コンテンツ プロパティ レポート マクロを挿入する
The content properties and content properties report macro work together to enable you to show summary information from one page or live doc on another page or live doc. You can see examples of these two macros in action on the Decision and Product Requirements blueprints.
このマクロは、以前はページ プロパティ レポート マクロと呼ばれていました。
ページまたはリアルタイム文書にコンテンツ プロパティ レポート マクロを追加する
ページまたはリアルタイム文書にコンテンツ プロパティ レポート マクロを追加するには:
エディターで、「
/contentpropertiesreport」と入力しますレポートの対象となるラベルを入力します。これはコンテンツ プロパティ レポート マクロを含むページとリアルタイム文書に追加されたラベルです。
フィールドを追加したり、コンテンツ プロパティ ID (詳細は以下を参照) を指定したりして、検索をさらに絞り込みます。
[挿入] をクリックします。
マクロは次のように表示されます。
その設定方法は次のとおりです。
特定のコンテンツ プロパティ マクロのレポート
1 つのページまたはリアルタイム文書に複数のコンテンツ プロパティ レポート マクロを追加して、レポートにすべてのマクロを含めるか、特定のマクロのみを含めるかを選択できます。コンテンツ プロパティ レポート マクロには、個々のコンテンツ プロパティ レポート マクロの識別に使用できるオプションの ID パラメーターが含まれます。
それぞれのコンテンツを表示するには、次のようにします。
選択したコンテンツ プロパティ マクロをレポートに表示 - コンテンツのラベルと、コンテンツ プロパティ レポート マクロの ID ([オプション] 配下) を指定します。
すべてのコンテンツ プロパティ マクロ をレポートに表示 - コンテンツのラベルのみを指定し、コンテンツ プロパティ ID フィールドは空白のまま残します。
コンテンツ プロパティ レポート マクロで許可される ID は 1 つのみです。
CQL フィールド
CQL (Confluence クエリ言語) は Confluence 用に開発されたクエリ言語で、マクロの一部や Confluence 検索で使用できます。Confluence 検索と CQL を活用するマクロにより、検索クエリを構築するためのフィルターを追加でき、検索結果を絞り込むのに必要なだけフィルターを増やせます。クエリにフィルターを追加するには、[フィルターを追加] リンクを選択します。
以下の CQL フィルターを使用できます。
フィルター | 説明 | 演算子 |
|---|---|---|
ラベル*
| このラベルを持つページ、リアルタイム文書、ブログ投稿、または添付ファイルを返します。 | OR (同じフィルター内で複数の値) AND (複数のラベル フィルタ) |
先祖あり | コンテンツ ツリーでこのアイテムの子であるページとリアルタイム文書をすべて返します。 これによってマクロを 1 つのコンテンツ ツリーに限定できます。 | OR (同じフィルター内で複数の値) |
投稿者** | これらのユーザーが作成または編集したページ、リアルタイム文書、ブログ投稿を返します。 | OR (同じフィルター内で複数の値) |
作成者 | これらのユーザーが作成した項目を返します。 | OR (同じフィルター内で複数の値) |
ユーザーのメンションあり | これらのユーザーを @メンションするページ、リアルタイム文書、ブログ投稿を返します。 | OR (同じフィルター内で複数の値) |
親あり | このアイテムの直下の子のみを返します (以降のサブアイテムは含まない)。 | EQUALS (1 ページのみ) |
スペース内** | これらのスペースの項目を返します。 | OR (同じフィルター内で複数の値) |
テキストを含む** | このテキストを含む項目を返します。 | CONTAINS (1 つのワードまたはフレーズ) |
タイトルあり | タイトルにこのテキストを含む項目を返します。 | CONTAINS (1 つのワードまたはフレーズ) |
同一タイプ** | ページ、リアルタイム文書、ブログ、添付ファイルのみを返します。 | OR (同じフィルター内で複数の値) |
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 で動作するマクロにこれらのフィルターを追加できますが、検索する際にこれらは標準の検索フィルターの一部となっているため、[フィルターを追加] メニューには表示されません。
マクロの表示オプション
ページでのマクロの表示方法を次のオプションで制御します。
パラメーター | 既定 | 説明 |
|---|---|---|
コンテンツ プロパティ ID | 空白 | この値が指定されない場合、レポートはページ上にある複数のコンテンツ プロパティ マクロすべてのデータを示します。ID を指定することで、同じ ID を使用するコンテンツ プロパティ マクロからのデータのみを含めることができます。 |
タイトル コラム見出し | タイトル | レポート テーブルの 1 列目に表示される見出しです。この列には、レポートで表示されるページとリアルタイム文書へのリンクが含まれます。既定の列見出しは「タイトル」です。 |
表示する列 |
| この値が指定しない場合、レポートはすべての列を表示します。含める列をカンマ区切りテキストで指定できます。 列見出しにカンマが使用されている場合、列名を二重引用符で囲みます。列見出しに引用符が使用されている場合は、二重引用符を使用します。例: A column, "My ""new"" column, yes", Third column |
1 ページに表示される結果の上限 | 30 | テーブルで、追加アイテムの改ページ オプションを表示する前に表示するアイテムの数。最大: 30。 |
並び替え順序 | 最終変更日 | 特定の列見出しでテーブルを並べ替えます。対応するコンテンツ プロパティ マクロの表記と同じ列名を入力します。 逆順ソート チェックボックスをオンにすると、逆順で表をソートします。 |
コメント件数の表示 | いいえ | テーブルの各アイテムのコメント数を表示します。 |
「いいね!」件数の表示 | いいえ | テーブルの各アイテムに対する "いいね!" の数を表示します。 |
トラブルシューティング
レポートが空白の場合、以下を確認してください。
ラベルを適切に入力していて、コンテンツ プロパティ マクロを含むページおよびリアルタイム文書にそのラベルが表示されていること。
The content properties macros on each page are configured correctly.
指定した他のフィールドで検索を絞り込みすぎていない (例: 指定した親アイテムの下にそのラベルを持つアイテムがない) こと。
この内容はお役に立ちましたか?