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

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

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

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

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

1. From the editor, select from the toolbar or type / to bring up the insert menu.

2. Find the Filter by label macro and select it. You can also type /filterbylabel to select this macro from the insert menu right in the body of your page.

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

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

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

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

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

4. When you’re done configuring your list, you can select Preview to see how it will look on your page.

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

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

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

2. Select the Edit () icon to open the configuration modal.

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

その他のオプション

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