Defining and Using Import Parameters 

Use

You want to assign values to the import parameters of a user-defined function, or to the import parameters of a standard function 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.

If you want to use import parameters in a user-defined function, you must have already created them and have defined the function parameters as signature variables in the function properties (you can only define import parameters there).

Since the import parameters are part of the signature of your user-defined function, you can access them directly in the source text.

Procedure

You must connect the function parameters to the message mapping parameters in the mapping editor.

...

       1.      In the mapping editor, switch to the Signature tab page. Enter import parameters in the table for those functions that will receive values for function parameters at runtime. You can use a message mapping import parameter to transfer values to multiple import function parameters.

       2.      In the mapping editor, switch to the Definition tab page. In the data-flow editor, call each of the target-field mappings with the functions to be parameterized, and perform the following steps for each function:

                            a.      To open the dialog box for editing the function parameters, double-click the function in the data-flow editor. Functions that have function parameters are indicated by the cogwheel icon ().

                            b.      Instead of entering constant values in the dialog box, choose Enhanced View (). Input help displays all message mapping import parameters on the Signature tab page that match the function parameter.

                            c.      Select a message mapping parameter to be connected to the function parameter and confirm by choosing Apply.

       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. You can use an operation mapping import parameter to transfer values to multiple message mapping import 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 import parameters to the operation mapping import parameters. You can also assign constants to the parameters in category Simple Type.

Since the value of a message mapping parameter that you have assigned a constant to is already defined, the constant is not displayed in the interface determination. At configuration time, you can only assign values to operation mapping parameters in the interface determination.

       8.      Save your operation mapping.

Result

Once you have activated your operation mapping, you can assign values to the import parameters in the following ways:

●      In Integration Directory interface determinations that reference the operation mapping.

●      Within a monitoring or integration process in the ES Repository by means of a transformation step that references the operation mapping.

Then, before the message mapping is executed, the mapping runtime forwards the values to the message mapping parameters by using the operation mapping parameters.