Jira Cloud for Sheets の使用

Jira Cloud for Sheets を使用すると、既存の Jira フィルターやカスタム JQL (Jira クエリ言語) を使用して Jira データをスプレッドシートにインポートできます。

Google スプレッドシートへのインストール

Google スプレッドシートのスプレッドシートで次の操作を実行します。

1. [アドオン] > [アドオンを取得] の順に選択します。

2. Jira Cloud for Sheets を検索します。カードにカーソルを合わせて、[+Free] を選択します。

3. プロンプトに従い、アドオンに Google スプレッドシートのスプレッドシートへのアクセスを許可します。

クラウド サイトを接続する

1. Google スプレッドシートでスプレッドシートを開き、[アドオン] > [Jira Cloud for Sheets] > [開く] の順に選択します。

2. [Connect (接続)] を選択します。新しいブラウザ ウィンドウが開きます。

3. 利用可能なサイトの一覧から追加するサイトを選択し、[Accept (承認)] を選択します。

認証が完了すると、Google スプレッドシートにリダイレクトされます。

Jira からのデータのインポート

これで、Jira 作業項目をスプレッドシートにインポートできます。次のいずれかの方法を使用して、[Get data from Jira (Jira からデータを取得)] を選択します。

JQL を使用する

1. [アドオン] > [Jira Cloud for Sheets] > [開く] の順に選択します。[Get data from Jira (Jira からデータを取得)] を選択します。

2. 実行したいクエリの JQL を指定します。[Jira で開く] を選択して、Jira で JQL クエリをテストします。

3. [データを取得] を選択します。

4. Jira がクエリを実行し、該当するすべての作業項目を現在のスプレッドシートに返します。

フィルターの使用

Jira Cloud サイトでフィルターを定義済みの場合、それをスプレッドシートで使用できます。

1. [アドオン] > [Jira Cloud for Sheets] > [開く] の順に選択します。[Get data from Jira (Jira からデータを取得)] を選択します。

2. [フィルター] タブを選択します。

3. 利用可能なフィルターのリストからフィルターを選択します。

4. [データを取得] を選択します。 返される行の数を [Max Rows (最大行数)] で制限できます。

Jira がクエリを実行し、該当するすべての作業項目を現在のスプレッドシートに返します。

JQL で JIRA() カスタム関数を使用する

このアドオンにより、カスタムの Google スプレッドシート関数である "=JIRA()" が導入されます。これを使用してスプレッドシートのセルから Jira にクエリを送信できます。

1. [アドオン] > [Jira Cloud for Sheets] > [開く] の順に選択します。[設定] を選択します。

2. [Enable = JIRA() function for users of this sheet (このスプレッドシートのユーザーに対して = JIRA() 関数を有効にする)] をクリックします。

3. 表示される警告を確認して承諾します。
   
   

スプレッドシートのセルで次のように関数を使用できます。

シナリオ

ProjA プロジェクトで先週作成された作業項目を、既定の列セットを使用して取得

クエリ

=JIRA("project = ProjA and createdDate >= -7d")

シナリオ

ProjA のすべての作業項目の作業項目キー、要約テキスト、作成日時、および報告者を取得

クエリ

=JIRA("project = ProjA", "workitemkey,summary,created,reporter")

シナリオ

ProjA の最初の 10 件の作業項目を、作業項目キー、ステータスの内部 ID、名前にスペースを含むカスタム列で取得

クエリ

=JIRA("project = ProjA order by createdDate desc", "workitemkey,status.id,another column", 0, 10)

シナリオ

ProjA のすべての作業項目の作業項目キー、要約テキスト、作成日時、および報告者を取得

クエリ

=JIRA("project = ProjA", "workitemkey,summary,created,reporter")

Jira Cloud サイトを追加で接続する

Jira Cloud サイトを追加で接続するには、次の手順を実行します。

1. [アドオン] > [Jira Cloud for Sheets] > [開く] の順に選択します

2. 現在のサイトの横にあるドロップダウンを選択します。[Add another site (別のサイトを追加)] を選択します。

3. プロンプトに従い、別の Jira Cloud サイトへのアクセスをアドオンに許可します。

4. これで、インポート中にサイトを切り替えることができるようになりました。

既知の問題と回避策

=JIRA() 関数を有効化したがエラーが表示される

=JIRA() 関数を使用しているセルの値を削除して Enter キーを押します。クエリを再入力し、適切に動作するかどうかを確認します。この操作は一回のみ行う必要があります。現在、この問題を引き起こしている不具合の修正に取り組んでいます。

多数の作業項目をクエリしようとすると、アドオンからエラーが返されます。

このアドオンは、最大 10,000 件の作業項目のクエリで正常に動作するはずです。ただし、この数は、データの複雑さとサイズ、および設定によって異なる場合があります。10,000 件の作業項目を一度に読み込もうとしてエラーが発生した場合は、件数を減らしてお試しください。

さらに多くの作業項目を返す必要がある場合、=JIRA() 関数を使用すると検索結果をページ単位で表示できます。クエリで検索結果を並べ替えることをおすすめします。

たとえば 20,000 件の作業項目を返したい場合、最初の 10,000 件の作業項目を返すにはセルに次のように入力します。

=JIRA("project = ProjA order by updated desc", "", 0, 10000)

別のセルに次のように入力して、残りの 10,000 件の作業項目を返します。

=JIRA("project = ProjA order by updated desc", "", 10000, 10000)

アドオンがユーザー データを空白で返す

アドオンは個々のユーザーのプロファイル データのプライバシー設定を尊重します。ユーザーが自身のプロファイル情報を非公開にしていた場合、assignee や reporter 列では、そのユーザーに対してアドオンから空白の値が返されます。

このアドオンは、エクスポート時にいくつかの作業項目を複製します

コメント ID やステータス トランジション日など、フィールドの属性が選択されていて、作業項目に関連する値が複数ある場合 (たとえば、複数のステータス トランジション、コメントなど)、Excel は各属性の作業項目行を展開します。

この動作により、主に一度に多くの作業項目を選択した場合に、より多くのデータを取得してシートに追加する必要があるため、タイムアウトが発生する可能性があります。さらに、作業項目の上限が設定されている場合、各作業項目に複数の行が含まれる可能性があるため、返される行はこの制限を超える可能性があります。

よくある質問

Jira Cloud for Sheets ではどのような機能を利用できますか?

Jira Cloud Sheets は Google スプレッドシートで使用できるアドオンであり、これを使用することで Jira Cloud サイトのデータを次のようにインポートできます。

• JQL (Jira Query Language) に基づいた検索結果

• Jira Cloud のスター付き / 定義済みのフィルターに基づいた検索結果

スプレッドシートに入力する列はどのように指定できますか?

アドオンはデータのインポート時に Jira Cloud の列設定を使用します。アカウントやフィルターに応じて異なる列設定が行われている場合があります。Jira Cloud にユーザー / フィルター固有の列設定がない場合、アドオンは既定のシステム列を使用します。

次のように =JIRA() 関数を使用することで異なる列を指定できます。

=JIRA("project=MYP","workitemType,reporter,another column")

アドオンのアンインストール方法を教えてください

アドオンをアンインストールするには、[アドオン] > [アドオンを管理] の順に選択します。[管理] > [削除] の順に選択します。

ライセンス付与済みのアトラシアン製品を持っていない場合は、このアドオンを使用できますか?

いいえ、このアドオンを使用するには、Jira Cloud のライセンス / サブスクリプションが必要です。

このアドオンを Jira Server と使用することはできますか?

いいえ、このアドオンは Jira と Jira Service Management の Cloud サイトでのみ使用できます。ご利用の製品がクラウド製品なのかサーバー製品なのか不明な場合は、Jira 管理者にご確認ください。

接続済みの Jira Cloud インスタンスからスプレッドシートの接続を解除するにはどうすればよいですか

設定済みのすべての Jira Cloud サイトをアドオンから切断できます。スプレッドシートで次の手順を実行します。

1. [アドオン] > [Jira Cloud for Sheets] の順に選択します。[開く] を選択します。

2. [サイトを切断] を選択します。

3. ご利用の Atlassian ID のプロファイル ページに転送されます。ここで [アクセス権の削除] を選択することで、アドオン/アプリを切断できます。

このアドオンは GDPR に準拠していますか?

はい。このアドオンは個人情報を保存しません。プライバシー通知をご確認ください。