Renders a space property value.

Audience
Categories
Tags
Type
Content Reuse, Properties Management
Since
1.8

Renders a space property value.

Do not use as property value

 

Do not use the space property macro as a value to a document property. If the value of the space property changes, the value of the document property that references the value will not be updated.

This is different to the display document property macros (for instance Display Document Property Macro) where the update of a value will be propagated. A workaround is to reference the property value of the projectdoc document that contains it instead of referencing the space.

This behavior may change in future versions of the projectdoc Toolbox. Therefore users cannot rely on the fact that the update of a property value is currently not propagated.

If the value of a space property is required as value of a document property, using the document property control no-render-cache may help for the majority of use cases. The control forces the property value to be recalculated on each request. Note that in this case the property must not be included in a search since the Lucene index will not be updated. So it may be a good choice to also set noindex to true.


Properties

Space

The reference to the space from which the property is to be read. Note that the space may define delegate spaces or extensions to fetch the property from.

Property Name

 The name of the space property to fetch the property value.

Default Value

A default value to render, if the space property is neither set or is blank.