This guide explains how to use the Report Version Table token in reports using a query string-like syntax.
Basic Structure
The token uses URL-style parameters separated by & characters.
The default configuration is:
{Report_Version_Table?columns=version,title,status,updated_by,updated_at}This token will be replaced by a table containing the following information for each report version:
- Version
- Title
- Status
- Updated by
- Updated at
Configuration Sections
Columns
Use the columns parameter to define which report version fields should be displayed in the table:
columns=[field1,field2,field3]
For example:
{Report_Version_Table?columns=version,title,status,updated_by,updated_at}The order of the fields in the token determines the order in which the columns appear in the generated table.
Available Columns
The following fields can be used in the columns parameter:
| Field | Description |
version | The report version number. |
title | The title of the report version. |
description | The description of the report version. |
template | The report template associated with the version. |
status | The current status of the report version. |
created_by | The user who created the report version. |
created_at | The date and time when the report version was created. |
updated_by | The user who last updated the report version. |
updated_at | The date and time when the report version was last updated. |
Filtering
The Report Version Table currently supports filtering by report version status.
Use the following parameter:
setting.filter.status=[status]
The supported status values are:
DraftPublished
Examples
Default Report Version Table
Displays the version, title, status, last updated user, and last updated date:
{Report_Version_Table?columns=version,title,status,updated_by,updated_at}Published Report Versions
Displays only published report versions:
{Report_Version_Table?columns=version,title,status,updated_by,updated_at&setting.filter.status=Published}Draft Report Versions
Displays only draft report versions:
{Report_Version_Table?columns=version,title,status,updated_by,updated_at&setting.filter.status=Draft}Report Version Creation Details
Displays the version number, title, template, creator, and creation date:
{Report_Version_Table?columns=version,title,template,created_by,created_at}Full Report Version History
Displays all available report version information:
{Report_Version_Table?columns=version,title,description,template,status,created_by,created_at,updated_by,updated_at}Notes
- At least one field must be included in the
columnsparameter. - Column names must be separated by commas.
- The order of the fields in the token controls the order of the generated table columns.
- If no status filter is provided, report versions of all statuses are included.