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

  • フィールドの追加リンクを使用し、クエリに付加フィルターを追加します。フィルターは、必要なだけいくつでも追加できます。
  • For an OR search, specify multiple values in the same field.
    So to show pages with 'label-a', 'label-b' or both you'd put 'label-a' and 'label-b' in the same Label field, like this:
     
  • For an AND search, add more than one field and specify a single value in each.
    To show only pages with label-a and label-b you'd put 'label-a' in one label field, then add a second Label field to the macro, and put 'label-b' in the second one, like this:

    Put simply, OR values are entered in the same field, AND values are entered in different fields. 
    Only some fields support AND.  If the field does not support the AND operator, you won't be able to add that field more than once.  
  • NOT 検索の場合は、マイナス記号 (-) をラベルの前に入力します。これにより、そのラベルを含むものはすべ除外されます。

クエリを構築する際は、以下の CQL を使用できます。

フィールド必須説明 演算子
ラベルはい

このラベルを持つページ、ブログ投稿、または添付ファイルを含む。

OR （1 つのフィールドに複数の値）

AND （複数のラベルフィールド）

先祖ありいいえ

このページの子ページを含む。

これによってマクロを 1 つのページ ツリーに限定できます。

OR （1 つのフィールドに複数の値）
Contributor*いいえ

これらのユーザーが作成または編集したページまたはブログ投稿を含む。

OR （1 つのフィールドに複数の値）
作成者いいえ

このユーザーが作成した項目を含む。

OR （1 つのフィールドに複数の値）
ユーザーのメンションありいいえ

これらのユーザーをメンションするページやブログ投稿を含む。

OR （1 つのフィールドに複数の値）
親ありいいえこのページの直下の子ページのみを含む (以降のサブページは含まない)。EQUALS (1 ページのみ)
スペース内いいえこのスペースの項目を含む。OR （1 つのフィールドに複数の値）
Including text*いいえこのテキストを含む項目を含む。CONTAINS (1 つのワードまたはフレーズ)
タイトルありいいえタイトルにこのテキストを持つ項目を含む。CONTAINS (1 つのワードまたはフレーズ)
Of type*いいえページ、ブログ、添付ファイルのみを含める。OR （1 つのフィールドに複数の値）

*CQL搭載のマクロではなく、検索でこれらのフィールドを追加することができます。検索と同じ情報を利用して、フィルターすることができます。しかし、フィルタ追加メニューには表示されず、同等の検索フィルターとして管理されます。

  • ラベルなし