Skip Headers
Oracle® Application Integration Architecture Oracle Communications Order to Cash Integration Pack Implementation Guide for Siebel CRM, Oracle Order and Service Management, and Oracle Billing and Revenue Management
Release 11.1
Part Number E22651-03
Go to Documentation Home
Home		 Go to Book List
Book List		 Go to Table of Contents
Contents		 Go to Index
Index		 Go to Feedback page
Contact Us
Go to previous page
Previous		 Go to next page
Next
PDF · Mobi · ePub

23 OFM - Create and Manage Trouble Ticket by Oracle OSM Business Flow: Implementation

This chapter provides an overview of the Create and Manage Trouble Ticket by Oracle OSM business flow and discusses Siebel Customer Relationship Management (Siebel CRM) interfaces, industry Oracle Application Integration Architecture (Oracle AIA) components, integration services, and fallout-enabled services for this business flow.

This chapter includes the following sections:

23.1 Creating Trouble Tickets in Siebel CRM by Oracle OSM Overview

The Create and Manage Trouble Ticket by Oracle OSM business flow enables the following integration flows:

23.2 Order Failure Notification to Oracle OSM Integration Flow

The Oracle AIA order fallout listener (AIAOrderFalloutJMSBridgeService), listens to all messages published to the Oracle AIA Error JMS Topic (AIA_ERROR_TOPIC) for errors or faults specific to order fallout by looking at the correlation ID. These fault messages are enriched and published to the central OFM in Oracle OSM.

This integration flow uses the following interfaces:

Figure 23-1 illustrates how Oracle OSM initiates the request to create a trouble after receiving an order failure notification.

Figure 23-1 Order Failure Notification to Oracle OSM

This image is described in surrounding text.

When this process initiates, the following events occur:

  1. The Enriched Fault Message containing the details pertaining to orders are pushed to the AIA_ERROR_TOPIC using the Oracle AIA Error Handling Framework. These messages are stamped with a JMS Correlation ID, for example, AIA_ORDERFALLOUT.

  2. AIAOrderFalloutJMSBridgeService picks up the messages with JMSCorrelationID, for example, AIA_ORDERFALLOUT and publishes them to the AIA_ORDERFALLOUT_JMSQ queue.

  3. AIACOMOrderFalloutNotificationJMSConsumer picks up the messages stamped with the JMS Correlation ID AIACOM_ORDERFALLOUT_CFS from the AIA_ORDERFALLOUT_JMSQ and invokes CreateOrderFalloutNotificationOSMCFSCommsProvImpl.

  4. CreateOrderFalloutNotificationOSMCFSCommsProvImpl parses the fault message, transforms it to OrderFalloutNotification message, and invokes the CreateOrderFalloutNotificationOSMCFSCommsJMSProducer service.

  5. CreateOrderFalloutNotificationOSMCFSCommsJMSProducer pushes the message to the AIA_FALLOUT_JMSQ store and forward (SAF) queue. Oracle OSM CFS picks up this message, marks the order as failed, and initiates the request to create a trouble ticket.

23.3 Creating a Trouble Ticket in Siebel CRM by Oracle OSM Integration Flow

This integration flow uses these interfaces:

Figure 23-2 describes the creation of trouble tickets in Siebel CRM by Oracle OSM.

Figure 23-2 Creating a Trouble Ticket in Siebel CRM by Oracle OSM

This image is described in surrounding text.

When this process initiates, the following events occur:

  1. The OSM Fulfillment system produces the CreateTroubleTicketEBM in the AIA_CRTTTREQ_JMSQ SAF queue.

  2. CreateTroubleTicketOSMCFSCommsJMSConsumer picks up the message from the queue and passes it to the CommunicationsTroubleTicketEBSV1 service using the CreateTroubleTicket operation.

  3. The CommunicationsTroubleTicketEBSV1 routes the message to the CreateTroubleTicketSiebelCommsProvABCSImpl service.

  4. The CreateTroubleTicketSiebelCommsProvABCSImpl service invokes the Siebel web service (SWITroubleTicketIO.wsdl: SWITroubleTicketInsert) synchronously, and the response trouble ticket ID is received in the form of a SWITroubleTicketInsert_Output message.

  5. CommsTroubleTicketEBS invokes the CreateTroubleTicketSiebelCommsProvABCSImpl with the CreateTroubleTicketEBM. This process transforms the CreateTroubleTicketEBM to TroubleTicketInsert_Input ABM.

  6. The CreateTroubleTicketSiebelCommsProvABCSImpl service invokes the Siebel web service (ServiceRequest.wsdl) synchronously, and the response trouble ticket ID is received in the form of a TroubleTicketInsert_Output message. This ABM is transformed to CreateTroubleTicketResponseEBM, and the CommunicationsTroubleTicketResponseEBSV1 is invoked with the CreateTroubleTicketResponse operation.

  7. The CommunicationsTroubleTicketResponseEBSV1 routes the message to the CreateTroubleTicketRespOSMCFSCommsJMSProducer service, which pushes the message to the AIA_CRTTTRESP_JMSQ SAF queue.

  8. Oracle OSM CFS picks up the message and stores the TroubleTicketID for reference.

23.4 Updating a Trouble Ticket in Siebel CRM by Oracle OSM Integration Flow

This integration flow uses the following interfaces:

Figure 23-3 describes the Trouble Ticket Update flow from Oracle OSM to Siebel CRM.

Figure 23-3 Updating a Trouble Ticket in Siebel CRM by Oracle OSM

This image is described in surrounding text.

When this process initiates, the following events occur:

  1. The Oracle OSM fulfillment system produces the UpdateTroubleTicketEBM in the AIA_UPDTTREQ_JMSQ SAF queue.

  2. UpdateTroubleTicketOSMCFSCommsJMSConsumer picks up the message from the queue and invokes CommunicationsTroubleTicketEBSV1 using the UpdateTroubleTicket operation.

  3. The CommunicationsTroubleTicketEBSV1 invokes the UpdateTroubleTicketSiebelCommsProvABCSImpl service. In this provider process, the EBM is transformed to TroubleTicketInsertorUpdate_Input ABM, and the Siebel web service is invoked to update the trouble ticket.

23.5 Siebel CRM Interfaces

The Create and Manage Trouble Ticket by Oracle OSM business flow uses this Siebel CRM interface:

This inbound web service is invoked by the Siebel ABCS to create or update a trouble ticket in Siebel CRM. If the request is for creating a new trouble ticket, then a new trouble ticket is created and the trouble ticket number is returned. If the request is to update a specific trouble ticket, typically to close the trouble ticket, then the trouble ticket is updated.

For more information about web services, see the Siebel Order Management Guide Addendum for Communications, "Web Services Reference."

23.6 Industry Oracle AIA Components

The Create and Manage Trouble Ticket by Oracle OSM business flow uses these industry components:

The industry enterprise business object (EBO) and EBM XSD files are located here: $AIA_HOME/apps/AIAMetaData/AIAComponents/EnterpriseObjectLibrary/Industry/Communications/EBO/TroubleTicket/V1/

The industry EBS WSDL files are located here: $AIA_HOME/apps/AIAMetaData/AIAComponents/EnterpriseBusinessServiceLibrary/Industry/Communications/EBO//TroubleTicket/V1/

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

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

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

For more information, see Oracle Application Integration Architecture - Foundation Pack: Integration Developer's Guide, "Extensibility for Oracle AIA Artifacts," Extending EBOs.

23.7 Integration Services

These services are delivered with this integration:

Some of these services have been enabled to use Session Pool Manager.

For more information about Session Pool Manager, see Oracle Application Integration Architecture Pre-Built Integrations Utilities Guide, "Session Pool Manager."

For more information, see Chapter 27, "Configuring the Process Integration for Order Fallout Management."

23.7.1 UpdateTroubleTicketSiebelCommsProvABCSImpl

The UpdateTroubleTicketSiebelCommsProvABCSImpl is a service that acts as the provider for the UpdateTroubleTicket operation of the CommunicationsTroubleTicketEBSV1. This service does not return any response.

This BPEL process takes the UpdateTroubleTicketEBM as input and invokes the Siebel web service SWITroubleTicket to update the trouble ticket.

Updating open trouble tickets to Closed or adding additional failed order lines to an existing open trouble ticket are the scenarios in which an update to trouble ticket request originates from Oracle OSM CFS.

23.7.2 CreateOrderFalloutNotificationOSMCFSCommsProvImpl

The CreateOrderFalloutNotificationOSMCFSCommsProvImpl service is a BPEL process that picks up the Fault message from CreateOrderFalloutNotificationOSMCFSCommsJMSConsumer. It parses the Fault message and then constructs the OrderFalloutNotification message.

Next, the CreateOrderFalloutNotificationOSMCFSCommsJMSProducer service is invoked to enqueue the order fallout notification message in the AIA_FALLOUT_JMSQ SAF queue for Oracle OSM CFS. This action consumes and triggers a fallout event for the particular order.

23.7.3 CreateOrderFalloutNotificationOSMCFSCommsJMSConsumer

The CreateOrderFalloutNotificationOSMCFSCommsJMSConsumer service is a Mediator service that picks up the Fault message from the AIA_ORDERFALLOUT_JMSQ. It passes the Fault message to the CreateOrderFalloutNotificationOSMCFSCommsProvImpl process based on the JMS Correlation ID.

This service acts as a consumer, listening to the messages produced in AIA_ORDERFALLOUT_JMSQ.

23.7.4 CreateOrderFalloutNotificationOSMCFSCommsJMSProducer

The CreateOrderFalloutNotificationOSMCFSCommsJMSProducer is a BPEL process that enqueues the OrderFalloutNotification message to the AIA_FALLOUT_JMSQ SAF queue. Oracle OSM then picks the message from this queue and triggers a fallout event in Oracle OSM. The CreateOrderFalloutNotificationOSMCFSCommsProvImpl service invokes this service.

23.7.5 CreateTroubleTicketOSMCFSCommsJMSConsumer

The CreateTroubleTicketOSMCFSCommsJMSConsumer is a Mediator service that picks up the CreateTroubleTicketEBM message from the AIA_CRTTTREQ_JMSQ SAF queue. It routes the message to the Create Trouble Ticket operation of the CommunicationsTroubleTicketEBSV1. This service acts as a consumer, listening to the messages produced in the AIA_CRTTTREQ_JMSQ SAF queue.

23.7.6 CreateTroubleTicketRespOSMCFSCommsJMSProducer

The CreateTroubleTicketRespOSMCFSCommsJMSProducer is a BPEL process that enqueues the CreateTroubleTicketResponseEBM message to the AIA_CRTTTRESP_JMSQ SAF queue. Oracle OSM then picks up the message from this queue and then updates the order task with the created trouble ticket ID. The CommunicationsTroubleTicketResponseEBSV1 service invokes this service.

23.7.7 UpdateTroubleTicketOSMCFSCommsJMSConsumer

The UpdateTroubleTicketOSMCFSCommsJMSConsumer is a Mediator service that picks up the UpdateTroubleTicketEBM message from the AIA_UPDTTREQ_JMSQ SAF queue. It routes the message to the Update Trouble Ticket operation of the CommunicationsTroubleTicketEBSV1. This service acts as a consumer, listening to the messages produced in the AIA_UPDTTREQ_JMSQ SAF queue.

23.7.8 CreateFaultNotificationLFCommsJMSConsumer

The CreateFaultNotificationLFCommsJMSConsumer is a Mediator service that picks up the Fault message from the AIA_LFERROR_JMSQ queue. It routes this message to the BPEL service AIAAsyncErrorHandlingBPELProcess, which queues the message in the AIA_ERROR_TOPIC.

Line Fulfillment (provisioning) systems that want to notify the central fulfillment system about an error in processing the order creates an enriched fault message (fault message with order details). This enriched fault message is queued to the AIA_LFERROR_JMSQ to get the fault processed by the order fallout framework. This fault message is processed by the Order Fallout Management framework, and Oracle OSM CFS is notified about the errors in the Line Fulfillment system for a particular order.

This service acts as a consumer, listening to the messages produced in the AIA_LFERROR_JMSQ.

23.8 Business Flow Fallout-Enabled Services

The following Create and Manage Trouble Ticket by Oracle OSM business flow services are fallout-enabled:

Go to previous page
Previous		 Go to next page
Next
Go to Documentation Home
Home		 Go to Book List
Book List		 Go to Table of Contents
Contents		 Go to Index
Index		 Go to Feedback page
Contact Us