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

Crystal Reports には、ODBC 標準向けのサポートが組み込まれています。CData ODBC Driver for Confluence は、Crystal Reports でレポート作成ウィザードやその他のツールを使ってConfluence へのアクセスを可能にします。この記事では、Confluence の機能を持つシンプルな帳票を作成する方法を説明します。

Confluence データに接続

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

1. ODBC 接続プロパティの指定がまだの場合は、DSN （データソース名）の設定を行います。Microsoft ODBC データソースアドミニストレーターを使ってODBC DSN を作成および設定できます。一般的な接続プロパティは以下のとおりです：
   • User
   • APIToken
   • Url
   • Timezone

   Microsoft ODBC データソースアドミニストレーターで必要なプロパティを設定する方法は、ヘルプドキュメントの「はじめに」をご参照ください。

   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

2. 新しい帳票で、［Create New Connection］>［ODBC］をクリックします。

3. ウィザードが表示されたら［Select Data Source］をクリックし、［Data Source Name］メニューでDSN を選択します。

Confluence データに連携する帳票をデザイン

ODBC 接続をConfluence に追加したら、レポート作成ウィザードを使ってConfluence を帳票に追加できます。

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

2. チャートの種類を設定。 例えば、Name をKey で表すシンプルなチャートを作成します。 ウィザードを完了すると、Crystal Reports はConfluence に実行されるSQL クエリをビルドします。ドライバーは、リアル隊うConfluence に対してクエリを実行します。

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

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

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