Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Import Macro Repair

...

Description

This filter will ensure that the specified prefix:key value matches the required Confluence content value.

It will check if the specified key chain value matches the criteria, such as its space, type, scope, or labels. These options are very similar to those provided by the Content Reporter, but can be used in other contexts.

This macro must be used within a reporter macro.

Parameters

Name

Required

Migratable to Cloud?

Default Value

Description

[default] /key

  • Status
    title(/)

...

  • Status
    titleNO

The key value to filter on. May be @self to filter on the current report item.

space(s)

  • Status
    title(

...

  • X)

  • Status
    titleNO

@self

The list of spaces to search in. Each space may be prefixed by either "+" (to indicate the space is required) or "-" (to indicate the space must be excluded). May be one of the following:

  • @self - (default) The space the current content is in.

  • @personal - Personal spaces only.

  • @global - Global spaces, that is, non-personal spaces.

  • @all - All spaces, both global and personal.

  • SPACE KEY - Any other space key may be specified explicitly.

type(s)

  • Status
    title(

...

  • X)

  • Status
    titleNO

all

The list of content types to allow. Each type may be prefixed by either a "+" (to indicate it is require) or "-" (to indicate it must be excluded). May be any of the following: 

  • page

  • news

  • comment

  • attachment

  • spacedescription

scope

  • Status
    title(

...

  • X)

  • Status
    titleNO

List of pages, news items, etc. which are in scope.

If the content is a page, the scope can be expanded to their children, descendants or ancestors:

  • > children - The direct children of the specified page. e.g.: "scope=My Page > children"

  • > descendents - All descendants of the specified page. e.g.: 'scope="My Page" > descendents'

  • > ancestors - All ancestors of the specified page. e.g.: "scope=My Page > ancestors"

label(s)

  • Status
    title(

...

  • X)

  • Status
    titleNO

List of label checks.

e.g.: "one, +two, -three" would list content which has the "two" label but not the "three" label.

matchAll

  • Status
    title(

...

  • X)

  • Status
    titleNO

true

If set to false, content matching any of the criteria will be matched. 

Editor View

...

Macro Edit View

  • Not applicable.

Notes

Display all children with the 'foo' label

Code Block
{report-list}
  {local-reporter:content:children}
    {text-sort:content:title}
    {content-filter:@self|labels=+foo}
  {local-reporter}
 
  {report-body}{report-info:content:title|link=true}{report-body}
 
{report-list}

...

Tutorial Examples

...

Tutorial Examples

Filter by label (Content by label)
showLabelsfalse
showSpacefalse
excerptTypesimple
cqllabel = "content-filter"