各製品の資料を入手。
詳細はこちら →Pentaho Report Designer にJira Service Management のデータに連携して分析
Pentaho BI ツールでJira Service Management のレポートを作成。
最終更新日:2022-03-16
この記事で実現できるJira Service Management 連携のシナリオ
こんにちは!ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。
CData JDBC Driver for JiraServiceDesk はダッシュボードや帳票ツールからリアルタイムJira Service Management のデータへの連携を可能にします。この記事では、Jira Service Management をJDBC データソースとして接続する方法と、Pentaho でJira Service Management を元に帳票を作成する方法を説明します。
接続と帳票の作成
- インストールディレクトリの[lib]サブフォルダ内のJAR ファイルをコピーし、Pentaho のディレクトリ内の\Report-Designer\lib\jdbc\ フォルダに配置します。
- \Report-Designer\ フォルダのreport-designer.bat ファイルを起動し、Report-Designer UI を開きます。
以下の手順でドライバーを新しいデータソースに設定します。[Data]>[Add Data Source]>[Advanced]>[JDBC (Custom)]とクリックし、新しいJira Service Management 接続を作成します。ダイアログが表示されたら、次のように接続プロパティを設定します。
Custom Connection URL property:JDBC URL を入力。初めに以下を入力し jdbc:jiraservicedesk: 次にセミコロン区切りで接続プロパティを入力します。
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」セクションを参照してください。
以下は一般的なJDBC URL です:
jdbc:jiraservicedesk:ApiKey=myApiKey;User=MyUser;
- Custom Driver Class Name:cdata.jdbc.jiraservicedesk.JiraServiceDeskDriver と入力。
- User Name:認証するユーザーネーム。
- Password:認証するパスワード。
レポートに Jira Service Management のデータを追加
これで、Jira Service Management の帳票を作成する準備が整いました。
-
帳票にJira Service Management のデータソースを追加します:[Data]>[Add Data Source]>[JDBC]をクリックし、データソースを選択します。
クエリを設定します。この記事では次を使います:
SELECT RequestId, ReporterName FROM Requests WHERE CurrentStatus = 'Open'
- 帳票にチャートをドラッグし、ダブルクリックしてチャートを編集します。帳票を実行して、チャートを表示します。このクエリ結果を使って、Requests テーブルのシンプルなチャートを作成することができます。
- 帳票を実行して、チャートを見てみましょう。
