ラベル別フィルター・マクロを挿入する
ラベル別フィルター・マクロを利用して、特定のラベルが貼られたページ、リアルタイム文書、ブログ投稿、添付ファイルのリストを表示します。関連コンテンツを一緒にまとめたり、見る必要のないコンテンツにフィルターをかけて除外したりするのに大変便利です。
例えば、このマクロを使用して、「機能 - 出荷済み」というラベルが付いていて「ブループリント」という単語を含むすべてのページのリストを表示したり、自分がメンションされていて「ミーティング - ノート」というラベルが付いたリアルタイム文書をリストしたりすることができます。
Here's how the list will look on your page or live doc:
Add a list of labeled content to your page or live doc
エディターのツールバーから を選択するか、「
/
」を入力して挿入メニューを開きます。「ラベルで絞り込み」マクロを探して選択します。「
/filterbylabel
」と入力することで、ページまたはリアルタイム文書の本文の挿入メニューから直接このマクロを選択することもできます。選択するとモーダルが表示され、挿入前にリストをカスタマイズして設定できます。
ラベル付きコンテンツのリストを設定する
設定モーダルから、「ラベルを追加」フィールドで検索し、リストをフィルタリングするために使用するラベルを選択します。
次に、「フィルターを追加」を選択して、このリストをさらにフィルタリングするかどうかを選択できます。
最後に、「その他のオプション」を選択してリストをさらにカスタマイズします。
リストの設定が完了したら、 [プレビュー] を選択して、ページやリアルタイム文書上でどのように表示されるかを確認できます。
Select Insert to embed your configured list on your page or doc.
このリストの項目は動的です。追加のアップデートが行われると、自動的にリストに反映されます。
ラベル付きコンテンツの既存のリストを編集する
While editing your content, select the Filter by label macro you want to re-configure.
[編集] () アイコンを選択して設定モーダルを開きます。
ラベル付きコンテンツのリストのパラメーターを調整します。
「挿入」を選択して、リストへの変更を確定します。
中央揃えアイコン、幅アイコン、全幅アイコンのいずれかを選択して、リストの幅を調整することもできます。他の場所に複製するにはコピー アイコンを選択します。完全に削除するにはゴミ箱アイコンを選択します。
どのような CQL フィルターが使用できるか
CQL(Confluence クエリ言語)は特定のマクロや Confluence 検索で使用するために Confluence によって開発されたものです。検索結果の絞り込みに必要なフィルターをいくつでも追加できます。
設定モーダルで「フィルターを追加」を選択すると、次の CQL フィルターを使用できます。
フィルター | 説明 | 演算子 |
---|---|---|
ラベル
| Returns pages, live docs, blog posts, or attachments with these labels. | OR (同じフィルター内で複数の値) AND (複数のラベル フィルタ) |
タイトル | タイトルにこのテキストを含む項目を返します。 | CONTAINS (1 つのワードまたはフレーズ) |
タイプ | Returns only pages, live docs, blogs or attachments. | OR (同じフィルター内で複数の値) |
テキスト | このテキストを含む項目を返します。 | CONTAINS (1 つのワードまたはフレーズ) |
作成日 | この日付に作成されたアイテムを返します。 | CONTAINS (1 つのワードまたはフレーズ) |
最終変更 | この日付に最終アップデートされたアイテムを返します。 | CONTAINS (1 つのワードまたはフレーズ) |
作成者 | これらのユーザーが作成した項目を返します。 | OR (同じフィルター内で複数の値) |
投稿者 | Returns pages, live docs, or blog posts that were created or edited by these people. | OR (同じフィルター内で複数の値) |
メンションされたユーザー | Returns pages, live docs, and blog posts that @mention these people. | 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 の関連性 | このドロップダウンでは、リストの順序を設定できます。
|
プレビューの表示 | なし | This dropdown allows you to display your list with or without a preview of each child item’s content.
|
リスト全体を表示 | オフ | チェックするとリストの全アイテムが一度に表示され、チェックを外すと表示するアイテム数を手動でカスタマイズできます。 |
リストの最大数 | 15 | 「リスト全体を表示」チェックボックスがオフの場合、この入力フィールドにリストに表示するアイテム数を入力できます。500 までの任意の値を設定できます。 |
ラベルを表示 | オン | チェックすると各アイテムに適用されているラベルが表示され、チェックを外すと非表示になります。 |
スペース名を表示 | オン | チェックすると各アイテムに関連付けられているスペース名が表示され、チェックを外すと非表示になります。 |
この内容はお役に立ちましたか?