Assemble#

Overview#

The Assemble widget enables users to assemble consumable Materials during assembly operations. Materials can be identified through barcode scanning, camera-based scanning, or manual entry, allowing users to record Material consumption and provide any required BOM information.

The widget also provides real-time visibility into Material consumption status throughout the assembly process. While it is used to perform Assemble operations, it displays the current state of Materials based on assembly-related activities, including Assemble, Disassemble, and Replace Assembled operations.

General#

To use the Assemble widget in a UI Page, follow the steps below:

1. In any UI Page in Build mode, select the Assemble from the widgets list located on the left side of the page; drag and drop to the desired place in the UI Page.
2. Enter the Settings section of the widget through the three vertical dots.
3. In the General tab, provide a name and a description for the widget. Use the toggle buttons to specify whether the widget should be visible, display the header, or allow full screen mode. Additionally, determine if the widget can be opened as an image in a new tab or exported as an image. You can also select the navigation mode behavior: open a new page, replace the current page, or none.

Style#

Optionally, in the Style tab, you can define a Border Width and Color.

Links#

In the Links tab, define the links between this widget and other elements of the UI Page.

You can also configure these links in the Links tab of the UI page.

Select Save and Close to apply the configuration. The widget will be changed accordingly.

Real Use Case#

The Assemble widget is intended for assembly processes in which Materials are consumed progressively throughout the execution of a production Step rather than in a single operation.

A common scenario is a long-running assembly process in which users assemble consumable Materials as they become available or as assembly work progresses. To support this workflow, the widget operates on an active BOM Instance created from either a BOM configured for an Explicit Long Running assembly context or a BOM with Assembly Type set to Mixed and Mixed Assembly Type set to Explicit Long Running.

The BOM Instance acts as the runtime record of the assembly process and allows users to perform incremental assembly operations while maintaining visibility into the current assembly progress and Material consumption.

Preconditions#

For the Assemble widget to function correctly in this use case:

• Configure an entry in the BOMContext smart table with the Assembly Type set to Explicit Long Running or Mixed, according to the BOM configuration.

• If the Assembly Type is set to Mixed:

  • Enable Use Mixed Assembly - Enables Mixed Assembly mode on the BOM, allowing some BOM Items to be assembled manually, while others are handled automatically by the system.

  • Set Mixed Assembly Type to Explicit Long Running - Defines the manual assembly behavior within the Mixed Assembly. This mode allows assembling quantities progressively rather than all at once.

Widget Linking#

The Assemble widget can be linked to other UI Page elements to receive the BOM Instance information it requires. In this example, two input links pass the BOM Instance identifier and entity type to the widget's GetBomInstance service call.

These links are defined in the Links tab of the UI Page settings.

Steps#

1. Add the Assemble widget to the UI Page.

2. Fill in the General and Style tabs.

3. In the Links tab, configure the following inputs:

   • Source - Select the source service call (in this case, GetBomInstance).
   • Output - Choose the expected output (in this example, output$Instance).
   • Target - Select Assemble.
   • Input - Choose BOM Instance.

   

4. After saving and closing the widget, select Preview from the action bar, and enter a BOM Instance ID.

   

5. The widget displays the Products and Materials associated with the selected BOM Instance.

   

6. Scan the Material barcode using a physical barcode scanner. Alternatively, select the to scan the barcode, or manually enter the Material name in the input field.

   

   Auto Consume Max. Quantity

   If the Auto Consume Max. Quantity checkbox is enabled, the system automatically consumes the maximum quantity required when a Material is scanned and skips the quantity entry step. For example, if a Product has a quantity of 1/10, it requires 9 additional units. If a Material with 50 available units is scanned, the system automatically consumes 9 units from that Material.

   If the Auto Consume Max. Quantity checkbox is disabled, the Assemble Item dialog opens after the scan, allowing the user to manually specify the quantity to consume.

7. If the Assemble Item dialog is displayed after scanning a Material, define the quantity to consume. In some conditions, additional information or quantity is required. In these cases, use the dialog to:

   • Select the appropriate Material.
   • Enter the exact consumed quantity.
   • Fill out additional information (if configured in the BOM item).
   • Select Advanced Details to provide extra information, such as recording Material losses or specifying locations.

   

   Continue scanning Materials until the required quantity is consumed.

8. The Assemble widget provides real-time status updates for assembled and disassembled Materials.

   

The Assemble widget panel can also reflect assembly-related operations performed on the Materials, such as Disassemble and Replace Assemble.