| Oracle® Application Integration Architecture Oracle Communications Order to Cash Integration Pack Implementation Guide for Siebel CRM, Oracle Communications Order and Service Management, and Oracle Communications Billing and Revenue Management Release 11.3 Part Number E50337-01 |
|
|
PDF · Mobi · ePub |
This chapter describes the Synchronize Product and Price business flow and explains how the Oracle Communications Order to Cash for Siebel customer relationship management (Siebel CRM) and Oracle Communications Billing and Revenue Management (BRM) Pre-built Integration option (the integration) implements the business flow using BRM interfaces, communications industry-specific Oracle Application Integration Architecture (Oracle AIA) components, and integration services.
The Synchronize Product and Price integration between BRM and Siebel CRM supports the following integration flows (in real time or batch mode):
Product Synchronization integration flow: enables you to create new products in BRM and then synchronize those products in Siebel CRM.
Billing Discount Synchronization integration flow: enables you to create billing discounts as billing products in BRM and then synchronize those billing discounts with Siebel CRM.
The product synchronization integration flow enables you to create new products in BRM and then synchronize those products in Siebel CRM. The products created are used by the Order Capture and Asset Tracking modules in Siebel CRM. The product synchronization integration flow also enables updates to existing products in BRM. The updates are then synchronized in Siebel CRM.
When products are created in BRM, those products have multiple events, each with a price, which differs from Siebel CRM, which has only one product and a price for that product.
The product synchronization integration flow takes multiple events with recurring prices first. If no recurring price event exists, then the integration takes the first event and makes that the main (parent) product with a price.
After synchronizing the product data from BRM to Siebel CRM, Siebel CRM returns a message containing both the product and the price data. The integration separates the product data from the price list data, and then synchronizes the price data in a separate process.
This integration flow delivers these services:
SyncProductBRMCommsReqABCSImpl with operation SyncProduct
SyncItemCompositionListSiebelCommsProvABCSImpl with operation SyncItemCompositionList
ProductOptimizedSyncPriceListListSiebelCommsProvABCSImpl with operation ProductOptimizedSyncPriceListList
Figure 4-1 is the sequence diagram for the product synchronization.
When this process starts, the following events occur:
In Pricing Center, create or edit a product.
Commit the product to the BRM database so that the new or changed product drops into the BRM product queue.
Dequeue the BRM product queue. The adapter SyncProductInfoChangeBRMAQ polls the BRM product queue.
It is dequeued whenever it sees a message in the queue and invokes the SyncProductBRMCommsReqABCSImpl with the operation SyncProduct.
The SyncProductBRMCommsReqABCSImpl first transforms the BRM product message into an ItemCompositionEBM and routes the message to the SyncItemCompositionListSiebelCommsProvABCSImpl
The SyncItemCompositionListSiebelCommsProvABCSImpl transforms the ItemCompositionEBM into the Siebel CRM product message and then calls the Siebel CRM product web service on operation SWIProductImportUpsert. The Siebel CRM web service completes the request and returns a response message. The SyncItemCompositionListSiebelCommsProvABCSImpl then transforms the Siebel CRM response message to an ItemCompositionResponseEBM and sends it back to the SyncProductBRMCommsReqABCSImpl.
The SyncProductBRMCommsReqABCSImpl transforms the BRM product message into the PriceListListEBM and routes the message to the ProductOptimizedSyncPriceListListSiebelCommsProvABCSImpl.
The ProductOptimizedSyncPriceListListSiebelCommsProvABCSImpl first identifies the event to be associated with the main product and then transforms the SyncPriceListListEBM to a SyncItemCompositionListEBM and routes the message to the SyncItemCompositionListSiebelCommsProvABCSImpl.
The SyncItemCompositionListSiebelCommsProvABCSImpl transforms the ItemCompositionEBM to the Siebel CRM product message and then calls the Siebel CRM product web service on operation SWIProductImportUpsert. The Siebel CRM web service completes the request and returns a response message. SyncItemCompositionListSiebelCommsProvABCSImpl then transforms the Siebel CRM response message to an ItemCompositionResponseEBM and returns it to the ProductOptimizedSyncPriceListListSiebelCommsProvABCSImpl.
The ProductOptimizedSyncPriceListListSiebelCommsProvABCSImpl transforms the PriceListEBM to a Siebel CRM price list message and then calls the Siebel CRM price list web service on operation Price_spcList_spcItem_spcInsertOrUpdate. The ProductOptimizedSyncPriceListListSiebelCommsProvABCSImpl transforms the PriceListListEBM to a Siebel CRM product message and then calls the Siebel CRM product web service on operation SWIProductImportUpsert. The Siebel CRM web service completes the request and returns a response message. SWIProductImportUpsert then transforms the Siebel CRM response message to a PriceList ListResponseEBM.
The billing discount synchronization integration flow enables you to create billing discounts as billing products in BRM and then synchronize those billing discounts with Siebel CRM. The billing discounts created are used by the Order Capture module in Siebel CRM.
The billing discount synchronization flow also enables updates to billing discounts in BRM. The updates are then synchronized in Siebel CRM.
The billing discount synchronization integration flow synchronizes only the basic billing discount attributes. It does not synchronize any price information. Add the billing discount detail information in the description of the billing discount when creating billing discounts
This integration flow delivers these services:
SyncDiscountBRMCommsReqABCSImpl with operation SyncDiscount
SyncItemCompositionListSiebelCommsProvABCSImpl with operation SyncItemCompositionList
Figure 4-2 is the sequence diagram for the billing discount synchronization:
When this process starts, the following events occur:
In Pricing Center, create or edit a discount.
Commit the discount to the BRM database so that the new or changed discount drops into the BRM product queue.
Dequeue the BRM discount queue. The adapter SyncDiscountInfoChangeBRMAQ polls the BRM discount queue. It is dequeued whenever it sees a message in the queue and invokes the SyncDiscountBRMCommsReqABCSImpl with the operation SyncDiscount.
The SyncDiscountBRMCommsReqABCSImpl first transforms the BRM discount message into the ItemCompositionEBM and routes the message to the SyncItemCompositionListSiebelCommsProvABCSImpl.
The SyncItemCompositionListSiebelCommsProvABCSImpl transforms the ItemCompositionEBM into the Siebel CRM product message and then calls the Siebel CRM product web service on operation SWIProductImportUpsert. The Siebel CRM web service completes the request and returns a response message to the SyncItemCompositionListSiebelCommsProvABCSImpl.
The Synchronize Product and Price business flow uses the following BRM interfaces:
SyncProductInfoChangeBRMAQ: The adapter SyncProductInfoChangeBRMAQ polls the BRM Product queue. It dequeues whenever it sees a message in the queue and invokes SyncProductBRMCommsReqABCSImpl with the operation SyncProduct.
SyncDiscountInfoChangeBRMAQ: The adapter SyncDiscountInfoChangeBRMAQ polls the BRM Discount queue. It dequeues whenever it sees a message in the queue and invokes SyncDiscountBRMCommsReqABCSImpl with the operation SyncDiscount.
The Synchronize Product and Price business flow uses the following Siebel CRM interfaces:
SWIISSPriceListItemIO: This web service is used to perform basic operations on a price list such as insert or update (upsert).
SWIProductImport: This inbound web service is used to support Insert or Update of product details, which allows the import of external product information into the Siebel CRM database.
See the discussion of Siebel CRM primary web services in Siebel CRM Web Services Reference for more information.
The Synchronize Product and Price business flow uses the following communications industry Oracle AIA components:
ItemCompositionEBO
SyncItemCompositionListEBM
SyncItemCompositionListResponseEBM
PriceListEBO
SyncPriceListListEBM
SyncPriceListListResponseEBM
The industry enterprise business object (EBO) and enterprise business message XML schema (EBM XSD) files are located here: $AIA_HOME/AIAMetaData/AIAComponents/EnterpriseObjectLibrary/Industry/Communications/EBO/
The industry enterprise business service (EBS) WSDL files are located here: $AIA_HOME/AIAMetaData/AIAComponents/EnterpriseBusinessServiceLibrary/Industry/Communications/EBO/
For detailed documentation of individual EBOs and EBMs, click the AIA Reference Doc link on EBO and EBM detail pages in the Oracle Enterprise Repository (OER).
EBOs can be extended, for instance, to add new data elements. These extensions are protected and remain intact after a patch or an upgrade, so long as the extensibility guidelines are followed.
See Oracle Fusion Middleware Developer's Guide for Oracle Application Integration Architecture Foundation Pack for more information about:
Configuring and using OER as the Oracle SOA Repository to provide the AIA Reference doc link
Extending existing schemas and EBOs
The following services are delivered with the Synchronize Product and Price business flow:
SyncProductBRMCommsReqABCSImpl
SyncDiscountBRMCommsReqABCSImpl
SyncItemCompositionListSiebelCommsProvABCSImpl
ProductOptimizedSyncPriceListListSiebelCommsProvABCSImpl
Some of these services have been enabled to use Session Pool Manager.
See Oracle Application Integration Architecture Pre-Built Integrations Utilities Guide for more information about Session Pool Manager.
The SyncProductBRMCommsReqABCSImpl has the operation SyncProduct and performs all of the Product/Item-related actions such as Create Product/Item, Update Product/Item, and Sync Product/Item.
This service accepts a BRM product message as a request and does not return a response. A BRM product message has two sets of information:
Standard product attributes.
Pricing information that can be mapped to a PriceLine of a PriceList.
Because it has two sets of information, the BRM product message is transformed into two EBMs: one for the product (SyncItemCompositionListEBM) and another for the PriceLine (SyncPriceListList EBM).
The program first prepares the SyncItemCompositionListEBM with the basic product information.
After the SyncItemCompositionList is complete, it prepares a SyncPriceListListEBM with the pricing information of the BRM message. It fetches the PriceList name from a configuration parameter.
The configuration parameter is located in the AIAConfigurationProperties.xml file.
The SyncDiscountBRMCommsReqABCSImpl is a BPEL service and it is the BRM discount request ABC implementation. It has the operation SyncDiscount. This accepts a BRM discount message as a request and does not return a response.
The SyncDiscountBRMCommsReqABCSImpl service accepts a BRM discount message. A BRM discount is created as a product for all of the recipients. A BRM discount message has basic discount attributes and does not contain any pricing information. The BRM discount message is transformed into the SyncItemCompositionListEBM with the basic discount information.
The SyncItemCompositionListSiebelCommsProvABCSImpl process accepts the SyncItemCompositionListEBM. It transforms SyncItemCompositionListEBM into the Siebel CRM product application business message (ABM). It then invokes the Siebel CRM Product web service to create products and product structures in Siebel.
This service is SPM enabled.
See Oracle Application Integration Architecture Pre-Built Integrations 11.1: Utilities Guide for more information about Session Pool Manager.
The ProductOptimizedSyncPriceListListSiebelCommsProvABCSImpl service performs all of the PriceList-related actions such as Create PriceList, Update PriceList, Sync PriceList, and Sync PriceListList. This operation has the standard create, read, update, delete (CRUD) operations.
This service transforms the PriceListEBM into a Siebel CRM price list message and then calls the Siebel CRM price list web service on operation Price_spcList_spcItem_spcInsertOrUpdate. The ProductOptimizedSyncPriceListListSiebelCommsProvABCSImpl transforms the PriceListListEBM into a Siebel CRM product message and then calls the Siebel CRM product web service on operation SWIProductImportUpsert. The Siebel CRM web service completes the request and returns a response message. SWIProductImportUpsert then transforms the Siebel CRM response message to a PriceList ListResponseEBM.
This service is SPM enabled.
See Oracle Application Integration Architecture Pre-Built Integrations 11.1: Utilities Guide for more information about Session Pool Manager.
|
 Copyright © 2011, 2013, Oracle and/or its affiliates. All rights reserved. Legal Notices |
|
