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

マクロ

このページの内容

お困りですか?

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

コミュニティに質問

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

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

マクロはページ上で以下のように表示されます。

マクロ ブラウザでの設定は以下のようになります。

ラベル別コンテンツマクロを利用する

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

  1. エディタのツールバーで、[挿入] > [その他のマクロ] を選択します。
  2. 対象のマクロを見つけて、選択します。

オートコンプリートを活用して素早く入力: {」とマクロ名の先頭を入力すると、マクロ候補の一覧が表示されます。この例では、cheese マクロを挿入します。

既存のマクロを編集する方法: マクロのプレースホルダをクリックして、[編集] を選択します。これによりマクロの詳細を開き、マクロのパラメーターを編集できます。

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搭載でこれらのフィルターを追加できますが、検索では、これらは標準検索フィルターの一部となっているため、フィルタ追加メニューには表示されません。

マクロ表示オプション

このオプションでページへのマクロの表示方法を管理します。

パラメータ 既定 説明
並び順 更新日

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

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

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

  • なし - 抜粋は表示されません
  • シンプル - 返された任意のページの抜粋マクロに含まれる、テキストの最初の文字を表示します。ページに抜粋マクロがない場合は、何も表示されません。
  • リッチ コンテキスト - 抜粋マクロ以外のコンテンツを表示します。ページに抜粋マクロがない場合、ページのコンテンツの最初の部分 (画像、および一部のマクロを含む) が書式設定されたテキストとして表示されます。
Exclude current page False Allows you to exclude the page the macro appears on from the list. This is useful when the current page contains the same labels as the pages you want to include in the list.



最終更新日 2019 年 11 月 4 日

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

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