How the Connector Components Manage Domain Data During Synchronization

2-8 Administrators Guide for Oracle Business Data Synchronization Server 1. The Hub Transport receives the SOAP message containing the Hub XML record. 2. The Hub Transport then passes the Hub XML set to the Transformer. 3. The Transformer performs the following actions to translate the record from Hub XML to the appropriate PIM XML: a. Identifies the synchronization direction outbound to apply the appropriate XSLT to the Hub XML record Hub to PIM. b. Calls an API to apply the XSLT. c. Passes the converted record to the Hub Transport. 4. The Hub Transport passes the PIM XML record to the PIM Transport. 5. The PIM Transport converts the PIM XML into a format needed by the native PIM API used to push the record to the PIM server. 6. The PIM Transport sends the PIM API-formatted record to the PIM server.

2.2.5 Error Messages

Errors can be integrated into a BPEL task flow to alert about administrators data errors that occur during synchronization. For example, if a user inadvertently creates a record with a character in the description that a third-party PIM Server cannot accept, then that PIM Server rejects the record during the next synchronization session. As a result, BDSS raises a BPEL event with the record summary and the error. The administrator sets up a BPEL process that checks the error code and then sends an e-mail telling the user to remove the unsupported character from the record. An event is raised whenever BDSS logs a Critical, Error, or Warning message to its log files. BDSS can also raise a BPEL event to a BPEL server or web service. 3 Installing the BDSS Components 3-1 3 Installing the BDSS Components This chapter describes installing Oracle Business Data Synchronization Server BDSS. This chapter includes the following topics: ■ Overview of Installation ■ Deploying the Hub Components ■ Overview of Installing and Configuring BDSS ■ Creating a Domain ■ Extending the Domain with the BDSS Templates ■ Adding Security Credentials ■ Setting SSL ■ Enabling Data Transformation and Filtering for Exchange 2007 Connector ■ Configuring the Exchange 2007 Connector ■ Configuring the Hub ■ Configuring BDSS Server Instances ■ Configuring Connector Instances ■ Adding Users ■ Postinstallation Configuration

3.1 Overview of Installation

BDSS consists of the following independently installed components, each with their own installation prerequisites listed in Table 3–1 : ■ The BDSS Hub components ■ The BDSS connectors: – Oracle BDSS Connector for Microsoft Exchange 2007 – The Oracle BPEL Task Connector The companion CD includes BDSS.zip. This file contains the installer file, bdss_ template.jar, the template file that creates the data source and queues. In addition, it contains the EAR files for the Oracle BDSS Connector For Exchange 2007 the Exchange 2007 Connector, the Oracle BPEL Task Connector, the Engine BDSSHub.ear, and the Dispatcher BDSSDispatcher.ear. BDSS.zip also includes XSL transformation files and SQL scripts.