Connect OAC with ADW

To connect OAC with ADW requires two configurations. One connection for use with DV and one for use with OAC Answers & Dashboards.

To create both connections, first download the Security Wallet from ADW and create the Admin Password (if not already done).

Prepare configuration of ADW

Download Wallet:

1) Go to ADW instance and click DB Connection Button

image

3) click Download Wallet

image

which stores the .zip file to you local drive:

image

This .zip file can already be extracted, since the tnsnames.ora and the cwallet.sso file are needed for later steps:

image

Set Admin Password

If not already done navigate to the ADB Service Console

image

and click Administration and set the Admin password:

image

Configure Connection for ADW of OAC (Answers & Dashboards)

To configure the connection to ADW for Answers and Dashboards of OAC navigate to the OAC Service with a similar URL like below:

https://***tenant.name***.analytics.ocp.oraclecloud.com/dv/ui?pageid=home

and click on Console:

image

click on Connections under Configuration and Administration

image

click on Upload wallet on the right Burger Menu:

image

This allows to upload the previously downloaded wallet from the hard drive (you may need to acknowledge a virus scan warning before):

image

After uploading the Wallet successfully a success message will be displayed:

image

After click the Burger Menu on the right again the button will now display “Replace Wallet” instead of “Upload Wallet”:

image

After the Wallet has been uploaded, the connection can be defined using the Create Button on the right. Within this Menu its important to select “Host, Port and Service Name” from the Connect Using dropdown Menu and enable SSL.

image

The Host, Port and Service name can be retrieved from the extracted tnsnames.ora file of the Wallet. This file can be opened in any editor to check the values:

image

The Connection will be displayed in the list:

image

A new metadata model can now be created and uploaded to OAC using this connection.

Configure Connection for ADW of DV (Data Visualisation)

On the Homepage of OAC click Data and select Connection:

image

click ADW from the available connection types:

image

specify the connection details and upload the extracted sso credential files from the wallet (cwallet.sso):

image

The connection will be displayed in the list of connections:

image

After the connection is established, a Data Set can be created using this Connection to ADW.

DVD: Filtering Measures based on conditions

Within Analytics we can define different types of Measures like discrete (raw) Measures or percentage or ratio Measures. For discrete measures we can also define a base measure and derived measures. E.g. within the HR domain we can define a Headcount Metric as the base metrics and a male, female and diverse Headcount as the derived measure. When adding up all male, female and diverse it should be identical with the (overall ) Headcount. Another example is within the Procurement domain where we can define an invoice amount and a invoice paid and invoice unpaid derived measure:

image

This break-down allows to further understand how a certain metrics is comprised.

Within Oracle Data Visualization there are two possible options to achieve this filtering.

  1. Using the Filter operator
  2. creating a case when statement

Using the Filter operator

The first option is to use the Filter operator within the formula editor:

image

Within the formula editor, a measure can be defined from a list of available measures, but it’s also possible to define new measure using a count aggregation on a attribute column like Invoice Number and add a filter on the dimension e.g. Paid Yes or No.:

image

However, when using this Filter function with a newly defined measure (like above using a count aggregate on Invoice Number) the filter is not applied in DVD, as can be seen in below screenshot were the count for # of invoices is identical to the count of # of invoices paid:

image

This might need to be considered a Bug, since this should apply the filter to the defined measure.

When using an available measure from the drop down list, the filter is correctly applied. E.g. when using the Value measure (representing the amount of the invoice) the filter can be applied for paid/unpaid using the Payment date attribute:

image

and correct application of the filter on the data set:

image

Thus, the Filter operator may only correclty work when using a actual measure available from the drop-down list and not with newly defined measures “on-the-fly” in the formula editor.

The alternative is to use a case when statement:

Case when statement

Since, the Filter operator doesn’t evaluate the filter correctly, the other option is to use a case when statement that counts the number of invoices if an invoice has been paid like below:

image

This formula checks if a Payment date is set and if a payment date is set then it uses the invoice Number for counting:

COUNT(DISTINCT case when PAYMENT_DATE is not null 
then INVOICE_NO 
else NULL end)

This formula (based on the case when statement) applies the intended filter on Payment date correctly and allows to calculate the derived measure.

image

To conclude

To apply filter for a measure that is not available from the data-set (defined in the Prepare Tab as a measure) use the case when logic to calculate based on a condition.

If a measure is available you may also use the predefined Filter operator from the formula editor.

DVD: difference in NULL Value handling

When using DVD Version Version 12.2.5.3.0-20190529084035

image

there is a difference in the handling of NULL values between the Preparation Tab and the Visualization Tap:

image

Within the Prepare Tab the NULL values are interpreted as empty strings, meaning if no Value is provided within the Source (e.g. a Database Table or an Excel Spreadsheet) then it is interpreted as a field with no content like ‘’, but not as a NULL value.

Below formula checks for NULL values using the IS NULL operator, but since null values are being interpreted as empty string, the evaluation is 1 for all values (of Payment date column):

image

when changing above formula from IS NULL check to a comparison of an empty string ‘’, the formula shows the below results were content is classified into 0 and 1:

image

The above figure shows the evaluation of the field by performing a check with an empty string ‘’. But, when switching from Prepare Tab to the Visualize Tab, the results do not coincide! The check for an empty string is not consistently evaluated, as shown below:

image

when using the empty string check on the Visualization Tab, every content of the Payment date field is evaluate to 1 (a value being present).

The Visualize Tab requires the IS NULL check to check for NULL values:

image

To conclude

If you want to check for NULL values use the IS NULL or IS NOT NULL operator despite the results shown within the Prepare Tab. There are some Known Issues with the current version of DVD and the handling of null values as documented to some extend (the document is only in respect to Excel files, but above scenario is tested on Oracle Database) in this Known Issue document (from Sept ‘19).

Link

Activate the Oracle Cloud after signing the contract (Order Document):

The Steps to initially activate the Oracle Cloud after purchasing are describes below:

https://docs.oracle.com/en/cloud/get-started/subscriptions-cloud/csgsg/activate-your-order-your-welcome-email.html

With the activation the customer chooses the Account Name (or actually Tenant Name) of their Service, that will be displayed in all subsequent URLs and in the background the Oracle Cloud is physically provided within the chosen Data Center region e.g. EMEA and the Cloud Console will be made available (via DNS configuration in the Oracle Cloud) with the specified Account Name and services like IDCS (Identity Domain Service) are started to maintain the User(s). The Person who conducts this initial activation is also the Cloud Service Administrator and from now on the only person to be able to add further Users as Cloud Service Administrators.

After completion of the steps from the activation link, the user receives another e-mail to his e-mail address with a provisioned user (from IDCS) and a new temporary password to change on the next login.

Provision individual Oracle Cloud Services, such as ADW

The steps to provision Services are described below:

https://www.oracle.com/webfolder/technetwork/tutorials/obe/cloud/adwc/OBE_Provisioning_Autonomous_Data_Warehouse_Cloud_bak/provisioning_autonomous_data_warehouse_cloud.html

Actions after signing in:

https://docs.cloud.oracle.com/iaas/Content/GSG/Tasks/signingin.htm

Link

Get Started with EPM Cloud Planning

https://www.oracle.com/webfolder/technetwork/tutorials/obe/cloud/epm/EPBCS/GetStartedWithPlanning/index.html

Additional guides:
Getting Started with Oracle EPM Cloud for Administrators: https://docs.oracle.com/en/cloud/saas/enterprise-performance-management-common/cgsad/index.html

Getting Started with Oracle EPM Cloud for Users: https://docs.oracle.com/en/cloud/saas/enterprise-performance-management-common/cgsus/index.html