_CQL
Confluence 検索フィルターは CQL で動作しています。
CQL およびその使用方法について
CQL (Confluence クエリ言語) は Confluence 用に開発されたクエリ言語で、マクロの一部や Confluence 検索で使用できます。Confluence 検索と CQL を活用するマクロにより、検索クエリを構築するためのフィルターを追加でき、検索結果を絞り込むのに必要なだけフィルターを増やせます。クエリにフィルターを追加するには、[フィルターを追加] リンクを選択します。
以下の CQL フィルターを使用できます。
| フィルター | 説明 | 演算子 |
|---|---|---|
ラベル* | このラベルを持つページ、ブログ投稿、または添付ファイルを返します。 | OR (同じフィルター内で複数の値) AND (複数のラベル フィルタ) |
| 先祖あり | ページ ツリーでこのページの子であるページを返します。 これによってマクロを 1 つのページ ツリーに限定できます。 | OR (同じフィルター内で複数の値) |
| 投稿者** | これらのユーザーが作成または編集したページまたはブログ投稿を返します。 | OR (同じフィルター内で複数の値) |
| 作成者 | このユーザーが作成した項目を返します。 | OR (同じフィルター内で複数の値) |
ユーザーのメンションあり | これらのユーザーをメンションするページやブログ投稿を返します。 | OR (同じフィルター内で複数の値) |
| 親あり | このページの直下の子ページのみを返します (以降のサブページは含まない)。 | EQUALS (1 ページのみ) |
| スペース内** | このスペースの項目を返します。 | OR (同じフィルター内で複数の値) |
| テキストを含む** | このテキストを含む項目を返します。 | CONTAINS (1 つのワードまたはフレーズ) |
| タイトルあり | タイトルにこのテキストを持つ項目を返します。 | CONTAINS (1 つのワードまたはフレーズ) |
| 同一タイプ** | ページ、ブログ、添付ファイルのみを返します。 | OR (同じフィルター内で複数の値) |
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 で動作するマクロに必須です。
** CQL で動作するマクロにこれらのフィルターを追加できますが、検索を行う場合、これらは標準の検索フィルターの一部となっているため、[フィルターを追加] メニューには表示されません。
最終更新日 2023 年 6 月 19 日
Powered by Confluence and Scroll Viewport.