8 Filter Data

Use filters in Oracle Analytics to focus the data in your workbooks and create an effective and interactive experience for your consumers.

About Filters

Filters reduce the amount of data shown in visualizations. Oracle Analytics lets you filter the data in your workbooks in many different ways and configure the filter properties to customize the experience for your consumers.

Filter Scopes

You can apply filters at four different scopes in your workbook in Oracle Analytics, from broadly filtering the entire workbook down to filtering a single visualization on a canvas.

You can apply filters at the following levels:

  • Workbook - A workbook filter is pinned in the filter bar and applies to all canvases in the workbook. See Use the Filter Bar.
  • Canvas - A canvas filter is unpinned in the filter bar and applies only to a single canvas in the workbook. See Use the Filter Bar.
  • Dashboard - A dashboard filter is used directly on a canvas to enable consumers to interact with and filter data on the canvas. See Use Dashboard Filters.
  • Visualization - A visualization filter is used directly on a visualization and applies only to that visualization. See Use Visualization Filters.

Filter Types

Oracle Analytics supports many different types of filters that you can use depending on the filter scope and the data element you're using to filter.

Filter Type Description
List

A list filter can be applied to data elements that are text and date data types, and number data types that can't be aggregated. A list filter provides a simple list of values to choose from and lets you see which values are selected and which aren't. They work well for attributes with a long list of values.

Availability: List filters are available for all filter scopes.

Properties:
  • Multi Select
  • Default Value
  • Exclude
  • Nulls
  • Disable
  • Selection Parameter Binding
  • Excludes Mode Parameter Binding
For more information about these properties, see Dashboard Filter Control Properties.

Limitations: While list filters don’t have a limit to the number of values they can display, performance can decline if more than 10,000 values are selected.

List box

A list box filter is similar to a list filter and can be applied to text, uncountable values, and dates. It also provides a simple list of values but only lets you select one or All.

Availability: List box filters are available only for dashboard filters.

Properties:
  • Custom Values
  • Default Value
  • Exclude
  • Nulls
  • Selection Parameter Binding
  • Excludes Mode Parameter Binding
For more information about these properties, see Dashboard Filter Control Properties.
Limitations:
  • You can't disable a list box filter.
  • Multi Select isn't available for list box filters.
Checkbox / Radio Button

A checkbox or radio button filter can be applied to text, uncountable values, and dates. When Multi Select is on, the filter uses a checkbox, and when it's off, the filter uses a radio button.

Availability: Checkbox or radio button filters are available only for dashboard filters.

Properties:
  • Multi Select
  • Default Value
  • Exclude
  • Nulls
  • Visible Values
  • Selection Parameter Binding
  • Excludes Mode Parameter Binding
For more information about these properties, see Dashboard Filter Control Properties.
Limitations:
  • By default, this filter type is optimized to display only the first 50 data values. For a filter column with more than 50 values, Oracle recommends that you use a different filter type, for example a list box filter.
  • You can't disable a checkbox or radio button filter.
Top Bottom N

A top bottom N filter can be applied to measure and attribute data elements. For example, you might filter a visualization by the top 10 customers based on sales.

Availability: Top bottom N filters are available for all filter scopes.

Properties:
  • Method - Specifies whether to filter by Top (highest values) or Bottom (lowest values).
  • Count - Specifies the number of values to display.
  • By - Specifies which measure or attribute to limit by.
Range

A range filter can be generated for data elements that are number data types and that have an aggregation rule set to something other than none. Range filters are applied to data elements that are measures, and that limit data to a range of contiguous values, such as revenue of $100,000 to $500,000. Or you can create a range filter that excludes (as opposed to includes) a contiguous range of values. Such exclusive filters limit data to noncontiguous ranges (for example, revenue less than $100,000 or greater than $500,000).

Availability: Range filters are available for all filter scopes.

Properties:

  • Start - Specifies the minimum value.
  • End - Specifies the maximum value.
  • By - Specifies which measure or attribute to limit by.
Date Range

A date range filter uses calendar controls to adjust time or date selections to limit data to a specific period of time. You can either select a single contiguous range of dates, or you can use a date range filter to exclude dates within the specified range.

Availability: Date range filters are available for all filter scopes.

Properties:

  • Range - Requires a start and end date to filter on.
  • Start at - Requires only a start date to filter from.
  • End at - Requires only an end date to filter to.
  • Equal - Requires a specific date to filter on.
Relative Time

A relative time filter focuses on values for a specified time period relative to today or end of last period. For example, you can focus on the last three years, the next three years, or year to date through the last fiscal period.

The current date and time used in queries is the Oracle Analytics server host's date and time in the server's timezone (not the browser host's time or timezone).

Availability: Relative time filters are available for all filter scopes.

Properties:
  • Type - Specifies whether the filter is relative to a past or future time period, or to today's date.
    • Last - Uses the Increment and Time Level values to specify a time period up to either today's date or the end of the last period.

      Last filters that are based on a DateTime column and which have a grain of Day or longer (for example, Year, Quarter, Month, Week, Day), retrieve data from the same time of day on the starting day. For example, if the server date/time is currently Thursday 3:15pm , a Last 2 Days filter on a DateTime column retrieves data with timestamps between Tuesday 3:15pm and Thursday 3:15pm in the server's timezone. Filter queries that are based on a Date column (which by definition have no time of day associated) only depend on the server host's date, not the time of day.

    • Next - Uses the Increment and Time Level values to specify a time period after either today's date or the start of the next period.
    • To Date - Use the Time Level value to specify the time period from the beginning of the Time Level value up to today's date. For example, Month to Date retrieves data from midnight of the first day of this month up until the current date and time (that is, Today).
  • Increment - Specifies the increment of the unit of time to use for the filter.
  • Time Level - Specifies the unit of time to use for the filter.
  • Relative To - Specifies whether the filtered data is relative to Today, Start of Next Period, or End of Last Period.

Limitations: You can apply a relative time filter only to date columns that already exist in the data source, not to derived columns such as Year, or Quarter. The relative time filter type supports Date and DateTime column types.

Slider

A slider filter can be used to animate visualizations and show dynamically how your data changes over a given dimension such as time. A slider filter can be applied to text, uncountable values, and dates.

Availability: Slider filters are only available for dashboard filters. See Filter and Animate Visualizations Using a Slider Dashboard Filter.

Properties:
  • Font - Value and Label
  • Auto Play - On, Off, Speed, and Repeat
For more information about these properties, see Dashboard Filter Control Properties.
Limitations:
  • You can't disable a slider filter.
  • Parameter binding isn't available for slider filters.

To change the filter type of an existing filter, see Change the Filter Type.

The following filter options are also available in Oracle Analytics:

How the Number of Datasets Affects Filters

Filters can interact differently with visualizations depending on the number of datasets and whether the datasets are joined.

If there's a single dataset in a workbook, and you add a filter, there are no restrictions on which data the filter applies to.

If a workbook contains multiple datasets, make sure that they're joined if you want to use data elements from one dataset as filters in your workbook. Filters based on data elements from one dataset don't work on visualizations using data from another dataset if the datasets aren't joined.

Ways to Use Parameters with Filters

In Oracle Analytics, you can use parameters and filters together to dynamically manipulate the data in your workbook.

Use parameters and filters together in the following ways:

If you use a parameter as a filter, keep in mind that parameters have a limit of 10,000 available values that can be cached and also a limit of 1,000 initial values.

You can also use a parameter and a filter together to conditionally show or hide visualizations on a canvas based on a user's selections. See Use a Parameter to Conditionally Show or Hide a Visualization.

How Do Filters Limit Each Other?

The topics in this section explain how different filters limit each other in workbooks in Oracle Analytics.

About the Limit Values Settings for Filters

In Oracle Analytics, the selections you make for one filter can impact the values available to select from for other filters, depending on the filter location and the limit values settings.

Limit Values Setting Levels

Before you add filters and selection steps to your workbook, it's important to understand how the limit values settings cascade and affect each other.

Level Location Description
1 Console

Your administrator sets the Oracle Analytics Default Limit Values By for Filters system setting.

This is the highest-level limit values setting and is applied to all workbooks. You can override this setting at various levels within a workbook.

The option chosen by the administrator is used as the default setting in the filter bar.

2 Filter bar

The filter bar inherits the system setting by default but you can use the Limit Values By setting for the filter bar to override the system setting.

The setting you specify in the filter bar is applied to all filters and selection steps in the filter bar.

See Specify Limit Values By for the Filter Bar.

3 Individual filters and selection steps in the filter bar

Any filters and selection steps that you add to the filter bar inherit the Limit Values By setting selected for the filter bar.

You can select an individual filter or selection step and use Limit Values to override the filter bar's setting for that particular item.

This setting level isn't available for individual parameters used in the filter bar.

See Specify Limit Values for Workbook, Canvas, or Visualization Filters.

4 Dashboard filters

Dashboard filters are limited by the workbook or canvas filter selections depending on the Limit Values By setting on the filter bar and the Limit Values setting on the individual workbook or canvas filters.

You can select an individual dashboard filter and use Limit Values to override the workbook or canvas filters' or filter bar's setting.

This setting level isn't available for parameters used as dashboard filters.

See Specify Limit Values By for Dashboard Filters.

5

Visualization filters

Visualizations display data according to the limitations you set for any existing workbook, canvas, and dashboard filters. If you add a visualization filter for the same column as a dashboard filter or a filter in the filter bar, the visualization filter is limited by the filter selections for that dashboard filter or filter in the filter bar.

Limit Values Setting Options

The following options are available depending on whether you're configuring the Limit Values By setting for the filter bar, or the Limit Values setting for individual filters and selection steps in the filter bar or for dashboard filters.

Option Description
Default

For the filter bar, uses the Default Limit Values By for Filters system setting that your administrator set.

For individual workbook or canvas filters in the filter bar, uses the Limit Values By setting from the filter bar.

Doesn't apply to selection steps.

For dashboard filters, uses the Limit Values By setting from the filter bar. Or if the canvas contains a workbook or canvas filter and a dashboard filter that use the same column, the default uses the Limit Values setting for the workbook or canvas filter.

This option is enabled by default for workbook, canvas, and dashboard filters.

Auto

For both the filter bar and individual workbook or canvas filters in the filter bar, limits the filter selection values by the other filter selections in the filter bar.

Doesn't apply to selection steps.

For dashboard filters, limits the filter selection values by the other dashboard filter and workbook or canvas filter selections.

None

For both the filter bar and for individual filters and selection steps in the filter bar, doesn't limit the selection values by the other selections in the filter bar.

For dashboard filters, doesn't limit filter selection values by the other dashboard filter and filter bar selections.

Filter Name

For individual filters and selection steps in the filter bar, uses the selected selection step, workbook, canvas, or dashboard filter's selections to limit selection values.

For dashboard filters, uses the selected selection step, workbook, canvas, or other dashboard filter's selections to limit selection values.

You can choose more than one.

Example Using Filters

Suppose you have the following filters in your workbook:
  • Workbook (pinned) filters: Customer Segment and Customer Name
  • Dashboard filters: Customer Segment and City
  • Visualization filter: Ship Date
If the filter bar's Limit Values By is set to Auto and you select values for the Customer Segment workbook filter:
  • Only the customer names associated with the chosen customer segments are available for selection in the Customer Name workbook filter. You can override this by setting the Customer Name workbook filter's Limit Values to None or another specific filter.
  • The Customer Segment dashboard filter inherits the values selected for the Customer Segment workbook filter. You can override this by setting the dashboard filter's Limit Values to None or another specific filter.
  • Only the cities associated with the chosen customer segments are available for selection in the City dashboard filter. You can override this by setting the dashboard filter's Limit Values to None or another specific filter.
  • Only the ship dates associated with the chosen customer segments are available for selection in the Ship Date visualization filter. You can't override this at the visualization filter level.

Specify Limit Values By for the Filter Bar

Configure the Limit Values By setting for the filter bar to specify how any workbook filters, canvas filters, and selection steps in it get their selection values.

This setting doesn't apply to any parameters in the filter bar.
  1. On the Home page, hover over a workbook, click Actions, then select Open.
  2. Click Filter Bar Menu, then hover over Limit Values By Filter Bar Menu icon .
  3. Click an option to select it.
  4. Click Save.

Specify Limit Values for Workbook, Canvas, or Visualization Filters

Configure the Limit Values setting for individual workbook filters, canvas filters, or visualization filters to specify how a filter gets its selection values.

To specify the limit values for selection steps, see Specify Limit Values for Selection Steps.

  1. On the Home page, hover over a workbook, click Actions, then select Open.
  2. Click the filter to open the Filter dialog.
  3. Click Limit Values Limit Values icon and click an option to select it.
  4. Click Save.

Specify Limit Values By for Dashboard Filters

Configure the Limit Values By setting for individual dashboard filter controls to specify how a filter gets its selection values.

If the dashboard filter control is one of the following filter types, you can alternatively open the Filter dialog and use the Limit Values option there:
  • List
  • Range
  • Date Range
  • Relative Time

To specify the limit values for selection steps, see Specify Limit Values for Selection Steps.

  1. On the Home page, hover over a workbook, click Actions, then select Open.
  2. Click the dashboard filters visualization to select it.
  3. Click Properties to open the Properties pane, then click Filter Controls.
  4. Expand the filter you want to set the Limit Values By for.
  5. In the Limit Values By row, click Default and select how you want to limit the filter's selection values.

  6. Click Save.

Specify Which Filters to Apply to a Visualization

When you add a visualization to a workbook, Oracle Analytics applies all the existing workbook, canvas, and dashboard filters to it. You can use the Filter This Viz By property to specify which of the filters you don't want to apply to a visualization.

You can also configure this property for dashboard filter visualizations.

Any selection steps that affect the visualization are also available to choose to from using this property.

  1. On the Home page, hover over a workbook, click Actions, then select Open.
  2. Click a visualization to select it.
  3. Click Properties to open the Properties pane, then click Filters.
  4. In the Filter This Viz By section, deselect the filters or selection steps you don't want to apply to the visualization.

  5. Click Save.

Apply a Dashboard Filter to Visualizations on the Canvas

When you add a dashboard filter, Oracle Analytics applies it to all visualizations on the canvas. You can specify which of the visualizations you don't want to apply the dashboard filter to.

  1. On the Home page, hover over a workbook, click Actions, then select Open.
  2. Click the dashboard filters visualization to select it.
  3. Click Properties to open the Properties pane, then click Filters.
  4. In the Apply This Filter To section, deselect the visualizations that you don't want the filter to apply to.

  5. Click Save.

Filter Properties

You can customize the appearance and functionality of filters in Oracle Analytics by setting the filter properties. The options available depend on the filter scope, filter type, and other property settings.

Dashboard Filter General Properties

You can modify these properties found under the General tab in the Properties pane to customize the appearance of your dashboard filters visualization.

These properties are available depending on the filter type and other property settings you're using. These properties are also available for selection steps used as dashboard filter controls.

Property Description
Title

Specifies whether the visualization title is displayed and how it's generated.

Options
  • Auto - Generates a title based on the column names used in the visualization.
  • Custom - Lets you create your own title.
  • None - Doesn't display a title.
Title Font

If the Title property is set to Auto or Custom, specifies the font formatting used for the visualization title.

Options - The default is Auto, or you can modify the following properties:
  • Font
  • Size
  • Style
  • Color
Title Tooltip

If the Title property is set to Auto or Custom, specifies whether the visualization title is displayed in a tooltip and how it's generated.

Options
  • Auto - Uses the visualization title
  • Custom - Lets you create your own tooltip title.
  • None - Doesn't display a title.
Filter Style

Specifies how the filter controls are displayed.

Options
  • Standard - Displays the name of the filtered data element above the filter selector.
  • Filter Chip - Displays dashboard filters in a compact style where the filter selector is hidden. This option merges the filtered data element name and the filter selector and provides a count of any selected values.

See Change the Dashboard Filter Style.

Show Values If the Filter Style is set to Filter Chip, specifies whether the filter values are displayed. You can hide the filter values when you need canvas space.
Label Font

Specifies the font formatting used for the filter control labels.

Options - The default is Auto, or you can modify the following properties:
  • Font
  • Size
  • Style
  • Color
Label Location

Specifies the placement of the filter control labels in relation to the filter selectors.

Options
  • Before
  • After
  • Above
Values Font

Specifies the font formatting used for the values displayed in the filter selectors.

Options - The default is Auto, or you can modify the following properties:
  • Font
  • Size
  • Style
  • Color
Orientation

Specifies the orientation of the visualization itself.

Options
  • Vertical
  • Horizontal
  • Auto - Automatically chooses the orientation based on the visualization's position and the space available on the canvas.

See Change the Orientation of Dashboard Filters.

Wrap

Specifies whether the filter controls stay on one line or wrap within the visualization.

Max Control Width

Specifies the maximum width of the filter controls within the visualization as displayed to consumers.

Options
  • Auto
  • Fill
  • Custom - You can specify a width of 121 or greater.
Control Style

Specifies the formatting of the filter controls.

Options - The default is Auto, or you can select Custom to modify the following properties:
  • Color - Changes the color of the filter selectors.
  • Transparency - Changes the transparency of the color applied to the filter selectors.
  • Outline - Hides or displays the outline for the filter selectors.
Buttons

Specifies whether the Reset or Apply buttons are available for consumers to use when selecting dashboard filters.

Options
  • Reset - Consumers can click the button to clear their filter value selections and reset the filters to their original state.
  • Apply - If the Apply button is visible, filter value selections aren't applied until the user clicks the button.
Align

Specifies the alignment of the filter controls inside the dashboard filters visualization.

Visibility Parameter

Specifies whether the visualization is always displayed or conditionally hidden for the consumer based on the selected value of a parameter. For more information, see Use a Parameter to Conditionally Show or Hide a Visualization.

Background

Specifies the formatting of the visualization background.

Options - The default is Auto, or you can click Custom to modify the following properties:
  • Fill Color - Changes the background color.
  • Color Transparency - Changes the transparency of the color applied to the background.
  • Image Source - Adds an image as the background using either a URL or an uploaded file.
Border

Specifies whether the visualization has a border and the format of the border.

See Set Visualization Border Properties.

Shadow

Specifies whether the visualization has a shadow and the format of the shadow.

See Set Visualization Shadow Properties.

Size and Position

If the canvas layout is set to Freeform, specifies the size and position of your visualization on the canvas.

Options
  • Width
  • Height
  • X Position
  • Y Position

Dashboard Filter Date/Time Properties

You can modify these properties found under the Date/Time tab in the Properties pane for dashboard filters visualizations that use a date or time column.

Property Description
Show By For date columns in a dataset, specifies the time intervals in which the filter values available to select are displayed.
Format Specifies the format of the values based on the selection for Show By.

Dashboard Filter Control Properties

You can modify these properties found under the Filter Controls tab in the Properties pane to customize the appearance and functionality of your dashboard filters visualization.

These properties are available depending on the filter type and other property settings you're using.

Property Description
Filter Type

Specifies the type of filter to use based on the data element you're using as a filter.

See Filter Types.

Label

Specifies how the filter control label is generated and whether it's displayed.

Options
  • Auto - Generates a label based on the data element being used as the filter.
  • Custom - Lets you create your own label.
  • None - Doesn't display a label.
Value Font

If the filter type is Slider, specifies the font formatting used for the values displayed in the slider filter control.

Options - The default is Auto, or you can modify the following properties:
  • Font
  • Size
  • Style
  • Color
Slider Label Font

If the filter type is Slider, specifies the font formatting used for the slider filter control label.

Options - The default is Auto, or you can modify the following properties:
  • Font
  • Size
  • Style
  • Color
Play

If the filter type is Slider, specifies whether the slider filter control is animated automatically.

Options - If Play is set to On, the following options are available on the slider filter control:

  • Speed
  • Repeat

See Filter and Animate Visualizations Using a Slider Dashboard Filter.

Multi Select

If the filter type is List or Checkbox / Radio Button, specifies whether more than one value can be selected in the filter control.

See Disable Multi Select for Filters.

Custom Values

If the filter type is List Box, specifies whether users can type a value into the filter's value selection field.

Null Selection

If the filter type is List Box or Checkbox / Radio Button, specifies whether the <NULL> option is included in the filter's value selection list. For list filters, the Nulls option is available in the filter dialog.

See Include Null Filter Values.

Exclude Selection

If the filter type is List Box or Checkbox / Radio Button, specifies whether values selected in the filter's value selection list are excluded or not. For list filters, the Exclude option is available in the filter dialog.

See Exclude Selected Filter Values.

Default Value

If the filter type is List, List Box, or Checkbox / Radio Button, specifies whether the filter control has a default value and what it is.

Options
  • First in List
  • Custom
  • None
Selection Required

If the filter type is List, List Box, or Checkbox / Radio Button, specifies if the user is required to select a filter value.

Limit Values By

Specifies how the dashboard filter control gets its selection values.

See Specify Limit Values By for Dashboard Filters.

Visible Values

If the filter type is Checkbox / Radio Button, specifies how many value selection options are displayed.

Options
  • Fit - Displays the first 50.
  • Custom - You can choose a number to display from 1-50.
Selection Parameter Binding

If the filter type is List Box or Checkbox / Radio Button, specifies whether a parameter is bound to the filter. For all other filter types, the Bind to Parameter option is available in the filter dialog.

See About Binding Parameters to Filters.

Excludes Mode Parameter Binding

If the filter type is List Box or Checkbox / Radio Button, specifies whether the filter excludes data values and is bound to an excludes parameter. For list filters, this option is available in the filter dialog.

See Create and Bind a Parameter to Exclude Filter Values.

Consumer Interactivity

Specifies the level of control consumer users have over the selection steps. Available for selection steps used in dashboard filters.

See Control Consumer Interactivity for Selection Steps.

Dashboard and Visualization Filters Properties

You can modify these properties found under the Filters tab in the Properties pane for dashboard filters visualizations and for visualizations using visualization filters or selection steps.

These properties are available depending on the visualization, filter type, and other property settings you're using.

Property Description
Visualization Filter Bar

Specifies whether the Visualization Filter Bar is displayed on the visualization.

To hide individual filters or selection steps in the Visualization Filter Bar, see Show or Hide a Visualization Filter in Present.

Use as Filter

Indicates whether a visualization is used as a filter on the canvas. The Use as Filter icon is green when the visualization is active as a filter.

See Use a Visualization as a Filter.

Show Filter Toggle

Specifies if the Use as Filter icon is visible on the visualization itself when the visualization is being used as a filter.

Titles Font

Specifies the font formatting used for the filter labels.

Options - The default is Auto, or you can modify the following properties:
  • Font
  • Size
  • Style
  • Color
Selections Font

Specifies the font formatting used for the displayed filter values.

Options - The default is Auto, or you can modify the following properties:
  • Font
  • Size
  • Style
  • Color
Label

Specifies how the filter label is generated and whether it's displayed.

Applies to visualization filters.

Options
  • Auto - Generates a label based on the data element being used as the filter.
  • Custom - Lets you create your own label.
  • None - Doesn't display a label.
Multi Select

Specifies whether more than one value can be selected if the data element being used as the filter is text, uncountable values, or dates.

Applies to only visualization filters.

See Disable Multi Select for Filters.

Filter This Viz By Indicates what the visualization is filtered by. The options available include workbook, canvas, and dashboard filters, and selection steps.
Apply This Filter To

Specifies which visualizations the dashboard filters apply to.

See Apply a Dashboard Filter to Visualizations on the Canvas.

Consumer Interactivity

Specifies the level of control consumer users have over the selection steps. Available for selection steps used directly on a visualization.

See Control Consumer Interactivity for Selection Steps.

Use Filter Personalizations

This topic describes how filter personalizations work and how you can manage them in a workbook.

About Filter Personalizations (For Authors)

A consumer's selected filter values are persisted when they close and re-open a workbook so they can easily pick up where they left off.

By default, personalizations are enabled for each workbook. As a workbook author, you can update the workbook's presentation flow to specify if the filter values persist when the user reopens the workbook. See Specify Personalization Options in Present.

Consumers make filter personalizations by changing the filter value selections for any filters and selection steps that are available to them. This includes dashboard filters, visualization filters, using visualizations as filters, parameters as filter controls, and parameters bound to dashboard filters. Filter personalizations don't apply to items in the filter bar. As the author, you control which filters and filter functionalities are available to consumers. See Set the Workbook Properties in Present, Set Canvas Properties in Present, and Control Consumer Interactivity for Selection Steps.

Consumers can configure a workbook to always open in a specific state, or they can choose which state to apply after they open the workbook.

The following workbook states are available:
  • Original State - This is the state in which you, as the workbook author, last saved the workbook.
  • Last State - This is the state the workbook was in when the consumer last made filter personalizations.
  • Custom State - This is a state the consumer creates by making filter personalizations and then saving and naming the state.
Workbook states are automatically purged as follows for a consumer instance:
  • Every 90 minutes: The least used custom states when there are more than 15 custom states
  • As applicable: Any states that haven't been used in the last year

Keep in mind that if you disable or delete a filter or selection step for the workbook, a consumer's personalizations are impacted which means their custom states may no longer work.

Note:

If you rename a workbook or move it to a different catalog folder, any custom workbook states are lost.

About Filter Personalizations (For Consumers)

Your selected filter values are persisted when you close and re-open a workbook so you can easily pick up where you left off.

You make filter personalizations by changing the filter value selections for any filters and selection steps that are available to you. Filter personalizations don't apply to items in the filter bar.

You can also configure a workbook to always open in a specific state, or you can choose which state to apply after you open the workbook.

The following workbook states are available:
  • Original State - This is the state in which the workbook author last saved the workbook.
  • Last State - This is the state the workbook was in when you last made filter personalizations.
  • Custom State - This is a state you create by making filter personalizations and then saving and naming the state. You can create up to 15 custom states.

Note:

If you rename a workbook or move it to a different catalog folder, any custom workbook states are lost.

This tutorial shows you how to manage your workbook states. Tutorial icon Tutorial

Create a Workbook State with Persisted Filter Values

Save a workbook state after making filter selections so you can access the workbook in that state in the future without having to reset any filter values.

  1. On the Home page, hover over a workbook, click Actions, then select Open.
  2. Make filter selections for the available filters to refine the data to suit your needs.
  3. Click State Menu State Menu icon, then click Save State.
  4. In the Save State dialog, give your state a name.

  5. Optional: Select Set as default state if you want the workbook to open in this state the next time you open it.
  6. Click Save.
Your saved state is now available to select in the Apply State drop-down list from the State Menu.

Modify a Custom Workbook State

You can modify your existing custom workbook states without having to create new ones.

  1. On the Home page, hover over a workbook, click Actions, then select Open.
  2. Click State Menu State Menu icon, then click Apply State and ensure the state you want to modify is selected.
  3. Modify the filter selections in the workbook to suit your needs.
  4. Click State Menu State Menu icon, then click Save State.
  5. In the Save State dialog, open the drop-down list and select the current state.

  6. Click Save.
  7. Click Overwrite to confirm you want to update the existing state.
  8. Optional: Click State Menu State Menu icon, then click Manage States.
  9. Click the custom state and modify the name if required.
  10. Click Done.
Your custom state is now updated with your changes.

Change the Workbook State

Select a different workbook state so you can view the workbook with specific filter selections applied.

  1. On the Home page, hover over a workbook, click Actions, then select Open.
  2. Click State Menu State Menu icon, then click Apply State.
  3. Click one of the available states to apply the associated filter selections.

Set the Default Workbook State

Set a workbook state to be the default state when you open the workbook.

If you set the default state to Last State, the workbook opens in whichever state it was in when you last closed it.

The Undo Last Edit and Redo Last Edit options in the workbook toolbar don't affect any changes you make in the Manage States dialog.

  1. On the Home page, hover over a workbook, click Actions, then select Open.
  2. Click State Menu State Menu icon, then click Manage States.
  3. In the Manage States dialog, hover over the state you want to set as the default state and click the checkmark beside it.

  4. Click Done.

Use the Filter Bar

You can use the filter bar to broadly limit the data on a specific canvas or all canvases in a workbook. For example, limit the data to the year 2024.

About the Filter Bar

You can add workbook filters, canvas filters, selection steps, and parameters to the filter bar.

These items in the filter bar are generally the first level of filtering that you add to a workbook. You can then add other levels to fine tune the data, for example, add dashboard filters that allow consumers to select their own filter values, or add visualization filters that cascade selected values from one visualization to another.

Filters in the filter bar can be pinned (called workbook filters) to limit the data on all canvases in the workbook, or unpinned (called canvas filters) to limit the data on a single canvas. See Add Workbook and Canvas Filters.

Selection steps work slightly differently than filters in the filter bar, but they can also be pinned or unpinned. For more information, see Use Selection Steps.

For information about using parameters in the filter bar, see Use a Parameter in the Filter Bar.

You can hide the items in the filter bar from consumers for a cleaner experience (see Show or Hide the Filter Bar in Present) or you can customize the level of interactivity you want your users to have with the filter bar (see Specify Workbook Filter Options in Present and Specify Canvas Filter Actions in Present).

Filter Bar Properties

You can modify these properties found in the Filter Bar Menu for items in the filter bar, depending on whether they're workbook or canvas filters, selection steps, or parameters.

Property Description
Limit Values By

Specifies how the filters and selection steps in the filter bar get their selection values.

See Specify Limit Values By for the Filter Bar.

You can't configure this property for parameters used in the filter bar.

Filter Values

Specifies whether the selected values for the filters, selection steps, and parameters in the filter bar are displayed.

Options
  • Show All - Displays selected values for all existing items in the filter bar.
  • Hide All - Hides selected values for all existing items in the filter bar.
  • Show by Default - Shows selected values for items that you add next. Items that you added before selecting this option aren't affected.

See Display or Hide Selected Values in the Filter Bar.

Auto-Apply Filters

Specifies whether the filter, selection step, and parameter value selections in the filter bar are automatically applied.

Options
  • On - Applies value selections as you make them in the filter bar.
  • Off - Doesn't automatically apply any selections you make in the filter bar. Adds an Apply button to the Filter or Selection Steps dialog.

See Manually Apply Selections in the Filter Bar.

Move to Dashboard Filter

Converts all canvas filters and unpinned selection steps in the workbook to dashboard filters. Adds a dashboard filter visualization to each canvas and moves the canvas filters and unpinned selection steps for that canvas from the filter bar into the visualization.

Options
  • Horizontal - Orients the new dashboard filters visualization horizontally.
  • Vertical - Orients the new dashboard filters visualization vertically.

See Convert Canvas Filters and Selection Steps to Dashboard Filters.

You can't convert workbook (pinned) filters or parameters used in the filter bar to dashboard filters using this option.

Add Workbook and Canvas Filters

When you add a filter to the filter bar, the filter applies to only the current canvas and is called a canvas filter. You can pin that filter to apply it to every canvas in the workbook and turn it into a workbook filter.

A pinned workbook filter functions the same on every canvas, so any filter data values that you select from any canvas are passed to the pinned filter on all canvases in the workbook. And any configurations you make for the filter are the same on every canvas, for example exclude, null, limit values, and disable filter.
For information about the different types of filters you can use, see Filter Types.
  1. On the Home page, hover over a workbook, click Actions, then select Open.
  2. On the Filter Bar, click Add Filter (+) and select the column you want to filter on.

  3. In the Filter dialog, select the data values to filter on.
  4. Optional: To make the filter a workbook filter that applies to all canvases, hover over the filter and click Pin to All Canvases.
  5. Click Save.

Display or Hide Selected Values in the Filter Bar

You can display the selected filter, selection step, or parameter values in the labels in the filter bar so that you don't have to open a dialog to check the selected values. Or you can hide the selected values to reduce clutter on the filter bar.

Use the Filter Values property to show or hide the selected values in the filter bar. For more information about this property, see Filter Bar Properties.

For a pinned workbook filter or selection step, you can change the value display settings from any canvas.

  1. On the Home page, hover over a workbook, click Actions, then select Open.
  2. On the filter bar, click Filter Bar Menu Filter Bar Menu icon .
  3. Hover over Filter Values and click an option to select it.
    • Show All
    • Hide All
    • Show by Default
  4. Click Save.

Manually Apply Selections in the Filter Bar

As you select filter, selection step, or parameter values in the filter bar, Oracle Analytics automatically applies them. You can change this behavior when you want to manually apply the selections instead.

Use the Auto-Apply Filters property in the Filter Bar Menu to specify if you want to manually apply all selections. When you set this property, it applies to all items in the filter bar across all canvases.

When set to Off, you can select values and then click the Apply button when you want to apply the selections.

For more information about this property, see Filter Bar Properties.

  1. On the Home page, hover over a workbook, click Actions, then select Open.
  2. On the filter bar, click Filter Bar Menu, hover over Auto-Apply Filters, and then click an option to select it.

  3. Click Save.

Convert Canvas Filters and Selection Steps to Dashboard Filters

Convert canvas (unpinned) filters and unpinned selection steps in the filter bar to dashboard filters when you want to use the functionality, style, layout, and personalization options that dashboard filters provide. This way you can avoid manually adding dashboard filters and deleting existing canvas filters or selection steps in the filter bar.

Use the Move to Dashboard Filter option to move the canvas filters and unpinned selection steps from the filter bar into a dashboard filters visualization on each canvas. This option converts all canvas filters and unpinned selection steps in the workbook at once. Pinned selection steps and workbook filters apply to all canvases in the workbook and therefore can't be converted to dashboard filters.
Filter settings such as selected data values, exclude, null, and limit by are moved with the canvas filter or selection step to the dashboard filter. Parameters bound to the canvas filter are also migrated to the dashboard filter control.

For more information about this property, see Filter Bar Properties.

  1. On the Home page, hover over a workbook, click Actions, then select Open.
  2. On the filter bar, click Filter Bar Menu Filter Bar Menu icon.
  3. Hover over Move to Dashboard Filter and click a layout option to select it.
  4. Click Save.

Use a Parameter in the Filter Bar

Adding a parameter to the filter bar allows you to set the parameter value for the whole workbook or an individual canvas.

This tutorial provides a use case explaining how to use a parameter in the filter bar:

Tutorial icon Tutorial

Note:

Adding a parameter as a workbook (pinned) or canvas (unpinned) filter in the filter bar functions as a column selector, it doesn't filter the data.
Using a parameter in the filter bar doesn't provide the same features as a standard filter. For example, it doesn't provide the exclude, nulls, or limit values functionalities.
You can also create and bind a parameter to a workbook filter, see Create and Bind a Parameter to a Workbook Filter.
  1. On the Home page, hover over a workbook, click Actions, then select Open.
  2. In the Data Panel, click Parameters.
  3. Drag and drop a parameter to the filter bar.
    Parameter added to filter bar

  4. Click Save.

Use Dashboard Filters

You can add dashboard filters to your canvases to enable consumers to select and change the values they want to see in the visualizations.

About Dashboard Filters

Dashboard filters provide filter controls for consumers to interact with on an individual canvas.

As an author, you usually add and set filters in the filter bar to broadly limit the data in your workbook, see Use the Filter Bar. You can then add and configure dashboard filters on each canvas to allow consumers to select their own filter values to change the data in the visualizations.

Dashboard filters are contained in the Dashboard Filters visualization. After you add a dashboard filters visualization to the canvas, you can then drag and drop columns to this visualization to create dashboard filters. Oracle Analytics assigns default properties based on the column you chose to create the filter but you can modify the filter's properties to better suit the data and improve the user experience.

You can also drag hierarchy columns to the dashboard filters visualization and create a selection step as a filter control to refine the data in visualizations that use the same hierarchy. You can control the level of interactivity a consumer has with the selection steps, see Control Consumer Interactivity for Selection Steps.

Add Dashboard Filters

Use the Dashboard Filters visualization to create and configure your dashboard filters.

Dashboard filters enable consumers to select their own filter values to change the data in the visualizations.
For information about the different types of filters you can use, see Filter Types.
For information about dashboard filter properties, see Filter Properties.
For information about adding a selection step to a dashboard filter, see Use Selection Steps.
  1. On the Home page, hover over a workbook, click Actions, then select Open.
  2. In the Visualizations Panel, click Visualizations, scroll to Dashboard Controls, and drag Dashboard Filters to the canvas.
  3. In the Data Panel, click Data and drag one or more columns to the new dashboard filters visualization to create the dashboard filter controls.

  4. Optional: Click a filter control to open the Filter dialog, then select the data values filter on.
  5. Click Save.

Change the Orientation of Dashboard Filters

Where you add a dashboard filters visualization to the canvas determines if the filter controls are displayed horizontally or vertically.

You can change the dashboard filters visualization's orientation to provide a canvas layout and filter experience that works best for your users.
  1. On the Home page, hover over a workbook, click Actions, then select Open.
  2. Click the dashboard filters visualization to select it.
  3. Click Properties to open the Properties pane, then click General.
  4. Click the Orientation field and select an orientation.
  5. Click Save.

Change the Dashboard Filter Style

You can choose how you want the filter controls in the dashboard filters visualization to display to provide a canvas layout and filter experience that works best for your users.

Use the Filter Style property to change the dashboard filter style to either of the following:
For more information about this property, see Dashboard Filter General Properties.
  1. On the Home page, hover over a workbook, click Actions, then select Open.
  2. Click the dashboard filters visualization to select it.
  3. Click Properties to open the Properties pane, then click General.
  4. Click the Filter Style field and select a style.
  5. Click Save.

Use a Parameter as a Dashboard Filter Control

You can use a parameter as a dashboard filter control to select and change the dimension and measure column values for the visualizations on a canvas.

These tutorials provide use cases explaining how to use a parameter in the dashboard filter control:

Tutorial icon Tutorial

Tutorial icon Tutorial

Note:

Adding a parameter as a dashboard filter control functions as a column selector, it doesn't filter data.
Using a parameter as a dashboard filter control doesn't provide the same features as a standard filter. For example, it doesn't provide the Top Bottom N, exclude, nulls, or limit values functionalities.
You can also use parameters to bind a dashboard filter to a corresponding filter in other canvases in the workbook. This allows you to pass a selected filter value from one canvas to another. See Create and Bind a Parameter to a Dashboard Filter.
  1. On the Home page, hover over a workbook, click Actions, then select Open.
  2. In the Data Panel, click Visualizations, scroll to the Dashboard Controls section, and drag Dashboard Filters to the canvas.
  3. In the Data Panel, click Parameters, and drag and drop a parameter to Filter Controls in the Dashboard Filter visualization's Grammar pane.
    Parameter on dashboard filter control

  4. Click Save.

Filter and Animate Visualizations Using a Slider Dashboard Filter

You can add a slider dashboard filter to a workbook canvas and animate visualizations to show how the data changes relative to a specified dimension. Consumers can select a dimension value interactively, or automatically play through dimension values, similar to a time-lapse video or animation.

This tutorial provides a use case explaining how to create a dashboard filter with a slider control to see how revenue and product type data changes over the years.

Tutorial icon Tutorial

As another example, you might analyze Olympic medals between 2000 and 2012 in an animation showing the numbers changing over the years.

Before you can create a slider dashboard filter, you need to have one or more visualizations on your canvas for which the dimension, in this case, Year, can be used as a filter. Each visualization must include the same dimension data.

For this example, to filter on Year so that you can analyze Olympic medal data between year 2000 and year 2012, you need to add Year to your dashboard filter visualization.

For more information about slider filters, see Filter Types. For more information about slider dashboard filter properties, see Dashboard Filter Control Properties.
  1. On the Home page, hover over a workbook, click Actions, then select Open.
  2. In the Data panel, click Visualizations, scroll to the Dashboard Controls section, and drag Dashboard Filters to the canvas.

  3. In the Data panel, click Data, and drag a dimension-based data element to the new dashboard filters visualization.
  4. Click Properties to open the Properties pane, then click Filter Controls.
  5. Locate and expand the filter you just added.
  6. Click the Filter Type field and select Slider.

  7. Click the Play field to turn auto-play on or off.
  8. If you enabled play, in the slider filter control, click Play to see how your visualizations play with the default settings.

Use Visualization Filters

You can add visualization filters and selection steps to individual visualizations to filter them without affecting any other visualizations.

About Visualization Filters

Visualization filters filter the data for only one visualization.

As an author, you usually add and set workbook and canvas filters in the filter bar to broadly limit the data in your workbook, see Use the Filter Bar. You can then add and configure dashboard filters on each canvas to allow consumers to select their own filter values to view the data in the visualizations on that canvas, see Use Dashboard Filters.

Oracle Analytics offers another, narrower filter scope in the form of visualization filters which you can add so that a user can select the values they want to see in that particular visualization without affecting the rest of the workbook. For visualizations using hierarchies, you can add selection steps at the visualization filter level as well.

You can also set visualization filters yourself and then hide them from the consumer, see Show or Hide a Visualization Filter in Present and Control Consumer Interactivity for Selection Steps.

Add Visualization Filters

Add visualization filters to a visualization to filter the data in that visualization only, without affecting anything else in the workbook.

For information about the different types of filters you can use, see Filter Types.
For information about visualization filter properties, see Dashboard and Visualization Filters Properties.
For information about adding a selection step to a visualization, see Use Selection Steps.
  1. On the Home page, hover over a workbook, click Actions, then select Open.
  2. Click a visualization to select it.
  3. Click the Grammar pane.
  4. Click Data, and drag and drop one or more columns to Filters in the Grammar pane to create the visualization filters.

  5. Click Save.

Use a Visualization as a Filter

You can use the data selections from one visualization to filter all other visualizations on the canvas, depending on the visualization type.

If a visualization's Use as Filter icon is displayed in greenGreen Use as Filter icon is activated, it means that it's functioning as a filter on the canvas. When you select a data element in the visualization, the other visualizations on the canvas that also use that data element are updated to display their data based on your selection.
  1. On the Home page, hover over a workbook, click Actions, then select Open.
  2. Hover over the visualization that you want to use as a filter.
  3. Click the Use as Filter icon The Use as Filter buttonto activate.
  4. Click Save.

Use Selection Steps

The topics in this section explain how you can use selection steps in workbooks.

About Selection Steps in Workbooks

In Oracle Analytics, you can use selection steps to specify which levels or members of a hierarchy you want to display in table or pivot visualizations that use that hierarchy.

Selection steps are similar to filters, but instead of filtering to select values from a column, they let you select members of a hierarchy to participate in the query. You can choose which levels or members of the hierarchy you want to keep, add, or remove in your selection. You can add as many selection steps as you need, at all filter scopes, and they're applied in a specific order.

For information about which filter properties you can configure for selection steps, see Filter Properties and Filter Bar Properties.

Hierarchies

Oracle Analytics supports using selection steps for both level-based hierarchies and parent-child hierarchies, including those with skip-level or ragged structures.

Level-based hierarchies (structure hierarchies) - In these hierarchies, members of the same type occur only at a single level, while members in parent-child hierarchies all have the same type. In level-based hierarchies, levels roll up from a lower level to a higher level, for example, months can roll up into a year. These roll ups occur over the hierarchy elements and span natural business relationships.

Parent-child hierarchies (value hierarchies) - In these hierarchies, the business relationships occur between different members of the same real-world type such as the manager-employee relationship in an organizational hierarchy tree. Parent-child hierarchies don't have explicitly named levels. There isn't a limit to the number of implicit levels in a parent-child hierarchy.

How Selection Steps and Filters Differ

It's important to understand the differences between filters and selection steps in workbooks so you can apply them effectively.

Purpose and Application

Filters act on individual columns to reduce or focus the data in one or more visualizations. Filters can apply to any visualization that uses data from the same dataset or subject area as the filter, including joined datasets. For more information, see About Filters.

Selection steps act on hierarchies and don't actually filter the data in visualizations. Instead, they specify which levels or members from the hierarchy are displayed in any visualizations that use the same hierarchy that the selection step is based on. Selection steps have no effect on visualizations that don't use the same hierarchy.

Impact on Aggregation

Filters are applied to data before aggregation and therefore affect any aggregate values in visualizations. Selection steps are applied after aggregation and therefore have no impact on aggregate values.

For example, suppose you have a table visualization named Revenue in 2010 that uses attribute and measure columns to show revenue by quarter for the year 2010, including the grand total for the whole year.
Description of selection_steps_example_aggregation_filter1.png follows
Description of the illustration selection_steps_example_aggregation_filter1.png

If you add a canvas filter in the filter bar to exclude the first quarter of 2010, the row for the first quarter disappears from the table and the grand total for the whole year changes to reflect the excluded filter value.
Description of selection_steps_example_aggregation_filter2.png follows
Description of the illustration selection_steps_example_aggregation_filter2.png

Now suppose your table visualization uses a time hierarchy to show the same data, now named Revenue in 2010 (Time Hierarchy).
Description of selection_steps_example_aggregation_ss1.png follows
Description of the illustration selection_steps_example_aggregation_ss1.png

If you add a selection step in the filter bar to remove the first quarter of 2010, the row for the first quarter is gone from the table, but total revenue for the whole year doesn't change. This is because that selection step is applied after the query for revenue in 2010 was aggregated so it's only removing the 2010 Q1 member from the visualization.
Description of selection_steps_example_aggregation_ss2.png follows
Description of the illustration selection_steps_example_aggregation_ss2.png

Order of Operation in the Filter Bar

In the filter bar, the order in which workbook or canvas filters appear is irrelevant. However, the order in which selections steps appear is critical because it dictates the order in which they're applied.

For example, suppose you have a table visualization named Revenue in 2010 that uses a time hierarchy to show revenue by quarter for the year 2010, including the total revenue for the year. Suppose the first selection step in the filter bar starts with the year 2010 and then removes the first quarter, 2010 Q1, so only the revenue amounts for the year itself and the remaining three quarters are displayed.
Description of selection_steps_example_order_before.png follows
Description of the illustration selection_steps_example_order_before.png

If you add another, separate selection step in the filter bar that adds back the first quarter, 2010 Q1, the visualization displays all four quarters for the year 2010, as expected.
Description of selection_steps_example_order_add.png follows
Description of the illustration selection_steps_example_order_add.png

If you swap the order of these two selection steps in the filter bar, the visualization doesn't display any data. This is because now, the selection step adding the member 2010 Q1 is applied first so the visualization starts with only 2010 Q1. The second selection step to keep 2010 and remove 2010 Q1 doesn't work because you can't keep the member 2010 if it's not in the selection to begin with.
Description of selection_steps_example_order_swap.png follows
Description of the illustration selection_steps_example_order_swap.png

It's important to make sure the selection steps appear in a logical order so that when they're applied, the visualization displays the data you expect.

Selection Steps Action and Operator Reference

Selection steps use actions and operators to help you access the specific data that you want to display in a table or visualization.

The combination of the action, operator, and values that you select determines what the selection step does.

To add a selection step, see Add Selection Steps.

Actions

There are three actions available for selection steps:

  • Add - Lets you select levels or members to add to the selection.

  • Keep Only - Lets you select the levels or members that you want to keep within the selection. This action doesn't add anything to the selection, it works only on levels or members that are already included in the selection. This is the default action.

  • Remove - Lets you select levels or members to remove from the selection.

Operators

The operators available for a selection step depend on the type of hierarchy you're using.

The Levels operator is available only for level-based hierarchies. It lets you specify the levels you want the selection step to act on; for example, Year, Quarter, Month, and Day for a time-based hierarchy.

When you choose any other operator, you can specify which members of the hierarchy you want the selection step to act on. Members are those data points residing at specific nodes in the hierarchy.

The following operators are available for both level-based hierarchies and parent-child hierarchies:
  • Members - Lets you specify the exact members you want the selection step to act on. Only the selected members are displayed in the visualization. This is the default operator.

  • + Children - Lets you specify members so that the selection step acts on them and their children. The members and their children are displayed in the visualization.

  • + Parents - Lets you specify members so that the selection step acts on them and their parents. The members and their parents are displayed in the visualization.

  • + Descendants - Lets you specify members so that the selection step acts on them and their descendants. The members and all their descendants, down to the lowest members, are displayed in the visualization.

  • + Ancestors - Lets you specify members so that the selection step acts on them and their ancestors. The members and their ancestors are displayed in the visualization.

  • + Siblings - Lets you specify members so that the selection step acts on them and their siblings. The members and their siblings are displayed in the visualization.

  • + Leaves - Lets you specify members so that the selection step acts on them and all the leaves under them. The specified members and the lowest members under them are displayed in the visualization. Any members in between are excluded.

  • Children - Lets you specify members so that the selection step acts only on their children (not the selected members themselves). Only the children are displayed in the visualization.

  • Parents - Lets you specify members so that the selection step acts only on their parents. Only the parents are displayed in the visualization.

  • Descendants - Lets you specify members so that the selection step acts only on their descendants. Only the descendants are displayed in the visualization.

  • Ancestors - Lets you specify members so that the selection step acts only on their ancestors. Only the ancestors are displayed in the visualization.

  • Siblings - Lets you specify members so that the selection step acts only on their siblings. Only the siblings are displayed in the visualization.

  • Leaves - Lets you specify members so that the selection step acts only on the leaves under them. Only the leaves are displayed in the visualization.

Operator Examples

The following examples illustrate the outcome of a selection step using the action Keep Only and each type of operator for a time-based level hierarchy and a parent-child hierarchy of sales representatives.
  • Members

    Level hierarchy example: For a table showing revenue for a time dimension, if you use a selection step with the action Keep Only, the operator Members, and the members 2010 and 2011, the table shows the revenue for only those two years.
    Description of selection_steps_lvlhierarchy_ex_members.png follows
    Description of the illustration selection_steps_lvlhierarchy_ex_members.png

    Parent-child hierarchy example: For a table showing revenue for a sales representative hierarchy, if you use a selection step with the action Keep Only, the operator Members, and the members Helen Mayes and Monica Velasquez, the table shows the revenue for only those two representatives. The names in the table are displayed alphabetically.
    Description of selection_steps_pchierarchy_ex_members.png follows
    Description of the illustration selection_steps_pchierarchy_ex_members.png

  • + Children

    Level hierarchy example: For a table showing revenue for a time hierarchy, if you use a selection step with the action Keep Only, the operator + Children, and the members 2010 and 2011, the table shows the revenue for those two years and their children, in this case, four quarters.
    Description of selection_steps_lvlhierarchy_ex_members_children.png follows
    Description of the illustration selection_steps_lvlhierarchy_ex_members_children.png

    Parent-child hierarchy example: For a table showing revenue for a sales representative hierarchy, if you use a selection step with the action Keep Only, the operator + Children, and the member Helen Mayes, the table shows the revenue for her and the representatives reporting directly to her. The names in the table are displayed alphabetically.
    Description of selection_steps_pchierarchy_ex_members_children.png follows
    Description of the illustration selection_steps_pchierarchy_ex_members_children.png

  • + Parents

    Level hierarchy example: For a table showing revenue for a time hierarchy, if you use a selection step with the action Keep Only, the operator + Parents, and the members 2010 and 2011, the table shows the revenue for those two years and their parent, in this case, Total Time.
    Description of selection_steps_lvlhierarchy_ex_members_parents.png follows
    Description of the illustration selection_steps_lvlhierarchy_ex_members_parents.png

    Parent-child hierarchy example: For a table showing revenue for a sales representative hierarchy, if you use a selection step with the action Keep Only, the operator + Parents, and the member Helen Mayes, the table shows the revenue for her and the representative she reports to. The names in the table are displayed alphabetically.
    Description of selection_steps_pchierarchy_ex_members_parents.png follows
    Description of the illustration selection_steps_pchierarchy_ex_members_parents.png

  • + Descendants

    Level hierarchy example: For a table showing revenue for a time hierarchy, if you use a selection step with the action Keep Only, the operator + Descendants, and the members 2010 and 2011, the table shows the revenue for those two years and all their descendants, in this case, quarters, months, and days.
    Description of selection_steps_lvlhierarchy_ex_members_descendants.png follows
    Description of the illustration selection_steps_lvlhierarchy_ex_members_descendants.png

    Parent-child hierarchy example: For a table showing revenue for a sales representative hierarchy, if you use a selection step with the action Keep Only, the operator + Descendants, and the member Helen Mayes, the table shows the revenue for her and all the representatives in the reporting structure under her. The names in the table are displayed alphabetically.
    Description of selection_steps_pchierarchy_ex_members_descendants.png follows
    Description of the illustration selection_steps_pchierarchy_ex_members_descendants.png

  • + Ancestors - Lets you specify members so that the selection step acts on them and their ancestors. The members and their ancestors are displayed in the visualization.

    Level hierarchy example: For a table showing revenue for a time hierarchy, if you use a selection step with the action Keep Only, the operator + Ancestors, and the members 2010 and 2011, the table shows the revenue for those two years and their ancestor, in this case, Total Time.
    Description of selection_steps_lvlhierarchy_ex_members_ancestors.png follows
    Description of the illustration selection_steps_lvlhierarchy_ex_members_ancestors.png

    Parent-child hierarchy example: For a table showing revenue for a sales representative hierarchy, if you use a selection step with the action Keep Only, the operator + Ancestors, and the member Helen Mayes, the table shows the revenue for her and the representative she reports to. The names in the table are displayed alphabetically.
    Description of selection_steps_pchierarchy_ex_members_ancestors.png follows
    Description of the illustration selection_steps_pchierarchy_ex_members_ancestors.png

  • + Siblings - Lets you specify members so that the selection step acts on them and their siblings. The members and their siblings are displayed in the visualization.

    Level hierarchy example: For a table showing revenue for a time hierarchy, if you use a selection step with the action Keep Only, the operator + Siblings, and the members 2010 and 2011, the table shows the revenue for those two years and their siblings, in this case, the rest of the years between 2008 and 2012.
    Description of selection_steps_lvlhierarchy_ex_members_siblings.png follows
    Description of the illustration selection_steps_lvlhierarchy_ex_members_siblings.png

    Parent-child hierarchy example: For a table showing revenue for a sales representative hierarchy, if you use a selection step with the action Keep Only, the operator + Siblings, and the member Helen Mayes, the table shows the revenue for her and the other representatives at the same reporting level. The names in the table are displayed alphabetically.
    Description of selection_steps_pchierarchy_ex_members_siblings.png follows
    Description of the illustration selection_steps_pchierarchy_ex_members_siblings.png

  • + Leaves - Lets you specify members so that the selection step acts on them and all the leaves under them. The specified members and the lowest members under them are displayed in the visualization. Any members in between are excluded.

    Level hierarchy example: For a table showing revenue for a time hierarchy, if you use a selection step with the action Keep Only, the operator + Leaves, and the members 2010 and 2011, the table shows the revenue for those two years and all their leaves, in this case, days.
    Description of selection_steps_lvlhierarchy_ex_members_leaves.png follows
    Description of the illustration selection_steps_lvlhierarchy_ex_members_leaves.png

    Parent-child hierarchy example: For a table showing revenue for a sales representative hierarchy, if you use a selection step with the action Keep Only, the operator + Leaves, and the member Helen Mayes, the table shows the revenue for her and all the representatives at the lowest level under her, excluding any in between. The names in the table are displayed alphabetically.
    Description of selection_steps_pchierarchy_ex_members_leaves.png follows
    Description of the illustration selection_steps_pchierarchy_ex_members_leaves.png

  • Children - Lets you specify members so that the selection step acts only on their children (not the selected members themselves). Only the children are displayed in the visualization.

    Level hierarchy example: For a table showing revenue for a time hierarchy, if you use a selection step with the action Keep Only, the operator Children, and the members 2010 and 2011, the table shows the revenue for the children of those two years, in this case, the quarters.
    Description of selection_steps_lvlhierarchy_ex_children.png follows
    Description of the illustration selection_steps_lvlhierarchy_ex_children.png

    Parent-child hierarchy example: For a table showing revenue for a sales representative hierarchy, if you use a selection step with the action Keep Only, the operator Children, and the member Helen Mayes, the table shows the revenue for the two representatives reporting directly to her. The names in the table are displayed alphabetically.
    Description of selection_steps_pchierarchy_ex_children.png follows
    Description of the illustration selection_steps_pchierarchy_ex_children.png

  • Parents - Lets you specify members so that the selection step acts only on their parents. Only the parents are displayed in the visualization.

    Level hierarchy example: For a table showing revenue for a time hierarchy, if you use a selection step with the action Keep Only, the operator Parents, and the members 2010 and 2011, the table shows the revenue for the parent of those two years, in this case, Total Time.
    Description of selection_steps_lvlhierarchy_ex_parents.png follows
    Description of the illustration selection_steps_lvlhierarchy_ex_parents.png

    Parent-child hierarchy example: For a table showing revenue for a sales representative hierarchy, if you use a selection step with the action Keep Only, the operator Parents, and the member Helen Mayes, the table shows the revenue for the representative she reports to.
    Description of selection_steps_pchierarchy_ex_parents.png follows
    Description of the illustration selection_steps_pchierarchy_ex_parents.png

  • Descendants - Lets you specify members so that the selection step acts only on their descendants. Only the descendants are displayed in the visualization.

    Level hierarchy example: For a table showing revenue for a time hierarchy, if you use a selection step with the action Keep Only, the operator Descendants, and the members 2010 and 2011, the table shows the revenue for all the descendants of those two years, in this case, quarters, months, and days.
    Description of selection_steps_lvlhierarchy_ex_descendants.png follows
    Description of the illustration selection_steps_lvlhierarchy_ex_descendants.png

    Parent-child hierarchy example: For a table showing revenue for a sales representative hierarchy, if you use a selection step with the action Keep Only, the operator Descendants, and the member Helen Mayes, the table shows the revenue for all the representatives in the reporting structure under her. The names in the table are displayed alphabetically.
    Description of selection_steps_pchierarchy_ex_descendants.png follows
    Description of the illustration selection_steps_pchierarchy_ex_descendants.png

  • Ancestors - Lets you specify members so that the selection step acts only on their ancestors. Only the ancestors are displayed in the visualization.

    Level hierarchy example: For a table showing revenue for a time hierarchy, if you use a selection step with the action Keep Only, the operator Ancestors, and the members 2010 and 2011, the table shows the revenue for the ancestor of those two years, in this case, Total Time.
    Description of selection_steps_lvlhierarchy_ex_ancestors.png follows
    Description of the illustration selection_steps_lvlhierarchy_ex_ancestors.png

    Parent-child hierarchy example: For a table showing revenue for a sales representative hierarchy, if you use a selection step with the action Keep Only, the operator Ancestors, and the member Helen Mayes, the table shows the revenue for the representative she reports to.
    Description of selection_steps_pchierarchy_ex_ancestors.png follows
    Description of the illustration selection_steps_pchierarchy_ex_ancestors.png

  • Siblings - Lets you specify members so that the selection step acts only on their siblings. Only the siblings are displayed in the visualization.

    Level hierarchy example: For a table showing revenue for a time hierarchy, if you use a selection step with the action Keep Only, the operator Siblings, and the members 2010 and 2011, the table shows the revenue for the siblings of those two years, in this case, the rest of the years between 2008 and 2012.
    Description of selection_steps_lvlhierarchy_ex_siblings.png follows
    Description of the illustration selection_steps_lvlhierarchy_ex_siblings.png

    Parent-child hierarchy example: For a table showing revenue for a sales representative hierarchy, if you use a selection step with the action Keep Only, the operator Siblings, and the member Helen Mayes, the table shows the revenue for the other representatives at the same reporting level as her. The names in the table are displayed alphabetically.
    Description of selection_steps_pchierarchy_ex_siblings.png follows
    Description of the illustration selection_steps_pchierarchy_ex_siblings.png

  • Leaves - Lets you specify members so that the selection step acts only on the leaves under them. Only the leaves are displayed in the visualization.

    Level hierarchy example: For a table showing revenue for a time hierarchy, if you use a selection step with the action Keep Only, the operator Leaves, and the members 2010 and 2011, the table shows the revenue for all the leaves of those two years, in this case, days.
    Description of selection_steps_lvlhierarchy_ex_leaves.png follows
    Description of the illustration selection_steps_lvlhierarchy_ex_leaves.png

    Parent-child hierarchy example: For a table showing revenue for a sales representative hierarchy, if you use a selection step with the action Keep Only, the operator Leaves, and the member Helen Mayes, the table shows the revenue for all the representatives at the lowest level under her, excluding any in between. The names in the table are displayed alphabetically.
    Description of selection_steps_pchierarchy_ex_leaves.png follows
    Description of the illustration selection_steps_pchierarchy_ex_leaves.png

Add Selection Steps

Use selection steps to select the levels or members you want to display in a table or pivot visualization that uses a level or parent-child hierarchy.

You can add selection steps to the filter bar, to a dashboard filter, or to an individual visualization.

For information about how to use the different actions and operators, see Selection Steps Action and Operator Reference.

This tutorial shows you how to create selection steps in the filter bar for a level hierarchy and a parent-child hierarchy:

Tutorial icon Tutorial

  1. On the Home page, hover over a workbook, click Actions, then select Open.
  2. In the Data pane, drag and drop a hierarchical data element to one of the following:
    • The filter bar to create a selection step to broadly limit the data on one or all canvases.
    • A dashboard filter on the canvas to create a selection step as a dashboard filter control that consumers can interact with.
    • The Filters area of the Grammar pane for a specific visualization to create a selection step to limit data in only that visualization.
  3. In the Selection Steps dialog:
    1. Select an action from the Actions drop-down list.

    2. Select an operator from the Operators drop-down list.

    3. Use Ctrl-click to select the levels or members from the Values drop-down list.
  4. Optional: To quickly see the exact members selected, click the green highlighted number in the member selection drop-down list.

  5. Click Save.

Specify Limit Values for Selection Steps

Configure the Limit Values setting for individual selection steps in a workbook to specify how a selection step gets its selection values.

As with filters in a workbook, the value selections you make for one selection step can impact the values available to select from for other selection steps, depending on the selection step location and the limit values settings. For information about the limit values settings, see About the Limit Values Settings for Filters.

Selection steps can also be limited by, and can limit, filters that use the same dimension.

If there aren't any other selection steps from the same hierarchy or any filters from the same dimension in the same filter location, the only Limit Values setting available is None.

  1. On the Home page, hover over a workbook, click Actions, then select Open.
  2. Click the selection step to open the dialog.
  3. Click Limit Values icon Limit Values and click an option to select it.
  4. Click Save.

Control Consumer Interactivity for Selection Steps

Specify the level of interactivity and control you want consumers to have with individual selection steps in your workbook.

You can configure the level of consumer interactivity for selection steps used as dashboard filter controls and for selection steps used on individual visualizations.

You can choose from the following levels of consumer interactivity:
  • Full – Provides consumers with full control of the selection step. They can change the action and operator, and the level or member selections. They can also add or delete selection steps.
  • Restricted – Lets consumers see the actions and operators but modify only the level or member selections. Prevents them from adding or deleting selection steps.
  • Minimal – Hides the actions and operators completely from consumers, but lets them modify the level or member selections. Prevents them from adding or deleting selection steps.

For all three levels, consumers can access the Limit Values setting and disable or enable the selection step.

  1. On the Home page, hover over a workbook, click Actions, then select Open.
  2. Click a dashboard filter or visualization to select it.
  3. Click Properties, then:
    • For a dashboard filter, click Filter Controls.
    • For an individual visualization, click Filters.
  4. In the Consumer Interactivity row, click Full and select an option.
  5. Click Save.

Change the Filter Type

Switch your filter from the default filter type assigned by Oracle Analytics to another compatible filter type to best suit your needs.

You can change the filter type of any filter but the compatible filter types available depend on the filter scope and data element you're using.
For more information about the filter types available, see Filter Types.
  1. On the Home page, hover over a workbook, click Actions, then select Open.
  2. For a workbook or canvas filter, in the filter bar, click the filter to open the Filter dialog, and then click the filter type you want to use.
  3. For a dashboard filter:
    1. Click the dashboard filters visualization to select it.
    2. Click Properties to open the Properties pane, then click Filter Controls.
    3. Locate and expand the filter you want to change the filter type for.
    4. Click the Filter Type field and select the type of filter you want to use.

  4. For a visualization filter, in the visualization, click the filter to open the Filter dialog, and then click the filter type you want to use.
  5. Click Save.

Filter Data Using an Expression Filter

Using expression filters, you can define more complex filters using SQL expressions. Expression filters can reference zero or more data elements.

For example, you can create and apply the expression filter "Sample Sales"."Base Facts"."Revenue" < "Sample Sales"."Base Facts"."Target Revenue" to see the items that didn’t achieve their target revenue.

You can use expression filters in the filter bar to apply to a canvas or the whole workbook, or you can use one as a visualization filter to apply only to a single visualization.

You can also use a parameter in an expression filter's SQL expression, see Use a Parameter in an Expression Filter.

  1. On the Home page, hover over a workbook, click Actions, then select Open.
  2. For a workbook or canvas filter, on the filter bar, click Add Filter and then select Create Expression Filter.
  3. For a visualization filter:
    1. Click the visualization to select it.
    2. Click Grammar to open the Grammar pane, scroll to the Filters area, click Drop Target Options, and then select Create Expression Filter.
  4. In the Expression Filter panel, in the Label field, give the expression a name.
  5. In the Expression field, compose an expression.
  6. Click Validate to check if the syntax is correct.
  7. When the expression filter is valid, then click Apply.

Exclude Selected Filter Values

You can configure a filter to exclude rather than include the selected data values.

You can exclude data values for filters created on certain column types using certain filter types. For example, you can exclude data values for an attribute column filter but the filter type must be List, List Box, or Checkbox / Radio Button. You can't exclude data values for filters on measure columns.
You can use also parameters to pass excluded values between filters, see Create and Bind a Parameter to Exclude Filter Values.
  1. On the Home page, hover over a workbook, click Actions, then select Open.
  2. For a workbook or canvas filter, on the filter bar, click the filter to open the Filter dialog, and then select Exclude.
  3. For a dashboard filter:
    1. If the filter type is List, in the dashboard filters visualization, click the filter to open the Filter dialog, and then select Exclude.
    2. If the filter type is List Box or Checkbox / Radio Button, click Properties to open the Properties pane, and then click Filter Controls.
    3. Locate and expand the filter you want to exclude values for, click the Exclude Selection field, and then select On.
  4. For a visualization filter, in the visualization, click the filter to open the Filter dialog, and then select Exclude.
  5. Click Save.

Include Null Filter Values

You can configure a filter to include rather than exclude null values.

You can include null values for filters created on certain column types using certain filter types. For example, you can include null values for an attribute column filter, but the filter type must be List, List Box, or Checkbox / Radio Button. You can't include null values for filters on measure columns.
  1. On the Home page, hover over a workbook, click Actions, then select Open.
  2. For a workbook or canvas filter, on the filter bar, click the filter to open the Filter dialog, and then select Nulls.
  3. For a dashboard filter:
    1. If the filter type is List, in the dashboard filters visualization, click the filter to open the Filter dialog, and then select Nulls.
    2. If the filter type is List Box or Checkbox / Radio Button, click Properties to open the Properties pane, and then click Filter Controls.
    3. Locate and expand the filter you want to include null values for, then click the Null Selection field, and select On.
  4. For a visualization filter, in the visualization, click the filter to open the Filter dialog, and the select Nulls.
  5. Click Save.

Disable Multi Select for Filters

You can configure a dashboard filter or visualization filter to allow only single value selections. For example, you must configure this setting to Off when you use a list filter to bind a parameter to a dashboard filter.

The Multi Select property is set to On by default and is available only for the filter types List and Checkbox / Radio Button.
  1. On the Home page, hover over a workbook, click Actions, then select Open.
  2. For a dashboard filter:
    1. Click the dashboard filters visualization to select it.
    2. Click Properties to display the Properties pane, then click Filter Controls.
  3. For a visualization filter:
    1. Click the visualization to select it.
    2. Click Properties to display the Properties pane, then click Filters.
  4. Locate and expand the filter you want to disable Multi Select for.
  5. Click the Multi Select field and select Off.
  6. Click Save.

Disable a Filter or Selection Step

You can disable a filter or selection step to turn it off temporarily without deleting it so you can use it again in the future.

You can disable a filter for these filter types only:

  • List
  • Top Bottom N
  • Range
  • Date Range
  • Relative Time
  1. On the Home page, hover over a workbook, click Actions, then select Open.
  2. For a workbook filter, canvas filter, or selection step in the filter bar, click the item to open the Filter dialog.
  3. For a dashboard filter, in the dashboard filters visualization, click the filter control to open the Filter dialog.
  4. For a visualization filter, in the visualization, click the filter or selection step to open the Filter dialog.
  5. Click Disable FilterDisable Filter icon.
  6. Click Save.