この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。
英語に切り替える

SoqlWhereCondition

リストビューの SOQL 検索条件に関する情報が含まれます。

SoqlWhereCondition にリストされる各条件は、条件の演算子を使用して項目値を比較値と比較する SOQL WHERE 句の条件式を表します。各条件には、次のプロパティが含まれます。

名前 説明
field string 検索条件で使用するオブジェクト項目。
operator soqlOperator 検索条件の演算子。次の演算子があります。
  • equals — 項目値が指定された値と一致する場合、条件は true。等号演算子を使用する文字列の比較の場合、大文字と小文字が区別される一意の項目は大文字と小文字が区別され、他のすべての項目は大文字と小文字が区別されません。
  • excludes — 複数選択リスト項目で選択された項目値が条件値のリストにない場合、条件は true。
  • greaterThan — 項目値が指定された値より大きい場合、条件は true。
  • greaterThenOrEqualTo — 項目値が指定された値以上の場合、条件は true。
  • in — 項目値が値リスト内の指定された値と一致する場合、条件は true。
  • includes — 複数選択リスト項目で選択された項目値が条件値のリストにある場合、条件は true。
  • lessThan — 項目値が指定された値より小さい場合、条件は true。
  • lessThanOrEqualTo — 項目値が指定された値以下の場合、条件は true。
  • like — 『SOQL および SOSL リファレンス』「比較演算子」に記載されている文字の一致ロジックを使用して、項目値が指定された値と一致する場合、条件は true。
  • notEquals — 項目値が指定された値と一致しない場合、条件は true。
  • notIn — 項目値が値リスト内の指定された値と一致しない場合、条件は true。
  • notLike — 『SOQL および SOSL リファレンス』「比較演算子」に記載されている文字の一致ロジックを使用して、項目値が指定された値と一致しない場合、条件は true。API バージョン 41.0 以降で使用できます。
  • within — 位置情報に基づく比較を使用して、項目値の位置が距離の値内にある場合、条件は true。詳細は、『SOQL および SOSL リファレンス』「位置情報に基づく SOQL クエリ」を参照してください。
values string[] operator 比較ロジックを使用して項目値と比較する 1 つ以上の値のリスト。

SoqlWhereConditions の評価

SOAP API では、Salesforce は SoqlWhereCondition のサブクラスを使用して条件のさまざまなカテゴリを表します。開発言語の型の比較機能 (Java の instanceof 演算子など) を使用して、SoqlWhereCondition の特定のインスタンスで使用されているサブクラスを判断します。

SoqlConditionGroup サブクラスは、SOQL WHERE 句の条件のグループを表し、次のプロパティを使用します。

名前 説明
conditions condition[] 検索条件のリスト。リストビューで検索条件ロジックを使用する場合、論理的な各検索条件グループが条件リストで表されます。
conjunction soqlConjunction 論理的な各検索条件グループで、複数の条件に使用する検索条件ロジックを表す結合演算子。次のような値があります。
  • and — SoqlWhereCondition 全体ですべての条件が true である必要があります。
  • or — SoqlWhereCondition 全体でいずれかの条件が true である必要があります。

SoqlNotCondition サブクラスは、like 演算子の特別な使用を表します。API バージョン 40.0 以前では、not like 演算子 (UI では [次の文字列を含まない] と表示) を使用して作成された SoqlWhereCondition を評価する場合、条件の演算子の値は like になります。Salesforce は SoqlWhereCondition の SoqlNotCondition サブクラスも使用して、完全な条件を表します。次の例では、Java の instanceof 演算子を使用して、not like 演算子が指定されているかどうかを判断します。

1if (resultSoqlWhereCondition instanceof SoqlNotCondition) {
2  // condition is really NOT condition
3  // if operator is "like", this condition really means "not like"
4  ...
5}

API バージョン 41.0 以降では、SoqlNotCondition と like 演算子の代わりに、notLike 演算子が使用されます。notLike 演算子は、リストビューでのみ使用できます。他の Salesforce 機能で使用される SOQL クエリでは使用できません。