製品をチェック

Zuora Driver の30日間無償トライアルをダウンロード

 ダウンロードはこちら

製品の詳細

Zuora アイコン Zuora JDBC Driver 相談したい

Zuora データを組み込んだパワフルなJava アプリケーションを短時間・低コストで作成して配布できます。

Crystal Reports でZuora データに連携して帳票を作成

レポートウィザードを使って、最新のZuora 連携データを使った帳票を作成。

加藤龍彦
ウェブデベロッパー

最終更新日:2022-06-11
zuora ロゴ

CData

jdbc ロゴ画像
SAP Crystal Reports ロゴ

こんにちは!ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。



Crystal Reports には、JDBC 標準向けのサポートが組み込まれています。この記事では、Zuora の機能を持つ帳票を作成するレポート作成ウィザードの使い方を説明します。

Zuora JDBC Driver のインストール

CData JDBC Driver for Zuora を、ドライバーのJAR をCrystal Reports のクラスパスに含めてインストール:DataDriverCommonElement の下のClassPath element のパスに、 .jar を含むファイルのフルパスを追加します。

CRConfig.xml は通常C:\Program Files (x86)\SAP BusinessObjects\SAP BusinessObjects Enterprise XI 4.0\java に配置されます。— パスはインストールによって若干異なる場合があります。ドライバーのJAR はインストールディレクトリの[lib]サブフォルダ内にあります。

ClassPath にJAR を追加したら、Crystal Reports を再起動します。

Zuora データに接続

下記の手順に従って、レポート作成ウィザードを使ってZuora 接続を作成します。

  1. 新しい空の帳票で、[Create New Connection]>[JDBC (JNDI)]をクリックします。
  2. ウィザードでJDBC 接続URL を選択します。

    jdbc:zuora:OAuthClientID=MyOAuthClientId;OAuthClientSecret=MyOAuthClientSecret;Tenant=USProduction;ZuoraService=DataQuery;
  3. ドライバーのクラス名を設定:

    cdata.jdbc.zuora.ZuoraDriver

    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 サービスを使用します。デフォルトでは、ZuoraServiceAQuADataExport に設定されています。

    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回再試行可能で、その後失敗として返されます。

帳票をデザイン

JDBC 接続をZuora に追加したら、レポート作成ウィザードを使ってZuora を帳票に追加できます。

  1. 帳票に必要なテーブルやフィールドを選択して、データソースを設定します。この例では、Invoices テーブルのId およびBillingCity カラムを使います。

    Zuora データ accessible as tables and columns in the Report Wizard. (Salesforce is shown.)
  2. チャートの種類を設定 ウィザードを完了すると、Crystal Reports はZuora データ に実行されるSQL クエリをビルドします。ドライバーは、ライブZuora データ に対してクエリを実行します。

    Chart type, axes, and summary type in the Report Wizard. (Salesforce is shown.)
  3. 必要に応じて、ほかのフィルタや帳票テンプレートを設定します。
  4. データのインポートが終わったら、データをサマライズもしくはソートするチャートやレポートオブジェクトを作成できます。[Insert]>[Chart]をクリックして、チャートエキスパートを開きます。Total BillingCity by Id を表すグラフを作成するには、Id を[On Change Of]メニューセレクションの下のボックスに追加してからBillingCity を[Show Values]の下のボックスに追加します。

    The x and y axes of the chart.

完成した帳票をプレビューして、チャートにデータが入っていることを確認します。Null 値を取り除きたい場合は、SelectionFormula を使います。

A chart with null values filtered out. (Salesforce is shown.)

関連コンテンツ

トライアル・お問い合わせ

30日間無償トライアルで、CData のリアルタイムデータ連携をフルにお試しいただけます。記事や製品についてのご質問があればお気軽にお問い合わせください。