Zapier で Zuora 連携の自動ワークフローを構築

Jerod Johnson
Senior Technology Evangelist

CData Connect AI を使用してリアルタイムのZuora のデータに接続し、Zapier で自動ワークフローを構築する方法を解説します。

Zapier は、アプリとサービスを連携させるオンライン自動化ツールです。CData Connect AI と組み合わせることで、ワークフローでリアルタイムのZuora のデータにアクセスできます。この記事では、Zuora に接続し、Zapier でリアルタイムのZuora のデータを使ったワークフローを構築する方法をご紹介します。

Zapier から Zuora に接続

Zapier で Zuora を使用するには、Connect AI から Zuora に接続し、接続へのユーザーアクセスを提供し、Zuora のデータ用のワークスペースを作成する必要があります。

Connect AI から Zuora に接続

CData Connect AI は、シンプルなポイント＆クリックのインターフェースでデータソースに接続できます。

Connect AI にログインして「Sources」をクリック、次に「 Add Connection」をクリック

接続を追加パネルから「Zuora」を選択

Zuora に接続するために必要な認証プロパティを入力します。
Zuora はユーザー認証にOAuth 標準を使用しています。OAuth 認証ついて詳しくは、オンラインヘルプドキュメントを参照してください。

Tenant プロパティの設定
プロバイダへの有効な接続を作成するには、アカウントの設定と合致するテナント値を1つ選択する必要があります。以下は、利用可能なオプションのリストです。
- USProduction：リクエストはhttps://rest.zuora.com に送信されます。
- USAPISandbox：リクエストはhttps://rest.apisandbox.zuora.com に送信されます。
- USPerformanceTest：リクエストはhttps://rest.pt1.zuora.com に送信されます。
- EUProduction：リクエストはhttps://rest.eu.zuora.com に送信されます。
- EUSandbox：リクエストはhttps://rest.sandbox.eu.zuora.com に送信されます。
デフォルトではUSProduction テナントを使用します。
Zuora サービスの選択
データクエリとAQuA API の2つのZuora サービスを使用します。デフォルトでは、ZuoraService はAQuADataExport に設定されています。
DataQuery
データクエリ機能は、非同期の読み取り専用SQL クエリを実行することで、Zuora テナントからのデータのエクスポートを実現します。このサービスは、素早く軽量なSQL クエリでの使用を推奨します。
制限
- フィルタ適用後の、テーブルごとの入力レコードの最大数： 1,000,000
- 出力レコードの最大数： 100,000
- テナントごとの、実行用に送信される同時クエリの最大数： 5
- テナントごとの、同時クエリの制限に達した後に実行用に送信され、キューに追加されるクエリの最大数： 10
- 1時間単位での、各クエリの最大処理時間： 1
- GB 単位での、各クエリに割り当てられるメモリの最大サイズ： 2
- Index Join を使用する際のインデックスの最大値。言い換えれば、Index Join を使用する際にWHERE 句で使われる一意の値に基づいた、左のテーブルから返されるレコードの最大数： 20.000
AQuADataExport
AQuA API のエクスポートは、すべてのオブジェクト（テーブル）のすべてのレコードをエクスポートするように設計されています。AQuA のクエリジョブには以下の制限があります。
制限
- AQuA のジョブ内のクエリが8時間以上実行されている場合、ジョブは自動的に停止されます。
- 停止されたAQuA のジョブは3回再試行可能で、その後失敗として返されます。
「Save & Test」をクリック
Zuora 接続の追加ページで「Permissions」タブに移動し、ユーザーベースの権限を更新します。

パーソナルアクセストークンを追加

REST API、OData API、または仮想 SQL Server を通じて Connect AI に接続する場合は、パーソナルアクセストークン（PAT）を使用して認証を行います。アクセス管理を細かく制御するため、サービスごとに個別の PAT を作成することをお勧めします。

Connect AI アプリの右上にある歯車アイコン（）をクリックして設定ページを開きます。
設定ページで「Access Tokens」セクションに移動し、「 Create PAT」をクリックします。
PAT に名前を付けて「Create」をクリックします。
パーソナルアクセストークンは作成時にのみ表示されます。必ずコピーして、今後の利用のために安全に保管してください。

Zapier 向けに Zuora エンドポイントを設定

Zuora への接続が完了したら、使用したいテーブル用のワークスペースを作成します。

「Workspaces」ページに移動し、「 Add」をクリックして新しいワークスペースを作成します（または既存のワークスペースを選択）。
「 Add」をクリックして、ワークスペースに新しいアセットを追加します。
Zuora 接続（例: Zuora1）を選択し、「Next」をクリックします。
使用したいテーブルを選択し、「Confirm」をクリックします。
ワークスペースの OData Service URL をメモしておきます（例: https://cloud.cdata.com/api/odata/{workspace_name}）

接続、PAT、ワークスペースの設定が完了したら、Zapier からZuora のデータに接続する準備は完了です。

Zapier ワークフローで Zuora に接続

Zapier から CData Connect AI への OData プロトコル経由での接続を確立するには、以下の手順に従います。

Zapier にログインします。
Create Zap をクリックします。
表示されるダイアログで「Webhooks by Zapier」を検索し、下に表示されるオプションをクリックします。
Event で Retrieve Poll を選択します。
接続の詳細を入力します。
- URL: OData URL を入力（例: https://cloud.cdata.com/api/odata/{workspace_name}）
- Key: 「value.name」と入力
- Authentication details: Basic Auth または Headers を入力します。Basic オプションでは、ユーザー（Connect AI のユーザー名、例: [email protected]）とパスワード（先ほど作成した PAT）をパイプ記号 | で区切って指定します。Headers オプションでは、エンコードされた認証情報を含むリクエストタイプヘッダーを指定します。
Test をクリックします。接続が正しく設定されていれば、サンプルレコードが表示されます。