get-metadata macro

Overview

The get-metadata macro is used on wiki pages (or content rendered to wiki pages) to retrieve and display Value References, including:

• Attribute References

• Metadata references

• Page Property References

• Parameter References

• Supplier References

• Page and User references

Where to use it?

Optional.

One or more get-metadata macros can be used in wiki content (pages, blog posts).

The macro can also be used in macros that render wiki content in the context of pages and blog posts.

Parameters

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.

Open

A simple way to display the value is to add the macro to a table cell.

Open

On the content, this retrieves and displays the current value of the metadata.

In markup notation:

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 another get-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.

All examples

See also

Workflow Authoring Guide

• Value References

• Conditions

• Events

• Triggers

• Actions

Integration Guides

• Comala Metadata app

• Communardo Metadata for Confluence app

• ServiceRocket Scaffolding Forms and Templates app