Confluence 検索フィールド
このページでは、Confluence で使用される Apache Luceneを使用した 検索フィールドの概要を説明します。
CQL を使用したフィルター
Lucene フィールドの詳細を見る前に、Confluence Query Language (CQL) によって提供される強力な検索フィルタリングについて知りたいと思われるかもしれません。
フィールドの追加リンクを使用し、クエリに付加フィルターを追加します。
- 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 で動作するマクロにこれらのフィルターを追加できますが、検索を行う場合、これらは標準の検索フィルターの一部となっているため、[フィルターを追加] メニューには表示されません。
特定のフィールドのコンテンツを検索する
Confluence のデータは、検索で指定可能なフィールドに格納されます。指定のフィールドを検索するには、フィールド名の後にコロン ':' と検索する用語を続けて入力します。
基本例：
title:"Some Title"
labelText:chalk
フィールド指定はコロンの直後の用語にのみ適用されます。たとえば、次のクエリはタイトル フィールドで "Some" を検索し、既定のフィールドで "Heading" を検索します。
title:Some HeadingConfluence 検索フィールド
以下は、コンテンツの種類別に分けた検索可能なフィールドの一覧です。
個人情報
名前 | インデックス化 | 保存 | トークン作成 | 注意 |
|---|---|---|---|---|
handle | true | true | false |
|
type | true | true | false |
|
urlPath | true | true | false |
|
fullName | true | true | true |
|
title | true | true | false |
|
labelText | true | true | true |
|
modified | true | true | false |
|
created | true | true | false |
|
contentBody | true | true | true |
|
ページ
名前 | インデックス化 | 保存 | トークン作成 | 注意 |
|---|---|---|---|---|
handle | true | true | false |
|
type | true | true | false |
|
urlPath | true | true | false |
|
title | true | true | true |
|
spacekey | true | true | false |
|
labelText | true | true | true |
|
modified | true | true | false |
|
created | true | true | false |
|
contentBody | true | true | true |
|
macroName | true | true | false | ページで使用されるマクロ名 |
ブログ
名前 | インデックス化 | 保存 | トークン作成 | 注意 |
|---|---|---|---|---|
handle | true | true | false |
|
type | true | true | false |
|
urlPath | true | true | false |
|
title | true | true | true |
|
spacekey | true | true | false |
|
labelText | true | true | true |
|
modified | true | true | false |
|
created | true | true | false |
|
contentBody | true | true | true |
|
macroName | true | true | false | ブログで使用されるマクロ名 |
添付ファイル
名前 | インデックス化 | 保存 | トークン作成 | 注意 |
|---|---|---|---|---|
handle | true | true | false |
|
type | true | true | false |
|
urlPath | true | true | false |
|
filename | true | true | true |
|
title | true | true | false |
|
comment | true | true | true |
|
spacekey | true | true | false |
|
modified | true | true | false |
|
created | true | true | false |
|
contentBody | true | true | true |
|
メール項目
名前 | インデックス化 | 保存 | トークン作成 | 注意 |
|---|---|---|---|---|
handle | true | true | false |
|
type | true | true | false |
|
urlPath | true | true | false |
|
title | true | true | true |
|
spacekey | true | true | false |
|
messageid | true | true | false |
|
inreplyto | true | true | false |
|
recipients | true | true | true |
|
labelText | true | true | true |
|
modified | true | true | false |
|
created | true | true | false | |
contentBody | true | true | true |
便利なプラグイン
Confluence サイトにアドオン（プラグインとも言う）をインストールする前に、アドオンの情報ページをチェックし、アドオンがアトラシアンによってサポートされているか、他のベンダーによってサポートされているか、またはまったくサポートされていないか確認してください。 アドオンのサポートについては、弊社のガイドラインを参照してください 。
このプラグインは Confluence 検索を拡張し、マクロ パラメーターの名前と値を検索可能にするものです： Confluence Macro Indexer プラグイン。
注意
Confluence が使用している Lucene のバージョンを確認するには、<installation directory>/confluence/WEB-INF/lib に移動して、 Lucene jar ファイルを確認します。Lucene バージョン番号はファイル名の一部です。