メインコンテンツへスキップ

​
はじめに

JIRAは素晴らしい製品を開発するためにチームを組織し、協力して作業をするのに活用できますが、製品チームは組織の一部に過ぎません。Domoを使用すると、複数のソースからのデータを単一のプラットフォームに結合することができます。製品開発、マーケティング、セールス、運営、財務などからデータを取得し、事業全体をリアルタイムに把握することができます。データをDomoに取り込むと、リアルタイムデータによるダイナミックな可視化がすべてのデバイスで実現します。 DomoのJIRAコネクターを使用すると、JIRAアカウントに接続してJIRAからデータを抽出することができます。カスタムクエリまたは事前定義されたクエリを使用すると、問題追跡、チームごとの完了済みチケット、チケット解決時間、プロジェクト管理メトリクスなどのデータをインポートできます。JIRA APIの詳細については、 https://developer.atlassian.com/jira…e-query-issues を参照してください。 JIRAコネクターは「クラウドApp」コネクターであるため、クラウドに保管されたデータの取得が可能です。Data Centerのウィンドウ上部にあるツールバーで ［クラウドApp］ をクリックすると、このコネクターやほかのクラウドAppコネクターのページにアクセスできます。 JIRAアカウントには、Data Centerから接続します。このトピックでは、JIRAコネクターのユーザーインターフェースに固有のフィールドとメニューについて説明します。DataSetの追加や更新スケジュールの設定、DataSet情報の編集に関する一般的な情報は、「 コネクターを使用してDataSetを追加する 」を参照してください。

主な使用事例

  • チケットの進捗や動向の追跡

  • 特定のユーザーやグループにアサインされたチケット数

  • オープンである特定のタイプのチケット（バグ）が多すぎないか確認

主なメトリクス

  • バグ、問題、またはチケットの追跡（経過時間、タイプ、ステータス、提出者により分類）

  • チームごとの完了済みチケット

  • チケット解決時間

  • プロジェクト管理メトリクス（プロジェクトやエピックに含まれる個々のタスクを追跡）

社内における主な権限

製品マネージャー

平均導入時間

実装の形態や、JIRAシステムに関するユーザーの知識レベルにより大きく異なります。

使いやすさ（1～10段階。1が「最も使いやすい」）

7

​
ベストプラクティス

  • JIRAコネクターでは、必ず「置換」を使用してください。「追加」は適切に作動しません。
  • クエリを長期間にわたるデータに対して実行する場合、スケジュール間隔は最低限に抑えてください（1日1回）。短期間のクエリについては、より頻繁なアップデートが適しています。

​
必要条件

JIRAアカウントに接続してDataSetを作成するには、以下が必要です。
  • JIRAへのログインに使用するユーザー名とパスワード/APIキー。 Jira CloudユーザーはAPIキーを使用する必要があります。APIキーは、http://id.atlassian.comで 生成できます。
  • 会社のJIRAインスタンスのURL。
  • データを引き出すのに使用するJQLクエリ（カスタマイズされたレポートを作成する場合）。
認証情報は、アカウントの作成時に取得します。JIRA管理者は、オンプレミスでJIRAを実装した場合、社内の大多数のユーザーに対してユーザー名とパスワードを作成したものと想定されます。

​
SSO

シングルサインオン（SSO）認証情報は機能しません。ただし、以下を実行することでSSO制限を回避できます。
  1. JIRA管理者に、APIで使用するための、専用のユーザー名とパスワードを持つローカルアカウントの作成を依頼します。
  2. APIキーを http://id.atlassian.com/ で作成します。
  3. DomoのJIRAコネクターページで、パスワードの代わりに作成したAPIキーを入力します（アカウントによっては、ユーザー名として、あなたのユーザー名、またはJIRAアカウントメールアドレスの入力を求められる場合があります）。

​
JIRAインスタンスに接続する

このセクションでは、JIRA Rest APIコネクターページの ［認証情報］ および ［詳細］ ペインについて説明します。このページのほかのペインの項目にある ［スケジュール設定］ や ［DataSetに名前を付け、説明を入力］ については、ほとんどのコネクターで共通しています。詳細については、「 コネクターを使用してDataSetを追加する 」を参照してください。

​
［認証情報］ペイン

このペインには、JIRAインスタンス接続用の認証情報を入力するフィールドが含まれています。下表では、各フィールドに必要な内容を説明しています。

フィールド

説明

Username

JIRAインスタンスのログインに使用するユーザー名を入力します。

Password

JIRAインスタンスのログインに使用するパスワードを入力します。 Jira CloudユーザーはAPIキーを使用する必要があります。APIキーは、 http://id.atlassian.comで 生成することができます。

Server URL

JIRAインスタンスのURLを入力します（例： onjira.mycompany.com ）。

一度有効なJIRA認証情報を入力しておくと、随時同じアカウントを使用して新しいJIRA DataSetを作成することができます。コネクターのアカウントは Data Center の ［アカウント］ タブで管理できます。このタブの詳細については、「 コネクターのユーザーアカウントを管理する 」を参照してください。

​
［詳細］ペイン

このペインには、メインとなる ［Reports］ メニューのほか、選択したレポートタイプに応じて表示／非表示になる様々なメニューが含まれています。

メニュー

説明

Report

実行する レポートを選択します。以下のレポートが利用できます。

レポート 説明
Issue Query ユーザーがJQL（JIRA Query Language）を使って問題をクエリできるようにします。
Boards スクラムボードのリストを返します。
Board Sprints 選択したボードスプリントのリストを返します。
Sprint Issues 選択したスプリントの問題を返します。
Fields ユーザーのJIRAアカウントで使用するフィールドのリストを返します。
Group Members 指定されたグループに属するユーザーのリストを返します。このレポートを実行するには管理者アクセス権が必要です。
Projects ユーザーがアクセスするプロジェクトすべてのリストを返します。
Project Versions 指定したプロジェクトのバージョンすべてのリストを返します。
JQL Query

カスタマイズされたデータを取得するためのJQLクエリを入力します。 JIRAのドキュメント を参照してください。

説明 クエリの例
3ヶ月前の月初以降に作成されたすべての問題 created >= STARTOFMONTH(-3)
10日前以降に作成されたすべての問題 created >= STARTOFDAY(-10)
特定の日以降に更新されたすべての問題 updated >= ‘2020-01-01’
自分に割り当てられたすべての問題 assignee = currentUser()
クローズされた「Some Project」に対するすべての問題 project = ‘Some Project’
and status = closed
特定のユーザーから報告されたすべての問題 reporter = ’ user.name ’
Data Option
データオプション 説明
Comments Report 関連するコメントを持つJIRAチケットを返します。
Changelog Report クエリに該当する問題に関するチェンジログを返します。ChangelogレポートはJira Cloudユーザーのみが利用可能です。
Labels Report クエリに該当する問題のラベルを返します。
Linked Issues Report クエリに該当する問題にリンクされた問題を返します。
Sprint Report クエリに該当する問題のスプリントの詳細を返します。
Standard Ticket Report JIRAチケットのほぼすべてのパラメーター（問題サマリ、説明、作成日、解決日、影響のあった顧客名、環境など）の列を返します。
Ticket History Report チケットの履歴情報を返します。
Worklog Report クエリに該当する問題に関するワークログを返します。
Filter Type 返されるデータセットに特定のフィールドを含めるか除外するかを選択します。
Group Name 取得したいユーザーを含むグループを入力します。このレポートには管理者アカウントが必要です。

​
その他のペイン

スケジュール設定、再試行、更新に関するオプションなど、コネクターインターフェースのその他のペインに表示されるオプションについては、「 コネクターを使用してDataSetを追加する 」を参照してください。

​
よくある質問

レポート名 エンドポイントURL（1つまたは複数）
Agile API: Agile Boards /rest/agile/1.0/board
Board Sprints /rest/agile/1.0/board//sprint
Sprint Issues /rest/agile/1.0/board//sprint//issue
Fields /rest/api/2/field
Group Members /rest/api/2/group/member
Issue Query /rest/api/2/search
Projects /rest/api/2/project
Project Versions /rest/api/2/project//versions
JIRAインスタンスには、ユーザー名、パスワード、サーバーのURLが必要です。
エラーの原因として、以下が考えられます。
  • JIRAサーバーでAPIアクセスが有効になっていない。APIアクセスを有効にするには、JIRAの管理者に連絡してください。
  • JIRAのユーザー名ではなく、メールアドレスを使用している。ユーザー名とメールアドレスがまったく同じであることは多いのですが、「 user.name@company.com 」というメールアドレスのユーザーの実際のユーザー名が「 user.name 」であることも珍しくありません。
JIRAではSSOの実装はサポートされていません。ただし、これらの制限を回避することはできます。
  • JIRAサーバー – JIRA管理者に、APIで使用する専用のユーザー名とパスワードを持つローカルアカウントの作成を依頼します。
  • JIRAクラウド – ATLASSIAN でAPIキーを作成することができます。DomoのJIRAコネクターページで、パスワードの代わりに作成したAPIキーを入力します。 注記：アカウントによっては、ユーザー名として、自分のユーザー名またはJIRAアカウントのメールアドレスを入力する必要があります。
JIRAのサーバーからのデータは、通常すぐにAPIで利用可能です。
JIRAプラットフォームには、クエリが有効かどうかを確認できる便利なツールがあります。このツールにアクセスする簡単な方法は、単にJIRAの検索バーで検索を行うことです。検索画面では、クエリ文字列の横に有効であることを示す緑のチェックボックスが表示されます。そうでない場合には、赤の「X」が表示されます。基本的な検索機能に戻して利用可能なセレクターからクエリを作成し、再び［Advanced］に切り替えることで作成したクエリを確認できます。
接続エラーの最も一般的な原因は、JIRAサーバーに、リクエストに対処できないほどの負荷がかかっていることです。JIRAサーバーにさらにリソースを割り当てる方法については、JIRAの管理者にお問い合わせください。
JIRAは非常に多くのデータを返すため、コネクターではフィールドをインクルーシブまたはエクスクルーシブで指定できます。インクルーシブを選択すると、指定したフィールドのみが返されます。エクスクルーシブを選択すると、指定したフィールドを除くすべてのフィールドが返されます。
アクセス権のあるすべてのアジャイルボードのリストを取得するには、レポートタイプで ［Agile API］ 、アジャイルレポートで ［Agile Board］ を選択します。
JIRAインスタンスでOAuthを使用する場合は、Jira Cloudコネクターを使用してください。Jira CloudコネクターはOAuth2認証をサポートしています。JIRAアカウントにオンラインでログインするのと同じ認証情報を使用して、Jira Cloudコネクターで認証することができます。

​
トラブルシューティング

  • JIRAでは、APIアクセスを確実に有効化するため、JIRA管理者側で、多くの設定を必要とします。よくある問題としては、タイムアウトが短すぎる、またはJIRAサーバーに十分なリソースが提供されないことが挙げられます。
  • JQLのフォーマットを理解するのが難しい場合は、JIRAフロントエンドにログインするのが最も簡単な解決法です。JIRAは、［検索］バーで、プリセットされたフィルターを用いてJQLクエリを作成できるツールを提供しています。クエリの作成後に ［Advanced］ ボタンを押すと、選択にもとづいてJQLフォーマットで表示されます。