Configure Advanced Options

You can set several advanced options using the Console.

About Advanced Configuration

Administrators can set more advanced, service-level options through the System Settings page.

Performance and Compatibility Options

You use these options to configure performance and compatibility settings between Oracle BI Enterprise Edition and Oracle Analytics. For example, you can set the maximum temporary file size.

System Setting More Information
Cache Enable

Specifies whether data query caching is enabled or disabled.

  • enabled — Data caching is enabled.

  • disabled — Caching is disabled.

Default: Enabled

Restart Required: Yes

Evaluate Support Level

Specifies who can issue database functions: EVALUATE, EVALUATE_ANALYTIC, EVALUATE_AGGR, and EVALUATE_PREDICATE.

By default (0), the EVALUATE database functions are disabled.

  • 1 — Service administrators only. Users with the BI Service Administrator application role can invoke EVALUATE database functions.

  • 2 — Anyone. Any user who signs in to Oracle Analytics can invoke EVALUATE database functions.

  • 0 (or any other value) — No one. All EVALUATE database functions are disabled in Oracle Analytics.

Valid Values: 0, 1, 2

Default: 0

Restart Required: Yes

OBIEE Compatibility Release

Specifies the on-premise Oracle BI Enterprise Edition version number for feature compatibility. This only applies if you upgrade from Oracle BI Enterprise Edition to Oracle Analytics, and you want to use a feature from a specific on-premise release in Oracle Analytics.

Valid Values: 11.1.1.9, 11.1.1.10, 11.1.1.11, 12.2.1.0, 12.2.1.1, 12.2.1.3, 12.2.1.4, 12.2.2.0, 12.2.3.0, 12.2.4.0, 12.2.5.0

Default: No value.

Restart Required: Yes

Maximum Working File Percent Size

Specifies that the temporary file doesn't exceed a specified percentage of the global work directory size limit.

The size limit defaults for temporary files is 5% (of 100 GB), equivalent to 5 GB. The file limit applies individually to each temporary file, while the size specified for the total global work directory applies collectively to all temporary files created.

You can increase or decrease this value within the range of 5% to 50%. This enables temporary file sizes between 5GB and 50GB. Raising this setting above 50% limits concurrency for large operations.

Valid Values: 5-50

Default: 5

Restart Required: Yes

Strong Datetime Type Checking

Specifies whether to enforce strict checking for date and time data types and whether to reject queries that contain incompatibilities in date and time data types.

  • enabled — Enforces strict checking for date and time data types.

  • disabled — Relaxes strict checking for date and time data types. However, invalid queries or queries with severe date and time incompatibilities may still be still rejected. For example, date and time incompatibilities might be rejected if your relational database uses strict checking for those data types.

Default: enabled

Restart Required: Yes

Recursive Datetime Type Checking

Specifies whether to enforce strict recursive data type checking for comparisons between identical data types (for example, integer to integer) or non-compatible data types (for example, integer to short integer) on all data sources or with all data sets.

  • enabled— Enforces strict recursive checking for identical or non-compatible data types on all data sources or data sets.

  • disabled— Relaxes strict recursive checking for date and time data types on all data sources or data sets. However, if there are too many data type inconsistencies, you may want to change the data types to be compatible or use constants of the correct data type when comparing a column to a value. For example, after you migrate content from Oracle BI Enterprise Edition 11g to Oracle Analytics, you might start seeing this type of check error in your reports because Oracle BI Enterprise Edition 11g didn't enforce strict checks:

    [nQSError: 22024] A comparison is being carried out between non-compatible types <type1> and <type2>.

Default: enabled

Restart Required: Yes

Disable Right Trim for VARCHAR Data

Specifies whether the automatic removal of trailing spaces from varchar columns is enabled (off) or disabled (on). For example, when this property is enabled (off), when a user starts entering values in a field, the filter dialog automatically trims any trailing spaces.

  • Off— Trims trailing whitespaces in varchar columns when processing queries. This is the default for Oracle Analytics. For example, if a user enters the text 'My Product ', it trims it to 'My Product'.

  • On— Preserves trailing whitespaces in varchar columns. If you primarily use Oracle Database sources, you might want to keep the default Oracle Database behavior of preserving trailing whitespaces rather than removing them. When you toggle this property on, you avoid the overhead of trimming spaces, and this can improve performance.

    Note:

    If you disable this property (on) and you construct a filter such as PRODUCT_DESCRIPTION = 'My Product '), you must make sure the amount of trailing whitespace used exactly matches the varchar column value. If you don't, the filter won't correctly match the data values.

Default: Off

Restart Required: Yes

Enable Subrequest Shipping

Specifies if sub-requests to source databases are executed separately as standalone queries or executed together. By default, sub-requests are shipped separately which can improve performance if you execute complex reports with a large group of sub-requests, that is, you prefer to ship the sub-requests separately in multiple simplified queries rather than ship a large single complicated query all at once.

Note:

In Oracle BI Enterprise Edition, the default was NO. If you used Oracle BI Enterprise Edition and want to retain the previous default behavior, set this property to NO so you can keep executing database sub-requests together.
  • Default — Database sub-requests are shipped separately. This is the same as the value YES.
  • YES — Database sub-requests are shipped separately.
  • NO — Database sub-requests are shipped together, all at once.

Default: Default

Restart Required: Yes

Analysis, Dashboard, and Pixel-Perfect Report Options

You use these options to set defaults and customizations for dashboards, analyses, and reports. For example, you can configure the analysis editor to open by default to the Criteria tab or the Results tab.

System Setting More Information
Portal Path

Specifies the URL of the dashboard page that's displayed by default when users sign in to Oracle Analytics.

This setting applies to all users, but users can override it after they've signed in.

Restart Required: Yes

Custom Links XML

Specifies the XML code containing Classic Home page header customizations.

You can use this XML code to customize the global header section of the Home page to better meet the needs of your users. For example, you can disable certain links or add custom ones.

Restart Required: Yes

Writeback Template XML

Defines the XML configuration for performing writeback on data elements.

For example, you can use an XML template to enable users of a dashboard page or an analysis with the ability to modify, or write back, the data that they see in a table view.

Restart Required: Yes

Answers Subject Area Sort Order

Sets the default sort order for subject area content trees. Users can override this default setting in the My Account: Subject Area Sort Order dialog.

  • asc — Sorts A to Z.

  • desc — Sorts Z to A.

  • rpd — Uses the subject area sort order specified in the original analyses.

Valid Values: asc, desc, rpd

Default: rpd

Restart Required: Yes

Answers Editor Start Tab

Specifies whether the analysis editor opens by default to the Criteria tab or the Results tab.

This setting applies when users click an Edit link for an analysis from a dashboard, the Home page, or the Catalog page.

Users can override this default setting by specifying the Full Editor option in the My Account dialog.

  • answerResults — Opens the analysis editor by default to the Results tab.

  • answerCriteria — Opens the analysis editor by default to the Criteria tab.

Valid Values: answerResults, answerCriteria

Default:answerResults

Restart Required: Yes

BIP Reporting Toolbar Mode

Configures an alternate toolbar for pixel-perfect reports that are included in a dashboard.

  • 1 — Don't display a toolbar for pixel-perfect reports.
  • 2 — Displays the URL to the report without the logo, toolbar, tabs, or navigation path.
  • 3 — Displays the URL to the report without the header or any parameter selections. Controls such as Template Selection, View, Export, and Send are still available.
  • 4 — Displays the URL to the report only. No other page information or options are displayed.
  • 6 — Displays parameter prompts for the report in a toolbar.
Valid Values: 1, 2, 3, 4, 6

Default: 1

Restart Required: Yes

Usage Tracking Options

You use these options to specify how you want to monitor system usage. For example, you can set the number of rows that you want stored in the usage tracking tables.

System Setting More Information
Usage Tracking Logical Query Logging Table

Specifies the name of the database table you want to use to store logical query details. For example, <database name>.<catalog name >.<schema name >.<table name> or <database name>.<schema name >.<table name>.

Default: No value.

Restart Required: Yes

Usage Tracking Physical Query Logging Table

Specifies the name of the database table you want to use to store physical query details. For example, <database name>.<catalog name >.<schema name >.<table name> or <database name>.<schema name >.<table name>.

Default: No value.

Restart Required: Yes

Usage Tracking Connection Pool

Specifies the name of the connection pool you created for your usage tracking statistics database. For example, <database name>.<connection pool name>.

Default: No value.

Restart Required: Yes

Usage Tracking Max Rows

Indicates the number of rows allowed in usage tracking tables, with a value of 0 indicating an unlimited number of rows.

Valid Values: Any positive number (up to 64-bit integer)

Default: 0

Restart Required: Yes

Usage Tracking Init Block Table

Specifies the name of the fully-qualified database table you use for inserting records that correspond to the initialization block statistics, as it appears in the physical layer of your data model file (RPD). For example, <database name>.<catalog name >.<schema name >.<table name> or <database name>.<schema name >.<table name>.

Default: No value.

Restart Required: Yes

Prompt Options

You use these options to configure prompt behavior in analyses and dashboards. For example, you can enable search results to automatically display as highlighted when users enter search parameters, without the need to click Search.

These options apply only to analyses and dashboards. They don't apply to data visualizations.

System Setting More Information
Support Auto Complete

Enables or disables the auto-complete functionality available in prompts.

  • Enabled — Enables auto-complete, which means that the Prompts Auto-Complete field is displayed and set to On in the My Account dialog and in the Dashboard Properties dialog.

  • Disabled — Disables auto-complete, which means that the auto-complete fields in the My Account and Dashboard Properties dialogs aren't available.

Default: Disabled

Restart Required: Yes

Case Insensitive Auto Complete

Specifies whether, when a user enters a prompt value in analyses and dashboards, the auto-complete functionality is case-insensitive.

  • Enabled — Case isn't considered when a user enters a prompt value such as "Oracle" or "oracle."

  • Disabled — Case is considered when a user enters a prompt value, so the user must enter "Oracle" and not "oracle" to find the Oracle record.

Default: Enabled

Restart Required: Yes

Show Null Value When Column Is Nullable

Specifies whether to show the term "NULL" at runtime in the column prompt above the column separator in the drop-down list when the database allows null values.

  • always — Always shows the term "NULL" above the column separator in the drop-down list.

  • never — Never shows the term "NULL" in the drop-down list.

  • asDataValue — Displays the data value in the drop-down list, not the term "NULL" above the separator in the drop-down list.

Valid Values: always, never, asDataValue

Default: always

Restart Required: Yes

Auto Apply Dashboard Prompt Values

Enables the option to hide the Apply button so that prompt values can be applied without clicking any button.

If this is property is Enabled:

  • Displays the Show Apply Button and Show Reset Button fields in the Edit Page Settings dialog.

  • Displays the Prompts Apply Buttons and Prompts Reset Buttons fields in the Dashboard Properties dialog.

  • Displays the Prompt Buttons on Current Page option on the dashboard builder's Tools menu.

Default: Enabled

Restart Required: Yes

Auto Search on Prompt Value Search Dialog

Enables search results to automatically display and highlight when users enter search parameters, without the need to click Search.

Default: Enabled

Restart Required: Yes

Format Options

You use these options to configure default currency and time zone settings for analyses and dashboards.

These options apply only to analyses and dashboards. They don't apply to data visualizations.

System Setting More Information
Currencies XML

Defines the default currency that's displayed for currency data in analyses and dashboards. For example, you can change from American dollars ($) to Euros (E).

Restart Required: Yes

User Currency Preferences XML

Determines whether users see a Currency option in their My Account preferences dialog and the list of currencies available to them. If you provide the Currency option, users can select in which currency they prefer to view columns of currency data in analyses and dashboards.

Restart Required: Yes

Default Data Offset Time Zone

Note:

This property only applies to Oracle Analytics Cloud - Classic.

Specifies a time zone offset of the original data that users see in analyses and dashboards. Enter an offset value that indicates the number of hours away from Greenwich Mean Time (GMT) time.

For example, to display values in United States Eastern Standard Time (EST), which is Greenwich Mean Time (GMT) - 5 hours, enter the value GMT-05:00 or the equivalent value in minutes -300.

If you don't set this option, no time zone conversion occurs because the value is "unknown".

Restart Required: Yes

Specifying a different offset value for each user

If you want to specify a different offset value where session variables can be used (for example, expressions, calculations), don't use the Default Data Offset Time Zone setting. Instead, set the system session variable DATA_TZ in the repository. See About Session Variables.

Default User Preferred Time Zone

Specifies a default preferred time zone that users see in analyses and dashboards before they select their own in the My Account Preferences dialog.

If you don't set this option, Oracle Analytics uses the local time zone.

Restart Required: Yes

Specifying a different time zone for each user

If you want to specify a different offset value where session variables can be used (for example, expressions, calculations), don't use the Default User Preferred Time Zone setting. Instead, set the system session variable TIMEZONE in the repository. See About Session Variables.

Default Time Zone for Date Calculations

Specifies the time zone used for evaluating date calculations such as getting the current date/time, truncating datetime values to a date, and extracting time fields from date/time expressions.

If you leave this field blank, Oracle Analytics uses the operating system time zone when evaluating date calculations.

Restart Required: Yes

View Options

You use these options to configure default search and viewing settings for users working with analyses and dashboards.

These options apply only to analyses and dashboards. They don't apply to data visualizations.

System Setting More Information
Prompt Auto Complete Matching Level

Specifies whether the auto-complete functionality uses matching to find the prompt value that the user enters into the prompt field. This setting doesn’t apply if the user accesses the Search dialog to locate and specify a prompt value.

  • StartsWith — Searches for a match that begins with the text that the user types. For example, the user types "M" and the following stored values are displayed: "MicroPod" and "MP3 Speakers System".

  • WordStartsWith — Searches for a match at the beginning of a word or group of words. For example, the user types "C" and the following values are displayed: "ComCell", "MPEG Camcorder", and "7 Megapixel Digital Camera".

  • MatchAll — Searches for any match within the word or words.

Valid Values: MatchAll, StartsWith, WordStartsWith

Default: MatchAll

Restart Required: Yes

Default Scrolling Enabled

Specifies how data scrolls in these views: table, pivot table, heat matrix, and simple and advanced trellis views.

  • Enabled — Data displays with a fixed header and content scrolling controls for users to browse the data.

  • Disabled — Data displays with content paging controls for users to browse the data.

Default: Enabled

Restart Required: Yes

View Interactions: Include/Exclude Columns

Specifies whether the Include/Exclude Columns option is selected by default in the Analysis Properties dialog: Interactions tab.

  • Enabled — The Include/Exclude Columns option is selected by default in the Analysis Properties dialog: Interactions tab.

  • Disabled — The Include/Exclude Columns option isn't selected by default in the Analysis Properties dialog: Interactions tab.

Default: Enabled

Restart Required: Yes

View Interactions: Display/Hide Running Sum

Specifies whether the Display/Hide Running Sum option is selected by default in the Analysis Properties dialog: Interactions tab.

  • Enabled — The Display/Hide Running Sum option is selected by default in the Analysis Properties dialog: Interactions tab.

  • Disabled — The Display/Hide Running Sum option isn't selected by default in the Analysis Properties dialog: Interactions tab.

Default: Disabled

Restart Required: Yes

View Interactions: Create/Edit/Remove Groups

Specifies whether the Create/Edit/Remove Groups option is selected by default in the Analysis Properties dialog: Interactions tab.

  • Enabled — The Create/Edit/Remove Groups option is selected by default in the Analysis Properties dialog: Interactions tab.

  • Disabled — The Create/Edit/Remove Groups option isn't selected by default in the Analysis Properties dialog: Interactions tab.

Default: Disabled

Restart Required: Yes

View Interactions: Move Columns

Specifies whether the Move Columns option is selected by default in the Analysis Properties dialog: Interactions tab.

  • Enabled — The Move Columns option is selected by default in the Analysis Properties dialog: Interactions tab.

  • Disabled — The Move Columns option isn't selected by default in the Analysis Properties dialog: Interactions tab.

Default: Enabled

Restart Required: Yes

View Interactions: Sort Columns

Specifies whether the Sort Columns option is selected by default in the Analysis Properties dialog: Interactions tab.

  • Enabled — The Sort Columns option is selected by default in the Analysis Properties dialog: Interactions tab.

  • Disabled — The Sort Columns option isn't selected by default in the Analysis Properties dialog: Interactions tab.

Default: Enabled

Restart Required: Yes

Name in Oracle BI Enterprise Edition: obips.Analysis.InteractionProperties.SortColumns

View Interactions: Display/Hide Sub-totals

Specifies whether the Display/Hide Sub-totals option is selected by default in the Analysis Properties dialog: Interactions tab.

  • Enabled — The Display/Hide Sub-totals option is selected by default in the Analysis Properties dialog: Interactions tab.

  • Disabled — The Display/Hide Sub-totals option isn't selected by default in the Analysis Properties dialog: Interactions tab.

Default: Disabled

Restart Required: Yes

View Interactions: Drill

Specifies whether the Drill (when not a primary interaction) option is selected by default in the Analysis Properties dialog: Interactions tab.

  • Enabled — The Drill (when not a primary interaction) option is selected by default in the Analysis Properties dialog: Interactions tab.

  • Disabled — The Drill (when not a primary interaction) option isn't selected by default in the Analysis Properties dialog: Interactions tab.

Default: Enabled

Restart Required: Yes

Name in Oracle BI Enterprise Edition: obips.Analysis.InteractionProperties.Drill

View Interactions: Add/Remove Values

Specifies whether the Add/Remove Values option is selected by default in the Analysis Properties dialog: Interactions tab.

  • Enabled — The Add/Remove Values option is selected by default in the Analysis Properties dialog: Interactions tab.

  • Disabled — The Add/Remove Values option isn't selected by default in the Analysis Properties dialog: Interactions tab.

Default: Disabled

Restart Required: Yes

View Interactions: Create/Edit/Remove Calculated Items

Specifies whether the Create/Edit/Remove Calculated Items option is selected by default in the Analysis Properties dialog: Interactions tab.

  • Enabled — The Create/Edit/Remove Calculated Items option is selected by default in the Analysis Properties dialog: Interactions tab.

  • Disabled — The Create/Edit/Remove Calculated Items option isn't selected by default in the Analysis Properties dialog: Interactions tab.

Default: Disabled

Restart Required: Yes

Table/Pivot View: Max Visible Rows

Specifies the maximum number of rows you want displayed for content paging in table and pivot table views in analyses and dashboards.

The minimum number of rows you can specify to display is 100.

Valid Values: 100-5000

Default: 5000

Restart Required: Yes

Connection Options

You use these options to configure connection defaults. For example, you can specify how often to synchronize the database connections defined in Console.

System Setting More Information
Connection Externalization Enabled

Specifies whether to externalize any database connections that administrators configured for data models in Oracle Analytics Cloud, using Console.

When you externalize the connection information, anyone who uses Oracle Analytics Developer Client Tool to edit data models can refer to the database connections “by name” rather than re-entering the connection details in full (connection pool settings). See Connect to a Data Source using a Connection Defined Through Console.

  • Enabled — Externalize the database connections that administrators define for data models through Console.

  • Disabled — Don't externalize database connections details. Anyone using Oracle Analytics Developer Client Tool to edit data models must enter the database connection information in the Connection Pool dialog.

Default: Enabled

Restart Required: Yes

Connection Externalization Polling Interval

Specifies how often Oracle Analytics Cloud synchronizes database connections defined in Console. Enter a suitable polling interval, in seconds. By default, database connections are synchronized every 180 seconds.

This property is used only when Connection Externalization Enabled is set to yes.

Valid Values: 60-3600

Default: 180

Restart Required: Yes

Security Options

Use Security options to control how users can perform specific actions in analyses and dashboards.

These options apply only to analyses and dashboards. They don't apply to data visualizations.

System Setting More Information
Enforce Safe Domains in Actions

Determines whether action links that users add to analyses and dashboards can invoke any URL or only URLs that administrators specify in the safe domains list.

  • Enabled — Don't allow actions to invoke any URL that's not in the safe domain list.
  • Disabled — Allow actions to invoke any URL, even if the URL isn't listed as a safe domain.

Default: Enabled for a brand new service and Disabled for an existing service.

Restart Required: No

Allow HTML Content

Determines whether the Contains HTML Markup option is displayed in various dialogs and editors where you can apply formatting. This option allows users to format content with valid HTML markup.

  • Enabled — Display the Contains HTML Markup option in various dialogs where additional formatting might be useful. For example:

    • For analyses: In the analysis editor, Analysis Properties dialog, Column Properties dialog, New Calculated Measure dialog.
    • For dashboards: In the Dashboard Properties dialog.
  • Disabled — Hide the Contains HTML Markup option. Users can enter only plain text.

Default: Disabled

Restart Required: Yes

URL for Browser Script Actions

Specifies the URL for the JavaScript file containing custom Browser Script Actions.

Default: No value.

Restart Required: Yes

Set Advanced Options

Use Console to set advanced options for Oracle Analytics.

  1. Click Console.
  2. Click System Settings.
  3. Update the property value.
  4. If required, click Restart and then click OK to confirm.
    Wait a few moments for the changes to refresh through the system.