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

G Suite 管理者で、ユーザーによる Google スプレッドシート アドオンへのアクセスを許可する必要がある場合があります。詳細情報

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

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

  1. Click Add-ons then click Get add-ons…

  2. Search for “Jira Cloud for Sheets” then hover over the card and click +Free.

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

クラウド サイト / インスタンスの接続

  1. Open a Google Sheets spreadsheet and select Add-onsJira Cloud for SheetsOpen…

  2. Click CONNECT, this will open a new browser window.

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


nce the authorization is successful you’ll be redirected to your Google Sheets spreadsheet and you should see something like the following (aka the hamburger menu):

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

You can now import Jira issues to your spreadsheet by clicking on Get data from Jira and then using one of the following methods:

JQL を使用する

特定の JQL を指定しない場合、システムはすべてのプロジェクトからすべての課題をインポートします。

  1. Click on Add-onsJira Cloud for SheetsOpen … Get data from Jira

  2. 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.

  3. Click on GET DATA.

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

フィルターを使用する

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

現在、スター付きのフィルターのみがサポートされています。使用したいフィルターが Jira Cloud サイトでスター付きに設定されていることをご確認ください。

  1. Click Add-onsJira Cloud for Sheets Open … Get data from Jira

  2. Select the FILTERS tab

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

  4. Click 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. Click Add-onsJira Cloud for SheetsOpen…Settings

  2. [Enable =JIRA() function for users of this sheet] をクリックします。

  3. Read the warning and accept.
    Only owners of the document can enable this function. When enabled, this function uses the document owner’s configured site and Jira account to query 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 サイトを追加で接続するには、次の手順を実行します。

  1. Click Add-onsJira Cloud for SheetsOpen…

  2. Click on the dropdown next to your current site and click Add another site….

  3. Follow the prompts to provide access to the add-on for the additional Jira Cloud site.

  4. Now you can switch between sites during import.

既知の問題と回避策

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

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

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

アドオンのクエリでは最大 10,000 件の課題を取得できます。さらに多くの課題を返す必要がある場合、=JIRA() 関数を使用すると検索結果をページ単位で表示できます。クエリで検索結果を並べ替えることをおすすめします。

たとえば 20000 件の課題を返したい場合、最初の 10,000 件の課題を返すにはセルに次のように入力します。

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

別のセルに次のように入力して残りの 10,000 件の課題を返します。

=JIRA("project = ProjA order by updated desc", "", 10000, 10000)
アドオンがユーザー データを空白で返す

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

FAQ (参考情報)

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

高度なカスタマイズ

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

=JIRA("project=MYP","issueType.id,reporter.displayName")
アドオンのアンインストール方法を教えてください

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

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

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

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

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

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

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

  1. Click on Add-onsJira Cloud for SheetsOpen

  2. Click on on the Disconnect site button

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

最終更新日 2019 年 7 月 10 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.