1. Using Processes in Oracle Integration Generation 2
  2. Developer Tasks
  3. Integrate with Applications and Services
  4. Work with Integrations

Work with Integrations

Integrations enable users to communicate with local and remote applications that are exposed as either SOAP or REST.

Note that Oracle Integration Processes supports SOAP and REST technology adapter based integrations only.

Topics:

About Integrations

Integrations enable you to communicate with applications in the cloud using adapters.

Use integrations to integrate between diverse systems or endpoints. An integration is composed of two different connections, the source and the target, and a mapping set between the types used by the distinct systems. The target connection is the endpoint system, which is called and is implemented by an adapter. The source connection is the entry point to the integration from Process. It's represented by a source system or endpoint, which triggers the integration execution.

Process applications can communicate and exchange data with local and remote applications that are exposed as either SOAP or REST.

In Oracle Integration, you first create and activate integrations and then use these integrations in your process applications to communicate with other applications in the cloud. For more information on developing integrations, see Developing Integrations with Oracle Integration in Using Integrations in Oracle Integration Generation 2.

Once you have set up an integration, you can select it and use it in a process. After setting up an integration, you must map a data object to hold the information to be sent or received as a payload. See Configure Integrations.

Configure Integrations

Use integrations to communicate with applications using adapters.

Configuring an integration involves the following main tasks:

  • Add a connection to an active integration

  • Use the integration in a process

To configure an integration:

  1. Add a connection to an active integration.
    1. On the Application home page, click Integrations and select the Integrations view.
    2. Click Create and select Use an Integration.
    3. In the Use an Integration dialog box, select an integration from the list of active integrations and click Create.
  2. Use the integration in a process.
    1. In the Elements palette, click Expand Expand/Collapse icon next to the Integrations flow element. Drag and drop the integration that you want to add onto the canvas.
    2. Optionally, if you choose not to display the integration in the elements palette, you can implement the integration in one or more service tasks in the process. Add or open a service task in the process. In its properties, implement a service call to an integration. See Invoke Integrations, REST, and Web Services.
    3. Configure data association to pass new values as input and output to the integration. For example, if you’re querying an order from Oracle Sales, pass an Order ID as input and you’ll receive an object representing an order as output. You need to map this order object to your business data objects as needed.
    4. Repeat these steps if you need to configure other integrations, perform an operation, and store data changes in the business object.

To delete an integration, click its delete icon on the Integrations page. You can’t delete an integration that is being called in a process.

Edit Integrations

You can edit an existing integration in the Edit Integration dialog box in Integrations view.

  1. Click an integration to open the Edit Integration dialog box.
  2. In the Advanced tab, specify timeout settings and visibility settings for the integration.
    1. In the Advanced tab, specify the read timeout and the timeout for connecting to the integration in milliseconds.
    2. Deselect or select the Visible on palette check box to hide or display the integration in the elements palette. This option is selected by default.
    3. If you choose to display the integration in the palette, click Open customization dialog, and specify a name to be used for the integration in the elements palette.
    4. Under Security, choose one of the options to specify the credentials for authenticating the integration.
      • Select Propagate identity, if you want to use the credentials of the user that created the instance. Note that, if for any reason this user is removed from the system, the integration call will fail.
      • Select Use generic credentials, if you don't want identity propagation to happen. In this case, Process uses the same internal system provided credentials for every integration call. Note that these credentials cannot be changed or removed.
    5. Click Apply to save your changes and close the dialog box.
    6. In the Use an Integration dialog box, click OK to save your changes.

Update Integrations

You can keep integrations that you use for your process application up-to-date. Update to the latest definition or to the latest version of the integration from the Edit the integration dialog box in Integrations view.

Update definition icon

If a schema definition update is available for an integration, you can update to the latest definition. Click the integration to open the Edit the integration dialog box. In the Edit the integration dialog box, click the update to latest definition link.

Service unavailable icon

If you see the deactivated or deleted icon for an integration, click the integration to open the Edit the integration dialog box. In the Edit the integration dialog box, you get one of the three options:

  • Update to the latest version.

  • Update to the latest incompatible version. In this case, you get a message to validate the application after you update the integration, as you may need to fix some references to the updated schema.

  • Update is not supported as the SOAP port type changed. This is applicable only to SOAP (web service) integrations.