Skip to content

Transfer Sub-Materials#

🔒 Material.TransferSubMaterial

Overview#

This operation is used to transfer an attached SubMaterial from one Material to another.

The Material losing the Sub-Material is referred to as Parent Material From and the Material gaining the SubMaterial is referred to as Parent Material To. The Topmost of each Material is referred to as Topmost of Parent Material From and Topmost of Parent Material To, respectively.

Setup#

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

Preconditions#

  • The Topmost of ParentMaterialFrom and Topmost of ParentMaterialTo are Active, have the same Material State, have the same InStore property, and must not be On Hold and not InTransit.
  • The Topmost of ParentMaterialFrom and Topmost of ParentMaterialTo must be at the same Facility and Step.
  • If TopMost of ParentMaterialFrom and TopMost of ParentMaterialTo are different, one of the following conditions must be True:
    • The Characteristics Count of the TopMost of ParentMaterialFrom is 0 (or Null) or the Characteristics Count of the TopMost of ParentMaterialTo is 0 (or Null).
    • The Characteristics Count of the TopMost of ParentMaterialFrom is greater than 0 or Null, is equal to the Characteristics Count of the TopMost of ParentMaterialTo, and the set of Characteristic Values of the TopMost of ParentMaterialFrom and the TopMost of ParentMaterialTo are exactly the same (number, name, and value).
  • For the TopMost of both the Parent Material and Parent Material Form:
    • The IsInTransferOrderItem must be empty.
    • The PickListItemCount must be empty.
    • If the Material is associated with a Resource, and the state of the Material is Consumable, Durable, Dispatched, InProcess, or the property IsInStore is set to True, the Resource InventoryLocked must be False.
  • The TopMost of ParentMaterialTo, ParentMaterialTo, and Sub Material Package Count must be empty.
  • If the topmost of ParentMaterialFrom is assigned to a Resource, the TopMost of ParentMaterialTo must be assigned to the same Resource.
  • If the topmost of ParentMaterialFrom is assigned to a Resource, the ParentMaterialFrom and ParentMaterialTo must have the same depth, relative to the Topmost of ParentMaterialFrom and TopMost of ParentMaterialTo respectively.
  • The relationship ParentMaterialTo Form -> SubMaterial Form must be defined in the MaterialFormRelation generic table.
  • All ParentMaterialTo SubMaterials must be of the same Form, that is, if the Parent Material already has one SubMaterial, subsequent Materials must have the same Form of existing SubMaterials.
  • The transaction must not create a circular reference, that is, the SubMaterial cannot be an ascendant (parent, great parent, etc.) of the ParentMaterialTo.
  • SubMaterial being transferred is a child of the ParentMaterialFrom.
  • If topmost of ParentMaterialTo has a CurrentBOMVersion different from Null, the SubMaterial Product must be equal to the ParentMaterialTo Product.
  • The topmost of the ParentMaterialFrom and of ParentMaterialTo must have the CurrentMaterialTransfer property set to Null.

  • 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.

Sequence of Steps#

Step 1: Sub-Materials#

  1. Select the Sub-Materials that should be transferred to another Material by checking the respective checkbox.

transfer_submaterials

Step 2: Parent Material#

  1. Select the new parent Material for the Sub-Materials being transferred, by clicking on its respective line.

transfer_submaterials2

Sep 3: Sub-Materials Containers#

  1. For each Sub-Material, it is possible to specify a new Container. If the new Container does not auto-generate positions, it is necessary to specify the position in the Container, otherwise the position will be generated automatically.
  2. If more than one Sub-Material is being transferred and the same Container is to be chosen for every Sub-Material, click the button Apply Container to All Sub-Materials.
  3. Press Transfer to complete the operation.

transfer_submaterials3