The Page Properties macro enables you to embed data on a page and then display that data in tabular form on another page . You can put the Page Properties macro on as many pages as you like and use the Page Properties Report macro to display the collected data on one page. You can also choose to hide the metadata on the pages that contain the Page Properties macro.

This macro was previously known as the Metadata Details macro.

On this page:

関連ページ

Basic usage of the Page Properties and Page Properties Report macros

ページ プロパティ マクロは、ページ プロパティ レポート マクロと組み合わせて使用されます。  

マクロを使用するには、次の手順を実行します。

  1. ページ プロパティ マクロをページに追加し、ラベル (ステータスなど) を指定します。

  2. メタデータ キーと値のマクロ プレースホルダーの本文に 2 列のテーブルを追加します。

  3. このプロセスを繰り返して、ページ プロパティ マクロを他のページに追加します。
  4. レポートを含む新しいページ (ステータス レポートなど) を作成します。
  5. ページ プロパティ レポート マクロを追加し、同じラベル (ステータスなど) を指定します。 
  6. View your new status report page. The data contained in your Page Properties macros display in the report.

    Screenshot: example 'Status' report 

     
  7. レポートを並べ替えるには、列見出しを選択します。 

When you insert the Page Properties macro on a page Confluence automatically adds the label to the page. You can add more than one Page Properties macro to the page, but they will inherit the same label (e.g. you cannot have two Page Properties macros with different  labels on the same page). 

Using the Page Properties macro

  1. Add the Page Properties macro to the page:

    1. In the Confluence editor, choose Insert > Other Macros.
    2. Find and select the required macro.

    オートコンプリートでマクロを素早く入力する方法

    Type { and the beginning of the macro name, to see a list of suggested macros. Details are in Using Autocomplete.

    既存のマクロを編集する方法: マクロのプレースホルダをクリックして、[編集] を選択します。マクロのパラメータが編集可能な場合、マクロのダイアログ ウィンドウが開きます。

  2. Add a label to the macro, using the macro parameters.
    In the macro browser, add a Label. For example, "Status".
      

  3. Add metadata keys and values as rows in a table, in the body of the macro placeholder. 
    In the macro body add a two column table. In the left column specify the keys (these will be the column headings in your report). In the right column specify the values for each key.

    Screenshot: The macro placeholder in the Confluence editor

パラメーター

パラメータは、マクロ出力の内容や形式を制御するために設定するオプションです。

パラメーター

既定

説明

ラベル

(なし)

The label used to identify the metadata on this page. Confluence will add this label to the page. Any additional Page Properties macros will inherit this label.
非表示Falseページ プロパティ マクロのデータを現在のページに表示するかどうかを決定します。この設定は、ページ プロパティ レポート マクロの詳細表示に影響しません。

例

The following examples outline how you can use the Page Properties and Page Properties Report macros together to create a Status Report or a Risk Report. 

In this example we wish to create a Status Report page that displays project status metadata from a number of pages.

The label in this example is 'status'

The keys in this example are:

  • Deadline
  • Project Status
  • Team.

The values for each key are:

  • Deadline: 1 June, 15 November and so on.
  • Project status:  Not started, In progress, Complete.
  • Team: Purple Monkeys, Green Parrots.

The Page Properties macro on each page looks like this:

Screenshot: two examples of the Page Properties macro from different pages showing values for each key.

   

The label keys are the same on each page. The values are different.

The Page Properties Report macro on the Status Report page looks like this:

Screenshot: Page Properties Report macro with the label 'Status'

The final Status Report page looks like this, with a row for each page: 

Screenshot: Example of the Page Properties Report macro showing data

Want to see this example in action? The following pages were created in this documentation space to create this example.

In this example we wish to create a Risk Report page that displays project risk metadata from a number of pages.

The label in this example is 'risk'

The keys in this example are:

  • 影響
  • Risk Level.

The values for each key are:

  • Impact: critical, high, medium, low
  • Risk Level:  major, minor, trivial.

The Page Properties macro on each page looks like this:

Screenshot: example of the Page Properties macro from one page.

The Page Properties Report macro on the Risk Report page looks like this:

Screenshot: Page Properties Report macro with the label 'Risk'

The final Risk Report page looks like this, with a row for each page: 

Screenshot: Example of the Page Properties Report macro showing data

Want to see this example in action? The following pages were created in this documentation space to create this example.

コー​​ドの例

参照先:

注意

  • If you add a label to the parameter in the Page Properties macro, Confluence adds the label to the page.
    • If you remove the label from the Page Properties macro, the label remains on the page.
    • If you remove the label from the page but leave it in the Page Properties macro, Confluence puts the label back onto the page.  
  • You can add many Page Properties macros per page, however all Page Properties macros on the page will have the same labels applied to them.  For example, if you add two Page Properties macros on a page, one with the label "risk" and the other with the label "status", both sets of metadata will appear in the Page Properties Report macro for the "status" label and for the "risk: label. This is true even if you have specified just one label in each Page Properties macro. It is the labels on the page that matter, not the labels in the macros.
  • ページ内や Confluence ページの他の場所からメタデータを使用してメタデータを参照することはできません。

Other metadata macros

There are other metadata macros, which are not supported or documented on this page but which are worth mentioning:

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.