---
alias: user-guide-compose-submaterials
description: "This documentation details transferring sub-materials into a target material, requiring specific material and container conditions"
---

# Compose Material (Sub-Materials)

:lock: Material.**Compose**

## Overview

This operation is similar to [[user-guide-compose-material]], 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.](images/compose_submaterial_option.png)

### 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-gt]] 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-lt]] Lookup Table.

    !!! info
        There must be a match between the chosen Source Materials' Form and the Sub-Materials' Form in the [[materialformrelation-gt]] Generic Table.

5. Select **Next** to continue.

![Screenshot showing a UI with fields for "Compose Material (Sub-Materias)" and "General Date".](images/compose_material_submaterials.png)

### 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 :material-plus: 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-gt]] Generic Table). You can also remove **Materials** by selecting the :material-trash-can: icon and filter **Materials** by selecting the :core-static-filter-sm: icon.
3. Select **Next** to continue.

![Screenshot showing a list of materials with sub-materials, as part of Step 2 in the documentation.](images/compose_submaterials_source.png)

### 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**.

    === "No Selection"

        ![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).](images/compose_submaterial_example1.png)

    === "Target Container Selected"

        ![Screenshot showing a container with a BOM and target container selected, illustrating the step for inserting a sub-material.](images/compose_submaterial_example2.png)

    === "BOM and Target Container Selected"

        ![Screenshot showing a user interface with a Compose Material (Sub-Materials) screen, featuring Source Materials Containers and a Target Container.](images/compose_submaterial_example3.png)

    !!! 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 :core-static-asterisk-sm:{ style="margin-top: 2px; color: #b83128;" } icon. Once all required positions are correctly filled, a :core-static-checkcircle-lg:{ style="color: #4DB6AC; margin-top: 2px;" } 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.