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.