Jira Cloud for Sheets の使用

Jira Cloud for Sheets lets you import Jira data into your spreadsheets using existing Jira filters, or custom JQL (Jira Query Language).

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

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

1. Select Add-ons, then Get add-ons.

2. Search for Jira Cloud for Sheets. Hover over the card, then select +Free.

3. Follow the prompts to give the add-on access to your Google Sheets spreadsheet.

Connect your cloud site

1. Open a Google Sheets spreadsheet and select Add-ons, then Jira Cloud for Sheets, then Open.

2. Select CONNECT. This will open a new browser window.

3. Select the site you want to add from the list of available sites, and select Accept.

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

Import data from Jira

You can now import Jira work items to your spreadsheet. Select Get data from Jira using one of the following methods.

JQL を使用する

1. Select Add-ons, then Jira Cloud for Sheets, then Open. Choose Get data from Jira.

2. Specify the JQL for the query you want to run. Select Open in Jira to test the JQL query in Jira.

3. Select Get data.

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

フィルターの使用

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

1. Select Add-ons, then Jira Cloud for Sheets, then Open. Choose Get data from Jira.

2. Select the Filters tab.

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

4. Select Get data. You can restrict the number of rows returned with Max rows.

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

Use the JIRA() custom function with JQL

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

1. Select Add-ons, then Jira Cloud for Sheets, then Open. Choose Settings.

2. Select Enable =JIRA() function for users of this sheet.

3. Read the warning, then accept.
   
   

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

シナリオ

Return the work items in project ProjA that have been created in the last week, using your default set of columns.

クエリ

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

シナリオ

Return all the work items in ProjA but only the work item key, summary text, the created time, and the reporter.

クエリ

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

シナリオ

Return the first 10 work items in ProjA but only the work item key, the internal id of the status, and a custom column with spaces in its name.

クエリ

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

シナリオ

Return all the work items in ProjA but only the work item key, summary text, the created time, and the reporter.

クエリ

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

Connect additional Jira Cloud sites

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

1. Select Add-ons, then Jira Cloud for Sheets, then Open.

2. Select the dropdown next to your current site. Choose Add another site.

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

4. Now, you can switch between sites during import.

Known problems and workarounds

I enabled the =JIRA() function and it's still showing me an error

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

The add-on returns an error when I want to query a large number of work items

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

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

For example, to return 20,000 work items, put this on one cell to return the first 10,000 work items:

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

And this in another cell to return the following 10,000 work items:

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

The add-on returns empty cells for user data

The add-on respects individual users' privacy settings for profile data. If a user has made their profile information private then the add-on will return a blank value for this user in columns like assignee or reporter.

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

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

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

Common questions

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")

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

You can uninstall the add-on by selecting Add-ons, then Manage Add-ons. Choose Manage, then Remove.

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

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

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

No, the add-on only works with Cloud sites for Jira and Jira Service Management. Check with your Jira administrator if you are not sure about cloud vs server.

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

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

1. Select Add-ons, then Jira Cloud for Sheets. Choose Open.

2. Select Disconnect site.

3. You’ll be redirected to your Atlassian Identity profile page where you can disconnect the add-on/app by selecting Remove access.

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

Yes, and we do not store any personal user information. Read the privacy notice.