ブロックリファレンス

BLOCKS Reference

Salesforce

SOQL クエリーの実行

概要

このブロックは、Salesforce の SOQL クエリーを実行して、結果を「結果を格納する変数」プロパティで指定された変数に格納します。

SOQL クエリーの実行ブロックの概念図

変数には、オブジェクト配列形式で、クエリー結果が格納されます。変数に格納されたデータを処理する系統のブロックと組み合わせて使用できます。

以下に、変数に格納されたデータを処理する系統のブロックの一部を列挙します。

SOQL クエリーを実行した結果のレコード件数が多いと、ブロックの実行がエラーになったり、動作しなくなる可能性があります。大量のレコード件数を扱う場合は、「SOQL クエリーの結果から GCS にファイル作成」ブロックの利用をおすすめします。

プロパティ

プロパティ名 説明
ブロック名

編集パネルに配置した当該ブロックの表示名が変更できます。

ブロックリストパネル中のブロック名は変更されません。

アカウント

Salesforce アカウントを選択します。

Salesforce アカウントは、あらかじめフローデザイナーの設定の Salesforce アカウントで設定を済ませておく必要があります。

SOQL クエリー

Salesforce の SOQL クエリーを指定します。

変数展開の指定が可能][% 形式の文字列書式の指定が可能]
結果を格納する変数

SOQL クエリーを実行した結果を格納する変数を指定します。

クエリー結果は、以下のようなオブジェクト配列形式で格納されます。

[
  {
    "name": "opportunityA",
    "amount": 100.99,
    "sales_date": "2021-06-30"
  },
  {
    "name": "opportunityB",
    "amount": 99.01,
    "sales_date": "2021-01-30"
  }
]  
Sandbox SOQL クエリーの実行先となる Salesforce が Sandbox 環境かどうかを指定します。
ブロックメモ このブロックに関するメモが記載できます。このブロックの処理に影響しません。
API バージョン

このブロックで使用する API のバージョンを指定します(このブロックでは、Salesforce が提供する API 経由で SOQL クエリーを実行しています)。

API のバージョンによって、使用できるクエリーの文法や関数が異なる可能性があります。UNSUPPORTED_API_VERSION というエラーメッセージがフローデザイナーのログに出力された場合は、このプロパティを適切な API バージョンに変更すると解決する可能性があります。

自身の環境で使用できる API バージョンについては、Salesforce の Edition および API バージョンを確認する方法 を参照してください。

この情報は役に立ちましたか?