Like what you see? Have a play with our trial version.

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Table of Contents
classcontents

Overview


Styleclass
ClasstopLink

top

The Filter format tab contains a number of sections that you can use to format your filters.

...

Each of these sections is described below.

 

General Settings


Styleclass
ClasstopLink

top

The main formatting options for report filters are displayed below.

...

Expand
titleFilter Refresh

This option is only available if one or more filters have been set to use Cached Values.

Option

Description

Refresh

There are two available refresh options available for cached filters:

  • Manual: allow users to manually refresh cached filter values. This should be used if values don't change regularly.
  • Scheduled: schedule automatic cached filter values refresh. This should be used if values change often.

If the refresh setting is defined as Scheduled then the following scheduling options will become available. This schedule will apply to all cached filters on this report.

 

Filter Settings


Styleclass
ClasstopLink

top


Dates

 

Expand
titleDisplay

The display options for dates are the same as those for dimensions and metrics, with the exception of Period Traversal.

Option

Description

Description

Define the title of the filter.

Display Filter in Legend

Show or hide this filter from the filter legend list.

Filter Requirement

There are two available options:

  • Allow Omit: allow the user to leave this filter blank.
  • Mandatory: force the user to provide a value for this filter in order to run the report.

Display Dependent On

Select a filter for this filter to be dependent on. This will mean that the selected filter will have to have a value selected before the dependent filter displays.
Note: this option will only be displayed if you have another filter that had cached values.

See Cached Dependent Filters for more information.

Remember User Selection

Remember values applied to this filter for future use.

Period Traversal

Allows you to provide the user with a method of stepping through periods before and after that selected in the filter. For example, the user filters the report on Year = 2009. If the interval is 1 Year and the interval bounds are 5 Back and 5 Forward then the user will initially see data for 2009. Each time they either move back or forward it will be 1 year, and they will be restricted to 5 years in either direction.


...

Expand
titleEntry Style


Option

Description

Value Entry Method

Define the way the user should provide values for the filter. There are two available options:

  • Manual User Entry: allows the user to either type in dates into values the entry fields, or use the calendar picker.
  • Value List Selection: allows you to cache values or provide provides a list of pre-defined date ranges dimension values for the user to select from.

Allow Prompt

This option is only available for the Manual User Entry option and allows users to prompt the database for a list of values to select from at the time of viewing the report.
Note: it is recommended that the user prompt option be disabled if your data set has many variables that as it may take some time for the values to be returned.

CSV Entry

This option is only available for the Manual User Entry option and allows users to enter values for the filter with the use of a .csv file.

Value List Setup

Define which method of providing a list of values you will use. There are three options:

  • Reference Codes: create a list of values for the user to select from based on the Org Ref Code applied to the filter. See Reference Code Use for more information.
  • Cached Values: create a list of values by caching the current contents of the field in the database.
  • Custom Query: create a list of values by caching the current contents of the field in the database using a custom SQL query.

Sort

Define the sort order for the list of values as ascending or descending.

Default Value

Define the default value(s) to be used for the filter when the report is initially loaded. (Optional).

If the Value List Setup option is set to Custom Query the following options will become available.

...

Expand
titleEntry Style


Option

Description

Value Entry Method

Define the way the user should provide values for the filter. There are two available options:

  • Manual User Entry: allows the user to either type in dates into the entry fields, or use the calendar pickerthe metric values.
  • Slider: allow the user to select values using a numeric slider.
  • Range: the user will provide a low and high value.

Value List Setup

Define which method of providing a list of values you will use. There are two options:

  • Manual: the user will manually type values for this filter.
  • Custom Query: create a list of values by caching the current contents of the field in the database using a custom SQL query.

Min

Define the minimum value the user can select for this filter.

Interval

Define the increments the value increases by.

Max

Define the maximum value the user can select for this value.

Colour

Select the colour for the entry style.

Default Value

Define the default value(s) to be used for the filter when the report is initially loaded. (Optional).

If the Value List Setup option is set to Custom Query the following options will become available.

 

horizontalrule

Styleclass
ClasstopLink

top