Jira Cloud for Sheets
Jira Cloud for Sheets を使用すると、既存の Jira フィルタやカスタム JQL (Jira Query Language) を使用して Jira データをスプレッドシートにインポートできます。
G Suite 管理者で、ユーザーによる Google スプレッドシート アドオンへのアクセスを許可する必要がある場合があります。詳細情報
Google スプレッドシートへのインストール
Google スプレッドシートのスプレッドシートで次の操作を実行します。
[アドオン] をクリックして [アドオンを取得] をクリックします。
「Jira Cloud for Sheets」を検索し、カードにカーソルを合わせて [+無料] をクリックします。
プロンプトに従い、アドオンに Google スプレッドシートへのアクセスを許可します。
クラウド サイト / インスタンスの接続
Google スプレッドシートでスプレッドシートを開き、[アドオン] > [Jira Cloud for Sheets] > [Open…] の順に選択します。
[CONNECT] をクリックすると、新しいブラウザ ウィンドウが開きます。
利用可能なサイトの一覧から追加するサイトを選び、[Accept] をクリックします。
認証に成功すると Google スプレッドシートに転送され、次のような画面 (ハンバーガー メニュー) が表示されます。
Jira からのデータのインポート
これで、[Get data from Jira] をクリックしてから次のいずれかの方法を使用して Jira 課題をスプレッドシートにインポートできます。
JQL を使用する
特定の JQL を指定しない場合、システムはすべてのプロジェクトからすべての課題をインポートします。
[アドオン] > [Jira Cloud for Sheets] > [Open…] > [Get data from Jira] の順にクリックします。
実行したい JQL を指定します。[Open in Jira] リンクをクリックすると、Jira を開いてそこで JQL クエリをテストすることができます。
[GET DATA] をクリックします。
Jira がクエリを実行し、該当するすべての課題を現在のスプレッドシートに返します。
フィルターを使用する
Jira Cloud サイトでフィルターを定義済みの場合、それをスプレッドシートで使用できます。
現在、スター付きのフィルターのみがサポートされています。使用したいフィルターが Jira Cloud サイトでスター付きに設定されていることをご確認ください。
[アドオン] > [Jira Cloud for Sheets] > [Open…] > [Get data from Jira] の順にクリックします。
[FILTERS] タブを選択します。
利用可能なフィルターの一覧からフィルターを選択します。
[GET DATA] をクリックします。
返される行の数を [Max Rows] で制限できます。
Jira がクエリを実行し、該当するすべての課題を現在のスプレッドシートに返します。次の図のようになります。
JQL で JIRA() カスタム関数を使用する
このアドオンにより、カスタムの Google スプレッドシート関数である "=JIRA()" が導入されます。これを使用してスプレッドシートのセルから Jira にクエリを送信できます。
[アドオン] > [Jira Cloud for Sheets] > [Open…] > [Settings] の順にクリックします。
[Enable =JIRA() function for users of this sheet] をクリックします。
表示される警告を確認して承諾します。
この関数はドキュメントの所有者のみが有効化できます。有効化すると、この関数はドキュメント所有者が設定したサイトと Jira アカウントを Jira へのクエリに使用します。
この関数はドキュメントの所有者のみが有効化できます。有効化すると、この関数はドキュメント所有者が設定したサイトと Jira アカウントを Jira へのクエリに使用します。
JIRA() カスタム関数を有効化したスプレッドシートでは、編集権限を持つすべてのユーザーがこの関数を使用して、ドキュメント所有者の Jira アカウントとして Jira データをインポートできます。スプレッドシートを共有する際はご注意ください。
スプレッドシートのセルで次のように関数を使用できます。
シナリオ |
クエリ |
|---|---|
ProjA プロジェクトの先週作成された課題を既定の列セットを使用して取得 |
=JIRA("project = ProjA and createdDate >= -7d") |
ProjA のすべての課題の課題キー、要約テキスト、作成日時、および報告者を取得 |
=JIRA("project = ProjA", "issuekey,summary,created,reporter") |
ProjA の最初の 10 件の課題を、課題キー、ステータスの内部 ID、名前にスペースを含むカスタム列で取得 |
=JIRA("project = ProjA order by createdDate desc", "issuekey,status.id,another column", 0, 10) |
ProjA のすべての課題の課題キー、要約テキスト、作成日時、および報告者を取得 |
=JIRA("project = ProjA", "issuekey,summary,created,reporter") |
Jira Cloud サイトを追加で接続する (任意)
Jira Cloud サイトを追加で接続するには、次の手順を実行します。
[アドオン] > [Jira Cloud for Sheets] > [Open…] の順にクリックします。
現在のサイトの横にあるドロップダウンをクリックして、 [Add another site…] をクリックします。
プロンプトに従い、別の Jira Cloud サイトへのアクセスをアドオンに許可します。
これで、インポート中にサイトを切り替えることができるようになりました。