Message Characteristics - Manual Value Assignment (SAP Library

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.

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.

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

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.

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

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