BIRT Reports をFreshdesk データ でデザイン

CData JDBC Driver for Freshdesk は、Freshdesk APIs への接続をデータドリブンJava アプリケーションに統合します。CData JDBC Driver for Freshdesk を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］を入力します。

   FreshDesk makes use of basic authentication. To connect to data, set the following connection properties:

   • Domain: Set this to the domain associated with your FreshDesk account. For example, in your URL: https://my_domain.freshdesk.com.
   • APIKey: Set this to the API key associated with your FreshDesk account. To retrieve your API key, Log into your support Portal -> Click on profile picture in the top right corner -> profile settings page. The API key will be available below the change password section to the right.

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

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

   java -jar cdata.jdbc.freshdesk.jar

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

   

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

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

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

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

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