exportIntegration

Exports an integration from Oracle Integration Cloud as a .iar artifact that can be imported into different Integration Cloud Instances.   If the connections are being managed by the operation, then a separate file will be created for each connection and any associated attachments.  This operation will retrieve all needed connections from the integration. Lookups are also included in the integration export.

Either FDOIC_CLOUD_ACCOUNT_CODE environment instance property value or FDOIC_INP_CLOUD_ACCOUNT_CODE plugin input value should exist. When both exists, plugin input value will take precedence. See Creating/Editing a Cloud Account and Provider for details on how to setup Cloud Account for OIC.

Environment/Instance Properties

Property Name

Property Code

Required

Description

OIC AccountFDOIC_CLOUD_ACCOUNT_CODENoThe OIC account with all the required properties like Base URI, Username and Password for running OIC Instance.

Project Properties

Property Name

Property Code

Required

Description

Integration Identifier

FDOIC_INTEGRATION_IDENTIFIER

Yes

The identifier (code) of the integration being deployed


Inputs

Input Name

Input Code

Required

Description

FDOIC_INP_CLOUD_ACCOUNT_CODENoThe OIC account with all the required properties like Base URI, Username and Password for running OIC Instance.
Integration VersionFDOIC_INP_INTEGRATION_VERSIONNoOptional version of the integration, leave blank for latest. (e.g. 01.02.0000)
Manage ConnectionsFDOIC_INP_MANAGE_CONNECTIONSNoBoolean to indicate whether connections for this integration should be exported as an artifact. Default is true.  The import Integration operation will automatically deploy any connections it finds in artifacts.
Integration IdentifierFDOIC_INP_INTEGRATION_IDENTIFIERNoOptional input for the integration identifier. This is intended to be used in a utility fashion. If this operation is being used in a standard build workflow then the project property should be used.
OIC Version Logic
FDOIC_INP_VERSION_LOGIC
No

A select option deciding how the version should be found if no version is specified. 

  • LastUpdateTime - Version is decided based on last updated time
  • LatestNamedVersion - Version is decided based upon the largest named version. I.E 3.0.1 would be chosen over 2.2.5

Outputs

Output Name

Required

Description

FDOIC_OUT_INTEGRATION_VERSION

No

The version number of the exported integration

Artifacts

This operation produces artifacts that will be stored in the artifacts repository.

Endpoint Selection

This operation will select all available endpoints associated to the environment/instance.

Endpoint Execution

This operation will execute on any one of the selected endpoints and will be random in the determination of which one.

Recommended Folder Structure

Prior to 5.7, this folder structure was required. It is still considered to be best practice.

Each integration (compressed as an IAR or uncompressed) is stored in its own folder in SCM. This matches the format the the exportIntegration operation outputs, so you can use that operation to setup your source control if you don't already have one or wish to migrate to the recommended structure.

The following macros are not currently supported in the footer:
  • style