SOQL を実行

UiPath.Salesforce.Activities.ExecuteSoql

Salesforce で Salesforce Object Query Language (SOQL) コマンドを実行し、クエリ結果を DataTable で返します。このアクティビティは、[Salesforce アプリケーション スコープ] アクティビティ内でのみ機能します。

プロパティ

共通

• 表示名 - アクティビティの表示名です。

入力

• SOQL コマンド - 実行する SOQL コマンドです。これは有効な SOQL コマンドでなければなりません。このフィールドは、文字列と String 型変数のみをサポートします。
  注:

  SOQL は、クエリで有効ないくつかのエスケープ シーケンスを定義しているため、検索テキストに特殊文字を含めることができます。改行、キャリッジリターン、タブ、引用符などをエスケープできます。SOQL で使用されるエスケープ文字は、バックスラッシュ (\) 文字です。こちらから、Salesforce の公式ドキュメントを確認して、詳細を参照することができます。

  SOQL コマンドに連結されたすべての検索文字列がエスケープされない場合、これらの特殊文字が検索文字列に存在するとアクティビティは MALFORMED_QUERY エラーをスローします。各検索文字列は、連結する前に次のようにエスケープする必要があります。

  str_Company.Replace(“\”, “\”).Replace(“'“, “\'”).Replace(“”””, “\”””)

  例： SOQL コマンドが

  "Select Id from Account where Name = '" + str_Company + "'"

  および str_Company is John's Pizza にエスケープされずに渡されると、MALFORMED_QUERY エラーが返されます。正しい SOQL コマンドは次のとおりです。

  "Select Id from Account where Name = '" + str_Company.Replace(“\”, “\”).Replace(“'“, “\'”).Replace(“”””, “\”””) + "'"

その他

• プライベート - オンにした場合、変数および引数の値が Verbose レベルでログに出力されなくなります。

出力

• 結果 - DataTable 型変数に格納された SOQL コマンドの実行結果です。このフィールドでは DataTable 型変数のみがサポートされています。
• SalesforceStatus - アクションが完了した時点で、Salesforce から返されるステータスで SalesforceStatus 変数に格納されています。このフィールドは SalesforceStatus 変数のみをサポートします。