Transfer Material between Containers#

Material.TransferBetweenContainers

Overview#

This operation is used to transfer a Material from one Container to another.

Setup#

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

Preconditions#

• For the Material:

  • The Material is Active, Not OnHold and not InTransit.
  • The Material has a Container associated with it.
  • The old Container is in state Available.

• For the new Container:

  • Container is Active and UsedPositions < TotalPositions or TotalPositions = -1.
  • The Container is in state Available.
  • Container PositionUnitType must be Material.
  • If the Container IsAutoGeneratePositionEnabled is set to False, the supplied position must not be in use at the Container.
  • Depending on the CapacityValidationMode:
    • Units - CapacityUnits are the same as either the PrimaryUnits or SecondaryUnits of the Material being transferred. The units are taken from the Material, not the Step.
    • Form - Form of the Material must match the Container CapacityForm.
    • None - no check.
• If the CapacityValidationMode is Units, the quantity of the Material being transferred does not exceed the CapacityPerPosition (or CapacityPerPosition = -1)
• The new Container must be different from the old Container.
• The new Container HoldCount must be zero.
• The Facility of the new Container must be the same as the Facility of the old Container.

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

1. Verify the Material information.
2. Select the new Container to which the Material is going to be transferred.
3. Click Transfer to complete the operation.