Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Macro Editor LabelDefaultDescriptionMacro Parameter
Page to list attachments fromMost recent attachment uploaded to the current page

Enter the location where the attachments are available. The following locations are supported:

  • page - Data is read from an attachment to the page specified here; provided that page is in the same space as the macro.
  • space:page - Data is read from an attachment to the specified page that is in the specified space.

Space key or space name regex

Enter a regular expression (regex) pattern to match with space keys or space names. Used in combination with the Page name regex parameter to select pages from which attachments are to be chosen. If left blank, the Page to list attachments from parameter is required.

The following options indicate:

  • @self - current space or page
  • @home - home page of current space
  • @parent - parent page of current page or space
Note

It is possible that in page preview, before publishing for the first time, the result for @self and @parent are not displayed as expected. Once you save the document, you can view the result as expected.


spaceRegex
Include personal spacesfalseEnable to control whether personal spaces matching Space key or space name regex are to be included or not, to process and render attachments from the specified spaces.includePersonalSpaces
Page name regex
Enter a regular expression (regex) pattern to match on page names (titles). Used in combination with the Space key or space name regex parameter to select pages from which attachments are to be chosen.pageRegex
Page label regex
Enter a regular expression (regex) pattern to match on page labels. Used in combination with the Page name regex and Space key or space name regex parameters to select pages from which attachments are to be chosen. Pages must match with every selection criteria.pageLabelRegex
Attachment name regex
Enter a regular expression (regex) pattern to match on attachment names. Used in combination with the Attachment comment regex and Attachment label regex parameters to select attachments. Attachment must match with every selection criteria.attachmentRegex
Attachment comment regex
Enter a regular expression (regex) pattern to match on attachment comments. Used in combination with the Attachment name regex and Attachment label regex parameters to select attachments. Attachment must match with every selection criteria.commentRegex
Attachment label regex
Enter a regular expression (regex) pattern to match on attachment labels. Used in combination with the Attachment name regex and Attachment comment regex parameters to select attachments. Attachment must match with every selection criteria. Matching technique is determined using the Label match option parameter.labelRegex
Label match optionsingle

Specify the manner in which to apply the Attachment label regex parameter (for attachments) and the Page label regex parameter (for pages) when looking for matching labels. The options are:

  • single: An attachment, that has at least one label that matches the Page label regex or Attachment label regex pattern, is considered as selected.
  • allPage label regex and Attachment label regex are used to match a blank separated list of all labels.
labelMatchOption
Text to display when no attachments match
Enter the text to be displayed when no attachments are found that match the given search criteria. If left blank, no text is displayed if no attachments are found.textForNone
Date formatConfluence defaultEnter a date format to format the dates in the created and modified columns. Use a simple date format string.dateFormat
Limit number of attachments to retrieve1000Enter the number of attachments that the macro must retrieve in total. Processing stops after the number of attachments found matching the selection criteria reaches the limit value. Space, page, and attachment processing is ordered by attachment name.limit
Retrieve attachments from child pagesfalse

Enable this option to list the child page attachments of the specified page in Space and Page parameters in the Page filtering tab. By default, only the attachments on the specified page are displayed. 

Note

This option works only if Single page is selected in Page filtering > Source.


fromAllChildPages

Common parameters

Include Page
info:_CommonTableCapabilitiesParametersTBLCld
info:_CommonTableCapabilitiesParametersTBLCld

...