Message Characteristics - Manual Value Assignment

Use

If you want to assign a characteristic value manually in the PI sheet, you mark the characteristic as an input value in the process data request. You also specify how the input value is processed in the PI sheet, that is, whether the system offers a default value or whether an input validation should take place.

In the PI sheet, the system creates an input field or - in repeated data requests - a table column for the input value.

Note Note

You also define signatures that you use to sign a process step in the PI sheet as input values. For more information, see Definition of Signatures .

End of the note.

Prerequisites

The characteristic you mark as an input value must be contained in the message category that is assigned to the process instruction.

Features

In general, you can define any message characteristic as an input characteristic in a process data request. However, note the following restrictions with respect to repeated process data requests :

No more than 10 input values with a total of up to 150 characters are allowed, that is, the input table can have a maximum of 10 columns or a maximum table width of 150 characters.
Input characteristics whose value is a long text may only be used in simple data request.

Basic Functions

When you define an input value, you must at least enter the following information in the process instruction (see graphic below):

A text that is to be displayed before the corresponding input field or above the corresponding table column in the PI sheet
The key of the message characteristic whose value you want to enter

If required, you can also enter a unit of measurement for the input value. The unit of measurement is displayed after the input field or above the corresponding table column in the PI sheet.

( )

To enter this information, you assign the following characteristics to the process instruction in the sequence specified below:

Characteristic	Meaning	Value
PPPI_INPUT_REQUEST	Input request	Any short text
PPPI_REQUESTED_VALUE	Message characteristic whose value is assigned manually	Characteristics of the assigned message category
PPPI_UNIT_OF_MEASURE	Unit of measurement	Unit of measurement defined in the system

Note Note

A value can be assigned automatically to the characteristics specifying the date (PPPI_EVENT_DATE) and time (PPPI_EVENT_TIME) in the PI sheet. If you define these characteristics as input values, the system proposes the current values as possible entries in the PI sheet. Unlike automatic value assignment, however, you can still change the value.

End of the note.

Additional Functions

You can enter additional information that controls PI sheet processing for each input value in the process instruction (see graphic below). You can define the following:

A heading to group several input values
A default value for the input value
A variable for the input value
An input validation

( )

The table below gives an overview of the characteristics you can use to enter this information in the process instruction. The characteristics are listed in the order in which you must assign them to the process instruction.

For more detailed information on the individual functions, see the corresponding sections.

Function	Characteristic	Value
Grouping of input values	PPPI_INPUT_GROUP	Any short text (heading)
Input request	PPPI_INPUT_REQUEST	Any short text
Default value Constant value Variable	Mess. char. to be assigned a value PPPI_DEFAULT_VARIABLE	Acc. to char. definition Variable name
Variable Local Global	PPPI_VARIABLE PPPI_GLOBAL_VARIABLE	New variable name, valid in PI sheet New variable name, valid in process order
Message characteristic whose value is assigned manually	PPPI_REQUESTED_VALUE	Characteristic of the assigned message
Input validation Check formula Check function Export parameters Parameter value Changing parameters Parameter value Import parameters Parameter value Warning Accepting invalid values Authorization for signature	PPPI_VALIDATION_FORMULA PPPI_VALIDATION_FUNCTION PPPI_EXPORT_PARAMETER PPPI_<data type>_CONSTANT any other characteristic PPPI_<data type>_VARIABLE PPPI_CHANGING_PARAMETER PPPI_<data type>_VARIABLE PPPI_IMPORT_PARAMETER PPPI_<data type>_VARIABLE (<data type> = STRING, FLOAT, DATE, TIME) PPPI_TEXT_FOR_INVALID_ INPUT PPPI_ACCEPT_INVALID_INPUT PPPI_SIGNATURE_ AUTHORIZATION	Boolean formula Function module name Import parameters of the function module Fixed value Fixed value Variable name Changing parameters of the function module Variable name Export parameters of the function module New variable name Long text No Yes With signature only Activity for authorization object C_CRPI_BER
Unit of measurement	PPPI_UNIT_OF_MEASURE	Unit of measurement

See also:

Definition of Signatures