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.

...

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.

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

...

Target Properties

Property Name

Property Code

Required

Description

OIC Account

FDOIC_CLOUD_ACCOUNT_CODE

No

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


Inputs

Input Name

Input Code

Required

Description

OIC Account

FDOIC_INP_CLOUD_ACCOUNT_CODE

No

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

Typically this will not be used because the value will come from the property FDOIC_CLOUD_ACCOUNT_CODE instead.

Export Server Connections

FDOIC_INP_MANAGE_CONNECTIONS


No

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.

When this value is false it will save any connections it found in source control, but no additional connections will be exported from OIC.

If true, OIC will be queried in the target environment, even when sourcing the integrations from SCM.

Outputs

Output Name

Description

Artifacts

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

...

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

Endpoint Execution

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

...

All 3 options shown below are valid and will result in a successful execution.  In option 3's case, since both the icspackage folder and iar file are present, only the iar file will be used.

Info
title

Option 1

....12345/12343/temp/checkoutFolder/myintegration.iar

....12345/12343/temp/checkoutFolder/connectionPlan.properties


title
Info

Option 2

....12345/12343/temp/icspackage/appinstances

....12345/12343/temp/icspackage/dvms

....12345/12343/temp/icspackage/project


title
Info

Option 3

....12345/12343/temp/checkoutFolder/icspackage

....12345/12343/temp/checkoutFolder/myintegration.iar

...

The below option is invalid since there is no icspackage folder and no iar artifact in the temp directory.


Info
title

Option 4

....12345/12343/temp/appinstances

....12345/12343/temp/dvms

....12345/12343/temp/project

...

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.

title
Info

Connections Folder Structure

....12345/12343/temp/icspackage

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

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

...