> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-bradley-turek-pfilter-operators-reference.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# JIRAクラウドコネクター

## はじめに

JIRAは素晴らしい製品を開発するためにチームを組織し、協力して作業をするのに活用できますが、製品チームは組織の一部に過ぎません。Domoを使用すると、複数のソースからのデータを単一のプラットフォームに結合することができます。製品開発、マーケティング、セールス、運営、財務などからデータを取得し、事業全体をリアルタイムに把握することができます。\
データがDomoに取得されると、リアルタイムデータで動的なJIRAの可視化をすべてのデバイスで表示することができます。\
DomoのJIRAクラウドコネクターを使用すると、JIRAアカウントに接続してJIRAからデータを抽出することができます。カスタムクエリまたは事前定義されたクエリを使用すると、問題追跡、チームごとの完了済みチケット、チケット解決時間、プロジェクト管理メトリクスなどのデータをインポートできます。JIRA APIの詳細については、[https://developer.atlassian.com/jiradev/jira-apis/jira-rest-apis/jira-rest-api-tutorials/jira-rest-api-example-query-issues](https://developer.atlassian.com/jiradev/jira-apis/jira-rest-apis/jira-rest-api-tutorials/jira-rest-api-example-query-issues)を参照してください。

JIRAコネクターは「クラウドApp」コネクターであるため、クラウドに保管されたデータの取得が可能です。Data Centerでウィンドウ上部のツールバーで \*\*\*\*［クラウドApp］\*\*\*\*をクリックすると、これを含む他のクラウドAppコネクターのページにアクセスできます。

JIRAクラウドアカウントには、Data Centerから接続します。このトピックでは、JIRAクラウドコネクターのユーザーインターフェースに固有のフィールドとメニューについて説明します。DataSetの追加や更新スケジュールの設定、DataSet情報の編集に関する一般的な情報は、「[データコネクターを使用してDataSetを追加する](/s/article/360042926274)」を参照してください。

|                                   |                                                                                                                    |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| ****主な使用事例****                    | - チケットの進捗や動向の追跡 - 特定のユーザーやグループにアサインされたチケット数 - オープンである特定のタイプのチケット（バグ）が多すぎないか確認                                      |
| ****主なメトリクス****                   | - バグ、問題、またはチケットの追跡（経過時間、タイプ、ステータス、提出者により分類） - チームごとの完了済みチケット - チケット解決時間 - プロジェクト管理メトリクス（プロジェクトやエピックに含まれる個々のタスクを追跡） |
| ****社内における主な権限****                | 製品マネージャー                                                                                                           |
| ****平均導入時間****                    | 実装の形態や、JIRAシステムに関するユーザーの知識レベルにより大きく異なります。                                                                          |
| ****使いやすさ（1～10段階。1が「最も使いやすい」）**** | 7                                                                                                                  |

## ベストプラクティス

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

## 必要条件

JIRAクラウドアカウントに接続してDataSetを作成するには、以下が必要です。

* JIRAクラウドアカウントのドメイン（JIRAサーバーアカウントはOAuthではサポートされていません）。

JIRAのクラウドコネクターで、JIRAアカウントオンラインでログインするのと同じ認証情報で認証することができます。

## JIRAクラウドアカウントに接続する

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

### 認証情報ペイン

このペインには、（サードパーティツール）アカウントにアクセスする認証情報の入力フィールドが含まれています。下表では、各フィールドに必要な内容を説明しています。

| フィールド | 説明                                                     |
| ----- | ------------------------------------------------------ |
| ドメイン  | JIRAクラウドアカウントのドメインです。JIRAサーバーアカウントはOAuthではサポートされていません。 |

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

### ［詳細］ペイン

このペインには、メインの\*\*［レポート］\*\*メニュー、および選択したレポートタイプに応じて表示/非表示になるその他様々なメニューがあります。

#### JIRA問題データを取得する

****［JIRA問題データの取得］**** を選択した場合、JQLクエリビルダーが画面に表示されます。ほぼすべてのJIRAチケットパラメーターに対する列を返す、JIRAクエリを作成できます。パラメーターには、問題の概要や説明、作成日、解決日、影響があった顧客名、および環境などが含まれます。JIRA でJQLクエリを作成し、クエリビルダーに貼り付けることもできます。

JQLクエリビルダーは、JIRAフィールドや値をオートサジェストするため、簡単にJQLクエリを作成できます。

クエリビルダーの右側に提案されたクエリから、選択することもできます。提案されたクエリをクリックするだけで、JQLクエリビルダーに自動入力されます。必要に応じて、後からクエリを編集できます。

クエリの例を1つ、以下に示します。

`(issuetype = Bug OR issuetype = defect OR issuetype = Improvement) AND status != Closed ORDER BY createdDate DESC`

このクエリは、バグ、欠陥、改善として分類されるすべての未解決の問題を取得し、作成日ごとに分類します。

JQLクエリ記述の詳細については、[https://confluence.atlassian.com/display/JIRA/Advanced+Searching](https://confluence.atlassian.com/display/JIRA/Advanced+Searching)を参照してください。

##### JIRA問題レポート

カスタムクエリを作成せず、既成のレポートを取得したい場合は、****［レポートを選択］**** タブを展開して、必要なレポートタイプを選択します。以下のレポートが利用できます。

| レポート           | 説明                                                             |
| -------------- | -------------------------------------------------------------- |
| コメントレポート       | 関連するコメントを持つJIRAチケットを返します。                                      |
| チェンジログレポート     | クエリに該当する問題に関するチェンジログを返します。                                     |
| ラベルレポート        | クエリに該当する問題のラベルを返します。                                           |
| リンクされた問題のレポート  | クエリに該当する問題にリンクされた問題を返します。                                      |
| スタンダードチケットレポート | JIRAチケットのほぼすべてのパラメーター（問題サマリ、説明、作成日、解決日、影響のあった顧客名、環境など）の列を返します。 |
| チケット履歴レポート     | チケットの履歴情報を返します。                                                |
| ワークログレポート      | クエリに該当する問題に関するワークログを返します。                                      |

#### JIRA管理者データを取得する

多くのJIRA管理者レベルレポートにアクセスできます。カスタムクエリを作成したい場合は、代わりに\*\*\*\*［JIRA問題データ］\*\*\*\*を選択します。

以下のレポートが利用できます。

| レポート        | 説明                                                     |
| ----------- | ------------------------------------------------------ |
| フィールド       | ユーザーのJIRAアカウントで使用するフィールドのリストを返します。                     |
| グループメンバー    | 指定されたグループに属するユーザーのリストを返します。このレポートを実行するには管理者アクセス権が必要です。 |
| プロジェクト      | ユーザーがアクセスするプロジェクトすべてのリストを返します。                         |
| プロジェクトバージョン | 指定したプロジェクトのバージョンすべてのリストを返します。                          |
| ユーザーグループ    | すべてのユーザーのグループのリストを返します。                                |

### その他のペイン

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

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

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