Show TOC

Procedure documentationImplementing Functions of Function Libraries Locate this document in the navigation structure

 

You want to use Java functions of a function library within a message mapping.

Prerequisites

  • The function library is in the same software component version as the message mapping in which you want to use the functions of the function library, or in an underlying version.

  • There is already a corresponding function library and a corresponding message mapping in the ES Repository.

  • You have loaded a source structure and a target structure to the definition page of the mapping editor.

Procedure

  1. The function libraries are imported from the dependencies page in the message mapping editor.

  2. To add a function library to the table, proceed as follows:

    1. Choose the category node Function Libraries.

    2. Choose the Add button and browse for the function library you want to use.

    3. A unique instance name is generated for each function library. In this way, you can use a function library more than once in a message mapping if you need different object instances of the class belonging to the function library.

  3. Save your changes.

Note Note

Use the functions in the expression editor using the name of the method entered in the Java editor. Its possible there are multiple functions with the same Java name and the signature coming from multiple function libraries that are imported. In such cases it is required to provide the unique prefix associated with the instance name for each function library usage. The instance name is mentioned next to the category node in the expression editor in parentheses.

End of the note.

Result

The functions of the function library entered in the mapping editor appear in the expression editor under the category with name same as the instance name.

Note Note

If you use multiple function libraries in a message mapping, there are several Java area Attributes and Methods, and several init()and cleanUp() methods. The mapping runtime executes this source text at the beginning or end of the message mapping in the sequence in which you have entered the corresponding function libraries in the table for using the libraries.

End of the note.