You can define a variable that refers to the value of a characteristic. To do so, you must add the PPPI_VARIABLE characteristic immediately before the relevant characteristic.
You can use variables that have been defined in a process instruction using the PPPI_VARIABLE characteristic in all subsequent process instructions of the same PI sheet (for example, in calculation formulas or for input validations). Variables that have been defined in a process instruction using the PPPI_GLOBAL_VARIABLE characteristic are valid within the entire process order.
You must define all message characteristics whose value you want to have assigned automatically in the PI sheet as the value for the PPPI_AUTOMATIC_VALUE characteristic. This is only possible for PPPI_EVENT_DATE (event date) and PPPI_EVENT_TIME (event time) characteristics.
You can also define a variable for characteristics whose values are assigned automatically.
You can also define a variable that refers to an input value. To do so, you must also add characteristic PPPI_VARIABLE directly before defining the input value. You can assign any variable name as the value to the PPPI_VARIABLE characteristic. (Do not use X, blanks and arithmetic operators as part of the variable name, or the following character strings at the end of the variable name: _COUNT, _SUM, _<number>, for example, _1,_2).
I n t e r n a l U s e S A P P a r t n e r O n l y I n t e r n a l U s e S A P P a r t n e r O n l y
SAP AG 2003
Type 0 process instruction Input Validation
Input value
PPPI_VALIDATION_FORMULA Validation rule Long text
PPPI_REQUESTED_VALUE Input characteristic PPPI_INPUT_REQUEST Short text
The following is an example for an input validation: PPPI_VALIDATION_FORMULA x>50 AND x<100.
In addition to the validation rule, you can define a warning message in the data request
(PPPI_TEXT_FOR_INVALID_INPUT characteristic). This message is displayed in the PI sheet if the input value fails the input validation.
You can use the PPPI_ACCEPT_INVALID_INPUT characteristic to determine whether invalid input values are only accepted in the PI sheet if a signature is entered or whether they are not accepted at all.
The Customizing for the control recipe destination indicates which type of signature is required. The following types are available:
y Signature without password check y Signature with simple password check y Digital signature
You can use the PPPI_SIGNATURE_AUTHORIZATION characteristic to specify that a special maintenance authorization for PI sheets is required for signatures with a simple password check and for digital signatures (C_CRPI_BER authorization object, "Activity" field).
I n t e r n a l U s e S A P P a r t n e r O n l y I n t e r n a l U s e S A P P a r t n e r O n l y
SAP AG 2003
Type 0 process instruction Definition of Calculations
PPPI_INPUT_REQUEST Short text
PPPI_CALCULATED_VALUE Characteristic for which you want to calculate the value PPPI_CALCULATION_FORMULA Calculation formula
PPPI_VARIABLE Variable name
Calculation:
Optional Key
Name of characteristic PPPI_...
You must assign the message characteristic whose value you want to calculate in the PI sheet to the PPPI_CALCULATED_VALUE characteristic.
You use the PPPI_CALCULATION_FORMULA characteristic to define the formula you want to use for the calculation. Note the following:
y You can use variables in your calculation formula to refer to values that have been entered or have already been calculated. Always use the decimal point for decimals.
y You can split long formulas into a maximum of eight formula definitions.
In addition to the calculation formula, you must define a text that is displayed before the formula result (PPPI_INPUT_REQUEST characteristic). If necessary, you can also define a unit of measure
(PPPI_UNIT_OF_MEASURE characteristic) that is displayed after the formula result.
Note that you must assign the characteristics in the same sequence as shown in the graphic.
In addition to this minimum information that a calculation formula must contain, you can also define a variable that refers to the calculated value. To do this, you must place the PPPI_VARIABLE
characteristic immediately before the definition of the calculated value. The variable automatically has the same data type as the message characteristic (for example, CHAR or NUM).
I n t e r n a l U s e S A P P a r t n e r O n l y I n t e r n a l U s e S A P P a r t n e r O n l y
SAP AG 2003
Type 0 process instruction Requesting Messages
PPPI_MESSAGE_CATEGORY Message category
Message characteristics: Value assigned in planning
Message characteristics: Value assigned autom. in the PI sheet
Message characteristics: Value assigned manually in the PI sheet PPPI_INPUT_REQUEST Short text
Message characteristic Value according to characteristic definition
PPPI_AUTOMATIC_VALUE PPPI_EVENT_DATE , or PPPI_EVENT_TIME
PPPI_CALCULATED_VALUE Calculation character.
or
PPPI_REQUESTED_VALUE Input characteristic
The graphic shows the minimum amount of information a process data request must contain:
y The requested message category
y All required characteristics of this message category and all optional characteristics to be contained in the message
How you include a message characteristic in the data request depends on where the characteristic value is to be assigned:
y Value assigned in planning (that is, in Customizing, the master recipe, or the process order):
Directly assign the characteristic to the data request. In the PI sheet, it is transferred to the message together with its value.
y Value assigned automatically in the PI sheet:
This is only possible for the PPPI_EVENT_DATE (event date) and PPPI_EVENT_TIME (event time) characteristics. Assign these characteristics to the PPPI_AUTOMATIC_VALUE characteristic.
y Value assigned manually in the PI sheet:
Assign the message characteristic to the PPPI_REQUESTED_VALUE or PPPI_CALCULATED_VALUE characteristic.
In addition, you must define an input request for the input field. You can also define the unit of
I n t e r n a l U s e S A P P a r t n e r O n l y I n t e r n a l U s e S A P P a r t n e r O n l y
SAP AG 2003
Message characteristics