Import and Export Integrations

You can import and export integrations to share them between Oracle Integration environments.

See the following topics:

Import an Integration

You can import integrations that were previously exported as an IAR file from Oracle Integration. You must update your connection properties after the import.

Note:

  • You cannot manually edit an exported integration (IAR) file outside of Oracle Integration and then import it into another instance. For example, if you manually update a connection name in an exported integration, then import it, the connection created cannot be updated or deleted. If you need to modify the file, contact Oracle Support Services.
  • You cannot import an Oracle Integration 3 integration into Oracle Integration Generation 2.
  • You can export an integration from a higher service instance version and import it into a lower service instance version as long as no new features from the higher version are used (for example, create an integration on a 25.02 development instance, then export and import it to a 24.10 production instance).
  • If you import a basic routing integration into Oracle Integration 3, it is converted to an application integration.
To import an integration:
  1. Decide where to start:
    • Work in a project.
      1. In the navigation pane, click Projects.
      2. Select the project name.
      3. Click Integrations Integrations icon.
      4. In the Integrations section, click Add if no integrations currently exist or + if integrations already exist.

        The Add integration panel opens.

      5. Click Import.

        The Import integration panel appears.

    • Work outside a project.
      1. In the navigation pane, click Design, then Integrations.
      2. In the banner, click Import.

        The Import integration panel appears.

  2. Click Drag and Drop to select a file or drag one to this field.
  3. Select one of the following options.
    • Import: Imports the integration for you to configure your connection properties at a later time.
    • Import and Configure: Imports the integration and shows the Configuration Editor page for configuring your connection properties now.
    If an integration already exists with the same identifier and version, you must confirm whether to overwrite the existing integration.
The imported integration appears in the Integrations list for you to configure or activate.

Import a Prebuilt Integration

You can import prebuilt integrations into your Oracle Integration environment.

There are two types of prebuilt integrations:
  • User-created integrations. These are integrations that you or another user created. See Import an Integration.

  • Oracle-created integrations from the Oracle Integration Home page or from the Oracle Cloud Marketplace as part of a package. Integrations from the Home page are designated with a RECIPE message that is displayed next to the integration name on the Integrations page. See Get Familiar with the Home Page in Getting Started with Oracle Integration 3 and the Oracle Cloud Marketplace.

Export an Integration

Once you create an integration, you can export that integration as an IAR file for use in other Oracle Integration environments. You can export a locked integration. You can also export integrations that publish and subscribe to events and import them into a project.

To export an integration:

  1. In the navigation pane, click Design, then Integrations.
  2. Hover over the integration to export.
  3. Click Actions Actions icon, then select Export.
    A message is displayed indicating that the integration has been downloaded. The file is saved with a name that consists of the identifier plus the version number, and an IAR extension.
You can import the exported integration into the XSL Map Editor in Oracle Service Bus. See Import a Map File into Oracle JDeveloper.

Note:

Lookups referenced using the lookupValue function in the Expression Builder are included in the exported integration JAR file. When you import the integration, the referenced lookups are also imported and are visible in the Expression Builder.