Parent Property Macro

Renders the property of the parent document, if it has the same doctype.

Audience
Template Author
Categories
Link / Document
Tags
Type
Dynamic Navigation

The Parent Property Macro allows template authors to reference a document property of the parent document. If such a document is moved to another document tree, the referenced parent property is automatically updated.

This macro is especially useful to add the name of the parent document to the properties table to be printed.

Properties

The macro provides the following properties.

Property Name

The name of the property in the parent document to references.

Parent Doctype

The name of the type of the parent document to be actually considered a parent. If the document type differs, the document is considered to have no parent.

If the macro parameter is empty, the parent is required to have the same type as the referencing document.

Since version 2.0 the value may be set to #ANY. In this case any projectdoc document is considered to be a valid parent.

Multiple values must be separated by comma.

If checked, a link to the parent is rendered. Otherwise it is not.

Append

Check if the Append Text is actually to be appended. If unchecked, the Append Text is prepended.

Append Text

The text to be appended to the referenced property value.

Default Value

A default value to render, if the document has no parent. Usually this property is left blank.

Prepend Newline

If checked, signals that a newline is to be rendered before the property.

Related macros

Name Short Description Tags
Child Documents Macro
Renders the list of child documents, matching the given filter criteria.
Display Document Properties Macro
Renders a template with property references.
Display Document Property As Image Macro
Renders the value of a document property as an image. The property value is required to an URL that points to an image.
Display Document Property As Link Macro
Renders the value of a document property as a link with an alternative label.
Display Document Property As List Macro
Renders the list value of a document property.
Display Document Property Macro
Renders the value of a property of a document.
Display Document Property Ref Concat Macro
Displays a single property of a document that is referred by a property of another document and concatenates it with the value of a local property.
Display Document Property Ref Macro
Displays a document property from a referenced document.
Display Space Attribute Macro
Renders a space attribute value.
Display Space Property Macro
Renders a space property value.
Name List Macro
Lists references to projectdoc documents. The rendering will add a link to a document, if there is a document with the given name.

Resources

Parent
The property references the higher ranked document, typically of the same type as the child document. Usually the parent is a more general form of the child or is in some other ways a structuring instance.
Parent Property of projectdoc Documents
projectdoc documents typically provide a property named 'Parent Property'. This property refers to a logical parent. This tip shows what this is all about.
adjust-title-on-any-parent
Controls the generation of the document title by adding the parent document's title in any case.
Materialize Properties
Using existing properties from other documents.