citrus-cms/resources/views/guide/weldlog-employer-view.md

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:

// 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:

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 - Standard weldlog view documentation
• Weldmap Guide - Weldmap module documentation
• NDT Calculation Guide - NDT testing documentation
• Repair Log Guide - 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