Events in PI Sheets and Cockpits 
Use
You can use events to automatically execute functions in PI sheets and cockpits that must normally be executed manually in the context menu.
The system distinguishes between internal events and external events:
Internal events can only occur within the same PI sheet or cockpit in which the function is to be triggered.
External events come from other applications, for example, from OPC servers or other cockpits. PI sheets and cockpits can access external events via the internal interface Manufacturing Data Access .
You can choose an event via the value help for the characteristic PPPI_EVENT.
Features
Internal Events in the PI Sheet
You can use the following internal events within the same PI sheet:
Internal Event |
Meaning |
|---|---|
DOCUMENT.GENERATED |
Document has been generated |
DOCUMENT.SAVING |
Document is being saved |
DOCUMENT.REPORTING |
Interim status being reported |
DOCUMENT.REPORTED |
Interim status has been reported |
DOCUMENT.LOGGED_IN |
User is logged on |
DOCUMENT.LOGGED_OFF |
User has logged off |
DOCUMENT.COMPLETING |
Document being completed |
STEP.ACTIVATING |
Workstep being activated |
STEP.ACTIVATED |
Workstep has been activated |
STEP.DEACTIVATING |
Step being deactivated |
STEP.DEACTIVATED |
Step has been deactivated |
STEP.LOCKING |
Step being locked |
STEP.LOCKED |
Step has been locked |
STEP.UNLOCKING |
Step being unlocked |
STEP.UNLOCKED |
Step has been unlocked |
STEP.COMPLETING |
Step has been completed |
PROC_INSTR.ACTIVATING |
Instruction being activated |
PROC_INSTR.ACTIVATED |
Instruction has been activated |
PROC_INSTR.DEACTIVATING |
Instruction being deactivated |
PROC_INSTR.DEACTIVATED |
Instruction has been deactivated |
PROC_INSTR.LOCKING |
Instruction being locked |
PROC_INSTR.LOCKED |
Instruction has been locked |
PROC_INSTR.UNLOCKING |
Instruction being unlocked |
PROC_INSTR.UNLOCKED |
Instruction has been unlocked |
PROC_INSTR.COMPLETING |
Instruction being completed |
TABLE.ACTIVATING |
Table being activated |
TABLE.ACTIVATED |
Table has been activated |
TABLE.DEACTIVATING |
Table being deactivated |
TABLE.DEACTIVATED |
Table has been deactivated |
TABLE.LOCKING |
Table being locked |
TABLE.LOCKED |
Table has been locked |
TABLE.UNLOCKING |
Table being unlocked |
TABLE.UNLOCKED |
Table has been unlocked |
TABLE.COMPLETING |
Table being completed |
TABLE_LINE.LINE_ADDING |
Line being added |
TABLE_LINE.LINE_ADDED |
Line has been added |
TABLE_LINE.ACTIVATING |
Line being activated |
TABLE_LINE.ACTIVATED |
Line has been activated |
TABLE_LINE.DEACTIVATING |
Line being deactivated |
TABLE_LINE.DEACTIVATED |
Line has been deactivated |
TABLE_LINE.LOCKING |
Line being locked |
TABLE_LINE.LOCKED |
Line has been locked |
TABLE_LINE.UNLOCKING |
Line being unlocked |
TABLE_LINE.UNLOCKED |
Line has been unlocked |
TABLE_LINE.COMPLETING |
Line being completed |
Parameter changed |
|
COMPLETING |
Being completed |
ACTIVATING |
Being activated |
ACTIVATED |
Has been activated |
DEACTIVATING |
Being deactivated |
DEACTIVATED |
Has been deactivated |
LOCKING |
Being locked |
LOCKED |
Has been locked |
UNLOCKING |
Being unlocked |
UNLOCKED |
Has been unlocked |
Internal Events in the Cockpit
You can use the following internal events within a manufacturing cockpit:
Internal Event |
Meaning |
|---|---|
DOCUMENT.COMPLETING |
Document being completed |
DOCUMENT.GENERATED |
Document has been generated |
DOCUMENT.INITIALIZED |
Document has been initialized |
DOCUMENT.INITIALIZING |
Document being initialized |
DOCUMENT.LOGGED_IN |
User is logged on |
DOCUMENT.LOGGED_OFF |
User has logged off |
STEP.COMPLETING |
Step has been completed |
STEP.INITIALIZED |
Step has been initialized |
STEP.INITIALIZING |
Step being initialized |
PROC_INSTR.COMPLETING |
Instruction being completed |
PROC_INSTR.INITIALIZED |
Instruction has been initialized |
PROC_INSTR.INITIALIZING |
Instruction being initialized |
TABLE.COMPLETING |
Table being completed |
TABLE.INITIALIZED |
Table has been initialized |
TABLE.INITIALIZING |
Table being initialized |
TABLE.LINE_ADDED |
Line has been added |
TABLE.LINE_ADDING |
Line being added |
TABLE_LINE.COMPLETING |
Line being completed |
TABLE_LINE.INITIALIZED |
Line has been initialized |
TABLE_LINE.INITIALIZING |
Line being initialized |
COMPLETING |
Being completed |
INITIALIZING |
Being initialized |
INITIALIZED |
Has been initialized |
PARAMETER_CHANGED |
Parameter changed |
External Events
External events are events that occur in other applications. Applications that have registered at the internal interface Manufacturing Data Access as services can provide or receive events.
PI sheets and cockpits can subscribe to an external event. The PI sheet or cockpit is notified when the event occurs in the relevant application. This event can, in turn, trigger certain functions in the PI sheet or cockpit.
At present, you can receive external events from the following applications or services in the PI sheet or cockpit:
Other PI sheets (service PSH)
Other manufacturing cockpits (service PMC)
OPC Data Access servers (Service ODA)
OPC Alarms/Events servers (service OAE)
Service MDA: Generic services
For more information on external events, see:
For more information on how to use internal and external events in PI sheets and cockpits, see: