Pentaho Report Designer にBacklog データに連携して分析

こんにちは！ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。

CData JDBC Driver for Backlog はダッシュボードや帳票ツールからリアルタイムBacklog データへの連携を可能にします。この記事では、Backlog をJDBC データソースとして接続する方法と、Pentaho でBacklog を元に帳票を作成する方法を説明します。

接続と帳票の作成

1. インストールディレクトリの［lib］サブフォルダ内のJAR ファイルをコピーし、Pentaho のディレクトリ内の\Report-Designer\lib\jdbc\ フォルダに配置します。
2. \Report-Designer\ フォルダのreport-designer.bat ファイルを起動し、Report-Designer UI を開きます。

3. 以下の手順でドライバーを新しいデータソースに設定します。［Data］>［Add Data Source］>［Advanced］>［JDBC (Custom)］とクリックし、新しいBacklog 接続を作成します。ダイアログが表示されたら、次のように接続プロパティを設定します。

   • Custom Connection URL property：JDBC URL を入力。初めに以下を入力し jdbc:backlog: 次にセミコロン区切りで接続プロパティを入力します。

     Backlog への接続に使用できる認証方法は、API キーおよびOAuth の2つです。

     API キー認証

     ApiKey およびURL をログインクレデンシャルに設定します。 ApiKey を取得するには：

     1. Backlog の個人設定ページを開きます。
     2. 「API」セクションをクリックして、「メモ」にAPI キーについての説明を追加し、「登録」ボタンをクリックします。トークンが生成されます。
     3. ApiKey にAPI キーを指定します。
     4. URL はBacklog のテナントURL から取得できます。

     OAuth 認証

     ユーザー名やパスワードへのアクセスを保有していない場合や、それらを使いたくない場合にはOAuth ユーザー同意フローを使用します。認証方法については、ヘルプドキュメントを参照してください。

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

     jdbc:backlog:ApiKey=YOUR_API_KEY;Url=https://yourURL.backlog.com;
   • Custom Driver Class Name：cdata.jdbc.backlog.BacklogDriver と入力。
   • User Name：認証するユーザーネーム。
   • Password：認証するパスワード。

レポートに Backlog データを追加

これで、Backlog の帳票を作成する準備が整いました。

1. 帳票にBacklog データソースを追加します：［Data］>［Add Data Source］>［JDBC］をクリックし、データソースを選択します。

2. クエリを設定します。この記事では次を使います：

   SELECT Id, ProjectID FROM Issues
3. 帳票にチャートをドラッグし、ダブルクリックしてチャートを編集します。帳票を実行して、チャートを表示します。このクエリ結果を使って、Issues テーブルのシンプルなチャートを作成することができます。
4. 帳票を実行して、チャートを見てみましょう。