Web 帳票ツール PrintStream でZuora データを利用した帳票を作成

こんにちは！ドライバー周りのヘルプドキュメントを担当している古川です。

PrintStream は株式会社オープンストリームが提供するWeb システムでの帳票印刷、PDF 生成機能を強力にサポートする帳票ツールです。

この記事では、PrintStream と CData ODBC ドライバを使って、PrintStream でZuora のデータを利用した帳票を作成する方法を紹介します。

CData ODBC ドライバとは？

CData ODBC ドライバは、以下のような特徴を持ったリアルタイムデータ連携ソリューションです。

1. Zuora をはじめとする、CRM、MA、会計ツールなど多様なカテゴリの270種類以上のSaaS / オンプレミスデータソースに対応
2. 多様なアプリケーション、ツールにZuora データを連携
3. ノーコードでの手軽な接続設定
4. 標準 SQL での柔軟なデータ読み込み・書き込み

CData ODBC ドライバでは、1.データソースとしてZuora の接続を設定、2.PrintStream 側でODBC Driver との接続を設定、という2つのステップだけでデータソースに接続できます。以下に具体的な設定手順を説明します。

CData ODBC ドライバのインストールとZuora への接続設定

まずは、本記事右側のサイドバーからZuora ODBC Driver の無償トライアルをダウンロード・インストールしてください。30日間無償で、製品版の全機能が使用できます。

1. ODBC DSN に必要な接続プロパティの値を入力します。 組み込みのMicrosoft ODBC データソースアドミニストレーターを使用してDSN を構成できます。 これは、ドライバーのインストール時の最後のステップでも可能です。 Microsoft ODBC データソースアドミニストレータを使用してDSN を作成および設定する方法については、ヘルプドキュメントの「はじめに」の章を参照してください。
   
   

   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回再試行可能で、その後失敗として返されます。
2. 入力後、接続テストが成功すれば設定は完了です。

PrintStream で帳票をデザインする

それでは PrintStream 側の作業を進めていきます。

1. 今回はシンプルに以下のようなZuora のデータを一覧表示する帳票を作成します。
2. 以下のようにリージョンを配置して、中にレコードとテキストフィールドを配置します。最終的にテキストフィールドにZuora のデータをそれぞれマッピングするイメージです。
3. 詳しい手順は割愛しますが、ヘルプの「PrintStream」チュートリアルにある「一覧表作成」を参考にしてみてください。

PrintStream でODBC 接続を行う

デザインが完了したらODBC 経由でデータを読み込みます。

1. 「印刷データウィザード」を使ってODBC 接続経由でZuora のデータを読み込みます。
2. データの取得方法から「ODBC データベース」を選択し、「次へ」をクリック
3. データベースの「参照」をクリックし
4. 「コンピューターデータソース」の一覧から先ほど設定したODBC DSN を選択します。
5. データベースの設定が完了したら、データの検索方法から「テーブルまたはビューを選択」もしくは「SQL を記述」を選択します。今回は「テーブルまたはビューを選択」を使ってみます。
6. 「テーブルまたはビューを選択」では、最初に任意のテーブルまたはビューを選択します。ここでデータサンプルも表示されるので、Zuora のデータを確認しながら選ぶことができます。
7. 続いて絞り込み条件を指定します。任意の条件を指定してください。
8. 併せてソート条件も指定しましょう。
9. 最後に帳票デザインに配置した印刷フィールドと読み込んだデータ項目をマッピングします。

印刷プレビュー

印刷プレビューで実際に帳票へデータが取り込めているか確認してみましょう。

1. 下図のアイコンもしくは「F5」を押下することでプレビューが実施できます。
2. 以下のようにODBC 経由で取り込んでいるデータが表示されればOK です。

Zuora からPrintStream へのデータ連携には、ぜひCData ODBC ドライバをご利用ください

このようにCData ODBC Driver for Zuora とPrintStream を組み合わせることで、簡単にZuora データを活用した連携を実現できます。ぜひ、30日の無償評価版 をお試しください。

CData ODBC ドライバは日本のユーザー向けに、UI の日本語化、ドキュメントの日本語化、日本語でのテクニカルサポートを提供しています。