Jira Cloud for Sheets の使用

Jira Cloud for Sheets enables you to import Jira data into your spreadsheets with Jira filters or JQL (Jira Query Language).

Your G Suite admin must enable access to Google Sheets add-ons for all users to use the integration. Learn more about turning on a G Suite marketplace app for all users.

Add the Jira Cloud add-on to Google Sheets

To add the Jira Cloud add-on to Google Sheets:

  1. Go to a Google Sheets spreadsheet.

  2. Select Add-ons > Get add-ons.

  3. Search for Jira Cloud for Sheets.

  4. Hover the app and then click +Free.

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

Connect your Jira Cloud site with Google Sheets

To connect your Jira Cloud site with Google Sheets:

  1. Go to a Google Sheets spreadsheet.

  2. Select Add-ons > Jira Cloud for Sheets > Open….

  3. Click CONNECT. This will open a new browser window.

  4. Select the site you want to add from the list of available sites.

  5. Click Accept.

 

Import data from Jira

Import issues to your spreadsheet with the following methods.

To import data from Jira using JQL

  1. Go to a Google Sheets spreadsheet.

  2. Click on Add-ons > Jira Cloud for Sheets > Open … > Get data from Jira.

  3. Specify the JQL for the query you want to run. You can click on the OPEN IN JIRA link to open and test the JQL query in Jira. If you don’t write a specific JQL query the system will import all issues on your site.

  4. Click GET DATA.

To import data from Jira using filters

Your filter must be a Starred Filter to import to a spreadsheet.

  1. Go to a Google Sheets spreadsheet.

  2. Click on Add-ons > Jira Cloud for Sheets > Open … > Get data from Jira.

  3. Select the FILTERS tab.

  4. Choose your filter from the list of available filters.

  5. Click GET DATA. You can restrict the number of rows returned with Max Rows.


JIRA() custom function with JQL

Only owners of the document can enable the JIRA() custom function with JQL. When enabled, this function uses the document owner’s configured site and Jira account to query Jira.

Anyone who can edit the document can use the function to import Jira data using the document owner’s Jira account.

To import data from Jira using the JIRA() custom function with JQL:

  1. Go to a Google Sheets spreadsheet.

  2. [アドオン] > [Jira Cloud for Sheets] > [Open…] > [Settings] の順にクリックします。

  3. Click Enable = JIRA() function for users of this sheet.

  4. Read the warning and accept.


Troubleshooting and workarounds

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

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

 

多数の課題を取得しようとするとアドオンからエラーが返される

アドオンのクエリでは最大 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

 

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

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.

 

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

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

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

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


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

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

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

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

For advanced use cases

Jira Cloud API で返されるデータ構造を把握している場合、サブフィールドを抽出することもできます。たとえば、課題の ID と報告者の表示名のみが必要な場合、JIRA() カスタム関数で次のような引数を使用できます。

=JIRA("project=MYP","issueType.id,reporter.displayName")

 

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

You can uninstall the add-on by click on Add-ons > Manage Add-ons > Manage >  Remove.

 

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

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


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

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


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

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

  1. Click on Add-ons → Jira Cloud for Sheets → Open

  2. Click on on the Disconnect site button

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


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

Yes. We also don't store any personal user information. Read more in our migration guide.

その他のヘルプ