5 Oracle Analytics Server

RDS is provisioned with Oracle Analytics Server (OAS), offering Data Visualization and BI Publisher (also known as Analytics Publisher or BIP) capabilities. These tools are accessible through the Retail Home Application Navigator by selecting either Data Visualization or Analytics Publisher.

Access is protected by the same OCI IAM instance used throughout Retail Data Store and supports Single Sign-On (SSO). Further access control for both tools is managed through OCI Groups.

This section guides you through the steps required to configure access to OAS.

For more guidance on using Data Visualization and BI Publisher, see Visualizing Data in OAS.

Determining Your Tenant Name

Prerequisites

  • You have the Retail Home URL for each environment you plan to configure (for example, PROD, STG).
  • You can access Retail Home through a supported browser.

Steps to Identify the Tenant Name

  1. Navigate to Retail Home for the desired environment using the URL provided by your administrator.
  2. In the Application Navigator in the left-hand panel, click Data Visualization or Analytics Publisher.
  3. Observe the URL in your browser’s address bar. It will follow a structure similar to: https://<hostname>/<tenant-name>/...
  4. Identify the tenant name, which follows the hostname. For example, if the URL is: https://retail.example.com/acme/... then the tenant name is acme.
  5. You will use this tenant name as a prefix when assigning users to OAS access groups.

Setup Access to OAS

OAS access groups have the following form:

Group Name Priviliege
<tenante-name>-DVConsumer Data Visualization report viewing
<tenant-name>-DVContentAuthor Data Visualization report creation and maintenance
<tenant-name>-BIConsumer Analytics Publisher report viewing
<tenant-name>-BIContentAuthor Analytics Publisher report creation and maintenance

Note:

You cannot create additional roles for Data Visualization or Analytics Publisher. Nor can you alter the privileges granted to these roles.

Prerequisites

  • You have permission to manage IAM users and groups in the OCI tenancy.

  • You know the tenant name (for example, acme).

  • You know which users need access and their intended roles (viewer or content author; Data Visualization or BI Publisher).

Steps to Assign a User to an OAS Group

  1. Sign in to the OCI Console for your tenancy.

    Use the identity domain that Retail Data Store is deployed in.

  2. In the left navigation menu, go to: Identity & Security -> Domains.
  3. Click the domain where your Retail Data Store is deployed. If you’re unsure which one to use, ask your tenancy administrator.
  4. Click the User Management menu item. Groups will be found at the bottom of the page.
  5. Search for and select the group you want to assign the user to. Group names follow this pattern:
    • <tenant-name>-DVConsumer
    • <tenant-name>-DVContentAuthor
    • <tenant-name>-BIConsumer
    • <tenant-name>-BIContentAuthor
  6. In the group details, click the Users menu item.
  7. Search for users by name or email. Select the appropriate user by checking the box next to their name, then click Assign user to group.
  8. Repeat for additional users and groups as needed.

Assignment of OAS roles (OCI Groups) may take 15 minutes or more to propagate.