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

マクロ

このページの内容

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

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

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

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

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

  1. エディタで、[挿入] > [その他のマクロ] > [ページ プロパティ レポート] を選択します。
  2. レポートの対象となるラベルを入力します。これはページ プロパティ マクロを含むページに追加されたラベルです。
  3. フィールドを追加したり、ページ プロパティ ID (詳細は以下を参照) を指定したりして、検索をさらに絞り込みます。
  4. [挿入] をクリックします。

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

マクロ ブラウザでのセットアップは次のようになります。

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

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

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

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

: ページ プロパティ レポート マクロでは、ID は 1 つのみ許可されます。  

CQL フィールド

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

フィールドの追加リンクを使用し、クエリに付加フィルターを追加します。
 

AND、OR、および NOT 演算子を使用する
  • OR 検索の場合、1 つのフィールドに複数の値を指定します。
    "label-a" または "label-b"、またはそれらの両方を含むページを表示するには、1 つのラベル フィールドに "label-a" と "label-b" を以下のように指定します。
  • AND 検索の場合、1 つ以上のフィルターを追加し、それぞれに値を 1 つずつ指定します。
    label-a と label-b を含むページのみを表示するには、1 つのラベル フィールドに "label-a" を指定し、マクロに次のように 2 つ目のフィールドを追加して、そこに "label-b" を指定します。

    つまり、OR の値は同じフィルタに、AND の値は異なるフィルタに入力します。
    AND は一部のフィルタでのみサポートされます。AND 演算子がサポートされていないフィルタの場合、フィルタを追加することはできません。  
  • NOT 検索の場合は、マイナス記号 (-) をラベルの前に入力します。これにより、そのラベルを含むものはすべて除外されます。


クエリを構築する際は、以下の CQL を使用できます。

フィルター説明 演算子
ラベル*

このラベルを持つページ、ブログ投稿、または添付ファイルを含む。

OR (同じフィルター内の複数の値)

AND (複数のラベル フィルタ)

先祖あり

このページの子ページを含む。

これによってマクロを 1 つのページ ツリーに限定できます。

OR (同じフィルター内の複数の値)
投稿者**

これらのユーザーが作成または編集したページまたはブログ投稿を含む。

OR (同じフィルター内の複数の値)
作成者

このユーザーが作成した項目を含む。

OR (同じフィルター内の複数の値)
ユーザーのメンションあり

これらのユーザーをメンションするページやブログ投稿を含む。

OR (同じフィルター内の複数の値)
親ありこのページの直下の子ページのみを含む (以降のサブページは含まない)。EQUALS (1 ページのみ)
スペース内**このスペースの項目を含む。OR (同じフィルター内の複数の値)
テキストを含む**このテキストを含む項目を含む。CONTAINS (1 つのワードまたはフレーズ)
タイトルありタイトルにこのテキストを持つ項目を含む。CONTAINS (1 つのワードまたはフレーズ)
同一タイプ**ページ、ブログ、添付ファイルのみを含める。OR (同じフィルター内の複数の値)

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

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

マクロの表示オプション

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

パラメーター既定説明
ページ プロパティ ID空白この値が指定されない場合、レポートはページ上にある複数のページ プロパティ マクロすべてのデータを示します。ID を指定することで、同じ ID を使用するページ プロパティ マクロからのデータのみを含めることができます。
タイトル コラム見出しタイトルレポート テーブルの 1 列目に表示される見出しです。この列には、レポートで表示されるページへのリンクが含まれます。既定の列見出しは "タイトル" です。
表示する列

この値が指定しない場合、レポートはすべての列を表示します。含める列をカンマ区切りテキストで指定できます。

列見出しにカンマが使用されている場合、列名を二重引用符で囲みます。列見出しに引用符が使用されている場合は、二重引用符を使用します。例: A column, "My ""new"" column, yes", Third column

表示するアイテム数30

テーブルで、追加アイテムのページネーション オプションを表示する前に表示するアイテムの数。

クロは最大 3000 ページを表示できます.システム管理者はこの上限を増減できます。ページすべてをまとめて一覧にするのではなく、ページ区切りを使用することをおすすめします。

並び替え順序最終変更日

特定の列見出しでテーブルを並べ替えます。対応するページ プロパティマクロの表記と同じ列名を入力します。

逆順ソート チェックボックスをオンにすると、逆順で表をソートします。

コメント件数の表示いいえテーブルの各ページのコメント数を表示します。
「いいね!」件数の表示いいえテーブルの各ページに対する "いいね!" の数を表示します。

トラブルシューティング

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

  • ラベルを適切に入力していて、ページ プロパティ マクロを含むページにそのラベルが表示されていること。
  • 各ページのページ プロパティ マクロが適切に構成されていること。 
  • 指定した他のフィールドで検索を絞り込みすぎていない (例: 指定した親ページの下にそのラベルを持つページがない) こと。

制限事項

マクロ ブラウザーには、最大 60 個のラベルを入力できます。

クロは最大 3000 ページを表示できます.システム管理者は pagePropertiesReportContentRetrieverMaxResult システム プロパティを使用して、上限値を増減できます。

最終更新日 2021 年 11 月 24 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.