2 Launch Cloud Service PDC (BRM) Integration
This chapter outlines the configuration steps required to integrate Launch with Pricing Design Center (PDC) or Billing Revenue Management (BRM). The integration helps customers who want to take advantage of the latest capabilities of the Oracle Launch Cloud Service while leveraging their existing investment in BRM.
Related Guides
Table 2-1 contains information about other useful sources of information for the integration process.
Table 2-1 Related Guides
Reference | Description |
---|---|
Launch Cloud Service User's Guide | Describes how you can create, publish, and manage product offers. |
REST API Reference for Launch Cloud Service | Provides the REST API reference document for Launch Cloud Service. |
Oracle PDC-BRM Documentation | PDC/BRM documentation to create client credentials and security requirements for PDC/RSM deployment |
Supported Versions
- Launch release version 25.01 or later and
- Oracle PDC/BRM 12 PS8 plus Patch 35361657
Supported Integration and Mapping
Launch-PDC Integration uses the mapping service which enables you to create a proxy API that can push the data into PDC/BRM. The mapping service currently works for the following entities in Launch. All other entities are ignored. Table 2-2 lists the entities that can currently be mapped.
Table 2-2 Supported Integration and Mapping
Launch Entity | PDC Entity | What can you synchronize? |
---|---|---|
Simple product offering |
Charge offer of Subscription type |
Definition Pricing Charging terms |
Simple product offering with fees and alterations |
Charge offer of Subscription type / Item / Account type (based on Launch definition). |
Definition Pricing and Adjustments |
N/A |
Discount offer of Subscription type. The name of the discount offer will be post fixed with _DISCOUNT. For DBE customers, the _DISCOUNT post fix won't be there. Discount offers will be post fixed with _DISCOUNT only for NON-DBE customers. |
Charging terms |
Simple offering of device/accessory type |
Charge offering of Account type |
Definition Pricing |
Attribute based pricing |
Charge Selector |
Definition Pricing |
Package |
Package |
Definition Components Commitment terms |
Service Bundle |
Bundle |
Definition Components Commitment terms |
Attribute based pricing |
Charge Selector |
Definition Pricing |
Attribute based adjustment |
Discount Selector |
Definition Pricing |
Setting up Launch PDC/BRM Integration
There are a few setups required to be done in Launch, Industry Framework and BRM for Publish from Launch-to-PDC.
Setup Task List
Table 2-3 Setup Task List
No. | Application | Task | Mandatory? | Description |
---|---|---|---|---|
1. |
Industry Framework |
Create Integration User |
Yes |
This is required to facilitate the integration between the two applications. |
2. |
Launch |
Register destinations |
Yes |
This is required to configure the right spoke instance to receive the publishing events. |
3. |
Launch |
Configure Entity Profile |
Yes |
This is required to ensure that Launch can model catalog definitions based on PDC/BRM. |
4. |
Industry Framework |
Configure the spoke systems |
Yes |
This is required to ensure to configure the spoke system instance for receiving publishing events. |
5. |
PDC REST Services Manager |
Create client credentials and security requirements |
Yes |
N/A |
6. |
Launch and PDC/BRM |
Set up Configuration entities |
Yes |
This is required to meet the Launch and PDC configuration setup. |
Setup Task Details
-
Create a new user with the user name FABRIC_SYSTEM_USER and the role Communications Catalog Administrator using the Security Console. If you have already created this as a part of the Launch setup, no additional setup is required.
-
Register Destination in Launch for publishing to PDC/BRM instance. Usually, you would have many PDC/BRM instances such as (Development, SIT, UAT and Production). Each instance of BRM instance is a destination that needs to be setup for Launch to publish to the correct PDC instance.
Configure destinations in Launch to appropriate life cycle status for which you would like to publish to external application. For example, you can configure a destination for test instance to the Ready to Publish life cycle status and configure one for production instance to the Active status.
While adding destinations, use:-
Name – The target pre-selection key from the Connection Descriptor in the Industry Framework.
-
Type - The target name used in Catalog Sync configuration.
-
Internal – Set this to ON.
Here’s the list of steps to create a Siebel destination:
-
Navigate to the Launch user interface > Administration > Lifecycle Status.
-
Select the new lifecycle configuration version in the PENDING state.
-
Choose the Edit option for the In design state and click Add Destination.
- Provide the Name, Type, and Publish Sequence. Click Add.
Note:
Destination Name and Type should match the spoke system configuration in the CX Industries Framework. - Select the PDC destination name in the Destinations field and save it.
- Choose the Activate option for the PENDING lifecycle configuration version.
- Verify that the new lifecycle configuration version changed to the ACTIVE state.
For more information on how to configure the Destination in Launch, see REST API Reference for Launch Cloud Service and "Publish Catalog Entities" in Launch Cloud Service Implementation Guide.
Note:
The destination Name setup in Launch should be an exact match to the system descriptor creation using config.ms in CXIF. This helps in identifying the correct Siebel instance for one-time migration (“Source” field in migration job) and in the mapping for Publishing to the appropriate Siebel instance. Ensure that you use the same name for system parameter name in system Descriptors while applying the configuration in step 5. -
-
Configure the Entity Profile to ensure that PDC/BRM supported product modeling is followed by Launch using the Entity Profile tile in Administration space.
No two applications are the same when it comes to modeling capabilities and so is the case between PDC/BRM and Launch. Though the result might be the same, the constructs might be different between the applications, and while integrating the applications, you need to factor in any restrictions of the target(spoke) application to ensure an error-free publishing of catalog definitions. Some of the common patterns between PDC and Launch can be classified as:
-
Both the applications have the same construct capabilities and restrictions for an entity at par - for example, Balance Element, Product Offering, Service Specification entities, and so on.
-
Both the applications have minimal common capabilities and/or additional capabilities or restrictions in one and not in the other - for example, PDC/BRM and Launch can have commitment terms, but Launch has the provision to configure multiple commitment terms to an offer, while only one commitment term is supported in PDC/BRM package.
-
-
Configure your external application in the Industry Framework for each instance. For more information, refer to the topic Integrate External Applications to add a Spoke End Point in the article Implement CX Industries Framework, on My Oracle Support, Doc ID 2720527.1.
-
Create client credentials and security requirements for PDC/BRM. See PDC/BRM documentation for information about creating client credentials and security requirements for PDC/RSM deployment.
-
Ensure that the services, events and service-event maps, general ledger IDs (GLID), tax codes, and balance elements required for charge or discount offers are set appropriately.
Before setting up integration, complete the following conditional tasks in PDC/BRM and Launch.
-
GLID name on Launch and BRM system should be same.
-
In Launch → Setup and Maintenance, go to standard lookup ORA_ATC_GLID and set the GLID. Example: Create 101 GLID in launch.
-
In PDC, use pin_glid application to create the general ledger ID. Create 101 GLID in PDC.
-
-
Tax code name on Launch and BRM system should be same.
-
a. In Launch, use the REST API operation to create https:///<HOST>/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogReferenceManagement/v1/taxServiceProvider. Example: Tax001 should be setup as taxCode in taxSupplier in Launch.
-
In PDC, set up the same set of tax codes as configured in Launch.
-
-
Balance element name, code, numeric code on Launch needs to be same as PDC.
-
In Launch, use the REST API to create the Balance element https:///<HOST>/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogReferenceManagement/v1/balanceElement.Example: Name: US Dollar, code - USD, numeric code – 840 and so on.
-
In PDC, configure the Balance Element (Name, Code, Numeric code), along with other attributes that should match with attributes in Launch.
-
-
Usage specification name and metering rule name in Launch needs to be same as the configured Usage event and RUM name on PDC side.
-
In Launch, use the REST API to create the usage specification https://<HOST>/crmRestApu/atcProductCatalog/11.13.18.05/tmf-api/usageManagement/v2/usageSpecification. The fields name, meteringRule.name should match with PDC. Example: EventDelayedTelcoGSMTelephony, meteringRule.name – Duration
-
In PDC, configure the serviceEventMap with the same event name and RUM.
-
-
The Service specification code in service specification in Launch and Service Event Map Name on BRM side should be same.
-
Launch Service Specification service code needs to be configured. Example: The service code /service/telco/gsm/telephony needs to be same on both systems.
-
In PDC, configure the ServiceEventMap.
-
-
Sample Mapping
Table 2-4 shows a sample mapping between Launch and PDC entities.
Table 2-4 Sample Mapping
Entity | Launch | PDC |
---|---|---|
Usage Specification |
EventDelayedTelcoGSMTelephony Metering Rule: Duration |
EventDelayedTelcoGSMTelephony (Event) RUM: Duration |
UOM (Unit of Measure) |
ORA_ATC_UOM |
UOM |
Tax Code |
TAX001 |
TAX001 |
Product Offering Billing Service Type |
Populate the Service code - /service/telco/gsm/telephony in ORA_ATC_BILLING_SERVICE_TYPE and then use it on product offering billing service type |
Service - /service/telco/gsm/telephony (BRM) serviceTelcoGSMTelephony(PDC) Configure the service-event maps. |
Product Specification |
Wireless PS
Populate the Service Specification - Wireless CFS |
N/A |
GLID |
101 |
101 |
Balance Element |
Name: US Dollars Code: USD Numeric code: 840 |
Name: US Dollars Code: USD Numeric code: 840 |
Price Tag |
CT01 |
CT01 |
Impact Category |
Common business configuration impact category IC_INTERNATIONAL |
IC_INTERNATIONAL |
Supported Scenarios
Table 2-5 lists the supported integration scenarios.
Table 2-5 Supported Scenarios
S.No. | What you can publish? | Launch Entity | PDC Entity |
---|---|---|---|
1. |
Simple Offer with one time price |
Simple product offering of service type Supported fee types are Purchase and Cancel |
Charge offering of service type ( EventBillingProductFeePurchase EventBillingProductFeeCancel ) |
2. |
Simple Offer with recurring price |
Simple product offering of service type Supported recurring frequency - Monthly, Bi-Monthly, Semi Annual, Annual, Quarterly, Arrear and Forward Arrear |
Charge offering of service type with the event of the below recurring frequency with the scaled fee. ( EventBillingProductFeeCycleCycle_forward_annual - Occurrence EventBillingProductFeeCycleCycle_forward_semiannual - Occurrence EventBillingProductFeeCycleCycle_forward_quarterly - Occurrence EventBillingProductFeeCycleCycle_forward_bimonthly - Occurrence EventBillingProductFeeCycleCycle_forward_monthly - Occurrence) EventBillingProductFeeCycleCycle_arrear - Occurrence EventBillingProductFeeCycleCycle_forward_arrear - Occurrence ) |
3. |
Simple Offer with one time, recurring and usage fee (any metering rule) |
Simple product offering of service type |
Charge offering of service type with the one time, recurring, and usage fee |
4. |
Simple Offer with a one- time, recurring price along with one time, recurring fixed/% discount |
Simple offering with fees and adjustments of type fixed discount or percentage discount |
Charge offering of service type with the one time, recurring, and usage fee. Discount offering with a fixed or percentage discount for the one-time fee |
5. |
Simple Offer with a usage fee and usage discount |
Simple offering with usage fees, metering rule, UOM with usage percentage or fixed discount |
Charge offering of service type with the usage fee. Discount offering with a fixed or percentage discount for the usage fee |
6. |
Simple Offer - Tiered pricing |
Simple offer with one time/recurring tiered pricing |
Charge offer of service type with one time/recurring tiered pricing |
7. |
Simple offer - Usage tiered pricing |
Simple offer with usage tiered pricing |
Charge offer with usage tiered pricing |
8. |
Re-use of price plans in Simple offer |
Simple offer with reused price plans |
Charge offer with reused rate plans |
9. |
Simple offer with Time Limited Discounts sync from Launch to BRM (Only absolute validity) |
Simple offer with one time/recurring/usage limited time discount |
Charge offer/Discount offer with rate plan validity |
10. |
Factor the following integration scenarios cloning, revisions |
Clone Simple offer revision Simple offer Retire Simple offer Obsolete |
Charge offer revise Charge offer obsolete Charge offer obsolete |
11. |
Launch - BRM - Simple offering with allowances |
Simple offering with single allowance |
Charge offering of service type with the non- currency resource granted part of one time, recurring, and usage fee for consumption. Discount offering for non-currency resource consumption |
12. |
Launch - BRM - Simple offering with Allowance and Overage |
Simple offering with single allowance and overage |
Charge offering of service type with the non- currency resource granted part of one time, recurring, and usage fee for consumption. Discount offering for non-currency resource consumption |
13. |
Launch - BRM - Simple offering with Attribute based pricing (one time, recurring and usage) |
Simple offer with attribute-based pricing for usage with service specification and usage specification characteristics. Simple offer with attribute-based pricing for one time and recurring with service specification and customer specification characteristics. |
Charge offer with charge selector |
14. |
Launch BRM - Simple offering with one-time, recurring fees and discounts along with Charging terms |
Simple offer with charging terms |
Charge offer/Discount offer with rate plan configuration or charging details like proration and increments |
15. |
Launch - BRM - Simple offering with one-time, recurring fees and usage fees (reuse of price plan alteration) |
Simple offer with reused discount price plan |
Discount offer with reused discount rate plan |
16. |
Simple Offer with a one time, recurring, usage volume discount (tiered, volume) |
Simple offer with one time/recurring/usage tiered and volume discount |
Charge offer and Discount offer with one time/recurring/usage tiered and volume discount |
17. |
Service Bundle (No nesting of bundles) |
Service bundle |
Bundle |
18. |
Package with commitment terms (no nested bundles or commercial bundles, aggregate groups) |
Package |
Package with commitment terms |
19. |
Service Bundle with commitment terms (No nesting of bundles) |
Service bundle |
Bundle with commitment terms |
20. |
Package (no nested bundles or commercial bundles, aggregate groups) |
Package |
Package |
21. |
Simple Offer with attribute-based adjustments for usage |
Simple offer with attribute-based adjustment for usage (customer specification, service specification, usage specification) |
Charge offer and Discount offer with Discount Selector |
22. |
Publish other type of product offering (like discounts) |
Simple offering with other type of product offering + discount |
Discount offers |
23. |
Simple Offer with multiple allowances and consumption model |
Simple offer With multiple allowances and consumption model |
Charge offer and Discount offer (consumption model) |
24. |
Simple Offer with usage prices based on zoning |
Simple offer with Value Map zoning |
Charge offer using charge selector with value map zoning |
25. |
Simple Offers with adjustments based on triggers |
Simple offer, triggers on adjustments (Total Charge, Total Quantity, Price Tag, Expression as trigger conditions) |
Discount offer with discount trigger (price tag in Launch maps to impact category in discount filter) |
26. |
Simple offers with multiple price lists |
Simple offers with multiple price lists. (Fees are created with different price lists within the same simple offers.) |
Charge offers with Charge selectors. The charge selectors are used to configure charge rate plans based on price lists. |
27. |
Simple offers with adjustments and user/share balance |
Simple offers with adjustments and user/sharer balance |
Discount offers with different types of discounts which applies to user/sharer balance. |
28. |
Simple offers with Balance Consumption Model |
Simple offers with Balance Consumption Model without Allowance configured in usage fee (Consumption Discount Model). |
Discount offers with Balance Consumption Model |
29. |
Simple offers with standard zone |
Simple offer with attribute based pricing for usage based on standard zone |
Charge offer using charge rate plan with standard zone |
30. |
Simple offers with price tags for run time price overrides |
Simple offer with price tags on product offering prices |
Charge and discount offers with rates having price tags |
31. |
Simple offers with multiple usage prices |
Simple offers with multiple usage prices. Attach appropriate usage specification for each usage fee |
Charge and discount offers with multiple usage events |