SAP Crystal Reports で Jira ののデータをレポートに出力

Dibyendu Datta
Dibyendu Datta
Lead Technology Evangelist
レポートウィザードを使用して、Jira のデータに基づいたレポートを作成します。

Crystal Reports にはリモートデータへのデータ処理をオフロードするためのさまざまなオプションが用意されており、リアルタイムレポートを実現できます。Crystal Reports がJDBC に対応しているため、CData JDBC Driver for Jira によってこの機能をCrystal Reports で利用できるようになります。この記事では、レポート実行時にデータを更新するJira のデータレポートを作成する方法を紹介します。

Jira データ連携について

CData は、Jira のライブデータへのアクセスと統合を簡素化します。お客様は CData の接続機能を以下の目的で活用しています:

  • Issue、Project、Workflow などの Jira オブジェクトへの双方向アクセスを実現します。
  • SQL ストアドプロシージャを使用して、Issue のステータス変更、カスタムフィールドの作成、添付ファイルのダウンロード・アップロード、時間追跡設定の変更・取得などの機能的なアクションを実行できます。
  • ユーザー名とパスワード、OAuth、パーソナルアクセストークン、API トークン、Crowd または OKTA SSO、LDAP など、さまざまな方法で安全に認証できます。

多くのユーザーは、CData Sync を直接使用するか、SSIS や Azure Data Factory などのプラットフォームとの CData の互換性を活用して、Jira データをデータベースやデータウェアハウスに統合するために CData ソリューションを活用しています。また、Tableau や Power BI などのお気に入りの分析ツールからライブ Jira データの分析やレポートを行いたい方もいます。

お客様がビジネス上の問題を解決するために Jira データにシームレスに接続している方法については、ブログをご覧ください:Drivers in Focus: Collaboration Tools


はじめに


以下の表は、この記事で使用するツールとバージョンです。

アプリケーション名バージョン
SAP Crystal Reports 2020SP3
JDBC Driver23.0.8565

JDBC Driver のデプロイ

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

CRConfig.xml ファイルのデフォルトの場所はC:\Program Files (x86)\SAP BusinessObjects\SAP BusinessObjects Enterprise XI 4.0\java ですが、インストールによって多少異なる場合があります。ドライバーJAR はインストールディレクトリのlib サブフォルダにあります。

CRConfig.xml ファイルにJDBC ファイルパスを追加

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

Jira のデータに接続

JiraのJDBC Driver をデプロイしたら、レポートウィザードを使用して新しいレポートにJira のデータを追加できます。

  1. File -> New -> Standard Report をクリックします。 標準レポートを作成
  2. Create New Connection の下にあるJDBC (JNDI) を展開し、Make a New Connection をダブルクリックします。
  3. CData JDBC Driver for Jira を使用して接続文字列を作成します。
  4. JDBC URL の構成については、Jira JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルをダブルクリックするか、コマンドラインからjar ファイルを実行します。

    java -jar cdata.jdbc.jira.jar
    

    JIRA への接続には、User、Password およびURL を使います。URL はhttps://yoursitename.atlassian.net などです。

    接続プロパティを入力し、接続文字列をクリップボードにコピーします。

    組み込みの接続文字列デザイナーを使用してJDBC URL を生成(例はSalesforce)

    JDBC URL を設定する際に、Max Rows 接続プロパティを設定することもできます。これにより返される行数が制限され、レポートやビジュアライゼーションをデザインする際のパフォーマンス向上に役立ちます。

  5. ウィザードでJDBC 接続URL を入力します。

    jdbc:jira:User=admin;Password=123abc;Url=https://yoursitename.atlassian.net;
    
  6. ドライバークラス名を設定します。

    cdata.jdbc.jira.JIRADriver
    
    新しいJDBC(JNDI)接続を作成
  7. レポートに必要なテーブルを選択します。 テーブルを追加
  8. SAP Crystal Reports でJira のデータのテーブルをリンクすることもできます。テーブル間のリンクを追加したら、NEXT をクリックします。 複数のテーブルを追加 テーブルをリンク
  9. テーブルを選択したら、選択したテーブルからレポートに表示するフィールドを選び、NEXT をクリックします。 表示するフィールドを追加
  10. レポート上の情報をグループ化するために「Group By」フィールドを選択します。 Group By フィールドを追加
  11. 集計合計に基づいてグループを並べ替え、NEXT をクリックします。 グループの並べ替え

その後、グループ化、並べ替え、集計を設定できます。集計とサマリーを使用してチャートを作成するには、次のセクションを参照してください。

チャートの作成

グループ化するカラムを選択した後、標準レポート作成ウィザードでチャートを作成するオプションが表示されます。以下の手順に従って、Summary カラムの値を集計するチャートを作成します。

  1. 標準レポート作成ウィザードで、Bar Chart オプションを選択し、「On change of」メニューでグループ化したカラムを選択します。
  2. Show Summary メニューで、作成した集計を選択します。
  3. 必要に応じてフィルターとテンプレートを選択し、ウィザードを完了します。 チャートの種類を選択

レポートのテンプレートを選択すると、完成したレポートをプレビューし、データが入力されたチャートを表示できます。

テンプレートの種類を選択

完成したレポート

レポートに最初に指定したすべてのフィールドが含まれていることを確認できます。

完成したレポート

リモートデータの操作

データの更新を確認するには、File をクリックし、「Save Data with Report」オプションをオフにします。レポートを操作すると(例えば、詳細にドリルダウンすると)、Crystal Reports はレポートの表示に必要なデータを取得するためにSQL クエリを実行します。すでに取得したデータを再読み込みするには、レポートを更新または再実行します。

詳細要素を非表示にし、サーバー側グループ化を有効にすることで、ドライバーに処理をオフロードできます。これを行うには、レポート作成ウィザードでグループ化するカラムを選択する必要があります。

  1. File -> Report Options をクリックし、「Perform Grouping On Server」オプションを選択します。 Perform Grouping On Server オプション
  2. Report -> Section Expert をクリックし、レポートのDetails セクションを選択します。「Hide (Drill-Down OK)」オプションを選択します。 Hide (Drill-Down OK) オプション

詳細を非表示にしてレポートをプレビューすると、Crystal Reports はGROUP BY クエリを実行します。チャートのカラムをダブルクリックして詳細にドリルダウンすると、Crystal Reports は必要なデータのみを取得するSELECT WHERE クエリを実行し、読み込み時間を短縮します。

これで、SAP Crystal Reports とCData JDBC Driver を使用して、Jira のデータに基づくSAP Crystal レポートが作成できました。CData JDBC Driver for Jira の詳細と無料トライアルのダウンロードについては、Jira JDBC Driver ページをご覧ください。ご不明な点がございましたら、サポートチームまでお問い合わせください。

はじめる準備はできましたか?

Jira Driver の無料トライアルをダウンロードしてお試しください:

 ダウンロード

詳細:

Jira Icon Jira JDBC Driver お問い合わせ

JIRA データ連携のパワフルなJava アプリケーションを素早く作成して配布。