Defining and Using Export Parameters 

Use

You want to use the transformation step and the export parameters of a user-defined function to transfer values to an integration or monitoring process at runtime

See also: Parameterized Message Mappings.

Prerequisites

You have loaded a source and a target structure to the mapping editor and are in change mode.

Procedure

...

       1.      In the mapping editor, switch to the Signature tab page. Enter export parameters in the table for all functions that are to transfer values to a transformation step at runtime. Note that you cannot enter the same export parameters for multiple functions.

       2.      Export parameters are not included in the signature of user-defined functions. They set their export parameters directly in the source text of the user-defined function:

if (exists(“MY_STR_PAR”) == true  && exists(“MY_INT_PAR”) == true  && exists(“MY_OBJ_PAR”) == true) { getOutputParameters.setString(    “MY_STR_PAR”, [value of type java.lang.String]); getOutputParameters.setInt(    “MY_INT_PAR”, [value of type int]); getOutputParameters.setValue(    “MY_OBJ_PAR”, [value of type java.lang.Object]); }

The names of the export parameters that you set in the source text must be identical to the names of the message mapping export parameters on the Signature tab page (not case-sensitive).

       3.      Save your message mapping.

To use your message mapping at configuration time, you must assign it to an appropriate operation mapping and connect the message mapping parameters to the operation mapping parameters:

       4.      If an appropriate operation mapping does not already exist, create one. Reference the operations that belong to the operation mapping and reference your parameterized message mapping (see: Operation Mapping).

       5.      To create the necessary operation mapping parameters, choose Parameters. Note that multiple message mapping export parameters cannot be connected to the same operation mapping export parameters.

       6.      In the Binding column in the table in frame Mapping Programs, there is a button for defining a binding (). Choose the button in the row in which your message mapping program is entered.

       7.      Assign interface mapping export parameters to the operation mapping export parameters.

       8.      Save your operation mapping.

Result

Once you have activated your operation mapping, you can access the export parameters in an integration or monitoring process (see: Transformation Step).