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

マクロ

このページの内容

お困りですか?

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

コミュニティに質問

ページ プロパティとページ プロパティ レポート マクロは合わせて、別のページの 1 つのページのサマリー情報を示します。意思決定および製品要件ブループリントの 2 つの操作でこれらの 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 を指定します。
タイトル列見出し Title レポート テーブルの 1 列目に表示する見出し。この列には、レポートで表示されるページへのリンクが含まれます。既定の列見出しは "Title" です。
表示する列  

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

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

表示する項目の数 30 追加アイテムのページネーション オプションを表示する前に、テーブルに表示する項目の数。
並び順 更新日

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

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

コメント数を表示 いいえ テーブルの各ページのコメント数を表示します。
イイネの数を表示 いいえ テーブルの各ページに対するイイネの数を表示します。

トラブルシューティング

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

  • ラベルを正しく入力し、ページ プロパティ マクロを含むページにラベルが表示される
  • 各ページのページ プロパティ マクロが正しく設定されている。 
  • 指定した他のフィールドによって、検索を絞り込みすぎていない (例えば、指定した親ページの下にそのラベルのページがない)。
  • There is a known issue where the Page Properties Report macro does not correctly display content from multiple Page Properties macros. See  CONF-34141 - Getting issue details... STATUS  for more information. 
最終更新日 2017 年 5 月 15 日

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

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