CData Excel Add-In for Zuora を使えば、Excel から直接Zuora への編集や保存が可能になります。この記事では、Excel から Zuora にデータを移行する方法を説明します。
Zuora のデータを一度Excel にエクスポートして編集・データソースの一括更新を行えるだけではなく、Excel スプレッドシートに保存されているデータを一括でZuora にインポートすることも可能です。
今回の記事では、Invoices テーブルを使います。同じことが、CData Excel Add-In で取得できるすべてのテーブルに対して実行可能です。
接続の確立
Zuora への接続には、Excel Add-in をインストールしたExcel の[CDATA]タブ→[Zuora]アイコンをクリックします。
Zuora uses the OAuth standard to authenticate users. See the online Help documentation for a full OAuth authentication guide.
Configuring Tenant property
In order to create a valid connection with the provider you need to choose one of the Tenant values (USProduction by default) which matches your account configuration. The following is a list with the available options:
- USProduction: Requests sent to https://rest.zuora.com.
- USAPISandbox: Requests sent to https://rest.apisandbox.zuora.com"
- USPerformanceTest: Requests sent to https://rest.pt1.zuora.com"
- EUProduction: Requests sent to https://rest.eu.zuora.com"
- EUSandbox: Requests sent to https://rest.sandbox.eu.zuora.com"
Selecting a Zuora Service
Two Zuora services are available: Data Query and AQuA API. By default ZuoraService is set to AQuADataExport.
DataQuery
The Data Query feature enables you to export data from your Zuora tenant by performing asynchronous, read-only SQL queries.
We recommend to use this service for quick lightweight SQL queries.
Limitations
- The maximum number of input records per table after filters have been applied: 1,000,000
- The maximum number of output records: 100,000
- The maximum number of simultaneous queries submitted for execution per tenant: 5
- The maximum number of queued queries submitted for execution after reaching the limitation of simultaneous queries per tenant: 10
- The maximum processing time for each query in hours: 1
- The maximum size of memory allocated to each query in GB: 2
- The maximum number of indices when using Index Join, in other words, the maximum number of records being returned by the left table based on the unique value used in the WHERE clause when using Index Join: 20,000
AQuADataExport
AQuA API export is designed to export all the records for all the objects ( tables ). AQuA query jobs have the following limitations:
Limitations
- If a query in an AQuA job is executed longer than 8 hours, this job will be killed automatically.
- The killed AQuA job can be retried three times before returned as failed.
Zuora データの取得
Zuora にデータを挿入するには、まず該当するZuora のテーブルを取得します。これによりExcel スプレッドシートとZuora のテーブルが連携した状態になります。取得したテーブルに対し変更、もしくは追加した部分は文字が赤でハイライトされます。
- CData リボンからZuora ボタンをクリックします。データ選択ウィザードが表示されます。
- テーブルもしくはビューメニューから、Invoices テーブルを選択します。
- [最大行数]に、取得したい最大行数を入力します。データの一括入力だけが目的の場合は1行だけを取得すれば十分です。リクエストどおりにクエリ欄にSQL クエリが表示されます。
- [シート名]に作成されるシートの名前を入力します。デフォルトでは、取得するテーブル名が新しいシート名になります。
Zuora へのデータの挿入
データ取得後、既存のExcel で保存されているデータを取得したテーブルの下に追加していきます。
- テーブルの最終行の下の行に、他のシートを参照する式を入力します。例:=MyInvoicesSheetInExcel!A1。
- Zuora に挿入するセルを参照する式を入力し、セルを取得する行数分ドラグダウンします。テーブルに参照された値が表示されます。
- 挿入する行を選択して、CDATA リボンの[行を挿入]ボタンをクリックします。
各行の挿入が完了すると、Id の値が表示され、追加した値の文字が赤から黒に変わります。