ページを選択

手動での Jira 統合設定

Atlassian 社より TestRail 開発元である Gurock 社に潜在的な問題の可能性に関する指摘がございました。
TestRail では Jira 統合 (欠陥プラグイン/参照プラグイン) にAtlassian API トークンを利用しており、今回の指摘はこのトークンの利用に起因していると想定されます。
詳細はこちらをご確認ください。

TestRail と Jira をすばやく統合するには、[管理] > [統合] をクリックし、TestRail の管理エリアから統合ウィザードを使用することを推奨します。

各 Jira 構成との統合をセットアップする方法の詳細については、以下のリンク先を参照してください。

手動で統合を設定することもできます。このトピックでは、TestRail と Jira を手動で統合する方法 (Jira Server と Jira Cloud の両方) を説明します。

TestRail と Jira を統合するには、現在 4 つの方法があります。

    • 欠陥 URL を使用してテスト結果を Jira にリンクする
    • 欠陥プラグインを使用して、TestRail で直接 Jira の新規課題を作成したり、課題の詳細を参照したりする
    • 参照 URL を使用してテスト ケースを Jira にリンクする
    • 参照プラグインを使用してリンクされた課題の詳細を TestRail で直接参照する

リストされている統合オプションをすべて使用する必要はなく、統合を他のツールと組み合わせることができます。統合の設定には通常数分しかかかりません。このガイドでは、統合の設定方法と機能について説明します。

TestRail では、すべてのプロジェクト用にグローバルな Jira インスタンスを指定することも、プロジェクトごとに Jira インスタンスを指定することもできます。[管理] > [プロジェクト] で、プロジェクトごとに統合パラメーターを上書きできます。

欠陥 URL

欠陥 URL は、TestRail に Jira インスタンスへのアクセス方法を知らせるために使われます。

[欠陥] フィールド用に Jira の URL を設定するには、[管理] > [統合] をクリックします>。

次の URL の例を使用してアドレスを設定します。

Jira Cloud

URL 統合タイプ URL
欠陥表示 URL https://<yoursubdomain>.atlassian.net/browse/%id%
欠陥追加 URL https://<yoursubdomain>.atlassian.net/secure/CreateIssue!default.jspa

Jira Server または Data Center

URL 統合タイプ URL
欠陥表示 URL http://<your.server.address>/jira/browse/%id%
欠陥追加 URL http://<your.server.address>/jira/secure/CreateIssue!default.jspa

欠陥 URL が設定されると、[結果の追加] ダイアログの [欠陥] フィールドの横に新しく [追加] リンクが表示されるようになります。このリンクを使用すると、Jira の [Create Issue ] フォームにジャンプして新しいバグをレポートできます。

さらに、入力された課題 ID は自動的に Jira のインスタンスにリンクされるため、課題のステータスを簡単に追跡できます。

参照 URL

参照 URL は、[参照] フィールドを介してテストケースと Jira に保存されている課題をリンクするために使用されます。URL を設定すると、[参照] フィールドに入力された課題 ID が Jira インスタンスにリンクされ、関連する課題、機能仕様、または要件に簡単にジャンプできるようになります。

[参照] フィールド用に Jira の URL を設定するには、[管理] > [統合] > [参照] をクリックします。

次の URL の例を使用してアドレスを設定します。

Jira Cloud

URL 統合タイプ URL
参照表示 URL https://<yoursubdomain>.atlassian.net/browse/%id%
参照追加 URL https://<yoursubdomain>.atlassian.net/secure/CreateIssue!default.jspa

Jira Server

URL 統合タイプ URL
参照表示 URL http://<your.server.address>/jira/browse/%id%
参照追加 URL http://<your.server.address>/jira/secure/CreateIssue!default.jspa

URL を設定すると、テスト ケースにユーザー ストーリー課題 ID を追加できるようになります。課題 ID はリンクとして表示され、Jira に移動できます。

欠陥プラグイン

欠陥プラグインは、より深いレベルのバグ追跡システムとの統合を実装するために使うことができ、TestRailにはすぐに使える Jira 欠陥プラグインが付属しています。Jira プラグインは、Jira Cloud と Server の Jira 連携を別々に扱うために、2つのプラグインに分割されています。2019年4月29日の時点で、AtlassianはヨーロッパのGDPR規定に合わせて、JIRA Cloudでユーザ名とパスワードによる認証を廃止しました。

TestRailの場合、Jira CloudとServerの連携を異なる方法で扱う必要があることを意味します。簡単に言うと、以下になります。

    • JIRA Serverでは、「Jira REST」(Jira Server5.x、6.x、7.x、8.x 以降)プラグインを使用し、Jira ユーザ名とパスワードの組み合わせを使用して認証します。
    • Jira Cloudでは、「Jira Cloud」プラグインを使用し、Jira 電子メールアドレスと Jira のAPIトークンを使用して連携を認証します。

欠陥プラグインを設定するには、 [管理] > [統合] を選択し、[欠陥プラグイン] ドロップダウン リストから適切な Jira 欠陥プラグインを選択します。次のステップは、[設定] フィールドで、必要なすべての接続設定を設定することです。オプションとして、[管理] > [プロジェクト] でプロジェクト固有のプラグインおよび構成設定を指定できます。

欠陥プラグインが設定されると、[結果の追加] ダイアログの [欠陥] フィールドの横に新しく [プッシュ] リンクが表示されるようになります。リンクをクリックするとポップアップ ダイアログが開き、TestRail を離れることなくバグ レポートを Jira にプッシュできます。

テスト結果が追加されている場合、課題 ID の上にマウス カーソルを合わせると、Jira の課題に関する情報やステータスの詳細が表示されたウィンドウが開きます。

参照プラグイン

参照プラグインを利用すると、テスト ケース、テスト ラン、マイルストーンなどの TestRail エンティティの参照フィールドに入力された ID から追加の情報を取得できます。参照プラグインは、欠陥プラグインの設定と同じように、統合設定の [参照] タブで設定します。

プラグインは、参照 ID の上にカーソルをホバーし、TestRail で直接 Jira の課題を編集する機能をサポートしています。上で説明しているように、リンクのホバリングで表示されるフィールドをカスタマイズしたり、カスタム フィールドを追加することもできます。

すでに Jira 用の欠陥プラグインが設定されている場合、欠陥プラグインの [connection] および [hover.fields] セクションを参照プラグインの設定にコピーできます。あるいは、参照プラグインと欠陥プラグインで異なるフィールドを表示することもできます。

添付ファイル

Jira 欠陥プラグインは、Jira への添付ファイルのサブミットもサポートしています。このフィールドをオンまたはオフにできますが、カスタマイズはできません。1 つまたは複数の添付ファイルを Jira にサブミットするには、プッシュ ダイアログの添付ファイルまたは説明エリアにファイルをドラッグするか、テスト結果ダイアログまたは [欠陥] ドロップダウン メニューで [プッシュ] をクリックし、エリアをクリックしてファイル システムから添付ファイルを選択します。

その他のカスタマイズ

TestRail Server はカスタム欠陥プラグインもサポートしています。TestRail Server を使用している場合、欠陥プラグインをさらにカスタマイズし (または独自のプラグインをビルドし)、他のフィールド タイプやデータをサポートできます。詳しくはカスタム欠陥プラグインのマニュアルを参照してください。