Report Body
Description
This macro contains the wiki code which will be executed for each item of the surrounding report.
It is used by the Report Block and Report List macros. It will usually contain one or more uses of the Report Info macro to display reported values.
Parameters
Name | Required | Migratable to Cloud? | Default Value | Description |
---|---|---|---|---|
trim |
|
| false | If set to true, the body will be have any whitespace at the beginning or end trimmed before being displayed. |
injected |
|
| false | (Since 2.0.0) If set to true, the body will have any '%prefix:keychain%' values injected with values from the current report item prior to being rendered. |
Editor View
Macro Edit View
Not applicable.
Notes
Quick Examples
List the Children of the Current Page
{report-list} {content-reporter:scope=@self > children} {text-sort:content:title} {content-reporter} {report-body}{report-info:content:title|link=true}{report-body} {report-list}
Keychain Injection
Output the title and excerpt of each child page. As you can see, you can mix injected properties and standard calls.
{report-block} {local-reporter:content:children} {local-reporter} {report-body:injected=true} h2. %content:title% {report-info:content:excerpt|render=wiki} {report-body} {report-block}
Conditional Display
From Reporting 2 onwards report-body can be displayed conditionally based on filters (e.g. text-filter). This is done by putting any filters the current item must match immediately before the report-body definition. For example:
{report-block} {local-reporter:content:children} {report-body}This is always output.{report-body} {text-filter:content:title|include=FOO.*} {user-filter:content:creator|user=bob} {report-body}Only children who's title starts with FOO and were created by Bob will have this displayed.{report-body} {report-body}This is always output too.{report-body} {report-block}
Tutorial Examples
- Getting the second last entry from Table Data
- Making a List of Pages by Displaying Only a Part of the Title
- Creating an IF ELSE statement with Reporting
- Listing All Available Spaces
- Returning the Number of Pages in a Space by Date Filter
- Multiple Ways to Use Expanding Reporter
- Including All Child Pages
- Displaying a List of Only Grandchildren Pages
- Displaying a List of Children for a Page with Customized Details
- Create a report to monitor project status
- Showing recently updated pages
- Checking Whether a Page Exists
- Message banners for pages