Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Packages an integration into an iar file and saves it to artifacts.  This operation is intended as an alternative for exportIntegration with the difference being exportIntegration exports directly from OIC, whereas this operation is intending the integration source code to be managed in an SCM.

...

Like exportIntegration, this operation also allows the ability to manage connections and lookups along with the integration. In this case, only the .iar file needs to be in source control. The connections and lookups are pulled from the server at build time. This operation should be used in a build workflow. The artifact will contain the exported .iar file and optionally the connections.json file. You can also store the connection replacement properties in SCM and they will be ready to go for your deploy workflow as well.

@since 5.3.0.4 - If the Manage Connections input is false this operation will save any connections included in the source control export. See Special Considerations for more information.

Info

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

...

Input NameInput CodeRequiredDescription
FDOIC_INP_CLOUD_ACCOUNT_CODENoThe OIC account with all the required properties like Base URI, Username and Password for running OIC Instance.
Manage ConnectionsFDOIC_INP_MANAGE_CONNECTIONSNo

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

@since 5.3.0.4 - When this value is false it will save any connections it found in source control

Outputs

Output NameDescription

...

For more information on connectionPlans, see here.

Connections in Source Control

@since 5.3.0.If you choose to check your connections into source control this operation can now save those into artifacts in addition to the IAR export. If you have connections saved in source control then the 'Manage Connections' input needs to be false. 

Connections should be saved in the same manner as they are exported via ExportConnections, which is a folder with the connection id with a child file named connections.json. The example below shows how an integration with two connections should be structured.

Info
titleConnections Folder Structure

....12345/12343/temp/icspackage

....12345/12343/temp/MY_FIRST_CONNECTION/connections.json

....12345/12343/temp/OTHER_CONNECTION/connections.json