ラベル別コンテンツ マクロ
ラベル別コンテンツマクロを利用して、特定のラベルが貼られたページ、ブログ投稿、添付ファイルのリストを表示します。関連ページを一緒にまとめたり、見る必要のないコンテンツにフィルターをかけて除外したりするのに大変便利です。
例えば、このマクロを使用すると、「機能-出荷済み」とラベルが貼られたすべてのページを表示する、「ブループリント」を含む、過去に記載した「ミーティング - ノート」をリストにするなどが可能になります。
マクロはページで以下のように表示されます。
マクロ ブラウザでのセットアップは次のようになります。
ラベル別コンテンツマクロを利用する
ラベル別コンテンツマクロをページに追加する方法
- Confluence のエディタで、[挿入] > [その他のマクロ] を選択します。
- 対象のマクロを見つけて、選択します。
オートコンプリートでマクロエントリを高速化： タイプ{とマクロ名の先頭には、提案したマクロの一覧を表示します。詳細は、こちらを参照ください。リンク、ファイル、マクロ、メンションのオートコンプリート
既存のマクロを編集する方法: マクロのプレースホルダをクリックして、[編集] を選択します。マクロのパラメータが編集可能な場合、マクロのダイアログ ウィンドウが開きます。
CQL フィルター
フィールドの追加リンクを使用し、クエリに付加フィルターを追加します。
- OR 検索の場合、1 つのフィールドに複数の値を指定します。
"label-a" または "label-b"、またはそれらの両方を含むページを表示するには、1 つのラベル フィールドに "label-a" と "label-b" を以下のように指定します。
- AND 検索の場合、1 つ以上のフィルターを追加し、それぞれに値を 1 つずつ指定します。
label-a と label-b を含むページのみを表示するには、1 つのラベル フィールドに "label-a" を指定し、マクロに次のように 2 つ目のフィールドを追加して、そこに "label-b" を指定します。
つまり、OR の値は同じフィルタに、AND の値は異なるフィルタに入力します。
AND は一部のフィルタでのみサポートされます。AND 演算子がサポートされていないフィルタの場合、フィルタを追加することはできません。 - NOT 検索の場合は、マイナス記号 (-) をラベルの前に入力します。これにより、そのラベルを含むものはすべて除外されます。
クエリを構築する際は、以下の CQL を使用できます。
| フィルター | 説明 | 演算子 |
|---|---|---|
| ラベル* | このラベルを持つページ、ブログ投稿、または添付ファイルを含む。 | OR (同じフィルター内の複数の値) AND (複数のラベル フィルタ) |
| 先祖あり | このページの子ページを含む。 これによってマクロを 1 つのページ ツリーに限定できます。 | OR (同じフィルター内の複数の値) |
| 投稿者** | これらのユーザーが作成または編集したページまたはブログ投稿を含む。 | OR (同じフィルター内の複数の値) |
| 作成者 | このユーザーが作成した項目を含む。 | OR (同じフィルター内の複数の値) |
| ユーザーのメンションあり | これらのユーザーをメンションするページやブログ投稿を含む。 | OR (同じフィルター内の複数の値) |
| 親あり | このページの直下の子ページのみを含む (以降のサブページは含まない)。 | EQUALS (1 ページのみ) |
| スペース内** | このスペースの項目を含む。 | OR (同じフィルター内の複数の値) |
| テキストを含む** | このテキストを含む項目を含む。 | CONTAINS (1 つのワードまたはフレーズ) |
| タイトルあり | タイトルにこのテキストを持つ項目を含む。 | CONTAINS (1 つのワードまたはフレーズ) |
| 同一タイプ** | ページ、ブログ、添付ファイルのみを含める。 | OR (同じフィルター内の複数の値) |
* このフィールドは CQL で動作するマクロに必須です。
** CQL で動作するマクロにこれらのフィルターを追加できますが、検索を行う場合、これらは標準の検索フィルターの一部となっているため、[フィルターを追加] メニューには表示されません。
マクロの表示オプション
ページでのマクロの表示方法を次のオプションで制御します。
| パラメーター | 既定 | 説明 |
|---|---|---|
| 並び替え順序 | 最終変更日 | タイトル、作成日、または最終更新日で一覧を並び替えます。オプションを選択しない場合は、CQL の既定の並び替え順である関連性が使用されます。 |
| 逆順 | False | リストを昇順ではなく降順で並べ替えます（(Z - A、古いもの - 新しいもの) |
| 最大ページ数 | 15 | リストに含む項目数を制限します。 |
| リストタイトル | 空白 | マクロ用オプション ヘッダーを含めます |
| 各ページのラベルを表示 | True | 各ページに適用されたラベルを表示／非表示します。 |
| 各ページのスペース名を表示 | True | 各ページのスペース名を表示／非表示します。 |
| 抜粋を表示 | False | リストの各ページの下に短い抜粋を含めることができます。次から選択:
|