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.

A typical workflow using this operation would first have 'cloneProjectSources' (or whichever SCM you prefer), followed by buildIntegration.  This operation is able to build an iar file itself or package the 'icspackage' directory into an iar file.  If both the iar file and icspackage directory are found in the exported source control files then the already packaged iar file will take precedence.

Like exportIntegration, this operation also allows the ability to manage connections along with the integration. In this case, only the .iar file needs to be in source control. 

@since 5.4.0.1 The connections are determined from the IAR extract at build time.

@pre 5.4.0.1 The connections are determined from the live integration on the OIC Instance 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.

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.

Environment/Instance Properties

Inputs

Outputs

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.

Special Considerations

Integration Id

Example temp directory prior to executing buildIntegration

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.

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

Dealing with Connections

As mentioned above, this operation also provides the ability to manage connections along with the integration.  This will result in a connection folder being saved into artifacts for each connection the integration uses.  In addition to exporting the connections, if a connectionPlan.properties is found in the exported source, it will be saved to artifacts so it can be used for the deploy step.

For more information on connectionPlans, see here.

Connections in Source Control

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.