For some type of properties it is useful to query for a given value or its ancestors. E.g. if you want to have all documents relevant for the Quick Response Team (QRT), a role derived from Ops, you may want to collect all documents marked with either QRT or Ops. Code Block |
---|
| $<Audience> = ^QRT^ |
This is not only a shortcut for not listening all parents. If you add the following to the role template, the document will show all documents relevant for the role: Code Block |
---|
| $<Audience> = ^${Name}^ |
Note that in the above example Audience is a property of a document that refers to documents of type Role. The hierarchy is defines on role documents. It may be confusing for new uses if they assume that the hierarchy is defined on the document containing the the Audience property. If you need to search the hierarchy down the tree, use "° " instead of "^ ". So "° " stands for downstream, "^ " for upstream search. Caution Box |
---|
Ancestor queries are based on the property information in the blueprint of a document type. Document authors cannot define hierarchies based on document instances. It is the job of template authors to do this. If you encounter unexpected results, you may want to refresh your caches, especially the doctype cache. Please refer to Cache Refresh Actions for details. |
|