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 Account | FDOIC_CLOUD_ACCOUNT_CODE | No | The 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 |
| Yes | Username for the registered OIC account |
OIC Password |
| Yes | Password for the registered OIC account |
OIC Base URI |
| Yes | The REST Base URI of a running OIC Instance |
OIC 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 |
| No | The Oracle Identity Client Id. Only required when using OAuth. For more information on configuring OAuth see here. |
OIC Client Secret |
| No | The Oracle Identity Client Secret. Only required when using OAuth. For more information on configuring OAuth see here. |
OIC 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_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. |
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/...)