Additional Information Related to Activities

Follow this procedure to extend the information provided from Oracle Utilities Customer Care and Billing to Oracle Utilities Mobile Workforce Management for an activity.

The process describes how to extend Oracle Utilities Mobile Workforce Management business objects and their user interface as well as the integration XAI Inbound Service with your custom elements.

If elements already exist in the FA Extract then follow the steps to extend Oracle Utilities Customer Care and Billing to forward them to Oracle Utilities Mobile Workforce Management.

If they are not part of the extract then follow the steps on how to request them using a callback from Oracle Utilities Mobile Workforce Management to Oracle Utilities Customer Care and Billing.

Extending Oracle Utilities Mobile Workforce Management Business Objects

Extending the Oracle Utilities Mobile Workforce Management business objects involves extending the data structures and extending the user interface to receive the additional elements passed from Oracle Utilities Customer Care and Billing.

Extending the Data Structures

Create customer modification (CM) data areas and use them to extend the corresponding Oracle Utilities Mobile Workforce Management data areas. After this is done, implement the relevant CM UI Map Fragments.

Refer to the List of Available CM Extended UI Map Fragments in Oracle Utilities Mobile Workforce Management for the exact fragment names.

Type of Information	How to Extend
Common Activity Details	For read only details common to any type of activity, extend the base M2-CommonActivityDetails data area. The base data area is already included in all base activity and assignment business objects so extending it automatically extends all these business objects. It is also included in the XAI Inbound Service maintaining an activity so the service is automatically extended as well. Notice that this information is not sent back as completion details.
Service Point, Meter or Item Details	For service points, meter or item information extend the respective corresponding data area: • Service Point Details (M2-SPDataDetails) • Meter Details (M2-MeterDataDetails) • Item Details (M2-ItemDataDetails) These data areas are already included in relevant base activity and assignment business objects so extending them automatically extends all these business objects. It is also included in the XAI Inbound Service maintaining an activity so the service is automatically extended as well. The data areas are also included in the completion part of the assignments and outbound messages so extending them also allows these details to be sent back as part of completion. When designing your custom UI map fragments choose which details to display and what to allow the crew to update.
Custom Activity Business Object Details	If the details are relevant to a specific type of activity that is not provided with the base product you need to design and configure custom activity and assignment business objects to handle such an activity. Use custom data areas to describe the details sent from the host for this type of activity and include them in your business objects. Refer to the Oracle Utilities Mobile Workforce Management Configuration Guide for more information on how to design new custom activity business objects. Once custom business objects are configured, you need to extend the XAI Inbound Service to accommodate your custom details. To do that you need to extend the M2-DataDetails data area with your custom data area. Notice that this information is not sent back as completion details.

Extending the User Interface

To extend the Implement activity and assignment CM UI Map Fragments to display your custom details as needed. Refer to the List of Available CM Extended UI Map Fragments in Oracle Utilities Mobile Workforce Management for the exact fragment names.

Obtaining the Data from Oracle Utilities Customer Care and Billing

To obtain data from Oracle Utilities Customer Care and Billing you must first send field activity extract details to Oracle Utilities Mobile Workforce Management then pull the data from Oracle Utilities Customer Care and Billing.

Sending Field Activity Extract Details to Oracle Utilities Mobile Workforce Management

Follow this procedure to send additional details that already exist on the field activity extract service schema to Oracle Utilities Mobile Workforce Management.

Note. This procedure assumes that all details which will be forwarded to Oracle Utilities Mobile Workforce Management are already extracted by the base field activity extract service.

Use an XSL on the field activity extract message Route Type to transform these details to corresponding Oracle Utilities Mobile Workforce Management element names under a Custom Schema Data group node:

• FA Type Characteristics

• FA Characteristics

• SP Type Characteristics

• SP Characteristics

• Premise Characteristics

• Meter Characteristics

• Item Characteristics

• Service Point Geographic Value

• Premise Geographic Value

Refer to XSL Template in Oracle Utilities Customer Care and Billing for information on how to configure custom elements of these types.

For other types of elements, use a custom XSL to transform the elements from their source location to the corresponding XPath below the Custom Schema Data node in the target Oracle Utilities Mobile Workforce Management message of the element. This should include the element name.

Obtain Additional Information from Oracle Utilities Customer Care and Billing

There are several options available for your implementation to obtain additional information from Oracle Utilities Customer Care and Billing to send to Oracle Utilities Mobile Workforce Management:

Create a callback from Oracle Utilities Customer Care and Billing Work Order Requestor or Oracle Utilities Mobile Workforce Management Work Order Provider process using extension points to invoke a new implementation created XAI Inbound Service in Oracle Utilities Customer Care and Billing and pass the additional information over to Oracle Utilities Mobile Workforce Management.

Directly obtain the additional information from Oracle Utilities Customer Care and Billing in Oracle Utilities Mobile Workforce Management.

Below is the procedure to directly obtain additional details from Oracle Utilities Customer Care and Billing that do not exist on the field activity extract service schema using a callback from Oracle Utilities Mobile Workforce Management.

Note: This process of obtaining Additional Information does not invoke the process integration pack. It is the responsibility of the implementation team to configure and test the edge applications to communicate with each other.

Configuration in Oracle Utilities Customer Care and Billing

• Create a service script that extracts the additional information.

• Expose the service script as an XAI Inbound Service.

Configuration in Oracle Utilities Mobile Workforce Management

• Set up an outbound message:

• Define an outbound message business object to match the XAI Inbound Service created in Oracle Utilities Customer Care and Billing.

• Define an outbound message type which references the outbound message business object.

• Set up a real time Message Sender to communicate with the external system, if one does not already exist.

• Invocation Type = Real Time

• XAI Class = Sender routes messages via HTTP real-time (RTHTTPSNDR)

• Context = set up the link to the external system

• Set up an External System record for the external system, if one does not already exist.

• Add the outbound message type to the External System list of messages.

• Reference the Message Sender

• Use Real Time Processing Method

• Add xsl to add the SOAP envelope to the message being sent out

• Create an Activity business object Pre-Processing plug-in as follows:

• Populate the outbound message business object and call the outbound message dispatcher service to send it to the external system

• Populate the activity business object with the information returned

Use the steps mentioned in option 2 to configure Oracle Utilities Customer Care and Billing and Oracle Utilities Mobile Workforce Management and create a new Integration process (using BPEL/ mediator) to pass the additional information between Oracle Utilities Customer Care and Billing and Oracle Utilities Mobile Workforce Management.