SOQL ​

特定のレコードを検索するために、Salesforce Object Query Language (SOQL) を使用してSalesforceデータを検索できます。 SOQLはStructured Query Language（SQL）のSELECTステートメントに似ていますが、Salesforceデータ専用に設計されています。次のSalesforceコネクター操作はSOQLをサポートしています:

アクション:

• SOQLクエリを使用したレコード検索
• SOQLクエリを使用したレコードの一括検索
• SOQLクエリのWHERE句を使用したレコード検索

トリガー:

• 新規レコードのエクスポート
• 新規/更新済みレコードのエクスポート
• レコードの変更を監視
• 新規プラットフォームイベント
• 新規レコード

次のクエリは、SOQLクエリの基本構文を示しています:

• SELECT（フィールドのリスト）
• FROM（オブジェクト）
• WHERE（フィルターステートメントと任意の並べ替え）

主要なSalesforceオブジェクトの標準フィールドのリストについては、Salesforce Fields Referenceを参照してください。

SOQL WHERE条件（構文） ​

SOQLのWHERE句はフィールド式の構文に従います。 fieldExpressionは<fieldName> <comparisonOperator> <value>として定義されます。次のセクションでは、有効なSOQLWHEREクエリの例を示します。

比較演算子 ​

次のリストには、すべてのSOQL比較演算子が含まれています:

• =
• !=
• <
• <=
• >
• >=
• LIKE
• IN
• NOT IN
• INCLUDES
• EXCLUDES

次の例では、有効なSOQL比較演算子とともにfieldExpression構文を使用しています:

比較演算子とともにfieldExpression構文を使用する例

各比較演算子の使用方法の詳細については、Comparison Operatorsを参照してください。

論理演算子 ​

複数のフィールド式は、論理演算子を使用して結合できます。これには、AND、OR、NOTが含まれます。次のリストには、各演算子の基本構文が含まれています:

• fieldExpressionX AND fieldExpressionY
• fieldExpressionX OR fieldExpressionY
• NOT fieldExpressionX

次の例では、論理演算子で結合された2つのfieldExpressionsを使用しています:

論理演算子を使用して2つのfieldExpressionsを結合する例

論理演算子の詳細については、Logical Operatorsを参照してください。

その他のSOQL句 ​

• LIMIT: 検索で返される結果の数を制限します。
• OFFSET: 結果を返す前に、指定した数の行をスキップします。

両方の句の最大値は2,000です。 2,000を超えるオフセットをリクエストすると、NUMBER_OUTSIDE_VALID_RANGEエラーが発生します。

日付形式と日付リテラル ​

dateまたはdateTimeフィールドをクエリするには、Formulaモードを使用する必要があります。 Formulaモードは、タイムスタンプをSOQLで想定されるISO8601形式に変換します。

クエリでdateフィールドをフィルターするには、Date only形式を使用する必要があります。この構文はYYYY-MM-DDです。

クエリでdateTimeフィールドをフィルターするには、日付、時刻、タイムゾーンオフセットを含む形式を使用する必要があります。 dateTime形式には3つの形式があります:

• YYYY-MM-DDThh:mm:ss+hh:mm
• YYYY-MM-DDThh:mm:ss-hh:mm
• YYYY-MM-DDThh:mm:ssZ

次の2つの例では、SOQLクエリで.to_dateを使用する方法を示しています。

クエリで.to_dateを使用する例クエリで.to_dateを使用する例

dateTimeフィールドの場合、クエリで使用する推奨形式はYYYY-MM-DDThh:mm:ssZ形式です。 nowや2.weeks.ago.beginning_of_dayなどのFormulaを使用して目的のタイムスタンプを取得した後、クエリの末尾に.strftime("%Y-%m-%dT%H:%M:%S%z")を追加します。

クエリで.strftimeを使用する例

日付形式と日付リテラルの詳細については、Date Formats and Date Literalsを参照してください。

SOQLを使用するトリガーとアクション ​

WHERE句を使用したクエリ ​

次のトリガーまたはアクションのいずれかを使用して、Workato UIで指定したフィールドを使用してSOQL入力が自動的に設定されるSOQLクエリをセットアップします。 Workato UIで使用可能なフィールドを使用して入力が設定されるSOQLクエリをすばやくセットアップするには、以下のトリガーまたはアクションのいずれかを使用します:

トリガー

• SOQLクエリのWHERE句を使用したスケジュール済みレコード検索

アクション

• SOQLクエリを使用したレコードの一括検索（API 1.0）
• SOQLクエリのWHERE句を使用したレコード検索

WHERE句を必要とするトリガーまたはアクションを使用する場合、レシピはクエリのSELECT FROM部分を自動的に処理します。レシピは、Fields to retrieveピックリストで選択したオブジェクトを使用して、そのオブジェクトFROMのすべてのフィールドをSELECTします。

使用可能な場合は、LIMITフィールドとOFFSETフィールドの値も指定できます。 LIMITフィールドとOFFSETフィールドは、一括アクションではサポートされていません。

特殊文字のエスケープ ​

SOQL WHERE句にエスケープされていない"または'文字が含まれている場合、Salesforceはクエリを不正な形式としてマークします。特殊文字の前にバックスラッシュ（\）を追加してエスケープできます。例: O\'glenn Johnson。

Rubyのgsub関数を使用して、特定の文字を置換することもできます。例:

gsub(/'/, "\\:'").gsub(/:/, "")

完全なSOQLクエリを使用したクエリ ​

Workatoで完全なSOQLクエリを使用するには、以下のトリガーまたはアクションのいずれかを使用します:

トリガー

• SOQLクエリを使用したスケジュール済みレコード検索

アクション

• SOQLクエリを使用したレコードの一括検索（API 2.0）
• SOQLクエリを使用したレコード検索

完全なSOQLクエリの使用 ​

次の例は、Search records in bulk using SOQL query (API 2.0) または Search for records using SOQL query アクションのSOQLクエリを示しています。

アクション用SOQLクエリの例

出力スキーマを生成するには、Use SOQLを選択します。 SOQL Queryフィールドに入力したものと同じSOQLを、Provide SOQL Queryフィールドで使用します。 Output schemaセクションのReview dataステージで、クエリが実行され、サンプル行が返されます。出力スキーマを生成するには、Generate schemaを選択します。

スキーマ生成の例

後続のレシピステップでは、SOQLクエリの出力にデータツリーからアクセスできます。

追加ドキュメント ​

その他のSOQLリソースについては、次のSalesforceドキュメントを参照してください:

• SOQL
• WHERE句の構文