Versions Compared

Key

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

...

Description

...

Warning

There is a Confluence bug that does not allow you to sort columns when combining Report Table and Date Supplier. Check the Notes section for the workaround.

Displays each of the items from a reporter in a table.

A report table must contain two things:

  1. A reporter macro (such as Content Reporter or User Reporter), which finds the list of items to report on

...

  1. .

AND

  1. One or more Report Column must be present to define what data is displayed.

It may also optionally include a Report Empty macro, which specifies what will be displayed if no items are returned from the reporter.

Parameters

Name

Required

Migratable to Cloud?

Default Value

Description

maxResults

  • (

...

  • X)

...

  • NO

100

The maximum number of results to display.

firstResult

  • (

...

  • X)

...

  • NO

1

(Since 2.0.0) Specify the number of the first result to start displaying in the report. The first item has a number of 1.

depth

  • (

...

  • X)

...

  • NO

0

If the item has children, the depth do display its descendants. May be all for all descendants, or a whole number value above 0. (Since Reporting 1.3)

injected

  • (

...

  • X)

...

  • NO

false

If set to true, the column bodies will have any '%prefix:keychain%' values injected with values from the current report item prior to being rendered.

 

...

  • It is a good practice to set the Injection to true at on {report header}, {report body}, {report footer}, or {report column}, instead on the highest level of the report.

class (CSS Class)

  • (

...

  • X)

...

  • NO

The CSS class to render the table with.

displayTitles

  • (

...

  • X)

...

  • NO

true

If set to false, the title header row will not be displayed. (Since Reporting 1.0.1)

Editor View

...

Tutorial Examples

...

Add a dropdown filter to the Space Inline Comment Report

...

All page states within a space

...

All pages with the 'Approved' state in the last month

...

Building a Forum in Confluence with Reporting

...

Calculating Work Hours in a Day

...

Create a report to monitor project status

...

Creating an IF ELSE statement with Reporting

...

Customizing a Report with Image Attachments

...

Displaying a list of images attached to the current page

...

Extract values from page titles using regex

...

Extract values from page titles using Reporting Text Supplier

...

Extracting Scaffolding Data from Children Pages

...

Extracting Scaffolding Data from children pages and modifying values using Reporting macro

...

Generating a List of Groups for the Current User

...

Generating a List of Pages with No Label

...

Generating a List of Redirecting Pages

...

List All Comments Including Unresolved Inline Comments

...

List Comments and Replied Comments on a Page

...

Listing All the Titles of Children Pages

...

...

Anchor
notes
notes
Notes

  • When using the Date Supplier, the [date format] key has to be formatted to not break the sorting functionality. Set the following:

    • content:modification datecontent:modification date > date:"yy-MM-dd HH:mm:ss"

    • The formatting above excludes milliseconds that allow the sorting to work.

Tutorial Examples

Filter by label (Content by label)
showLabelsfalse
showSpacefalse
excerptTypesimple
cqllabel = "report-table"