Table of Contents | ||||||||
---|---|---|---|---|---|---|---|---|
|
Overview
Excerpt | ||
---|---|---|
| ||
Retrieve and display Value References |
The {get-metadata}
macro macro is used on wiki pages (or content rendered to wiki pages) to retrieve and display Value References, including:
Where to use it?
Optional.
One or more {get-metadata}
macros can be used in wiki content (pages, blog posts).
It The macro can also be used in macros that render wiki content in the context of pages and blog posts.
Filter by label (Content by label) | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Info |
---|
...
Can also be used in page templates and blueprints. |
Parameters
Parameter | Required | Default | Notes | Ver |
---|---|---|---|---|
| The metadata or value reference to display |
| 3.0.3+ |
Example
To retrieve a value reference called @Project Lead@
, add the {get-metadata}
macro to content using the macro editor to add the metadata name (note: no @
symbols).
...
.
...
o
Do not include the @
symbols when adding the value reference name to the macro editor.
A simple way to display the value is to add the macro to a table cell.
...
On the content, this retrieves and displays the current value of the metadata.
...
In markup notation:
Code Block | ||||
---|---|---|---|---|
| ||||
{get-metadata:name=Project Lead} |
Info |
---|
...
Metadata values created with |
...
the set- |
...
metadata macro are only indexed by Confluence and appear in the Confluence search if the Comala Metadata app is installed. |
Metadata retrieval logic
The following may cause problems when trying to retrieve a metadata value using the get-metadata
macro.
For example
in Comala Document Management versions prior to v6.18.8 using a
get-metadata
macro to define a page property value where the metadata being retrieved is the value of anotherget-metadata
macro
The retrieval logic of the get-metadata
macro may also have problems returning a value if there is any coincidence (or overlap) in a metadata name and another metadata or property name. To avoid any problem simply try to ensure the use of unique names for each of your metadata names.
Suppose duplication of a value reference name occurs, for example, a page property and metadata set with the Comala set-metadata macro. In that case, the get-metadata
macro will resolve the value in the following priority.
Insert excerpt | ||||||||
---|---|---|---|---|---|---|---|---|
|
All examples
Filter by label (Content by label) | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
|