Report On

Description

Sets the report item context to the item/key value specified.

This is useful when you wish to display several key values from a sub-item of the item currently being reported. For example, you may wish to display the full name and email address of the current page's last modifier:

{report-on:content:modifier} Last Modifier: {report-info:user:full name|link=true} ({report-info:user:email|link=true}) {report-on}

Also, it will automatically loop multiple values if the supplied key is a collection or iterator, rendering the contents against each item.

Parameters

Name

Required

Migratable to Cloud?

Default Value

Description

Name

Required

Migratable to Cloud?

Default Value

Description

[default] /key

 

  • (X)

 

 

  • NO

 

@self

The key value to display. Defaults to @self (Since 2.0.0).

injected

 

  • (X)

 

 

  • NO

 

false

(Since 2.0.0) If set to true, the body will have any '%prefix:keychain%' values injected with values from the current item prior to being rendered.

If the current value being reported on is a collection, the injection will happen on each collection item as it is processed. 

default

 

  • (X)

 

 

  • NO

 

 

The contents of this parameter will be used if the item/key is empty. It will be rendered as wiki text.

Alternately, the body of macro can also be used, if more complex wiki text is required.

separator

 

  • (X)

 

 

  • NO

 

comma

If the item/key points to a list of results, the type of separator to display between each item. May be one of the following:

  • bracket - Square brackets ('[', ']') surrounding each item.

  • brace - Braces ('{', '} ') surrounding each item.

  • comma - A comma (',') between each item.

  • paren - Parentheses ('(', ')') surrounding each item.

  • pipe - A pipe ('|') between each item.

  • newline - A line break after each item.

  • "custom" - Any other character you wish, specified between quotes.

trim

 

  • (X)

 

 

  • NO

 

 

If false, the whitespace at the beginning and end of the body will not be removed. 

Editor View

Macro Edit View

  • Not applicable.

Notes

  • Not applicable.

Tutorial Examples