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

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

接続と帳票の作成

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)］とクリックし、新しいConfluence 接続を作成します。ダイアログが表示されたら、次のように接続プロパティを設定します。

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

     API Token を取得する方法

     API token は、アカウントへの認証に必須です。トークンの生成には、Atlassian アカウントでサービスにログインし、API tokens > Create API token に進みます。生成されたトークンが表示されます。

     Confluence Cloud Account への接続

     Cloud アカウントへの接続には、以下のプロパティを設定します（Password は、Server Instance への接続時のみ必要で、Cloud Account への接続には不要になりました。）:

     • User: Confluence サーバーに認証するユーザー名。
     • APIToken: 認証するユーザーに紐付けられたAPI Token。
     • Url: JIRA エンドポイントのURL。例： https://yoursitename.atlassian.net

     Confluence Server Instance への接続

     Server instance への接続には以下を設定します:

     • User: Confluence Instance に接続するユーザー名。
     • Password: Confluence Instance に接続するユーザーのパスワード。
     • Url: JIRA エンドポイントのURL。例： https://yoursitename.atlassian.net

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

     jdbc:confluence:User=admin;APIToken=myApiToken;Url=https://yoursitename.atlassian.net;Timezone=America/New_York;
   • Custom Driver Class Name：cdata.jdbc.confluence.ConfluenceDriver と入力。
   • User Name：認証するユーザーネーム。
   • Password：認証するパスワード。

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

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

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

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

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