Detach Material#

Material.Detach

Overview#

This operation is used to remove a Sub-Material from a Main Material. As a naming convention, the Material being detached is referred to as Sub-Material, and the Material losing the Sub-Material is referred to as Parent Material. The highest parent of the Parent Material is referred to as Top-Most of Parent Material.

Setup#

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

Preconditions#

• The Parent Material and the Sub-Material exist and are Active.
• The Top-Most Material is not On Hold.
• The Top-Most Material property CurrentMaterialTransfer must be empty.
• For the Top-Most of the Parent Material:
  • The In Transfer Order Item must be empty.
  • The Pick List Item Count must be empty.
  • If the Material is associated with a Resource, and the state of the Material is Consumable, Durable, Dispatched, In Process, or the property In Store is set to true, the Resource Inventory Locked must be false.
• The Parent Material and Sub-Material Package Count must be empty.
• The Sub-Material to be detached has a Parent Material.
• The Flow of the Material being detached is Enabled.

• If the property Use Container Restrictions in the Step of the Material is true, the available containers will be the ones that match the restrictions applied by the context of that Step. For more information, see Contexts View or MaterialContainerTypeContext.

  Note

  The Container Used Positions must be less than the Container Max Usable Positions.

Preconditions for Bulk#

• In addition to the preconditions mentioned above, all Sub-Materials must:
  • Be detached from the same Parent Material.

Sequence of Steps#

The Detach Material wizard is called from the Details page of the selected Material. Depending on the current system status, the Detach Material button may be visible on the top ribbon or under the More actions button.

Step 1: Sub-Materials#

1. Select the Material you need.
2. Select Detach.
3. In the Detach Material wizard, select the Sub-Materials to detach by selecting the respective checkbox(es).

Step 2: Containers#

1. Optionally, expand the Options section.
2. If the main Material has future holds associated to it, define if the Sub-Material will Copy Future Holds.
3. Define if the Sub-Material will Terminate Material on Zero Quantity(ies) and no Sub-Materials.
4. Define if the Sub-Material will Copy Characteristics.
5. Select the container, if one exists, for the Sub-Material.
6. Select Detach to complete the operation.