Jira Cloud for SheetsとスプレッドシートのQuery関数を使用してJira ISSUESを集計する①

# はじめに

株式会社HRBrainでバックエンドエンジニアをしている入中です。
この記事はHRBrain Advent Calendar 2023の2日目の記事になります🎁🎁🎁

# この記事について

HRBrainでは、技術的対応の必要な問い合わせがあった際、テクニカルサポートメンバーがSlackに投稿した内容を元にJira ISSUEを自動発行するというワークフローを一部プロダクトで採用しています。
そのフローで発行された問い合わせISSUEを利用して、どういった問い合わせがどの時期に多く来ているのかを可視化したいという要望があり、以下の方法で実現しました。

# 実現方法

**①Jira ISSUESをスプレッドシートに連携する**
**②スプレッドーシートに連携したJira　ISSUESをスプレッドシートのQuery関数を使用してグラフ化する**

Jiraの[ダッシュボード](https://support.atlassian.com/ja/jira-software-cloud/docs/what-is-a-jira-dashboard/)でも[JQL](https://support.atlassian.com/ja/jira-software-cloud/docs/use-advanced-search-with-jira-query-language-jql/)や[フィルター](https://support.atlassian.com/ja/jira-software-cloud/docs/save-your-search-as-a-filter/)を使用してISSUEの集計を行うことができます。ですが、グラフに使用できるフィールド等がテンプレート化されており、可視化したい集計結果をグラフ化することができませんでした。
そこで、スプレッドシートを使用してJira ISSUESのデータを集計し、グラフ化しようと考えました。

とても簡単にできたので方法を記載していきます！！
この記事では①の方法のみを書いていければと思います。
②に関してはHRBrain Advent Calendar 2023の6日目に記述予定です。

# 完成後イメージ

![スクリーンショット 2023-11-28 23.17.14.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/421982/64f919e9-c565-2f92-a6e2-8a16ea13b9fe.png)

※上記画像の内容はテストデータを集計したものになります。

Jira ISSUESのラベルや経過時間の設定を使用して様々なグラフを表示していこうと思います。

# Jiraとスプレッドシートを簡単に同期できる【**Jira Cloud for Sheets**】

[Jira Cloud for Sheets](https://support.atlassian.com/ja/jira-work-management/docs/use-jira-cloud-for-sheets/)というアドオンをご存知でしょうか？

このアドオンを使用すれば、
- 定期的に
- 指定した条件で
- JiraのISSUESをスプレッドシートに連携

することができます。
早速インストールしてみましょう！

## Jira Cloud for Sheetsインストール方法

- Googleスプレッドシートを開き、`拡張機能` > `アドオン` > `アドオンを取得`を選択します。

![スクリーンショット 2023-11-26 15.06.52.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/421982/ecf51b67-e946-edc3-c053-adcc76e155d8.png)

検索窓で`Jira Cloud for Sheets`を入力すると、以下のようなリストがでてくるのでクリックしてインストールしてください。

![スクリーンショット 2023-11-26 15.24.42.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/421982/df89802e-86eb-a80c-110b-c0ce98a32b40.png)

インストールが完了し、再度`拡張機能`を押下すると

 ![スクリーンショット 2023-11-26 15.28.40.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/421982/cc6cb01e-d1ef-afbc-6681-12582e0f2730.png)

上記イメージのように`Jira Cloud for Sheets`が選択できるようになり、`Open`という選択肢が出るので押下し、`Get issue from Jira`を選択します。

## Jira　ISSUESを連携するための設定

### ISSUES

どいういったJiraのISSUESをスプレッドシートに連携するかを設定します。

**IMPORT TYPE**

- JQL
- BASIC
- FILTER
- =Jira()

から選択することができます。
私は基本のJQLがあれば、簡単に他のデータを作成するために使いまわしができると思い`JQL`を使用して設定を行いました。Jira画面の`プロジェクト`　>　`課題`でフィルターを設定し、JQLタブを押下すると、現在表示しているISSUESを取得するためのJQLが確認できます。

![スクリーンショット 2023-11-26 15.48.23.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/421982/e04134f3-53c7-146d-7d1f-2fc08744b30e.png)

JQL queryのフィールドにフィルター設定画面で表示されたJQLを入力します。

![スクリーンショット 2023-11-26 16.18.07.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/421982/485e86c4-3662-e941-995a-58810b14ff9c.png)

**Max issues**

最大で何件のISSUESを連携するかを設定します。

### FIELDS

**Selected fields**

ISSUEに記載されている何の項目をスプレッドシートに連携するかを設定します。

### SCHEDULE

**Schedule**
- Manually(手動)
- Hourly(毎時)
- Daily(日時)
- Weekly（週次）
- Monthly on the last Sunday（毎月最終日曜日）

上記のタイミングで同期時刻を指定することができます。

## 同期実行結果

ここまでの設定をして、同期時刻がくると、

![スクリーンショット 2023-11-26 16.14.05.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/421982/41aeba32-0cff-98c7-a1f6-323853e647e7.png)

Jiraに記載したISSUEの内容がスプレッドシートに連携されます。

# まとめ

スクリプトを書く等難しいことを何もすることなく、Jiraチケットをスプレッドシートに連携することができました。スプレッドシートに連携することでJiraのアカウントを持っていない人ともISSUEの集計結果を共有することができるようになります。

JiraのISSUESをスプシに連携したいなという要望があれば、ぜひ利用してみてください！

# 最後に

HRBrainでは一緒に働く仲間を探しています。
ぜひ、[採用サイト](https://www.hrbrain.co.jp/recruit)からカジュアル面談の申し込みお願いします🎁🎁🎁