projectdoc Toolbox

It is pretty easy to annotate dynamic lists with the projectdoc Toolbox on Confluence.

Audience
Type
Level of Experience
Expected Duration
5 min

Adding a note to lines of the results shown in the Display Table Macro is not supported by this macro alone. But put Table Set Macro and the Tour Macro into the mix and you're nearly done.

With this approach you are able to add information to a possibly growing list of references to matching documents. For instance you may collect links to meeting notes and add some comment to document that they have been read or commented. The comments are not part of the meeting notes page and therefore only accessible in the context of your page.

Delegate Documents

 

Another approach to add information to existing documents are delegate documents. Delegate documents transclude whole sections for all empty sections from a single referenced document and allow to transclude property values selectively. This allows to render information from another page and add additional information in other sections.

You can also use the Transclude Documents Macro or the Transclusion Macro to transclude sections from other documents selectively.

Define the Set

Provide a set of tables, define the matching column ('Name'), and 'or' table rows.

Dynamic List

Set up the dynamic list with the Display Table Macro. Note that the Name is in the first column.

Just add the additional columns you need for your notes. We are fine with one additional column called 'Notes'.

For now we simply have a table with random hits and an empty column for notes.

Notes Table

To add notes use the Tour Macro and add a table for the notes. Note that the order of columns in this second table matches that from the first one.

The line in the first table is matched with the first column. Make sure to translate the title column to document names (otherwise there will be no match):

Rendered

The rendered table will have the order from the first table and add the notes from the second.

 

In case you want to control the order of lines, simply switch the ordering of the tables. The first table defines the order.

Resources

Display Table Macro
Lists references to projectdoc documents in a table. Allows to select document properties for columns. Also non-list representations are provided.
Tour Macro
Renders a predefined list of documents in a table.
Table Set Macro
Applies a simple set operation on tables in its body.