Solutions

Oracle Smart Operations in Fusion Cloud SCM Integration

5min

Oracle and Litmus have worked together to build an integration – focusing on Oracle Smart Operations Connected Assets and Equipment capabilities in Fusion Cloud Supply Chain & Manufacturing (SCM), alongside Litmus Edge's Edge capabilities.

Litmus created a solution template enabling customers to generate Smart Operations payloads within Oracle Cloud Manufacturing and Maintenance. This integration supports data transmission through the REST API OAuth Integration.

Oracle Payload Requirement:

The integration focuses on associating connected devices on Litmus Edge with the five predefined event types powered by Smart Operations capabilities within Oracle Fusion Cloud Manufacturing and Oracle Fusion Cloud Maintenance.

The five event types and payloads are listed below:

  1. Asset Fault Event
  2. Asset Status Event
  3. Operation Execution Start Event
  4. Quantity Report Event
  5. Operation Execution Stop Event

The purpose is to provide Smart Operations for Oracle / Litmus customers to model 5 event types on Litmus Edge, generate events, and send them to Oracle Cloud Manufacturing and Maintenance via Litmus's Northbound REST API OAuth Integration.

Example: Please refer to the Oracle REST API for the Oracle Supply Chain Management Cloud Guide, which showcases these examples.

The breakdown of each of the key:value pairs in each of the payloads is broken down as below:

  • entityCode - Device Metadata
  • eventTypeCode - Metadata for each event
  • eventTime - Event time at the time of event generation
  • data - Data payload is generated via DeviceHub, Analytics, and/or Integrations on Litmus Edge

Quick Start Guide

  1. Deploy Litmus Edge Version 3.22.0 or later. See Installation and Deployments for details.
  2. Import the Litmus Edge template to the deployed instance of Litmus Edge. Documentation on how to apply a template can be found here.
  3. Configuring and generating the desired payload:
    • Digital Twins on Litmus Edge helps with standardization and governance to build the data schema and format for your devices on the plant floor. For integration with Oracle Smart Operations in Manufacturing and Maintenance, Digital Twins helps with building the payload necessary to be sent.
    • Based on the specific customer requirement(s), tags, and mapping required for events, the transformation changes can be done in Digital Twins and Analytics to build the payload for the five events.
    • When connected to real devices, the payload can be customized using wildcards by wildcarding the device payloads for each of the events in Digital Twin Instances topics by replacing the device ID with a "*" like below:
    • Example: devicehub.alias.*.STATUS
    • Note: Please reach out to your Litmus Support Representative, or your System Integrator Partner for help and guidance for your specific use case.
  4. Building your data model using Digital Twins and Analytics.
    • Digital Twins on Litmus Edge helps with standardization and governance to build the data schema and format for your devices on the plant floor. For integration with Oracle Smart Operations in Manufacturing and Maintenance, Digital Twins helps with building the payload necessary to be sent.
    • Analytics on Litmus Edge helps transform the device payload and associate device values with event values. For example, a payload for an Asset Fault event coming from the device may only contain Fault_Code - which can be associated with an associated Fault_Type using Analytics Tengo Script Processor or JavaScript Processor on Analytics.
      • Example: Asset Fault event can be configured to map the fault_code to a specific fault_type using Transformations in Digital Twin Models - defining the mapping using JSONata transformations as shown in the template.

    • Once the desired payload is configured in Digital Twins, copy the topic from Digital Twins instance for the events that needs to be sent to Oracle Cloud Manufacturing and Oracle Cloud Maintenance.

      Document image
      
  5. Data will be sent to Oracle Fusion SCM using Integrations on Litmus Edge.
    • Data can be sent to Oracle Fusion SCM using REST API Integrations on Litmus Edge. On the REST API Connector, enter the OAuth credentials to Oracle.
      • The details around tOAuth token endpoint, Client secret, Client ID, and Scope can be requested from Oracle for your integration.
    • Important: It is necessary to define the port after the base URL on the REST API OAuth configuration page: https://<base url>:<port_number>/<resource_request/api_call>

    • Once the connection is established, configure the outbound topic from Digital Twins Instances as necessary.

      Document image
      

Example end-to-end Configuration Steps for Asset Fault Event:

  1. Connect your device. See Connect a Device for more details.
  2. Upload the template. See template for more details.
  3. Add entityCode as metadata for your device.
  4. On your Digital Twins:
    • Static Attributes: Ensure you have eventTypeCode configured as "CA_FAULT" on Static attributes.
    • Transformation: associate your fault codes to fault types under "data_payload_transformation" by using the example on the template.
    • Note: For high-volume fault codes, the data payload transformation can be done in Analytics using a TengoScript processor or JavaScript processor to build the payload instead of transformations.
    • Dynamic Attributes: maps the data and event payloads.
    • Schema: defines your payload structure.
    • Be sure to upgrade the instance to apply changes.
  5. Copy the topic from Instance topic in REST API Integration as shown in Integrations section.

The data will now be streaming to Oracle Smart Operations for Manufacturing and Maintenance for the 5 event types configured from Litmus Edge.

Updated 21 Apr 2025
PREVIOUS
How to connect Litmus Edge to Data Historians
NEXT
Oracle DB API Wrapper
Docs powered by Archbee