Crystal Reports でConfluence データに連携して帳票を作成

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

Crystal Reports には、JDBC 標準向けのサポートが組み込まれています。この記事では、Confluence の機能を持つ帳票を作成するレポート作成ウィザードの使い方を説明します。

Confluence JDBC Driver のインストール

CData JDBC Driver for Confluence を、ドライバーのJAR をCrystal Reports のクラスパスに含めてインストール：DataDriverCommonElement の下のClassPath element のパスに、 .jar を含むファイルのフルパスを追加します。

CRConfig.xml は通常C:\Program Files (x86)\SAP BusinessObjects\SAP BusinessObjects Enterprise XI 4.0\java に配置されます。— パスはインストールによって若干異なる場合があります。ドライバーのJAR はインストールディレクトリの［lib］サブフォルダ内にあります。

ClassPath にJAR を追加したら、Crystal Reports を再起動します。

Confluence データに接続

下記の手順に従って、レポート作成ウィザードを使ってConfluence 接続を作成します。

1. 新しい空の帳票で、［Create New Connection］>［JDBC (JNDI)］をクリックします。

2. ウィザードでJDBC 接続URL を選択します。

   jdbc:confluence:User=admin;APIToken=myApiToken;Url=https://yoursitename.atlassian.net;Timezone=America/New_York;

3. ドライバーのクラス名を設定：

   cdata.jdbc.confluence.ConfluenceDriver

   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 接続をConfluence に追加したら、レポート作成ウィザードを使ってConfluence を帳票に追加できます。

1. 帳票に必要なテーブルやフィールドを選択して、データソースを設定します。この例では、Pages テーブルのKey およびName カラムを使います。

2. チャートの種類を設定 ウィザードを完了すると、Crystal Reports はConfluence データ に実行されるSQL クエリをビルドします。ドライバーは、ライブConfluence データ に対してクエリを実行します。

3. 必要に応じて、ほかのフィルタや帳票テンプレートを設定します。

4. データのインポートが終わったら、データをサマライズもしくはソートするチャートやレポートオブジェクトを作成できます。［Insert］>［Chart］をクリックして、チャートエキスパートを開きます。Total Name by Key を表すグラフを作成するには、Key を［On Change Of］メニューセレクションの下のボックスに追加してからName を［Show Values］の下のボックスに追加します。

完成した帳票をプレビューして、チャートにデータが入っていることを確認します。Null 値を取り除きたい場合は、SelectionFormula を使います。