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 at the top left of the header to get to the VB Studio navigator.
  2. In the VB Studio left navigator, click 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 at the top left of the header to get to the VB Studio navigator.
  2. In the VB Studio left navigator, click 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 and follow these steps:
     1. In Base URL, enter the base URL of the Oracle Cloud Applications instance.
     2. In Instance Name, update the instance's name if you want.
     3. In Username and Password, enter the credentials of a user who can access the Oracle Cloud Applications instance.
     4. Click Add.
     5. 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.

        Note:

        OAuth tokens (access and refresh) are typically cycled during regular use. If a token expires during extended periods of inactivity (say, when you're away on vacation), click Actions and select Renew OAuth Access to restart the OAuth workflow.

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