Comment Aggregation (v 3.0)
What is the Macro Used for?
The macro is used to summarize the comments and inline comments on your processes clearly.
All comments and inline comments for the process and sub processes are taken into account. To make work easier, edited comments can be marked as "resolved".
Add Macro
Read the steps to learn and use the macro. The following sub chapters are divided based on the use cases of the macro.
User information
Switch to the edit mode of your page to insert the macro into the page. To do this, simply type "e" or click the "Edit" button.
Navigate to a position within your page where you like to insert the macro.
Click either on the + button in the menu navigation bar and select the macro.
OR add the macro by typing the curly bracket and the name of the macro { Comments aggregation.
For configuring your macro, click on the macro again and then the "Edit- button".
Independently which way you go, the edit mode is displayed the same.
Enter the name of the process of which you want to see the latest comments. You can also see the comments and inline comments of the related process steps.
Select the required parameters and save your changes (see table below).
You have successfully added the macro to your page.
Resolve Comments
User information
For normal Confluence comments on a page (i.e. those which are not inline comments) the status "resolved" is only visible in the macro. The comment on the source page is not showing this information.
You can use the Resolve action of a comment shown in the macro to mark it as resolved.
The status badge will be updated accordingly and the action will change from Resolve to Unresolve. This allows you to undo your change and mark the comment as still open and not yet resolved. To hide the manually resolved comments from the result list, you can use the Reload button or refresh the page.
When clicking on the link next to the icon you will be sent to the original comment. This way you have quick access to the normal operations like editing, deleting or replying.
Resolve Inline Comments
The macro handles Confluence inline comments the same way as the normal page comments. However, you can also resolve the inline comment directly on the source page. The macro will reflect this change when it is refreshed.
Configure Macro Parameters
You can configure the macro with the following parameters.
For configuring the macro switch to the edit mode of your page, select the macro and then click "Edit".
| Parameter | Default | Description | |
|---|---|---|---|
| Page of the process | empty | *obligatory | Select the process of whom the comments should be shown. The comments of the related subprocesses are also displayed. |
| Order | Ascending | optional | The order of the comments depending on their modification date. Choose between adscending or descending. |
| Comment Status | Resolved | optional | Select whether you want to view resolved or unresolved comments. |
| Number of comments to be displayed | 10 | optional | Number of comments displayed in the view. |