メインコンテンツへスキップ

Jira Cloudインテグレーションのセットアップ

Eva Ferreira
  • 更新

この記事では、mablワークスペースをJiraプロジェクトに接続し、mablワークスペースから直接課題の作成とリンクを行えるようにする方法を説明します。セットアップは2つのアプリケーションで行われ、通常は次の2つの役割が関わります。

  • mablワークスペースの所有者 - "Issue tracker" APIキーを作成し、mablからワークスペースIDを取得します。
  • Jira管理者 - すべてのプロジェクトにアクセスできるJira管理者が、JiraにmablアプリケーションをインストールしてmablのAPIキーとワークスペースIDを入力します。

開始する前に

Jira Cloudインテグレーションをセットアップするには、mablアプリケーションから次の情報を収集します。

  • "Issue tracker" APIキー - mablアプリケーションの [ワークスペース] > [API] で作成されます。APIキーにアクセスできるユーザーは、ワークスペースの所有者に限定されています。
  • ワークスペースID - mablアプリケーションの [ワークスペース] > [ワークスペース] にあります。

mabl Jira Cloudアプリケーションのインストール

Atlassian Marketplaceのリストでmabl Automated Testing for Jira appを探し、インテグレーションをセットアップします。

権限

mabl Jira Cloudアプリケーションをインストールできるのは、すべてのプロジェクトにアクセスできるJira管理者のみです。Jiraプロジェクト管理者やその他のユーザーには、インテグレーションをセットアップするのに十分な権限がありません。

アプリケーションの設定

アプリケーションがインストールされたら、リストまたはJiraの [Settings] > [Manage Apps] から、mabl Jira Cloudアプリケーションに対応する [Configure] ボタンをクリックします。

次のフィールドに入力して設定を完了します。

  • Name: インテグレーションの固有の名前を指定します。
  • API key: mablの "Issue tracker" APIキーを入力します。
  • Workspace ID: mablのワークスペースIDを入力します。
  • Projects: mablワークスペースで課題が作成され、リンクされる特定のJiraプロジェクトを選択します。

[+Add integration] ボタンをクリックして、インストールを完了します。

インテグレーションが正常にインストールされたことを確認するには、この記事に記載されている手順を実行して、mablアプリケーションからJira課題を作成します。

追加のワークスペースの接続

mablに複数のワークスペースがある場合、次の手順で、Jira Cloudインスタンスが追加のmablワークスペースに接続するように設定できます。

  1. 追加のmablワークスペースで、"Issue tracker" APIキーを新規作成します。
  2. 追加のmablワークスペースからワークスペースIDを取得します。
  3. mabl Automated Testing for Jiraアプリケーションページで、[Configure] ボタンをクリックします。インテグレーションに追加のワークスペースを追加できるのはJira管理者のみです。
  4. 追加のワークスペースの設定情報として、名前、"Issue tracker" APIキー、ワークスペースID、Jiraプロジェクトを入力します。
  5. [+ Add integration] ボタンをクリックします。

アプリの削除または再インストール

Jira Cloudインスタンスからmablアプリをアンインストールしたり、アンインストールして再インストールしたりすると、mablテストと既存のJira課題とのリンクが壊れることがあります。リンクの記録を残しておきたい場合は、インテグレーションを削除する前に、mablアプリの [テスト] > [イシュー] から課題をCSVファイルとしてエクスポートできます。アプリを再インストールして再設定した後、影響を受けたテストをJira課題に再度リンクしてください。

以前のバージョンのアプリからのアップグレード

バージョン2.x以前のmabl Jira Cloudアプリケーションは、Atlassianが提供を終了するAtlassian Connect上で動作しています。2027年1月31日までにバージョン4.xにアップグレードしてください。この日を過ぎると以前のバージョンは動作しなくなり、アップグレードするまでmablからJira課題を作成したりリンクしたりできなくなります。

アップグレードは、組織管理者またはサイト管理者がAtlassian Administrationで承認します。Apps > Sites でサイトを選択し、Connected apps を開きます。mablアプリは mabl: Automated Testing with Jira & Rovo という名前で表示されます。Update ラベルが表示されている場合、サイトは以前のバージョンを使用しているため、アップグレードが必要です。

Connected appsで Update ラベルが表示されているmablアプリ

アプリの詳細を開きます。アプリのバージョンが間もなくサポートされなくなるプラットフォームで動作していることを示すバナーが表示され、Version には現在のバージョン(2.8.0など)が Outdated として表示されます。Update を選択し、新しい権限を確認してから、もう一度 Update を選択します。

Update ボタンとサポート終了のバナーが表示されたmablアプリの詳細ページ

詳しい手順については、Atlassianの記事Manage an installed appをご覧ください。

アップグレードにより、アプリのJira権限が次のように変わります。

  • 削除: read:connect-jira、write:connect-jira
  • 追加: read:jira-work、write:jira-work、read:jira-user、read:app-user-token、read:app-system-token

インテグレーションの設定、接続済みのワークスペース、リンク済みの課題はそのまま引き継がれます。

関連記事