付録 H.3 演算子・属性値・全文検索キーワードの記述方法
演算子、属性値、および全文検索キーワードは、検索条件に指定する属性の型に合わせて記述します。属性の型と演算子の組み合わせにおける、属性値および全文検索キーワードの記述方法は、次のとおりです。
| 属性型 | 演算子 | 説明 | 検索条件の例（＊1）（＊2） | 属性値（ac01val）または全文検索キーワード（ftcval）に指定する値 | |||
|---|---|---|---|---|---|---|---|
| 指定する値（＊2） | 複数の値の指定方法（＊2） | ワイルドカード文字 | 備考 | ||||
| 文字列 | いずれかに一致 | キーワードのいずれかと一致する属性値を持つ文書やフォルダーがヒットします。 | ac01op=INCLUDE ac01val=ABC%20DEF |
区切り文字、ワイルドカード文字、エスケープ文字を含めた文字列全体を、URLエンコードした値。 | 半角または全角のスペースで区切って、ac01valに複数の値を指定します。 | 「*」（任意の文字列） 「?」（任意の1文字） |
半角スペース、全角スペース、 「*」、「?」、または「¥」を値に指定したい場合は、「¥」（半角円記号）または「¥」（半角バックス ラッシュ）でエスケープします。 |
| いずれかを含む | キーワードのいずれかを含む属性値を 持つ文書やフォルダーがヒットします。 | ac01op=INCLUDE_ANY ac01val=ABC%20DEF |
区切り文字、ワイルドカード文字、エスケープ文字を含めた文字列全体を、URLエンコードした値。 | 半角または全角のスペースで区切って、ac01valに複数の値を指定します。 | 「*」（任意の文字列） 「?」（任意の1文字） |
半角スペース、全角スペース、 「*」、「?」、または「¥」を値に指定したい場合は、「¥」（半角円記号）または「¥」（半角バックス ラッシュ）でエスケープします。 |
|
| 全て含む | キーワードをすべて含む属性値を持つ文書やフォルダーがヒットします。 | ac01op=INCLUDE_ALL ac01val=ABC%20DEF |
区切り文字、ワイルドカード文字、エスケープ文字を含めた文字列全体を、URLエンコードした値。 | 半角または全角のスペースで区切って、ac01valに複数の値を指定します。 | 「*」（任意の文字列） 「?」（任意の1文字） |
半角スペース、全角スペース、 「*」、「?」、または「¥」を値に指定したい場合は、「¥」（半角円記号）または「¥」（半角バックス ラッシュ）でエスケープします。 |
|
| 完全一致 | 指定されたキーワードと一致する属性値を持つ文書やフォルダーがヒットします。 | ac01op=EXACTLY_MATCH ac01val=ABC |
区切り文字、ワイルドカード文字、エスケープ文字を含めた文字列全体を、URLエンコードした値。 | 指定できません。 | 使用できません。 | ― | |
| 以外 | 指定されたキーワードとは一致しない属性値を持つ文書やフォルダーがヒットします。 | ac01op=EXCEPT ac01val=ABC%20DEF |
区切り文字、ワイルドカード文字、エスケープ文字を含めた文字列全体を、URLエンコードした値。 | 半角または全角のスペースで区切って、ac01valに複数の値を指定します。 | 「*」（任意の文字列） 「?」（任意の1文字） |
半角スペース、全角スペース、 「*」、「?」、または「¥」を値に指定したい場合は、「¥」（半角円記号）または「¥」（半角バックス ラッシュ）でエスケープします。 |
|
| 値なし | 属性値に値が設定されていない文書やフォルダーがヒットします。 | ac01op=IS_NULL | 指定する必要はありません。 | 指定できません。 | 使用できません。 | ― | |
| 値あり | 属性値に値が設定されている文書やフォルダーがヒットします。 | ac01op=IS_NOT_NULL | 指定する必要はありません。 | 指定できません。 | 使用できません。 | ― | |
| 整数／ 長整数／小数 | ＝ | 指定された数値と一致する属性値を持つ文書やフォルダーがヒットします。 | ac01op=EQUAL ac01val=123 |
数値 | 指定できません。 | 使用できません。 | ― |
| ≠ | 指定された数値とは一致しない属性値を持つ文書やフォルダーがヒットします。 | ac01op=NOT_EQUAL ac01val=123 |
数値 | 指定できません。 | 使用できません。 | ― | |
| ＞ | 指定された数値より大きい属性値を持つ文書やフォルダーがヒットします。 | ac01op=GREATER_THAN ac01val=123 |
数値 | 指定できません。 | 使用できません。 | ― | |
| ≧ | 指定された数値以上の属性値を持つ文書やフォルダーがヒットします。 | ac01op=GREATER_EQUAL ac01val=123 |
数値 | 指定できません。 | 使用できません。 | ― | |
| ＜ | 指定された数値より小さい属性値を持つ文書やフォルダーがヒットします。 | ac01op=LESS_THAN ac01val=123 |
数値 | 指定できません。 | 使用できません。 | ― | |
| ≦ | 指定された数値以下の属性値を持つ文書やフォルダーがヒットします。 | ac01op=LESS_EQUAL ac01val=123 |
数値 | 指定できません。 | 使用できません。 | ― | |
| 範囲 ・ 最小値 ・ 最大値 |
指定した範囲にある属性値を持つ文書やフォルダーがヒットします。 | ac01op=RANGE ac01valMin=123 ac01valMax=456 |
・ ac01valMin範囲の最小値 ・ ac01valMax範囲の最大値 最小値または最大値のどちらかは省略できます。 |
指定できません。 | 使用できません。 | ― | |
| いずれかに一致 | 数値のいずれかと一致する属性値を持つ文書やフォルダーがヒットします。 | ac01op=INCLUDE ac01val=123%20456 |
区切り文字を含めた文字列全体をURLエンコードした値。 | 半角または全角のスペースで区切って、ac01valに複数の値を指定します。 | 使用できません。 | ― | |
| 値なし | 属性値に値が設定されていない文書やフォルダーがヒットします。 | ac01op=IS_NULL | 指定する必要はありません。 | 指定できません。 | 使用できません。 | ― | |
| 値あり | 属性値に値が設定されている文書やフォルダーがヒットします。 | ac01op=IS_NOT_NULL | 指定する必要はありません。 | 指定できません。 | 使用できません。 | ― | |
| 日時 | 範囲 ・ 開始日時 ・ 終了日時 |
指定した範囲内の日時を持つ文書やフォルダーがヒットします。 | ac01op=RANGE ac01valstart=1540998000000 ac01valend=1546268400000 |
・ ac01valstart開始日時 ・ ac01valend終了日時 開始日時または終了日時のどちらかは省略可能です。 値は、エポックミリ秒で指定します。 |
指定できません。 | 使用できません。 | ― |
| 過去 ・年 ・月 ・週 ・日 ・時 ・秒 |
「年」、「月」、「週」、「日」、「時」、「秒」から選択し、指定された期間の日時を持つ文書やフォルダーがヒットします。 | ac01op=PAST ac01valunit=year ac01val=3 |
・ ac01valunit 時間の単位として 「year」、「month」、 「week」、「day」、「hour」、 「seconds」のいずれかを指定します。 ・ ac01val 指定した単位での数値を指定します。 |
指定できません。 | 使用できません。 | ― | |
| 値なし | 属性値が設定されていない文書やフォルダーがヒットします。 | ac01op=IS_NULL | 指定する必要はありません。 | 指定できません。 | 使用できません。 | ― | |
| 値あり | 属性値が設定されている文書やフォルダーがヒットします。 | ac01op=IS_NOT_NULL | 指定する必要はありません。 | 指定できません。 | 使用できません。 | ― | |
| ブーリアン | ＝ ・ TRUE ・ FALSE |
設定した値（「TRUE」または 「FALSE」）を属性値に持つ文書やフォルダーがヒットします。 |
ac01op=EQUAL ac01val=true |
「true」または「false」。 | 指定できません。 | 使用できません。 | ― |
| 値なし | 属性値が設定されていない文書やフォルダーがヒットします。 | ac01op=IS_NULL | 指定する必要はありません。 | 指定できません。 | 使用できません。 | ― | |
| 値あり | 属性値が設定されている文書やフォルダーがヒットします。 | ac01op=IS_NOT_NULL | 指定する必要はありません。 | 指定できません。 | 使用できません。 | ― | |
| ユーザー、グループ | いずれかに一致 | アドレス帳で追加したユーザー、グ ループのいずれかと一致する属性値を 持つ文書やフォルダーがヒットします。 |
ac01op=INCLUDE ac01val=1_1%3a38613dbe%2 dfb33%2d4c19%2dbe33%2d7 08ad49b8e34 ac01val=1_2:53596742-8067- 44fb-854f-57e83b5ce430 ･ ･ ･ ac01val=1_1%3aa7fe7ce0%2d 7758%2d4c63%2d8cd3%2dde 8e962c61ba |
ユーザー情報画面や、アドレス帳に表示される「識別子」をURLエンコードした値。 | ac01valを複数記述します。 | 使用できません。 | ― |
| 以外 | アドレス帳で追加したユーザー、グ ループと同じIDのユーザー、グループを持たない（値あり）の文書やフォルダーがヒットします。 | ac01op=EXCEPT ac01val=1_1%3a38613dbe%2 dfb33%2d4c19%2dbe33%2d7 08ad49b8e34 ac01val=1_2:53596742-8067- 44fb-854f-57e83b5ce430 ･ ･ ･ ac01val=1_1%3aa7fe7ce0%2d 7758%2d4c63%2d8cd3%2dde 8e962c61ba |
ユーザー情報画面や、アドレス帳で表示される「識別子」をURLエンコードした値。 | ac01valを複数記述します。 | 使用できません。 | ― | |
| 値なし | 属性値に値が設定されていない文書やフォルダーがヒットします。 | ac01op=IS_NULL | 指定する必要はありません。 | 指定できません。 | 使用できません。 | ― | |
| 値あり | 属性値に値が設定されている文書やフォルダーがヒットします。 | ac01op=IS_NOT_NULL | 指定する必要はありません。 | 指定できません。 | 使用できません。 | ― | |
| 文字列 （全文検索の場合） |
いずれかを含む | キーワードをいずれか含む全文検索インデックスが作成されている文書が ヒットします。 | ftcop=INCLUDE_ANY ftcval=ABC%20DEF |
区切り文字を含めた文字列全体をURLエンコードした値。 | 半角または全角のスペースで区切って、ftcvalに複数の値を指定します。 | 使用できません。 | ― |
| すべて含む | キーワードを全て含む全文検索イン デックスが作成されている文書がヒットします。 | ftcop=INCLUDE_ALL ftcval=ABC%20DEF |
区切り文字を含めた文字列全体をURLエンコードした値。 | 半角または全角のスペースで区切って、ftcvalに複数の値を指定します。 | 使用できません。 | ― | |
| いずれかのフレーズを含む | 各入力フィールドに記載されたフレーズをいずれか含む全文検索インデックスが作成されている文書がヒットします。 | ftcop=INCLUDE_PHRASE_ANY ftcval=ABC%20DEF ftcval=GHI%20JKL ･ ･ ･ ftcval=uvw%20xyz |
文字列全体をURLエンコードした値。 | ftcvalを複数記述します （最大6つまで）。 |
使用できません。 | ― | |
| すべてのフレーズを含む | 各入力フィールドに記載されたフレーズを全て含む全文検索インデックスが作成されている文書がヒットします。 | ftcop=INCLUDE_PHRASE_ALL ftcval=ABC%20DEF ftcval=GHI%20JKL ･ ･ ･ ftcval=uvw%20xyz |
文字列全体をURLエンコードした値。 | ftcvalを複数記述します （最大6つまで）。 |
使用できません。 | ― | |
＊1：実際に指定する場合は、改行ではなく「&」で区切ります。
＊2：「ac01」の「01」の部分は、指定する属性が共用検索定義の何番目かに応じて変更してください。