博客

页面属性（Page Properties）宏是可以嵌入在页面上的数据，然后这个嵌入的数据可以另一个页面上以表格形式显示。

你可以和使用

页面属性报表宏

一样在一个页面中插入多个页面属性宏。

你也可以选择隐藏包含有页面属性宏页面的 metadata 数据。

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

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

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

希望使用这个宏：

1. 添加
   
   页面属性宏
   
   到你的页面中，然后在宏中指定一个标签（例如，Status）。

2. 添加一个两列表格到宏占位符中，在表格中分别对应 metadata 数据
   
   keys
   
   和
   
   values
   
   。

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

   
   屏幕截图：’Status’ 报表实例
   
   
   

7. 选择行的头来对报表进行排序。

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

使用页面属性（Page Properties）宏

1. 
   
   希望在页面中使用页面属性（Page Properties）宏
   
   
   

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

   
   
   

2. 
   使用宏参数添加一个标签到宏
   
   
   在宏浏览器中，添加一个标签（
   
   Label
   
   ）。例如： “Status”。
   

3. 
   添加 metadata 关键字和值在表格行中，这个在宏占位符的内部。
   
   
   在宏的占位符内部，添加一个 2 列表格。在表格的左列指定
   
   键值（keys）
   
   这个键值被用来在报表宏中显示头，你必须使用纯文本。在表格的右列为每一个键值指定一个
   
   值（values）
   
   。

   
   屏幕截图：
   
   Confluence 编辑器的
   
   宏占位符
   

   

参数

宏参数的定义为，你可以使用这些参数在宏输出的内容和格式上进行定义。

Confluence 使用的存储格式或者 wikimarkup 格式中使用的参数和在宏浏览器中使用的标签是不同的，这些将会在下面在括号内容中列出(

example

)。