ラベル別コンテンツ マクロ

マクロ

このページの内容

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

ラベル別コンテンツ マクロをページに追加して、特定のラベルが付いたページ、ブログ投稿、または添付ファイルの一覧を表示します。  

このマクロは、関連するページを一緒にまとめたり、表示したくないコンテンツにフィルターをかけて除外したりするのに便利です。以下のことが可能です。

  • "提供済みの機能" というラベルがあり、"ブループリント" という語が含まれるすべてのページの一覧
  • 自分がメンションされた "議事録" というラベルがあるすべてのページの一覧

On this page:

スクリーンショット: "printer" というラベルを含むすべてのページを表示するラベル別コンテンツ マクロ

Confluence でのラベルの使用の全般的な情報については、「ラベルの追加、削除および検索」をご覧ください。

このマクロをページに追加する

ラベル別コンテンツマクロをページに追加する方法

  1. エディタのツールバーで、[挿入] > [その他のマクロ] を選択します。
  2. [Confluence コンテンツ] カテゴリから [ラベル別コンテンツ] を選択します。
  3. クエリのベースとして使用するラベルを入力します。
  4. フィルターを追加してクエリをさらに絞り込みます。これらのフィルターでは CQL を使用します。
  5. [表示] を選択してマクロ パラメーターを変更します。これらはオプションです。 
  6. [挿入] をクリックします。 

その後、ページを公開するとマクロの動作を確認できます。 

スクリーンショット: CQL を使用して、ラベル別コンテンツ マクロで 2 つのスペースで特定のラベルを含むコンテンツを検索

CQL フィルター

CQL (Confluence クエリ言語) は Confluence 用に開発されたクエリ言語で、マクロの一部や Confluence 検索で使用できます。Confluence 検索と CQL を活用するマクロにより、検索クエリを構築するためのフィールドを追加し、検索結果を絞り込むのに必要なだけフィルターを増やせます。

フィールドの追加リンクを使用し、クエリに付加フィルターを追加します。
 

AND、OR、および NOT 演算子を使用する
  • 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 で動作するマクロにこれらのフィルターを追加できますが、検索を行う場合、これらは標準の検索フィルターの一部となっているため、[フィルターを追加] メニューには表示されません。

マクロ パラメーターを変更する

マクロ パラメーターは、マクロの動作を変えるために使用します。

マクロ パラメーターを変更するには、次の手順を実行します。

  1. エディタでマクロのプレースホルダーをクリックし、[編集] を選択します。
  2. 必要に応じてパラメーターを更新し、[挿入] を選択します。

このマクロで使用できるパラメーターの一覧は、次のとおりです。 

パラメーター既定説明
並び替え順序最終変更日

タイトル、作成日、または最終更新日で一覧を並び替えます。オプションを選択しない場合は、CQL の既定の並び替え順である関連性が使用されます。

逆順Falseリストを昇順ではなく降順で並べ替えます((Z - A、古いもの - 新しいもの)
最大ページ数15リストに含む項目数を制限します。最大 500 ページまでの値を設定できます。
リストタイトル空白マクロ用オプション ヘッダーを含めます
各ページのラベルを表示True各ページに適用されたラベルを表示/非表示します。
各ページのスペース名を表示True各ページのスペース名を表示/非表示します。
抜粋を表示False

リストの各ページの下に短い抜粋を含めることができます。次から選択:

  • なし - 抜粋は表示されません
  • シンプル - 返された任意のページの抜粋マクロに含まれる、テキストの最初の文字を表示します。ページに抜粋マクロがない場合は、何も表示されません。
  • リッチ コンテキスト - 抜粋マクロ以外のコンテンツを表示します。ページに抜粋マクロがない場合、ページのコンテンツの最初の部分 (画像、および一部のマクロを含む) が書式設定されたテキストとして表示されます。
現在のページを除くFalseマクロが表示されるページを一覧から除外できます。これは、現在のページに、一覧に含めたいページと同じラベルが含まれている場合に便利です。

Confluence の保存形式または wiki マークアップで使用されるパラメーター名がマクロ ブラウザで使用されるラベルと異なる場合、以下の一覧に括弧付きで表示されます (example)。

このマクロを追加するその他の方法

手入力でこのマクロを追加する

{」と入力してからマクロ名の入力を開始すると、マクロの一覧が表示されます。

Wiki マークアップを使用してこのマクロを追加する

Wiki マークアップを使用してこのマクロを追加することはできません。

最終更新日 2021 年 4 月 13 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.