BIRT Reports をMoney Forward Expense データ でデザイン

CData JDBC Driver for MFExpense は、Money Forward Expense API への接続をデータドリブンJava アプリケーションに統合します。CData JDBC Driver for MFExpense をBIRT (Business Intelligence Reporting Tools) のプラットホームで使用することで、リアルタイムでデータの変更を反映するBIRT レポートを作成できます。

1. Eclipse 用のBIRT Framework プラグインとDatabase Development プラグインをインストールします。
2. ［File］->［New］->［Report］と進みます。［Report Design perspective］が表示されます。
3. ［Data Explorer］で［Data Sources］を右クリックし、［New Data Source］をクリックします。
4. ［Following List］オプションから［Create from Data Source Type］を選択し、［JDBC Data Source］を選択します。
5. ［Manage Drivers］をクリックし、インストールフォルダのlib サブフォルダにあるドライバーのJAR を追加します。
6. ［Database URL］ボックスに、接続文字列を含む［JDBC URL］を入力します。

   MoneyForward Expense はOAuth 2 認証標準を利用しています。MoneyForward Expense にアプリケーションを登録し、OAuthClientId およびOAuthClientSecret を取得する必要があります。認証方法については、ヘルプドキュメントの「MoneyForward Expense への接続」を参照してください。

   また、ほとんどのテーブルを操作するためにOfficeId プロパティを指定する必要があります。

   ビルトイン接続文字列デザイナ

   JDBC URL の構成については、Money Forward Expense JDBC Driver に組み込まれている接続文字列デザイナを使用してください。JAR ファイルのダブルクリック、またはコマンドラインからJAR ファイルを実行します。

   java -jar cdata.jdbc.mfexpense.jar

   接続プロパティを入力し、接続文字列をクリップボードにコピーします。

   JDBC URL を構成する際に、Max Rows プロパティを定めることも可能です。これによって戻される行数を制限するため、可視化・レポートのデザイン設計時のパフォーマンスを向上させるのに役立ちます。

   以下は一般的なJDBC URL です。

   jdbc:mfexpense:OAuthClientId=MyOAuthClientId;OAuthClientSecret=MyOAuthClientSecret;InitiateOAuth=GETANDREFRESH
7. ［Data Sets］フォルダを右クリックし、［JDBC data source for MFExpense］を選択します。
8. 表示されるダイアログで、レポートのデータを取得するために使用するSELECT クエリを構築します。この記事では、以下のクエリを用います。 SELECT Id, Name FROM Offices
9. ［Palette］で、［Chart］をエディタにドラッグします。［Chart］ウィザードが表示されます。
10. チャートタイプを選択した後、［Select Data］タブのチャートフィールドにカラムをドラッグします。
11. ［Run］->［View Report］->［In Web Viewer］とクリックして、レポートを表示します。

これによって、BIRT レポートがMoney Forward Expense の更新をすべて取得できるようになります。

レポートをアプリケーションサーバーに公開するには、ドライバーのJAR をBIRT Viewer のクラスパスに追加します。より詳しい説明は、Java アプリケーションサーバーにJDBC Driver をデプロイする方法について、CData KB を参照してください。