Type 0: Definition of Functions to Be Executed Automatically

Use

You can use this function to define conditions that automatically trigger the automatic execution of functions such as Deactivate process instruction or Lock process step in the context menu.

Example Example

You want to specify, for example, that the quantity recording for a certain material depends on the current pH value of the mixture in the vessel. This means that the material quantity may not be recorded until the process operator has measured a pH value of less than seven (< 7).

Using this function, you define this condition in the process order or master recipe. When the PI sheet is opened, the input field for material quantity recording would first be locked. The lock for the input field for material quantities would only be removed after a pH value of less than seven was entered in the preceding input field. The material quantity field would become ready for input.

End of the example.

Prerequisites

OPC Events

To use events of the service OAE (OPC Alarms/Events), you must first have created a subscription in Customizing.

To do so, go to Customizing for Process Management and choose SAP ODA (OPC Data Access) .

For more information about SAP ODA, see SAP OPC Data Access .

Features

You can define conditions to automatically execute the following functions:

-Save document

-Document report data

-Activate process step

-Deactivate process step

-Lock process step

-Unlock process step

-Complete process step

-Activate process instruction

-Deactivate process instruction

-Lock process instruction

-Unlock process instruction

-Complete process instruction

-Activate table

-Deactivate table

-Lock table

-Unlock table

-Complete table

-Add table line

-Activate table line

-Deactivate table line

-Lock table line

-Unlock table line

-Complete table line

Conditions

You can define conditions for the automatic execution of functions as follows:

In a formula (PPPI_FORMULA)
In a function module (PPPI_FUNCTION)
As a manufacturing event (PPPI_EVENT)

Value Assignment of PPPI_EVENT

You must assign an address to PPPI_EVENT that contains the name of the event to which the PI sheet or cockpit wants to subscribe. The system distinguishes between internal events and external events.

For more information on internal and external events, see:

Activities

When defining functions to be executed automatically, you define the following characteristics in the process instruction in the sequence specified:

In a Formula

Characteristic	Meaning	Value
PPPI_COMMAND	Specifies the function that is to be executed, shown, or hidden when the condition is fulfilled	A function from the context menu
PPPI_ACTION	Specifies whether the function is to be executed, shown, or hidden (optional)	Execute, show, or hide
PPPI_FORMULA	Specifies the calculation formula in which the conditions are defined. The function is triggered when the conditions are fulfilled.	Calculation formula

Example Example

Example for PPPI_FORMULA

Process instruction 0020 is to be deactivated when the value entered in process instruction 0010 is greater than 100. At the same time, process instruction 0020 is to be activated again when the value is less than or equal to 100.

Process instruction 0010:

End of the example.

	PPPI_DATA_REQUEST_TYPE	Simple data request
	PPPI_INPUT_REQUEST	Record quantity ABC:
	PPPI_VARIABLE	VAR
	PPPI_REQUESTED_VALUE	PPPI_MATERIAL_CONSUMED

Process instruction 0020:

	PPPI_DATA_REQUEST_TYPE	Simple data request
	PPPI_INPUT_REQUEST	Record quantity XYZ
	PPPI_REQUESTED_VALUE	PPPI_MATERIAL_CONSUMED
	PPPI_COMMAND	Deactivate process instruction
	PPPI_ACTION	Execute
	PPPI_FORMULA	VAR > 100
	PPPI_COMMAND	Activate process instruction
	PPPI_ACTION	Execute
	PPPI_FORMULA	VAR =< 100

In a Function Module

Characteristic	Meaning	Value
PPPI_COMMAND	Specifies the function that is to be executed, shown, or hidden when the condition is fulfilled	A function from the context menu
PPPI_ACTION	Specifies whether the function is to be executed, shown, or hidden (optional)	Execute, show, or hide
PPPI_FUNCTION	Specifies the function module in which the conditions are defined. The function is triggered when the conditions are fulfilled.	Name of the function module
One of the following parameter characteristics: < <Export parameter> < <Changing parameter> < <Import parameter>	Parameters according to definition in function module: < Export parameters < Changing parameters < Import parameters	Parameters of the function module < Import parameters < Changing parameters < Export parameters
Characteristic for the variable/constant that has the same data type as the parameter	Value transfer in constant, variable, or through message characteristic	Any fixed value, existing variable, or any message characteristic with the corresponding data type

Example Example

Example for PPPI_FUNCTION

Process instruction 0010: The pH value for material CATALYST is to be recorded.

Process instruction 0020: Depending on the pH value measured, the process operator is to add lye and record the quantity added. At the same time, function module PHVAL_CHECK is defined to check whether the pH value from process instruction 0010 is at least four. It also checks other factors such as the quality of the material by consulting data from material classification.

If the pH value is less than four (< 4) or other inspection criteria is not met, process instruction 0020 is deactivated and the process operator must not add lye.

Process instruction 0010:

End of the example.

	PPPI_DATA_REQUEST_TYPE	Simple data request
	PPPI_VARIABLE	MY_MAT
	PPPI_MATERIAL	CATALYST
	PPPI_OUTPUT_CHARACTERISTIC	PPPI_MATERIAL
	PPPI_INPUT_REQUEST	Record pH value
	PPPI_VARIABLE	PHVALUE
	PPPI_REQUESTED_VALUE	PPPI_MATERIAL

Process instruction 0020:

	PPPI_INPUT_REQUEST	Lye quantity added
	PPPI_VARIABLE	MY_MAT
	PPPI_REQUESTED_VALUE	PPPI_MATERIAL_CONSUMED
	PPPI_COMMAND	Activate process instruction
	PPPI_ACTION	Execute
	PPPI_FUNCTION	PHVAL_CHECK
	PPPI_EXPORT_PARAMETER	MATNR
	PPPI_STRING_VARIABLE	MY_MAT
	PPPI_EXPORT_PARAMETER	PHVALUE
	PPPI_FLOAT_VARIABLE	MY_VALUE

As a Manufacturing Event (PPPI_EVENT)

Characteristic	Meaning	Value
PPPI_COMMAND	Specifies the function that is to be executed, shown, or hidden when the condition is fulfilled	A function from the context menu
PPPI_ACTION	Specifies whether the function is to be executed, shown, or hidden (optional)	Execute, show, or hide
PPPI_EVENT	Specifies an internal event (for example, Process Instruction Locked ) or an external event (for example, OPC event). The function is triggered when the event occurs.	Internal event or the address of an external event

Example Example

Example for PPPI_EVENT

In operation 0010, the quantity of material MAT003 charged into vessel 123 is to be recorded and confirmed by executing a signature.

In operation 0020, the quantity of material MAT005 charged into vessel 155 is to be recorded and confirmed by executing a signature. In addition, it is defined that the system is to lock the current process step as soon as the external event MY_OAE from plant 0001 of service OAE occurs. This means that the section between the first and the second signature is locked since this is considered a process step.

Operation 0010:

End of the example.

	PPPI_DATA_REQUEST_TYPE	Simple data request
	PPPI_INPUT_REQUEST	Vessel 123:
	PPPI_REQUESTED_VALUE	PPPI_MATERIAL_CONSUMED
	PPPI_MATERIAL	MAT003
	PPPI_OUTPUT_CHARACTERISTIC	PPPI_MATERIAL
	PPPI_INPUT_REQUEST	Signature
	PPPI_REQUESTED_VALUE	PPPI_SIGNATURE

Operation 0020:

	PPPI_DATA_REQUEST_TYPE	Simple data request
	PPPI_INPUT_REQUEST	Vessel 155:
	PPPI_REQUESTED_VALUE	PPPI_MATERIAL_CONSUMED
	PPPI_OUTPUT_CHARACTERISTIC	MAT005
	PPPI_COMMAND	Lock process step
	PPPI_ACTION	Execute
	PPPI_EVENT	OAE:0001.MY_SUBSKRIPTION.EVT
	PPPI_INPUT_REQUEST	Signature
	PPPI_REQUESTED_VALUE	PPPI_SIGNATURE