本文翻译自官方文档：https://confluence.atlassian.com/pages/viewpage.action?pageId=317194676

将内容报表宏添加到页面可以显示一个表格，包含带有指定标签的页面和博文，以及它们的创建者和修改日期。

此宏适用于需要一目了然地查看一组相关页面信息的情况，例如：

  • 项目页面
  • 文档控制
  • 变更管理
  • 流程文档

您可以在Meeting Notes blueprint中看到此宏的运行情况。

截图：内容报表宏，配置为显示带有“printer”标签的页面。

关于在Confluence中使用标签的文档，请参考Add, Remove and Search for Labels。

在页面中添加宏

在页面中添加Content Report Table宏：

  1. 从编辑器工具栏中，选择插入(Insert) > 其它宏（Other Macros）。
  2. 从Confluence content类别中选择Content Report Table。
  3. 输入要显示页面的标签。
  4. 使用以下参数缩小范围。
  5. 点击Insert。 

然后，您可以发布您的页面以查看宏的效果。 

截图：在内容报表宏中输入标签参数。


修改宏参数

宏参数用于设置宏的行为。

要更改宏参数：

  1. 在编辑器中，点击宏占位符并选择“编辑（Edit）”。
  2. 根据需要设置参数，然后选择“插入（Insert）”。

这是此宏中可用的参数列表。

参数

必填

默认值

描述

Label(s)
(labels) 

Yes

None

此参数是必填的。指定一个或多个标签，用逗号分隔。宏将显示包含任一指定标签的内容。

例如，如果您指定标签“A”和“B”，宏将显示具有标签“A”的所有页面、具有标签“B”的所有页面，当然也包括了同时拥有这两个标签的所有页面。

Space(s)
(spaces) 

No

(All spaces)

指定一个或多个空间，用逗号或空格分隔。该宏将仅显示属于指定空间的内容。

指定个人空间时，记得在用户名前使用波浪号 (~) 符号，例如 ~jbloggs 或 ~jblogs@example.com。

Maximum Number of Pages
(maxResults) 		No20

设置宏将在结果中显示的最大页面数量。如果要显示更多页面，宏将显示一个标有“Find more results”的链接。查看页面的人可以点击链接以转到搜索页面，该搜索页面会显示所有具有指定标签的页面。

会出现哪些页面？在显示结果之前，Confluence会按照页面上次修改的日期对它们进行排序。最近创建/更新的页面将首先出现。

如果Confluence存储格式或wiki标记中使用的参数名称与浏览器中使用的参数名称不同，则会在参数名下方用括号列出，例如（example）。

其它添加方式

用键盘输入添加宏

输入左大括号{，然后输入宏名称的几个起始字符，就可以看到一个相关的宏列表。

通过wiki标记添加宏

您不能使用wiki标记来添加此宏。