DataFileSources APIサンプル呼び出し
このページは機械翻訳を使用して翻訳されています。
DataFileSources GET
クエリオプション
以下は、さまざまなクエリオプションとそのパラメータを示す表です
フィルター名 | 目的 |
created_at | created_atパラメータを使用して、処理されたファイルの詳細なステータスが必要な開始と終了のタイムスタンプを制御します(ファイルステータス、フィールドレベルエラー) |
source_for | source_forパラメータを使用して、対象のオブジェクトに基づいてファイルをフィルタリングします。 |
type |
typeパラメーターを使用して、情報が必要なファイルの種類を決定します-Coupaに送信されたファイルまたはCoupaによって送信されたファイル |
status | ステータスパラメーターを使用して、クエリの目標に応じて処理ステータス別にデータソースを除外します |
file_file_name | file_file_nameパラメータを使用して、特定のファイルのデータファイルソースを検索します |
データ構造
以下は、特定のGET呼び出しに対して返されるさまざまな値の概要を示す表です。フィールド名の前のスペースは、それが前述のタグのいずれかにネストされていることを意味します。
論争 | タイプ | 値 |
id | 整数 | |
created-at | 日時 | YYY-MM-DDTHH:MM:SS-HH:MM |
updated-at | 日時 | YYYY-MM-DDTHH:MM:SS+HH:MM |
type | string型 | BackgroundCsvFileLoad、DataFileSource、BackgroundImportCorporateCreditCard ... |
ソース用 | string型 | InvoiceHeader、支払、インボイス、ExpenseReport、サプライヤー、ユーザー、アイテム、商品、住所、契約、アカウント、検索値... |
status | string型 | 完了、失敗、再試行、ロード中、Resqueに送信済み、保留中、アップロード中、一時停止中、停止中 |
ファイルファイル名 | string型 | Invoices_20141209_234608Z.csvなど |
ファイルファイルサイズ | string型 | 9822 |
結果テキスト | string型 | 処理結果の例27行が処理され、0行が新規作成され、11行が更新されています。 |
進捗状況 | 整数 | 27 |
開始時間 | 日時 | YYYY-MM-DDTHH:MM:SS+HH:MM |
終了時間 | 日時 | YYYY-MM-DDTHH:MM:SS+HH:MM |
アップロードエラー | 配列 | |
アップロードエラー/アップロードエラー | ||
アップロードエラー/アップロードエラー/ID | 整数 | 123456 |
アップロードエラー/アップロードエラー/作成日時 | 日時 | YYYY-MM-DDTHH:MM:SS+HH:MM |
アップロードエラー/アップロードエラー/更新日時 | 日時 | YYYY-MM-DDTHH:MM:SS+HH:MM |
アップロードエラー/アップロードエラー/タイプ | string型 | エラーのタイプ、例:UploadRowError |
アップロードエラー/アップロードエラー/行 | 整数 | 1 |
アップロードエラー/アップロードエラー/最初の列 | ||
アップロードエラー/アップロードエラー/フィールド付きエラー | string型 | エラーが発生した列名 |
アップロードエラー/アップロードエラー/値 | string型 |
下書き、pending_buyer_action、pending_approval、承認済み、受領済み、注文済み、一部受領済み、却下済み、作成済み |
アップロードエラー/アップロードエラー/フィールドエラー | 配列 | |
アップロードエラー/アップロード=エラー/作成者 | user |
ID、ログイン、姓名、電子メールなどを含むユーザーレコード |
アップロードエラー/アップロードエラー/更新者 | user | ID、ログイン、姓名、電子メールなどを含むユーザーレコード |
created_by | user |
ID、ログイン、姓名、電子メールなどを含むユーザーレコード |
updated_by | user | ID、ログイン、姓名、電子メールなどを含むユーザーレコード |
サンプルAPI呼び出し
DataFileSourcesクエリの例-指定された日付のクエリ
この例では、過去24時間に作成されたすべてのDataFileSourcesを探しています(現在の時刻は2015年4月17日午後3時PSTまたは '2015-04-17 22:00:00')。これより大きな日付時刻を使用することもできます。 DataFileSource APIには、それを参照する多数の関連オブジェクトとレコードがあることに注意してください。そのため、大きな数値やレコードをクエリすると、インスタンスのパフォーマンスが低下する可能性があります。さらに、CoupaへのすべてのAPI呼び出しと同様に、1回の呼び出しで返すことができるレコードは50件に制限されています。次のセットを問い合わせるには、 &offset = 50 を通話の最後に追加します
https://<instance>.coupahost.com/api/data_file_sources?created_at[gt]='<timestamp>'
https://<instance>.coupahost.com/api/data_file_sources?created_at[gt]='2015-04-16 22:00:00'
サンプル日次データソース
<?xml version="1.0" encoding="UTF-8"?> <data-file-sources type="array"> <data-file-source> <id type="integer">1117</id> <created-at type="datetime">2015-04-17T08:34:17-07:00</created-at> <updated-at type="datetime">2015-04-17T08:34:25-07:00</updated-at> <type>BackgroundCsvFileLoad</type> <source-for>LookupValue</source-for> <status>sample</status> <file-file-name>lookup_value_list_wbstype.csv</file-file-name> <file-content-type>text/csv</file-content-type> <file-file-size>300</file-file-size> <result-text nil="true" /> <progress nil="true" /> <start-time nil="true" /> <end-time nil="true" /> <upload-errors type="array"> <upload-error> <id type="integer">920</id> <created-at type="datetime">2015-04-17T08:34:25-07:00</created-at> <updated-at type="datetime">2015-04-17T08:34:25-07:00</updated-at> <type>UploadRowError</type> <row type="integer">2</row> <first-column>SAP Upgrade</first-column> <field-with-error>parent_id</field-with-error> <value>1</value> <field-errors type="array"> <field-error>Parent unable to find matching parent.</field-error> </field-errors> <created-by> <id type="integer">81</id> <login>bknott</login> <email>brent.knott+bknott@coupa.com</email> <employee-number /> <firstname>Brent</firstname> <lastname>Knott</lastname> <salesforce-id nil="true" /> <company-code>100</company-code> <cost-center>10000</cost-center> <account-category>K</account-category> </created-by> <updated-by> <id type="integer">81</id> <login>bknott</login> <email>brent.knott+bknott@coupa.com</email> <employee-number /> <firstname>Brent</firstname> <lastname>Knott</lastname> <salesforce-id nil="true" /> <company-code>100</company-code> <cost-center>10000</cost-center> <account-category>K</account-category> </updated-by> </upload-error> <upload-error> <id type="integer">921</id> <created-at type="datetime">2015-04-17T08:34:25-07:00</created-at> <updated-at type="datetime">2015-04-17T08:34:25-07:00</updated-at> <type>UploadRowError</type> <row type="integer">3</row> <first-column>Coupa Implementation</first-column> <field-with-error>parent_id</field-with-error> <value>1</value> <field-errors type="array"> <field-error>Parent unable to find matching parent.</field-error> </field-errors> <created-by> <id type="integer">81</id> <login>bknott</login> <email>brent.knott+bknott@coupa.com</email> <employee-number /> <firstname>Brent</firstname> <lastname>Knott</lastname> <salesforce-id nil="true" /> <company-code>100</company-code> <cost-center>10000</cost-center> <account-category>K</account-category> </created-by> <updated-by> <id type="integer">81</id> <login>bknott</login> <email>brent.knott+bknott@coupa.com</email> <employee-number /> <firstname>Brent</firstname> <lastname>Knott</lastname> <salesforce-id nil="true" /> <company-code>100</company-code> <cost-center>10000</cost-center> <account-category>K</account-category> </updated-by> </upload-error> </upload-errors> <created-by> <id type="integer">81</id> <login>bknott</login> <email>brent.knott+bknott@coupa.com</email> <employee-number /> <firstname>Brent</firstname> <lastname>Knott</lastname> <salesforce-id nil="true" /> <company-code>100</company-code> <cost-center>10000</cost-center> <account-category>K</account-category> </created-by> <updated-by> <id type="integer">81</id> <login>bknott</login> <email>brent.knott+bknott@coupa.com</email> <employee-number /> <firstname>Brent</firstname> <lastname>Knott</lastname> <salesforce-id nil="true" /> <company-code>100</company-code> <cost-center>10000</cost-center> <account-category>K</account-category> </updated-by> </data-file-source> <data-file-source> <id type="integer">1118</id> <created-at type="datetime">2015-04-17T08:35:15-07:00</created-at> <updated-at type="datetime">2015-04-17T08:35:16-07:00</updated-at> <type>BackgroundCsvFileLoad</type> <source-for>LookupValue</source-for> <status>sample</status> <file-file-name>lookup_value_list_wbstype.csv</file-file-name> <file-content-type>text/csv</file-content-type> <file-file-size>304</file-file-size> <result-text nil="true" /> <progress nil="true" /> <start-time nil="true" /> <end-time nil="true" /> <upload-errors type="array"> <upload-error> <id type="integer">922</id> <created-at type="datetime">2015-04-17T08:35:16-07:00</created-at> <updated-at type="datetime">2015-04-17T08:35:16-07:00</updated-at> <type>UploadRowError</type> <row type="integer">2</row> <first-column>SAP Upgrade</first-column> <field-with-error>parent_id</field-with-error> <value>1</value> <field-errors type="array"> <field-error>Parent unable to find matching parent.</field-error> </field-errors> <created-by> <id type="integer">81</id> <login>bknott</login> <email>brent.knott+bknott@coupa.com</email> <employee-number /> <firstname>Brent</firstname> <lastname>Knott</lastname> <salesforce-id nil="true" /> <company-code>100</company-code> <cost-center>10000</cost-center> <account-category>K</account-category> </created-by> <updated-by> <id type="integer">81</id> <login>bknott</login> <email>brent.knott+bknott@coupa.com</email> <employee-number /> <firstname>Brent</firstname> <lastname>Knott</lastname> <salesforce-id nil="true" /> <company-code>100</company-code> <cost-center>10000</cost-center> <account-category>K</account-category> </updated-by> </upload-error> <upload-error> <id type="integer">923</id> <created-at type="datetime">2015-04-17T08:35:16-07:00</created-at> <updated-at type="datetime">2015-04-17T08:35:16-07:00</updated-at> <type>UploadRowError</type> <row type="integer">3</row> <first-column>Coupa Implementation</first-column> <field-with-error>parent_id</field-with-error> <value>1</value> <field-errors type="array"> <field-error>Parent unable to find matching parent.</field-error> </field-errors> <created-by> <id type="integer">81</id> <login>bknott</login> <email>brent.knott+bknott@coupa.com</email> <employee-number /> <firstname>Brent</firstname> <lastname>Knott</lastname> <salesforce-id nil="true" /> <company-code>100</company-code> <cost-center>10000</cost-center> <account-category>K</account-category> </created-by> <updated-by> <id type="integer">81</id> <login>bknott</login> <email>brent.knott+bknott@coupa.com</email> <employee-number /> <firstname>Brent</firstname> <lastname>Knott</lastname> <salesforce-id nil="true" /> <company-code>100</company-code> <cost-center>10000</cost-center> <account-category>K</account-category> </updated-by> </upload-error> </upload-errors> <created-by> <id type="integer">81</id> <login>bknott</login> <email>brent.knott+bknott@coupa.com</email> <employee-number /> <firstname>Brent</firstname> <lastname>Knott</lastname> <salesforce-id nil="true" /> <company-code>100</company-code> <cost-center>10000</cost-center> <account-category>K</account-category> </created-by> <updated-by> <id type="integer">81</id> <login>bknott</login> <email>brent.knott+bknott@coupa.com</email> <employee-number /> <firstname>Brent</firstname> <lastname>Knott</lastname> <salesforce-id nil="true" /> <company-code>100</company-code> <cost-center>10000</cost-center> <account-category>K</account-category> </updated-by> </data-file-source> <data-file-source> <id type="integer">1119</id> <created-at type="datetime">2015-04-17T08:36:07-07:00</created-at> <updated-at type="datetime">2015-04-17T08:36:07-07:00</updated-at> <type>BackgroundCsvFileLoad</type> <source-for>LookupValue</source-for> <status>sample</status> <file-file-name>lookup_value_list_wbstype.csv</file-file-name> <file-content-type>text/csv</file-content-type> <file-file-size>344</file-file-size> <result-text nil="true" /> <progress nil="true" /> <start-time nil="true" /> <end-time nil="true" /> <upload-errors type="array"> <upload-error> <id type="integer">917</id> <created-at type="datetime">2015-04-17T08:36:08-07:00</created-at> <updated-at type="datetime">2015-04-17T08:36:08-07:00</updated-at> <type>UploadRowError</type> <row type="integer">2</row> <first-column>SAP Upgrade</first-column> <field-with-error>parent_id</field-with-error> <value>1</value> <field-errors type="array"> <field-error>Parent unable to find matching parent.</field-error> </field-errors> <created-by> <id type="integer">81</id> <login>bknott</login> <email>brent.knott+bknott@coupa.com</email> <employee-number /> <firstname>Brent</firstname> <lastname>Knott</lastname> <salesforce-id nil="true" /> <company-code>100</company-code> <cost-center>10000</cost-center> <account-category>K</account-category> </created-by> <updated-by> <id type="integer">81</id> <login>bknott</login> <email>brent.knott+bknott@coupa.com</email> <employee-number /> <firstname>Brent</firstname> <lastname>Knott</lastname> <salesforce-id nil="true" /> <company-code>100</company-code> <cost-center>10000</cost-center> <account-category>K</account-category> </updated-by> </upload-error> <upload-error> <id type="integer">925</id> <created-at type="datetime">2015-04-17T08:36:08-07:00</created-at> <updated-at type="datetime">2015-04-17T08:36:08-07:00</updated-at> <type>UploadRowError</type> <row type="integer">3</row> <first-column>Coupa Implementation</first-column> <field-with-error>parent_id</field-with-error> <value>1</value> <field-errors type="array"> <field-error>Parent unable to find matching parent.</field-error> </field-errors> <created-by> <id type="integer">81</id> <login>bknott</login> <email>brent.knott+bknott@coupa.com</email> <employee-number /> <firstname>Brent</firstname> <lastname>Knott</lastname> <salesforce-id nil="true" /> <company-code>100</company-code> <cost-center>10000</cost-center> <account-category>K</account-category> </created-by> <updated-by> <id type="integer">81</id> <login>bknott</login> <email>brent.knott+bknott@coupa.com</email> <employee-number /> <firstname>Brent</firstname> <lastname>Knott</lastname> <salesforce-id nil="true" /> <company-code>100</company-code> <cost-center>10000</cost-center> <account-category>K</account-category> </updated-by> </upload-error> </upload-errors> <created-by> <id type="integer">81</id> <login>bknott</login> <email>brent.knott+bknott@coupa.com</email> <employee-number /> <firstname>Brent</firstname> <lastname>Knott</lastname> <salesforce-id nil="true" /> <company-code>100</company-code> <cost-center>10000</cost-center> <account-category>K</account-category> </created-by> <updated-by> <id type="integer">81</id> <login>bknott</login> <email>brent.knott+bknott@coupa.com</email> <employee-number /> <firstname>Brent</firstname> <lastname>Knott</lastname> <salesforce-id nil="true" /> <company-code>100</company-code> <cost-center>10000</cost-center> <account-category>K</account-category> </updated-by> </data-file-source> <data-file-source> <id type="integer">1125</id> <created-at type="datetime">2015-04-17T12:59:44-07:00</created-at> <updated-at type="datetime">2015-04-17T12:59:45-07:00</updated-at> <type>DataFileSource</type> <source-for>Supplier</source-for> <status>sample</status> <file-file-name>remit_to_address_list.csv</file-file-name> <file-content-type>text/csv</file-content-type> <file-file-size>221</file-file-size> <result-text nil="true" /> <progress nil="true" /> <start-time nil="true" /> <end-time nil="true" /> <upload-errors type="array"> <upload-error> <id type="integer">926</id> <created-at type="datetime">2015-04-17T12:59:46-07:00</created-at> <updated-at type="datetime">2015-04-17T12:59:46-07:00</updated-at> <type>UploadHeaderError</type> <row nil="true" /> <first-column nil="true" /> <field-with-error nil="true" /> <value nil="true" /> <field-errors>Column header Active is not valid.</field-errors> <created-by> <id type="integer">1</id> <login>coupasupport</login> <email>rakesh.tatineni+01@coupa.com</email> <employee-number /> <firstname>Coupa</firstname> <lastname>Support</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </created-by> <updated-by> <id type="integer">1</id> <login>coupasupport</login> <email>rakesh.tatineni+01@coupa.com</email> <employee-number /> <firstname>Coupa</firstname> <lastname>Support</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </updated-by> </upload-error> </upload-errors> <created-by> <id type="integer">1</id> <login>coupasupport</login> <email>rakesh.tatineni+01@coupa.com</email> <employee-number /> <firstname>Coupa</firstname> <lastname>Support</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </created-by> <updated-by> <id type="integer">1</id> <login>coupasupport</login> <email>rakesh.tatineni+01@coupa.com</email> <employee-number /> <firstname>Coupa</firstname> <lastname>Support</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </updated-by> </data-file-source> <data-file-source> <id type="integer">1126</id> <created-at type="datetime">2015-04-17T13:00:05-07:00</created-at> <updated-at type="datetime">2015-04-17T13:00:04-07:00</updated-at> <type>DataFileSource</type> <source-for>Supplier</source-for> <status>sample</status> <file-file-name>remit_to_address_list.csv</file-file-name> <file-content-type>text/csv</file-content-type> <file-file-size>210</file-file-size> <result-text nil="true" /> <progress nil="true" /> <start-time nil="true" /> <end-time nil="true" /> <upload-errors type="array"> <upload-error> <id type="integer">927</id> <created-at type="datetime">2015-04-17T13:00:04-07:00</created-at> <updated-at type="datetime">2015-04-17T13:00:04-07:00</updated-at> <type>UploadHeaderError</type> <row nil="true" /> <first-column nil="true" /> <field-with-error nil="true" /> <value nil="true" /> <field-errors>Column header Line1* is not valid.</field-errors> <created-by> <id type="integer">1</id> <login>coupasupport</login> <email>rakesh.tatineni+01@coupa.com</email> <employee-number /> <firstname>Coupa</firstname> <lastname>Support</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </created-by> <updated-by> <id type="integer">1</id> <login>coupasupport</login> <email>rakesh.tatineni+01@coupa.com</email> <employee-number /> <firstname>Coupa</firstname> <lastname>Support</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </updated-by> </upload-error> </upload-errors> <created-by> <id type="integer">1</id> <login>coupasupport</login> <email>rakesh.tatineni+01@coupa.com</email> <employee-number /> <firstname>Coupa</firstname> <lastname>Support</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </created-by> <updated-by> <id type="integer">1</id> <login>coupasupport</login> <email>rakesh.tatineni+01@coupa.com</email> <employee-number /> <firstname>Coupa</firstname> <lastname>Support</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </updated-by> </data-file-source> </data-file-sources>
DataFileSourcesクエリの例-特定のオブジェクトのクエリ
この例では、Coupaで処理中のファイルにエラーがないか確認できるように、2014年12月15日のすべての受信ルックアップ値をクエリしています。以下に示すように、これはマルチステージクエリです。
https://<instance>.coupahost.com/api/data_file_sources?created_at[gt]='<day> 00:00:00'&created_at[lt]='<day> 23:59:59'&source_for=<object>
https://<instance>.coupahost.com/api/data_file_sources?created_at[gt]='2014-12-15 00:00:00'&created_at[lt]='2014-12-15 23:59:59'&source_for=LookupValue
このクエリは3つの部分に分かれています。最初の1つは、15日のUTC午前0時以降に作成されたデータファイルソースのみに制限し、2番目は、16日の午前0時より前に作成されたデータファイルソースの制限を設定します。最後のセクションは、私たちが探しているオブジェクト、この場合はLookupValueを定義します。
12/15/14にインバウンドするLookupValuesのサンプル応答
<?xml version="1.0" encoding="UTF-8"?> <data-file-sources type="array"> <data-file-source> <id type="integer">1332</id> <created-at type="datetime">2014-12-15T08:47:54-08:00</created-at> <updated-at type="datetime">2014-12-15T08:48:53-08:00</updated-at> <type>DataFileSource</type> <source-for>LookupValue</source-for> <status>done</status> <file-file-name>_Incoming_LookupValues_Knott_LookupValues.csv</file-file-name> <file-content-type>text/csv</file-content-type> <file-file-size>282</file-file-size> <result-text>0 rows processed, creating 0 new rows and updating 0 rows.</result-text> <progress type="integer">0</progress> <start-time type="datetime">2014-12-15T08:48:07-08:00</start-time> <end-time type="datetime">2014-12-15T08:48:53-08:00</end-time> <upload-errors type="array"> <upload-error> <id type="integer">964</id> <created-at type="datetime">2014-12-15T08:48:10-08:00</created-at> <updated-at type="datetime">2014-12-15T08:48:10-08:00</updated-at> <type>UploadRowError</type> <row type="integer">1</row> <first-column>TESTUS1</first-column> <field-with-error nil="true" /> <value nil="true" /> <field-errors type="array"> <field-error>Row corrupt or invalid.</field-error> </field-errors> <created-by> <id type="integer">93</id> <login>sftp_integration@coupa.com</login> <email>sftp_integration@coupa.com</email> <employee-number nil="true" /> <firstname>sFTP</firstname> <lastname>Integration</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </created-by> <updated-by> <id type="integer">93</id> <login>sftp_integration@coupa.com</login> <email>sftp_integration@coupa.com</email> <employee-number nil="true" /> <firstname>sFTP</firstname> <lastname>Integration</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </updated-by> </upload-error> <upload-error> <id type="integer">965</id> <created-at type="datetime">2014-12-15T08:48:13-08:00</created-at> <updated-at type="datetime">2014-12-15T08:48:13-08:00</updated-at> <type>UploadRowError</type> <row type="integer">2</row> <first-column>TESTEMEA1</first-column> <field-with-error nil="true" /> <value nil="true" /> <field-errors type="array"> <field-error>Row corrupt or invalid.</field-error> </field-errors> <created-by> <id type="integer">93</id> <login>sftp_integration@coupa.com</login> <email>sftp_integration@coupa.com</email> <employee-number nil="true" /> <firstname>sFTP</firstname> <lastname>Integration</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </created-by> <updated-by> <id type="integer">93</id> <login>sftp_integration@coupa.com</login> <email>sftp_integration@coupa.com</email> <employee-number nil="true" /> <firstname>sFTP</firstname> <lastname>Integration</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </updated-by> </upload-error> <upload-error> <id type="integer">966</id> <created-at type="datetime">2014-12-15T08:48:13-08:00</created-at> <updated-at type="datetime">2014-12-15T08:48:13-08:00</updated-at> <type>UploadRowError</type> <row type="integer">3</row> <first-column>TESTSales1</first-column> <field-with-error nil="true" /> <value nil="true" /> <field-errors type="array"> <field-error>Row corrupt or invalid.</field-error> </field-errors> <created-by> <id type="integer">93</id> <login>sftp_integration@coupa.com</login> <email>sftp_integration@coupa.com</email> <employee-number nil="true" /> <firstname>sFTP</firstname> <lastname>Integration</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </created-by> <updated-by> <id type="integer">93</id> <login>sftp_integration@coupa.com</login> <email>sftp_integration@coupa.com</email> <employee-number nil="true" /> <firstname>sFTP</firstname> <lastname>Integration</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </updated-by> </upload-error> </upload-errors> <created-by> <id type="integer">93</id> <login>sftp_integration@coupa.com</login> <email>sftp_integration@coupa.com</email> <employee-number nil="true" /> <firstname>sFTP</firstname> <lastname>Integration</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </created-by> <updated-by> <id type="integer">93</id> <login>sftp_integration@coupa.com</login> <email>sftp_integration@coupa.com</email> <employee-number nil="true" /> <firstname>sFTP</firstname> <lastname>Integration</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </updated-by> </data-file-source> <data-file-source> <id type="integer">1333</id> <created-at type="datetime">2014-12-15T08:55:19-08:00</created-at> <updated-at type="datetime">2014-12-15T08:55:53-08:00</updated-at> <type>DataFileSource</type> <source-for>LookupValue</source-for> <status>done</status> <file-file-name>_Incoming_LookupValues_Knott_LookupValues.csv</file-file-name> <file-content-type>text/csv</file-content-type> <file-file-size>279</file-file-size> <result-text>0 rows processed, creating 0 new rows and updating 0 rows.</result-text> <progress type="integer">0</progress> <start-time type="datetime">2014-12-15T08:55:27-08:00</start-time> <end-time type="datetime">2014-12-15T08:55:53-08:00</end-time> <upload-errors type="array"> <upload-error> <id type="integer">967</id> <created-at type="datetime">2014-12-15T08:55:29-08:00</created-at> <updated-at type="datetime">2014-12-15T08:55:29-08:00</updated-at> <type>UploadRowError</type> <row type="integer">1</row> <first-column>TESTUS</first-column> <field-with-error nil="true" /> <value nil="true" /> <field-errors type="array"> <field-error>Row corrupt or invalid.</field-error> </field-errors> <created-by> <id type="integer">93</id> <login>sftp_integration@coupa.com</login> <email>sftp_integration@coupa.com</email> <employee-number nil="true" /> <firstname>sFTP</firstname> <lastname>Integration</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </created-by> <updated-by> <id type="integer">93</id> <login>sftp_integration@coupa.com</login> <email>sftp_integration@coupa.com</email> <employee-number nil="true" /> <firstname>sFTP</firstname> <lastname>Integration</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </updated-by> </upload-error> <upload-error> <id type="integer">968</id> <created-at type="datetime">2014-12-15T08:55:29-08:00</created-at> <updated-at type="datetime">2014-12-15T08:55:29-08:00</updated-at> <type>UploadRowError</type> <row type="integer">2</row> <first-column>TESTEMEA</first-column> <field-with-error nil="true" /> <value nil="true" /> <field-errors type="array"> <field-error>Row corrupt or invalid.</field-error> </field-errors> <created-by> <id type="integer">93</id> <login>sftp_integration@coupa.com</login> <email>sftp_integration@coupa.com</email> <employee-number nil="true" /> <firstname>sFTP</firstname> <lastname>Integration</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </created-by> <updated-by> <id type="integer">93</id> <login>sftp_integration@coupa.com</login> <email>sftp_integration@coupa.com</email> <employee-number nil="true" /> <firstname>sFTP</firstname> <lastname>Integration</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </updated-by> </upload-error> <upload-error> <id type="integer">969</id> <created-at type="datetime">2014-12-15T08:55:29-08:00</created-at> <updated-at type="datetime">2014-12-15T08:55:29-08:00</updated-at> <type>UploadRowError</type> <row type="integer">3</row> <first-column>TESTSales</first-column> <field-with-error nil="true" /> <value nil="true" /> <field-errors type="array"> <field-error>Row corrupt or invalid.</field-error> </field-errors> <created-by> <id type="integer">93</id> <login>sftp_integration@coupa.com</login> <email>sftp_integration@coupa.com</email> <employee-number nil="true" /> <firstname>sFTP</firstname> <lastname>Integration</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </created-by> <updated-by> <id type="integer">93</id> <login>sftp_integration@coupa.com</login> <email>sftp_integration@coupa.com</email> <employee-number nil="true" /> <firstname>sFTP</firstname> <lastname>Integration</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </updated-by> </upload-error> </upload-errors> <created-by> <id type="integer">93</id> <login>sftp_integration@coupa.com</login> <email>sftp_integration@coupa.com</email> <employee-number nil="true" /> <firstname>sFTP</firstname> <lastname>Integration</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </created-by> <updated-by> <id type="integer">93</id> <login>sftp_integration@coupa.com</login> <email>sftp_integration@coupa.com</email> <employee-number nil="true" /> <firstname>sFTP</firstname> <lastname>Integration</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </updated-by> </data-file-source> <data-file-source> <id type="integer">1334</id> <created-at type="datetime">2014-12-15T09:13:17-08:00</created-at> <updated-at type="datetime">2014-12-15T09:13:55-08:00</updated-at> <type>DataFileSource</type> <source-for>LookupValue</source-for> <status>done</status> <file-file-name>_Incoming_LookupValues_Knott_LookupValues.csv</file-file-name> <file-content-type>text/csv</file-content-type> <file-file-size>258</file-file-size> <result-text>0 rows processed, creating 0 new rows and updating 0 rows.</result-text> <progress type="integer">0</progress> <start-time type="datetime">2014-12-15T09:13:27-08:00</start-time> <end-time type="datetime">2014-12-15T09:13:55-08:00</end-time> <upload-errors type="array"> <upload-error> <id type="integer">970</id> <created-at type="datetime">2014-12-15T09:13:30-08:00</created-at> <updated-at type="datetime">2014-12-15T09:13:30-08:00</updated-at> <type>UploadRowError</type> <row type="integer">1</row> <first-column>TESTUS</first-column> <field-with-error nil="true" /> <value nil="true" /> <field-errors type="array"> <field-error>Row corrupt or invalid.</field-error> </field-errors> <created-by> <id type="integer">93</id> <login>sftp_integration@coupa.com</login> <email>sftp_integration@coupa.com</email> <employee-number nil="true" /> <firstname>sFTP</firstname> <lastname>Integration</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </created-by> <updated-by> <id type="integer">93</id> <login>sftp_integration@coupa.com</login> <email>sftp_integration@coupa.com</email> <employee-number nil="true" /> <firstname>sFTP</firstname> <lastname>Integration</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </updated-by> </upload-error> <upload-error> <id type="integer">971</id> <created-at type="datetime">2014-12-15T09:13:30-08:00</created-at> <updated-at type="datetime">2014-12-15T09:13:30-08:00</updated-at> <type>UploadRowError</type> <row type="integer">2</row> <first-column>TESTEMEA</first-column> <field-with-error nil="true" /> <value nil="true" /> <field-errors type="array"> <field-error>Row corrupt or invalid.</field-error> </field-errors> <created-by> <id type="integer">93</id> <login>sftp_integration@coupa.com</login> <email>sftp_integration@coupa.com</email> <employee-number nil="true" /> <firstname>sFTP</firstname> <lastname>Integration</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </created-by> <updated-by> <id type="integer">93</id> <login>sftp_integration@coupa.com</login> <email>sftp_integration@coupa.com</email> <employee-number nil="true" /> <firstname>sFTP</firstname> <lastname>Integration</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </updated-by> </upload-error> <upload-error> <id type="integer">972</id> <created-at type="datetime">2014-12-15T09:13:31-08:00</created-at> <updated-at type="datetime">2014-12-15T09:13:31-08:00</updated-at> <type>UploadRowError</type> <row type="integer">3</row> <first-column>TESTSales</first-column> <field-with-error nil="true" /> <value nil="true" /> <field-errors type="array"> <field-error>Row corrupt or invalid.</field-error> </field-errors> <created-by> <id type="integer">93</id> <login>sftp_integration@coupa.com</login> <email>sftp_integration@coupa.com</email> <employee-number nil="true" /> <firstname>sFTP</firstname> <lastname>Integration</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </created-by> <updated-by> <id type="integer">93</id> <login>sftp_integration@coupa.com</login> <email>sftp_integration@coupa.com</email> <employee-number nil="true" /> <firstname>sFTP</firstname> <lastname>Integration</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </updated-by> </upload-error> </upload-errors> <created-by> <id type="integer">93</id> <login>sftp_integration@coupa.com</login> <email>sftp_integration@coupa.com</email> <employee-number nil="true" /> <firstname>sFTP</firstname> <lastname>Integration</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </created-by> <updated-by> <id type="integer">93</id> <login>sftp_integration@coupa.com</login> <email>sftp_integration@coupa.com</email> <employee-number nil="true" /> <firstname>sFTP</firstname> <lastname>Integration</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </updated-by> </data-file-source> <data-file-source> <id type="integer">1335</id> <created-at type="datetime">2014-12-15T09:22:15-08:00</created-at> <updated-at type="datetime">2014-12-15T09:22:32-08:00</updated-at> <type>BackgroundCsvFileLoad</type> <source-for>LookupValue</source-for> <status>done</status> <file-file-name>_Incoming_LookupValues_Knott_LookupValues.csv</file-file-name> <file-content-type /> <file-file-size>282</file-file-size> <result-text>3 rows processed, creating 0 new rows and updating 3 rows.</result-text> <progress type="integer">3</progress> <start-time type="datetime">2014-12-15T09:22:24-08:00</start-time> <end-time type="datetime">2014-12-15T09:22:32-08:00</end-time> <upload-errors type="array" /> <created-by> <id type="integer">93</id> <login>sftp_integration@coupa.com</login> <email>sftp_integration@coupa.com</email> <employee-number nil="true" /> <firstname>sFTP</firstname> <lastname>Integration</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </created-by> <updated-by> <id type="integer">93</id> <login>sftp_integration@coupa.com</login> <email>sftp_integration@coupa.com</email> <employee-number nil="true" /> <firstname>sFTP</firstname> <lastname>Integration</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </updated-by> </data-file-source> <data-file-source> <id type="integer">1336</id> <created-at type="datetime">2014-12-15T09:28:19-08:00</created-at> <updated-at type="datetime">2014-12-15T09:28:32-08:00</updated-at> <type>BackgroundCsvFileLoad</type> <source-for>LookupValue</source-for> <status>done</status> <file-file-name>_Incoming_LookupValues_Knott_LookupValues.csv</file-file-name> <file-content-type /> <file-file-size>282</file-file-size> <result-text>3 rows processed, creating 0 new rows and updating 3 rows.</result-text> <progress type="integer">3</progress> <start-time type="datetime">2014-12-15T09:28:29-08:00</start-time> <end-time type="datetime">2014-12-15T09:28:32-08:00</end-time> <upload-errors type="array" /> <created-by> <id type="integer">93</id> <login>sftp_integration@coupa.com</login> <email>sftp_integration@coupa.com</email> <employee-number nil="true" /> <firstname>sFTP</firstname> <lastname>Integration</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </created-by> <updated-by> <id type="integer">93</id> <login>sftp_integration@coupa.com</login> <email>sftp_integration@coupa.com</email> <employee-number nil="true" /> <firstname>sFTP</firstname> <lastname>Integration</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </updated-by> </data-file-source> <data-file-source> <id type="integer">1337</id> <created-at type="datetime">2014-12-15T09:34:24-08:00</created-at> <updated-at type="datetime">2014-12-15T09:35:00-08:00</updated-at> <type>BackgroundCsvFileLoad</type> <source-for>LookupValue</source-for> <status>done</status> <file-file-name>_Incoming_LookupValues_Knott_LookupValues.csv</file-file-name> <file-content-type /> <file-file-size>332</file-file-size> <result-text>4 rows processed, creating 0 new rows and updating 3 rows.</result-text> <progress type="integer">4</progress> <start-time type="datetime">2014-12-15T09:34:32-08:00</start-time> <end-time type="datetime">2014-12-15T09:35:00-08:00</end-time> <upload-errors type="array"> <upload-error> <id type="integer">973</id> <created-at type="datetime">2014-12-15T09:34:35-08:00</created-at> <updated-at type="datetime">2014-12-15T09:34:35-08:00</updated-at> <type>UploadRowError</type> <row type="integer">2</row> <first-column>0200</first-column> <field-with-error>name</field-with-error> <value>TESTUS1</value> <field-errors type="array"> <field-error>Name has already been taken</field-error> </field-errors> <created-by> <id type="integer">93</id> <login>sftp_integration@coupa.com</login> <email>sftp_integration@coupa.com</email> <employee-number nil="true" /> <firstname>sFTP</firstname> <lastname>Integration</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </created-by> <updated-by> <id type="integer">93</id> <login>sftp_integration@coupa.com</login> <email>sftp_integration@coupa.com</email> <employee-number nil="true" /> <firstname>sFTP</firstname> <lastname>Integration</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </updated-by> </upload-error> </upload-errors> <created-by> <id type="integer">93</id> <login>sftp_integration@coupa.com</login> <email>sftp_integration@coupa.com</email> <employee-number nil="true" /> <firstname>sFTP</firstname> <lastname>Integration</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </created-by> <updated-by> <id type="integer">93</id> <login>sftp_integration@coupa.com</login> <email>sftp_integration@coupa.com</email> <employee-number nil="true" /> <firstname>sFTP</firstname> <lastname>Integration</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </updated-by> </data-file-source> <data-file-source> <id type="integer">1338</id> <created-at type="datetime">2014-12-15T10:40:57-08:00</created-at> <updated-at type="datetime">2014-12-15T10:41:33-08:00</updated-at> <type>BackgroundCsvFileLoad</type> <source-for>LookupValue</source-for> <status>done</status> <file-file-name>_Incoming_LookupValues_Knott_LookupValues.csv</file-file-name> <file-content-type /> <file-file-size>332</file-file-size> <result-text>4 rows processed, creating 0 new rows and updating 3 rows.</result-text> <progress type="integer">4</progress> <start-time type="datetime">2014-12-15T10:41:06-08:00</start-time> <end-time type="datetime">2014-12-15T10:41:33-08:00</end-time> <upload-errors type="array"> <upload-error> <id type="integer">974</id> <created-at type="datetime">2014-12-15T10:41:11-08:00</created-at> <updated-at type="datetime">2014-12-15T10:41:11-08:00</updated-at> <type>UploadRowError</type> <row type="integer">2</row> <first-column>0200</first-column> <field-with-error>name</field-with-error> <value>TESTUS1</value> <field-errors type="array"> <field-error>Name has already been taken</field-error> </field-errors> <created-by> <id type="integer">93</id> <login>sftp_integration@coupa.com</login> <email>sftp_integration@coupa.com</email> <employee-number nil="true" /> <firstname>sFTP</firstname> <lastname>Integration</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </created-by> <updated-by> <id type="integer">93</id> <login>sftp_integration@coupa.com</login> <email>sftp_integration@coupa.com</email> <employee-number nil="true" /> <firstname>sFTP</firstname> <lastname>Integration</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </updated-by> </upload-error> </upload-errors> <created-by> <id type="integer">93</id> <login>sftp_integration@coupa.com</login> <email>sftp_integration@coupa.com</email> <employee-number nil="true" /> <firstname>sFTP</firstname> <lastname>Integration</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </created-by> <updated-by> <id type="integer">93</id> <login>sftp_integration@coupa.com</login> <email>sftp_integration@coupa.com</email> <employee-number nil="true" /> <firstname>sFTP</firstname> <lastname>Integration</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </updated-by> </data-file-source> </data-file-sources>
DataFileSourcesクエリの例-クエリ固有のDataFileSource
この例では、datafilesource#1338を照会しています。これは、このオブジェクトに対して自動的に生成された内部Coupa IDであり、このレコードの主要な識別方法です。
このレコードをクエリするには2つの方法があります:
- 形式1:
https://<instance>.coupahost.com/api/data_file_sources/<id>
https://<instance>.coupahost.com/api/data_file_sources/1338
このクエリの出力を以下に示します。
- フォーマット2:
https://<instance>.coupahost.com/api/data_file_sources?id=<id>
https://<instance>.coupahost.com/api/data_file_sources?id=1338
この形式では、応答が若干異なります。以下の出力全体(XMLバージョン情報を除く)は、?として <data-file-sources type="array"> </data-file-sources>タグでラップされます。
パラメータは複数のレコードを返すことができますが、IDを明示的に指定すると1つだけを返すことができます
サンプルDataSource GET応答
<?xml version="1.0" encoding="UTF-8"?> <data-file-source> <id type="integer">1338</id> <created-at type="datetime">2014-12-15T10:40:57-08:00</created-at> <updated-at type="datetime">2014-12-15T10:41:33-08:00</updated-at> <type>BackgroundCsvFileLoad</type> <source-for>LookupValue</source-for> <status>done</status> <file-file-name>_Incoming_LookupValues_Knott_LookupValues.csv</file-file-name> <file-content-type /> <file-file-size>332</file-file-size> <result-text>4 rows processed, creating 0 new rows and updating 3 rows.</result-text> <progress type="integer">4</progress> <start-time type="datetime">2014-12-15T10:41:06-08:00</start-time> <end-time type="datetime">2014-12-15T10:41:33-08:00</end-time> <upload-errors type="array"> <upload-error> <id type="integer">974</id> <created-at type="datetime">2014-12-15T10:41:11-08:00</created-at> <updated-at type="datetime">2014-12-15T10:41:11-08:00</updated-at> <type>UploadRowError</type> <row type="integer">2</row> <first-column>0200</first-column> <field-with-error>name</field-with-error> <value>TESTUS1</value> <field-errors type="array"> <field-error>Name has already been taken</field-error> </field-errors> <created-by> <id type="integer">93</id> <login>sftp_integration@coupa.com</login> <email>sftp_integration@coupa.com</email> <employee-number nil="true" /> <firstname>sFTP</firstname> <lastname>Integration</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </created-by> <updated-by> <id type="integer">93</id> <login>sftp_integration@coupa.com</login> <email>sftp_integration@coupa.com</email> <employee-number nil="true" /> <firstname>sFTP</firstname> <lastname>Integration</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </updated-by> </upload-error> </upload-errors> <created-by> <id type="integer">93</id> <login>sftp_integration@coupa.com</login> <email>sftp_integration@coupa.com</email> <employee-number nil="true" /> <firstname>sFTP</firstname> <lastname>Integration</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </created-by> <updated-by> <id type="integer">93</id> <login>sftp_integration@coupa.com</login> <email>sftp_integration@coupa.com</email> <employee-number nil="true" /> <firstname>sFTP</firstname> <lastname>Integration</lastname> <salesforce-id nil="true" /> <company-code /> <cost-center /> <account-category /> </updated-by> </data-file-source>
DataFileSourcesクエリ例-クエリ固有ファイル
この例では、lookup_list.csvという名前のファイル用に作成されたdatafilesourceを照会しています。
このレコードをクエリするには2つの方法があります:
- 形式1:
https://<instance>.coupahost.com/api/data_file_sources?file_file_name=filename
https://<instance>.coupahost.com/api/data_file_sources?file_file_name=lookup_list.csv
このクエリの出力を以下に示します。
サンプルDataSource GET応答
<?xml version="1.0" encoding="UTF-8"?> <data-file-sources type="array"> <data-file-source> <id type="integer">990</id> <created-at type="datetime">2015-07-09T16:32:42-07:00</created-at> <updated-at type="datetime">2015-07-09T16:34:19-07:00</updated-at> <type>DataFileSource</type> <source-for>Lookup</source-for> <status>done</status> <file-file-name>lookup_list.csv</file-file-name> <file-content-type>text/csv</file-content-type> <file-file-size>170</file-file-size> <result-text>0 rows processed, creating 0 new rows and updating 0 rows.</result-text> <progress nil="true" /> <start-time type="datetime">2015-07-09T16:34:05-07:00</start-time> <end-time type="datetime">2015-07-09T16:34:19-07:00</end-time> <upload-errors type="array" /> <created-by> <id type="integer">85</id> <login>staging@coupa.com</login> <email>staging@coupa.com</email> <employee-number nil="true" /> <firstname>John</firstname> <lastname>Doe</lastname> </created-by> <updated-by> <id type="integer">85</id> <login>staging@coupa.com</login> <email>staging@coupa.com</email> <employee-number nil="true" /> <firstname>John</firstname> <lastname>Doe</lastname> </updated-by> </data-file-source> </data-file-sources>