6 Configuring the Order to Cash Business Process
This chapter describes how to configure the Order to Cash business process.
Configuring Order Lifecycle Management
This section describes how to configure order lifecycle management in Order to Cash business process.
About Configuring Order Lifecycle Management
This chapter assumes that you have already installed Oracle Communications Billing and Revenue Management (BRM), Siebel CRM, and Oracle AIA and performed any Oracle AIA post-installation tasks described in Oracle Application Integration Architecture Cloud Native Deployment Guide.
See the Oracle AIA software compatibility matrix available from My Oracle Support for information about required versions and patches.
In addition to basic setup, configuring order lifecycle management includes:
-
Working with domain value maps (DVMs) and cross-references.
-
Handling error notifications.
-
Setting Oracle AIA configuration properties.
Working with Domain Value Maps (DVMs) for Order Lifecycle Management
DVMs are a standard feature of the Oracle SOA Suite and enable you to equate lookup codes and other static values across applications, for example, FOOT and FT or US and USA.
DVMs are static in nature, though administrators can add maps as required. Transactional business processes never update DVMs, they only read from them. They are stored in XML files and cached in memory at run time.
DVM types are seeded for the order management flows, and administrators can extend the list of mapped values by adding more maps.
Note:
The DVM names in the following table have an underscore. If you open the file in FTP mode, the underscore is replaced with 95.
Table 6-1 lists the DVMs for the process integration for order lifecycle management.
Table 6-1 Order Lifecycle Management DVMs
DVM | Description |
---|---|
SALESORDER_DYNAMICPRICEIND |
Dynamic Pricing Indicator |
SALESORDER_FULFILLCOMPOSITIONTYPE |
Fulfillment Composition Type Code |
SALESORDER_FULFILLMENTMODECODE |
Fulfillment Mode Code |
SALESORDER_LINEFULFILLMENTMODECODE |
Line Fulfillment Mode Code |
SALESORDER_NETWORKINDICATOR |
Network Indicator |
SALESORDER_PARTIALFULFILLALLOWEDIND |
Partial Fulfillment Mode Indicator |
SALESORDER_PRIORITY |
Order Priority |
SALESORDER_PROCESSINGTYPECODE |
Processing Type Code |
ITEM_TYPE |
Product/Item Type Code |
SALESORDER_REVISIONPERMISIBLECODE |
Revision Permissible Code |
SALESORDER_SERVICEINDICATOR. |
Service Indicator |
SALESORDER_STRTBILLSERVICEUSAGE |
Start Billing Service Usage |
SALESORDER_STATUS |
Status |
SALESORDER_TYPECODE |
Type Code |
STATE |
State |
PROVINCE |
Province |
ADDRESS_COUNTRYID |
Country Code |
CUSTOMERPARTY_TYPECODE |
Account Type Code |
ITEM_BILLINGTYPECODE |
Billing Type Code. Examples values include Subscription, Discount, Item, and Sponsorship. |
SALESORDER_CHANGEDIND |
Order Changed Indicator. Values are True or False. Used to validate the OrderChangedIndicator attribute. For example, The order management system can set this attribute to True if, as part of fulfillment, the order changes significantly such that Siebel CRM must make a copy of the customer order to preserve the customer intent before updating the working version of the order. |
SALESORDER_ACTIONCODE |
Sales Order Line Action Code |
SALESORDER_REVISIONPERMISIBLECODE |
Revision Permissible Code |
SALESORDER_LINESTATUS |
Order Line Status |
DISCOUNT_METHODCODE |
Discount Method Code |
CURRENCY_CODE |
Currency Code |
PRICE_TYPE |
Price Type |
PRICELIST |
Maps price list Row IDs from Siebel CRM to logical common price list names for BRM and Oracle Product Hub. Used to communicate price lists from order lines for products synchronized from BRM using a rate plan selector. See Working with the PRICELIST DVM for details. |
See Oracle Fusion Middleware Developer's Guide for Oracle Application Integration Architecture Foundation Pack for more information about working with DVMs.
Working with the PRICELIST DVM
You must update the PRICELIST DVM before submitting any orders so that the integration can map Siebel CRM price lists to BRM rate plans. You can migrate the PRICELIST DVM information between environments.
Updating the PRICELIST DVM
To update the PRICELIST DVM:
-
Log in to Oracle SOA Composer and open PRICELIST.dvm.
For information about using Oracle SOA Composer with DVMs, see Oracle Fusion Middleware Developer's Guide for Oracle SOA Suite.
-
Replace the placeholder domain values for the first row in PRICELIST.dvm as follows:
-
For SEBL_01, enter the Siebel CRM price list row ID for one of the price lists you created in Siebel CRM before synchronizing the products to BRM. You can find price list row IDs using a query in Siebel CRM.
-
For COMMON and BRM_01, enter the logical name of the price list that corresponds to the Siebel CRM price list.
-
-
Add and fill in new rows for all additional price lists that you created in Siebel CRM with the exception of the default price list that you entered into the AIAConfigurationProperties.xml file. For more information about configuring Siebel CRM for integrated product lifecycle management, see Oracle AIA Oracle Communications Order to Cash Integration Pack Implementation Guide
-
Save and commit the changes.
Migrating PRICELIST DVM Between Environments
To migrate the PRICELIST DVM between environments:
-
In the source environment, in Siebel CRM, open the S_PR_LST table.
-
Search in the ROW_ID column for the price list row IDs listed in the SEBL_01 column in PRICELIST.dvm.
-
Copy the values in the NAME, SUBTYPE_CD, and BU_ID columns for each row ID to a text editor and close the table.
-
In the target environment, in Siebel CRM, open the S_PR_LST table.
-
Search the ROW_ID column for the price list row IDs listed in the source environment's S_PR_LST table and PRICELIST.dvm.
-
Enter the values copied to the text editor in the NAME, SUBTYPE_CD, and BU_ID columns.
-
Using Oracle SOA Composer, open PRICELIST.dvm.
-
In the SEBL_01 column, add the row IDs copied to the text editor. Fill out the COMMON and BRM_01 columns as described in Updating the PRICELIST DVM.
-
Save and commit the changes in both files.
Working with Cross-References for Order Lifecycle Management
Cross-references map and connect the records within the application network, and they enable these applications to communicate in the same language. The integration server stores the relationship in a persistent way so that others can refer to it.
Table 6-2 lists the order lifecycle management cross-references.
Table 6-2 Order Lifecycle Management Cross-References
Cross-Reference Table Name | COMMON | SEBL_01 | BRM_01 | Description |
---|---|---|---|---|
SALESORDER_ID |
SalesOrderIdentification |
Id |
N/A |
The Siebel CRM Sales Order ID is cross-referenced. |
SALESORDER_LINEID |
SalesOrderLine/Identification |
OrderItem/OrderId |
N/A |
The Siebel CRM OrderItem/OrderId is mapped to the SalesOrderLine Identification in the EBM. |
INSTALLED PRODUCT_ID |
InstalledProductIdentification |
AssetIntegrationId |
Product, service, or discount OBJ, or sharing group POID |
The Siebel CRM Asset Integration ID is mapped to the product/service/discount OBJ or sharing group POID of the BRM object. |
ITEM_ITEMID |
ItemIdentification |
ProductId |
Product or discount POID |
The Siebel CRM Product ID is mapped to the product/discount POID of the BRM object. |
CUSTOMERPARTY_ACCOUNTID |
CustomerPartyAccountIdentification |
AccountId |
Account POID |
The Siebel CRM Customer ID is mapped to the BRM Account POID. |
CUSTOMERPARTY_CONTACTID |
CustomerPartyAccountContactIdentification |
ContactId |
Contact POID |
The Siebel CRM Contact ID is mapped to the BRM Contact POID. |
CUSTOMERPARTY_DEFAULTBALANCEGROUPID (Populated only when service-level balance groups are enabled) |
InstalledProductIdentification (Populated from INSTALLEDPRODUCT_ID) |
AssetIntegrationID |
Balance group POID |
The balance group POID for each service bundle or simple service bundle is mapped to the InstalledProductIdentification for the product and to the Siebel CRM AssetIntegrationID sent on the order line. For nested service bundles, the integration populates only the values for the parent service bundle. To track the parent of a nested service bundle, the integration populates the BalanceBundleIdentification field in the order EBM with the common InstalledProductIdentification value of the parent service bundle. |
CUSTOMERPARTY_DEFAULTBALANCEGROUPID (Entry for default account-level balance group) |
CustomerPartyAccountIdentification |
ServiceAccountId/BillingAccountId |
Balance group POID |
The default balance group POID is mapped to the common ID of the account. |
CUSTOMERPARTY_PAYPROFILEID |
PaymentProfileIdentification |
BillingProfileId |
/payinfo POID |
The billing profile ID is mapped to the pay info POID from BRM. |
CUSTOMERPARTY_BILLPROFILEID |
BillingProfileIdentification |
BillingProfileId |
/billinfo POID |
The billing profile ID is mapped to the bill info POID from BRM. |
CUSTOMERPARTY_ADDRESSID |
CustomerPartyAccountAddressIdentification |
AddressId |
Address POID |
The address ID is mapped to the BRM Contact POID. |
PROMOTIONGROUP_MEMBER_ID |
The common ID of a promotion group (Populated from INSTALLEDPRODUCT_ID) combined with the common ID of a BRM bundled promotion POID. |
Promotion group RowId |
BRM bundled promotion POID |
The Siebel CRM RowId for a promotion group is mapped to the POID of a bundled promotion (but not the components of the bundled promotion). The integration uses this XREF to determine if a bundled promotion is associated with a promotion group membership. A bundled promotion can be associated with multiple promotion group memberships. In this case, the BRM value is included only for the first promotion group membership. A promotion group membership can be associated with multiple bundled promotions. In this case, the BRM value is included for each bundled promotion. |
COMMUNITYOFFER_ID |
Bundled promotion common ID |
Bundled promotion RowId |
POID of the discount sharing group |
The Siebel CRM RowId for a bundled promotion that includes a discount with the Community Offer attribute enabled is mapped to the POID of the corresponding discount sharing group. |
COLLECTION_GROUP_OWNER_ID |
Common ID of the owner billing profile |
N/A |
POID of the owner /billinfo |
The common ID of the billing profile for the owner account on the sales order is mapped to the corresponding /billinfo POID. When creating new collections sharing groups, the integration checks if the owner account's /billinfo POID already exists in this table. If so, the member is added to the existing group. |
COLLECTION_GROUP_MEMBER_ID |
Common ID of the member billing profile |
N/A |
POID of the member /billinfo |
The common ID of the billing profile for the member account on the sales order is mapped to the corresponding /billinfo POID. |
Handling Error Notifications for Order Lifecycle Management
Based on the roles defined for the services, email notifications are sent if a service ends due to an error.
Order Fallout Management can generate trouble tickets for failed orders.
See About Order Fallout Management for more information about order fallout.
Table 6-3 lists the error messages that are issued when order billing integration is called in billing initiation mode.
Table 6-3 Error Messages for Order Lifecycle Management
Error Code | Error Text | Description |
---|---|---|
AIA_ERR_AIACOMOMPI_0001 |
Date Validation Failed: Either a Purchase Date/Cycle Start Date/ Usage Start Date should be set to the future. |
In Billing Initiation mode, the ProcessFulfillmentOrderBillingBRMComms AddSubProcess ends in an error when at least one billing date (purchase, cycle start, usage start date) is not set to the future for lines with products of type Subscription or Discount. |
AIA_ERR_AIACOMOMPI_0002 |
Date Validation Failed: Purchase Date should be set to the future. |
In Billing Initiation mode, the ProcessFulfillmentOrderBillingBRMComms AddSubProcess ends in an error when the purchase date is not set to the future for lines with products of type Item. |
AIA_ERR_AIACOMOMPI_0003 |
Purchased promotion instance does not exist for a promotion that was previously purchased. A data upgrade script was not run. |
ProcessFulfillmentOrderBillingBRMCommsProvABCSImpl ends in an error if a change order is processed for data that was created using AIA for Communications 2.0/2.0.1 and the custom upgrade script was not run to create the necessary cross-reference and purchased promotion instances in BRM. |
AIA_ERR_AIACOMOMPI_0004 |
Promotion referenced on Sales Order &OrderNum, Line &LineNum for &Product has not been interfaced to billing. The promotion must be interfaced to billing, before interfacing the order line that references it. |
ProcessFulfillmentOrderBillingBRMCommsProvABCSImpl ends in an error if service bundle/account-level product with promotion reference is sent to billing before the corresponding promotion line. |
For more information about the errors caused by Siebel CRM or BRM, see the Siebel CRM and BRM documentation.
See Oracle Fusion Middleware Infrastructure Components and Utilities User's Guide for Oracle Application Integration Architecture Foundation Pack for more information about AIA error handling.
About Error Notification Roles and Users
The integration uses the following default roles and users to issue error notifications:
-
Role: AIAIntegrationAdmin
-
User: AIAIntegrationAdminUser
See the discussion of configuring Oracle AIA processes for error handling and trace logging in Oracle Fusion Middleware Developer's Guide for Oracle SOA Core Extension for more information about configuring error notifications.
Configuring Order Lifecycle Management
This section provides instructions for setting the Oracle AIA configuration properties and setting the BRM version number for backward compatibility.
Setting Oracle AIA Configuration Properties
Configure the properties described in this section in the COMMS_AIA_HOME/source/soainfra/apps/AIAMetaData/config/AIAConfigurationProperties.xml file.
See Oracle Fusion Middleware Developer's Guide for Oracle Application Integration Architecture Foundation Pack for more information about working with AIAConfigurationProperties.xml.
Note:
Entries in the AIAConfigurationProperties.xml file are case sensitive.
System-Level Configuration Properties
Table 6-4 shows the system-level configuration properties for order lifecycle management.
Table 6-4 System Configuration Properties for Order Lifecycle Management
Property Name | Value/Default Values | Description |
---|---|---|
O2C.AccountLevelBalanceGroup |
TRUE/FALSE Default value: FALSE |
A value of FALSE enables service-level balance groups. A value of TRUE disables service-level balance groups and tracks all services in one account-level balance group in BRM. |
Configuration Properties for Siebel CRM Services
Table 6-5 shows the properties for the UpdateSalesOrderSiebelCommsProvABCSImpl service.
Table 6-5 UpdateSalesOrderSiebelCommsProvABCSImpl Properties
Property Name | Value/Default Values | Description |
---|---|---|
Default.SystemID |
SEBL_01 |
URL for Siebel CRM Instance web service for "Order spcLine spcItem spcUpdate spc- _spcComplex" web service. |
Routing.SWI_spcOrder_spcUpsert.RouteToCAVS |
true/false. Default = false. |
Controls whether UpdateSalesOrderSiebelCommsProvABCSImpl routes messages to the CAVS or to the Siebel CRM system. |
Routing.SWI_spcOrder_spcUpsert.SEBL_01.EndpointURI |
Target Endpoint URL for the Siebel CRM upsert web service. example: http://${siebel.http.host}:${siebel.http.port}/eai_enu/start.swe?SWEExtSource=SecureWebService&SWEExtCmd=Execute&WSSOAP=1Status OpenFixedClosed |
Target Endpoint URL for the Siebel CRM upsert web service. |
ABCSExtension.PreXformEBMtoABM |
true/false. Default = false. |
Whether there is any extension in the ABCS before transformation of EBM to ABM. |
ABCSExtension.PreInvokeABS |
true/false. Default = false. |
Indicates whether there is any extension in the ABCS before invoking application business service. |
Table 6-6 shows the properties for the ProcessSalesOrderFulfillmentSiebelCommsReqABCSImpl service.
Table 6-6 ProcessSalesOrderFulfillmentSiebelCommsReqABCSImpl Properties
Property Name | Value/Default Values | Description |
---|---|---|
Default.SystemID |
Possible value: A Siebel CRM system instance code. Default value: SEBL_01 |
Default Siebel CRM system instance code (defined in BSR). This is used only if the Siebel CRM Order message does not contain the EnterpriseServerName. |
ABCSExtension.PreXformABMtoEBM |
Possible values: true or false Default value: false |
Indicates whether there is any extension in the ABCS before transformation of EBM to ABM. |
ABCSExtension.PostXformABMtoEBM |
true/false. Default = false |
Indicates whether there is any extension in the ABCS after transformation of EBM to ABM. |
ABCSExtension.PreInvokeEBS |
Possible values: true or false Default value: false |
Indicates whether there is any extension in the ABCS before invoking application business service. |
ABCSExtension.PostInvokeEBS |
Possible values: true or false Default value: false |
Indicates whether there is any extension in the ABCS after invoking application business service. |
EBSOverride.CommunicationsSalesOrderEBSV2.ProcessSalesOrderFulfillment.Address |
Possible value: address of web service that must be invoked. Default value: http://<soa_server>:<soa port>/soa-infra/services/default/ProcessSalesOrderFulfillmentOSMCFSCommsJMSProducer/client |
This property is used to dynamically invoke any web service from this service. This holds the address of the web service that must be invoked dynamically. To invoke CAVS/EBS or any other web service this property must be updated accordingly. |
EBSOverride.CommunicationsSalesOrderEBSV2.ProcessSalesOrderFulfillment.PortType |
Possible value: PortType of the web service that must be invoked. Default value: ProcessSalesOrderFulfillmentOSMCFSCommsJMSProducer |
This value should be in consistent with EBSOverride.CommunicationsSalesOrderEBSV2.ProcessSalesOrderFulfillment.Address. |
EBSOverride.CommunicationsSalesOrderEBSV2.ProcessSalesOrderFulfillment.ServiceName |
Possible value: ServiceName of the web service that must be invoked. Default value: http://xmlns.oracle.com/ProcessSalesOrderFulfillmentOSMCFSCommsJMSProducer}ProcessSalesOrderFulfillmentOSMCFSCommsJMSProducer |
This value should be in consistent with EBSOverride.CommunicationsSalesOrderEBSV2.ProcessSalesOrderFulfillment.Address. |
Configuration Properties for BRM Services
Table 6-7 shows the properties for the ProcessFulfillmentOrderBillingBRMCommsAddSubProcess service.
Table 6-7 ProcessFulfillmentOrderBillingBRMCommsAddSubProcess Properties
Property Name | Value/Default Values | Description |
---|---|---|
Default.SystemID |
BRM_01 |
Default target billing system instance code (defined in BSR). This is used only if the request message does not contain the target information. |
BRM_01.FutureTimeThresholdForBillingDates |
8640 |
This property is used for future date validation in Billing Initiation. It is set to a default value of 8640 hours (360 days). This property is billing-instance-specific and must be set for any instance that the order must be sent for billing integration. See Using Single-Phase Billing or Two-Phase Billing for more information on how this property is used. |
ABCSExtension.PreInvokeEBM |
true/false. Default = false |
To indicate whether the ABCS has any extension before transformation of EBM to ABM. |
ABCSExtension.PostInvokeEBM |
true/false. Default = false |
To indicate whether the ABCS has any extension after transformation of EBM to ABM. |
ABCSExtension.PostprocessAddPCM_OP_SUBSSCRIPTION_PURCHASE_DEALABM |
true/false. Default = false |
To indicate whether the ABCS has any extension before calling BRM opcode PCM_ OP_SUBSCRIPTION_PURCHASE_DEAL. |
ABCSExtension.PostProcessA ddPCM_OP_ SUBSCRIPTION_ PURCHASE_DEALABM |
true/false. Default = false |
To indicate whether the ABCS has any extension after calling BRM opcode PCM_ OP_SUBSCRIPTION_PURCHASE_DEAL. |
ABCSExtension.PreProcessAd dPCM_OP_CUST_MODIFY_ CUSTOMERABM |
true/false. Default = false |
To indicate whether the ABCS has any extension before calling BRM opcode PCM_ OP_CUST_MODIFY_CUSTOMER. |
ABCSExtension.PostProcessA ddPCM_OP_CUST_ MODIFY_CUSTOMERABM |
true/false. Default = false |
To indicate whether the ABCS has any extension after calling BRM opcode PCM_ OP_CUST_MODIFY_CUSTOMER. |
Table 6-8 shows the properties for the ProcessFulfillmentOrderBillingBRMCommsDeleteSubProcess service.
Table 6-8 ProcessFulfillmentOrderBillingBRMCommsDeleteSubProcess Properties
Property Name | Value/Default Values | Description |
---|---|---|
Default.SystemID |
BRM_01 |
Default target billing system instance code (defined in BSR). This is used only if the request message does not contain the target information. |
ABCSExtension.PreInvokeEBM |
true/false. Default = false |
To indicate whether the ABCS has any extension before transformation of EBM to ABM. |
ABCSExtension.PostInvokeEBM |
true/false. Default = false |
To indicate whether the ABCS has any extension after transformation of EBM to ABM. |
ABCSExtension.PreProcessPCM_ OP_SUBSCRIPTION_CANCEL_ DISCOUNTABM |
true/false. Default = false |
To indicate whether the ABCS has any extension before calling BRM opcode PCM_OP_SUBSCRIPTION_CANCEL_ DISCOUNT. |
ABCSExtention.PostprocessPCM _OP_SUBSCRIPTION_CANCEL_ DISCOUNTABM |
true/false. Default = false |
To indicate whether the ABCS has any extension after calling BRM opcode PCM_OP_SUBSCRIPTION_CANCEL_ DISCOUNT. |
ABCSExtension.PreProcessPCM_ OP_SUBSCRIPTION_CANCEL_ PRODUCTABM |
true/false. Default = false |
To indicate whether the ABCS has any extension before calling BRM opcode PCM_OP_SUBSCRIPTION_CANCEL_ PRODUCT. |
ABCSExtention.PostProcessPCM _OP_SUBSCRIPTION_CANCEL_ PRODUCTABM |
true/false. Default = false |
To indicate whether the ABCS has any extension after calling BRM opcode PCM_OP_SUBSCRIPTION_CANCEL_ PRODUCT. |
ABCSExtension.PreProcessPCM_ OP_CUST_SET_STATUSABM |
true/false. Default = false |
To indicate whether the ABCS has any extension before calling BRM opcode PCM_OP_CUST_SET_STATUS. |
ABCSExtension.PostProcessPCM _OP_CUST_SET_STATUSABM |
true/false. Default = false |
To indicate whether the ABCS has any extension after calling BRM opcode PCM_OP_CUST_SET_STATUS. |
ABCSExtension.PreProcessPCM_ OP_SUBSCRIPTION_ PURCHASE_DEALABM |
true/false. Default = false |
To indicate whether the ABCS has any extension before calling BRM opcode PCM_OP_SUBSCRIPTION_ PURCHASE_DEAL. |
ABCSExtension.PostProcessPCM _OP_SUBSCRIPTION_ PURCHASE_DEALABM |
true/false. Default = false |
To indicate whether the ABCS has any extension after calling BRM opcode PCM_OP_SUBSCRIPTION_ PURCHASE_DEAL. |
Table 6-9 shows the properties for the ProcessFulfillmentOrderBillingBRMCommsMoveAddSubProcess service.
Table 6-9 ProcessFulfillmentOrderBillingBRMCommsMoveAddSubProcess Properties
Property Name | Value/Default Values | Description |
---|---|---|
Default.SystemID |
BRM_01 |
Default target billing system instance code (defined in BSR). This is used only if the request message does not contain the target information. |
ABCSExtension.PreInvokeEBM |
true/false. Default = false |
To indicate whether the ABCS has any extension before transformation of EBM to ABM. |
ABCSExtension.PostInvokeEBM |
true/false. Default = false |
To indicate whether the ABCS has any extension after transformation of EBM to ABM. |
ABCSExtension.PreProcessMoveAddPCM_OP_ SUBSCRIPTION_PURCHASE_ DEALABM |
true/false. Default = false |
To indicate whether the ABCS has any extension before calling BRM opcode PCM_ OP_SUBSCRIPTION_PURCHASE_DEAL. |
ABCSExtension.PostProcessMoveAddPCM_OP_ SUBSCRIPTION_PURCHASE_ DEALABM |
true/false. Default = false |
To indicate whether the ABCS has any extension after calling BRM opcode PCM_ OP_SUBSCRIPTION_PURCHASE_DEAL. |
Table 6-10 shows the properties for the ProcessFulfillmentOrderBillingBRMCommsProvABCSImpl service.
Table 6-10 ProcessFulfillmentOrderBillingBRMCommsProvABCSImpl Properties
Property Name | Value/Default Values | Description |
---|---|---|
Default.SystemID |
BRM_01 |
Default target billing system instance code (defined in BSR). This is used only if the request message does not contain the target information. |
Routing.BRMSUBSCRIPTIONService.RouteToCAVS |
true/false. Default = false |
CAVS simulator to be enabled or disabled for this partner link. |
Routing.BRMSUBSCRIPTIONService.BRM_01.EndpointURI |
End point for BRM Adapter. Example: eis/BRM |
End point for BRM Adapter. Example: Update with CAVS endpoint URL to route to CAVS along with changing the above property to "true" |
Routing.BRMSUBSCRIPTIONService.BRM_02.EndpointURI |
End point for BRM Adapter. Example: eis/BRM2 |
End point for BRM Adapter. Example: Update with CAVS endpoint URL to route to CAVS along with changing the above property to "true" |
Routing.BRMSUBSCRIPTIONService.BRM_03.EndpointURI |
End point for BRM Adapter. Example: eis/BRM3 |
End point for BRM Adapter. Example: Update with CAVS endpoint URL to route to CAVS along with changing the above property to "true" |
Routing.BRMCUSTService.RouteToCAVS |
true/false. Default = false |
CAVS simulator to be enabled or disabled for this partner link. |
Routing.BRMCUSTService.BRM_01.EndpointURI |
End point for BRM Adapter. Example: eis/BRM |
End point for BRM Adapter. Example: Update with CAVS endpoint URL to route to CAVS along with changing the above property to "true" |
Routing.BRMCUSTService.BRM_02.EndpointURI |
End point for BRM Adapter. Example: eis/BRM2 |
End point for BRM Adapter. Example: Update with CAVS endpoint URL to route to CAVS along with changing the above property to "true" |
Routing.BRMCUSTService.BRM_03.EndpointURI |
End point for BRM Adapter. Example: eis/BRM3 |
End point for BRM Adapter. Example: Update with CAVS endpoint URL to route to CAVS along with changing the above property to "true" |
Routing.BRMBALService.RouteToCAVS |
true/false. Default = false |
CAVS simulator to be enabled or disabled for this partner link. |
Routing.BRMBALService_ptt.BRM_01.EndpointURI |
End point for BRM Adapter. Example: eis/BRM |
End point for BRM adapter. Example: Update with CAVS endpoint URL to route to CAVS along with changing the above property to "true" |
Routing.BRMBALService_ptt.BRM_02.EndpointURI |
End point for BRM Adapter. Example: eis/BRM2 |
End point for BRM adapter. Example: Update with CAVS endpoint URL to route to CAVS along with changing the above property to "true" |
Routing.BRMBALService_ptt.BRM_03.EndpointURI |
End point for BRM Adapter. Example: eis/BRM3 |
End point for BRM adapter. Example: Update with CAVS endpoint URL to route to CAVS along with changing the above property to "true" |
Routing.BRMARService.RouteToCAVS |
true/false. Default = false |
CAVS simulator to be enabled or disabled for this partner link. |
Routing.BRMARService.BRM_01.EndpointURI |
End point for BRM Adapter. Example: eis/BRM |
End point for BRM adapter. Example: Update with CAVS endpoint URL to route to CAVS along with changing the above property to "true" |
Routing.BRMBASEService.RouteToCAVS |
true/false. Default = false |
CAVS simulator to be enabled or disabled for this partner link. |
Routing.BRMBASEService.BRM_01.EndpointURI |
End point for BRM Adapter. Example: eis/BRM |
End point for BRM adapter. Example: Update with CAVS endpoint URL to route to CAVS along with changing the above property to "true" |
ABCSExtension.PreInvokeEBM |
true/false. Default = false |
To indicate whether the ABCS has any extension before transformation of EBM to ABM. |
ABCSExtension.PostInvokeEBM |
true/false. Default = false |
To indicate whether the ABCS has any extension after transformation of EBM to ABM. |
ABCSExtension.PreProcessPCM_OP_CUST_CREATE_PROFILEABM |
true/false. Default = false |
To indicate whether the ABCS has any extension before calling BRM opcode PCM_OP_CUST_CREATE_PROFILE. |
ABCSExtension.PostProcessPCM_OP_CUST_CREATE_PROFILEABM |
true/false. Default = false |
To indicate whether the ABCS has any extension after calling BRM opcode PCM_OP_CUST_CREATE_PROFILE. |
ABCSExtension.PreProcessPCM_OP_CUST_MODIFY_PROFILEABM |
true/false. Default = false |
To indicate whether the ABCS has any extension before calling BRM opcode PCM_OP_CUST_MODIFY_PROFILE. |
ABCSExtension.PostProcessPCM_OP_CUST_MODIFY_PROFILEABM |
true/false. Default = false |
To indicate whether the ABCS has any extension after calling BRM opcode PCM_OP_CUST_MODIFY_PROFILE. |
ABCSExtension.PreProcessPCM_OP_CUST_DELETE_PROFILEABM |
true/false. Default = false |
To indicate whether the ABCS has any extension before calling BRM opcode PCM_OP_CUST_DELETE_PROFILE. |
ABCSExtension.PostProcessPCM_OP_CUST_DELETE_PROFILEABM |
true/false. Default = false |
To indicate whether the ABCS has any extension after calling BRM opcode PCM_OP_CUST_DELETE_PROFILE. |
ABCSExtension.PreProcessPCM_OP_SUBSCRIPTION_SET_BUNDLEABM |
true/false. Default = false |
To indicate whether the ABCS has any extension after calling BRM opcode PCM_ OP_SUBSCRIPTION_SET_BUNDLEABM. |
ABCSExtension.PostProcessPCM_OP_SUBSCRIPTION_SET_BUNDLEABM |
true/false. Default = false |
To indicate whether the ABCS has any extension after calling BRM opcode PCM_ OP_SUBSCRIPTION_SET_BUNDLEABM. |
EBSOverride.CommunicationsBillingEBSV1.ProcessFulfillmentOrderBillingResponse.Address |
Address of the web service that must be invoked. Example (Default): {http://host:port/soa-infra/services/default/ProcessFulfillmentOrderBillingResponseOSMCFSCommsJMSProducer/client |
This property is used to dynamically invoke any web service from this service. This holds the Address of the web service that must be invoked dynamically. To invoke CAVS/EBS or any other web service this property must be updated accordingly. |
EBSOverride.CommunicationsBillingEBSV1.ProcessFulfillmentOrderBillingResponse.PortType |
PortType of the web service that must be invoked. Example (Default): ProcessFulfillmentOrderBillingResponseOSMCFSCommsJMSProducer |
This property is used to dynamically invoke any web service from this service. This holds the PortType of the web service that must be invoked dynamically. To invoke CAVS/EBS or any other web service this property must be updated accordingly. |
EBSOverride.CommunicationsBillingEBSV1.ProcessFulfillmentOrderBillingResponse.ServiceName |
ServiceName of the web service that must be invoked. Example (Default): |
This property is used to dynamically invoke any web service from this service. This holds the ServiceName of the web service that must be invoked dynamically. To invoke CAVS/EBS or any other web service this property must be updated accordingly. |
Table 6-11 shows the properties for the ProcessFulfillmentOrderBillingBRMCommsSuspendResumeSubProcess service.
Table 6-11 ProcessFulfillmentOrderBillingBRMCommsSuspendResumeSubProcess Properties
Property Name | Value/Default Values | Description |
---|---|---|
Default.SystemID |
BRM_01 |
Default target billing system instance code (defined in BSR). This is used if the request message does not contain the target information. |
ABCSExtension.PreInvokeEBM |
true/false. Default = false |
To indicate whether the ABCS has any extension before transformation of EBM to ABM. |
ABCSExtension.PostInvokeEBM |
true/false. Default = false |
To indicate whether the ABCS has any extension after transformation of EBM to ABM. |
ABCSExtension.PreProcessResumePCM_OP_CUST_SET_ STATUSABM |
true/false. Default = false |
To indicate whether the ABCS has any extension before calling BRM opcode PCM_ OP_CUST_SET_STATUS for resume scenario. |
ABCSExtension.PostProcessResumePCM_OP_CUST_SET_ STATUSABM |
true/false. Default = false |
To indicate whether the ABCS has any extension after calling BRM opcode PCM_ OP_CUST_SET_STATUS for resume scenario. |
ABCSExtension.PreProcessSuspendPCM_OP_CUST_SET_ STATUSABM |
true/false. Default = false |
To indicate whether the ABCS has any extension before calling BRM opcode PCM_ OP_CUST_SET_STATUS for suspend scenario. |
ABCSExtension.PostProcessSuspendPCM_OP_CUST_SET_ STATUSABM |
true/false. Default = false |
To indicate whether the ABCS has any extension after calling BRM opcode PCM_ OP_CUST_SET_STATUS for suspend scenario. |
ABCSExtension.PreProcessResumePCM_OP_SUBSCRIPTION_ PURCHASE_DEALABM |
true/false. Default = false |
To indicate whether the ABCS has any extension before calling BRM opcode PCM_ OP_SUBSCRIPTION_PURCHASE_DEAL for resume scenario. |
ABCSExtension.PostProcessResumePCM_OP_SUBSCRIPTION_ PURCHASE_DEALABM |
true/false. Default = false |
To indicate whether the ABCS has any extension after calling BRM opcode PCM_ OP_SUBSCRIPTION_PURCHASE_DEAL for resume scenario. |
ABCSExtension.PreProcessSuspendPCM_OP_SUBSCRIPTION_ PURCHASE_DEALABM |
true/false. Default = false |
To indicate whether the ABCS has any extension before calling BRM opcode PCM_ OP_SUBSCRIPTION_PURCHASE_DEAL for suspend scenario. |
ABCSExtension.PostProcessSuspendPCM_OP_ SUBSCRIPTION_PURCHASE_ DEALABM |
true/false. Default = false |
To indicate whether the ABCS has any extension after calling BRM opcode PCM_ OP_SUBSCRIPTION_PURCHASE_DEAL for suspend scenario. |
ABCSExtension.PreProcessPCM_OP_SUBSCRIPTION_SET_DISCOUNT_STATUSABM |
true/false. Default = false |
To indicate whether the ABCS has any extension before calling BRM opcode PCM_ OP_SUBSCRIPTION_SET_DISCOUNT_ STATUS. |
ABCSExtension.PostProcessPC M_OP_SUBSCRIPTION_SET_ DISCOUNT_STATUSABM |
true/false. Default = false |
To indicate whether the ABCS has any extension after calling BRM opcode PCM_ OP_SUBSCRIPTION_SET_DISCOUNT_ STATUS. |
ABCSExtension.PreProcessPCM _OP_SUBSCRIPTION_SET_ PRODUCT_STATUSABM |
true/false. Default = false |
To indicate whether the ABCS has any extension before calling BRM opcode PCM_ OP_SUBSCRIPTION_SET_PRODUCT_ STATUS. |
ABCSExtension.PostProcessPC M_OP_SUBSCRIPTION_SET_ PRODUCT_STATUSABM |
true/false. Default = false |
To indicate whether the ABCS has any extension after calling BRM opcode PCM_ OP_SUBSCRIPTION_SET_PRODUCT_ STATUS. |
Table 6-12 shows the properties for the ProcessFulfillmentOrderBillingBRMCommsUpdateSubProcess service.
Table 6-12 ProcessFulfillmentOrderBillingBRMCommsUpdateSubProcess Properties
Property Name | Value/Default Values | Description |
---|---|---|
Default.SystemID |
BRM_01 |
Default target billing system instance code (defined in BSR). This is used if the request message does not contain the target information. |
ABCSExtension.PreInvokeEBM |
true/false. Default = false |
To indicate whether the ABCS has any extension before transformation of EBM to ABM. |
ABCSExtension.PostInvokeEBM |
true/false. Default = false |
To indicate whether the ABCS has any extension after transformation of EBM to ABM. |
ABCSExtension.PreProcessUpdate1PCM_OP_SEARCHABM |
true/false. Default = false |
To indicate whether the ABCS has any extension before making the first BRM opcode call PCM_OP_SEARCH. |
ABCSExtension.PostProcessUpdate1PCM_OP_SEARCHABM |
true/false. Default = false |
To indicate whether the ABCS has any extension after making the first BRM opcode call PCM_OP_SEARCH. |
ABCSExtension.PreProcessUpdate2PCM_OP_SEARCHABM |
true/false. Default = false |
To indicate whether the ABCS has any extension before making the second BRM opcode call PCM_OP_SEARCH. |
ABCSExtension.PostProcessUpdate2PCM_OP_SEARCHABM |
true/false. Default = false |
To indicate whether the ABCS has any extension after making the second BRM opcode call PCM_OP_SEARCH. |
ABCSExtension.PreProcessUpdate1PCM_OP_CUST_MODIFY_ CUSTOMERABM |
true/false. Default = false |
To indicate whether the ABCS has any extension before making the first BRM opcode call PCM_OP_CUST_MODIFY_ CUSTOMER. |
ABCSExtension.PostProcessUpdate1PCM_OP_CUST_ MODIFY_CUSTOMERABM |
true/false. Default = false |
To indicate whether the ABCS has any extension after making the first BRM opcode call PCM_OP_CUST_MODIFY_ CUSTOMER. |
ABCSExtension.PreProcessUpdate2PCM_OP_CUST_MODIFY_ CUSTOMERABM |
true/false. Default = false |
To indicate whether the ABCS has any extension before making the second BRM opcode call PCM_OP_CUST_MODIFY_ CUSTOMER. |
ABCSExtension.PostProcessUpdate2PCM_OP_CUST_ MODIFY_CUSTOMERABM |
true/false. Default = false |
To indicate whether the ABCS has any extension after making the second BRM opcode call PCM_OP_CUST_MODIFY_ CUSTOMER. |
ABCSExtension.PreProcessPCM _OP_SUBSCRIPTION_ TRANSFER_ SUBSCRIPTIONABM |
true/false. Default = false |
To indicate whether the ABCS has any extension before making the BRM opcode call PCM_OP_SUBSCRIPTION_ TRANSFER_SUBSCRIPTION. |
ABCSExtension.PostProcessPCM_OP_SUBSCRIPTION_ TRANSFER_ SUBSCRIPTIONABM |
true/false. Default = false |
To indicate whether the ABCS has any extension after making the BRM opcode call PCM_OP_SUBSCRIPTION_ TRANSFER_SUBSCRIPTION. |
ABCSExtension.PreProcessPCM _OP_CUST_UPDATE_ SERVICESABM |
true/false. Default = false |
To indicate whether the ABCS has any extension before making the BRM opcode call PCM_OP_CUST_UPDATE_SERVICE. |
ABCSExtension.PostProcessPCM_OP_CUST_UPDATE_ SERVICESABM |
true/false. Default = false |
To indicate whether the ABCS has any extension after making the BRM opcode call PCM_OP_CUST_UPDATE_SERVICE. |
Setting the BRM Version Number for Backward Price List Compatibility
When sending order data to BRM, Oracle AIA checks the BRM version number in the Oracle AIA system configuration property. Oracle AIA sends order line price list information to BRM versions 7.5 and later. For earlier versions of BRM, Oracle AIA does not send the order line price list information.
To support the behavior for earlier versions of BRM, you must change the version number in the AIA system configuration property.
To change the BRM version number:
-
Browse to your AIA Home Page. For example:
http://host:port/AIA
-
In the Setup area, click Go.
-
Select the Systems tab.
-
In the Version column of the BRM row, enter your BRM version number.
-
Save your changes.
Configuring Customer Management
This section describes how to configure customer management in the Order to Cash business process.
About Configuring Customer Management
Configuring customer management includes:
-
Working with domain value maps (DVMs) and cross-references.
-
Handling error notifications.
-
Setting Oracle AIA configuration properties.
This section assumes that you have already installed Oracle Communications Billing and Revenue Management (BRM) and Siebel CRM. See Oracle Application Integration Architecture Compatibility Matrix for information about required versions and patches.
Working with Domain Value Maps for Customer Management
DVMs are a standard feature of the Oracle SOA Suite that enable you to equate lookup codes and other static values across applications, for example, FOOT and FT or US and USA.
DVMs are static in nature, though administrators can add maps as required. Transactional business processes never update DVMs; they only read from them. They are stored in XML files and cached in memory at run time.
DVM types are seeded for the customer management flows, and administrators can extend the list of mapped values by adding more maps.
Table 6-13 lists the DVMs for the process integration for customer management.
Table 6-13 Customer Management DVMs
DVM | Columns | Description |
---|---|---|
CUSTOMERPARTY_ACCOUNTTYPECODE.dvm |
SEBL_01, COMMON, BRM_01 |
Used to get the type of the account, such as Business or Residential. |
PROVINCE.dvm |
SEBL_01, COMMON, BRM_01 |
Province name. |
STATE.dvm |
SEBL_01, COMMON, BRM_01 |
State name. |
ADDRESS_COUNTRYID.dvm |
SEBL_01, COMMON, BRM_01 |
Country codes. |
ADDRESS_COUNTRYSUBDIVID.dvm |
SEBL_01, COMMON, BRM_01 |
State codes. |
CONTACT_SALUTATION.dvm |
SEBL_01, COMMON, BRM_01 |
Salutation (such Mr., Mrs.). In BRM, Salutation is not a language-independent code. If BRM requires salutations in a language other than English, then you must update the DVM with the appropriate BRM values. |
CURRENCY_CODE.dvm |
SEBL_01, COMMON, BRM_01 |
Currency codes. |
CUSTOMERPARTY_BILLPROFILE_BILLTYPECODE.dvm |
SEBL_01, COMMON, BRM_01 |
Bill type (summary and detailed). |
CUSTOMERPARTY_BILLPROFILE_FREQUENCYCODE.dvm |
SEBL_01, COMMON, BRM_01 |
Billing frequency (monthly, yearly, quarterly, and so on). |
CUSTOMERPARTY_PAYPROFILE_BANKACCOUNTTYPE.dvm |
SEBL_01, COMMON, BRM_01 |
Bank account type (checking, savings, and so on). |
CUSTOMERPARTY_PAY PROFILE CREDIT_CARDTYPE.dvm |
SEBL_01, COMMON |
Credit Card type (Visa, Mastercard, and so on). |
CUSTOMERPARTY_PAYPROFILE_DELIVERYPREF.dvm |
COMMON, BRM_01 |
Bill media/delivery preference (Email or Mail). |
CUSTOMERPARTY_PAYPROFILE_PAYMETHODCODE.dvm |
SEBL_01, COMMON, BRM_01 |
Payment profile payment method types (credit card, direct debit, and invoice/bill me). |
CUSTOMERPARTY_PAYPROFILE_PAYTERMCODE.dvm |
COMMON, BRM_01 |
Payment term codes. |
CUSTOMERPARTY_STATUSCODE.dvm |
SEBL_01, COMMON, BRM_01 |
Account status codes. |
PHONENUMBER_TYPE.dvm |
SEBL_01, COMMON, BRM_01 |
Phone number type codes (home, work, mobile, fax, and so on). |
See Oracle Fusion Middleware Developer's Guide for Oracle Application Integration Architecture Foundation Pack for more information about working with DVMs.
Working with Cross-References for Customer Management
Cross-references map and connect the records within the application network, and they enable these applications to communicate in the same language. The integration server stores the relationship in a persistent way so that others can refer to it.
Table 6-14 lists the customer management cross-references.
Table 6-14 Customer Management Cross-References
Cross-Reference Table Name | COMMON | SEBL_01 | BRM_01 |
---|---|---|---|
CUSTOMERPARTY_ACCOUNTID |
Common GUID (generated by Oracle AIA) |
Account ID |
Account POID |
CUSTOMERPARTY_BILLPROFILEID |
Bill Profile ID |
Bill Profile ID |
Bill-info POID |
CUSTOMERPARTY_PAYPROFILEID |
Payment Profile ID |
Bill Profile ID |
Pay-info POID |
CUSTOMERPARTY_ADDRESSID |
Address ID |
Address ID |
Account POID (if this is the billing address) Pay-info POID (if this is the pay-info address) |
CUSTOMERPARTY_CONTACTID |
Contact ID |
Contact ID |
Account POID (if this is the main contact) Pay-info POID (if this is the pay-info contact) |
CUSTOMERPARTY_DEFAULTBALANCEGROUPID |
Account ID |
Not applicable |
Balance Group POID |
CUSTOMERPARTY_PARTYID |
Customer Party ID |
Customer Party ID |
Not applicable |
CUSTOMERPARTY_PARTYLOCATIONID.xref |
Customer Party Location ID |
Customer Party Location ID |
Not applicable |
CUSTOMERPARTY_LOCATIONREFID |
Customer Party Location Reference ID |
Customer Party Location Reference ID |
Not applicable |
CUSTOMERPARTY_ACCOUNT_PHONECOMMID |
Customer Account's phone number |
Customer Account's phone number |
Not applicable |
CUSTOMERPARTY_ACCOUNT_FAXCOMMID |
Customer Account's fax number |
Customer Account's fax number |
Not applicable |
CUSTOMERPARTY_ACCOUNT_WEBCOMMID |
Customer Account's email address |
Customer Account's email address |
Not applicable |
CUSTOMERPARTY_CONTACT_PHONECOMMID |
Customer Contact's phone number |
Customer Contact's phone number |
Not applicable |
CUSTOMERPARTY_CONTACT_FAXCOMMID |
Customer Contact's fax number |
Customer Contact's fax number |
Not applicable |
CUSTOMERPARTY_CONTACT_EMAILCOMMID |
Customer Contact's email address |
Customer Contact's email address |
Not applicable |
Handling Error Notifications
Based on the roles defined for the services, email notifications are sent if a service ends due to an error. Table 6-15 lists the errors that are caused by the process integration for customer management services.
Table 6-15 Errors Caused by Customer Management Services
Service Name | Error Code | Possible Cause |
---|---|---|
SyncCustomerPartyListBRMCommsProvABCSImpl |
AIA_ERR_AIACOMCMPI_0004 |
Subordinate account cannot have multiple parent accounts. |
SyncCustomerPartyListBRMCommsProvABCSImpl |
AIA_ERR_AIACOMCMPI_0005 |
Ambiguous subordinate bill profile update: Multiple distinct Pay-From-Party billing profile references are associated with a single Prior Pay-From-Party billing profile reference. |
SyncCustomerPartyListBRMCommsProvABCSImpl |
AIA_ERR_AIACOMCMPI_0006 |
None of the existing subordinate bill profiles are included in the move account request. |
CommsProcessBillingAccountListEBF |
AIA_ERR_AIACOMCMPI_0001 |
EBMHeader/Sender/ID is required. |
CommsProcessBillingAccountListEBF |
AIA_ERR_AIACOMCMPI_0002 |
EBMHeader/Target/ID is required. |
CommsProcessBillingAccountListEBF |
AIA_ERR_AIACOMCMPI_0003 |
Account sequence error: Pay-From accounts and billing profiles must appear before dependent and subordinate accounts and billing profiles. |
About Error Notification Roles and Users
The integration uses the following default roles and users to issue error notifications:
-
Role: AIAIntegrationAdmin
-
User: AIAIntegrationAdminUser
See Oracle Fusion Middleware Infrastructure Components and Utilities User's Guide for Oracle Application Integration Architecture Foundation Pack for more information about setting up error notifications.
Order Fallout Management
When an order is submitted from Siebel CRM, the order may fail while customer-related information is being interfaced to BRM. In that case, a trouble ticket is generated by the Order Fallout flow. The trouble ticket generated is displayed in Siebel CRM. This helps the Customer Service Representative (CSR) in getting notified about any error while processing the order without checking the instances in the Business Process Execution Language (BPEL) Console.
Whenever an error occurs during customer synchronization, it is propagated to the CommsProcessFulfillmentOrderBillingAccountListEBF. This enterprise business flow (EBF) generates an error notification in the error topic (similar to any other Oracle AIA process). From the error topic, the order fallout flow is triggered only for the CommsProcessFulfillmentOrderBillingAccountListEBF (among all the processes in customer management process integration), thereby generating one trouble ticket for any error.
See About Order Fallout Management for more information about order fallout.
Configuring the Process Integration for Customer Management
Configure the properties described in this section in the Comms_home/source/soainfra/apps/AIAMetaData/config/AIAConfigurationProperties.xml file.
See Oracle Fusion Middleware Developer's Guide for Oracle Application Integration Architecture Foundation Pack for more information about working with AIAConfigurationProperties.xml.
Note:
Entries in the AIAConfigurationProperties.xml file are case sensitive.
System-Level Configuration Properties
Table 6-16 shows the system-level properties for the process integration for customer management.
Table 6-16 Customer Management System-level Properties
Property Name | Value/Default Value | Description |
---|---|---|
O2C.LegalGroup |
TRUE/FALSE. Default: FALSE |
Determines whether the integration creates collections sharing groups in BRM. If set to TRUE, the integration creates collections sharing groups when the owner account and billing account on an order line are different. If set to FALSE, the integration ignores the owner account and does not create collections sharing groups. |
Configuration Properties for BRM Services
Table 6-17 shows the properties for the ProcessCollectionSharingBRMCommsProvABCSImpl service.
Table 6-17 ProcessCollectionSharingBRMCommsProvABCSImpl Properties
Property Name | Value/Default Value | Description |
---|---|---|
Default.SystemID |
BRM_01 |
Specifies the BRM instance code. It is used if the request message does not contain the target system ID. |
Routing.BRMCOLLECTIONSService.RouteToCAVS |
true/false Default: false |
Specifies whether the end point routes to CAVS. |
Routing.BRMCOLLECTIONSService.BRM_01.EndpointURI |
Default: eis/BRM |
Specifies the end point URL for the CAVS. |
ABCSExtension.ABCSExtension.PreXformABMtoEBM |
true/false Default: false |
Indicates whether the ABCS has been extended before the EBM to ABM transformation. |
ABCSExtension.PostXformEBMtoABM |
true/false Default: false |
Indicates whether the ABCS has been extended after the EBM to ABM transformation. |
Table 6-18 shows the properties for the SyncCustomerPartyListBRMCommsProvABCSImpl service.
Table 6-18 SyncCustomerPartyListBRMCommsProvABCSImpl Properties
Property Name | Value/Default Value | Description |
---|---|---|
Default.SystemID |
BRM_01 |
Specifies the BRM instance code that is used if the request message does not contain the target system ID. |
EBSOverride.CommunicationsCustomerPartyEBSV2.SyncCustomerPartyListResponse.PortType |
CommsProcessBillingAccountListEBF |
The port type of the web service to invoke dynamically. This value should be consistent with the Address property. |
EBSOverride.CommunicationsCustomerPartyEBSV2.SyncCustomerPartyListResponse.ServiceName |
{http://xmlns.oracle.com/EnterpriseFlows/Industry/Comms/CommsProcessBillingAccountListEBF/V1}CommsProcessBillingAccountListEBF |
The service name of the web service to invoke dynamically. This value should be consistent with the Address property. |
EBSOverride.CommunicationsCustomerPartyEBSV2.SyncCustomerPartyListResponse.Address |
http://SOA_host:port/soa-infra/services/default/CommsProcessBillingAccountListEBF/client |
The address endpoint URI of a web service, such as CAVS or another ABCS, to dynamically invoke from this service. |
EnableAccountStatusSync |
true/false. Default: false |
Indicates whether the integration synchronizes account status. When set to true, the integration synchronizes account status from Siebel CRM to BRM. |
Routing.BRMCUSTService.BRM_01.EndpointURI |
Default: eis/BRM |
Specifies the connection factory to connect to the BRM JCA adapter for the first of multiple instances of BRM for the CUST opcodes. |
Routing.BRMCUSTService.RouteToCAVS |
true/false. Default: false |
Specifies whether the end point routes to CAVS for the CUST opcodes. |
AccountLevelBalanceGroupName |
Account Level Balance Group |
Names the default balance group created in BRM when an account is created. |
ABCSExtension.PreXFormEBMtoABM |
true/false. Default: false |
Indicates whether the ABCS has been extended before the EBM to ABM transformation. |
ABCSExtension.PreInvokePCM_OP_BILL_GROUP_GET_PARENTABM |
true/false. Default: false |
Indicates whether the ABCS has been extended before the invocation of the opcode in the property name. |
ABCSExtension.PostInvokePCM_OP_BILL_GROUP_GET_PARENTABM |
true/false. Default: false |
Indicates whether the ABCS has been extended after the invocation of the opcode in the property name. |
ABCSExtension.PreInvokePCM_OP_SEARCHABM |
true/false. Default: false |
Indicates whether the ABCS has been extended before the invocation of the opcode in the property name. |
ABCSExtension.PostInvokePCM_OP_SEARCHABM |
true/false. Default: false |
Indicates whether the ABCS has been extended after the invocation of the opcode in the property name. |
ABCSExtension.PreInvokeABSPCM_OP_CUST_COMMIT_CUSTOMERABM |
true/false. Default: false |
Indicates whether the ABCS has been extended before the invocation of the opcode in the property name. |
ABCSExtension.PostInvokeABSPCM_OP_CUST_COMMIT_CUSTOMERABM |
true/false. Default: false |
Indicates whether the ABCS has been extended after the invocation of the opcode in the property name. |
ABCSExtension.PreInvokePCM_OP_CUSTCARE_MOVE_ACCTABM |
true/false. Default: false |
Indicates whether the ABCS has been extended before the invocation of the opcode in the property name. |
ABCSExtension.PostInvokePCM_OP_CUSTCARE_MOVE_ACCTABM |
true/false. Default: false |
Indicates whether the ABCS has been extended after the invocation of the opcode in the property name. |
ABCSExtension.PreInvokePCM_OP_CUST_UPDATE_CUSTOMERABM |
true/false. Default: false |
Indicates whether the ABCS has been extended before the invocation of the opcode in the property name. |
ABCSExtension.PostInvokePCM_OP_CUST_UPDATE_CUSTOMERABM |
true/false. Default: false |
Indicates whether the ABCS has been extended after the invocation of the opcode in the property name. |
ABCSExtension.PreInvokePCM_OP_CUST_DELETE_PAYINFOABM |
true/false. Default: false |
Indicates whether the ABCS has been extended before the invocation of the opcode in the property name. |
ABCSExtension.PostInvokePCM_OP_CUST_DELETE_PAYINFOABM |
true/false. Default: false |
Indicates whether the ABCS has been extended after the invocation of the opcode in the property name. |
ABCSExtension.PostXFormABMtoEBM |
true/false. Default: false |
Indicates whether the ABCS has been extended after the ABM to EBM transformation. |
Routing.BRMCUSTService_ptt.RouteToCAVS |
true/false. Default: false |
Specifies whether to route to CAVS for the CUST opcodes. |
Routing.BRMCUSTCAREService.RouteToCAVS |
true/false. Default: false |
Specifies whether to route to CAVS for the CUSTCARE opcodes. |
Routing.BRMBILLService.RouteToCAVS |
true/false. Default: false |
Specifies whether to route to CAVS for BILL opcodes. |
Routing.BRMBASEService.RouteToCAVS |
true/false. Default: false |
Specifies whether to route to CAVS for BASE opcodes. |
Routing.BRMTXNService.RouteToCAVS |
true/false. Default: false |
Specifies whether to route to CAVS for TXN opcodes. |
Configuration Properties for Siebel CRM Services
Table 6-19 shows the properties for the SyncAccountSiebelReqABCSImpl service.
Table 6-19 SyncAccountSiebelReqABCSImpl Properties
Property Name | Value/Default Values | Description |
---|---|---|
Default.SystemID |
SEBL_01 |
Specifies the Siebel CRM instance code that is used if the request message does not contain the target system ID. |
ABCSExtension.PreXformABMtoEBMABM |
true/false. Default: false |
Indicates whether the ABCS has been extended before the ABM to EBM transformation. |
ABCSExtension.PreInvokeEBSEBM |
true/false. Default: false. |
Indicates whether the ABCS has been extended before the EBS invocation. |
Routing.SWICustomerParty.SEBL_01.EndpointURI |
http://Siebel_host:port/eai_Siebel_language/start.swe?SWEExtSource=SecureWebService&SWEExtCmd=Execute&WSSOAP=1 |
Endpoint URI of the SEBL_01 Siebel instance. |
Routing.SWICustomerParty.RouteToCAVS |
true/false. Default: false. |
Specifies whether the end point routes to CAVS. |
Routing.SWICustomerParty.CAVS.EndpointURI |
http://SOA_host:port/AIAValidationSystemServlet/syncresponsesimulator |
Specifies the end point URL for the CAVS service. |
Routing.CustomerPartyEBSV2.SyncCustomerPartyList.MessageProcessingInstruction.EnvironmentCode |
PRODUCTION |
NA |
RoutingCustomerPartyEBSV2.SyncCustomerPartyList.CAVS.EndpointURI |
http://${fp.server.soaserverhostname}:{fp.server.soaserverport}/AIAValidationSystemServlet/asyncrequestrecipient |
Specifies whether the end point routes to CAVS. |
Routing.CustomerPartyEBSV2.SyncCustomerPartyList.RouteToCAVS |
true/false. Default: false. |
Specifies whether the end point routes to CAVS. |
Routing.TransformAppContextSiebelService.RouteToCAVS |
true/false. Default: false. |
Specifies whether the end point routes to CAVS. |
Routing.TransformAppContextSiebelService.CAVS.EndpointURI |
http://${fp.server.soaserverhostname}:{fp.server.soaserverport}/AIAValidationSystemServlet/asyncrequestrecipient |
Specifies whether the end point routes to CAVS. |
Account.ProcessUpdateEventsOnly |
true/false. Default: true. |
To optimize the integration flow, leave this property set to true. This prevents the Siebel CRM ABCS from propagating create events. By default the integration supports creation of customers only as part of the order flow. Setting this property to false results in a less optimized flow, and the default integration behavior remains the same. See Oracle Application Integration Architecture Pre-Built Integrations Functional Interoperability Configuration Guide for more information. |
Contact.QueryAllEntities |
true/false. Default: false. |
NA |
Address.QueryAllEntities |
true/false. Default: false. |
NA |
Table 6-20 shows the properties for the ProcessAccountHierarchyListSiebelCommsProvABCSImpl service.
Table 6-20 ProcessAccountHierarchyListSiebelCommsProvABCSImpl Properties
Property Name | Value/Default Value | Description |
---|---|---|
Default.SystemID |
SEBL_01 |
Specifies the Siebel CRM instance code that is used if the request message does not contain the target system ID. |
ABCSExtension.PreXformEBMtoABM |
true/false Default: false |
Indicates whether the ABCS has been extended before the EBM to ABM transformation. |
ABCSExtension.PostXformEBMtoABM |
true/false Default: false |
Indicates whether the ABCS has been extended after the EBM to ABM transformation. |
Routing.SWI_spcAccount_spcHierarchy.RouteToCAVS |
true/false Default: false |
Specifies whether the end point routes to CAVS. |
Routing.SWI_spcAccount_spcHierarchy.CAVS.EndpointURI |
http://SOA_server:port/AIAValidationSystemServlet/syncresponsesimulator. |
Specifies the CAVS endpoint URI for the Siebel CRM adapter. |
Routing.SWI_spcAccount_spcHierarchy.SEBL_01.EndpointURI |
http://Siebel_server:port/eai_Siebel_language/start.swe?SWEExtSource=SecureWebService&SWEExtCmd=Execute&WSSOAP=1 |
Specifies the Siebel CRM instance endpoint URI. |
Routing.SWI_spcAccount_spcHierarchy.MessageProcessingInstruction.EnvironmentCode |
PRODUCTION |
Specifies the type of environment for which to route to CAVS. |
ABCSExtension.PreInvokeABS |
true/false Default: false |
Indicates whether the ABCS invokes the extension service before invoking the application. |
ABCSExtension.PostInvokeABS |
true/false Default: false |
Indicates whether the ABCS invokes the extension service after invoking the application. |
Table 6-21 shows the properties for the QueryCustomerPartyListSiebelProvABCSImpleV2 service.
Table 6-21 QueryCustomerPartyListSiebelProvABCSImpleV2 Properties
Property Name | Value/Default Value | Description |
---|---|---|
Default.SystemID |
SEBL_01 |
Specifies the Siebel CRM instance code that is used if the request message does not contain the target system ID. |
ABCSExtension.PreXformEBMtoABMEBM |
true/false Default: false |
Indicates whether the ABCS has been extended before the EBM to ABM transformation. |
ABCSExtension.PostXformABMtoEBMEBM |
true/false Default: false |
Indicates whether the ABCS has been extended after the EBM to ABM transformation. |
Routing.SWI_spcCustomer_spcParty_spcService.RouteToCAVS |
true/false Default: false |
Specifies whether the end point routes to CAVS. |
Routing.SWI_spcCustomer_spcParty_spcService.CAVS.EndpointURI |
http://SOA_server:port/AIAValidationSystemServlet/syncresponsesimulator. |
Specifies the CAVS endpoint URI for the Siebel CRM adapter. |
Routing.SWI_spcCustomer_spcParty_spcService.SEBL_01.EndpointURI |
http://Siebel_server:port/eai_Siebel_language/start.swe?SWEExtSource=SecureWebService&SWEExtCmd=Execute&WSSOAP=1 |
Specifies the Siebel CRM instance endpoint URI. |
Routing.SWI_spcAccount_spcHierarchy.MessageProcessingInstruction.EnvironmentCode |
PRODUCTION |
Specifies the type of environment for which to route to CAVS. |
ABCSExtension.PreInvokeSWICustServiceABM |
true/false Default: false |
Indicates whether the ABCS invokes the extension service before invoking the Siebel CRM web service. |
ABCSExtension.PostInvokeSWICustServiceABM |
true/false Default: false |
Indicates whether the ABCS invokes the extension service after invoking the Siebel CRM web service. |
Configuring Order Fallout Management
This section describes how to configure order fallout management in the Order to Cash business process.
About Configuring Order Fallout Management
Configuring order fallout management includes:
-
Configuring Oracle AIA
-
Configuring Siebel CRM to integrate with Oracle AIA
-
Working with domain value maps (DVMs) and cross-references
-
Handling error notifications
-
Setting Oracle AIA configuration properties
This section assumes that you have already installed Siebel CRM. See the Oracle AIA software compatibility matrix available from My Oracle Support for information about required versions and patches.
Configuring Oracle AIA for Order Fallout Management
To configure Oracle AIA for order fallout management:
-
If necessary, update the data seeded by the installation process in the AIA_ERROR_NOTIFICATIONS table. See Using Error Type to Control Response to Order Fallout for more information.
-
Ensure that the SystemType for the applications configured in the AIA_SYSTEMS table matches the COMMON value of the TROUBLETICKET_AREA DVM.
Configuring Siebel CRM for Integrated Order Fallout Management
To configure Siebel CRM for order fallout management, add the following dependencies to Siebel Trouble Ticket Area's List of Values (LOVs) for the trouble ticket functionality:
Area: Oracle OSM - OLM Oracle OSM - Provisioning BRM_01 Sub-Area: OSM OLM ABC OSM Provisioning ABC BRM ABC
Add any additional values needed for your environment.
See Siebel documentation for more information on adding values to a LOV.
Working with Domain Value Maps for Order Fallout Management
DVMs are a standard feature of the Oracle SOA Suite. They enable you to equate lookup codes and other static values across applications, for example, FOOT and FT or US and USA.
DVMs are static in nature, though administrators can add additional maps as required. Transactional business processes never update DVMs; they only read from them. DVMs are stored in XML files and cached in memory at run time.
DVM types are seeded for the order fallout flows, and administrators can extend the list of mapped values by adding more maps. The DVM data should be synchronized with what the participating applications use.
Table 6-22 lists the DVMs for the process integration for order fallout.
Table 6-22 Order Fallout Management DMVs
DVM | Description |
---|---|
TROUBLETICKET_AREA |
DVM to map the Area of the trouble ticket. SEBL_01 column maps to the Area element in Siebel CRM. COMMON column points to the SystemCode column of the corresponding system in the AIA Systems page. |
TROUBLETICKET_SUBAREA |
DVM to map the SubArea of the trouble ticket. SEBL_01 column maps to the Sub-Area element in Siebel CRM. COMMON column points to the appropriate FailureSubSystemCode or the faulting service. |
TROUBLETICKET_STATUS |
DVM to map the status of the trouble ticket. SEBL_01 column maps to the Status element in Siebel CRM. COMMON column maps to the appropriate status in Oracle AIA. |
TROUBLETICKET_SEVERITY |
DVM to map the severity of the trouble ticket. SEBL_01 column maps to the Severity element in Siebel CRM. COMMON column maps to the appropriate severity (1-5) in Oracle AIA. |
TROUBLETICKET_PRIORITY |
DVM to map the recovery priority of the trouble ticket. SEBL_01 column maps to the Priority element in Siebel CRM. COMMON column maps to the appropriate priority (1-4) in Oracle AIA. |
See "Working with Message Transformations", Working with DVMs and Cross-References in Oracle Fusion Middleware Developer's Guide for Oracle Application Integration Architecture Foundation Pack for more information.
Working with Cross-References for Order Fallout Management
Cross-references map and connect the records within the application network, and they enable these applications to communicate in the same language. The integration server stores the relationship in a persistent way so that others can refer to it.
Table 6-23 lists the order fallout cross-reference.
Table 6-23 Order Fallout Management Cross-Reference
Cross-Reference Table Name | Column NameCOMMON | Column ValueSEBL_01 | Description |
---|---|---|---|
TROUBLETICKET_TROUBLETICKETID |
CreateTroubleTicketResponseEBM/DataArea/CreateTroubleTicketResponse/Identification/BusinessComponentID stores this value. A randomly generated ID is used as the COMMON value for the trouble ticket and referenced with the Siebel value. |
The row ID for the trouble ticket created in Siebel, which is returned in the ListOfSWITroubleTicketIO/TroubleTicket/Id element of the response of the web service, is cross-referenced. |
The trouble ticket ID returned by the Siebel web service is cross-referenced to the BusinessComponentID of the TroubleTicket Response enterprise business message (EBM). The idea is to use this cross-referenced value for making any updates to this trouble ticket. So this cross-referencing is done only when the response is sought from the process CreateTroubleTicketSiebelCommsProvABCSImpl. |
Handling Error Notifications for Order Fallout Management
Based on the roles defined for the services, email notifications are sent if a service ends due to an error.
Table 6-24 lists the localized custom errors that are caused by the order fallout management services for data insufficiency for creating a trouble ticket.
Table 6-24 Localized Custom Errors
Error Code | Message Text |
---|---|
AIA_ERR_AIACOMOFMPI_0001 |
Data Insufficient for Trouble Ticket Creation. Order Originating System Code not available. |
AIA_ERR_AIACOMOFMPI_0002 |
Data Insufficient for Trouble Ticket Creation. Order ID not available. |
For more information about the errors caused by Siebel CRM or BRM, see the documentation for that product.
See Oracle Fusion Middleware Infrastructure Components and Utilities User's Guide for Oracle Application Integration Architecture Foundation Pack for more information about AIA error handling.
About Error Notification Roles and Users
The integration uses the following default roles and users to issue error notifications:
-
Role: AIAIntegrationAdmin
-
User: AIAIntegrationAdminUser
See Oracle Fusion Middleware Infrastructure Components and Utilities User's Guide for Oracle Application Integration Architecture Foundation Pack for more information about setting up error notifications.
Using Error Type to Control Response to Order Fallout
The ERROR_TYPE column in the AIA Error Notifications table (AIA_ERROR_NOTIFICATION) determines what happens when there is a failure during order processing.
The supported values for ERROR_TYPE are:
-
AIA_EH_DEFAULT - Generates the standard Oracle AIA error notification.
-
AIA_ORDERFALLOUT_CFS - Results in Oracle AIA notifying an order management system or central fulfillment system (such as OSM) regarding the order fallout so that it can create and manage the trouble ticket. This value enables the default Order Fallout handling for the Create and Manage Trouble Ticket for Order Fallout flow.
-
AIA_ORDERFALLOUT_TTS - Results in Oracle AIA creating a trouble ticket for the order fallout. This value enables the default Order Fallout handling for the Create Trouble Ticket for Order Fallout flow.
The value AIA_EH_DEFAULT can be combined with the value AIA_ORDERFALLOUT_CFS or AIA_ORDERFALLOUT_TTS, using a comma as the separator. For example, AIA_EH_DEFAULT,AIA_ORDERFALLOUT_CFS results in the actions associated with both the values being triggered.
Note:
You cannot have both AIA_ORDERFALLOUT_CFS and AIA_ORDERFALLOUT_TTS values specified for a given record.
If both the Oracle Communications Order to Cash Siebel CRM business process option and the Oracle Communications Order to Cash OSM business process options are installed, the seeded value for ERROR_TYPE is AIA_ORDERFALLOUT_CFS. If the Oracle Communications Order to Cash: Siebel CRM business process option is installed alone (without the Oracle Communications Order to Cash OSM business process option) the seeded value for ERROR TYPE is AIA_ORDERFALLOUT_TTS.
Different ERROR_TYPE values can be given for different combinations of BPEL and ESB service, business process, system code, and error code. As delivered, Oracle AIA seeds these values for all order services. In cases where a service is used in multiple business processes, it is separately seeded for each business process.
In any given order service, there can be two categories of errors:
-
Business Errors
A business error is usually due to invalid or incomplete data on the order or missing setup in the end fulfillment system, which results in the request to process an order failing. In this case, for the order to be successfully processed, either the order must be corrected or revised and resubmitted, or the setup in the end fulfillment system must be corrected and the order resubmitted. For this type of error, Order Fallout should be triggered.
This type of error usually happens when an order reaches either the participating or the edge application (such as BRM). The expectation is that the fault coming from the application is a BPEL error code: "{http://schemas.oracle.com/bpel/extension}bindingFault". BRM returns a bindingFault when it sees a business error in the order.
-
All Other Errors
This includes system errors. System errors can arise when a certain system (such as BRM or BRM JCA Adapter) is down. The assumption is that there is actually nothing wrong with the order data itself and when system errors are addressed, the order can be resubmitted without any changes. For these types of errors, Order Fallout should not occur.
Order services are delivered seeded with two entries in the AIA_ERROR_NOTIFICATIONS table:
-
Error Code - "{http://schemas.oracle.com/bpel/extension}bindingFault
The seeded value for Error Type is either AIA_EH_DEFAULT,AIA_ORDERFALLOUT_TTS or AIA_EH_DEFAULT,AIA_ORDERFALLOUT_CFS. The expected behavior for this case is both standard AIA error notification and order fallout processing occurs.
-
Error Code - null or no value
The seeded value for Error Type is AIA_EH_DEFAULT. The expected behavior for this case is only standard Oracle AIA error notification occurs.
Table 6-25 is an example entry for the ProcessFulfillmentOrderBillingBRMCommsAddSubProcess order service.
Table 6-25 Example Entry for ProcessFulfillmentOrderBillingBRMCommsAddSubProcess Order Service
Error Code | Service Name | Error Type | Error Extn Handler |
---|---|---|---|
-- |
ProcessFullmentOrderBillingBRMCommsAddSubProcess |
AIA_EH_DEFAULT |
AIACOM_OFM_EXT |
{http://schemas.oracle.com/bpel/extension}bindingFault |
ProcessFullmentOrderBillingBRMCommsAddSubProcess |
AIA_EH_DEFAULT,AIA_ORDERFALLOUT_CFS |
AIACOM_OFM_EXT |
If additional error codes are also classified as business errors, you can add new entries into the AIA_ERROR_NOTIFICATIONS table with the appropriate Error Code value.
Note:
The Error Extn Handler value for all order service entries must be AIACOM_OFM_EXT. This is required so that the correct information is in the fallout and the standard error notification.
You can perform a bulk update or the error types for all of the processes by using a SQL script to update the table ERROR_TYPE column in the AIA_ERROR_NOTIFICATIONS table with the appropriate values. See the $AIA_HOME/pips/Communications/O2C/DatabaseObjects/AIA_OFM_CreateOrderFalloutAIAErrorNotificationsData.sql for reference. After the table is updated, you must restart FMW.
Configuring Order Fallout Services
Configure the properties described in this section in the COMMS_AIA_HOME/source/soainfra/apps/AIAMetaData/config/AIAConfigurationProperties.xml file.
See Oracle Fusion Middleware Developer's Guide for Oracle Application Integration Architecture Foundation Pack for more information about working with AIAConfigurationProperties.xml.
Note:
Entries in the AIAConfigurationProperties.xml file are case sensitive.
Table 6-26 shows the properties for the CreateTroubleTicketAIACommsReqImpl service.
Table 6-26 CreateTroubleTicketAIACommsReqImpl Properties
Property Name | Value/Default Values | Description |
---|---|---|
Sender.Default.SystemID |
COMMON |
Use this only if the request message does not contain the system instance ID. This value is always COMMON because this service is triggered from Oracle AIA. |
EBSOverride.TroubleTicketEBS.CreateTroubleTicket.PortType |
{http://xmlns.oracle.com/ABCSImpl/Siebel/Industry/Comms/CreateTroubleTicketSiebelCommsProvABCSImpl/V1}CreateTroubleTicketSiebelCommsProvABCSImplService |
Port Type of the provider ABCS/EBS service of the CreateTroubleTicket operation. |
EBSOverride.TroubleTicketEBS.CreateTroubleTicket.Address |
http://${fp.server.soaserverhostname}:${fp.server.soaserverport}/soa-infra/services/default/CreateTroubleTicketSiebelCommsProvABCSImpl/CreateTroubleTicketSiebelCommsProvABCSImpl |
Address of the provider ABCS/EBS service CreateTroubleTicket operation. |
EBSOverride.TroubleTicketEBS.CreateTroubleTicket.ServiceName |
{http://xmlns.oracle.com/ABCSImpl/Siebel/Industry/Comms/CreateTroubleTicketSiebelCommsProvABCSImpl/V1}CreateTroubleTicketSiebelCommsProvABCSImplService |
Service Name of the provider ABCS/EBS service of the CreateTroubleTicket operation. |
TroubleTicket.DefaultSeverity |
Any number from 1 to 5. Default = 2. |
If the fault message does not have any severity associated with it, the default severity is assigned to the fault message and reflects the same in the trouble ticket. |
TroubleTicket.DefaultPriority |
Any number from 1 to 4. Default = 2. |
This service assigns the recovery priority for the trouble ticket by default to the value specified in this configuration property. |
Table 6-27 shows the properties for the CreateTroubleTicketSiebelCommsProvABCSImpl service name.
Table 6-27 CreateTroubleTicketSiebelCommsProvABCSImpl Properties
Property Name | Value/Default Values | Description |
---|---|---|
Default.SystemID |
SEBL_01 |
Siebel system instance code (defined in BSR). Used when the target system cannot be identified from the request message or if the configuration property. TroubleTicket.UseDefaultInstance is set to true. |
ABCSExtension.PreXformEBMtoABMTroubleTicketEBM |
true/false Default: false |
Value determines whether the ABCS should invoke the Extension service (before the EBM to ABM transformation). |
ABCSExtension.PostXformABMtoEBMTroubleTicketEBM |
true/false Default: false |
Value determines whether the ABCS should invoke the Extension service (after the ABM to EBM transformation). |
ABCSExtension.PreInvokeABSSWITroubleTicketIOABM |
true/false Default: false |
Value determines whether the ABCS should invoke the Extension service (PreInvoke Application). |
ABCSExtension.PostInvokeABSSWITroubleTicketIOABM |
true/false Default: false |
Value determines whether the ABCS should invoke the Extension service (PostInvoke Application). |
EBSOverride.TroubleTicketEBSResponse.CreateTroubleTicketResponse.PortType |
{http://xmlns.oracle.com/Industry/Comms/CreateTroubleTicketRespOSMCFSCommsJMSProducer/V1}CreateTroubleTicketRespOSMCFSCommsJMSProducer |
Port Type of the provider ABCS/EBS service of the CreateTroubleTicketResponse operation. |
EBSOverride.TroubleTicketEBSResponse.CreateTroubleTicketResponse.Address |
http://${fp.server.soaserverhostname}:${fp.server.soaserverport}/soa-infra/services/default/CreateTroubleTicketRespOSMCFSCommsJMSProducer |
Address of the provider ABCS/EBS service of the CreateTroubleTicketResponse operation. |
EBSOverride.TroubleTicketEBSResponse.CreateTroubleTicketResponse.ServiceName |
{http://xmlns.oracle.com/Industry/Comms/CreateTroubleTicketRespOSMCFSCommsJMSProducer/V1}CreateTroubleTicketRespOSMCFSCommsJMSProducer |
Service Name of the provider ABCS/EBS service of the CreateTroubleTicketResponse operation. |
Routing.SWI_spcTrouble_spcTicket_spcService.RouteToCAVS |
true/false Default: false |
Indicates whether the Partner link SWI_spcTrouble_spcTicket_spcService should be routed to CAVS or the actual application. |
Routing.SWI_spcTrouble_spcTicket_spcService.SEBL_01.EndpointURI |
Endpoint URI of the SEBL_01 Siebel instance |
Endpoint URI of the SEBL_01 Siebel instance or CAVS simulator (if RouteToCAVS is true). |
TroubleTicket.GenerateTroubleTicketResponse |
true/false Default: false |
CreateTroubleTicketSiebelCommsProvABCSImpl creates a trouble ticket response message (creates a cross-reference for the trouble ticket ID with the Siebel ID) and invokes the CommunicationsTroubleTicketResponseEBSV1 if this property is set to true or if the response code attribute is not null. Otherwise, this service acts only as a fire-and-forget flow and ignores the response. |
TroubleTicket.UseDefaultInstance |
true/false Default: false |
If set to true, overwrites the target Siebel instance to the default instance indicated by the property Default.SystemID. Gives the user an option to create a trouble ticket in a Siebel instance different from the one where the order was placed. |
TroubleTicket.SR_TYPE |
Order Failure |
SR_TYPE identifies that the trouble ticket is for Order Failure. Siebel web service expects this value to be Order Failure for Order Failure Trouble Tickets. |
Table 6-28 shows the properties for the UpdateTroubleTicketSiebelCommsProvABCSImpl service name.
Table 6-28 UpdateTroubleTicketSiebelCommsProvABCSImpl Properties
Property Name | Value/Default Values | Description |
---|---|---|
Default.SystemID |
SEBL_01 |
Siebel system instance code (defined in BSR). Used when the target system cannot be identified from the request message or if the configuration property TroubleTicket.UseDefaultInstance is set to true. |
ABCSExtension.PreXformEBMtoABMTroubleTicketEBM |
true/false Default: false |
Value determines whether the ABCS should invoke the Extension service (before the EBM to ABM transformation). |
ABCSExtension.PreInvokeABSSWITroubleTicketIOABM |
true/false Default: false |
Value determines whether the ABCS should invoke the Extension service (PreInvoke Application). |
Routing.SWI_spcTrouble_spcTicket_spcService.RouteToCAVS |
true/false Default: false |
Indicates whether the Partner link SWI_spcTrouble_spcTicket_spcService should be routed to CAVS or the actual application. |
Routing.SWI_spcTrouble_spcTicket_spcService.SEBL_01.EndpointURI |
Endpoint URI of the SEBL_01 Siebel instance |
Endpoint URI of the SEBL_01 Siebel instance or CAVS simulator (if RouteToCAVS is true). |
Table 6-29 shows the properties for the CreateOrderFalloutNotificationOSMCFSCommsProvImpl service.
Table 6-29 CreateOrderFalloutNotificationOSMCFSCommsProvImpl Properties
Property Name | Value/Default Values | Description |
---|---|---|
Default.SystemID |
OSMCFS_01 |
Siebel system instance code (defined in BSR). Used when the target system cannot be identified from the request message or if the configuration property TroubleTicket.UseDefaultInstance is set to true. |
Routing.CreateOrderFalloutNotification.OSMCFS_01.EndpointURI |
http://${http.host name}:${http.port}/orabpel/default/CreateOrderFalloutNotificationOSMCFSCommsJMSProducer/1.0 |
Endpoint URI of the service that sends the fallout notification to OSMCFS_01. The default value is the EndpointURI of the out-of-the-box JMS enqueuing or producing service that enqueues or produces the message in the OSM JMS Queue. |
Fault.DefaultSeverity |
Any number from 1 to 5 Default - 2 |
If the fault message has no severity associated with it, assigns the default severity to the fault message and reflects the same in the trouble ticket. |
The following fields extract the localized values using the aia:getAIALocalizedString xpath function:
EBM Field Name: DataArea / CreateTroubleTicket / Description Siebel Field Name: Description ResourceBundle - oracle.apps.aia.core.i18n.AIAListResourceBundle ResourceBundle Key - TROUBLETICKET_DESCRIPTION Resource Bundle Value: SalesOrder- {OrderNumber} # {OrderRevision}for Account {AccountName} failed at {Timestamp} -- EBM Field Name: EBMHeader/BusinessScope/ID Siebel Field Name: Abstract ResourceBundle - oracle.apps.aia.core.i18n.AIAListResourceBundle ResourceBundle Key - TROUBLETICKET_ABSTRACT Resource Bundle Value: [{Timestamp}] Trouble Ticket for (Sales)Order - {OrderNumber} # {OrderRevision}