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

マクロ

このページの内容

お困りですか?

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

コミュニティに質問

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

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

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

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

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

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

  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 pageFalseAllows 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.