Integrate Oracle Fusion Cloud Maintenance with Oracle IoT Production Monitoring Cloud Service

Use Oracle Fusion Cloud Maintenance integration to automatically create maintenance work orders for your machines in Oracle Internet of Things (IoT) Production Monitoring Cloud Service.

You can choose to import machines from Oracle Fusion Cloud Maintenance into Oracle Internet of Things (IoT) Production Monitoring Cloud Service.

You must have the machine types already defined in Oracle IoT Production Monitoring Cloud Service for the machines that you wish to import from Oracle Fusion Cloud Maintenance. If you are also integrating with Oracle Fusion Cloud Manufacturing, then the machine types can also come from Oracle Fusion Cloud Manufacturing.

After you import machines and associate the machines with sensors, you can configure rules to conditionally generate incidents and automatic work orders in Oracle Fusion Cloud Maintenance.

For example, you can have a threshold rule that triggers an incident when a device associated with a machine overheats. An outbound work order corresponding to the incident is automatically generated in Oracle Fusion Cloud Maintenance.

When you release, close, cancel, or modify the work order in Oracle Fusion Cloud Maintenance, the status of the corresponding incident is automatically updated inOracle IoT Production Monitoring Cloud Service. The synchronization between Oracle IoT Production Monitoring Cloud Service and Oracle Fusion Cloud Maintenance happens every 5 minutes.

Note:

If you manually modify the status of an incident in Oracle IoT Production Monitoring Cloud Service, the change is not synchronized with the work order in Oracle Fusion Cloud Maintenance.

Add an Oracle Fusion Cloud Maintenance Integration

Use the Integrations page in Oracle Internet of Things (IoT) Production Monitoring Cloud Service to add an integration with Oracle Fusion Cloud Maintenance.

Before you configure Oracle Fusion Cloud Maintenance integration, make sure your Oracle Fusion Cloud Maintenance host is trusted by your Oracle Internet of Things Intelligent Applications Cloud domain.

Host names with .oraclecloud.com and .oraclecloudapps.com suffixes are always allowed. If your Oracle Fusion Cloud Maintenance domain name is different, then add the domain as a trusted CN in the Oracle Internet of Things Intelligent Applications Cloud management console. To do this, add *.YourDomain.com under Trusted CN in the Settings page.

You can access your Oracle Internet of Things Intelligent Applications Cloud management console at the following URL:

https://hostname/ui

Here, hostname is the host name of your Oracle Internet of Things Intelligent Applications Cloud instance.

To add an integration with Oracle Fusion Cloud Maintenance:

1. In Oracle IoT Production Monitoring Cloud Service, click Menu (), and then click Settings.

   You can access Oracle IoT Production Monitoring Cloud Service at the following URL:

   https://hostname/pm

   Here, hostname is the host name of your Oracle Internet of Things Intelligent Applications Cloud instance.

   If you are in the Design Center, you need to click Previous () before you see the Settings option in the menu.
2. Click Integrations.
3. Click Add to add a new integration.
4. In the Add Integration dialog, select Oracle Maintenance Cloud Service and click Add.
   Tip: You can also search for an integration name in the list.
   
   

   

   
   
   Oracle Maintenance Cloud Service integration gets added to the Integrations page.
5. On the Integrations page, under Oracle Maintenance Cloud Service, click Connect.
6. Specify the Service URL for your Oracle Fusion Cloud Maintenance instance.
   The Service URL is the URL of your Oracle Fusion Cloud Maintenance host. No port number is necessary here.
   For example: https://MyMntCloud.oraclecloud.com.
7. Specify the User Name for your Oracle Fusion Cloud Maintenance instance.
8. Specify the Password for your Oracle Fusion Cloud Maintenance instance.
9. Click Verify Connectivity to verify connectivity to the Oracle Fusion Cloud Maintenance instance.
   If the connection succeeds, then the Save button gets enabled.
10. Click Save to save the connection settings.

Enable and Configure the Oracle Fusion Cloud Maintenance Integration

To start using Oracle Fusion Cloud Maintenance integration, enable and configure the integration for Oracle Maintenance Cloud Service on the Integrations page.

1. In Oracle IoT Production Monitoring Cloud Service, click Menu (), and then click Settings.
2. Click Integrations.
3. Under Oracle Maintenance Cloud Service, click Edit Configuration.
4. Toggle the Integration Status switch to ON.
   This enables your Oracle Fusion Cloud Maintenance integration.
5. Specify the Synchronization frequency in minutes.
   The sync frequency determines how often Oracle IoT Production Monitoring Cloud Service syncs with Oracle Fusion Cloud Maintenance.
6. Click Save to save your configuration settings.

You may next proceed to import machines from Oracle Fusion Cloud Maintenance.

Import Machines from Oracle Fusion Cloud Maintenance

You can choose to import Oracle Fusion Cloud Maintenance assets as machines into Oracle IoT Production Monitoring Cloud Service.

You must have the machine types already defined in Oracle IoT Production Monitoring Cloud Service for the machines that you wish to import from Oracle Fusion Cloud Maintenance. If you are also integrating with Oracle Fusion Cloud Manufacturing, then the machine types can also come from Oracle Fusion Cloud Manufacturing.

If you are also integrating with Oracle Fusion Cloud Manufacturing, then the resource instances in Oracle Fusion Cloud Manufacturing that have associated asset numbers for the corresponding assets in Oracle Fusion Cloud Maintenance are already present in Oracle Internet of Things (IoT) Production Monitoring Cloud Service. If you have additional assets in Oracle Fusion Cloud Maintenance that are not present in Oracle Fusion Cloud Manufacturing, you can import these into Oracle IoT Production Monitoring Cloud Service.

1. In Oracle Internet of Things (IoT) Production Monitoring Cloud Service, click Menu and then click Design Center.
2. Select Machines from the Design Center menu.
3. Click Import .
4. Under Source, ensure that Maintenance Cloud (MNT) is selected.
5. Select a pre-existing Machine Type for the machines that you are importing.
   You must have either defined a machine type in Oracle IoT Production Monitoring Cloud Service, or imported the machine type from Oracle Fusion Cloud Manufacturing.
6. Search for Oracle Fusion Cloud Maintenance machines to import:
   1. Select Maintainable Machines or All Machines to search for in Oracle Fusion Cloud Maintenance.
   2. In the Search Parameters list, select Name, Type (Item in Oracle Fusion Cloud Maintenance), or Organization Code.
   3. Specify the corresponding Name, Type, or Organization Code value.

      Note:

      The search value field is case sensitive.
   4. Click Search.
7. Select the machines that you want to import from the search results.
8. Click Import.

The selected machines are imported into Oracle IoT Production Monitoring Cloud Service.

Configure Rules to Generate Automatic Maintenance Work Orders

Configure rules to automatically create work orders in Oracle Fusion Cloud Maintenance when an incident is created in Oracle IoT Production Monitoring Cloud Service.

When creating incident rules in Oracle IoT Production Monitoring Cloud Service, an additional Work Order section appears for machines synced with Oracle Fusion Cloud Maintenance.

For basic information on using rules in Oracle IoT Production Monitoring Cloud Service, see Define Rules to Trigger Incidents.

If you are creating a rule to generate an incident for an imported asset, click Create Work Order in Maintenance Cloud.

Use Condition Event Codes

If you have defined condition event codes in Oracle Fusion Cloud Maintenance for your IoT assets, then you can pass the event code corresponding to the incident back to Oracle Fusion Cloud Maintenance. Select the Event Codes to pass to Oracle Fusion Cloud Maintenance when the incident rule is triggered.

You can define maintenance programs in Oracle Fusion Cloud Maintenance to act on the incident based on the event code passed back by Oracle IoT Production Monitoring Cloud Service. The maintenance program can trigger one or more work orders in Oracle Fusion Cloud Maintenance based on the reported incident.

Note:

The Event Codes field appears only when you are creating a rule for a machine mapped to a specific asset in Oracle Fusion Cloud Maintenance. If you are creating a generic rule for a machine type, then the event codes aren't available, as the machine type can have machines in Oracle IoT Production Monitoring Cloud Service that are not imported from Oracle Fusion Cloud Maintenance.

See Also: How You Manage Condition Event Codes in the Oracle SCM Cloud Using Maintenance guide.

Verify and Update the Work Orders in Oracle Maintenance Cloud

When an incident is created for an imported machine in Oracle Internet of Things (IoT) Production Monitoring Cloud Service, the corresponding work order is automatically created in Oracle Fusion Cloud Maintenance.

When a rule incident has an associated work order, you can open the work order directly in Oracle Fusion Cloud Maintenance from the Incidents page in Operations Center. The link is available under the Maintenance Cloud Work Orders section for the incident.

Note:

The scheduler job synchronizes the Oracle Fusion Cloud Maintenance with Oracle IoT Production Monitoring Cloud Service every 5 minutes.

You can also manually search for a work order in your Oracle Fusion Cloud Maintenance instance using the following steps:

1. Sign in to your Oracle Fusion Cloud Maintenance instance.
2. Navigate to Maintenance Management.
3. Under Tasks, select Manage Maintenance Work Orders.
4. Click Search Filters to specify criteria, such as the asset name and work order creation time, for your search.
5. Select one or more work order rows from the search results.
   • Click Release to release the selected work orders.
   • Click Mass Action to change the status of the work orders.
   When you change the status of a work order in Oracle Fusion Cloud Maintenance, the status of the incident in Oracle IoT Production Monitoring Cloud Service is automatically updated. For example, when you release a work order in Oracle Fusion Cloud Maintenance, the status of the corresponding incident in Oracle IoT Production Monitoring Cloud Service changes from New to Open. When you close or cancel a work order, the status for the associated incident changes to Withdrawn.

Verify Incident Status Update in Oracle IoT Production Monitoring Cloud Service

When you change the status of a work order in the Oracle Fusion Cloud Maintenance, the associated incident status is automatically updated in Oracle Internet of Things (IoT) Production Monitoring Cloud Service.

Note:

The scheduler job synchronizes the Oracle Fusion Cloud Maintenance with Oracle IoT Production Monitoring Cloud Service every 5 minutes.

1. Click Menu, and then click Operations Center.
2. Click Incidents .
3. Use one of the following methods to verify the status of an incident:
   • In the Incidents table, view the Status column value that corresponds to the incident.
   • Search for the incident by using incident filters.