You are viewing an old version of this page. View the current version.
Compare with Current
View Page History
« Previous
Version 3
Next »
Renders the list of child documents, matching the given filter criteria.
The macro lists child documents that meet the matcher's filter criteria.
The child documents are selected by reference and do not use a Confluence search. Therefore this macro can be used as a property value.
The use case for this macro is to be used as a property value for macros that use that value to render referenced documents.
Properties
Doctypes
The comma separated list of doctype identifiers.
Only child documents of the given doctypes are considered as match. If no doctype is specified, all doctypes are valid.
Matcher
The parameter value is a constraint the documents need to match to not be filtered from the result set.
The syntax is different from those you specify in case you run a Lucene search. As in queries you check the property values of the child documents.
If the property name you need to match is a alphanumeric token, you do not need to encode it (e.g. Year=2019). If it has a space, used $[...] as delimiters for the property name. For instance $[Customer Reference]. This is similar to the encoding used for Lucene queries with the Display Table Macro. You may also use ${...} or $<...> as delimiters. But there is no reason to do so since property names should not contain special characters. We recommend to use the square brackets ($[...]) since these are also used for Lucene queries of the property name contains a space (see Search Tips).
Values that have no spaces and are plain tokens need not to be encoded to compare with a property property value (e.g. $[Zip Code]=45672. In case there is a space, you can use quotes as in $[Customer Reference]="123 ABC".
You may also compare the property value of the document in the result set with a property value of the document the macro is part of: $[Customer Reference]=${Default Customer Reference}
You may combine your property constraints by the following Boolean operators.
| Operator | Description |
|---|
| & | AND - both properties need to match |
| | | OR - only one of the two properties need to match |
| ! | NOT - only true if the property does not match. |
Use parentheses to group your expressions.
Currently the projectdoc Toolbox does not support list searches or comparisons with greater than or less than. Only exact matches are supported.
Property Name
By default the name of the matching documents is rendered. The Property Name Parameter allows to select another property to be rendered for the link. It should be a unique property such as the Short Name or an Identifier.
