citrus-cms/resources/views/guide/weldmap.md

Weldmap User Guide

What is Weldmap?

Weldmap is where you track and manage all welding joint information in your project. Think of it as your digital welding logbook where you record every weld, track quality inspections, and maintain welding documentation.

Getting Started

To access Weldmap:

1. Login to the system
2. Click on Welding in the main menu
3. Select Weldmap from the dropdown

Creating a New Weld Record

Step 1: Adding Basic Information

1. Click the "Add New" button (+ icon) in the DataGrid
2. Fill in the required fields:
   • ISO Number: Enter the isometric drawing number
   • Joint Number: Unique identifier for this weld joint
   • Spool Number: The spool this weld belongs to

Step 2: Line Information

1. Line Number: Start typing the line number - the system will show suggestions
   • ⚡ Auto-Fill Feature: When you select a line number, many fields will automatically fill:
     • Design temperature and pressure
     • Service category
     • Piping class
     • NDT percentage
     • Painting information

Step 3: Material Information

1. Element Code 1 & 2: Select the components being welded
2. Material Numbers: These often auto-fill based on element codes
3. Steel Grades: Choose appropriate material grades
4. Wall Thickness: Enter thickness measurements

Step 4: Welding Details

1. WPS Number: Select the Welding Procedure Specification
2. Welding Method: Choose the welding process (SMAW, GTAW, etc.)
3. Welder Information: Select the qualified welders
4. Welding Position: Specify the position (1G, 2G, etc.)

Step 5: Quality Control

1. NDT Requirements: The system calculates this based on line requirements
2. Test Results: Update as inspections are completed
3. Inspection Reports: Reference NDT report numbers

Working with the DataGrid

Viewing Records

• Scroll: Use mouse wheel or scroll bars to navigate
• Sort: Click column headers to sort data
• Filter: Use the filter row to search specific values
• Page Size: Adjust how many records you see per page

Editing Existing Records

1. Double-click any cell to edit (if you have permissions)
2. Make your changes
3. Press Enter or click elsewhere to save
4. Press Escape to cancel changes

Using Dropdowns

• Many fields have dropdown lists
• Start typing to filter options
• Use arrow keys to navigate
• Press Enter to select

File Management

Uploading PDF Documents

For ISO Drawings:

1. Click "Upload PDF" button
2. Select ISO tab in the upload window
3. Drag and drop PDF files or click to browse
4. Files are automatically organized by ISO number

For Engineering Drawings:

1. Use the Engineering tab in upload window
2. Upload related technical drawings
3. Files link automatically to your weld records

Viewing PDFs

• Look for PDF icons (📄) in the grid
• Click the icon to open the related drawing
• Multiple PDFs may be available for each record

Smart Features

Auto-Complete Fields

Several fields help you by suggesting values:

• Line Number: Shows matching lines from your project
• UT Type: Lists available ultrasonic testing types
• Contractor Information: Filtered based on your access level

Automatic Calculations

The system automatically:

• Calculates NDT requirements based on line specifications
• Updates related fields when you select line numbers
• Applies appropriate welding standards

Data Validation

The system prevents errors by:

• Highlighting required fields
• Validating date formats
• Checking number ranges
• Ensuring proper selections

Common Tasks

Finding a Specific Weld

1. Use the search box above the grid
2. Or use column filters for specific criteria
3. Export to Excel for offline analysis

Updating Test Results

1. Locate the weld record
2. Double-click the test result field
3. Select: ACCEPT, REJECT, or REPAIR
4. Add report numbers and dates

Tracking Welding Progress

1. Use the Status column to see completion
2. Filter by Date to see recent work
3. Check NDT Percentage for inspection requirements

Generating Reports

1. Select multiple records using checkboxes
2. Click Export button
3. Choose Excel format for analysis
4. Data includes all visible columns

Tips for Efficient Use

✅ Best Practices

• Always start with Line Number - it auto-fills many fields
• Keep ISO Numbers consistent - enables PDF linking
• Update status regularly - helps track progress
• Use filters - find specific welds quickly
• Save frequently - changes auto-save but be careful

⚠️ Common Mistakes to Avoid

• Don't skip required fields (highlighted in red)
• Don't modify read-only fields (they're auto-calculated)
• Don't forget to upload related PDFs
• Don't use inconsistent naming conventions

🚀 Pro Tips

• Use Ctrl+F to search within the current page
• Right-click for context menus
• Tab key to move between fields quickly
• Shift+Click to select multiple rows

Troubleshooting

Can't Edit a Field?

• Check if it's read-only (grayed out)
• Verify you have edit permissions
• Some fields auto-populate from other sources

Auto-Complete Not Working?

• Make sure you're typing in the correct field
• Check your internet connection
• Contact admin if master data is missing

PDF Not Loading?

• Verify the file was uploaded correctly
• Check the ISO number matches exactly
• Ensure file isn't corrupted

Changes Not Saving?

• Check for validation errors (red highlights)
• Ensure all required fields are filled
• Try refreshing the page and re-entering

Getting Help

If you need assistance:

1. Check this guide first - most questions are answered here
2. Ask a colleague - they might have similar experience
3. Contact your supervisor - for process-related questions
4. Submit a support ticket - for technical issues

Remember: Weldmap is your primary tool for welding quality control. Taking time to learn it well will make your daily work much more efficient!