updateConnections

This operation is included in the importIntegration operation. You don't need to put updateConnections or activateIntegration in your workflow after the importIntegration operation.

This page is the best source of information about the way that connection information can be updated at deploy time.

There is a blog article about replacements as well - https://flexagon.com/2019/01/flexdeploy-loves-oic-manage-connection-property-replacement/

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.

Updates connection properties in an OIC Instance.  Connection metadata should be in json format.  If properties have attachments, those attachments will be uploaded as well.  This operation is intended to work in tandem with exportConnections but it is not required.  This operation can be utilized as long as there is a connections.json file in FD_ARTIFACTS_DIR.  If there are attachments that need to be uploaded as well they should be at the same level as the connections.json and follow the same directory format as seen in the attachments section here.

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.
OIC Connection Plan FileFDOIC_INP_CONNECTION_PLANNo

Optional input to specify a different connection plan file name. Default 'connectionPlan.properties'. An absolute path can be specified otherwise it is relative to the artifacts directory.

If left blank then artifactsDir/connectionPlan.properties is assumed.

Outputs

Output Name

Required

Description




Artifacts

This operation consumes artifacts from 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

Valid Artifact Directories

The below examples are all valid connection directory structures that will result in a successful execution.  Note that if you used exportConnections you do not need to worry about the directory structure.

Example 1

12343/12345/artifacts/HR_SOAP_CONNECTION/connections.json

12343/12345/artifacts/HR_SOAP_CONNECTION/attachments/HR_SOAP_CONNECTION/targetWSDLURL/hr.wsdl

12343/12345/artifacts/MY_REST_ENDPOINT_INTERFAC/connections.json

Example 2

12343/12345/artifacts/myFolder/connections.json

12343/12345/artifacts/myFolder/attachments/HR_SOAP_CONNECTION/targetWSDLURL/hr.wsdl

12343/12345/artifacts/myFolder/attachments/EBS_SOAP_CONNECTION/targetWSDLURL/ebs.wsdl

12343/12345/artifacts/myFolder/connectionPlan.properties

Example 3

12343/12345/artifacts/connections.json

12343/12345/artifacts/connectionPlan.properties

Connection Plans and Property Replacement

Prior to updating connections, the connection plan file is applied if present to to update environment specific properties.

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