JasperReports Server で QuickBooks のレポートを作成

Jerod Johnson
Senior Technology Evangelist

CData JDBC Driver をJasperReports Server にデプロイして、レポートや組み込み分析などから QuickBooks データにリアルタイムでアクセスできます。

CData JDBC Driver for QuickBooks を使用すると、企業全体で QuickBooks のデータへのアクセスを提供できます。この記事では、JasperReports Server にドライバーをデプロイし、QuickBooks のデータのビジネスビューであるレポートドメインに基づいたシンプルなレポートを作成する方法を説明します。

QuickBooks データ連携について

CData は、QuickBooks のライブデータへのアクセスと統合を簡素化します。お客様は CData の接続機能を以下の目的で活用しています：

ローカルとリモートの両方の会社ファイルにアクセスできます。
エディションと地域を問わず接続できます：QuickBooks Premier、Professional、Enterprise、Simple Start エディション 2002+、およびカナダ、ニュージーランド、オーストラリア、英国エディション 2003+。
SQL ストアドプロシージャを使用して、取引の無効化やクリア、リストの統合、エンティティの検索などのアクションを実行できます。

お客様は、Power BI、Tableau、Excel などのお気に入りのツールと QuickBooks データを定期的に統合し、QuickBooks データをデータベースやデータウェアハウスに統合しています。

はじめに

ドライバー JAR のデプロイ

以下の手順に従って、JasperReports Server にドライバー JAR をデプロイします。この手順は QuickBooks と JasperReports Server にバンドルされている Tomcat サーバーに固有のものです。Tomcat ではなく JBoss AS 7 を使用している場合は、標準的なプロセスに従って JBoss への QuickBooks JDBC Driver のデプロイを行ってください。

インストールディレクトリの lib サブフォルダにあるドライバー JAR と .lic ファイルを、JasperReports Server インストールディレクトリ内の apache-tomcat フォルダの lib サブフォルダにコピーします。
apache-tomcat -> webapps -> jasperserver-pro -> META-INF に移動し、以下のリソースエントリを context.xml ファイルに追加します。
```
<Resource name="jdbc/quickbooks"   auth="Container" type="javax.sql.DataSource" driverClassName="cdata.jdbc.quickbooks.QuickBooksDriver"  url="jdbc:quickbooks:URL=http://remotehost:8166;User=admin;Password=admin123;" maxActive="20" maxIdle="10" maxWait="-1" factory="com.jaspersoft.jasperserver.tomcat.jndi.JSCommonsBasicDataSourceFactory"/>
```
JDBC URL（url 属性）に必要な接続プロパティを指定します。

ローカルQuickBooks インスタンスへの接続には接続プロパティ入力は不要です。

CData 製品は、リモートコネクタ経由でQuickBooks にリクエストを作成します。リモートコネクタはQuickBooks と同じマシン上で動作し、軽量の組み込みWeb サーバーを介して接続を受け入れます。サーバーはSSL/TLS をサポートし、ユーザーにリモートマシンからのセキュアな接続を可能にします。

初めて接続するときは、CData 製品をQuickBooks で認証する必要があります。詳しくは、ヘルプドキュメントの「Using the Remote Connector」を参照してください。

組み込みの接続文字列デザイナー

JDBC URL の構築には、QuickBooks JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行します。
```
java -jar cdata.jdbc.quickbooks.jar
```
接続プロパティを入力し、接続文字列をクリップボードにコピーします。

JDBC URL を設定する際に、Max Rows 接続プロパティを設定することもできます。これにより返される行数が制限され、レポートやビジュアライゼーションを設計する際のパフォーマンス向上に役立ちます。
jasperserver-pro -> WEB-INF に移動し、以下の参照を web.xml ファイルに追加します。
```
  QuickBooks のデータ JSP
  jdbc/quickbooks
  javax.sql.DataSource
  Container
```
サーバーを再起動します。

QuickBooks JDBC データソースの作成

以下の手順に従って、QuickBooks JDBC Driver を JDBC データソースにマッピングします。

JasperReports Server にログインし、Create -> Data Source をクリックします。
Type メニューで、JNDI Data Source を選択します。
Service Name ボックスに、web.xml ファイルのリソース定義で指定した JNDI ルックアップを入力します。この例では、ルックアップは「jdbc/quickbooks」です。
Save をクリックしてデータソースを作成します。

ドメインの作成

ドメインは、レポート作成者に関連するビジネスビューを提供するメタデータおよびアクセス制御レイヤーです。以下の手順に従って、QuickBooks のカラムを選択し、フィルタを適用し、SQL を実行してドメインを作成します。

Create -> Domain をクリックします。ドメインの ID を入力し、保存場所を選択します。
Data Source セクションで Browse をクリックし、作成した QuickBooks データソースを選択します。
Domain Design セクションで、Create with Domain Designer をクリックします。
テーブルが含まれるスキーマを選択します。
Tables タブで、Data Source ペインからテーブルを選択し、矢印をクリックして Selected Tables ペインに追加します。
Derived Tables タブでは、SQL クエリに基づいてドメインを定義できます。例えば、
```
  SELECT Name, CustomerBalance FROM Customers
  
```
Joins タブでは、結合条件を構築するカラムを選択し、結合タイプを選択することでテーブルを結合できます。
Pre-Filters タブでは、カラムをドラッグ＆ドロップして、ドメインを通じて公開されるデータをフィルタする検索条件を定義します。
Display タブで、ユーザーに提示されるデータセットに QuickBooks データを選択します。
OK をクリックして変更を確定し、Submit をクリックしてドメインを作成します。

リアルタイムでデータを探索

ドメインを作成したら、データに接続する準備が整います。以下の手順に従って、Ad Hoc Editor で Ad Hoc ビューを作成します。

Create -> Ad Hoc View をクリックします。
表示されるダイアログで、作成した QuickBooks ドメインを選択します。
Choose Data ページで、ビューで使用するカラムを選択します。Pre-Filters セクションでは、選択したフィールドに基づいてフィルタを作成できます。Display セクションでは、ドメインで表示されるカラム情報を変更できます。
ウィザードが完了したら、ビュータイプを選択し、ビューにカラムを追加します。JasperSoft はドライバーのメタデータを使用して、データ型に基づいて利用可能なディメンションとメジャーを検出します。ディメンションとメジャーを Columns ボックスと Rows ボックスにドラッグします。メジャーを右クリックして集計計算を変更できます。Filters セクションで Columns スライダーを目的のデータレベルにドラッグします。
ビューの設計中にデータの更新にアクセスするには、設計モードのツールバーでメニュー選択を Sample Data から Full Data に変更します。変更を行うと、JasperSoft Server はドライバーに対して基になる SQL クエリを実行します。
ビューを保存します。