This site has moved to the integrated Appfire documentation and information site for our apps.

From February 2024 this site is no longer updated.

Take a look here! If you have any questions please email support@appfire.com

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Current »

Overview

You can add a single piece or multiple pieces of metadata to a space using space-metadata macro and space-metadata-list macro

Adding a single piece of metadata to a space

To add a single piece of metadata to a space, choose the  Space Metadata (Metadata Plugin) macro in the Confluence macro browser:space metadata plugin macro browser icon

Simply add your chosen metadata name to the macro editor e.g. Department. This metadata name will be case sensitive.

space metadata insert macro window

To add the value of the metadata, Insert the macro to the page and enter the metadata value into the metadata macro placeholder.

To see the display of the space metadata value on the current page, choose the macro placeholder Edit option.

The added space metadata value is now displayed in the macro editor Preview.

The space metadata macro body accepts both plain text and simple wiki markup for the value.

The metadata is stored as un-rendered wiki markup, so in this case the value ||Squadron Leader Comala| is stored for the Department metadata. The wiki markup will create a filled cell in a table containing the text value of the metadata, Department.

squadron leader comala metadata value displayed as filled table cell

When using the macro to set a metadata that is a date and time, Confluence search and CQL will return the value as a string value unless the metadata value is added in the following format yyyyMMddHHmmssSSS.

  • for example, creating a metadata End Date with a value of Dec 2023 or 08/09/2024 will be returned as a string value and is not recognized as a date format value


Adding multiple pieces of metadata to a space

To add multiple pieces of metadata to a space, choose the Space Metadata list macro in the Confluence macro browser:

The macro editor allows you to configure the macro.

The macro editor only includes the following options for the macro:

  • display metadata as a vertical or horizontal list

  • hide the metadata from being displayed on this page

  • clear any existing metadata values of the page before setting the new metadata and values

You must Insert the macro to add the metadata names and their values using the space-metadata-list macro placeholder:

The metadata name and value can be plain text or include simple wiki markup.

In the example above the metadata and their values are rendered in a table on the page:

Existing metadata values can be cleared on adding the macro to the page by checking the Clear value option in the macro editor.

This macro is for setting metadata values for the space, not for listing existing metadata values.

When using the macro to set a metadata that is a date and time, Confluence search and CQL will return the value as a string value unless the metadata value is added in the following format yyyyMMddHHmmssSSS.

  • for example, creating a metadata End Date with a value of Dec 2023 or 08/09/2024 will be returned as a string value and is not recognized as a date format value


Related Comala Metadata macros

Other resources



  • No labels