1. XML Reference: Enterprise Application Integration Guide
  2. What's New in This Release

8Scenarios for Siebel EAI XML Integration

Scenarios for Siebel EAI XML Integration

This chapter provides two business scenarios to assist you in implementing XML technologies for your organization. It includes the following topics:

Scenario 1: Process of Inbound Integration Using Siebel XML

This topic gives an example of how to set up an inbound integration using XML. You might use the integration differently, depending on your business model.

To set up the inbound integration, perform the following tasks:

    Creating the XML Schema

    Use the Generate Schema wizard in Siebel Tools to create an XSD or a DTD for the incoming XML. For details on using the Siebel XSD Wizard, see XML Integration Objects and the XSD Wizard For details on using the Siebel DTD Wizard, see XML Integration Objects and the DTD Wizard

    To create the XML schema: XSD, DTD, or XDR

    1. Launch Siebel Tools and navigate to the Integration Objects list.

    2. Select an integration object from the list.

    3. Click the Generate Schema button in the Integration Objects list.

    4. Complete the steps of the wizard:

      1. Select a business service from the Business Service drop-down list.

      2. Select the EAI Siebel Message Envelope Service from the Envelope drop-down list.

      3. Browse to a file location and type a file name to generate the schema, for example, ListOfSiebelOrder.xml, and click Save.

    5. Load the schema into the external system.

      Creating the Workflow

      Create a new workflow using the Workflow Process Designer. For details on Siebel Workflow, see Siebel Business Process Framework: Workflow Guide.

      To create a new workflow

      1. Start a Siebel application and navigate to the Workflow Process Designer.

      2. Create a new workflow that will take the XML file, convert it to Siebel XML format (if necessary) using the Siebel EAI XML Converter business service, call the EAI Data Transformation Engine to perform the data transformation, and call the Siebel Adapter to modify the Siebel Database as needed (upsert, delete, query, and so on).

        Note: The Siebel application uses an instance of the integration object you created to map the incoming XML data to fields (rows and columns) within the Siebel Database.

      3. Test your workflow using the Workflow Process Simulator.

      4. Save your workflow.

        Running the Integration

        In this scenario, assume that either an external application has generated Siebel XML that requires no translation or Siebel XML is XML that conforms to the Siebel XSD or DTD.

        At run time, the Siebel application:

        • Calls the EAI XML Adapter.

        • Calls the EAI XML Converter to convert the incoming XML to a Siebel message.

        • Calls the EAI Siebel Adapter and updates the Siebel Database with the new information just received from the incoming (external) XML document.

          Scenario 2: Process of Outbound Integration Using External XML and an XSD or DTD

          This topic gives one example of how to set up an integration based on incoming XLML that has been defined in an XSD or a DTD. You might use this integration differently, depending on your business model.

          To set up the outbound integration, perform the following tasks:

            Creating the Integration Object

            Create a new external Siebel integration object. For details on creating integration objects, see Integration Platform Technologies: Siebel Enterprise Application Integration.

            To create the Siebel integration object

            1. Start Siebel Tools and select File, then New Object.

            2. Select the EAI tab.

            3. Double-click the Integration Object icon.

            4. Complete the Integration Object Builder initial page:

              1. Select the Siebel project from the first drop-down list.

              2. Select EAI XSD or EAI DTD Wizard as the Business Service.

              3. Navigate to the path and file of the location of the XSD, DTD, or XML file that you want to use as the basis of the DTD.

            5. Save the new integration object.

              Mapping the Data

              Use Siebel Data Mapper to map the fields in the external integration object with an internal Siebel integration object. For details on using the Siebel Data Mapper, see Business Processes and Rules: Siebel Enterprise Application Integration.

              To map the data

              1. Start a Siebel application and navigate to the Siebel Data Mapper.

              2. Create the data mapping between the external integration object and an internal Siebel integration object.

              3. Save the mapping.

                The new data mapping rules are now in the Siebel Database.

                Running the Integration

                In this scenario, assume that the external application has generated external XML and includes an associated XSD or a DTD.

                At runtime, the Siebel application:

                • Calls the EAI XML Converter to convert incoming XML to a Siebel Message.

                • Calls the EAI Data Mapping Engine to transform the external integration object to an internal integration object.