页面属性报表（Page Properties Report）宏将会在当前空间页面中显示任何使用使用页面报表宏元数据（metadata?）页面和博客页面的表格。
页面属性报表宏仅仅从含有指定标签的页面和博客页面中获取数据。
在表格的左侧显示的是包含有指定元数据的页面名称。每一个页面名称做为单一行显示一个页面的链接。
表格的其他行显示在页面属性宏中定义的字段（keys）。你可以在表格中通过单击表格的都对表格的内容进行排序。
这个宏在早期被称为细节概要宏。
页面属性（Page Properties）宏和页面属性报表（Page Properties?Report）宏的基本使用
页面属性宏被用来与页面属性报表宏进行连接。
希望使用这个宏：
- 添加页面属性宏到你的页面中，然后在宏中指定一个标签（例如，Status）。
添加一个两列表格到宏占位符中，在表格中分别对应?metadata?数据??keys?和?values。
- 在其他页面中重复上面的过程来添加页面属性宏。
- 创建一个新的页面包含你的报表（例如，状态报表）。
- 添加一个页面属性报表宏到页面中，然后制定相同的标签（例如，Status）。
- 刷新你新的报表页面状态。你页面属性宏中包含的数据将会被报表中显示。
屏幕截图：'Status' 报表实例
?
- 选择行的头来对报表进行排序。
当你添加页面属性宏到页面中后，Confluence 将会自动的将标签添加到页面中。你可以在页面中添加一个或者多个页面属性宏，但是他们将会继承同样的标签（例如，你不能有 2 个页面属性宏在同一个页面中包含有 2 个不同的标签）。
?
使用页面属性报表（Page Properties Report）宏
希望在页面中使用页面属性报表宏：
- 打开你希望编辑?Confluence 页面，然后单击?编辑（Edit）按钮。页面的编辑模式将会被打开。
- 下一步，在编辑工具栏中单击宏浏览器图标
。这时候宏浏览器将会在屏幕的中间打开。 - 在宏浏览器中，在窗口的右上角的对话框中输入你希望插入的宏的名称。当找到与你输入的宏名称接近的宏后将会在中间的面板上显示。单击需要的宏然后来查看可用进行配置的宏选项，在这里你可以对需要插入的宏设置相关参数，然后单击?插入（insert）来将需要的宏插入到页面中。
?
- 使用宏参数将标签添加到宏。
在宏浏览器中，指定一个?标签（Label）。例如，'Status'.
屏幕截图：使用指定标签的页面属性报表宏的占位符
参数
宏参数的定义为，你可以使用这些参数在宏输出的内容和格式上进行定义。
Confluence 使用的存储格式或者?wikimarkup 格式中使用的参数和在宏浏览器中使用的标签是不同的，这些将会在下面在括号内容中列出(example)。
?
标签（Label） | (None) | 确定页面属性报表使用的标签。报表将在当前空间页面中显示任何使用指定标签的页面。 |
| 限制空间（Restrict to spaces） | (None) | 如果没有确定，报表只会在当前空间中读取数据。你可以使用逗号分隔符来分隔空间的 Key，或者使用 @all 来从所有空间中显示数据。 |
| 列头标题（Title column heading） | Title | 在报表中显示的第一列，这一列显示了报表中包含的页面链接。默认的头标题为，'Title'。 |
| 显示列（Columns to show） | (None) | 如果没有确定，报表将会显示所有的列，你可以指定你希望显示的列，列名字采用逗号分隔符进行分隔。 如果你的列名字中包含有盗号，你可以使用双引号来包含列名。如果你你的列名中含有单引号，你可以使用双引号来包含这个引号。例如， "My ""new"" column, yes", Third column。 |
| 显示数量（Number of items to display） | 30 | 显示的其他数据选项之前在表中显示的数据数量数。 |
| 排序方式（Sort by） | 最后修改的时间 | 通过指定列的头来对表格进行排序。输入在页面属性宏中使用的列的名字。 选择逆向排序选择框，排序方式将会使用逆序。 |
| 显示评论数量（Show Comments Count） | No | 表格中显示评论的数量。 |
| 显示喜欢数量（Show Likes Count) | No | 表格中显示喜欢的数量。 |
?
来源：http://cwiki.ossez.com/pages/viewpage.action?pageId=2393327
?
?