Skip to content

Compose Material (Sub-Materials)#

🔒 Material.Compose

Overview#

This operation is similar to Compose Material (Quantities), but it allows you to transfer Sub-Materials instead of Quantities. Simply, this means that you can attach the Sub-Materials you select into the Target Material.

Setup#

No special setup is required other than to meet the preconditions of the transaction.

Preconditions#

  • Source and Target Materials are Active.
  • Source and Target Materials, and their respective Top-Most Materials, are not On Hold and are not In Transit.
  • Source and Target Materials, as well as the Target Container, must belong to the same Facility.
  • Source Parent Materials and Top-Most Materials must be different from the Target Materials.
  • Source Materials and Source Parent Materials must not have expired or an Expiration Date has not been defined.
  • Top-Most of Source and Target Materials must have different Top-Mosts.
  • The Top-Most Source and the Top-Most Target Materials must have the Current Transfer Material property set to null.
  • The Source Material Products must not be blocked, or if blocked, the Source Materials property Override Product Block must be true.
  • The Source Materials must not have any open defects (Open Defect Count is 0).
  • The Target Container must be Active, Non-Template, the System State must be Available, and it must not be On Hold for Maintenance.
  • The Target Container must have the Position Unit Type set to Material and the Target Container Units must match either the Material Primary or Secondary Units.

Info

This transaction is relevant for genealogy.

Sequence of Steps#

  1. Select a Material that complies with the preconditions.
  2. Select the Sub-Materials button, accessible through the More button on the top ribbon.

Screenshot showing the "Compose Sub-material" option in the drop-down menu.

Step 1: General Data#

  1. Optionally, select a BOM of Compose Map scope.

  2. When selecting a BOM, you must also specify the Compose BOM Mode and choose a target Container. The Compose BOM Mode offers two options:

    • Full - all the required BOM items must be assigned in the Container.
    • Partial - you can choose which BOM items will be assigned to the empty positions in the Container.

    Info

    It is possible to define the default value for the Compose BOM Mode by editing the entry Context = Material.Compose and Element = ComposeBOMMode in the GUIElementDefaultValue Generic Table. By default, the value is set to Full.

  3. Optionally, select a Target Container.

    Info

    When selecting a BOM, it is mandatory to also choose a Target Container.

  4. Select the Source Materials' Form from the MaterialForm Lookup Table.

    Info

    There must be a match between the chosen Source Materials' Form and the Sub-Materials' Form in the MaterialFormRelation Generic Table.

  5. Select Next to continue.

Screenshot showing a UI with fields for "Compose Material (Sub-Materias)" and "General Date".

Step 2: Source Materials#

  1. Choose whether to Allow Top-Most Materials of Form {Form Name} of the selected Sub-Materials Form to be included as Source Materials.
  2. Add as many Source Materials as you need by selecting the icon and choose the desired Material. Only Source Materials with a compatible form for the selected Sub-Materials Form will be shown (based on the MaterialFormRelation Generic Table). You can also remove Materials by selecting the icon and filter Materials by selecting the icon.
  3. Select Next to continue.

Screenshot showing a list of materials with sub-materials, as part of Step 2 in the documentation.

Step 3: Sub-Materials Transfer#

Depending on your selections in Step 1, there are three possible scenarios:

  1. No BOM or Target Container Selected - the positions each Sub-Materials occupies in the Target Container are irrelevant.
  2. Target Container Selected - you must insert the Sub-Material in a specific position within the Container by choosing a Sub-Material and selecting the desired position.

  3. Both BOM and Target Container Selected - you must insert the Sub-Material in a designated position within the Container, as determined by the BOM Items Products. For highlighted positions in the Target Container, select compatible Materials based on the BOM-defined Products.

    Screenshot showing a UI illustrating the step of inserting a Sub-Material into a designated position within a Container, as determined by the Bill of Materials (BOM).

    Screenshot showing a container with a BOM and target container selected, illustrating the step for inserting a sub-material.

    Screenshot showing a user interface with a Compose Material (Sub-Materials) screen, featuring Source Materials Containers and a Target Container.

    Info

    *When a Target Container or both BOM and Target Container are selected, Source Materials are color-coded based on their associated Products. You can drag and drop each Material or Sub-Material into the Target Container. * When a BOM and Target Container are selected, the mandatory positions are marked with an icon. Once all required positions are correctly filled, a icon confirms completion. * You can use the search field to quickly locate specific Materials in any of the three scenarios.

  4. Select Compose to complete the operation.