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

マクロ

このページの内容

お困りですか?

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

コミュニティに質問

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

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

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

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

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

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

  1. From the editor toolbar, choose (Insert) > Other Macros
  2. 対象のマクロを見つけて、選択します。

Speed it up with autocomplete: Type and the beginning of the macro name, to see a list of suggested macros. In this example we're inserting the cheese macro.

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

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

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

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

 

 

最終更新日 2018 年 1 月 22 日

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

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