Deploys integrations as built by packageBuild. Import all integrations. If connections were exported, they will be imported. Any libraries being used within the integrations built in the package with the packageBuild operation will be imported along with the associated metadata as well.
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 |
| 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 |
|---|---|---|---|
Stop On Deployment Error |
| No | Stop deploying package files if any error occurs. If unchecked all files will be deployed even if one or more files fails. Only applies to this operation. Defaults to true. |
Inputs
Input Name | Input Code | Required | Description |
|---|---|---|---|
OIC Account |
| No | The OIC account with all the required properties like Base URI, Username and Password for running OIC Instance. |
Overwrite Integrations |
| No | Overwrite integrations with the same name and version when importing. |
OIC Connection Plan File |
| No | Optional connection configuration file to run during import. The default is 'connectionPlan.properties' in the FD_ARTIFACTS_DIR. Allows absolute path or relative to the artifacts directory. This is used for replacing values in the connections.json file. That file must be present in order to have values replaced in it. Will be pre-processed by the plugin to transform any defined replacement properties based on the deployed environment. |
Deploy Delay between Integrations |
| No | Specify deploy delay in seconds between integrations. Default is 0, which means no delay. Use this delay only if you see issues with Oracle Integration Cloud deployments. |
Update Connections Mode |
| Yes | @since 6.5.0.12 Input to determine whether connections should be updated after deployment. Defaults to ALL. If value is set to ALL, every applicable connection is updated. If value is set to SPECIFIC, only connections specified in FDOIC_INP_UPDATE_CONNECTION_LIST will be updated. If value is set to NONE, none of the connections are updated after a deployment. |
Update Connection List |
| No | @since 6.5.0.12 Comma-separated list of connection IDs to update after deployment. This input is only considered when |
Attachment Override Directory |
| No | A directory which contains attachments to override. Any attachments contained in this directory will be copied over the existing attachments. Useful if you want to have different attachments per environment, you can use FD_ENVIRONMENT_CODE to achieve this. See the attachment overrides section for an example of this. Directory should be in the following format <Connectionid>/<PropertyName>/<attachment>. Example : The folder structure should be <Root>/<Environment Code>/<Connection Id>/<Property Name>/<Attachment File> @since 6.5.0.14 There are situations where you may use same attachment for all environments, rather copying the attachment file structure to each environment folder, you can place them in the following folder structure <Root>/GLOBAL/<Connection Id>/<Property Name>/<Attachment File>. Attachments for connections placed under GLOBAL will be copied along with the files inside environment folder where the plugin execution runs, all files are then copied to the artifacts connection attachment folder. Files inside GLOBAL will be copied first and then files from environment folder will be copied. |
Start Schedules |
| No | @since 6.5.0.3 If true, the file attribute Start Schedules is used to determine if any schedules should be initiated after integration deployment. If false, schedules will not be started regardless of the file attribute value. This is useful to start schedules based on workflow execution variables. I.E. Starting schedules if |
Enable Tracing |
| No | @since 6.5.0.3 If true, the file attribute Enable Tracing is used to determine if integration activity can be viewed in the Activity Stream. If false, tracing will be disabled regardless of the file attribute value. This is useful to enable tracing based on workflow execution variables. I.E. Enable tracing if |
Enable Payload Tracing |
| No | @since 6.5.0.3 If true, the file attribute Enable Payload is used to determine if the payload should be traced. If false, payload tracing will be disabled regardless of the file attribute value. This is useful to enable payload tracing based on workflow execution variables. I.E. Starting schedules if |
Artifacts
This operation consumes artifacts from the artifacts repository.
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.
Connection Plans
If you are using connection plan file(s), ie. “connectionPlan.properties”, it is best practice to store these in source control. For SCM, FlexDeploy will copy all files with the extension properties inside the root directory of the repository (includes checkout folder) and puts them in the target export folder. If you choose to not put your connection plan files at the root level, then you will have to add a clone/checkout step in your build workflow to add your connection plan to the artifact, such that it can be used in the deploy. Subsequently, on the deploy side FlexDeploy will have access to the artifact created during the build which can then be used with the FDOIC_INP_CONNECTION_PLAN input.
The below image is an example of placing the connection plan properties file under the root directory. We are assuming “OIC” is the root directory.
Attachment Overrides
By default, attachments from the source will be deployed to connection in question on the target environment. To deploy different attachments per environment you can use the attachments overrides input along with some variables.
Add your attachments to a GIT repository. This can be the same GIT repository as your integrations. Store them in the following format: <Root>/<Environment Code>/<Connection Id>/<Property Name>/<Attachment File>. This way we will replace the environment code to get the correct attachments.
Instead of storing attachments in a SCM you could also manage the attachments in the FlexDeploy file system. We suggest SCM for versioning and historical purposes.
Add a clone step to the deploy workflow. This will clone the attachments. Sparse checkout folder can be whatever the root is + FD_ENVIRONMENT_CODE
If you went the FlexDeploy file system route, skip this step
Next we will change the Attachment Override Directory input to be FD_TEMP_DIR + <Wherever the files were cloned to> + <Root> + FD_ENVIRONMENT_CODE
I.E. <FD_TEMP_DIR>/XXHR/Connections/DEV/..
If you went the FlexDeploy file system route, you can simply point Attachment Override Directory to the location of the attachments you want to migrate separated by environment.
When the connections are updated on deployment, the attachments in each specified environment directory will be deployed if they apply to the connection(s) in question.