Siebel Financial Services Connector for IFX XML Guide > Configuration Roadmap > Creating Integration Objects in Siebel Tools >

Creating External Integration Objects


An external integration object establishes the hierarchy for an IFX XML message. Each type of message under a service needs its own integration object that defines the body portion of the XML document.

When you create an external integration object, you create a pair of such objects, one for the request portion of the cycle and one for the response portion of the cycle.

Each external integration object is paired with an internal integration object when you configure the DTE map.

To create an external integration object

  1. In Siebel Tools, lock the appropriate project, if necessary.
  2. The FINS IFX XML Wizard requires a locked project. This example uses the FINS IFX Tutorial project.

  3. From the application-level menu, choose File>New Object.
  4. The New Object Wizards dialog box appears.

  5. Select the EAI tab and double-click Integration Object.
  6. The Integration Object Builder wizard appears.

  7. Fill in the two fields.
    1. Select the project you have locked.
    2. Select FINS IFX Tutorial Wizard Service from the Business Service list.
    3. Click for full size image

  8. Click Next.
  9. Choose the DTD file you want to use, and then click Next.
  10. The filename is IFX101.dtd. This filename indicates that this is version 1.0.1 of IFX DTD.

    Click for full size image

    It takes some time for the wizard to parse the DTD file and to display the next page.

  11. Choose a Request Service and Response Service pair.
  12. Choose PaySvcRq for the Request Service. PaySvcRs is automatically entered for the Response Service.

    Click for full size image

  13. Click Next, and then choose the Request Command and Response Command you want to use.
  14. Click for full size image

    This screen uses Request Command to identify the IFX request message. The request message you select is automatically paired with an appropriate response message. For this example, you choose <PmtAddRq>; it is automatically paired with <PmtAddRs>.

    NOTE:  Be sure to select the request message from the list. If the message is typed into the field, the wizard does not populate the remaining fields automatically.

    You can change the Integration Object Name for the request and response integration objects for administrative convenience. You should consider establishing a set of naming conventions to make groups of objects easy to recognize. This example renames the external integration objects.

    Integration object names for request and response messages must be unique within the repository. Note the integration object names. You will need to know the names when you configure the DTE map.

  15. Change the integration object names for the request and response messages.
  16. Click Next to display the integration components screen in which you select the message elements to include.
  17. You will select message elements for the request integration object on this screen, and you will select the message elements for the response integration object in the next screen. The request integration object is FINS IFX Tutorial PmtAddRq IntgObj.

  18. Click the plus symbol (+) to display the message elements.
  19. This screen displays a visual hierarchy of the message structure. It provides all the available aggregates and elements for the message. The screen starts with all of these selected (included).

    Click for full size image

    This example includes all the elements in the external integration objects. You would deselect elements to create an object to exchange fewer elements. Notice that if you deselect the parent, all the child items are deselected. Reselecting the parent does not reselect the child items, so you can select just a subset of child items.

  20. Be sure that all the elements are selected, then click Next.
  21. The second integration components screen allows you to select the message elements to include for your response message integration object. The response integration object is FINS IFX Tutorial PmtAddRs.

  22. Click Next to include all elements and display the Select Internal Integration Object screen.
  23. Click for full size image

See Additional Information for technical details about integration components, such as those created in this procedure.


 Siebel Financial Services Connector for IFX XML Guide 
 Published: 18 April 2003