MaterialMovement Event Type
In the Event_Transactions table, the MaterialMovement event type is used to specify raw material movements, which are used to determine the lot ID, product code, and amount of a particular raw material that was consumed during the batch.
Multiple raw material movements are allowed, as well as multiple instances of the same raw material, as long as the EventTimestamp is different for each instance.
If none of the procedural information is specified, then it will be assumed that the current batch will be the destination of the material movement. Only the EventTimestamp will be used to timestamp the event component record.
When the EventType is MaterialMovement, the following fields in the Event_Transactions table are processed.
Field |
Required |
Notes |
EventType |
Yes |
Associates raw material movements with the batch event. |
EventTimestamp |
Yes |
Local timestamp event occurred in BES |
AreaName |
Yes |
Batch execution system AreaName, which maps to department in plant model. |
CellName |
Yes |
Batch execution system CellName, which maps to production line in plant model. |
UnitName |
Yes |
Batch execution system UnitName, which maps to production unit in plant model. |
BatchName |
Yes |
Name of the batch (including UnitCycleCount). |
UnitProcedureName |
Yes |
Name of unit procedure. If specified, the material movement is linked to the unit procedure. If not specified, the material movement is linked to the virtual batch. |
OperationName |
Yes |
Name of operation. If not specified, the current operation is assumed. |
PhaseName |
Yes |
Name of phase. If not specified, the current phase is assumed. |
PhaseInstance |
No |
Name of phase instance. If not specified, the current phase is assumed. |
ProcedureStartTime |
No |
If the ProcedureStartTime is not specified, it will use the event component start time as the Start_Time of the User-Defined Event. If it is specified, this will be used as the User-Defined Event Start_Time |
ProcedureEndTime |
No |
If the ProcedureEndTime is not specified, it will use the event component timestamp as the End_Time of the User-Defined Event. If it is specified, this will be used as the User-Defined Event End_Time. |
RawMaterialAreaName |
Yes |
Specifies the area or department of the raw material event that will be linked to the main batch event. |
RawMaterialCellName |
Yes |
Specifies the cell or production line of the raw material event that will be linked to the main batch event. |
RawMaterialUnitName |
Yes |
Specifies the production unit of the raw material event that will be linked to the main batch event. |
RawMaterialProductCode |
Yes |
Specifies the ProductCode of the raw material event that will be linked to the main batch event. If the RawMaterialProductCode is not found in Plant Applications, then a new product will be added. |
RawMaterialBatchName |
Yes |
Specifies the Event_Num or BatchName of the raw material event that will be linked to the main batch event. |
RawMaterialContainerId |
No |
The identification of the container moving the material. Not currently used. |
RawMaterialDimensionX |
Yes |
The weight of the material being consumed. Populates the DimensionX field in the Event_Components table. |
RawMaterialDimensionY |
Yes |
The length of the material being consumed. Populates the DimensionY field in the Event_Components table. |
RawMaterialDimensionZ |
Yes |
The width of the material being consumed. Populates the DimensionZ field in the Event_Components table. |
RawMaterialDimensionA |
Yes |
The diameter of the material being consumed. Populates the DimensionA field in the Event_Components table. |
UserName |
No |
The user creating or approving the transaction. |
UserSignature |
No |
The token of the user approving the transaction. |
BatchInstance |
No |
Assumes an instance of 1, if not specified. |
UnitProcedureInstance |
No |
Assumes an instance of 1, if not specified. |
OperationInstance |
No |
Assumes an instance of 1, if not specified. |