1. Administering Oracle Visual Builder in Oracle Integration Generation 2
  2. Configure Tenant Settings
  3. Add a Connection to Oracle Cloud Applications

Add a Connection to Oracle Cloud Applications

The list of REST services in the service catalog of a visual application is retrieved from an Oracle Cloud Applications backend service. Specify the instance URL of the Oracle Cloud Applications backend service in the Tenant Settings page.

All visual applications in the tenant will use the Oracle Cloud Applications instance URL specified in Tenant Settings, but a visual application can be configured to use a different Oracle Cloud Applications backend service by specifying a different instance URL in the Backends tab (which you access from the Navigator's Services tab). The tenant-level backend configuration is ignored if you or a visual application developer configures a different Oracle Cloud Applications backend service in a visual application’s Backends tab.

The authentication choices available to configure a tenant-level Oracle Cloud Applications backend are:
  • Basic Auth: Uses a fixed username and password for authentication.
  • Oracle Cloud Account: Needs federation between Oracle Cloud Applications and Visual Builder.
  • Delegate Authentication (previously called Propagate Current User Identity): Same as Oracle Cloud Applications. That is, it needs federation between Oracle Cloud Applications and Visual Builder.
  • None: This assumes your Oracle Cloud Applications REST API can be called without any authentication, which is not usually the case.

See About Authentication and Connection Type in Developing Applications with Oracle Visual Builder in Oracle Integration Generation 2.

If the necessary prerequisites for setting a tenant-level Oracle Cloud Applications backend service are not available, then a visual application developer can set up a backend service at the visual application level where more options are available. Another option is for you (the service administrator) to configure the Oracle Cloud Applications backend with None and let the visual application developer override the authentication setting at the visual application level.

To specify an Oracle Cloud Applications service for the tenant:

  1. Open the instance’s Tenant Settings page.
  2. In the Services tab, click Create Backend, then choose Oracle Cloud Applications in the Create Backend dialog.

    Description of admin-settings-fa-url.png follows
    Description of the illustration admin-settings-fa-url.png

    When specifying the URL in the Tenant Settings, you (the service administrator) only need to provide the instance URL of the Oracle Cloud Applications backend service to retrieve the list of services.

  3. In the dialog, type the Server URL of the backend service, and configure other settings, such as security, as needed.
  4. (Optional) After you configure settings for the backend, add headers to the backend.
    Backend headers that you add will be applicable for any service connection to this backend, irrespective of the server or application profile that is used.
  5. Click Create.

    Visual Builder automatically discovers the interfaceCatalogs endpoint of the Oracle Cloud Applications backend, which retrieves the list of services and their metadata. This endpoint is typically in the form: 

    https://<My Oracle Cloud Applications Instance URL >/helpPortalApi/otherResources/latest/interfaceCatalogs

    This endpoint is publicly accessible without any authentication.

    If there is a problem creating the connection, verify the instance URL of the Oracle Cloud Applications instance.