Crystal Reports にJira Service Management を連携してJira Service Management のデータを使った帳票を作成

古川えりか
コンテンツスペシャリスト

レポート作成ウィザードを使って、最新のJira Service Management のデータを使った帳票を作成。

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

CData ODBC ドライバとは？

CData ODBC ドライバは、以下のような特徴を持ったリアルタイムデータ連携ソリューションです。

Jira Service Management をはじめとする、CRM、MA、会計ツールなど多様なカテゴリの270種類以上のSaaS / オンプレミスデータソースに対応
多様なアプリケーション、ツールにJira Service Management のデータを連携
ノーコードでの手軽な接続設定
標準 SQL での柔軟なデータ読み込み・書き込み

CData ODBC ドライバでは、1.データソースとしてJira Service Management の接続を設定、2.Crystal Reports 側でODBC Driver との接続を設定、という2つのステップだけでデータソースに接続できます。以下に具体的な設定手順を説明します。

CData ODBC ドライバのインストールとJira Service Management への接続設定

まずは、本記事右側のサイドバーからJiraServiceDesk ODBC Driver の無償トライアルをダウンロード・インストールしてください。30日間無償で、製品版の全機能が使用できます。

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

ODBC 接続プロパティの指定がまだの場合は、DSN （データソース名）の設定を行います。Microsoft ODBC データソースアドミニストレーターを使ってODBC DSN を作成および設定できます。一般的な接続プロパティは以下のとおりです：
- ApiKey
- User
Microsoft ODBC データソースアドミニストレーターで必要なプロパティを設定する方法は、ヘルプドキュメントの「はじめに」をご参照ください。
Jira Service Management 接続プロパティの取得・設定方法

任意のJira Service Management Cloud またはJira Service Management Server インスタンスへの接続を確立できます。接続するにはURL プロパティを設定します。
- URL（例：https://yoursitename.atlassian.net）
カスタムフィールドへのアクセス

デフォルトでは、CData 製品はシステムフィールドのみを表示します。Issues のカスタムフィールドにアクセスするには、IncludeCustomFields を設定します。
Jira Service Management への認証

ベーシック認証

ローカルサーバーアカウントで認証するためには、次の接続プロパティを指定します。
- AuthScheme：Basic に設定。
- User：認証ユーザーのユーザー名に設定。
- Password：認証ユーザーのパスワードに設定。
API トークン

Cloud アカウントに接続するには、APIToken を取得する必要があります。API トークンを生成するには、Atlassian アカウントにログインして「API トークン」 -> 「API トークンの作成」をクリックします。生成されたトークンが表示されます。

データに接続するには以下を設定します。
- AuthScheme：APIToken に設定。
- User：認証ユーザーのユーザー名に設定。
- APIToken：作成したAPI トークンに設定。
ちなみに、Cloud アカウントへの接続でパスワード認証を使うことも可能ですが、非推奨となっています。

OAuth 2.0
Jira Service Management のOAuth 2.0 サポート（3LO）を活用して、ログインクレデンシャルなしでデータに接続することもできます。
この場合、AuthSchemeをすべてのOAuth フローでOAuth に設定する必要があります。また、すべてのシナリオでカスタムOAuth アプリケーションを作成して構成する必要があります。詳しくは、ヘルプドキュメントの「OAuth」セクションを参照してください。
新しい帳票で、［Create New Connection］>［ODBC］をクリックします。
ウィザードが表示されたら［Select Data Source］をクリックし、［Data Source Name］メニューでDSN を選択します。

Jira Service Management のデータに連携する帳票をデザイン

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

帳票に必要なテーブルやフィールドを選択して、データソースを設定します。この例では、Requests テーブルのRequestId およびReporterName カラムを使います。
チャートの種類を設定。例えば、ReporterName をRequestId で表すシンプルなチャートを作成します。ウィザードを完了すると、Crystal Reports はJira Service Management に実行されるSQL クエリをビルドします。ドライバーは、リアル隊うJira Service Management に対してクエリを実行します。
必要に応じて、ほかのフィルタやレポートテンプレートを設定します。
データのインポートが終わったら、レポートフィールドをサマライズもしくはソートするチャートやレポートオブジェクトを作成できます。［Insert］>［Chart］をクリックして、チャートエキスパートを開きます。Total ReporterName by RequestId を表すグラフを作成するには、RequestId を［On Change Of］メニューセレクションの下のボックスに追加してからReporterName を［Show Values］の下のボックスに追加します。