--- alias: tutorials-weigh-and-dispense-tutorial-index tags: - "11.3" tutorial: deepdive module: Weigh and Dispense description: "Learn how to configure Weigh and Dispense and how to weigh and dispense raw materials into a target material with electronic scales in Attach and Consume modes" --- # Weigh and Dispense Tutorial ## Overview !!! info Weigh and Dispense is a Critical Manufacturing optional module and requires a separate license. Confirm that you enabled it in your environment. Weigh and Dispense is a controlled, computer-aided process that guides operators step by step through weighing and dispensing raw materials. It combines three capabilities: - Material tracking. - Resource tracking. - Equipment integration with electronic scales. The process follows a formula, which defines the raw materials that a product requires, the quantity of each raw material, and the accepted tolerances. The system guides the operator to pick, weigh, and dispense each ingredient into containers, and it validates that each dispensed quantity falls within the tolerances. The process can involve hazardous materials and protective equipment, so the system always displays the safety information of the products to the operator. For more information, see [[user-guide-manage-product-safety-information]]. ### Why Weigh and Dispense Matters Weigh and Dispense addresses the following challenges of formulation industries: - Error-prone and time-consuming process: Manual weighing is slow, and small deviations in the quantity of an ingredient can compromise the quality or safety of the product. - Operator guidance and safety: The system ensures that operators have the necessary qualifications, use the required protective equipment, and always see the safety information of the product. - Precision and quality control: The process uses only calibrated scales, validates the weighed quantities against the tolerances of the formula, and prints labels that operators attach to the dispensed containers. - Traceability and regulatory compliance: The system records every action to provide end-to-end traceability of the raw materials and to support regulatory requirements, such as GMP in the pharmaceutical industry. In this tutorial, you will learn how to: - Configure the safety information, the **BOM**, the **BOM Context**, the electronic scale, and the labels. - Understand how the system calculates the quantities to weigh and their tolerances. - Weigh and dispense raw materials into a target material in a single **Step**, using the Attach mode. - Weigh and dispense raw materials into a target material across multiple **Steps**, using the Consume mode. The scenarios target process engineers and administrators who configure Weigh and Dispense, and operators who perform it. !!! info For more information, see: - [[user-guide-weigh-and-dispense-material]] in Business Data. - [[user-guide-manage-product-safety-information]]. For a short task-based guide, see [[tutorials-weigh-and-dispense-howto-index]]. ## Key Concepts The following table describes the main terms of Weigh and Dispense. | Term | Description | | --- | --- | | **Electronic Scale** | The physical weighing device that connects to the system as an Instrument. It reads and sends the weight values in real time, so that the system can validate whether the dispensed quantity is within the accepted range. | | **Formula** | The definition of the raw materials that a product requires, the quantity of each raw material, and the tolerances. In the system, a formula is a **BOM** with the Weigh and Dispense scope. | | **Gross** | The total weight that the scale measures when the operator loads a container, that is, the weight of the container plus its contents. | | **Hazard Classifications** | The safety classifications of a product in four dimensions: Health (blue diamond), Fire (red diamond), Instability (yellow diamond), and Specific (white diamond). The classifications for Health, Fire, and Instability range from zero, which represents no hazard, to four, which represents the most extreme hazard. The Specific hazard is qualitative. | | **Hazard Symbols** | The visual warning icons that flag additional risks of a product, for example Oxidizing, Biohazardous, or Flammable. They complement the Hazard Classifications. | | **Ingredients** | The raw materials to weigh and dispense in a Weigh and Dispense operation. Each ingredient corresponds to a source **Product** of the formula. | | **Net** | The weight of the material without the container. The system calculates it as Gross minus Tare. | | **Protection Equipment** | The personal protective equipment that the operator must use to handle a material, for example goggles, gloves, a dust mask, or boots. The system shows the requirements to the operator before the process begins. | | **Raw Material** | A source material that the operator uses as an ingredient. It is the input that the operator weighs and dispenses into the target material. | | **Routes of Exposure** | The ways in which a substance can enter the human body: inhalation, skin or eye absorption, ingestion, or injection. | | **Safety Data Sheet** | A document that you attach to a **Product**. It contains the safety information of the product, such as hazards, handling instructions, first aid measures, and storage requirements. | | **Tare** | The weight of the empty container before the operator adds any material. The system uses it as the baseline to calculate the net weight. | | **Target Material** | The material that the operator produces or assembles. The operator weighs and dispenses the raw materials into it in the quantities that the formula defines. | | **Technical Data Sheet** | A document that you attach to a **Product**. It contains the technical specifications and properties that are relevant to handling and use. | Table: Weigh and Dispense key concepts ![Hazard classification diamond with the Health, Fire, Instability, and Specific values.](images/hazard_classification_diamond.png) ### Weighing Methods The weighing method defines which container the scale measures. | Method | Description | | --- | --- | | **Positive Weighing** | The weight is the quantity that the operator adds to the target container. The scale measures the target container. | | **Negative Weighing** | The weight is the quantity that the operator removes from the source container. The scale measures the source container. | Table: Weighing methods ![Positive weighing with the scale under the target container.](images/positive_weighing.png) ![Negative weighing with the scale under the source container.](images/negative_weighing.png) ## How the Operator Performs Weigh and Dispense After the operator performs Track-In on the target **Material**, the operator selects **Weigh & Dispense**. The operation consists of two wizards. | Wizard | Description | | --- | --- | | Preparation | Collects the printer to use. Shows the safety information of the process. The system merges the safety information of all the BOM Products and of the target **Product**. | | Execution | Performs the partial or complete dispenses of the ingredients. | Table: Weigh and Dispense wizards ![Preparation wizard with the printer selection.](images/wizard_printer.png) ![Preparation wizard with the safety information of the process.](images/wizard_safety_information.png) ![Execution wizard with the ingredients, the source, the target, and the weight of the scale.](images/wizard_execution.png) The execution wizard allows the operator to: - Change the scale. - Alternate between the Execution and the Summary views. - Open the Safety Data Sheets and the Technical Data Sheets. The documents icon shows the number of available documents. - Select a source, either by a **Material** name or by the name of a **Container** that holds only one **Material**, and then start weighing: - For positive weighing, select **Set Tare & Begin**. - For negative weighing, select **Begin Weighing**. - Dispense the weighed quantity partially or completely. - Undo a previous dispense with **Delete Value**. - Stop the current weighing with **Stop**. !!! info The system consumes the raw materials only when you select Complete W&D. Complete the whole operation in one transaction. For more information, see [[user-guide-weigh-and-dispense-material]]. ### Scale Status A colored indicator on the left of the scale shows the connection status of the electronic scale. The status depends on the state of the selected **Resource**. | Color | Status | | --- | --- | | Red | Disconnected | | Green | Connected | | Yellow | Unstable | | Grey | Unknown | Table: Scale status indicator ## Learning Path Complete the scenarios in order. The scenarios reuse the configuration that the previous scenarios create. | Scenario | Description | | --- | --- | | [[tutorials-weigh-and-dispense-prerequisites]] | Confirm the security features, configuration entries, and [master data file](master_data/weight-dispense-masterdata.xlsx) that the scenarios require. | | [[tutorials-weigh-and-dispense-scenario-configure]] | Configure the safety information, the BOM, the BOM Context, the electronic scale, and the labels. | | [[tutorials-weigh-and-dispense-calculate-quantities]] | Understand how the system calculates the quantities to weigh and the tolerances for the Relative and Absolute formula types. | | [[tutorials-weigh-and-dispense-single-step]] | Weigh and dispense two ingredients into a target material in a single Step and attach them as Sub-Materials. | | [[tutorials-weigh-and-dispense-multi-step]] | Weigh and dispense partial quantities across two Steps and consume them into the target material. | | [[tutorials-weigh-and-dispense-scale-integration]] | Review the messages and the workflows that integrate an electronic scale with the Weigh and Dispense pages. | Table: Weigh and Dispense tutorial scenarios Start with [[tutorials-weigh-and-dispense-prerequisites]].