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.
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:
- Add a connection to an active integration.
- On the Application home page, click Integrations and select the Integrations view.
- Click Create and select Use an Integration.
- In the Use an Integration dialog box, select an integration from the list of active integrations and click Create.
- Use the integration in a process.
- In the Elements palette, click Expand next to the Integrations flow element. Drag and drop the integration that you want to add onto the canvas.
- 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.
- 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.
- 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.
- Click an integration to open the Edit Integration dialog box.
- In the Advanced tab, specify timeout settings and visibility settings for the integration.
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.
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.
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.