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

Jerod Johnson
Senior Technology Evangelist

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

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

ドライバー JAR のデプロイ

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

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

Square OAuth 認証標準を使用します。OAuth を使用して認証するには、Square にアプリを登録してOAuthClientId、OAuthClientSecret、CallbackURL を入手します。OAuth の使用方法については、ヘルプドキュメントの「はじめに」セクションをご覧ください。

追加でLocationId を指定する必要がある場合があります。Locations テーブルをクエリすることでLocations のId を取得できます。または、クエリの検索項目にLocationId を設定することもできます。

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

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

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

Square JDBC データソースの作成

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

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

ドメインの作成

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

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

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

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

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