Contents

Title and Copyright Information

Preface

• Audience
• Accessing Oracle Communications Documentation
• Documentation Accessibility
• Document Revision History

1 Overview of the Order-to-Activate Cartridges

• About the Application Integration Architecture Order-to-Activate Cartridges
• Order-to-Activate Business Process Overview
• Overview of the Order-to-Activate Cartridges
• Order-to-Activate Cartridge Solution Options
• OSM Cartridge Types Supporting the Order to Cash Integration Pack for OSM Solution
• Extending the Cartridges
• Time Zones in Order-to-Activate Cartridges
• Order Creation in the Order-to-Activate Cartridges
• Order-to-Activate Emulators
• About Fulfillment Topologies
  • Simple Fulfillment Topology
  • Typical and Complex Fulfillment Topologies

2 Performing an Interactive Installation of the Order-to-Activate Components

• Cartridge Installation Overview
• System Requirements
  • Order-to-Activate Cartridge Compatibility
• Order-to-Activate Cartridge Pre-Installation Tasks
• Installing the Order-to-Activate Cartridges
  • Getting the Installation Package
  • Importing the Installation Cartridge and Configuring the Installation Build File
  • Importing the OSM Order-to-Activate Cartridges for the Calculate Service Order Solution Option
  • Importing the OSM Order-to-Activate Cartridges for the Solution Option Without Calculate Service Order
  • Configuring WebLogic Server Resources
• Building and Deploying the Order-to-Activate Cartridges
• Testing the Order-to-Activate Cartridges
• Switching Between Live and Emulator Configurations
• Configuring a Workspace Without Configuring WebLogic Server
• Uninstalling Order-to-Activate Components
  • Undeploying Cartridges
  • Deleting the Oracle AIA Emulator
  • Removing the Inventory and Technical Order Management Emulators

3 Performing a Silent Installation of the Order-to-Activate Cartridges

• Cartridge Installation Overview
• Directory Placeholders Used in This Chapter
• System Requirements
  • Order-to-Activate Cartridge Compatibility
• Setting Up the Installation Environment
  • Getting the Installation Package
  • Setting Up Files and Directories
  • Encrypting the Passwords Used by the Silent Installer
    • Encrypting the WebLogic Server Administrator Password for Connecting to WebLogic
    • Encrypting the WebLogic Server Administrator Password for Use with XML Import/Export
    • Encrypting Passwords for the Standard Order-to-Activate User Accounts
    • Encrypting the UIM Application User Password
    • Encrypting the Technical Order Management Application User Password
    • Encrypting the Password for Deploying the Cartridges
    • Encrypting the Oracle AIA JMS Connection Password
    • Encrypting the UIM JMS Connection Password
    • Encrypting the Technical Order Management JMS Connection Password
    • Encrypting the Asset Management System JMS Connection Password
• Configuring the build.properties File
  • Configuring Software Path Settings
  • Configuring Solution Import Settings
  • Configuring WebLogic Server Settings
  • Configuring Solution Configuration Settings
  • Configuring Oracle AIA Connection Settings
  • Configuring UIM Connection Settings
  • Configuring Technical Order Management Connection Settings
  • Configuring Asset Management System Settings
• Performing the Silent Installation
  • Building the Solution Cartridges
  • Building the Solution Cartridges and Configuring the WebLogic Server Resources
  • Deploying the Cartridges
• Testing the Order-to-Activate Cartridges
• Switching Between Live and Emulator Configurations
• Configuring a Workspace Without Configuring WebLogic Server
• Uninstalling Order-to-Activate Components

4 Order-to-Activate Cartridge Contents

• Cartridge Overview
  • Common Order Management Cartridges
  • Central Order Management Cartridges
    • Common Central Order Management Cartridges
    • Central Order Management Cartridges for the Calculate Service Order Solution Option
    • Central Order Management Cartridges for the Solution Option Without Calculate Service Order
  • Service Order Management Cartridges
    • Service Order Management Cartridges for the Calculate Service Order Solution Option
    • Service Order Management Cartridges for the Solution Option Without Calculate Service Order
  • Conceptual Model Projects
    • Common Conceptual Model Projects
    • Conceptual Model Projects for Central Order Management
    • Conceptual Model Projects for Service Order Management
• Common Order Management Cartridges
  • OracleComms_OSM_CommonDataDictionary
  • OracleComms_OSM_O2A_AIAEBMDataDictionary
  • OracleComms_OSM_O2A_CommonUtility
  • OracleComms_OSM_O2A_ControlMap
    • Configuring Breakpoints for Central Order Management and for Service Order Management Without Calculate Service Order
    • Configuring Breakpoints for Service Order Management with Calculate Service Order
    • Controlling Point of No Return
    • Controlling Fault Simulation
    • Controlling Order Updates
    • Controlling Processing Granularity for FulfillBillingFunction
  • OracleComms_OSM_O2A_RecognitionFallout
  • OracleComms_OSM_O2A_SystemAdmin
    • How the Inbound Message Recovery MDB Works
    • Recovering from Inbound Message Errors Due to Suspended Orders
    • Recovering from Inbound Message Errors Due to Resource Issues
• Common Central Order Management Cartridges
  • OracleComms_OSM_O2A_COM_Base
    • Order Events
    • Processing Granularity Rules
    • Abstract Orchestration Entities
    • Order Lifecycle Manager Configuration
    • XQuery Modules in the OracleComms_OSM_O2A_COM_Base Cartridge
    • Automation Modules in the OracleComms_OSM_O2A_COM_Base Cartridge
    • External Fulfillment States
  • OracleComms_OSM_O2A_COM_SalesOrderFulfillment
  • OracleComms_OSM_O2A_COM_Billing
    • SyncCustomerFunction
    • InitiateBillingFunction
    • FulfillBillingFunction
    • Billing Dates for Billing Patterns
  • OracleComms_OSM_O2A_COM_Provisioning
  • OracleComms_OSM_O2A_COM_Shipping_Sample
  • OracleComms_OSM_O2A_COM_Install_Sample
  • OracleComms_OSM_O2A_COM_Recognition_Sample
    • Revision Number Update for Canceled Orders
  • OracleComms_OSM_O2A_COM_Asset
• Central Order Management Cartridges for the Calculate Service Order Solution Option
  • OracleComms_OSM_O2A_COM_CSO_Base
  • OracleComms_OSM_O2A_COM_CSO_Broadband_Internet_Access_CFS
  • OracleComms_OSM_O2A_COM_CSO_Email_CFS
  • OracleComms_OSM_O2A_COM_CSO_FulfillmentPattern
  • OracleComms_OSM_O2A_COM_CSO_FulfillmentStateMap
  • OracleComms_OSM_O2A_COM_CSO_Internet_Media_CFS
  • OracleComms_OSM_O2A_COM_CSO_IP_Fax_CFS
  • OracleComms_OSM_O2A_COM_CSO_Model_Container
  • OracleComms_OSM_O2A_COM_CSO_Provisioning
    • External Fulfillment States
  • OracleComms_OSM_O2A_COM_CSO_SalesOrders
  • OracleComms_OSM_O2A_COM_CSO_Solution
  • OracleComms_OSM_O2A_COM_CSO_Topology
  • OracleComms_OSM_O2A_COM_CSO_VoIP_Access_CFS
  • OracleComms_OSM_O2A_COM_CSO_Web_Conferencing_CFS
  • OracleComms_OSM_O2A_COM_FulfillmentPattern
  • OracleComms_OSM_O2A_COM_FulfillmentStateMap_Sample
  • OracleComms_OSM_O2A_COMSOM_CSO_Recognition
    • Revision Number Update for Canceled Orders
  • OracleComms_OSM_O2A_COMSOM_CSO_Solution
• Central Order Management Cartridges for the Solution Option Without Calculate Service Order
  • OracleComms_OSM_O2A_BBVoIP_FP_NP_Danube_Sample
  • OracleComms_OSM_O2A_BBVoIP_FP_NP_Nile_Sample
  • OracleComms_OSM_O2A_COM_NCSO_Base
  • OracleComms_OSM_O2A_COM_NCSO_Provisioning
  • OracleComms_OSM_O2A_COM_Simple_NP_Soln
  • OracleComms_OSM_O2A_COM_Typical_NP_Soln
  • OracleComms_OSM_O2A_COMSOM_Recognition_Sample
    • Revision Number Update for Canceled Orders
  • OracleComms_OSM_O2A_COMSOM_Simple_NP_Soln
  • OracleComms_OSM_O2A_COMSOM_Typical_NP_Soln
  • OracleComms_OSM_O2A_FulfillmentPatternMap_Sample
  • OracleComms_OSM_O2A_SalesOrders_NP_Sample
  • OracleComms_OSM_O2A_SimpleTopology_Sample
  • OracleComms_OSM_O2A_TypicalTopology_Sample
• Service Order Management Cartridges for the Calculate Service Order Solution Option
  • OracleComms_OSM_O2A_SOM_CSO_Base
    • Order Events
    • Order Lifecycle Manager Configuration
    • XQuery Modules in the OracleComms_OSM_O2A_SOM_CSO_Base Cartridge
    • Automation Modules in the OracleComms_OSM_O2A_SOM_CSO_Base Cartridge
  • OracleComms_OSM_O2A_SOM_CSO_Broadband_Internet_Access_CFS
  • OracleComms_OSM_O2A_SOM_CSO_Common
  • OracleComms_OSM_O2A_SOM_CSO_CompleteProvisioning
  • OracleComms_OSM_O2A_SOM_CSO_DeliverOrder
  • OracleComms_OSM_O2A_SOM_CSO_DesignService
  • OracleComms_OSM_O2A_SOM_CSO_Email_CFS
  • OracleComms_OSM_O2A_SOM_CSO_FulfillmentPattern
  • OracleComms_OSM_O2A_SOM_CSO_FulfillmentStateMap
  • OracleComms_OSM_O2A_SOM_CSO_Internet_Media_CFS
  • OracleComms_OSM_O2A_SOM_CSO_IP_Fax_CFS
  • OracleComms_OSM_O2A_SOM_CSO_ModelContainer
  • OracleComms_OSM_O2A_SOM_CSO_PlanDelivery
  • OracleComms_OSM_O2A_SOM_CSO_Recognition
    • Revision Number Update for Canceled Orders
  • OracleComms_OSM_O2A_SOM_CSO_Solution
  • OracleComms_OSM_O2A_SOM_CSO_Topology
  • OracleComms_OSM_O2A_SOM_CSO_VoIP_Access_CFS
  • OracleComms_OSM_O2A_SOM_CSO_Web_Conferencing_CFS
• Service Order Management Cartridges for the Solution Option Without Calculate Service Order
  • OracleComms_OSM_O2A_SOM_Base
    • Order Events
    • Processing Granularity Rules
    • XQuery Modules in the OracleComms_OSM_O2A_SOM_Base Cartridge
    • Automation Modules in the OracleComms_OSM_O2A_SOM_Base Cartridge
  • OracleComms_OSM_O2A_SOM_Provisioning
  • OracleComms_OSM_O2A_SOM_Solution
  • OracleComms_OSM_O2A_SOM_Recognition_Sample
    • Revision Number Update for Canceled Orders
  • OracleComms_OSM_O2A_SomBBVoIP_FP_NP_Sample
  • OracleComms_OSM_O2A_SomProvisionBroadband_Sample
  • OracleComms_OSM_O2A_SomProvisionVoIP_Sample
• Common Conceptual Model Projects
  • OracleComms_Model_Base
  • OracleComms_Model_BaseCatalog
  • OracleComms_Model_Common
  • OracleComms_Model_O2A_Broadband_Internet_Access_CFS
  • OracleComms_Model_O2A_Broadband_Internet_Access_SA
  • OracleComms_Model_O2A_Broadband_Internet_DataModel
  • OracleComms_Model_O2A_Email_CFS
  • OracleComms_Model_O2A_Email_DataModel
  • OracleComms_Model_O2A_Email_SA
  • OracleComms_Model_O2A_Internet_Media_CFS
  • OracleComms_Model_O2A_Internet_Media_DataModel
  • OracleComms_Model_O2A_Internet_Media_SA
  • OracleComms_Model_O2A_VoIP_Access_CFS
  • OracleComms_Model_O2A_VoIP_Access_SA
  • OracleComms_Model_O2A_VoIP_DataModel
• Conceptual Model Projects for Central Order Management
  • OracleComms_Model_O2A_Billing_PS
  • OracleComms_Model_O2A_Broadband_Internet_Access_PS
  • OracleComms_Model_O2A_Email_PS
  • OracleComms_Model_O2A_Install_PS
  • OracleComms_Model_O2A_Internet_Media_PS
  • OracleComms_Model_O2A_VoIP_PS
• Conceptual Model Projects for Service Order Management
  • OracleComms_Model_O2A_SOM_PS
• Oracle AIA Emulators

5 Extending Order-to-Activate Cartridges

• Adding Custom Data Elements
• Adding Custom Order Item Properties
• Changing Durations for Order Components
• Adding a New Fulfillment Function
  • Planning the Addition of a New Fulfillment Function
  • Response Patterns in System Interactions
    • Single Response Pattern
    • Multiple Response Pattern
  • Entities to Create, Modify, or Reuse
    • Data Dictionary and Order Templates
    • About Creation Tasks
    • About Query Tasks
    • About Subprocesses
  • Fulfillment Function Extension Point Interface
    • Fulfillment Function Extension Point Overview
    • COMPONENT-START Extension Point
    • COMPONENT-COMPLETE Extension Point
    • COMPONENT-UPDATE Extension Point
    • CREATE-EBM Extension Point for do Execution Mode
    • CREATE-EBM Extension Point for redo Execution Mode
    • CREATE-EBM Extension Point for undo Execution Mode
    • CREATE-EBM-CUSTOM Extension Point
    • CREATE-EBM-ALL-ORDERITEMS Extension Point
    • CREATE-EBM-ORDERITEM Extension Point for do Execution Mode
    • CREATE-EBM-ORDERITEM Extension Point for redo Execution Mode
    • CREATE-EBM-ORDERITEM Extension Point for undo Execution Mode
    • CREATE-EBM-ORDERITEM-CUSTOM Extension Point
    • CREATE-EBM-PRIORORDERITEM Extension Point
    • CREATE-EBM-PRIORORDERITEM-CUSTOM Extension Point
    • VALIDATE-RESPONSE-EBM Extension Point
    • COMPONENT-RESPONSE-UPDATE Extension Point
    • ORDER-EXTENSION-UPDATE-STATUS-EBM Extension Point
  • About Fallout
    • Fallout Customization
    • Failure During Revision
  • Adding a New Fulfillment Function for a New Service Offering
• Adding a New Fulfillment Provider
• Adding a New Fulfillment Mode
• Adding a New Product Specification
  • Mapping Product Specifications to Order-to-Activate Sample Fulfillment Patterns
  • Creating a New Product
  • Creating a New Fulfillment Pattern
    • Customizing Mapping Rules
  • Importing the New Product Specification
• Changing Processing Granularity
  • Configuring a New Processing Granularity Rule
• Changing Fulfillment Function Dependencies
• Setting a Point of No Return
  • Modeling a PoNR
• Configuring Fulfillment States
  • External Fulfillment States
  • Fulfillment State Extension Point Interface
    • Fulfillment State Extension Point Overview
    • ORDERITEM_FULFILLMENT_STATE_UPDATED Extension Point
    • ORDER_FULFILLMENT_STATE_UPDATED Extension Point
    • ORDER_STATUS Extension Point
    • ORDER_STATUSCONTEXT Extension Point
    • ORDERITEM_MILESTONE Extension Point
    • ORDERITEM_STATUSCONTEXT Extension Point
    • REPORT_ORDERITEM_STATUS Extension Point
    • REPORT_ORDERITEM_MILESTONE Extension Point
    • REPORT_ORDERITEM_STATUSCONTEXT Extension Point
• Adding a New Service for the Calculate Service Order Solution Option
• Adding a New Service for the Service Option Without Calculate Service Order
• Customizing Service Order Management
  • Service Order Management Extension Point Overview
  • SOM-CREATE-SOAP-REQUEST Extension Point
  • SOM-DETECT-FAULT Extension Point
  • SOM-GET-FAULT-DATA Extension Point
  • SOM-CHECK-IS-LAST-RESPONSE Extension Point
  • SOM-GET-UPDATE-DATA Extension Point
  • SOM-GET-EXTERNAL-FULFILLMENT-STATE Extension Point
  • SOM-GET-EXTERNAL-FULFILLMENT-STATE-AT-FALLOUT Extension Point
  • SOM-GET-NEW-CORRELATION-ID Extension Point
• Extending XQuery Modules
• Sending Enriched Data to the CRM System
• Considerations When Integrating with Oracle AIA

6 Performing Order-to-Activate Cartridge Operations

• XQuery Transformation Logging
• Enabling or Disabling Product Attribute Validation
• Troubleshooting Order-to-Activate Cartridges
  • Updating the JMS Redelivery Configuration Settings
  • Setting Cartridge Breakpoints

7 Prior Versions of Order-to-Activate Cartridges

• Updating Prior Versions of the Cartridges to Work with Newer Versions of OSM
• Changes from Order-to-Activate 2.1.0.2 to Version 2.1.1
  • Support for Asset Processing
  • Support for Order Lifecycle Management User Interface
  • Support for Processing States
• Changes from Order-to-Activate 2.1.0.1 Cartridges to Version 2.1.0.2
  • Changes to Fulfillment Function Extension Points
    • New Extension Points
    • Extension Points Added to the Billing Components
  • Changes to Action Code Mappings
  • New XML-type Parameter Added to Contain Custom Order Item Properties
• Changes from Order-to-Activate 2.1.0 Cartridges to Version 2.1.0.1
  • New Silent Installation Option
• Changes from Order-to-Activate 2.0.1 Cartridges to Version 2.1.0
  • Support for Calculate Service Order
    • Two Solution Options: With and Without Calculate Service Order
    • The Calculate Service Order Solution Option
    • New Service Order Management Cartridges for the Calculate Service Order Solution Option
    • Inclusion of Conceptual Model Projects
  • Large Order Support
  • Support for Sharing Groups
• Changes from Order-to-Activate 7.2 Cartridges to Version 2.0.1
  • Release Number Changes and Packaging Changes
  • Support for Multiple Price Lists
  • Support for Importing Product Classes Directly from Oracle Product Hub
• Changes from Order-to-Activate 7.0.3 Cartridges to Version 7.2
  • Cartridge Re-Factoring Overview
  • Cartridge Mapping Between Order-to-Activate 7.0.3 and Order-to-Activate 7.2