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

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

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

TaxJar JDBC Driver のインストール

CData JDBC Driver for TaxJar を、ドライバーの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 を再起動します。

TaxJar のデータに接続

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

1. 新しい空の帳票で、［Create New Connection］>［JDBC (JNDI)］をクリックします。

2. ウィザードでJDBC 接続URL を選択します。

   jdbc:taxjar:APIKey=3bb04218ef8t80efdf1739abf7257144;

3. ドライバーのクラス名を設定：

   cdata.jdbc.taxjar.TaxJarDriver

   TaxJar API への認証には、まず初めにTaxJar UI からAPI キーを取得する必要があります。

   NOTE：API の利用は、Professional およびPremium TaxJar プランでのみ可能です。

   すでにProfessional またはPremium プランをお持ちの方は、TaxJar UI にログインして、「アカウント」->「TaxJar API」に移動するとAPI キーを確認することができます。 API キーを取得したら、APIKey 接続プロパティに設定できます。

   その他の注意事項

   • デフォルトでは、エンティティが日付範囲フィルタをサポートしている場合、CData コネクタは過去3か月のデータを取得します。StartDate を設定して、取得するデータの最小作成日を指定することができます。
   • API キーがサンドボックスAPI アカウント用に作成されている場合は、UseSandbox をtrue に設定してください。ただし、すべてのエンドポイントが期待どおりに機能するとは限りません。詳しくは、TaxJar 開発者用ドキュメントを参照してください。

帳票をデザイン

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

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

2. チャートの種類を設定 ウィザードを完了すると、Crystal Reports はTaxJar のデータ に実行されるSQL クエリをビルドします。ドライバーは、ライブTaxJar のデータ に対してクエリを実行します。

3. 必要に応じて、ほかのフィルタや帳票テンプレートを設定します。

4. データのインポートが終わったら、データをサマライズもしくはソートするチャートやレポートオブジェクトを作成できます。［Insert］>［Chart］をクリックして、チャートエキスパートを開きます。Total UserID by TransactionID を表すグラフを作成するには、TransactionID を［On Change Of］メニューセレクションの下のボックスに追加してからUserID を［Show Values］の下のボックスに追加します。

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