Type 0: Definition of Export Parameters (SAP Library

Type 0: Definition of Export Parameters

Use

Note that by export parameter we mean the export parameters of the PI sheet or cockpit (PPPI_EXPORT_PARAMETER), which are the values that are transferred from the PI sheet or cockpit to the function module. From the function module's point of view, they are import parameters.

You define export parameters (import parameters of the function module) in dynamic function calls and input validations that are carried out using a check function.

Prerequisites

If you want to pass on the value of a variable to the function module, the variable must be defined in the same PI sheet or in the same cockpit. For PI sheets, the variable may also have been defined for the entire process order.

For more information on how to use system variables and variables in general, see:

Using Variables in Browser-Based PI Sheets and Cockpits

Using System Variables in Browser-Based PI Sheets

Activities

When defining export parameters, you specify the following information in the process instruction:

All required import parameters of the function module;
Import parameters are required if the Optional indicator has not been set. They must be specified in the process instruction.

Optional import parameters of the function module for which you do not want to use the default value defined in the function module;
Import parameters are optional if the Optional indicator has been set. They need not be specified in the process instruction.

If required, the characteristic optional parameter transfer for optional parameters whose value you do not want to pass on when the function call is executed;
See also Type 0: Optional Parameter Transfer.

The parameter name for each parameter to be passed on

The variable, constant, or message characteristic for each parameter value to be passed on
You can only pass on the value of a variable or constant to a parameter if the variable or constant has the same data type as the parameter in the function module.

Notes on Parameter Value Assignment

If the value is available in the process order, you enter it as a fixed value in the form of:

A constant
The characteristic you use to define the constant also determines the constant's data type.
A message characteristic
If you want to use a message characteristic, the characteristic must have the same data type as the parameter in the function module. You may want to use a message characteristic if the characteristic value is assigned in the order.

If the value is only available in the PI sheet, you transfer it from a preceding process instruction using a variable. The variable has the same data type as the value to which it refers. In the process instruction, you must assign the variable to the appropriate characteristic depending on the data type.
In input validations, you use variable SY_VALUE or X to transfer the input value to be checked. The variable always refers to the value entered immediately before.

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

Characteristic	Meaning	Allowed Values
PPPI_EXPORT_PARAMETER	Export parameters	Import parameters of the function module
< PPPI_STRING_CONSTANT or < PPPI_FLOAT_CONSTANT or < PPPI_DATE_CONSTANT or < PPPI_TIME_CONSTANT or < PPPI_STRING_VARIABLE or < PPPI_FLOAT_VARIABLE or < PPPI_DATE_VARIABLE or < PPPI_TIME_VARIABLE or < <Message characteristic>	Value transfer in constant: < Alphanumerical value < Floating point number < Date < Time Value transfer in variable: < Alphanumerical value < Floating point number < Date < Time For value assignment using message characteristic: < Message characteristic	Any fixed value of data type: < Alphanumerical value < Floating point number < Date < Time Existing variable of data type: < Alphanumerical value < Floating point number < Date < Time < Any message characteristic
PPPI_OPTIONAL_PARAMETER	Optional parameter transfer	< Parameter transfer not optional < Parameter transfer optional