Confluence 页面属性报表(Page Properties Report)宏

页面属性报表(Page Properties Report)宏将会在当前空间页面中显示任何使用使用页面报表宏元数据(metadata )页面和博客页面的表格。

页面属性报表宏仅仅从含有指定标签的页面和博客页面中获取数据。

在表格的左侧显示的是包含有指定元数据的页面名称。每一个页面名称做为单一行显示一个页面的链接。

表格的其他行显示在页面属性宏中定义的字段(keys)。你可以在表格中通过单击表格的都对表格的内容进行排序。

这个宏在早期被称为细节概要宏。

页面属性(Page Properties)宏和页面属性报表(Page Properties Report)宏的基本使用

页面属性宏被用来与页面属性报表宏进行连接。

希望使用这个宏:

  1. 添加页面属性宏到你的页面中,然后在宏中指定一个标签(例如,Status)。
  2. 添加一个两列表格到宏占位符中,在表格中分别对应 metadata 数据  keys 和 values

  3. 在其他页面中重复上面的过程来添加页面属性宏
  4. 创建一个新的页面包含你的报表(例如,状态报表)。
  5. 添加一个页面属性报表宏到页面中,然后制定相同的标签(例如,Status)。
  6. 刷新你新的报表页面状态。你页面属性宏中包含的数据将会被报表中显示。

    屏幕截图:'Status' 报表实例
     
  7. 选择行的头来对报表进行排序。

当你添加页面属性宏到页面中后,Confluence 将会自动的将标签添加到页面中。你可以在页面中添加一个或者多个页面属性宏,但是他们将会继承同样的标签(例如,你不能有 2 个页面属性宏在同一个页面中包含有 2 个不同的标签)。

 

使用页面属性报表(Page Properties Report)宏

  1. 希望在页面中使用页面属性报表宏:

    1. 打开你希望编辑 Confluence 页面,然后单击 编辑(Edit)按钮。页面的编辑模式将会被打开。
    2. 下一步,在编辑工具栏中单击宏浏览器图标。这时候宏浏览器将会在屏幕的中间打开。
    3. 在宏浏览器中,在窗口的右上角的对话框中输入你希望插入的宏的名称。当找到与你输入的宏名称接近的宏后将会在中间的面板上显示。单击需要的宏然后来查看可用进行配置的宏选项,在这里你可以对需要插入的宏设置相关参数,然后单击 插入(insert来将需要的宏插入到页面中。
      

     

  2. 使用宏参数将标签添加到宏。
    在宏浏览器中,指定一个 标签(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

猜你喜欢

转载自osseztec.iteye.com/blog/2022670