Business Flows
The integration scope supports the following business processes:
Process Activity (Oracle Utilities Customer Cloud Service Initiated)
This integration process is used to accept request from Oracle Utilities Customer Cloud Service to create, update, or cancel activities in Oracle Field Service. The information is sent synchronously from Oracle Utilities Customer Cloud Service, regardless of the activity type, and Oracle Field Service sends back a response.
The following diagram shows a graphical representation of the Process Activity integration process.
![](../CCS-OFS_CONFIGURATION_GUIDE_22B/images/C2M-OFSC_Solution_Architecture.03.3.1.jpg)
Business Processing
The integration process includes the following activities:
1. Oracle Utilities Customer Cloud Service sends the create/update/cancel activity request to the Oracle Utilities CCS OFSC Activity Process integration process deployed on Oracle Integration Cloud.
2. The Oracle Utilities CCS OFSC Activity Process transforms the create/update/cancel activity request message from Oracle Utilities Customer Cloud Service to the request message format in Oracle Field Service and invokes bulkUpdate API.
3. Oracle Field Service sends the success or failure response to the integration transformed and sent to Oracle Utilities Customer Cloud Service.
4. Any errors are reported back to Oracle Utilities Customer Cloud Service through the global fault handler.
5. An optional email notification with error details is sent to the users configured in the SOMOFSC_Email_ID lookup.
Technical Details
The following table describes the integration processes and the respective Oracle Utilities Customer Cloud Service and Oracle Field Service artifacts used in this integration process.
Appointment Window Request (Oracle Utilities Customer Cloud Service Initiated)
This integration process provides a list of available appointments.
Oracle Utilities Customer Cloud Service sends the activity start and end date times from the Appointment portal and Oracle Field Service sends back the list of appointments available during that time window.
The following diagram shows a graphical representation of the Appointment Window Request integration process.
![](../CCS-OFS_CONFIGURATION_GUIDE_22B/images/C2M-OFSC_Solution_Architecture.03.3.2.jpg)
Business Processing
The integration process includes the following activities:
1. Oracle Utilities Customer Cloud Service sends the get available appointment request to Oracle Utilities CCS OFSC Appointment Get integration process deployed on Oracle Integration Cloud.
2. The Oracle Utilities CCS OFSC Appointment Get process transforms the request message from Oracle Utilities Customer Cloud Service to the request message format in Oracle Field Service and invokes the activityBookingOptions REST API.
3. Oracle Field Service sends the success or failure response to the integration transformed and sent to Oracle Utilities Customer Cloud Service.
4. Any errors are reported back to Oracle Utilities Customer Cloud Service through the global fault handler.
5. An optional email notification with error details is sent to the users configured in the SOMOFSC_Email_ID lookup.
Note: Make sure the fix for Bug 28474403 is applied on to the Oracle Utilities Customer Cloud Service environment. Also, in Oracle Field Service make sure the employee-based activities have 'Break' in the time slot label.
For example: Lunch Break, Second Lunch Break, and more
Technical Details
The following table describes the integration processes and the respective Oracle Utilities Customer Cloud Service and Oracle Field Service artifacts used in this integration process.
Interim Activity Status (Oracle Utilities Customer Cloud Service Initiated)
Oracle Utilities Customer Cloud Service synchronously sends the requests for the interim activity status of the field activities and Oracle Field Service sends back the status.
The following diagram shows a graphical representation of the Interim Activity Status integration process.
![](../CCS-OFS_CONFIGURATION_GUIDE_22B/images/C2M-OFSC_Solution_Architecture.03.3.3.jpg)
Business Processing
The integration process includes the following activities:
1. Oracle Utilities Customer Cloud Service sends the interim activity status request to the Oracle Utilities CCS OFSC Activity Get Status integration process deployed on Oracle Integration Cloud.
2. Oracle Field Service sends the success or failure response to the integration that is transformed and sent to Oracle Utilities Customer Cloud Service.
3. Any errors are reported back to Oracle Utilities Customer Cloud Service through the global fault handler.
4. An optional email notification with error details are sent to the users configured in the SOMOFSC_Email_ID lookup.
Technical Details
The following table describes the integration processes and the respective Oracle Utilities Customer Cloud Service and Oracle Field Service artifacts used in this integration process.
Device Verification (Oracle Field Service Initiated)
This integration process is used to verify if the item/device/equipment is present in Oracle Utilities Customer Cloud Service. Oracle Field Service synchronously sends the requests for device verification with the device’s badge number and Oracle Utilities Customer Cloud Service sends back the details, such as device configuration type and verification status.
The following diagram shows a graphical representation of the Device Verification integration process.
![](../CCS-OFS_CONFIGURATION_GUIDE_22B/images/C2M-OFSC_Solution_Architecture.03.3.4.jpg)
Business Processing
The integration process includes the following activities:
1. Oracle Field Service sends the device verification request to the Oracle Utilities OFSC CCS Device Verification integration process deployed on Oracle Integration Cloud.
2. The Oracle Field Service mobile worker has the option to request for device information using the badge number and serial Number. The serial number is optional.
3. The Oracle Utilities OFSC CCS Device Verification process transforms the request message from Oracle Field Service to the request message format in Oracle Utilities Customer Cloud Service and invokes either D1-DeviceVerificationService or D1-ItemVerificationService inbound web service if the device type is Meter/Equipment or Item respectively.
4. Oracle Utilities Customer Cloud Service sends the success or failure response to the integration transformed and sent to Oracle Field Service.
5. Any errors are handled by the custom plug-in hosted on Oracle Field Service. A pop-up blocker appears in Oracle Field Service with the respective error details.
Technical Details
The following table describes the integration processes and the respective Oracle Utilities Customer Cloud Service and Oracle Field Service artifacts used in this integration process.
Create Activity (Oracle Field Service Initiated)
This integration process is used to create an activity in an external system. Oracle Field Service sends a request to create activity in Oracle Utilities Customer Cloud Service.
The same flow is used to create both related and unrelated pickup activities from Oracle Field Service.
The following diagram shows a graphical representation of the Create Activity integration process.
Business Processing
The integration process includes the following activities:
1. Oracle Field Service sends the create activity request to the Oracle Utilities OFSC CCS Activity Create integration process deployed on Oracle Integration Cloud.
2. The Oracle Utilities OFSC CCS Activity Create process transforms the request message from Oracle Field Service to the request message format in Oracle Utilities Customer Cloud Service and invokes the D1-FARequestSynchronous inbound web service.
3. The integration process sends the Oracle Utilities Customer Cloud Service Activity ID from Oracle Utilities Customer Cloud Service response to Oracle Field Service work order using Update_Patch.
4. Any errors are captured through the global fault handler.
5. An optional email notification with error details are sent to the users configured in the SOMOFSC_Email_ID lookup.
Technical Details
The following table describes the integration processes and the respective Oracle Utilities Customer Cloud Service and Oracle Field Service artifacts used in this integration process.
Activity Completion/Cancellation (Oracle Field Service Initiated)
This integration process is used to send the field activity completion/cancellation details from Oracle Field Service to Oracle Utilities Customer Cloud Service. Oracle Field Service sends the activity completion/cancellation details, along with the completion/cancellation status, to complete/cancel the activity in Oracle Utilities Customer Cloud Service.
The following diagram shows a graphical representation of the Activity Completion integration process:
![](../CCS-OFS_CONFIGURATION_GUIDE_22B/images/C2M-OFSC_Solution_Architecture.03.3.6.jpg)
Business Processing
The integration process includes the following activities:
1. Oracle Field Service sends the activity completion details to the Oracle Utilities OFSC CCS Activity Complete integration process deployed on Oracle Integration Cloud.
2. The Oracle Utilities OFSC CCS Activity Complete process transforms the message from Oracle Field Service to the message format in Oracle Utilities Customer Cloud Service and invokes the D1-FieldActivityIBComm inbound web service.
4. Any errors are captured through the global fault handler.
5. An optional email notification with error details are sent to the users configured in the SOMOFSC_Email_ID lookup.
Technical Details
The following table describes the integration processes and the respective Oracle Utilities Customer Cloud Service and Oracle Field Service artifacts used in this integration process.
Query Service Point (Oracle Field Service Initiated)
The Query Service Point integration process is used to query the service point information.
The integration process sends request from Oracle Field Service to Oracle Utilities Customer Cloud Service to identify a service point. Oracle Field Service crew sends either the address and city, or latitude and longitude, or postal code, or all of them to Oracle Utilities Customer Cloud Service. Oracle Utilities Customer Cloud Service performs the service point search based on the above criteria and sends back the list of service points and other details, such as service point type and service point source status.
The following diagram shows a graphical representation of the Query Service Point integration process.
![](../CCS-OFS_CONFIGURATION_GUIDE_22B/images/C2M-OFSC_Solution_Architecture.03.3.7.jpg)
Business Processing
The integration process includes the following activities:
1. Oracle Field Service mobile worker requests for service point information to create an unrelated pickup activity.
2. Oracle Field Service sends the query service point request to the Oracle Utilities OFSC CCS ServicePoint Query integration process deployed on Oracle Integration Cloud.
3. The Oracle Utilities OFSC CCS ServicePoint Query process transforms the request message from Oracle Field Service to the request message format in Oracle Utilities Customer Cloud Service and invokes the D1-FieldWorkSPQuery inbound web service.
4. Oracle Utilities Customer Cloud Service sends the success or failure response to the integration transformed and sent to Oracle Field Service.
5. In case of success response, a list of service points is returned to Oracle Field Service.
6. Oracle Field Service mobile worker selects the relevant service point from the list, selects the activity type, and adds activity notes to create an activity.
7. This creates an unrelated pickup activity in Oracle Field Service and a text message with the Oracle Field Service activity ID is displayed on mobile screen.
8. If Oracle Utilities Customer Cloud Service invocation fails due to invalid input data, the global fault handler captures the invocation error and the error details are returned to Oracle Field Service using Unrelated Pickup custom plugin.
9. Other errors are handled by the Unrelated Pickup custom plug-in hosted on Oracle Field Service. A text message appears on Oracle Field Service mobile screen with the respective error details.
Technical Details
The following table describes the integration processes and the respective Oracle Utilities Customer Cloud Service and Oracle Field Service artifacts used in this integration process.
Admin Sync (Oracle Integration Cloud Initiated)
The Admin Sync integration process is used to get the admin data from Oracle Utilities Customer Cloud Service and send it to Oracle Field Service.
The integration process sends request from Oracle Integration Cloud to Oracle Utilities Customer Cloud Service to get the admin data which includes service point data, activity data, activity types, device data and register data and sends these data to Oracle Field Service.
The following diagram shows a graphical representation of the Admin Sync integration process.
![](../CCS-OFS_CONFIGURATION_GUIDE_22B/images/Admin_Sync_Flow.jpg)
Business Processing
The integration process includes the following activities:
1. Oracle Integration Cloud sends request to Oracle Utilities Customer Cloud Service. This includes codes and descriptions of selected admin entities, characteristic type valid values and extendable lookup values. It also includes the activity types.
2. Run this integration sync process manually from Oracle Integration Cloud by scheduling the integration process to run on a scheduled date or selecting Submit Now from the menu of the activated sync integration process to initiate an instance of the integration.
3. It populates the enumeration values for the following Oracle Field Service properties.
• Service Point Details
• Service Instructions
• Disconnect Location
• Service Point Warnings
• Service Type
• Premise Type
• Activity Types
• Activity Data
• Customer Contact Type
• Remarks Type
• FA Cancel Reason
• Meter Details
• Manufacturer
• Model
• Device Type
• Device Configuration Type
• Headend System
• Register Details
• Unit Of Measure
• Time Of Use
• Service Quantity Identifier
4. Oracle Utilities Customer Cloud Service sends the success or failure response to the integration transformed and sent to Oracle Field Service.
5. In case of success response, the admin sync data is sent to Oracle Field Service.
6. If Oracle Utilities Customer Cloud Service invocation fails due to invalid input data, the global fault handler captures the invocation error and the error details are sent to configured email in the SOMOFSC_Email_ID lookup.
7. Other errors are handled by the respective scope fault handlers and the error details will be sent to email ID configured in SOMOFSC_Email_ID lookup.
Technical Details
The following table describes the integration processes and the respective Oracle Utilities Customer Cloud Service and Oracle Field Service artifacts used in this integration process.
Note: It is recommended to take a backup of the Activity types data. As part of Admin Sync, the activity types will be overridden or created in your environment.
By default, the Activity types sync will not happen as part of Admin Sync. To sync Activity types, update the “som.adminsync.activitytypes.sync” config property to ‘true’ available in the SOMOFSC_ConfigProps lookup.