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

Pentaho BI ツールでConfluence のレポートを作成。

加藤龍彦
デジタルマーケティング

最終更新日:2022-03-16

この記事で実現できる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: 次にセミコロン区切りで接続プロパティを入力します。

      Confluence 接続プロパティの取得・設定方法

      任意のConfluence Cloud またはConfluence Server インスタンスへの接続を確立できます。接続するにはURL 接続プロパティを設定します。例えば、https://yoursitename.atlassian.net です。

      Confluence への認証

      Confluence は、次の認証メソッドをサポートしています:API トークン、Basic 認証、OAuth 2.0、SSO。

      API トークン - Confluence Cloud アカウント

      トークンの取得

      アカウント認証にはAPI トークンが必要です。API トークンを生成するには、Atlassian アカウントにログインしてAPI トークン -> API トークンの作成を選択します。生成されたトークンが表示されます。

      トークンを使用する認証

      Cloud アカウントへの認証を行うには、以下を入力します。

      • AuthScheme:APIToken に設定。
      • User:Confluence サーバーに認証する際に使用されるユーザー。
      • APIToken:現在認証されているユーザーに紐づくAPI トークン。
      • Url:Confluence エンドポイントに紐づくURL。例えば、https://yoursitename.atlassian.net です。

      Basic 認証 - Confluence Server インスタンス

      Server インスタンスへの認証を行うには、以下のように指定します。

      • AuthSchemeBasic に設定。
      • User:Confluence インスタンスに認証する際に使用されるユーザー。
      • Password:Confluence サーバーに認証する際に使われるパスワード。
      • Url:Confluence エンドポイントに紐づく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:認証するパスワード。
    Required connection properties defined in the JDBC URL. (Salesforce is shown.)

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

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

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

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

    SELECT Key, Name FROM Pages WHERE Id = '10000' The query to retrieve data, specified in the JDBC data source configuration wizard. (Salesforce is shown.)
  3. 帳票にチャートをドラッグし、ダブルクリックしてチャートを編集します。帳票を実行して、チャートを表示します。このクエリ結果を使って、Pages テーブルのシンプルなチャートを作成することができます。
  4. 帳票を実行して、チャートを見てみましょう。
A chart generated from up-to-date data. (Salesforce is shown.)

関連コンテンツ

トライアル・お問い合わせ

30日間無償トライアルで、CData のリアルタイムデータ連携をフルにお試しいただけます。記事や製品についてのご質問があればお気軽にお問い合わせください。