Bulk API 開発者ガイド
jステップ 2: ジョブの作成
データを読み込むには、まずジョブを作成します。ジョブには、読み込むオブジェクトの種別 (取引先責任者など) と、実行する操作 (クエリ、queryAll、挿入、更新、更新/挿入、削除など) を指定します。ジョブでは、ユーザがデータ読み込みのプロセスをある程度制御できます。たとえば、進行中のジョブを中止することなどが可能です。
-
job.txt という名前のテキストファイルを作成し、次のテキストを含めます。
1<?xml version="1.0" encoding="UTF-8"?> 2<jobInfo xmlns="http://www.force.com/2009/06/asyncapi/dataload"> 3 <operation>insert</operation> 4 <object>Contact</object> 5 <contentType>CSV</contentType> 6</jobInfo> - コマンドラインウィンドウを使用して、次の cURL コマンドを実行します。
curl https://instance.salesforce.com/services/async/44.0/job -H "X-SFDC-Session: sessionId" -H "Content-Type: application/xml; charset=UTF-8" -d @job.txt
instance は、ログインの応答でメモした <serverUrl> 要素の一部分です。sessionId は同様にメモした <sessionId> 要素です。
Salesforce により、次のようなデータを含む XML 応答が返されます。
1<?xml version="1.0" encoding="UTF-8"?> 2<jobInfo 3 xmlns="http://www.force.com/2009/06/asyncapi/dataload"> 4 <id>750x0000000005LAAQ</id> 5 <operation>insert</operation> 6 <object>Contact</object> 7 <createdById>005x0000000wPWdAAM</createdById> 8 <createdDate>2009-09-01T16:42:46.000Z</createdDate> 9 <systemModstamp>2009-09-01T16:42:46.000Z</systemModstamp> 10 <state>Open</state> 11 <concurrencyMode>Parallel</concurrencyMode> 12 <contentType>CSV</contentType> 13 <numberBatchesQueued>0</numberBatchesQueued> 14 <numberBatchesInProgress>0</numberBatchesInProgress> 15 <numberBatchesCompleted>0</numberBatchesCompleted> 16 <numberBatchesFailed>0</numberBatchesFailed> 17 <numberBatchesTotal>0</numberBatchesTotal> 18 <numberRecordsProcessed>0</numberRecordsProcessed> 19 <numberRetries>0</numberRetries> 20 <apiVersion>44.0</apiVersion> 21 <numberRecordsFailed>0</numberRecordsFailed> 22 <totalProcessingTime>0</totalProcessingTime> 23 <apiActiveProcessingTime>0</apiActiveProcessingTime> 24 <apexProcessingTime>0</apexProcessingTime> 25</jobInfo> - <id> 要素内に返されたジョブ ID の値をメモしておいてください。後続の処理で使用します。