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

CData JDBC Driver for FreshDesk は、Freshdesk API への接続をデータドリブン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 はbasic 認証を使用します。データへの接続には、次の接続プロパティを設定してください。

   • Domain：この値を、FreshDesk アカウントに紐づけられたドメインに設定します。例えば、 https://my_domain.freshdesk.comです。
   • APIKey：この値を、FreshDesk アカウントに紐づけられたAPI キーに設定します。API キーを取得するには、 サポートPortal にログインして、-> 右上端のプロファイル写真をクリック、-> プロファイル設定ページに移動します。API キーは、 右のchange password セクションの下から生成できます。

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

   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 を参照してください。