Configure an OIC Integration

A configured OIC integration uses the Loftware Spectrum Adapter.

A. Create OIC Connections

To create the OIC connections, use the ERP Adapter to create a connection to the SCM Cloud, and then use the Loftware Spectrum Adapter to create a connection to the Spectrum Cloud Integration Agent. For more information about how to create OIC connections, refer to Oracle Integration Cloud documentation.

  1. In OIC, create a connection from the Oracle SCM Cloud (Trigger) to the Oracle ERP Adapter. During this process, you will be asked to select the specific SCM business event that will trigger Spectrum to print a label.
  2. In OIC, create a connection from the Loftware Spectrum Adapter (Invoke) to the Spectrum Cloud Integration Agent. To complete this connection, provide the following information for the Spectrum Cloud Integration Agent:
    1. Select the adapter Loftware Spectrum.
    2. For Create Connection, select Invoke for the Role field.
    3. For Connection Base URL, enter the base URL for the Spectrum Cloud Integration Agent component in one of the following formats:
      • http://<host name or IP address>:<port>
      • https://<host name or IP address>:<port>

      Example

      • http://demohost:8080
      • https://demohost:8443
    4. For Security Policy, select the appropriate security policy configured for the Spectrum Cloud Integration Agent component.
    5. For Username and Password, enter basic authentication credentials to the Spectrum Cloud Integration Agent that you created in step B of Provision the Spectrum Cloud Integration Agent.
    6. For Agent Group, click Configure Agents, and then select the Agent group for which the Loftware Spectrum Adapter 2.0 component was installed.

B. Create OIC Integration

  1. Create an OIC integration. For more information, refer to Oracle Integration Cloud documentation. For example, select App Driven Orchestration.
  2. Configure the Trigger endpoint for your integration as documented by Oracle using the SCM Trigger Connection you created in step 1 of A. Create OIC Connections.
  3. Configure the Invoke endpoint using the Spectrum Adapter connection you created in step 2 of A. Create OIC Connections.
  4. For Basic Info, use the following information for the Spectrum Adapter configuration.
    1. For What do you want to call your endpoint, enter a name (required).
    2. For What does this endpoint do, add the purpose and detail of the endpoint (optional).
    3. For Spectrum Integration Name, enter the name of the Cloud integration configured in Spectrum that you created in Configure a Cloud Integration in Spectrum (required). This field must exactly match the name in Spectrum.
    4. For Event Name, enter a relevant event name that triggers this integration (optional). This name is passed to Spectrum and can be used in Spectrum business rules for conditional logic. The field name in Spectrum will be lwEventName.
    5. Click Next when this section is complete.
  5. For Configure Data Fields, use the following information. The fields will be explicitly mapped to the OIC integration trigger endpoint, and also mapped to fields on the Spectrum document implicitly (by name).
    1. Click + to add a data field.
    2. Enter the name of the field. This is the name used on a Spectrum document or in a Spectrum Business Rule. It does not need to match any field in the OIC integration trigger endpoint, since you explicitly map fields as an OIC configuration step.
    3. Click Next when this section is complete.

      Note: During Mapping, expand the QueryParameters label to see the data fields you entered for use in the mapping process.

  6. For Summary, review your entries. Click Next if correct or return to a previous section to make edits.
  7. Continue configuring the OIC integration. For more information, refer to Oracle Integration Cloud documentation.