...
Section | ||
---|---|---|
| ||
To create a report on documents these documents need to have properties to select upon. Only documents that meet a given query constraint must be listed in the report. The act of adding properties for selection is called tagging. A Confluence wiki page becomes a projectdoc Document by adding the Document Properties Marker Macro. The This macro expects a table with three columns to specify the properties of this document properties. A Name or a Short Description is a property, but also Tags and Type. Authors may specify any property in this table since a property is simply
As you can see the value for a property may be a simple text string (like "Reporting"), but may also be an image (not shown in this example), or a macro (like ). |
Section | ||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||
Reports may have many forms. In this short tip we'll focus on the Display Table Macro. It allows to list a number of projectdoc documents (aka Confluence pages with our Document Properties Marker Macro) that match the given query constraint. The list of results is rendered in form of a table: each document of the result is rendered in a table row, each property of the document, in a table column.
The Display Table Macro has a couple of parameters, but for this short example we focus on two of them:
Note that the name of a property you use as constraint must not contains contain spaces. ! Hence we type " The following screenshot shows the altered Where parameter. One could argue that this is not really easier to read:
But it comes with an additional feature! By using the square brackets on the side of the expected value you can make an exact match. While in the before mentioned query you may also find document with types having the string "
|
...