Using the Lookup API in a Message Mapping

1. Implement a Parameterized Message Mapping Program

1. To execute the lookup, your user-defined function requires an import function parameter of type Adapter , which is assigned to the message mapping parameter (see step 1-3 in Defining and Using Import Parameters ).

2. Using the lookup API and the import parameter, implement the call to the application system

   • If the features of the standard function for graphical JDBC lookups (see above) are not sufficient for your application, use the specific lookup API for the JDBC adapter.

     More information: Implementing Lookups Using DataBaseAccessor

   • For calls with all other adapters, use the generic lookup API

     More information: Implementing Lookups Using SystemAccessor

3. If, later, you want to assign a receiver channel to the message mapping parameter that you assigned the import function parameter to in step 1, you must assign this import parameter to an operation mapping parameter by using a binding (see step 4-8 in Defining and Using Import Parameters ).

To execute or test the mapping program and the mapping lookup, perform the following steps in the Integration Directory:

2. Configure a Receiver Channel for Mapping Lookups

1. Create the receiver channel for the application system call in the Integration Directory.

   More information: Defining Communication Channels

2. To transfer the ID of the receiver channel to your message mapping program at runtime, create an interface determination and assign it to the operation mapping from step 3.

   More information: Defining an Interface Determination

   Caution

   You can only execute the mapping lookup once you have performed these steps and have installed the runtime components of the Integration Server. If this is not the case, the message mapping program will terminate with an error message.