Creating containment requests¶

There are three ways to create a containment request:

1. Contain by file.
2. Contain forward from a single item.
3. Contain from genealogy level.

Creating a containment request by file¶

You can create a containment request by importing a previously prepared CSV file that includes the list of materials to be potentially contained. Once the file is successfully imported, the containment request will be available for download by all connected systems and can be viewed at any time by Traceability users with the appropriate roles.

To create a containment request by file, follow the steps:

1. In the "Search" page, click "Contain By File".
   In the "Import the CSV file" tab, the dialog box displays the "Name" field prefilled as ContainmentRequest_<identifier>.
2. Add a comment in the text box.

3. Browse and upload the CSV file you previously created and click "Next". When a CSV file contains more than 50,000 items, the system automatically splits it into multiple batches for separate upload. After the file has been split, you can upload the batches using either of the following methods:

   • Manual upload: Upload each batch individually.
   • Automatic upload: Follow the step below:

4. In the "Upload Data and Execute" tab, click the "Upload All" button to upload all batches automatically. The system will process and upload each batch sequentially until all uploads are complete.

5. Once all batches have been successfully uploaded using either method, click "Execute" to confirm the containment action. You can track the progress of the operation on the "Contain History" page.

Creating a containment request from the "Backward and forward genealogy" page¶

You can create a containment request from the "Backward and forward genealogy" page. For each swimlane that represents a genealogy level of the manufacturing process, a containment action can be performed. The containment request will include all elements of the selected level. If you enable the "Forward Containment" option, the application will also include all materials in the subsequent levels that are impacted by the current selection. If the "Forward Containment" option is disabled, the containment request considers only the items present in the level where the action was initiated.

Creating a containment request from a single item¶

Once an item is selected from the "Search" page, users can navigate to the analysis page and initiate a containment operation based on the focused item. This operation is always performed using a forward genealogy search. As a result, in addition to the selected item, the application will include all items produced from the selected item in the containment request, extending through the genealogy chain up to the end of the genealogy or the calculation limit defined by the application.

Checking the status of containment requests¶

By default, the list of containment requests is sorted by the last update date. Requests are automatically ordered based on the most recent action that resulted in a status change, with the most recently updated items displayed first.

To check the progress of a containment request, do the following:

1. Click "Contain History" in the left-hand menu to view the list of containment requests, ordered by creation date. In the grid, a containment request can have one of five statuses:

   • "In progress": The request is created until processing is complete.
   • "Completed": The request is finalized and available to all connected systems.
   • "Releasing": The release action has started after analysis.
   • "Released": Items with no issues are released.
   • "Not Executed": This status is assigned to a containment request when it cannot be processed because it exceeds the application's predefined calculation limits. This helps prevent system overload and ensures stable performance.

2. Select the request to view its details in the right-hand panel.

   • The area on top of the panel shows information about the containment request.
   • The "Production Tracking Items" tab shows the list of items included in the containment request.
   • The "Acks Received" tab shows the acknowledgements to the containment request from external systems.

Retrying a failed containment request¶

A "Retry" button has been introduced to handle specific types of failures, allowing you to re-initiate a request without creating a new one.

When you click "Retry", the system re-executes the containment request using the same input parameters as the original attempt.

Important constraints¶

• The retry action can only be performed within 12 hours of the initial failed attempt. After this period, the "Retry" button is no longer available for that request.
• Retry can only be used for containment requests that are in the "Failed" status.