外部連携: Jira, Azure DevOps, GitHub Issues, Slack, Teams, Telegram
Nexus StudioQAは、Jira Cloud, Azure DevOps, GitHub Issues, Slack, Microsoft Teams, Telegramの6つのサービスと連携します。いずれも有効にするまで無効のままで、当社のサーバーを経由せず、お使いの端末から直接接続します。このページでは、各連携の機能、読み取るキー、そして決して行わないことを説明します。
最終更新日:
執筆:Verdict System LLC、Nexus StudioQAチーム。2026年10月9日。
各連携の仕組み
- 有効にするまで無効のままです。各サービスには個別の切り替え設定があります。
JIRA_ENABLED、AZURE_BOARDS_ENABLED、GITHUB_ISSUES_ENABLED、SLACK_ENABLED、TEAMS_ENABLED、TELEGRAM_ENABLEDです。初期値はすべてfalseです。 - お使いのマシンから直接送信。 エンジンは、テストを実行するマシンから各サービスのAPIを直接呼び出します。弊社のサーバーを経由することは一切なく、課題、アラート、テスト結果が弊社に閲覧されることもありません。
- キーはワークスペース内に保持。 トークンやキーは、ローカルディスク上のワークスペース内にある
.envファイルの行として保存されます。連携の設定画面からこれらを編集でき、すべてのトークン、キー、Webhookは伏字で表示されます。 - サンドボックス実行は除外。 サンドボックス実行は作成中のテストであり、確定した結果ではありません。課題の作成、コメント、クローズを行うことはありません。
テストが失敗し続ける限り、テストごとに1つの課題を保持
Jira、Azure Boards、GitHub Issuesは同じライフサイクルに従い、チケット設定で各段階を変更できます。課題は実行ではなくテストに紐づくため、毎晩失敗するテストでも、毎晩新しい課題が作られるのではなく、1つの課題に履歴が蓄積されます。
- 最初の失敗で1つの課題を作成。 実行結果がBREACHED、BREACHED_FLAKY、CHAOS_BREACHED、またはTIMEOUTとなった場合、そのテストに対してエラー情報と失敗時のスクリーンショットを添付した課題が1つ作成されます。
- 再度の失敗時にはコメントが追加されます。該当の課題がオープンの間は、次の失敗時に新しいスクリーンショットが添付されたコメントが追加されます。2つのブラウザで同時に失敗した場合は、同じ課題に追加されます。
- 完全にパスすると課題はクローズされます。実行されたすべてのブラウザでテストが完全にパスすると、その旨を伝えるコメントが課題に追加され、完了ステータスへと移行します。ワークフローに該当するトランジションやステータスがない場合は、コメントのみが追加されます。
- その後の失敗では新しい課題が起票されます。課題が削除された場合や移動された場合の失敗でも同様です。
添付ファイル:デフォルトではスクリーンショットのみとなります。Playwrightのトレースと実行ログは、Cookieや認証ヘッダー、入力されたパスワードなどのセッションデータが含まれる可能性があるため、設定で NEXUS_ISSUE_ATTACH_TRACE=true をオプトインした場合にのみ添付されます。各ファイルは最大 10 MB まで添付されます。
FLAKY(不安定)によって起票されることはありません。失敗した後にリトライでパスした実行はバグではないためです。BLOCKED、UNREACHABLE、CRASHED、または設定エラーも同様で、これらはアプリケーションではなく環境に起因するものです(判定基準の詳細)。どの課題がどのテストに属しているかは、ワークスペース内の evidence/integrations/issue-map.json で管理されます。
手順別ガイド
各ガイドでは、必要なもの、認証情報の取得方法、動作の確認方法を説明し、よくあるエラーとその原因、対処方法を紹介しています。
失敗の通知先がさらに充実
さらに5つの通知先が、上記のサービスと同じルールで利用できます。いずれも有効にするまではオフのままで、お使いのマシンからご自身のキーで直接接続します。
- Linear: 選択したチームに、失敗したテストごとに課題を1件作成します。再び失敗するとコメントを追加し、問題なく成功すると最初の完了ステータスに移動します。キー:
LINEAR_ENABLED、LINEAR_API_KEY、LINEAR_TEAM_ID。 - GitLab Issues: GitLabプロジェクトで同じライフサイクルに従い、問題なく成功すると課題をクローズし、再発すると再オープンします。キー:
GITLAB_ISSUES_ENABLED、GITLAB_ISSUES_TOKEN、GITLAB_ISSUES_PROJECT。トークンはhttps経由でのみ送信されます。 - PagerDuty: 失敗するとインシデントを作成し、再び失敗すると同じインシデントに追記し、問題なく成功すると解決済みにします。キー:
PAGERDUTY_ENABLED、PAGERDUTY_ROUTING_KEY。 - Opsgenie: アラートとして同じライフサイクルに従い、問題なく成功するとクローズします。キー:
OPSGENIE_ENABLED、OPSGENIE_API_KEY。 - TestRail: テスト内の
// nexus:testrail C123コメントで指定したケースに、各実行の結果を報告します。キー:TESTRAIL_ENABLED、TESTRAIL_URL、TESTRAIL_USER、TESTRAIL_API_KEY、TESTRAIL_PROJECT_ID。
根本原因でグループ化はチケット設定のルールで、デフォルトではオフです。有効にすると、未解決の課題がすでにあるテストと同じエラーで失敗した場合、新たな課題を作成せず、その課題にコメントを追加します。また、グループ化されたテストが問題なく成功しても、元のテストの課題がクローズされることはありません。
AIアシスタントに手順を案内してもらう
どのAIアシスタントでも、これらのガイドに沿って手順を案内できます。ガイドのアドレス、またはintegrations-guide.jsonのアドレスを伝えてください。このファイルには、すべてのキー、有効な形式、確認方法、および各エラーの原因と対処方法が記載されています。
- トークン、キー、パスワード、Webhook URLは絶対にチャットに貼り付けないでください。認証情報を入力するのは、Studioの「設定」の「連携」だけです。アシスタントに認証情報を渡す必要はありません。
- 伝えるのは機密ではない情報だけにしてください: サイトのアドレス、プロジェクト名、Studioに表示されるエラー行の正確な内容です。
- 接続できたかどうかは、Studio自体の確認機能で判断してください。接続が機能するかどうかを示すのは、アシスタントではなく、「接続を確認」、「テストメッセージを送信」、「テストチケットを作成」の結果です。
- すでに認証情報をチャットに貼り付けてしまった場合は、そのサービスで認証情報を失効させ、新しく作成してください。
Jira Cloud
- 接続:Atlassianアカウントのメールアドレスと、id.atlassian.com で作成したAPIトークンを使用します。設定のIntegrationsで、お使いのJiraサイトの任意のリンクを貼り付けてください。Studioがサイトとプロジェクトキーを保持します。サイトアドレスである
JIRA_BASE_URLは https である必要があります。Check connectionを実行するとテストが行われ、データは作成されません。 - 課題:上記で説明したライフサイクルに従い、
JIRA_PROJECT_KEY内にBugが起票されます。完全にパスすると、課題はJIRA_DONE_TRANSITIONで指定されたトランジション(デフォルトは Done、大文字・小文字を問わず名前で一致)を経て移動します。 - 重複防止:過去24時間以内に同じ要約のBugが作成されていた場合、2件目は起票されません。
- 複数のJiraサイト: チケットの別のJiraサイトを追加で、サイト、プロジェクトキー、課題タイプを個別に指定した送信先を追加できます。有効な送信先ごとにチケットが作成されます。サイトにはAtlassian Cloudのアドレス https://<name>.atlassian.net を指定する必要があり、同じアカウントのすべてのサイトで、1つのAtlassianメールアドレスとAPIトークンを使用します。トークンは、指定したサイトにのみ送信されます。
- 手動対応:必要に応じて、Evidence LockerからJiraに失敗を送信することも可能です。
Azure DevOps:Boards、Test Plans、Pipelines
AZURE_DEVOPS_ORG_URL(https://dev.azure.com/<org> または https://<org>.visualstudio.com)と AZURE_DEVOPS_PROJECT に設定する、1つの個人用アクセストークン(PAT)と1つのプロジェクトが必要です。PATはAzure DevOps自体のホストにのみ送信され、ログ行に出力されることは決してありません。設定の Integrations で Connect Azure DevOps を実行すると、プロジェクトと作業項目タイプがチェックされ、データは作成されません。
- Azure Boards:
AZURE_BOARDS_ENABLED=trueの場合、失敗すると上記のライフサイクルに従ってAZURE_BOARDS_WORK_ITEM_TYPE(デフォルトは Bug)タイプの作業項目が開かれます。問題なく成功すると、AZURE_BOARDS_DONE_STATE(デフォルトは Resolved)の状態に移行します。その状態を受け入れないプロセスにはコメントのみが追加されます。PAT には Work Items(Read & write)が必要です。Evidence Locker から手動で失敗を Azure Boards に送信することもできます。 - Azure Test Plans: CI/CD 画面で生成される
azure-pipelines.ymlは、PublishTestResults@2タスクを使用して実行の JUnit XML を公開するため、すべてのパイプライン実行が Test Plans の Runs の下に表示されます。 - Azure Pipelines:
nexus ci-remote --provider=azureはAZURE_PIPELINE_IDのパイプラインの実行をキューに入れ、完了を待機し、その JUnit XML をこのマシンに持ち帰ります。これには PAT に Build(Read & execute)が必要です。
GitHub Issues
- 接続: 1つのリポジトリに対してIssuesの読み取りと書き込み権限を持つ、権限を細かく設定できる個人アクセストークンを
GITHUB_ISSUES_TOKENに設定し、リポジトリをowner/repo形式でGITHUB_ISSUES_REPOに設定します。設定の連携にあるGitHub Issuesに接続には、トークンの所有者が表示され、トークンでアクセスでき、Issuesが有効なリポジトリのみが選択肢として表示されます(手順ガイド)。 - 課題:
GITHUB_ISSUES_ENABLED=trueの場合、失敗時にチケットのラベルを付けた課題が作成され、上記のライフサイクルに従って処理されます。問題なく成功すると、課題にコメントが追加され、完了として閉じられます。 - 別のリポジトリ: チケットでは、GitHubの送信先に
.envとは異なるowner/repoを指定できます。
Slack
- 接続:
SLACK_WEBHOOK_URLに Incoming Webhook URL を1つ設定します。設定には テストメッセージを送信 ボタンがあります。 - 取得内容: Block Kit メッセージ: 実行の概要、および
NEXUS_SLACK_NOTIFY=trueの場合は失敗、不安定(flaky)、カオス、またはビジュアルリグレッションのテストごとに1つのメッセージが届きます。失敗に関するメッセージには、Jira の課題がある場合にそのリンクが含まれます。 - 手動: Evidence Locker から失敗のテキストサマリーを Slack に投稿できます。Slack にはファイルは送信されません。
Microsoft Teams
- 接続: チャネル用のWorkflows Webhook URLを1つ、
TEAMS_WEBHOOK_URLに設定します。Teams WorkflowsにはMicrosoft 365の職場または学校アカウントが必要です。設定には保存 & テスト送信があります(手順ガイド)。 - 受信する内容: Slackと同じメッセージをAdaptive Cards形式で受信します。実行結果の概要に加え、
NEXUS_TEAMS_NOTIFY=trueの場合は、失敗したテスト、結果が不安定なテスト、カオステスト、表示の回帰テストごとに1件のメッセージが届きます。 - URLの送信先: Microsoft自身のWebhookホスト(logic.azure.com, webhook.office.com, api.powerplatform.com)上のhttpsアドレスにのみ送信します。それ以外のURLは拒否され、何も送信されません。
Telegram
- 接続: @BotFather で一度作成した独自のボットを
TELEGRAM_TOKENに設定します。設定の QR で接続 を使用すると、チャットがペアリングされ、TELEGRAM_CHAT_IDが入力されます。共有ボットはありません。 - 取得内容: 失敗時のアラート(
NEXUS_TELEGRAM_NOTIFY=trueの場合はテストごとに1つ)、および Studio から共有するように選択したレポートとファイルです。 - 有効にする前に: Telegram はレポートや PDF などのファイルを受信でき、それらは Telegram のサーバーに送信されます。規制対象の環境では、まずコンプライアンスチームにご確認ください。
チケット: 作成のタイミング、記載内容、送信先
設定の連携にあるチケット画面で、テスト失敗時に Jira、Azure Boards、GitHub Issues に登録する内容を設定します。Evidence Locker の共有機能も同じテンプレートを使用します。設定は作業領域の nexus-tickets.config.json に保存されます。このファイルに機密情報は含まれないため、リポジトリで管理できます。ファイルがない場合、チケットは上記の説明どおりに動作します。ファイルが無効な場合は既定値が適用され、理由がログに記録されます。
- 作成条件: チケットを作成する判定結果(既定では BREACHED と TIMEOUT)、作成までの連続失敗回数、実行ごとの作成上限、対象の実行環境(ローカル、CI、または両方)、対象に含めるテスト ID と除外するテスト ID、問題なく合格した場合の処理(クローズ、コメントのみ、または何もしない)、失敗が再発した際に新規チケットを作成せず、クローズ済みのチケットを再開するかどうかを指定します。
- 内容:
{type}、{testId}、{browser}、{error.firstLine}を使ってタイトルのテンプレートを指定します。タイトルは24時間以内の重複を判定するキーとなるため、{testId}は必須です。また、送信する説明の各項目とその順序、エラーの記載範囲、ラベル、判定結果ごとの優先度、担当者、コンポーネント、カスタムフィールド、チーム向けのメモも指定します。 - 添付ファイル: 既定ではスクリーンショットが添付されます。トレース、動画、レポートは選択した場合のみ添付され、それぞれにサイズ上限が適用されます。
- 送信先: 課題管理ツールごとに送信先を1つ指定し、それぞれ個別に有効・無効を切り替えられます。送信先では、Jira のサイト、プロジェクト、課題の種類、GitHub のリポジトリ、Azure の作業項目の種類を上書きできます。
- プレビューとテスト: 保存前に、直近の失敗から作成されるチケットが送信先ごとに画面に表示されます。テストチケットを作成を選ぶと、その内容で実際のチケットが1件登録され、
nexus-testラベルが付けられます。
チケットに含まれないもの
- 選択したものだけを送信します。選択しなかった項目や添付ファイルは、お使いの端末にとどまります。
- 機密情報は事前にマスクされます。すべてのテキストは、登録前に行ごとに機密情報を伏せる処理を通ります。対象は、認証ヘッダーと Cookie ヘッダー、Bearer トークンと Basic トークン、JWT、既知のプロバイダーのキー形式、URL 内のパスワード、機密情報を示す名前のフィールドの値です。ログやエラーによく現れる形式の機密情報は検出しますが、自由記述のテキストに含まれうるあらゆる機密情報を検出できるわけではありません。そのため、必要な場合を除き、トレースは無効のままにしてください。
- ファイルにトークンは含まれません。
nexus-tickets.config.jsonでは、機密情報を示す名前のフィールドや、ユーザー名とパスワードを含む URL はすべて拒否されます。トークンは.envに保持されます。
キー
すべてのキーはワークスペースの .env の1行に対応しています。設定画面ですべて編集できます。
| サービス | キー | デフォルト |
|---|---|---|
| Jira Cloud | JIRA_ENABLED, JIRA_BASE_URL, JIRA_EMAIL, JIRA_API_TOKEN, JIRA_PROJECT_KEY, JIRA_DONE_TRANSITION | オフ、プロジェクト QA、トランジション Done |
| Azure DevOps | AZURE_BOARDS_ENABLED, AZURE_DEVOPS_ORG_URL, AZURE_DEVOPS_PROJECT, AZURE_DEVOPS_PAT, AZURE_BOARDS_WORK_ITEM_TYPE, AZURE_BOARDS_DONE_STATE, AZURE_PIPELINE_ID | オフ、タイプ: バグ、状態: 解決済み |
| GitHub Issues | GITHUB_ISSUES_ENABLED, GITHUB_ISSUES_REPO, GITHUB_ISSUES_TOKEN | オフ |
| 課題の添付ファイル | NEXUS_ISSUE_ATTACH_TRACE | オフ: スクリーンショットのみ |
| Slack | SLACK_ENABLED, SLACK_WEBHOOK_URL, NEXUS_SLACK_NOTIFY | オフ |
| Microsoft Teams | TEAMS_ENABLED, TEAMS_WEBHOOK_URL, NEXUS_TEAMS_NOTIFY | オフ |
| Telegram | TELEGRAM_ENABLED, TELEGRAM_TOKEN, TELEGRAM_CHAT_ID, NEXUS_TELEGRAM_NOTIFY | オフ |
パイプラインでは、AZURE_PIPELINE_ID 以外の同じキーがパイプラインのシークレット変数となり、設定されていないキーに対応するサービスはオフのままになります(CI/CD におけるシークレット)。
ご質問
Nexus StudioQA は私の Jira や Azure DevOps のデータを閲覧しますか?
いいえ。エンジンは、お使いの端末からご自身のキーでJira, Azure DevOps, GitHub Issues, Slack, Teams, Telegramと通信します。当社のサーバーを経由することは一切ありません。
フレキーテスト(不安定なテスト)によってチケットが作成されますか?
いいえ。FLAKY では何も作成されません。BREACHED_FLAKY では作成されます。失敗自体に再現性がなく、再試行してもそれが隠蔽されないためです。
あるテストが今週 30 回失敗しました。作成される課題は何件ですか?
1 件です。初回の失敗以降の各失敗に対してコメントと最新のスクリーンショットが追加され、すべてのブラウザでテストが正常にパスするまで継続します。
Jira、Azure Boards、GitHub Issues を同時に使えますか?
はい。それぞれがテストごとに個別の課題を管理します。追加した Jira サイトも同様です。