Task Report Macro
Task Report macro showing incomplete tasks, on pages with the label 'meeting-notes'.
Parameters
Parameters are options that you can set to control the content or format of the macro output. Where the parameter name used in Confluence storage format or wikimarkup is different to the label used in the macro browser, it will be listed below in brackets (example).
Parameter | Required | Default | Description |
|---|---|---|---|
Space(s) and Page(s)(spaceAndPage) | No | None | Filter by the task location. The macro will only display tasks in the pages or spaces specified. You can enter a combination of spaces and pages. |
Label(s)(labels) | No | None | Filter by Label. The macro will only display tasks on pages with this label. You can enter multiple labels, separated by a comma. |
Assigned to(assignee) | No | None | Filter by Assignee. The macro will only display tasks assigned to the users specified. |
Created by(creator) | No | None | Filter by Creator. The macro will only display tasks created by the users specified. |
Created after(createddateFrom) | No | None | Filter by created date. The macro will only display tasks created on or after the date specified. Date must be entered as dd-mm-yyyy. |
Task status(status) | Yes | Incomplete | Show complete or incomplete tasks. |
Number of tasks to display | No | 20 | The number of tasks to display on each page of results in the table. Choose from 10, 20 or 40. |
Display columns(columns) | No | description,duedate,assignee,location | Columns to include in the table. Available columns include description, duedate, assignee, location, completedate and labels. |
Sort by(sortBy) | No | Due date | Sort tasks by due date, assignee or page title. Select the Reverse Sort check box to sort the table in reverse order. |
Code examples
The following examples are provided for advanced users who want to inspect or edit the underlying markup for a Confluence page.
Macro name: tasks-report-macro
Macro body: None.
Storage format example
Note: The spaceAndPage multi-picker parameter populates the spaces and pages parameters.
<ac:structured-macro ac:name="tasks-report-macro">
<ac:parameter ac:name="spaces">BSP</ac:parameter>
<ac:parameter ac:name="status">complete</ac:parameter>
<ac:parameter ac:name="assignees">
<ri:user ri:userkey="2c9682654373c47f014373caa68a0003"/>
</ac:parameter>
<ac:parameter ac:name="spaceAndPage">space:BSP,page:2555905</ac:parameter>
<ac:parameter ac:name="pages">2555905</ac:parameter>
<ac:parameter ac:name="labels">meeting-notes</ac:parameter>
<ac:parameter ac:name="pageSize">10</ac:parameter>
</ac:structured-macro>Wiki markup
Wiki markup is not available for this macro. You cannot add this macro via wiki markup.