/
importApplication

importApplication

Imports the application resources from the artifacts repository and deploys the application to one or more selected cloud instances. Performs environment-specific property replacement for one or more service endpoint configuration plans ( if exists ) before deployment. 

It is required to have exported the application resources using exportApplication operation prior to running the import. This operation uses the application artifact zip file (ApplicationId-ApplicationVersion.zip) from the artifacts repository and derives the ApplicationVersion to be used for the application imported to the target cloud instances. It will result in failure when there is no exported application artifact in the repo, 

Configuration plans can be used for this operation, see below for more details. It also performs application 'Stage' or 'Publish' based on the operation type plugin input after successfully importing all the resources. 


Either FDOVB_CLOUD_ACCOUNT_CODE environment instance property value or FDOVB_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 OVB.

Environment/Instance Properties

Property Name

Property Code

Required

Description

Oracle Visual Builder AccountFDOVB_CLOUD_ACCOUNT_CODENoThe OVB account with all the required properties like Base URI, Username and Password for running OVB Instance.

Project Properties

Property Name

Property Code

Required

Description

Oracle Visual Builder Application Id

FDOVB_APPLICATION_ID

Yes

This ID defines the context path (browser's URI) used for the application.

Oracle Visual Builder Application DescriptionFDOVB_APPLICATION_DESCRIPTIONNoOracle Visual Builder Application Description.

Cloud Account Properties

Property Name

Property Code

Required

Description

OVB User

FDOVBACCT_USERNAME

Yes

User name for the registered OVB account

OVB Password

FDOVBACCT_PASSWORD

Yes

Password for the registered OVB account

OVB Base URI

FDOVBACCT_BASE_URI

Yes

The REST Base URI of a running OVB Instance

OVB Identity Base URI

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

OVB Client Id

FDOVBACCT_CLIENT_ID

No

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

OVB Client Secret

FDOVBACCT_CLIENT_SECRET

No

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

OVB Client Scope

FDOVBACCT_CLIENT_SCOPE

No

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

OVB Keystore Path

FDOVBACCT_KEYSTORE_PATH

No

Java keystore path containing the private key to use for JWT User Assertion. Only required when using OAuth. For more information on configuring OAuth see here.

OVB Keystore Passphrase

FDOVBACCT_KEYSTORE_PASS

No

Java keystore passphrase for the OVB Keystore Path property. Only required when using OAuth. For more information on configuring OAuth see here.

OVB Certificate Alias

FDOVBACCT_CERT_ALIAS

No

Private certificate alias. Only required when using OAuth. For more information on configuring OAuth see here.

OVB Certificate Passphrase

FDOVBACCT_CERT_PASS

No

Passphrase for the OVB Certificate Alias property. Leave blank if no passphrase was used. Only required when using OAuth. For more information on configuring OAuth see here.

OVB Certificate Algorithm

FDOVBACCT_CERT_ALGORITHM

No

Algorithm used for the certificate. Defaults to RS256 Only required when using OAuth. For more information on configuring OAuth see here.

OVB Component Exchange URL

FDOVBACCT_COMPONENT_EXCHANGE_URL

No

URL for a visual builder component exchange. More info on this https://docs.oracle.com/en/cloud/paas/app-builder-cloud/abcag/manage-your-component-exchange.html#GUID-2B02DA1E-82EA-4FD1-88EC-F1C113A8969E. Default is the US Oracle hosted exchange. Only neccessary if using buildApplication operation and you are using component exchange.

OVB Component Exchange Username

FDOVBACCT_COMPONENT_EXCHANGE_USERNAME

No

Username for a visual builder component exchange. Defaults to US oracle hosted exchange. Only neccessary if using buildApplication operation and you are using component exchange.

OVB Component Exchange Password

FDOVBACCT_COMPONENT_EXCHANGE_PASSWORD

No

Password for a visual builder component exchange. Default for US oracle hosted exchange is: bXwphh6RMFjn#g Only neccessary if using buildApplication operation and you are using component exchange.


Inputs

Input Name

Input Code

Required

Description

Oracle Visual Builder AccountFDOVB_INP_CLOUD_ACCOUNT_CODENoThe OVB account with all the required properties like Base URI, Username and Password for running OVB Instance.
Oracle Visual Builder Application Import OperationFDOVB_INP_OPERATION_TYPENoVisual builder operation (Blank, Stage or Publish) to be performed after successful import. Defaults to Publish

Outputs

Output Name

Description



Artifacts

This operation consumes the artifacts stored in 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.

Configuration Plans

Configuration plans are used to dynamically update the environment specific information for service endpoints used across the applications. VBCS application stores the server endpoint configuration for all the service connections in the json format under '/services/' directory. This operation utilizes one or more config plans ( explained below ) to update the appropriate server definition prior importing the resources to the target cloud instance. 

Configuration plans are expected to be available in the artifacts repository. You may choose to keep all the configuration plans in shared network location. However, design your workflow step to copy the required configuration plans from your shared location to the artifacts repository location (