BIRT でスマレジのデータのレポートを作成

Jerod Johnson
Senior Technology Evangelist

組み込み分析にリアルタイムスマレジのデータを提供。

CData JDBC Driver for スマレジは、データドリブンな Java アプリケーションにスマレジ API への接続機能を統合します。CData JDBC Driver for スマレジを BIRT（Business Intelligence Reporting Tools）プラットフォームと組み合わせることで、データの変更をリアルタイムに反映する BIRT レポートを作成できます。

まだインストールしていない場合は、BIRT Framework プラグインと Database Development プラグインを Eclipse にインストールします。
「File」->「New」->「Report」をクリックします。Report Design パースペクティブが開きます。
Data Explorer で「Data Sources」を右クリックし、「New Data Source」をクリックします。
「Create from a Data Source Type in the Following List」オプションを選択し、「JDBC Data Source」を選択します。
「Manage Drivers」をクリックし、インストールフォルダの lib サブフォルダにあるドライバー JAR を追加します。
「Database URL」ボックスに、接続文字列を含む JDBC URL を入力します。
スマレジドライバーには、ContractId およびAccessToken パラメータが必要です。
- スマレジにログイン後、「設定」->「システム連携」->「スマレジAPI 設定」に移動します。
- 「API受信設定」セクションにある「受信機能を利用する」を「利用する」に変更し、「アクセストークンの生成」をクリックし、AccessToken を取得します。
- 次に必要なAPI アクセスを有効にするため、「機能設定」セクションで必要な機能を「利用する」に変更します。
ContractId： アカウントの契約ID。これは受信設定セクションでも確認できます。
AccessToken： 受信設定セクションのアクセストークン。

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

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

JDBC URL を設定する際、Max Rows 接続プロパティも設定しておくと良いでしょう。返される行数が制限されるため、レポートやビジュアライゼーションの設計時のパフォーマンスが向上します。

一般的な JDBC URL は以下のとおりです：
```
jdbc:smaregi:ContractId=mycontractid;AccessToken=myaccesstoken;
```
「Data Sets」フォルダを右クリックし、スマレジ用の JDBC データソースを選択します。
表示されるダイアログで、レポート用のデータを取得する SELECT クエリを作成します。この記事では以下のクエリを使用します：
```
SELECT ProductName, Description FROM Products
```
「Palette」からエディターにチャートをドラッグします。チャートウィザードが表示されます。
チャートタイプを選択した後、「Select Data」タブでカラムをチャートフィールドにドラッグします。
「Run」->「View Report」->「In Web Viewer」をクリックしてレポートを表示します。