Show TOC

Using the Lookup API in a Java Mapping ProgramLocate this document in the navigation structure

Prerequisites

Note the prerequisites for the adapter that you want to use for the lookup (see: Adding Lookups to Mapping Programs ).

Procedure

1. Implement a Parameterized Java Mapping Program

  1. To be able to execute the lookup, your Java mapping program requires an import parameter of type Adapter . Create a Java mapping (see steps 1 and 2 in Parameterizing Java Mappings ).

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

  3. To be able to assign a receiver channel to this import parameter later, you must assign the import parameter to an operation mapping parameter by using a binding (see steps 3-7 in Parameterized Java Mappings ).

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 communication 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 Java 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 Java mapping program will terminate with an error message.

Result

You have implemented a lookup in your Java mapping program, and have configured it in the Integration Directory. You can now test the Java mapping program in the operation mapping (see: Test Environment for Operation Mappings ).