Confluence Cloud を検討中ですか?
Confluence Cloudの概要とプランごとに利用可能な機能をご確認ください。
ラベル別フィルター・マクロを挿入する
ラベル別フィルター・マクロを利用して、特定のラベルが貼られたページ、ブログ投稿、添付ファイルのリストを表示します。関連ページを一緒にまとめたり、見る必要のないコンテンツにフィルターをかけて除外したりするのに大変便利です。
例えば、このマクロを使用すると、「機能-出荷済み」とラベルが貼られたすべてのページを表示する、「ブループリント」を含む、過去に記載した「ミーティング - ノート」をリストにするなどが可能になります。
リストはページで以下のように表示されます。
ラベル付きコンテンツのリストをページに追加する
エディターのツールバーから を選択するか、「 / 」を入力して挿入メニューを開きます。
「ラベル別フィルター」マクロを探して選択します。「/filterbylabel」と入力することで、ページ本文の挿入メニューから直接このマクロを選択することもできます。
選択するとモーダルが表示され、挿入前にリストをカスタマイズして設定できます。
ラベル付きコンテンツのリストを設定する
設定モーダルから、「ラベルを追加」フィールドで検索し、リストをフィルタリングするために使用するラベルを選択します。
次に、「フィルターを追加」を選択して、このリストをさらにフィルタリングするかどうかを選択できます。
最後に、「その他のオプション」を選択してリストをさらにカスタマイズします。
リストの設定が完了したら、「プレビュー」を選択して、ページ上でどのように表示されるかを確認できます。
「挿入」を選択して、設定したリストをページに埋め込みます。
このリストの項目は動的です。追加のアップデートが行われると、自動的にリストに反映されます。
ラベル付きコンテンツの既存のリストを編集する
ページの編集中に、再設定するラベル別フィルター・マクロを選択します。
編集（）アイコンを選択して設定モーダルを開きます。
ラベル付きコンテンツのリストのパラメーターを調整します。
「挿入」を選択して、リストへの変更を確定します。
中央揃えアイコン、幅アイコン、全幅アイコンのいずれかを選択して、リストの幅を調整することもできます。他の場所に複製するにはコピー アイコンを選択します。完全に削除するにはゴミ箱アイコンを選択します。
どのような CQL フィルターが使用できるか
CQL（Confluence クエリ言語）は特定のマクロや Confluence 検索で使用するために Confluence によって開発されたものです。検索結果の絞り込みに必要なフィルターをいくつでも追加できます。
設定モーダルで「フィルターを追加」を選択すると、次の CQL フィルターを使用できます。
フィルター | 説明 | 演算子 |
|---|---|---|
ラベル
| このラベルを持つページ、ブログ投稿、または添付ファイルを返します。 | OR (同じフィルター内で複数の値) AND (複数のラベル フィルタ) |
タイトル | タイトルにこのテキストを含む項目を返します。 | CONTAINS (1 つのワードまたはフレーズ) |
タイプ | ページ、ブログ、添付ファイルのみを返します。 | OR (同じフィルター内で複数の値) |
テキスト | このテキストを含む項目を返します。 | CONTAINS (1 つのワードまたはフレーズ) |
作成日 | この日付に作成されたアイテムを返します。 | CONTAINS (1 つのワードまたはフレーズ) |
最終変更 | この日付に最終アップデートされたアイテムを返します。 | CONTAINS (1 つのワードまたはフレーズ) |
作成者 | これらのユーザーが作成した項目を返します。 | OR (同じフィルター内で複数の値) |
投稿者 | これらのユーザーが作成または編集したページまたはブログ投稿を返します。 | OR (同じフィルター内で複数の値) |
メンションされたユーザー | これらのユーザーをメンションするページやブログ投稿を返します。 | OR (同じフィルター内で複数の値) |
スペース | これらのスペースの項目を返します。 | OR (同じフィルター内で複数の値) |
子ページ | このページの直下の子ページのみを返します (以降のサブページは含まない)。 | EQUALS (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 の関連性 | このドロップダウンでは、リストの順序を設定できます。
|
プレビューの表示 | なし | このドロップダウンでは、各子ページのコンテンツのプレビューの有無にかかわらず、リストを表示できます。
|
リスト全体を表示 | オフ | チェックするとリストの全アイテムが一度に表示され、チェックを外すと表示するアイテム数を手動でカスタマイズできます。 |
リストの最大数 | 15 | 「リスト全体を表示」チェックボックスがオフの場合、この入力フィールドにリストに表示するアイテム数を入力できます。500 までの任意の値を設定できます。 |
ラベルを表示 | オン | チェックすると各アイテムに適用されているラベルが表示され、チェックを外すと非表示になります。 |
スペース名を表示 | オン | チェックすると各アイテムに関連付けられているスペース名が表示され、チェックを外すと非表示になります。 |
この内容はお役に立ちましたか?
さらにヘルプが必要ですか?
アトラシアン コミュニティをご利用ください。