Skip Headers
Oracle® Application Integration Architecture Oracle Order Management for Oracle Transportation Management, Oracle EBS, and Siebel CRM Implementation Guide
Release 3.1.1

Part Number E20504-07
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

2 Process Integration for Customers

This chapter provides an overview of the process integration for customers and discusses business process flows, assumptions and constraints, Siebel Customer Relationship Management (Siebel CRM), Oracle E-Business Suite (Oracle EBS), and Oracle Transportation Management (OTM) interfaces, core Oracle Application Integration Architecture (Oracle AIA) components, and integration services.

This chapter includes the following sections:

2.1 Overview

The process integration for creating and synchronization of customer accounts between Siebel CRM, Oracle EBS, and OTM involves these integrations:

Customers are important for any transportation order. In Siebel CRM, the customers are created as accounts. These accounts must be in OTM for execution of the order and the same accounts must be in Oracle EBS for billing purpose.

2.2 Business Process Flows

In this integration, Siebel sends accounts to OTM and Oracle EBS. Whenever a new account is created in Siebel, a real-time synchronization flow is initiated to synchronize it to a customer account in Oracle EBS. A new location and the corresponding corporation are created in OTM simultaneously for that Siebel account.

The addresses of the Siebel CRM account are synchronized to Oracle EBS to create locations, party sites, and account sites are synchronized as separate locations in OTM. The Bill To and Ship To address relationships from Siebel CRM are synchronized to Party Site Use and Account Site Use in Oracle EBS and to Location Roles in OTM.

If an update to a customer record or any of the details, for example, addresses, contacts occurs in Siebel CRM, the updated account record is synchronized to both OTM and Oracle EBS.

Figure 2-1 Customer Process Integration Flow

Description of Figure 2-1 follows
Description of "Figure 2-1 Customer Process Integration Flow"

2.2.1 Synchronizing Account Information

Figure 2-2 Incremental Changes in the Account Sequence Diagram

Description of Figure 2-2 follows
Description of "Figure 2-2 Incremental Changes in the Account Sequence Diagram"

Siebel application can send one of these messages:

  • Account Message - This message contains the details about an account and its associated addresses and contacts. This message is sent to SyncAccountSiebelReqABCSImpl requester process. The requester process converts the message to SyncCustomerPartyListEBM and sends it to CustomerPartyEBS. From enterprise business service (EBS), the message then flows through the OTM provider and Oracle EBS provider to create the entries in the respective systems.

  • Address Message - This message comes to application integration architecture (AIA) layer when an address is modified in Siebel CRM. Siebel CRM sends an address message that contains the changed address data and all the associated accounts and locations for that address. Master Data Management (MDM) code then deciphers that message, picks up the associated accounts, and for each account it creates an account message and sends it to the MDM account requester. The requester then processes the message in the same manner as described in account message.

  • Contact Message - This message comes to the Oracle AIA layer when a contact is modified in Siebel CRM. Siebel CRM sends a contact message that contains the changed contact data and all the associated accounts and locations for that contact. The MDM code then deciphers that message, picks up the associated accounts, and for each account it creates an account message and sends it to the MDM account requester. The requester then processes the message in the same manner as described in account message.

2.3 Assumptions and Constraints

These are the solution assumptions and constraints:

The direction of data flow is only from Siebel to OTM and Oracle EBS. The reverse data flow is not supported in this integration. If any customer data is modified or created in OTM or Oracle EBS, those changes are not reflected in Siebel CRM. Any subsequent synchronization of the same data from Siebel to OTM or Oracle EBS may overwrite the changes made in OTM or Oracle EBS.

2.4 Siebel CRM Interfaces

The schemas available for this outbound integration from Siebel are:

For more information about Siebel customer WSDL and schema definition, see Oracle Customer Master Data Management Integration documentation.

2.5 Oracle EBS Interfaces

For more information about Oracle EBS web services definition language (WSDL) and schema definition, see Oracle Customer Master Data Management Integration documentation.

For more information about Oracle EBS web services and documentation prior to Release 12.1.3, see the library on Oracle Technology Network: http://www.oracle.com/technetwork/documentation/applications-167706.html?. For Oracle E-Business Suite documentation for R12.1.3 and beyond, see this library: http://download.oracle.com/docs/cd/E18727_01/index.htm.

2.6 OTM Interfaces

The OTM provides an interface through a web service to connect to its application. This connectivity is established as a partner link in the provider service. The logistics web service on being called immediately returns an acknowledgment with a transmission number. When the processing is complete, it then sends a transmission report back indicating the success or the failure.

For more information about the Logistics Service, see Oracle Transportation Management Integration Guide.

2.7 Core Oracle AIA Components

The integration flow uses these components:

The core enterprise business object (EBO) and enterprise business message (EBM) XSD files can be located by EBO within the $AIA_HOME/AIAMetaData/AIAComponents/EnterpriseObjectLibrary/Core/EBO/ parent folder.

The core enterprise business services (EBS) web services definition language (WSDL) files can be located by EBO within the $AIA_HOME/AIAMetaData/AIAComponents/EnterpriseBusinessServiceLibrary/Core/EBO/ parent folder.

For detailed documentation of individual EBOs and EBMs, click AIA Reference Doc link on EBO and EBM detail pages in the Oracle Enterprise Repository.

For more information about using the Oracle Enterprise Repository and configuring it to provide the AIA Reference Doc link, see Oracle Fusion Middleware Developer's Guide for Oracle Application Integration Architecture Foundation Pack, "Configuring and Using Oracle Enterprise Repository as the Oracle AIA SOA Repository."

EBOs can be extended, for instance, to add new data elements. These extensions are protected and remain intact after a patch or an upgrade.

For more information, see Oracle Fusion Middleware Developer's Guide for Oracle Application Integration Architecture Foundation Pack, "Extensibility for AIA Artifacts.

2.8 Integration Services

The services delivered with the customer process integration are:

2.8.1 SyncCustomerPartyListLogisticsProvABCSImpl

The SyncCustomerPartyListLogisticsProvABCSlmpl service is a Business Process Execution Language (BPEL) process that receives SyncCustomerPartyListEBM as input from CustomerPartyListLogisticsJMSConsumerV1, transforms that message to Logistics application business message (ABM), and calls the Oracle Transportation Management (OTM) web service to process that message in OTM. Cross-reference values are populated upon successful message processing.

2.8.2 JMS Topic

A JMS topic receives a message from the customer party EBS and routes it to both OTM connector and Oracle E-Business Suite connector. The topic is created in the AIA database under the user JMSUSER. The topic name is AIA_CustomerPartyJMSTV1.

2.8.3 SyncCustomerPartyJMSProducerV1

This service publishes the SyncCustomerPartyListEBM JMS message from EBS into the topic.

This is a mediator service with JMS Adapter and a routing rule. It accepts SyncCustomerPartyListEBM as input from CustomerPartyEBSV2. The received Customer Party List enterprise business message (EBM) payload message is published into the JMS Topic AIA_CustomerPartyJMSTV1.

2.8.4 SyncCustomerPartyEbizJMSConsumerV1

SyncCustomerPartyEbizJMSConsumerV1service is a subscriber to the topic that dequeues the SyncCustomerPartyListEBM JMS message from the JMS Topic for Oracle E-Business Suite connector.

This is a mediator service with JMS Adapter. This adapter dequeues the SyncCustomerPartyListEBM message for the subscribed consumer from the JMS Topic AIA_CustomerPartyJMSTV1 and routes the message to the SyncCustomerPartyListEbizProvABCSImpl provider service.

2.8.5 SyncCustomerPartyLogisticsJMSConsumer

SyncCustomerPartyLogisticsJMSConsumerV1 service is the other subscriber of the topic that dequeues the SyncCustomerPartyListEBM JMS message from the topic for logistics connector.

This is a mediator service with JMS Adapter. This adapter dequeues the SyncCustomerPartyListEBM message for the subscribed consumer from the JMS Topic AIA_CustomerPartyJMSTV1 and routes to the SyncCustomerPartyListLogisticsProvABCSImpl.