ページ プロパティ レポート マクロを挿入する

ページ プロパティとページ プロパティ レポート マクロを組み合わせて、特定のページの概要情報を別のページに表示できます。意思決定および製品要件ブループリントでこれらの 2 つのマクロの実際の例を見ることができます。  

このマクロは以前は詳細の概要マクロと呼ばれていました。 

ページにページ プロパティ レポート マクロを追加する

ページ プロパティ レポート マクロをページに追加するには、次の手順を実行します。

1. エディタで、[挿入] > [その他のマクロ] > [ページ プロパティ レポート] を選択します。

2. レポートの対象となるラベルを入力します。これはページ プロパティ マクロを含むページに追加されたラベルです。

3. フィールドを追加したり、ページ プロパティ ID (詳細は以下を参照) を指定したりして、検索をさらに絞り込みます。

4. [挿入] をクリックします。

マクロはページで以下のように表示されます。

その設定方法は次のとおりです。

特定のページ プロパティ マクロのレポート

1 つのページに複数のページ プロパティ マクロを追加して、レポートにすべてのマクロを含めるか、特定のマクロのみを含めるかを選択できます。ページ プロパティ マクロには、個々のページ プロパティ マクロの識別に使用できるオプションの ID パラメーターが含まれます。

それぞれのコンテンツを表示するには、次のようにします。 

• 選択したページ プロパティ マクロをレポートに表示 - 対象のページのラベルと、ページ プロパティ マクロの ID ([オプション] 配下) を指定します。

• すべてのページ プロパティ マクロ をレポートに表示 - ページのラベルのみを指定し、ページ プロパティ ID フィールドは空白のまま残します。

CQL フィールド

CQL (Confluence クエリ言語) は Confluence 用に開発されたクエリ言語で、マクロの一部や Confluence 検索で使用できます。Confluence 検索と CQL を活用するマクロにより、検索クエリを構築するためのフィルターを追加でき、検索結果を絞り込むのに必要なだけフィルターを増やせます。クエリにフィルターを追加するには、[フィルターを追加] リンクを選択します。

以下の CQL フィルターを使用できます。

AND、OR、NOT 演算子

• OR 検索の場合は、同じフィールドに複数の値を指定します。
  'label-a' もしくは 'label-b'、またはそれらの両方を含むページを表示するには、同じラベル フィールドに 'label-a' と 'label-b' を指定します。
  
  

• AND 検索の場合は、複数のフィルターを追加して、それぞれに値を 1 つずつ指定します。
  label-a と label-b のページだけを表示するには、1 つのラベル フィールドに「label-a」を入力してから、マクロに 2 つ目のラベル フィールドを追加して、2 番目のフィールドに「label-b」を入力します。
  
  つまり、OR 値は同じフィルターに、AND 値は異なるフィルターに入力します。
  AND は一部のフィルターでのみサポートされます。AND 演算子がサポートされていないフィルターの場合は、複数のフィルターを追加できません。  

• NOT 検索の場合は、マイナス記号 (-) をラベルの前に入力します。これにより、そのラベルを含むものはすべて除外されます。

* このフィールドは CQL で動作するマクロに必須です。

**CQL で動作するマクロにこれらのフィルターを追加できますが、検索する際にこれらは標準の検索フィルターの一部となっているため、[フィルターを追加] メニューには表示されません。

マクロの表示オプション

ページでのマクロの表示方法を次のオプションで制御します。

トラブルシューティング

レポートが空白の場合、以下を確認してください。

• ラベルを適切に入力していて、ページ プロパティ マクロを含むページにそのラベルが表示されていること。

• 各ページのページ プロパティ マクロが適切に構成されていること。 

• 指定した他のフィールドで検索を絞り込みすぎていない (例: 指定した親ページの下にそのラベルを持つページがない) こと。