Events in PI Sheets and Cockpits (SAP Library - Process Management (PP-PI-PMA))

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. Using the internal interface Manufacturing Data Access, PI sheets and cockpits can access external events.

You can select an event through the value help for 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 Was Generated
DOCUMENT.SAVING	Saving Document
DOCUMENT.REPORTING	Reporting Data
DOCUMENT.REPORTED	Data Is Reported
DOCUMENT.LOGGED_IN	User Is Logged On
DOCUMENT.LOGGED_OFF	User Is Logged Off
DOCUMENT.COMPLETING	Completing Document
STEP.ACTIVATING	Activating Process Step
STEP.ACTIVATED	Process Step Was Activated
STEP.DEACTIVATING	Deactivating Step
STEP.DEACTIVATED	Step Was Deactivated
STEP.LOCKING	Locking Step
STEP.LOCKED	Step Was Locked
STEP.UNLOCKING	Unlocking Step
STEP.UNLOCKED	Step Was Unlocked
STEP.COMPLETING	Completing Step
PROC_INSTR.ACTIVATING	Activating Instruction
PROC_INSTR.ACTIVATED	Instruction Was Activated
PROC_INSTR.DEACTIVATING	Deactivating Instruction
PROC_INSTR.DEACTIVATED	Instruction Was Deactivated
PROC_INSTR.LOCKING	Locking Instruction
PROC_INSTR.LOCKED	Instruction Was Locked
PROC_INSTR.UNLOCKING	Unlocking Instruction
PROC_INSTR.UNLOCKED	Instruction Was Unlocked
PROC_INSTR.COMPLETING	Completing Instruction
TABLE.ACTIVATING	Activating Table
TABLE.ACTIVATED	Table Was Activated
TABLE.DEACTIVATING	Deactivating Table
TABLE.DEACTIVATED	Table Was Deactivated
TABLE.LOCKING	Locking Table
TABLE.LOCKED	Table Was Locked
TABLE.UNLOCKING	Unlocking Table
TABLE.UNLOCKED	Table Was Unlocked
TABLE.COMPLETING	Completing Table
TABLE_LINE.LINE_ADDING	Adding Line
TABLE_LINE.LINE_ADDED	Line Was Added
TABLE_LINE.ACTIVATING	Activating Line
TABLE_LINE.ACTIVATED	Line Was Activated
TABLE_LINE.DEACTIVATING	Deactivating Line
TABLE_LINE.DEACTIVATED	Line Was Deactivated
TABLE_LINE.LOCKING	Locking Line
TABLE_LINE.LOCKED	Line Was Locked
TABLE_LINE.UNLOCKING	Unlocking Line
TABLE_LINE.UNLOCKED	Line Was Unlocked
TABLE_LINE.COMPLETING	Completing Line
PARAMETER_CHANGED	Parameter Changed
COMPLETING	Completing
ACTIVATING	Activating
ACTIVATED	Activated
DEACTIVATING	Deactivating
DEACTIVATED	Deactivated
LOCKING	Locking
LOCKED	Locked
UNLOCKING	Unlocking
UNLOCKED	Unlocked

Internal Events in the Cockpit

You can use the following internal events within a manufacturing cockpit:

Internal Event	Meaning
DOCUMENT.COMPLETING	Completing Document
DOCUMENT.GENERATED	Document Was Generated
DOCUMENT.INITIALIZED	Document Was Initialized
DOCUMENT.INITIALIZING	Initializing Document
DOCUMENT.LOGGED_IN	User Is Logged On
DOCUMENT.LOGGED_OFF	User Is Logged Off
STEP.COMPLETING	Completing Step
STEP.INITIALIZED	Step Was Initialized
STEP.INITIALIZING	Initializing Step
PROC_INSTR.COMPLETING	Completing Instruction
PROC_INSTR.INITIALIZED	Instruction Was Initialized
PROC_INSTR.INITIALIZING	Initializing Instruction
TABLE.COMPLETING	Completing Table
TABLE.INITIALIZED	Table Was Initialized
TABLE.INITIALIZING	Initializing Table
TABLE.LINE_ADDED	Line Was Added
TABLE.LINE_ADDING	Adding Line
TABLE_LINE.COMPLETING	Completing Line
TABLE_LINE.INITIALIZED	Line Was Initialized
TABLE_LINE.INITIALIZING	Initializing Line
COMPLETING	Completing
INITIALIZING	Initializing
INITIALIZED	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:

Manufacturing Data Access

Manufacturing Events

For more information on how to use internal and external events in PI sheets and cockpits, see:

Type 0: Definition of Manufacturing Data Access

Type 0: Definition of Functions to Be Executed Automatically

Type 0: Definition of Calculations to Be Executed Automatically

Type 0: Definition of Dynamic Function Calls to Be Executed Automatically