頁面屬性報表（Page Properties Report）宏將會在當(dāng)前空間頁面中顯示任何使用使用頁面報表宏元數(shù)據(jù)（metadata ）頁面和博客頁面的表格。
頁面屬性報表宏僅僅從含有指定標(biāo)簽的頁面和博客頁面中獲取數(shù)據(jù)。
在表格的左側(cè)顯示的是包含有指定元數(shù)據(jù)的頁面名稱。每一個頁面名稱做為單一行顯示一個頁面的鏈接。
表格的其他行顯示在頁面屬性宏中定義的字段（keys）。你可以在表格中通過單擊表格的都對表格的內(nèi)容進(jìn)行排序。
這個宏在早期被稱為細(xì)節(jié)概要宏。
頁面屬性宏被用來與頁面屬性報表宏進(jìn)行連接。
希望使用這個宏：
添加一個兩列表格到宏占位符中，在表格中分別對應(yīng) metadata 數(shù)據(jù) keys 和 values。
當(dāng)你添加頁面屬性宏到頁面中后，Confluence 將會自動的將標(biāo)簽添加到頁面中。你可以在頁面中添加一個或者多個頁面屬性宏，但是他們將會繼承同樣的標(biāo)簽（例如，你不能有 2 個頁面屬性宏在同一個頁面中包含有 2 個不同的標(biāo)簽）。
希望在頁面中使用頁面屬性報表宏：
宏參數(shù)的定義為，你可以使用這些參數(shù)在宏輸出的內(nèi)容和格式上進(jìn)行定義。
Confluence 使用的存儲格式或者 wikimarkup 格式中使用的參數(shù)和在宏瀏覽器中使用的標(biāo)簽是不同的，這些將會在下面在括號內(nèi)容中列出(example)。
參數(shù) | 默認(rèn)值 | 說明 |
|---|---|---|
標(biāo)簽（Label） | (None) | 確定頁面屬性報表使用的標(biāo)簽。報表將在當(dāng)前空間頁面中顯示任何使用指定標(biāo)簽的頁面。 |
| 限制空間（Restrict to spaces） | (None) | 如果沒有確定，報表只會在當(dāng)前空間中讀取數(shù)據(jù)。你可以使用逗號分隔符來分隔空間的 Key，或者使用 @all 來從所有空間中顯示數(shù)據(jù)。 |
| 列頭標(biāo)題（Title column heading） | Title | 在報表中顯示的第一列，這一列顯示了報表中包含的頁面鏈接。默認(rèn)的頭標(biāo)題為，'Title'。 |
| 顯示列（Columns to show） | (None) | 如果沒有確定，報表將會顯示所有的列，你可以指定你希望顯示的列，列名字采用逗號分隔符進(jìn)行分隔。 如果你的列名字中包含有盜號，你可以使用雙引號來包含列名。如果你你的列名中含有單引號，你可以使用雙引號來包含這個引號。例如， "My ""new"" column, yes", Third column。 |
| 顯示數(shù)量（Number of items to display） | 30 | 顯示的其他數(shù)據(jù)選項之前在表中顯示的數(shù)據(jù)數(shù)量數(shù)。 |
| 排序方式（Sort by） | 最后修改的時間 | 通過指定列的頭來對表格進(jìn)行排序。輸入在頁面屬性宏中使用的列的名字。 選擇逆向排序選擇框，排序方式將會使用逆序。 |
| 顯示評論數(shù)量（Show Comments Count） | No | 表格中顯示評論的數(shù)量。 |
| 顯示喜歡數(shù)量（Show Likes Count) | No | 表格中顯示喜歡的數(shù)量。 |
下面的代碼顯示了你如何使用頁面屬性和頁面屬性協(xié)同工作并創(chuàng)建報表報表。
下面的示例程序說明了你如何使用頁面屬性宏和頁面屬性報表宏來創(chuàng)建一個 Status 報表或者 Risk 報表。
下面的代碼是提供給希望進(jìn)一步編輯 Confluence 頁面的高級用戶使用的。
宏名稱： detailssummary
宏內(nèi)容： None.
<ac:structured-macro ac:name="detailssummary"> <ac:parameter ac:name="label">status</ac:parameter></ac:structured-macro> |
{detailssummary:label=status} |
