Tracing ing on SAP XI

ArticleDirectory

• Eclipse plug-in for appleid
• The appleid 2380 HTTP interface

Tracing ing on SAP XI

The Xi adapter for tn5250 is used to connect the Integration Server to back-end applications. it enables messages to be exchanged by converting the XI Message format to tn5250 service call and converting the result of the service call back to an xi message. when you wish to create a communication path from the Integration Server or the PCK to a program or subprogram on the remote host, a number of configuration steps are required.

 

To convert Xi messages to a tn5250 service call you will need:

1. Retrieve the WSDL file of an applinx procedure group.

2. Tasks saved med from the design: Integration Builder tool:

   1. Create an external definition.

   2. Create a message interface. (For each web method you will need to create a separate message interface .)

   3. Activate your settings.

3. Tasks saved med from the configuration: Integration Builder tool:

   1. Define a service.

   2. Define a communication channel.

   3. Define the specified er determination.

   4. Define the interface determination.

   5. Define the receive agreement.

   6. Activate your settings.

Retrieving the WSDL file of an applinx procedure group

A wsdl file can be created either using Eclipse plug-in for appleid or via the http: // localhost: 2380/applinx address on your browser. the WSDL file contains one or more web methods for a specific web service.

• Eclipse plug-in for appleid

• The appleid 2380 HTTP interface

Eclipse plug-in for appleid

ReferApplw.user Guide, The applinx plug-in for eclipse appendix for details regarding how to install and work with the plug-in.

Right-click on a procedure group and selectGenerate WSDL.

The appleid 2380 HTTP interface

The WSDL file can be retrieved using the appleid web interface. in other words, you can connect to the appleid server through your browser and retrieve the WSDL file from the server using procedures (web methods ).

To retrieve the WSDL file using the appleid Web Interface

1. Type the following HTTP address:Http: // <applinx server: Web interface port>/appleid(For example:Http: // localhost: 2380/appleid) In your browser to connect to the appleid server. A list of host applications defined in the appleid server appears.

2. Click the requested application. A list of procedure groups (Web Services) for the application appears.

3. Click [WSDL (wrapped)] next to the name of the relevant procedure group. The WSDL file will be opened as an XML file.

4. Save the file with a suitable name, with the. WSDL extension.

Creating an external Definition

To create an external Definition

2. Open the design integration builder.

4. In the node of your product namespace, right-clickExternal DefinitionNode, and selectNew....

   The create object: External definition screen is displayed.

6. Enter a suitable name and clickCreateTo create the external definition. The edit external definition screen is displayed.

8. Ensure that the selected category is "WSDL ".

10. Click onImport external definitionsButton. The open dialog box is displayed.

12. Browse and locate the WSDL file retrieved inRetrieving the WSDL file of an applinx procedure group.

14. Save the external definition.

Creating a message interface

For each web method, it is necessary to create a separate message interface.

To create a message interface

1. Open the design integration builder.

2. Right-clickMessage InterfacesNode, and selectNew....

   The create object: message interface screen is displayed.

3. Enter a suitable name and clickCreateTo create the message interface. The edit message interface screen is displayed.

4. Ensure that "inbound" is the category selected.

5. Ensure that "synchronous" is the mode selected.

6. Click on the display input help icon to browse and select the input message.

7. Click on the display input help icon to browse and select the Output Message.

8. Save the message interface.

Defining a service

To define a service

2. Open the configuration integration builder.

4. ExpandService without PartyNode, right-clickBusiness ServiceNode, and selectNew....

   The Business Service screen is displayed.

6. Enter a suitable name for the service and clickCreate. The edit service screen is displayed.

8. In the specified er tab, inbound interfaces, click the insert line below selection icon. An empty row will be added.

10. Click the display list of permitted values icon to display the Select Interface screen.

12. Select the message interface that you defined in creating an external definition. ClickOK.

14. Save your definitions.

Defining a communication channel

 

To define a communication channel

2. In the edit service screen, click the create object icon in order to create a new communication channel.

   The communication channel is displayed.

4. Enter a name for the communication channel and clickCreate. The edit communication channel screen is displayed.

6. In the parameters tab,Adapter type, Click the display input help icon to display the list of adapters.

8. Select tn5250 and click OK. The contents of the parameters tab change accordingly.

10. Select the Message Protocol as 5250.

12. Enter the connection parameters: the IP name or address of the applinx server (mandatory) and the corresponding port number (2380 is the default port number ).

14. Define the application parameters: the name of the application to connect to, the relevant service in Appleton and the method.

    Note:
    In order for the method name to be the same as the communication channel name, type * as the method name.

16. Set the adapter to active to enable messages to be exchanged.

18. Save your changes.

Note:
You need to define a separate communication channel for each appleid web method that you want to use.

Defining the specified er Determination

To define the specified er Determination

2. In the configuration integration builder, right-clickReceiver DeterminationAnd selectNew....

   The specified er determination screen is displayed.

4. In the service field, click the display list of permitted values icon to display the list of services.

6. Select the service that is to provide the data to appleid.

8. Enter the name of the message interface that you defined in creating a message interface.

10. Enter the namespace that you used when creating the message interface.

12. ClickCreate. The edit rule er determination screen is displayed.

14. In the configured receivers area, click on the insert line below selection icon. An empty row will be added.

16. In the services cell, click on the icon and select the service you defined in defining a new service.

18. ClickSave.

Defining the interface Determination

To define the interface Determination

2. In the configuration integration builder, right-clickInterface DeterminationAnd selectNew....

   The interface determination screen is displayed.

4. In the service field, click the display list of permitted values icon to display the list of services.

6. Select the service that is to provide the data to appleid and clickOK.

8. Enter the name of the message interface that you defined in creating a message interface.

10. Enter the namespace that you used when creating the message interface.

12. Click the display list of permitted values icon to display the list of services. Select the service that you defined in defining a service.

14. ClickCreate. The edit interface determination screen is displayed.

    Click the display input help icon to display the list of interfaces. Select the relevant interface and clickOK.

16. ClickSave.

Defining the aggreger agreement

To define a comment er agreement

2. In the configuration integration builder, right-clickReceiver agreementAnd selectNew....

   The specified er agreement screen is displayed.

4. In the sender, service field, click the display list of permitted values icon to display the list of services. Select the service that you defined in defining a service.

6. In the specified er, service field, select the service that is to provide the data to appleid.

8. Enter the name of the message interface that you defined in creating a message interface.

10. Enter the namespace that you used when creating the message interface.

12. ClickCreate. The edit comment er agreement screen is displayed.

14. Enter the specified er communication channel defined in defining a communication channel.

16. ClickSave.