Manage Maintenance Programs Across Organizations Using File-Based Data Import and REST API

Maintenance programs are used to define and generate a periodic preventative maintenance forecast for one or more affected assets in a maintenance-enabled organization. In this update, you can now create and update maintenance programs in a central planning organization to enable assets across operating different organizations to be included in the forecast. When assets move between organizations either temporarily or permanently, you can now determine when and where an asset will be maintained using a REST API or file-based data import.  These methods will continue to support assets that operate and will be maintained in their operating organizations as well.

The FBDI template provides tabs to define key program attributes and the template includes detailed column descriptions and sample data for common use cases.  The change log for this uptake includes:

  • The Maintenance Program (header) tab has the following new attributes: Program Type Code, Program SubType Code, Allow Global Assets Flag, Program Reference, Forecast Window in Days, Workorder Window in Days, Work Order Start Time, and Work Order Timezone

  • The Work Requirements tab has the following new attributes: Requirement Reference, Forecast Window in Days, Workorder Window in Days, Create Work Order Option Code, Work Order Status, Work Order Firm Flag, and Work Order Priority.

  • The Affected Assets tab has the following new attribute: Create Work Order Option Code

Additionally, complementary enhancements have been made to the Maintenance Programs REST API to ensure that cross-organization assets are supported and assets that operate and will be maintained in their operating organizations.  Examples are included in the REST API guide for Supply Chain Management under the Use Cases section, Maintenance folder and then the document Create and Update Maintenance Programs.

The updates to the Maintenance Program REST API and file-based data import support the user interface of the Manage Preventative Maintenance For Assets Across Organizations feature that's also available in this update.

Steps to Enable

Review the REST service definition in the REST API guides to leverage (available from the Oracle Help Center > your apps service area of interest > APIs & Schema). If you are new to Oracle's REST services you may want to begin with the Quick Start section.

You do not need to do anything to enable this feature.

Tips And Considerations

The Allow Global Assets is an optional attribute that's used during the creation of a new program. It can only be updated until the first work order is created for the program.

Access Requirements

No new roles or privileges are required for the new capabilities introduced in this service.