BIRT でJira Assets のデータのレポートを作成

CData JDBC Driver for Jira Assets は、データドリブンな Java アプリケーションにJira Assets API への接続機能を統合します。CData JDBC Driver for Jira Assets を BIRT（Business Intelligence Reporting Tools）プラットフォームと組み合わせることで、データの変更をリアルタイムに反映する BIRT レポートを作成できます。

1. まだインストールしていない場合は、BIRT Framework プラグインと Database Development プラグインを Eclipse にインストールします。
2. 「File」->「New」->「Report」をクリックします。Report Design パースペクティブが開きます。
3. Data Explorer で「Data Sources」を右クリックし、「New Data Source」をクリックします。
4. 「Create from a Data Source Type in the Following List」オプションを選択し、「JDBC Data Source」を選択します。
5. 「Manage Drivers」をクリックし、インストールフォルダの lib サブフォルダにあるドライバー JAR を追加します。
6. 「Database URL」ボックスに、接続文字列を含む JDBC URL を入力します。

   Jira Assets は、APIToken 経由での接続と認証をサポートしています。

   API トークンを生成するには：

   1. Atlassian アカウントにログインします。
   2. セキュリティ設定 > API トークン > API トークンを作成するをクリックします。

   Atlassian がAPI トークンを生成して表示します。

   API トークンを生成したら、以下のパラメータをセットします。

   • AuthScheme：APIToken。
   • User：認証するユーザーのログイン名。
   • APIToken：生成したAPI トークン。

   これでJira Assets に接続して認証する準備が整いました。

   組み込みの接続文字列デザイナー

   JDBC URL の構築には、Jira Assets JDBC Driver に組み込まれている接続文字列デザイナーを使用できます。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行してください。

   java -jar cdata.jdbc.jiraassets.jar
   

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

   

   JDBC URL を設定する際、Max Rows 接続プロパティも設定しておくと良いでしょう。返される行数が制限されるため、レポートやビジュアライゼーションの設計時のパフォーマンスが向上します。

   一般的な JDBC URL は以下のとおりです：

   jdbc:jiraassets:User=MyUser;APIToken=myApiToken;Url=https://yoursitename.atlassian.net
   

7. 「Data Sets」フォルダを右クリックし、Jira Assets用の JDBC データソースを選択します。
8. 表示されるダイアログで、レポート用のデータを取得する SELECT クエリを作成します。この記事では以下のクエリを使用します：

   SELECT ID, Name FROM Objects WHERE Label = 'SYD-1'
   

9. 「Palette」からエディターにチャートをドラッグします。チャートウィザードが表示されます。
10. チャートタイプを選択した後、「Select Data」タブでカラムをチャートフィールドにドラッグします。
11. 「Run」->「View Report」->「In Web Viewer」をクリックしてレポートを表示します。

これで、BIRT レポートがJira Assets のデータの更新を反映できるようになりました。

レポートをアプリケーションサーバーに公開するには、ドライバー JAR を BIRT Viewer のクラスパスに追加します。詳細については、Java アプリケーションサーバーへの JDBC ドライバのデプロイに関する CData KB ガイドを参照してください。