exportUpdatedIntegrations

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.

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





Cloud Account Properties

Property Name

Property Code

Required

Description

OIC User

FDOICACCT_USERNAME

Yes

Username for the registered OIC account

OIC Password

FDOICACCT_PASSWORD

Yes

Password for the registered OIC account

OIC Base URI

FDOICACCT_BASE_URI

Yes

The REST Base URI of a running OIC Instance

OIC Identity Base URI

FDOICACCT_IDENTITY_BASE_URI

No

The Oracle Identity Cloud Service URL (IDCS). E.G. https://idcs-1a2bc3de.identity.oraclecloud.com. Only required when using OAuth. For more information on configuring OAuth see here.

OIC Client Id

FDOICACCT_CLIENT_ID

No

The Oracle Identity Client Id. Only required when using OAuth. For more information on configuring OAuth see here.

OIC Client Secret

FDOICACCT_CLIENT_SECRET

No

The Oracle Identity Client Secret. Only required when using OAuth. For more information on configuring OAuth see here.

OIC Client Scope

FDOICACCT_CLIENT_SCOPE

No

The Oracle Identity Client Scope. Only required when using OAuth. For more information on configuring OAuth see here.

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.
Exclude ListFDOIC_INP_INTEGRATION_EXCLUDE_LISTNoOptional list of integration ids or codes to be excluded from being checked for updates. Leaving this blank will not exclude any integrations.
Include ListFDOIC_INP_INTEGRATION_INCLUDE_LISTNoOptional explicit list of integration ids or codes to be checked for updates. Leaving this blank will exclude any integrations not excluded.
Export SubfolderFDOIC_INP_EXPORT_SUBFOLDERNoOptional subfolder of the temp directory to export any integrations into
Extract IntegrationsFDOIC_INP_EXTRACT_INTEGRATIONSNoOptionally extract the .iar files exported by this operation

Outputs

Output Name

Required

Description




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

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 it's 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/...)

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