ラベル別フィルター・マクロを挿入する

ラベル別フィルター・マクロを利用して、特定のラベルが貼られたページ、ブログ投稿、添付ファイルのリストを表示します。関連ページを一緒にまとめたり、見る必要のないコンテンツにフィルターをかけて除外したりするのに大変便利です。

例えば、このマクロを使用すると、「機能-出荷済み」とラベルが貼られたすべてのページを表示する、「ブループリント」を含む、過去に記載した「ミーティング - ノート」をリストにするなどが可能になります。

リストはページで以下のように表示されます。

ラベル付きコンテンツのリストをページに追加するには： 

1. エディターのツールバーから を選択するか、「 / 」を入力して挿入メニューを開きます。

2. 「ラベル別フィルター」マクロを探して選択します。「/filterbylabel」と入力することで、ページ本文の挿入メニューから直接このマクロを選択することもできます。

3. 選択するとモーダルが表示され、挿入前にリストをカスタマイズして設定できます。

ラベル付きコンテンツのリストを設定するには：

1. 設定モーダルから、「ラベルを追加」フィールドで検索し、リストをフィルタリングするために使用するラベルを選択します。

2. 次に、「フィルターを追加」を選択して、このリストをさらにフィルタリングするかどうかを選択できます。

3. 最後に、「その他のオプション」を選択してリストをさらにカスタマイズします。

4. リストの設定が完了したら、「プレビュー」を選択して、ページ上でどのように表示されるかを確認できます。

5. 「挿入」を選択して、設定したリストをページに埋め込みます。

ラベル付きコンテンツの既存のリストを編集するには：

1. ページの編集中に、再設定するラベル別フィルター・マクロを選択します。

2. 編集（）アイコンを選択して設定モーダルを開きます。

3. ラベル付きコンテンツのリストのパラメーターを調整します。

4. 「挿入」を選択して、リストへの変更を確定します。

どのような CQL フィルターが使用できるか

CQL（Confluence クエリ言語）は特定のマクロや Confluence 検索で使用するために Confluence によって開発されたものです。検索結果の絞り込みに必要なフィルターをいくつでも追加できます。

設定モーダルで「フィルターを追加」を選択すると、次の CQL フィルターを使用できます。

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 検索の場合は、マイナス記号 (-) をラベルの前に入力します。これにより、そのラベルを含むものはすべて除外されます。

その他のオプション

次の設定オプションは、リストがページにどのように表示されるかを制御します。

Wiki マークアップの例

Wiki マークアップはエディタ外部でマクロを追加する必要がある場合 (スペースのサイドバー、ヘッダー、またはフッターのカスタム コンテンツなど) に便利です。

マクロ名: recently-updated

マクロ本文: なし。