Integration Platform Technologies: Siebel eBusiness Application Integration Volume ll > Integration Objects >

About the Structure of Integration Objects

The Siebel integration object provides a hierarchical structure that represents a complex data type. Most specifically, prebuilt eAI integration objects describe the structure of Siebel business objects, SAP IDOCs, SAP BAPIs, XML, and external data. Most integration projects require the use of an integration object that describes Siebel business objects, either in an outbound direction such as a query operation against a Siebel integration object or in an inbound direction such as a synchronize operation against a Siebel integration object.

Creating and Maintaining Integration Objects continues with descriptions of how to create integration objects. The initial process of using the Integration Object Builder wizard is essentially the same for every integration object type currently supported.

CAUTION:  You should avoid using or modifying integration objects in the EAI Design project. Using or modifying any objects in the EAI Design project can cause unpredictable results.

Siebel business objects conform to a particular structure in memory. Although it is generally not necessary to consider this structure when working with Siebel applications, when you are planning and designing an integration project it is helpful to understand how a Siebel eAI integration object represents that internal structure.

An integration object consists of one Parent Integration Component, sometimes referred to as the root component or the primary integration component. The Parent Integration Component corresponds to the primary business component of the business object you chose as the model for your integration object. Figure 3 shows the Account business object in Siebel Tools.

Figure 3.  Account Parent Business Component

For example, assume you chose the Account business object (on the first panel of the Integration Object Builder wizard) to base your integration object myAccount_01 on. The Account business object in Siebel Tools has an Account business component as its primary business component. In the myAccount_01 integration object, every child component will be represented as either a direct or indirect child of the primary business component named Account.

Each child component can have one or more child components. In Siebel Tools, if you look at the integration components for an integration object you have created, you will see that each component can have one or more fields. Figure 4 illustrates a partial view of a Siebel integration object based on the Account business object, with the Business Address component and the Contact component activated.

Figure 4 represents part of the structure of the Account integration object. The Account parent integration component can have both fields and child integration components. Each integration component can also have child integration components and fields. A structure of this sort represents the metadata of an Account integration object. You may choose to inactivate components and fields. By inactivating components and fields, you can define the structure of the integration object instances entering or leaving the system.

Figure 4.  Representation of Partial Account Integration Object