Insert the content properties report macro
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.
This macro was previously known as the page properties report macro.
Adding the content properties report macro to a page or live doc
To add the content properties report macro to a page or live doc:
In the editor, type
/contentpropertiesreportEnter the Labels you want to report on - this is the label added to pages and live docs containing the content properties report macro.
Further narrow down your search by adding more fields, or specifying a content properties ID (more info on this below)
[挿入] をクリックします。
Here's how the macro looks when displayed:
その設定方法は次のとおりです。
Reporting on specific content properties macros
It's possible to add multiple content properties report macros on a page or live doc, and choose whether to include all or only specific macros in the report. The content properties report macro includes an optional ID parameter that can be used to identify specific content properties report macros.
それぞれのコンテンツを表示するには、次のようにします。
Selected content properties macros in the report - specify the label for the content and the ID of the particular content properties report macro (under Options)
All content properties macros in the report - specify just the label for the content - leave the content properties ID field blank.
The content properties report macro can only accept one ID.
CQL フィールド
CQL (Confluence クエリ言語) は Confluence 用に開発されたクエリ言語で、マクロの一部や Confluence 検索で使用できます。Confluence 検索と CQL を活用するマクロにより、検索クエリを構築するためのフィルターを追加でき、検索結果を絞り込むのに必要なだけフィルターを増やせます。クエリにフィルターを追加するには、[フィルターを追加] リンクを選択します。
以下の CQL フィルターを使用できます。
フィルター | 説明 | 演算子 |
|---|---|---|
ラベル*
| Returns pages, live docs, blog posts or attachments with these labels. | OR (同じフィルター内で複数の値) AND (複数のラベル フィルタ) |
先祖あり | Returns pages and live docs that live under this item in the content tree. This allows you to restrict the macro to a single content tree. | OR (同じフィルター内で複数の値) |
投稿者** | Returns pages, live docs, or blog posts that were created or edited by these people. | OR (同じフィルター内で複数の値) |
作成者 | これらのユーザーが作成した項目を返します。 | OR (同じフィルター内で複数の値) |
ユーザーのメンションあり | Returns pages, live docs, and blog posts that @mention these people. | OR (同じフィルター内で複数の値) |
親あり | Returns only direct children of this item (further sub-items won't be included) | EQUALS (1 ページのみ) |
スペース内** | これらのスペースの項目を返します。 | OR (同じフィルター内で複数の値) |
テキストを含む** | このテキストを含む項目を返します。 | CONTAINS (1 つのワードまたはフレーズ) |
タイトルあり | タイトルにこのテキストを含む項目を返します。 | CONTAINS (1 つのワードまたはフレーズ) |
同一タイプ** | Returns only pages, live docs, blogs or attachments. | 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 で動作するマクロにこれらのフィルターを追加できますが、検索する際にこれらは標準の検索フィルターの一部となっているため、[フィルターを追加] メニューには表示されません。
マクロの表示オプション
ページでのマクロの表示方法を次のオプションで制御します。
パラメーター | 既定 | 説明 |
|---|---|---|
Content properties ID | 空白 | If not specified, the report will show data from all content properties macros on a page or live doc, where there are multiple macros. Specify an ID to include only data from content properties macros with the same ID. |
タイトル コラム見出し | タイトル | The heading to display on the first column in the report table. This column contains links to pages and live docs displayed by the report. The default column heading is 'Title'. |
表示する列 |
| この値が指定しない場合、レポートはすべての列を表示します。含める列をカンマ区切りテキストで指定できます。 列見出しにカンマが使用されている場合、列名を二重引用符で囲みます。列見出しに引用符が使用されている場合は、二重引用符を使用します。例: A column, "My ""new"" column, yes", Third column |
1 ページに表示される結果の上限 | 30 | テーブルで、追加アイテムの改ページ オプションを表示する前に表示するアイテムの数。最大: 30。 |
並び替え順序 | 最終変更日 | Sort the table by a specific column heading. Enter the column name, exactly as it appears in the corresponding content properties macro. 逆順ソート チェックボックスをオンにすると、逆順で表をソートします。 |
コメント件数の表示 | いいえ | Displays the number of comments for each item in the table. |
「いいね!」件数の表示 | いいえ | Displays the number of likes for each item in the table. |
トラブルシューティング
レポートが空白の場合、以下を確認してください。
You have entered the label correctly and that the label does appear on pages and live docs containing a content properties macro.
The content properties macros on each page are configured correctly.
Any other fields you have specified have not narrowed your search too far (for example there are no items with that label under the Parent item you've specified).
この内容はお役に立ちましたか?