projectdoc Toolbox

Renders the list of child documents, matching the given filter criteria.

Audience
Categories
Tags
Since
3.2

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.

OperatorDescription
&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.

Example Matcher Expression with !, |, and &

 
!($[Property A]="Value 1" | !$[Property B] = "Value 2") & $[Property C] = "Value 3"

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.

Related Macros

The following macros can take advantage of the Child Documents Macro.

Transclusion Reference Macro
Transcludes content via a reference from a document marked with the content marker macro.
Tour-by-Property Macro
Renders a predefined list of documents in a table . Documents are selected by a document property. Allows to select document properties for columns. Also non-list representations are provided.
Document Properties Supplier From Documents Macro
Import properties from another projectdoc document.

The macro is related in function to the Parent Property Macro. While that macro creates a name reference to the parent document, the Child Documents Macro links to the child documents.