1. Oracle Fusion Field Service Questions and Answers
  2. How do I create a plugin that work on Follow Up Work Order in Oracle Maintenance Cloud?

How do I create a plugin that work on Follow Up Work Order in Oracle Maintenance Cloud?

When a mobile worker receives an assignment for an activity, they can start working on the activity according to the schedule. Here are the actions that mobile workers or other users can perform on the activity once it is processed and the corresponding changes they can make to the work order:

  • Activity Started: When the activity starts, the activity status changes from 'pending' to 'started'. The accelerator option allows configuring the work order status to display corresponding to Oracle Fusion Field Service status changes. You can change the work order status to an appropriate value based on the status configuration mapping table defined on the OIC accelerator. See the Work Order Status section for more details.
  • Item/Material Installation: When a mobile worker or any other user installs an item or specific quantity of items, the accelerator reserves the corresponding quantity of items in the maintenance inventory management until the activity is complete. These items move to the 'installed' pool in Oracle Fusion Field Service. These items are not available qualities for Oracle Fusion Field Service. When the inventory items are synchronized, items in the reserved state don't sync to Oracle Fusion Field Service.
  • Activity Completed:
    • The work order operation item updates with actual items installed, and the work order labor resource is updates with the labor usage (activity duration).
    • The accelerator updates the item master with actual quantities installed. Reserved item quantities are deducted from the actual quantities, and the item master is updated.
    • The accelerator performs the material transaction in Oracle Maintenance based on the total quantities of items installed for the final calculations.
    • The accelerator performs the actual labor transaction in Oracle Maintenance for the final calculations.
    • For a multi-segment activity, when individual segments are completed, the accelerator updates the labor resource usage and item consumption associated with that segment. When the segments are completed, the total labor usage is the sum of labor usage from individual segments. Similarly, the total item consumption is the sum of the items consumed by individual segments. For more information on multi-segment activity, refer to Multi-Segment Activity Creation in.

  • Activity Canceled: If the work order contains a single operation resource and the corresponding activity is canceled, the work order is canceled with a cancellation reason, and the operation status remains as ready.

  • Activity Deleted: When an activity is deleted in Oracle Fusion Field Service, the corresponding resource is deleted from Oracle Maintenance.
    Note: Only Optional Operations (Count Point and Automatically Transact are false) can be deleted from a work order in Oracle Maintenance. The best practice is that all Standard Operations restrict the visibility of the delete/cancel button in Oracle Fusion Field Service based on the value of Count Point and Automatically Transact Flag. Deleting an activity from Oracle Fusion Field Service results in an error in the integration flow, and the corresponding operations aren't deleted from Oracle Maintenance.
  • Activity Suspended: The 'suspend' action in Oracle Fusion Field Service creates a clone of the activity in the same queue as a not-ordered activity in 'pending status'. When the activity becomes a not-ordered activity, the start date/time of the maintenance operation resource/operation is updated with the SLA start and end dates of the not-ordered activity.
  • Activity Not Done: The 'not done' action in Oracle Fusion Field Service indicates that the activity couldn't be completed that day for various reasons, such as unavailability of parts, lack of time to finish, and so on. Oracle Fusion Field Service treats the 'not done' status as a 'complete' status, and the accelerator follows one of these flows:
    • If the activity is started and has the duration, the labor resource usage corresponding to the resource is updated in the operation resource.
    • If the installation/de-installation of materials is done before the 'not done' action, the material transactions are updated in Oracle Maintenance.
    • The operation status is updated as 'completed' if all the activities corresponding to the operation resources in Oracle Fusion Field Service are 'Not Done'.
    • To create a new work order, a new operation, or a new resource as part of the Not Done action, follow these steps:
      1. Ensure that the activity properties "Maintenance Action Type" and "Maintenance Planned Date" are configured using the activity page.
      2. Provide the values of "New Work Order", "New Operation", or "New Resource" for the "Maintenance Action Type" property. Based on the value of this field, the accelerator creates a new work order, operation, or resource in the work order. The entry in the "Maintenance Planned Date" captures the due date on which the new work order, operation, or resource is created in Oracle Maintenance. Configure the "Maintenance Planned Date" field such that a user enters the due date in the format 'YYYY:MM:DD HH:mm:ss'.
  • Create a New Activity: While working on an activity, the user can create a new activity or a follow-up activity from Oracle Fusion Field Service. The accelerator can then create a corresponding new work order, work order operation, or operation resource in Oracle Maintenance.
    • The accelerator creates a new activity property in Oracle Fusion Field Service called "Maintenance Action Type" (label 'mwo_action_type') of the enumeration type with a value of "New Work Order", "New Operation", or "New Resource".
    • Based on the value of "New Work Order", "New Operation", or "New Resource" property, the accelerator creates a new work order, a new operation under the same work order, or a new resource under the work order operation.
    • Make sure you mention the Parent Reference Work Order number whenever a new activity is requested, so that:
      • The accelerator creates a new work order by using the work order type, work order subtype, and organization information from the reference work order.
      • The accelerator creates a new work order operation under the reference work order if the request is to create a new operation.
      • The accelerator creates a new resource under the reference work order if the request is to create a new resource.

    If the Parent Reference Work Order number isn't present, the accelerator can't create a new work order, operation, or resource in Oracle Maintenance.