Versions Compared

Key

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

Exports one or more integrations from Oracle Integration Cloud as .iar files that can be extracted and placed in an SCM to support Continuous Integration.

This operation is intended to be used in a utility workflow that commits the exported files to your SCM. This allows us to set up a utility project that runs on a schedule. Then, we can configure a separate Build/Deploy project for each integration that uses a 'Poll SCM' trigger watching the SCM path that the utility project commits changes to. This allows for Continuous Integration even though the project is not normally stored in SCM.

Info

Either FDOIC_CLOUD_ACCOUNT_CODE Target 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.

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.

Exclude List

FDOIC_INP_INTEGRATION_EXCLUDE_LIST

No

Optional list of integration ids or codes to be excluded from being checked for updates. Leaving this blank will not exclude any integrations.

Include List

FDOIC_INP_INTEGRATION_INCLUDE_LIST

No

Optional explicit list of integration ids or codes to be checked for updates. Leaving this blank will exclude any integrations not excluded.

Export Subfolder

FDOIC_INP_EXPORT_SUBFOLDER

No

Optional subfolder of the temp directory to export any integrations into

Extract Integrations

FDOIC_INP_EXTRACT_INTEGRATIONS

No

Optionally extract the .iar files exported by this operation

Stop on Error

FDOIC_INP_STOP_ON_ERROR

No

Stop exporting integrations, if any error occurs. If false or not specified, exporting of other integrations will continue.

Include Version in Folder Name

FDOIC_INP_INCLUDE_VERSION_IN_FOLDER_NAME

No

Include the version in the folder name. This will need to be checked to use with

partial deploy

package-based projects.

Export Only Updated Integrations

FDOIC_INP_EXPORT_ONLY_UPDATED_INTEGRATIONS

Yes

Export only integrations which have been updated since the last export. Defaults to true.

Artifacts

This operation produces no artifacts, instead all exported files are stored in the temp directory to be pushed to SCM.

Endpoint Selection

This operation will select all available endpoints associated to the Target.

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

Integrations will be exported based on their last updated date time. When an update is detected, the integration will be exported to an .iar file inside of a folder with its integration id in the FD_TEMP_DIR. For example, the integration "HELLO_WORLD" version 1.001.0000 would be exported to the following location: FD_TEMP_DIR/HELLO_WORLD/HELLO_WORLD.1.001.0000.iar.

If Expand Integrations input is true, the .iar file will be expanded at the same level as the original file. (e.g. FD_TEMP_DIR/HELLO_WORLD/...)

Exclude List and Include List inputs can take a CSV list of identifiers (HELLO_WORLD) or full identifiers (HELLO_WORLD|01.02.0000). Providing only identifier would export all versions for that integration instead of one version with the full identifier.

...