ステップ 2: ジョブの作成

データを読み込むには、まずジョブを作成する必要があります。ジョブには、読み込むオブジェクトの種別 (取引先責任者など) と、実行する処理 (クエリ、挿入、更新、更新/挿入、削除など) を指定します。ジョブでは、ユーザがデータ読み込みのプロセスをある程度制御できます。たとえば、進行中のジョブを中止することなどが可能です。

cURL を使用してジョブを作成する手順は、次のとおりです。

1. job.txt という名前のテキストファイルを作成し、次のテキストを含めます。
   1<?xml version="1.0" encoding="UTF-8"?>
   2
   3<jobInfo xmlns="http://www.force.com/2009/06/asyncapi/dataload">
   4
   5    <operation>insert</operation>
   6
   7    <object>Contact</object>
   8
   9    <contentType>CSV</contentType>
   10
   11</jobInfo>

   この operation 項目の値はすべて小文字で入力してください。たとえば、insert の代わりに INSERT と入力すると、エラーが発生します。

   警告

2. コマンドラインウィンドウを使用して、次の cURL コマンドを実行します。

   curl https://instance.salesforce.com/services/async/33.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
   3<jobInfo
   4
   5   xmlns="http://www.force.com/2009/06/asyncapi/dataload">
   6
   7  <id>750x0000000005LAAQ</id>
   8
   9  <operation>insert</operation>
   10
   11  <object>Contact</object>
   12
   13  <createdById>005x0000000wPWdAAM</createdById>
   14
   15  <createdDate>2009-09-01T16:42:46.000Z</createdDate>
   16
   17  <systemModstamp>2009-09-01T16:42:46.000Z</systemModstamp>
   18
   19  <state>Open</state>
   20
   21  <concurrencyMode>Parallel</concurrencyMode>
   22
   23  <contentType>CSV</contentType>
   24
   25  <numberBatchesQueued>0</numberBatchesQueued>
   26
   27  <numberBatchesInProgress>0</numberBatchesInProgress>
   28
   29  <numberBatchesCompleted>0</numberBatchesCompleted>
   30
   31  <numberBatchesFailed>0</numberBatchesFailed>
   32
   33  <numberBatchesTotal>0</numberBatchesTotal>
   34
   35  <numberRecordsProcessed>0</numberRecordsProcessed>
   36
   37  <numberRetries>0</numberRetries>
   38
   39  <apiVersion>33.0</apiVersion>
   40
   41</jobInfo>

3. <id> 要素内に返されたジョブ ID の値をメモしておいてください。後続の処理で使用します。