--- alias: tutorials-weigh-and-dispense-scenario-configure tags: - "11.3" description: "Configure the safety information, the BOM, the BOM Context, the electronic scale, and the labels that Weigh and Dispense requires" --- # Configure Weigh and Dispense In this scenario, you will learn how to: - Define the safety information and the data sheets of a **Product**. - Create a **BOM** with the Weigh and Dispense scope. - Define the **BOM Context** for the Weigh and Dispense operation. - Configure an electronic scale. - Optionally, configure the labels that the system prints after each dispense. !!! info For more information, see: - [[user-guide-manage-product-safety-information]] - [[tutorials-howto-createbomforweighanddispense]] - [[bomcontext-st]] - [[tutorials-howto-createinstrument]] - [[tutorials-howto-addinstrument]] - [[user-guide-manage-resource-measurement-capabilities]] - [[user-guide-create-printable-document]] ## Sequence of Steps ### 1. Create the Products Create a target **Product** and the source **Products** that the target requires. For example: - Target **Product**: `Blue Compound`. - Source **Products**: `Powdered chemical Blue` and `Phthalates`. For more information, see [[user-guide-create-product]]. ### 2. Define the Safety Information This step is optional. The system always shows the safety information of the **Products** to the operator. 1. In the left side menu, select **Business Data**. 2. From the Business Data panel, select **Product**. 3. Select a source **Product**. For example, `Powdered chemical Blue`. 4. In the **Safety Information** section, select **Manage**. 5. Define the Routes of Exposure, the Hazard Classifications, the Hazard Information, and the Protection Equipment. ![Safety Information of a Product with the hazard classifications, routes of exposure, hazard information, and protection equipment.](images/product_safety_information.png) !!! info The system merges the safety information of all the BOM Products and of the target Product, and shows it to the operator in the Preparation wizard. ### 3. Add the Data Sheets as Attachments The system shows the Safety Data Sheets and the Technical Data Sheets in the Execution wizard. It takes them from the attachments of the **Product**. 1. Open the source **Product**. 2. In the right side panel, select **Attachments**. 3. Add the file of the data sheet, and select the attachment type `Safety Data Sheet` or `Technical Data Sheet`. ![Attachments of a Product with a Safety Data Sheet and a Technical Data Sheet.](images/product_attachments.png) !!! info The configuration entries `/Cmf/System/Configuration/Product/SafetyDataSheet` and `/Cmf/System/Configuration/Product/TechnicalDataSheet` define the attachment types that the system treats as data sheets. For more information, see [[user-guide-attachments]] and [[attachmenttype-gt]]. ### 4. Create the BOM Create a **BOM** with the Weigh and Dispense scope for each target **Product**. For the detailed steps, see [[tutorials-howto-createbomforweighanddispense]]. The scenarios use the following **BOMs**: | BOM | Target Product | Formula Type | Product | Quantity | Lower Tolerance | Upper Tolerance | Assembly Step | Instrument Type | | --- | --- | --- | --- | --- | --- | --- | --- | --- | | `BOM W&D Compound B` | `Blue Compound` | Relative | `Powdered chemical Blue` | 20 | 0.1 | 0.01 | `Chemicals Preparation` | `Scale High Precision` | | `BOM W&D Compound B` | `Blue Compound` | Relative | `Phthalates` | 80 | 2 | 1 | `Chemicals Preparation` | `Standard Scale` | | `BOM W&D Compound G` | `Green Compound` | Absolute | `Powdered chemical Green` | 5 | 0.1 | 0.05 | `Chemicals Preparation` | `Scale High Precision` | | `BOM W&D Compound G` | `Green Compound` | Absolute | `Phthalates` | 30 | 2 | 1.5 | `Chemicals Preparation` | `Standard Scale` | | `BOM W&D Compound G` | `Green Compound` | Absolute | `Secret Chemical Recipe` | 20 | 0.1 | 0.05 | `Chemicals Preparation and Mixing` | None | Table: BOM items in the scenarios For each item, enter instructions in the **Note** field. For example, for `Powdered chemical Blue`: 1. Use the High Precision Scale. 2. Check if the Scale is Calibrated. 3. Weigh the Blue Powdered Chemical according to the Bill of Material. ![BOM with the Weigh And Dispense scope and the Relative formula type for the Blue Compound.](images/create_bom.png) ### 5. Define the BOM Context The **BOM Context** associates the **BOM** with the **Step** and the **Product**, and defines how the system handles the dispensed quantities. 1. In the left side menu, select **Administration**. 2. From the Administration panel, select **Tables**. 3. In the left side panel, select **Smart Tables**. 4. In the search box, write `BOMContext`. 5. Select **BOMContext**. 6. In the top ribbon, select **Add**. 7. Select the **Step**. For example, `Chemicals Preparation`. 8. Select the **Product**. For example, `Blue Compound`. 9. Select the **BOM**. For example, `BOM W&D Compound B`. 10. Set the **Assembly Type** to `Weigh and Dispense`. 11. Select the **Weigh and Dispense Mode**. The following table describes the modes. 12. Select **Add**. | Mode | Description | | --- | --- | | Attach | At the end of the operation, the system attaches the dispensed raw materials as Sub-Materials of the target **Material**. The quantity of the target **Material** is zero, because the Sub-Materials hold all the quantity. | | Consume | At the end of the operation, the target **Material** consumes the dispensed raw materials. The quantity of the target **Material** equals the sum of the dispensed quantities. | Table: Weigh and Dispense modes The scenarios use the following records: | Step | Product | BOM | Weigh and Dispense Mode | | --- | --- | --- | --- | | `Chemicals Preparation` | `Blue Compound` | `BOM W&D Compound B` | Attach | | `Chemicals Preparation` | `Green Compound` | `BOM W&D Compound G` | Consume | | `Chemicals Preparation and Mixing` | `Green Compound` | `BOM W&D Compound G` | Consume | Table: BOM Context records in the scenarios ![BOM Context with the records of a Product for the Attach and Consume modes.](images/bom_context.png) ### 6. Configure the Electronic Scale 1. Create an **Instrument** for the electronic scale. For more information, see [[tutorials-howto-createinstrument]]. 2. Add the **Instrument** to a Process **Resource**. For more information, see [[tutorials-howto-addinstrument]]. 3. Define the Measurement Capabilities of the **Instrument**: the measurement units, the range, and the precision. For example, `Kg`, a range of `0.1` to `999`, and a precision of `0.01`. For more information, see [[user-guide-manage-resource-measurement-capabilities]]. ![Measurement Capabilities of the scale with the measurement units, the range, and the precision.](images/scale_measurement_capabilities.png) !!! info Configure the scale to provide the weight in the primary units of the target Material, or create an entry in the [[unitconversionfactors-gt]] generic table. !!! info The scale Resource must integrate with the system, so that the Weigh and Dispense wizard receives the values of the scale automatically. For more information, see [[tutorials-weigh-and-dispense-scale-integration]]. ### 7. Configure the Labels This step is optional. When the **BOM** references a label, the system prints it after each partial or complete dispense. 1. In the left side menu, select **Administration**. 2. From the Administration panel, select **Tables**. 3. In the left side panel, select **Smart Tables**. 4. Select **PrinterTypePrintersContext**. 5. Add a record that defines the printer for the Weigh and Dispense labels of a context. For example, set the **Printer Type** to `General` and select the **Printer Name**. !!! info If the BOM references a label, the operator must select a printer in the Preparation wizard. For more information, see [[printertypeprinterscontext-st]]. Create the label as a **Printable Document** with the Weigh and Dispense Label scope. The label scope has the following rules: - Leave the **Applies To** field empty. - The system creates the data contexts in the following table automatically. Reference them in the label design. - Printing **Printable Documents** requires a license for the Advanced Layout and Printing module. | Name | Source Type | | --- | --- | | `DispensedFromMaterial` | Object | | `DispensedFromProduct` | Object | | `DispensedFromStep` | Object | | `DispensedFromContainer` | Object | | `DispensedToMaterial` | Object | | `DispensedToProduct` | Object | | `DispensedToStep` | Object | | `DispensedToContainer` | Object | | `DispensedToContainerType` | String | | `DispensedEmployee` | Object | | `DispensedQuantity` | Decimal | | `DispensedUnits` | String | | `DispensedResource` | Object | | `DispensedScale` | Object | Table: Data contexts of the Weigh and Dispense label All the data contexts have the type `Input`. When the operator uses **Dispense & Continue**, a label can list several elements. To print every element of a list, use a Data band. A Data band has a data source that provides a table of fields. The Data band prints one row for each row of the data source. When a page has no more space, the system generates a new page and continues printing. - Label with multiple entries: The Data band prints one row for each dispense. ![Label design with two Data bands, one for the dispensed materials and one for the scales.](images/label_multiple_entries_design.png) ![Printed label with two dispenses, each with the source material, the quantity, and the scale.](images/label_multiple_entries_result.png) - Label with a single entry: The label prints only the first element of each list. ![Label design with a Data band that lists the employee, the resource, the step, the source product, and the target product.](images/label_single_entry_design.png) ![Printed label with the employee, the resource, the step, the source product, and the target product.](images/label_single_entry_result.png) Finally, select the **Printable Document** in the **Weigh and Dispense Label** field of the **BOM**. ## Expected Result After you complete this scenario, the **Products** have their safety information and data sheets, the **BOMs** exist with the Weigh and Dispense scope, the **BOM Context** associates them with the **Steps**, and the electronic scale is ready. The labels are ready if you configured them. ## Next Scenario Continue with [[tutorials-weigh-and-dispense-calculate-quantities]].