The Integration blog covers the latest in product updates, best practices, customer stories, and more.

  • August 12, 2020

Integration Properties

Samir Sahu, Niket Narang, and Mohammed Sameeruddin

How to externalize properties using Integration Properties in OIC?

Have you tried to use the integration to read the files from FTP and wondered if there was a way to externalize the FTP location outside the integration? Or create an integration that sends out notification and wanted to externalize the recipient of the email as a property to be passed as a parameter to the integration? We have heard from our customers on the need for an easy way to externalize properties from the integration and be able to modify the values without editing the integration.

Changing hard-coded parameter values in the integration canvas can be a time-consuming task as

        i) Integrations needs to be edited

        ii) Familiarity with the integration and the design tool in order to update the appropriate action and property. 

Also, there are use cases where an integration is developed by a one user and run by different users. The user running it might not have privileges to edit the integration making it difficult to change the parameter values.

We have introduced a new feature that allows the integration developer to define properties which are exposed and can be modified outside of the integration designer. Integration developers can define properties of their choosing, providing them with meaningful names and default values, and then use them throughout the integration in the rich set of available actions. Although property values are not modifiable using integration actions, what makes them extremely useful is that the default value can be overridden outside of the design tool prior to running the integration. This feature is available for both - App Driven and Scheduled Orchestration styles.

We have seen some of our customers use lookups and schedule parameters to externalize properties. Lookups works well for defining global properties, Integration Properties allows users to customize the properties at the integration level. Schedule parameters are only available for scheduled integrations and are modifiable using integration actions as they are used to maintain the Last Run Time (position) of the scheduled integration.

How to add Integration Properties

Integration properties can be added from the hamburger menu of trigger action inside the canvas (refer to screenshot below).  User is navigated to new page on clicking "Edit Integration Properties". Name, description and a value for the property can be added here. A maximum of 10 integration properties can be defined per integration.

The default values can be edited later using the "Edit Integration Properties" option available in the menu.

How to override Integration Property values

Integration Property can be updated from the integrations landing page using the "Update Property Value” menu item (refer to the screenshot below). 

Clicking on the menu item opens a popup where user can override the values for the properties defined for the integration.


The behaviour to override integration properties is based on the integration style. 

  • For Scheduled Orchestration, the integration must be in ACTIVATED state. 
  • For App Driven Orchestration, the integration must be in DRAFT/CONFIGURED state.


The feature is available from Oracle Integration August 2020 release.


Hope you enjoyed reading the blog and find this feature useful.

Be the first to comment

Comments ( 0 )
Please enter your name.Please provide a valid email address.Please enter a comment.CAPTCHA challenge response provided was incorrect. Please try again.