Skip Navigation

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

英語に切り替える

一括クエリサンプルの説明

このコードサンプルは、cURL を使用していくつかの取引先レコードを照会します。

インテグレーションまたはその他のクライアントアプリケーションを作成する前に、次のことを実行してください。

製品ドキュメントに従って、開発プラットフォームをインストールする。
テストクライアントアプリケーションの作成を開始する前に、すべての手順に目を通す。用語およびコンセプトについて理解するために、このマニュアルの残りの部分も確認します。

メモ

ジョブの作成

次のテキストを含む、create-job.xml というファイルを作成します。
コマンドラインウィンドウを使用して、次の cURL コマンドを実行し、新しいジョブを作成します。
curl -H "X-SFDC-Session: sessionId" -H "Content-Type: application/xml; charset=UTF-8" -d @create-job.xml https://instance.salesforce.com/services/async/57.0/job

instance は、ログインの応答でメモした <serverUrl> 要素の一部分です。sessionId は同様にメモした <sessionId> 要素です。

Salesforce により、次のようなデータを含む XML 応答が返されます。

ジョブへのバッチの追加

SOQL クエリステートメントを含む、query.txt というファイルを作成します。
コマンドラインウィンドウを使用して、次の cURL コマンドを実行し、ジョブにバッチを追加します:
curl -d @query.txt -H "X-SFDC-Session: sessionId" -H "Content-Type: text/csv; charset=UTF-8" https://instance.salesforce.com/services/async/57.0/job/jobId/batch

jobId は、ジョブ作成の応答で返されたジョブ ID です。

Salesforce により、次のようなデータを含む XML 応答が返されます。

一括クエリジョブにバッチを追加するときに、要求のヘッダーの Content-Type には、ジョブの作成時に指定されたコンテンツタイプに応じて、text/csv、application/xml、または application/json を指定する必要があります。バッチに使用される実際の SOQL ステートメントは、平文テキスト形式で表されます。
メモ

ジョブの終了

次のテキストを含む、close-job.xml というファイルを作成します。
コマンドラインウィンドウを使用して、次の cURL コマンドを実行し、ジョブを終了します。
curl -H "X-SFDC-Session: sessionId" -H "Content-Type: text/csv; charset=UTF-8" -d @close-job.xml https://instance.salesforce.com/services/async/57.0/job/jobId

Salesforce により、次のようなデータを含む XML 応答が返されます。

ジョブとバッチの状況の確認

コマンドラインウィンドウを使用して、次の cURL コマンドを実行し、ジョブの状況を確認します。
curl -H "X-SFDC-Session: sessionId" https://instance.salesforce.com/services/async/57.0/job/jobId

Salesforce により、次のようなデータを含む XML 応答が返されます。
コマンドラインウィンドウを使用して、次の cURL コマンドを実行し、バッチの状況を確認します。
curl -H "X-SFDC-Session: sessionId" https://instance.salesforce.com/services/async/57.0/job/jobId/batch/batchId

batchId は、バッチ作成の応答で返されたバッチ ID です。

Salesforce により、次のようなデータを含む XML 応答が返されます。

結果の取得

コマンドラインウィンドウを使用して、次の cURL コマンドを実行し、バッチ結果のリストを取得します。
curl -H "X-SFDC-Session: sessionId" https://instance.salesforce.com/services/async/57.0/job/jobId/batch/batchId/result

Salesforce により、次のようなデータを含む XML 応答が返されます。

バッチに再試行が必要であった場合、出力に複数の <result> 要素が記述されます。
メモ
コマンドラインウィンドウを使用して、次の cURL コマンドを実行し、クエリの結果を取得します。
curl -H "X-SFDC-Session: sessionId" https://instance.salesforce.com/services/async/57.0/job/jobId/batch/batchId/result/resultId

resultId は、バッチ結果リストの要求に対する応答で返された結果 ID です。

Salesforce により、次のようなデータを含む CSV 応答が返されます。