Salesforce の SOQL 実行アクション

Salesforce のデータを検索して特定の情報を取得するには、Salesforce の [SOQL を実行] アクションを使用して、Automation 360 から Salesforce Object Query Language (SOQL) コマンドを実行します。

SOQL は構造化照会言語 (SQL) に似ていますが、Salesforce のデータ用に調整されています。SOQL の詳細については、「Salesforce の SOQL 実行」を参照してください。

Salesforce のデータから特定の情報を取得するには、Automation 360 からクエリを実行します。

[SOQL を実行] アクションを使用して Salesforce に SOQL クエリを送信するには、次の手順を実行します。
注: Salesforce のアクションを呼び出す前に、認証されていることを確認してください。認証の詳細については、「Salesforce の認証アクション」を参照してください。

手順

  1. [アクション] ペインから [Salesforce] > [SOQL を実行] を選択し、キャンバスに配置します。
    Salesforce の [SOQL を実行] アクション
  2. 次のフィールドを入力します。
    1. 実行する SOQL クエリを入力します (例: Select Status From Case Where Id = '5004W000026rD4HQAU')。
      注: Salesforce カスタム オブジェクトの場合、オブジェクトの表示名の代わりに API 名を指定してください。たとえば、次のように指定します。API 名: 「AAIRPA__Salesforce_Connection__c」を指定し、表示名: Salesforce 接続は表示されません。API 名の確認方法については、「https://help.salesforce.com/s/articleView?id=000327123&type=1」を参照してください。
    2. 次のいずれかのオプションを選択します。
      • 削除されたレコードを含めたい場合は、[はい] を選択します。
      • 削除されたレコードを含めたくない場合は、[いいえ] を選択します。
    3. [デフォルト] をセッション名として入力します。
    4. 結果を変数に保存します。たとえば、レコードのすべてのフィールドをリスト (List_SOQL) に格納することができます。
  3. ブレーク ポイントを [SOQL を実行] の隣のアクションに設定して、Bot をデバッグ モードで実行できることを確認します。たとえば、前に提供されたサンプルには、メッセージ ボックス アクションがあります。List_SOQL 変数を開いて、結果を表示します。
    Salesforce の [SOQL 検証実行] アクション
    Salesforce の [SOQL を実行] アクションの応答として結果セット全体が返されます。返されるレコードの数に制限はありません。
    注: 応答には大量のデータが含まれる場合があるため、オートメーションのパフォーマンスが低下することがあります。
    注: 出力は、ディクショナリ型のリストとして取得されます。このリストの個々のレコード (行) を読み取るには、ループ アクションを使用してすべてのディクショナリ項目をループし、レコード (行) を個別に読み取るか抽出する必要があります。たとえば、[複数のレコードを取得] の出力は、変数 list_of_records_any に保存されます。変数に 5 つのレコードが含まれている場合、各レコードは Loop アクションに渡され、一度に 1 つずつ処理されます。複数のレコードを取得するループ アクション