User Guide: Bulk Event Update

1. Purpose

This guide explains how to use the Bulk Event Update screen (bulk-event-update.component.html) to apply the same container event (like "ONHIRE", "OFFHIRE", "SHIPPER PICKUP EMPTY") to multiple containers simultaneously. This involves defining the event details and then selecting the containers using a popup (bulk-pickcontainers-popup.component.html).

2. Accessing the Feature

Navigate to the Bulk Event Update page through the application's menu system (likely under a "Box Control" or similar section).

3. Screen Overview: Bulk Event Update (bulk-event-update.component.html)

The main screen is divided into several sections:

Toolbar

Located at the top right, it contains standard action buttons:

• Home (home): Navigates back to the main dashboard.
• New (add): Clears the current form and table to start a new bulk update process.
• Save (save): Saves the event details for the selected containers in the table below. Becomes disabled during the save process (isSaving==1).
• (Other icons like Delete delete_outline, PDF picture_as_pdf, Spreadsheet save_alt, Clear All clear_all are currently disabled).

Page Header

Displays the page title ("Bulk Event Update") and an Info icon (info) to view help information if available.

Event Details Form

This section requires you to define the event that will be applied to the containers.

• Event Date*: (Required) Select the date when the event occurred using the date picker.
• Event Code*: (Required) Select the type of event from the dropdown list (e.g., "SHIPPER PICKUP EMPTY", "POL PICKUP EMPTY", "ONHIRE", "OFFHIRE").
• (Conditional Fields - Appear for ONHIRE/OFFHIRE when canShow==1):
  • Agent: Select the relevant agent from the dropdown list (searches as you type).
  • Location*: (Required for ONHIRE/OFFHIRE) Enter or select the port code where the event occurred (autocomplete suggestions appear).
  • Release / Return Ref.*: (Required for ONHIRE/OFFHIRE) Enter the associated release or return reference number.
  • Release / Return Depot*: (Required for ONHIRE/OFFHIRE) Enter or select the depot code associated with the event (autocomplete suggestions appear).

Action Buttons

• Pick Containers (playlist_add_check icon): Opens a popup window (viewPickContainerList1() function) to input and select the containers for this bulk update.
• View ExlCopy Uploaded Data (visibility icon): Navigates to a separate screen (viewExcelCopyData() function) to view data potentially uploaded via a different Excel copy/paste mechanism.

Container List Table

This table displays the containers selected for the bulk update.

• Select Checkbox: Allows selecting/deselecting individual containers or all containers using the header checkbox (select_all). Only selected containers will be processed when you click Save.
• Columns: Shows details for each container: Event Code, Event Date, Container No., Order No., Location, Reference, Depot.
• Container No.: This is a clickable link (viewContainerHistoryList() function). Clicking it will open a popup showing the historical movements for that specific container. After saving, status icons appear next to the container number:
  • check (Green): Indicates the event was successfully saved for this container (element.status==1).
  • error (Red): Indicates an error occurred while saving the event for this container (element.status==0). Hover over the icon for the error message (element.msg).

4. Step-by-Step Workflow

1. Define the Event Details
   1. Go to the Event Details Form.
   2. Select the Event Date*.
   3. Select the Event Code* from the dropdown.
   4. If the selected Event Code is "ONHIRE" or "OFFHIRE":
      • Fill in the Agent (optional, but recommended).
      • Fill in the Location* (required).
      • Fill in the Release / Return Ref.* (required).
      • Fill in the Release / Return Depot* (required).
   5. Ensure all required fields (*) are filled correctly.
2. Pick Containers
   1. Click the Pick Containers button (playlist_add_check icon). This calls the viewPickContainerList1() function.
   2. The "Pick Containers" popup will open, but only if the required fields in the main form (Step 1) are valid (this.eveupd.valid check).
   3. Note: If the event has already been saved (isEdit==1), you cannot pick new containers and must click New first.
3. Use the Pick Containers Popup (bulk-pickcontainers-popup.component.html)

   This popup allows you to input a list of containers.

   1. Input Data: In the large text area on the left labeled Input Data, paste your list of container numbers. You can often include other details like Order Number on the same line, separated by a space or tab.
   2. Extract Data: Click the Extract Inputted Data button (get_app icon, calls extractData()). The system processes the text and displays recognized containers in the table on the right.
   3. Review Extracted Data: Check the table on the right (columns: Container No, Order No, No. of Pkgs, Pkg Type) to ensure containers were extracted correctly.
   4. (Optional) Refresh Data: Click the Refresh Data button (refresh icon, calls refreshData()) to clear the input and the extracted list.
   5. (Optional) Excel Download: Click the Excel Download Inputted Data... button (save_alt icon, calls excelDownloadData()) to download the list.
   6. Upload Data: Once satisfied, click the Upload Extracted Data button (playlist_add_check icon, calls uploadData()). This closes the popup and transfers the container list to the main screen's table.
4. Review and Select Containers on Main Screen
   1. Back on the main Bulk Event Update screen, the Container List Table (dataSource) is populated.
   2. The event details from Step 1 are automatically associated with each container row.
   3. Review the list. Use the checkboxes in the first column (element.selected) to select/deselect containers.
   4. Use the header checkbox (select_all) to Select All or Deselect All.
5. Save the Bulk Event Update
   1. Ensure correct containers are selected.
   2. Click the Save button (save icon, calls save1() which checks isEdit before calling save()).
   3. The system attempts to save the event for each selected container. The Save button is disabled (isSaving=1), and a "Saving..." message appears.
   4. After processing, observe the status icons (check or error) in the Container List Table.
   5. A summary message (toast notification) indicates success/failure counts.
   6. The screen state is updated (isEdit=1) to prevent re-saving the same batch without clicking New.
6. Start a New Bulk Update (If Needed)
   1. Click the New button (add icon) in the toolbar. This reloads the component/clears the form and table.

5. Additional Actions

• View Container History: Click any underlined Container No. in the table to open the ContainerHistoryPopupComponent.
• Go Home: Click the Home icon (home) to return to the application dashboard.