Siebel Server Sync Guide > Customizing Siebel Server Sync >

Example of Changing Integration Objects

This topic gives one example of changing integration objects as part of customizing SSSE. You may use this feature differently, depending on your business requirements.

In this example, you want to map the Spouse field of a Siebel business contact to the corresponding Spouse field of a Microsoft Outlook business contact so SSSE can synchronize it. To do this, you must first:

1. Map the existing contact business component field, Spouse, to the Siebel integration object and the intermediate integration object for the Business Contact domain.
2. Expose the Spouse field in the user interface.

The procedure to perform these tasks is given below.

For more information about integration objects, see About SSSE Integration Objects.

NOTE:  This example assumes that the Spouse field already exists in the appropriate Siebel business component, but does not yet exist in the Siebel integration object or the intermediate integration object, and it has not yet been synchronized.

To change Siebel and intermediate integration objects for a new field

1. Log in to Siebel Tools.
2. Select the View menu, and then Options.
3. Click the Object Explorer tab.
4. In the Object Explorer Hierarchy list box, select the Integration Object check box, and click OK.
5. In the Object Explorer, select Integration Object, and complete the following substeps:
   1. In the Object List Editor, select PIMSI Business Contact.
   2. From the Tools menu, select Lock Project.
   3. In the Object Explorer, expand Integration Object, then select Integration Component.
   4. In the Object List Editor, select Contact.
   5. In the Object Explorer, expand Integration Component, then select Integration Component Field.
   6. In the Name field, query for Spouse.
   7. In the Spouse field, scroll to the right until the Inactive field is visible, and clear the Inactive check box.
6. In the Object Explorer, select Integration Object, and complete the following substeps:
   1. In the Object List Editor, select PIMSI Intermediate Business Contact.
   2. In the Object Explorer, expand Integration Object, then select Integration Component.
   3. In the Object List Editor, select Business Contact.
   4. In the Object Explorer, expand Integration Component, then select Integration Component Field.
   5. In the Object List Editor, right-click and choose New Record.
   6. Enter values for the new Spouse field as shown in the following table.

      Field Property	Field Property Value	Comment
      Name	Spouse	Internal name of the field.
      Data Type	DTYPE_TEXT	Data type of the field.
      Type	Data	Field type.
      External Name	Spouse	For a Siebel integration object, External Name must match the name of the field as it is specified in the Siebel business component. For an intermediate integration object, you can choose any value for External Name.
      External Sequence	19	Specifies the order in which the field will appear when Data Mapper is used to map the fields. Enter a value that is not already present in the field list, such as the number that follows the value used for the last existing field in the sequence. It is recommended that you use the same value for XML Sequence and External Sequence.
      XML Sequence	19	Specifies the order in which the field will appear in the Output XML message. Enter a value that is not already present in the field list, such as the number that follows the value used for the last existing field in the sequence. It is recommended that you use the same value for XML Sequence and External Sequence.
      XML Tag	Spouse	Enter a value that does not contain any spaces. This value is included in the XML output that SSSE produces.

      CAUTION:  For Siebel integration objects (but not intermediate integration objects), if an MVG field is not a user key, be sure to set the XML Sequence property value and the External Sequence property value to be greater than the value of a user key MVG field. If you do not specify a greater value, synchronization may not work properly for information that travels from Microsoft Exchange to the Siebel application.

      A user key MVG field is a field that is specified in the Integration Component User Key object as a user key. If any new MVG field is added to the Integration Component, then the XML Sequence and External Sequence property value for the new field must be greater than that of the user key field.

7. Expose the Spouse field in the user interface by completing the following substeps:
   1. In the Object Explorer, select the Applet object.
   2. Query for the Contact List Applet.
   3. From the Tools menu, choose Lock Project.
   4. In the Object Explorer, expand Applet, then List, and click on List Column.
   5. In the Object List Editor, right click and choose New Record.
   6. Enter the following information for the new Spouse record:

      Field	Value
      Name	Spouse
      Field	Spouse
      Display Name	Spouse
      HTML Type	Field

   7. Right-click on the Contact List Applet record, and select Edit Web Layout.
   8. In the Controls/Columns window, select Edit List mode.
   9. In the Applet (Contact List Applet) layout window, scroll to the right until empty Field placeholders are visible.
   10. In the Controls/Columns window, drag the Spouse control onto an empty Field placeholder in the Applet (Contact List Applet) layout window.
   11. Close the Applet (Contact List Applet) layout window and, when prompted as to whether you want to save the changes you have made to the Contact List Applet, click Yes.
8. Recompile the SRF for the project, then stop and restart the Siebel Server.

   Use this recompiled SRF when you make corresponding changes to Data Maps, as described in Example of Changing Data Maps.