Transports and Interfaces: Siebel Enterprise Application Integration > Interfacing with Microsoft BizTalk Server > Preparing to Use the Siebel BizTalk Adapter >

Siebel Integration Objects


Before you can exchange documents with any of your trading partners or with any other application using BizTalk Server, you need to expose the appropriate Siebel integration objects to BizTalk; this is done by creating integration object schema which you then import into BizTalk.

Siebel integration objects are published using the Schema Generator Wizard—a component of Siebel Tools. You need to create a new document definition using the Schema Wizard to expose any of the Siebel integration object formats for use with BizTalk.

NOTE:  For instructions on how to create and modify Siebel integration objects, see the Integration Platform Technologies: Siebel Enterprise Application Integration guide.

You export either DTD or XDR schema. These exported files are imported into BizTalk where they are converted into document specifications. BizTalk Server adds BizTalk-specific XML tags that convert the standard XDR format to BizTalk's document specification format. Figure 6 depicts how the Siebel integration objects are exposed to BizTalk Server.

Figure 6. Exposing Siebel Integration Objects to BizTalk Server

Document specifications are stored in the WebDAV BizTalk Repository and are available to any client that can connect to WebDAV. You can retrieve stored document specifications from WebDAV and create maps to perform data transformations from within BizTalk Mapper. BizTalk maps, which are XSLT (Extensible Stylesheet Language)-based, are also stored in WebDAV.

NOTE:  To use the Siebel BizTalk Server interface, you need to have integration objects defined for each trading partner. You can either use existing integration objects for this purpose, or you can create new ones depending upon your business requirements.

Exposing Integration Objects to BizTalk

Use the following checklist as a guideline for how to expose integration objects to BizTalk.

Checklist

q

Generate an DTD or XDR schema for each integration object you want to expose to BizTalk (repeat for each integration object you need).

For details, see To generate a new DTD or XDR schema.

q

Import the generated schema for the integration object into BizTalk Server, where they are converted to document specifications.

For details, see To import schema into BizTalk Server to save it as a BizTalk document specification.

To generate a new DTD or XDR schema

  1. Start Siebel Tools.
  2. Select Integration Object in the Objects Explorer window as shown in the following figure.
    Click for full size image
  3. Select the integration object that you want to expose and click the Generate Schema button at the top of the window as shown in the following figure.
    Click for full size image

    The Generate Schema Wizard appears.

  4. Perform the following in the Generate Schema Wizard:
    1. Select EAI XML XDR Generator from the Business Service drop-down list.
    2. Select 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. Click Finish to complete the process.

    A file (for example, ListOfSiebelOrder.xml.) has now been created in the file location you specified.

  6. Copy the newly generated schema from the Siebel client machine to the BizTalk Server machine.

To import schema into BizTalk Server to save it as a BizTalk document specification

  1. Open the BizTalk Server Schema Editor on the BizTalk Server machine.
  2. Choose Tools > Import.
  3. Select XDR Schema and click OK.
  4. Browse to the location where you stored the XDR Schema and click Open.

    The columns of the integration object display in the BizTalk Server Editor, samples of which are shown in the next figure.

    Click for full size image
  5. Choose File > Store to WebDav.
  6. Give the file a name (such as Siebel Orders).
  7. Click Save.

    NOTE:  The XDR schema is now saved in the BizTalk Documentation Specification format on WebDav.

About Siebel Data Types Mappings in BizTalk

Standard Siebel applications come with predefined data types, which are mapped to XDR-specific data types.

Table 24 presents data types for the Siebel Field object type and the current corresponding mapping to XDR data types.

Table 24. Siebel Data Type Mappings in BizTalk
Siebel Data Type
XDR Data Types

DTYPE_TEXT

string

DTYPE_BOOL

char (1)

DTYPE_CURRENCY

number

DTYPE_DATE

string

DTYPE_DATETIME

string

DTYPE_TIME

string

DTYPE_ID

string

DTYPE_INTEGER

int

DTYPE_NOTE

string

DTYPE_NUMBER

number

DTYPE_PHONE

number

Transports and Interfaces: Siebel Enterprise Application Integration