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

页面属性宏和页面属性报告宏通常会一起使用，使您能够在另一页上显示一个页面的概要信息。您可以在Decision和Product Requirements 蓝图上看到这两个宏的示例。

在页面中添加宏

在页面中添加Page Properties Report宏：

  1. 在编辑器中，选择“Insert”>“Other Macros”>“Page Properties Report”。
  2. 输入要报告的Labels——这是添加到包含页面属性宏的页面的标签。
  3. 通过添加更多字段或指定页面属性宏的ID来进一步缩小搜索范围（详见下文）
  4. 点击 Insert。

以下是宏在您的页面上的显示效果：

这是在宏浏览器中设置它的方法：

报告指定的页面属性宏

可以在一个页面上添加多个页面属性宏，并选择是在报告中包含所有宏还是仅包含指定的宏。页面属性宏包括一个可选的ID参数，可用于标识特定的页面属性宏。

显示以下内容：

  • 在报告中指定的Page Properties macros - 指定页面标签和特定页面属性宏的ID（在Options下）
  • 在报告中包含所有Page Properties macros - 仅指定页面标签 - 设置页面属性ID字段为空白。

注意：页面属性报告宏只能接受一个ID。 

宏显示选项

以下选项控制宏在页面上的显示方式。

参数默认值描述
Page Properties IDBlank

如果未指定，报告将显示页面上所有页面属性宏的数据，即使其中有多个宏。指定一个 ID则仅包含来自具有相同ID的页面属性宏的数据。

Title column headingTitle

显示在报告表第一列的标题。此列包含指向报告显示的页面的链接。默认列标题为“Title”。

Columns to show

如果未指定，报告将显示所有列。您可以指定要包含的以逗号分隔的列的列表。

如果您的列标题包含逗号，请在列名上使用双引号。如果您的列标题包含单引号，请使用双引号。例如，A column, "My ""new"" column, yes", Third column

Number of items to display30

要在表中显示的条目数。

宏最多可以显示3000个页面。系统管理员可以增加或减少此限制。最好使用分页，而不是一次性列出所有页面。

Sort byModified

按特定列标题对表格进行排序。输入列名称，与在相应的页面属性宏中显示的完全相同。

选择“Reverse Sort”复选框可以反向排序。

Show Comments CountNo显示表格中每个页面的评论数量。
Show Likes CountNo显示表格中每个页面的点赞数量。

故障排除

如果您的报告为空，请检查：

  • 您已正确输入标签，并且该标签确实出现在包含页面属性宏的页面上。
  • 每个页面上的Page Properties macros都配置正确。
  • 按您指定的其它字段没有找到对应的页面（例如，您指定的父页面下没有带有该标签的页面）。

限制

您最多可以在宏浏览器中输入60个标签。

宏最多可以显示3000个页面。系统管理员可以使用pagePropertiesReportContentRetrieverMaxResult系统属性增加或减少此限制。