Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
maxLevel3
minLevel2
absoluteUrltrue
excludeSee also
typeflat
separatorpipe

Overview

The users-report macro generates a report for matching users, showing the values of the chosen metadata attached to the user.

For users with personal spaces, the metadata is fetched from the personal space, while for regular users (without a personal space) the metadata is retrieved from their profile.

Metadata can either be posted to a user's profile or to their personal space, and then reports generated. For example

  • every user in a company could be requested to attach personal metadata such as work phone, cell phone, location etc. A company directory can then be generated that includes all of this information.

The users-report macro can be used when setting up hierarchical space.

Parameters

Parameter

Required

Default

Notes

Version

value-name

(tick)


The list of fields (columns) as a comma separated list to be included in the report. This can include added metadata and internal metadata.


maxResults


500

Limits the number of results


Usage

To retrieve the metadata from users with personal spaces and from regular users profiles (without personal spaces), choose Users Report macro in the Confluence macro browser:

...

Filter by label (Content by label)
showLabelsfalse
showSpacefalse
cqllabel = "metadata-report-macro" and space = currentSpace ( )

Related documentation