Add an Oracle Cloud Applications Instance to a Visual Application

If you want to populate a visual application's catalog with REST services from an Oracle Cloud Applications backend, you need to add the Oracle Cloud Applications instance to the same environment as your Visual Builder instance.

You can only add one Oracle Cloud Applications instance to an environment. The instance can reside either in the same identity domain as your VB Studio instance (current identity domain) or in a different identity domain. (The identity domain that your VB Studio instance belongs will be listed on the left under Identity.)

  • To add an Oracle Cloud Applications instance from your current identity domain:
    1. If you're in the Designer, click Go to project page icon at the top left of the header to get to the VB Studio navigator.
    2. In the VB Studio left navigator, click Environments Environments.
    3. Select an existing environment or create one.

      To create an environment, click Create Environment. In Environment Name and Description, enter a unique name and description, and click Create.

    4. In the environment's Service Instances tab, click + Add Instance.
    5. In the Add Service Instance dialog box, select Oracle Cloud Applications under Instance Type.
    6. Select Identity Domain under Add Instance Using.
    7. Select the Oracle Cloud Applications instance you want to add and click Add.
  • To add an Oracle Cloud Applications instance from another identity domain, you'll need the credentials of a user who can access the Oracle Cloud Applications instance. Identify a user who can connect and deploy to the Oracle Cloud Applications instance and get that user's credentials, then follow these steps:
    1. If you're in the Designer, click Go to project page icon at the top left of the header to get to the VB Studio navigator.
    2. In the VB Studio left navigator, click Environments Environments .
    3. Select an existing environment or create one.

      To create an environment, click Create Environment. In Environment Name and Description, enter a unique name and description, and click Create.

    4. In the environment's Service Instances tab, click + Add Instance.
    5. In the Add Service Instance dialog, select Oracle Cloud Applications under Instance Type.
    6. Select Application Credentials under Add Instance Using.
    7. In Base URL, enter the base URL of the Oracle Cloud Applications instance.
    8. In Instance Name, update the instance's name if you want.
    9. In Username and Password, enter the credentials of a user who can access the Oracle Cloud Applications instance.
    10. Under Authorization type, select OAuth 2.0 (default) or Basic to specify the type of authorization and click Add.

      Note:

      OAuth is the recommended authorization type. Use Basic authentication only if you run into issues with setting up an OAuth connection. To use Basic authentication, select Use Basic, then enter the credentials of a user who can access the test instance in Username and Password.

      With OAuth 2.0 selected as the Authorization Type, you may be prompted for authorization to acquire OAuth tokens for accessing the target instance. Click Authorize when prompted, then sign in with credentials to access the Oracle Cloud Applications instance.

      OAuth tokens (access and refresh) are cycled during regular use. A refresh token is used to obtain an access token whenever a user accesses the target instance. This refresh token is typically valid for seven days. (The token expiration time is set in the IDCS resource app and may be different based on your security requirements.) If the user authenticates with the target instance within the seven-day period, the active refresh token generates a new access token and a new refresh token. This cycle continues indefinitely as long as the refresh token stays valid. If the refresh token expires during extended periods of inactivity (say, when you're away on vacation), click Actions Three horizontal dots and select Renew OAuth Access.

The Oracle Cloud Applications instance added to your environment is now available to all visual applications in your project.

Note:

All visual applications in the project will use the Oracle Cloud Applications instance URL specified in the environment, but your visual app can be configured to use a different Oracle Cloud Applications backend by specifying a different instance URL under Backends in the Navigator's Services pane. The project-level backend configuration is ignored if you or another developer configures a different Oracle Cloud Applications backend.