ラベル別コンテンツ マクロ
スクリーンショット: "printer" というラベルを含むすべてのページを表示するラベル別コンテンツ マクロ
Confluence でのラベルの使用の全般的な情報については、「ラベルの追加、削除および検索」をご覧ください。
このマクロをページに追加する
ラベル別コンテンツマクロをページに追加する方法
- エディターのツールバーから、[挿入] > [その他のマクロ] の順に選択します。
- [Confluence コンテンツ] カテゴリから [ラベル別コンテンツ] を選択します。
- クエリのベースとして使用するラベルを入力します。
- フィルターを追加してクエリをさらに絞り込みます。これらのフィルターでは CQL を使用します。
- [表示] を選択してマクロ パラメーターを変更します。これらはオプションです。
- [挿入] をクリックします。
その後、ページを公開するとマクロの動作を確認できます。
スクリーンショット: CQL を使用して、ラベル別コンテンツ マクロで 2 つのスペースで特定のラベルを含むコンテンツを検索
CQL フィルター
フィールドの追加リンクを使用し、クエリに付加フィルターを追加します。
クエリを構築する際は、以下の CQL を使用できます。
フィルター | 説明 | 演算子 |
---|---|---|
ラベル* | このラベルを持つページ、ブログ投稿、または添付ファイルを含む。 | OR (同じフィルター内の複数の値) AND (複数のラベル フィルタ) |
先祖あり | このページの子ページを含む。 これによってマクロを 1 つのページ ツリーに限定できます。 | OR (同じフィルター内の複数の値) |
投稿者** | これらのユーザーが作成または編集したページまたはブログ投稿を含む。 | OR (同じフィルター内の複数の値) |
作成者 | このユーザーが作成した項目を含む。 | OR (同じフィルター内の複数の値) |
ユーザーのメンションあり | これらのユーザーをメンションするページやブログ投稿を含む。 | OR (同じフィルター内の複数の値) |
親あり | このページの直下の子ページのみを含む (以降のサブページは含まない)。 | EQUALS (1 ページのみ) |
スペース内** | このスペースの項目を含む。 | OR (同じフィルター内の複数の値) |
テキストを含む** | このテキストを含む項目を含む。 | CONTAINS (1 つのワードまたはフレーズ) |
タイトルあり | タイトルにこのテキストを持つ項目を含む。 | CONTAINS (1 つのワードまたはフレーズ) |
同一タイプ** | ページ、ブログ、添付ファイルのみを含める。 | OR (同じフィルター内の複数の値) |
* このフィールドは CQL で動作するマクロに必須です。
** CQL で動作するマクロにこれらのフィルターを追加できますが、検索を行う場合、これらは標準の検索フィルターの一部となっているため、[フィルターを追加] メニューには表示されません。
マクロ パラメーターを変更する
マクロ パラメーターは、マクロの動作を変えるために使用します。
マクロ パラメーターを変更するには、次の手順を実行します。
- エディタでマクロのプレースホルダーをクリックし、[編集] を選択します。
- 必要に応じてパラメータを更新し、[挿入] を選択します。
このマクロで使用できるパラメーターの一覧は、次のとおりです。
パラメーター | 既定 | 説明 |
---|---|---|
並び替え順序 | 最終変更日 | タイトル、作成日、または最終更新日で一覧を並び替えます。オプションを選択しない場合は、CQL の既定の並び替え順である関連性が使用されます。 |
逆順 | False | リストを昇順ではなく降順で並べ替えます((Z - A、古いもの - 新しいもの) |
最大ページ数 | 15 | リストに含む項目数を制限します。最大 500 ページまでの値を設定できます。 |
リストタイトル | 空白 | マクロ用オプション ヘッダーを含めます |
各ページのラベルを表示 | True | 各ページに適用されたラベルを表示/非表示します。 |
各ページのスペース名を表示 | True | 各ページのスペース名を表示/非表示します。 |
抜粋を表示 | False | リストの各ページの下に短い抜粋を含めることができます。次から選択:
|
現在のページを除く | False | マクロが表示されるページを一覧から除外できます。これは、現在のページに、一覧に含めたいページと同じラベルが含まれている場合に便利です。 |
Confluence の保存形式または wiki マークアップで使用されるパラメーター名がマクロ ブラウザで使用されるラベルと異なる場合、以下の一覧に括弧付きで表示されます (example
)。
このマクロを追加するその他の方法
手入力でこのマクロを追加する
Wiki マークアップを使用してこのマクロを追加する
Wiki マークアップを使用してこのマクロを追加することはできません。