Import and Export Integrations

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

See the following topics:

• Import an Integration

• Import a Prebuilt Integration

• Export an Integration

Import an Integration

You can import integrations that were previously exported as a JAR file from Oracle Integration.

Note:

• You cannot import Oracle Integration Classic (user-managed) and Oracle Integration integrations into Oracle Integration Cloud Service.

• 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.

To import an integration:

1. In the left navigation pane, click Home > Integrations > Integrations.
2. In the banner, click Import.
3. In the Import Integration File dialog, click Browse to navigate to and select the file to import.
4. If the integration includes Oracle Asserter recordings that you want to import, click Include Asserter Recordings (if any).
5. Click Import.
   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 and you can customize or activate it.

Note:

Even though the Activate icon is enabled after you import an integration, you must first configure your connection endpoints. If you do not, you receive an error when trying to activate the integration. See Edit a Connection.

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 Generation 2 and the Oracle Cloud Marketplace.

Export an Integration

Once you create an integration, you can export that integration as a JAR file for use in other Oracle Integration environments or import the integration into Oracle JDeveloper to perform an advanced XSLT mapper task (for example, creating variables or using templates) that you cannot perform in the mapper. After mapper editing in Oracle JDeveloper is complete, the mapper file can then be imported back into Oracle Integration. You can export an integration from either the Integration Designer or from the Integrations list. You can also export a locked integration.

Note:

You cannot import Oracle Integration Classic (user-managed) and Oracle Integration integrations into Oracle Integration.

To export an integration:

1. In the left navigation pane, click Home > Integrations > Integrations.
2. Go to the row of the integration to export.
3. Select Export from the menu.
4. In the dialog that appears, select Save File, and then click OK.
5. Save the file to the location you want.

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.