Page tree

Versions Compared

Key

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

...

Table of Contents
maxLevel2

How to filter one table with a drop-down filter

To filter a table, enter the Edit mode, find Table Filter in the Insert - Other Macros menu and insert it to the page. Then either copy and paste an already existing table or create a new table inside the macro.

...

Info

To make your work with long tables more comfortable, you can specify the number of top rows to show in the Show first N rows field.

How to filter more than one table

To filter two or more tables, place them inside the Table Filter macro. You can set up individual filters for tables (the Country filter in the example below) or filters that affect all tables (the City filter).

How to add a textbox filter

To add a textbox filter, enter the table header(s) in the User Filtered Columns field or choose them from the list.

How to use the global filter

Select the Global Filter option to enable filtering by all columns. In the example below, a regular expression is used to filter all rows containing the snippets 'Morocco' or '1500 mln' in any columns.

How to filter date range

Info

This functionality is not available for Confluence Cloud version.

...

Info

The date format can be specified and alternated depending on your table date.

Use the following formats for specifying date:

  • yy - year
  • mm - month
  • dd - day

For the details on date formats, see What date formats are supported?

How to filter number range

Info

This functionality is not available for Confluence Cloud version.

...

  1. Open the macro and locate the Number Filter Columns box.
  2. Click it and select the columns containing the numbers.
  3. Once you have saved the page, locate the box for a column with number and enter the appropriate number range.

How to use regular expressions in textbox filters

You can use JavaScript-style regular expressions in textbox filters. 

Examples

Regular ExpressionMatched Values
[Dd]oeDoe, doe
colo(u)?rcolor, colour
Developer|ScientistDeveloper, Scientist

The full list of regular expressions is available here.

How to set default values for filters

Open the macro and point to the Filters' Default Values button and then click it. Select the appropriate value for the current dropdown filter.

...

 You can set multiple default values for each drop-down filter. You can delete the added default values by clicking the Close icon available on each value.

How to use Table Filter with the JIRA Issues and Task Report add-ons

To filter tables produced by the JIRA Issues and Taks Report add-ons, put these macros inside the Table Filter macro.

...

Set filters and use Table Filter as with an normal table.

How to change the look of filters

You can remove filter names from the Confluence page by selecting the Hide Labels box.

...

Click the Width of Filters button and enter the appropriate width (in pixels) for the filter fields. You can set width for each field.

How to disable filters

To temporarily disable filters, click the icon. All entered filter values will be restored when you enable filtering.

How to add automatic row numbering

While editing the Table filter macro, select the Automatic row numbering option. You can choose between dynamic and static row numbering.

How to hide table columns

  1. While editing the Table filter macro, select the Hide columns option.
  2. Click the Filters' Default Values button.
  3. Locate the Hide columns box and select the columns you want to hide.
  4. Click Save.

How to limit the table height

Info

This functionality is not available for Confluence Cloud version.

...

Once you have saved the page, the table will automatically fit the screen area.

Changing order of filters when editing the macro

Info

This functionality is not available for Confluence Cloud version.

You can change order of filters by dragging the column label to the appropriate place in all filter boxes.

How to export the table with filtered data to PDF/Word

Info

This functionality is not available for Confluence Cloud version.

...