Ümit Tunç
342 lines
9.6 KiB
Markdown
342 lines
9.6 KiB
Markdown
# Weldlog Employer View Guide
|
|
|
|
## Overview
|
|
|
|
The **Weldlog Employer View** is a specialized read-only interface designed to display filtered weld log data specifically for employer/client review. This view shows only the data that employers should see, excluding repair records and non-acceptable NDT results.
|
|
|
|
## Purpose
|
|
|
|
The Employer View serves to:
|
|
- Display only acceptable weld log records to employers
|
|
- Hide repair-related information
|
|
- Filter out non-acceptable NDT test results
|
|
- Provide a clean, professional view of welding progress
|
|
- Show release information from release logs
|
|
|
|
## Access
|
|
|
|
To access the Employer View:
|
|
1. Login to the system
|
|
2. Navigate to **Admin** → **Types**
|
|
3. Select **Weldlog - Employer View**
|
|
|
|
**URL:** `/admin/types/weldlog-employer-view`
|
|
|
|
---
|
|
|
|
## Key Features
|
|
|
|
### 1. Filtered Data Display
|
|
|
|
The Employer View automatically filters data to show only:
|
|
- ✅ Records with **Accept / Годен** NDT results
|
|
- ✅ Records with **empty/null** NDT results
|
|
- ✅ Records **NOT** in repair status
|
|
- ❌ Records with repair status = 'Repair' (hidden)
|
|
- ❌ Records with non-acceptable NDT results (hidden)
|
|
|
|
### 2. Calculated Field: Joint Type RU
|
|
|
|
The view includes a calculated field **"Joint Type RU"** that displays the joint type from the WPS (Welding Procedure Specification) table based on the `wps_no` field.
|
|
|
|
**How it works:**
|
|
- The system looks up `weld_logs.wps_no` in the `w_p_s` table
|
|
- Retrieves the corresponding `joint_type_ru` value
|
|
- Displays it in the "Joint Type Connection" group header
|
|
|
|
**Filtering:**
|
|
- You can filter by Joint Type RU using the header filter
|
|
- The filter automatically converts to `wps_no` filtering on the backend
|
|
- Only joint types that actually exist in the data are shown in the filter dropdown
|
|
|
|
### 3. Infinite Scrolling
|
|
|
|
Unlike the standard weldlog view, the Employer View uses **infinite scrolling** instead of pagination:
|
|
- Scroll down to load more records automatically
|
|
- No page numbers or page size selection
|
|
- Smooth, continuous data loading
|
|
|
|
### 4. Read-Only Mode
|
|
|
|
The Employer View is **read-only**:
|
|
- No editing capabilities
|
|
- No data modification
|
|
- View-only access for employers
|
|
|
|
---
|
|
|
|
## Data Structure
|
|
|
|
### Group Headers
|
|
|
|
The Employer View organizes data into the following group headers:
|
|
|
|
1. **Attachment**
|
|
- PDF Engineering
|
|
- PDF Spool ISO
|
|
- PDF As Build
|
|
|
|
2. **Information About the PIPE**
|
|
- General Contractor, Contractor, Project
|
|
- Piping Type, Design Area
|
|
- Line Specification, Line Number
|
|
- Fluid Code, Service Category, Fluid Group
|
|
- Piping Class
|
|
- Design/Operating Temperature and Pressure
|
|
- Painting Cycle, External Finish Type
|
|
|
|
3. **ISO Information**
|
|
- ISO Number, Quantity of ISO
|
|
- ISO Revision, Spool Number
|
|
|
|
4. **Information about the welding**
|
|
- Type of Joint, Joint Number
|
|
- Type of Welds
|
|
- Fit-up Date, Welding Date
|
|
- WPS Number, WPS Approval Date
|
|
- Welding Method
|
|
- Welding Materials (1, 2, 3) with Lot Numbers and Certificates
|
|
- Fitter Name
|
|
- Welder 1 & 2 with Certificates and WPQ Reports
|
|
|
|
5. **Joint Type Connection** (New)
|
|
- Joint Type RU (calculated from WPS table)
|
|
- Shows C21, C17, etc. based on WPS joint type
|
|
|
|
6. **Control Information**
|
|
- Mechanic Supervisor & Control Date
|
|
- Welding Supervisor & Control Date
|
|
- Fit-up Report Number & Date
|
|
- Welding Report Number & Date
|
|
|
|
7. **Information about the welding elements 1 & 2**
|
|
- Element Code, Pose Number, Member Number
|
|
- Material Number, Product Standard
|
|
- RU Material Group, Certificate Number
|
|
- Heat Number
|
|
- NPS, Thickness by ASME, Outside Diameter
|
|
- Note: Wall Thickness (SCH1/SCH2) is hidden in employer view
|
|
|
|
8. **NDT Test Sections**
|
|
- VT (Visual Testing)
|
|
- RT (Radiographic Testing)
|
|
- UT (Ultrasonic Testing)
|
|
- PT (Penetrant Testing)
|
|
- MT (Magnetic Particle Testing)
|
|
- PMI (Positive Material Identification)
|
|
- PWHT (Post Weld Heat Treatment)
|
|
- HT (Hardness Testing)
|
|
- Ferrite Check
|
|
|
|
9. **PIPE Testing**
|
|
- Test Package Number
|
|
- Test Pressure, Type of Test
|
|
- Date Test, Test Result
|
|
|
|
10. **Release** (All data from release log)
|
|
- NDT Release Number & Date
|
|
- Spool NDT Check & Check Number
|
|
- Register Paint Number & Date
|
|
- Paint Release Number & Date
|
|
- Spool Paint Check
|
|
- Clearance Number & Date
|
|
- Spool Zone, Spool Status
|
|
- Spool Release Date
|
|
|
|
11. **Status**
|
|
- STE Subcontractor
|
|
- Remarks, Remarks 2
|
|
- Note: Real Welder 1 & 2 are hidden in employer view
|
|
|
|
---
|
|
|
|
## Filtering
|
|
|
|
### Header Filters
|
|
|
|
You can filter data using header filters on any column:
|
|
- Click the filter icon in the column header
|
|
- Select values from the dropdown
|
|
- Multiple selections are supported
|
|
- Filters are combined with AND logic
|
|
|
|
### Joint Type RU Filter
|
|
|
|
Special filtering for Joint Type RU:
|
|
1. Click the filter icon on "Joint Type RU" column
|
|
2. Select one or more joint types (C21, C17, etc.)
|
|
3. The system automatically converts this to `wps_no` filtering
|
|
4. Only joint types that exist in the data are shown
|
|
|
|
**Technical Details:**
|
|
- For 1 WPS number: Uses `wps_no = value`
|
|
- For 2-5 WPS numbers: Uses OR conditions
|
|
- For more than 5 WPS numbers: Uses IN clause for performance
|
|
|
|
---
|
|
|
|
## Hidden Fields in Employer View
|
|
|
|
The following fields are **not displayed** in the Employer View (as per requirements):
|
|
|
|
1. **Main Material** - Hidden
|
|
2. **Main NPS** - Hidden
|
|
3. **SCH1 (Wall Thickness 1)** - Hidden
|
|
4. **SCH2 (Wall Thickness 2)** - Hidden
|
|
5. **Real Welder 1** - Hidden
|
|
6. **Real Welder 2** - Hidden
|
|
7. **RQ Date** fields for all NDT methods - Hidden
|
|
8. **RQ No** fields for all NDT methods - Hidden
|
|
|
|
---
|
|
|
|
## Technical Implementation
|
|
|
|
### Backend Filtering
|
|
|
|
The system applies the following filters automatically:
|
|
|
|
```php
|
|
// Filter 1: Exclude repair logs
|
|
NOT EXISTS (
|
|
SELECT 1 FROM repair_logs
|
|
WHERE repair_logs.iso_number = weld_logs.iso_number
|
|
AND repair_logs.new_joint_no = weld_logs.no_of_the_joint_as_per_as_built_survey
|
|
AND repair_logs.repair_status = 'Repair'
|
|
)
|
|
|
|
// Filter 2: Only acceptable NDT results
|
|
AND (
|
|
(vt_result IN ('Accept / Годен', '') OR vt_result IS NULL)
|
|
AND (rt_result IN ('Accept / Годен', '') OR rt_result IS NULL)
|
|
AND (ut_result IN ('Accept / Годен', '') OR ut_result IS NULL)
|
|
AND (pt_result IN ('Accept / Годен', '') OR pt_result IS NULL)
|
|
AND (mt_result IN ('Accept / Годен', '') OR mt_result IS NULL)
|
|
AND (pmi_result IN ('Accept / Годен', '') OR pmi_result IS NULL)
|
|
AND (ferrite_result IN ('Accept / Годен', '') OR ferrite_result IS NULL)
|
|
AND (ht_result IN ('Accept / Годен', '') OR ht_result IS NULL)
|
|
)
|
|
```
|
|
|
|
### Calculated Field Implementation
|
|
|
|
The `wps_joint_type_ru` field is calculated on the frontend:
|
|
|
|
```javascript
|
|
calculateCellValue: function(rowData) {
|
|
var wpsNo = rowData ? rowData.wps_no : null;
|
|
if (wpsNo && wpsJointTypeRuMapping[wpsNo]) {
|
|
return wpsJointTypeRuMapping[wpsNo];
|
|
}
|
|
return null;
|
|
}
|
|
```
|
|
|
|
The mapping is loaded from the backend:
|
|
- `w_p_s` table: `details` (wps_no) → `joint_type_ru`
|
|
- Only existing joint types in `weld_logs` are shown in filters
|
|
|
|
### Performance Optimizations
|
|
|
|
1. **IN Clause Support**: For filters with many values, the system uses SQL IN clause instead of multiple OR conditions to avoid URL length issues (414 errors)
|
|
|
|
2. **Existing Joint Types Query**: Only joint types that actually exist in the data are loaded for the filter dropdown
|
|
|
|
3. **Infinite Scrolling**: Reduces initial load time by loading data in chunks
|
|
|
|
---
|
|
|
|
## Common Tasks
|
|
|
|
### Viewing Weld Logs
|
|
|
|
1. Navigate to Weldlog - Employer View
|
|
2. Use header filters to narrow down results
|
|
3. Scroll down to load more records
|
|
4. Use column sorting if needed
|
|
|
|
### Filtering by Joint Type
|
|
|
|
1. Locate the "Joint Type RU" column in "Joint Type Connection" group
|
|
2. Click the filter icon
|
|
3. Select desired joint types (e.g., C21, C17)
|
|
4. The grid will automatically filter and show matching records
|
|
|
|
### Exporting Data
|
|
|
|
The Employer View supports standard DevExtreme export features:
|
|
- Export to Excel
|
|
- Export to PDF
|
|
- Column selection before export
|
|
|
|
---
|
|
|
|
## Troubleshooting
|
|
|
|
### No Data Showing
|
|
|
|
**Possible causes:**
|
|
1. All records are in repair status
|
|
2. All records have non-acceptable NDT results
|
|
3. Filters are too restrictive
|
|
|
|
**Solution:**
|
|
- Check if filters are applied
|
|
- Verify that records exist with acceptable NDT results
|
|
- Clear filters and try again
|
|
|
|
### Joint Type RU Filter Not Working
|
|
|
|
**Possible causes:**
|
|
1. No WPS mapping exists for selected joint types
|
|
2. Filter conversion error
|
|
|
|
**Solution:**
|
|
- Check if WPS records have `joint_type_ru` values
|
|
- Verify that `wps_no` in weld_logs matches `details` in w_p_s table
|
|
- Check browser console for errors
|
|
|
|
### Performance Issues
|
|
|
|
**Possible causes:**
|
|
1. Too many records loaded
|
|
2. Complex filters
|
|
|
|
**Solution:**
|
|
- Use more specific filters to reduce dataset
|
|
- Wait for infinite scroll to load data in chunks
|
|
- Check network tab for slow queries
|
|
|
|
---
|
|
|
|
## Best Practices
|
|
|
|
1. **Use Filters Wisely**: Apply filters to narrow down large datasets
|
|
2. **Scroll Efficiently**: Let infinite scrolling load data gradually
|
|
3. **Export When Needed**: Export filtered data for offline review
|
|
4. **Check Data Regularly**: Verify that acceptable records are showing correctly
|
|
|
|
---
|
|
|
|
## Related Documentation
|
|
|
|
- [Weldlog Guide](./weldlog.md) - Standard weldlog view documentation
|
|
- [Weldmap Guide](./weldmap.md) - Weldmap module documentation
|
|
- [NDT Calculation Guide](./ndt-calculation.md) - NDT testing documentation
|
|
- [Repair Log Guide](./repair-log.md) - Repair log documentation
|
|
|
|
---
|
|
|
|
## Support
|
|
|
|
For issues or questions regarding the Employer View:
|
|
1. Check this guide first
|
|
2. Review related documentation
|
|
3. Contact system administrator
|
|
4. Report bugs through the support system
|
|
|
|
---
|
|
|
|
**Last Updated:** 2025-01-12
|
|
**Version:** 1.0
|