Integration Platform Technologies: Siebel eBusiness Application Integration Volume II > EAI Siebel Adapter >

MVGs in EAI Siebel Adapter


Multi-value groups (MVGs) in the business components are mapped to separate integration components. Such integration components are denoted by setting a user property MVG on the integration component to Y. For details on MVGs, see About Integration Objects.

An integration component instance that corresponds to a primary MVG is denoted by the attribute IsPrimaryMVG set to Y. This attribute is a hidden integration component field and does not have a corresponding business component field.

Each MVG that appears on the client UI is mapped to a separate integration component. For example, in the Orders Entry - Orders screen, there is an Account Address, a Bill-to Address, and a Ship-to Address. Each of these MVGs needs a separate integration component definition. Each field defined for an integration component (represented by the class CSSEAIIntCompFieldDef) maps to a field in the MVG. For such fields, External Name denotes the name of the business component field as it appears on the master business component, and the user property MVGFieldName denotes the name of the business component field as it appears on the MVG business component.

NOTE:  Setting a primary record in an MVG is supported only when the Auto Primary property of the underlying MVLink is specified as Selected or None. If Auto Primary is defined as Default, then the Object Manager does not allow the EAI Siebel Adapter to set the primary. The exception to this rule are all the visibility MVG components (components whose records are used by Object Manager to determine who is going to see their parent records). For details on Auto Primary property, see Siebel Tools Reference.

Setting a Primary Address for an Account

You have an account with multiple shipping addresses in a Siebel application. None of these addresses are marked as the primary address for the account and you want to select one of them as the primary shipping address.

To specify an address as a primary

  1. Create your XML file and insert <IsPrimaryMVG= 'Y'> before the address you want to identify as the primary address for the account as shown below:
  2. <?xml version="1.0" encoding="UTF-8" ?>

       <?Siebel-Property-Set EscapeNames="false"?>

    - <SiebelMessage MessageId="1-69A" IntObjectFormat="Siebel Hierarchical" MessageType="Integration Object" IntObjectName="Sample Contact">

    - <ListOfSampleContact>

    - <Contact>

       <FirstName>Pal888</FirstName>

       <IntegrationId>65454398</IntegrationId>

       <JobTitle>Manager</JobTitle>

       <LastName>John888</LastName>

       <MiddleName />

       <PersonUId>1-Y88H</PersonUId>

       <PersonalContact>N</PersonalContact>

    - <ListOfContact_Position>

    - <Contact_Position IsPrimaryMVG="Y">

       <EmployeeFirstName>Siebel</EmployeeFirstName>

       <EmployeeLastName>Administrator</EmployeeLastName>

       <Position>Siebel Administrator</Position>

       <RowStatus>N</RowStatus>

       <SalesRep>SADMIN</SalesRep>

       </Contact_Position>

       </ListOfContact_Position>

       </Contact>

       </ListOfSampleContact>

       </SiebelMessage>.

  3. Use the Upsert or Sync method to update the account.

 Integration Platform Technologies: Siebel eBusiness Application Integration Volume II 
 Published: 18 July 2003