トラブルシューティング
別のマシンで失敗するテスト、見つからない要素、読み取れないテキスト: その対処法。
まず実行の信頼度レポートを開いてください: どのステップがなぜ失敗したかを、わかりやすい言葉で伝えます。そのうえで、以下から問題を探してください。
実行が不合格になる
「見つかりません」と出るが、要素は画面に見えている
この順に試してください
- 1この画面の解像度と表示の拡大縮小が記録時と同じか確認してください。要素は記録されたサイズで比較されます。
- 2要素が検索範囲の外に移動したのかもしれません。範囲を広げるか、「画面全体を検索」にチェックを入れてください。
- 3ビジュアルターゲットに、カウンターやハイライトなど変化するものが含まれているのかもしれません。四角形を小さく描き直し、変化しない部分だけを囲んでください。
- 4画面が現れるまでに時間がかかるのかもしれません。アサーションのタイムアウトを延ばしてください。
自分のコンピューターでは合格するのに、別のコンピューターでは不合格になる
この順に試してください
- 1両方のコンピューターの画面解像度と表示の拡大縮小を比べてください。これが最も多い原因です。
- 2テーマ (ライトかダークか)、ブラウザーとそのズームレベル、アプリの言語を比べてください。
- 3どちらの見た目も正しいなら、環境ごとのベースラインプロファイルで両方を保持してください。Web アプリの別のブラウザーやデバイスには、代わりにそれ向けのテストのバージョンを生成してください。
アサーションが不合格になるが、2 枚の画像は同じに見える
この順に試してください
- 1レポートをパルス表示か差分表示に切り替えてください: どちらも変わった箇所を光らせます。1 文字や 1 桁の数字であることがよくあります。
- 2AI スマート分析がオンなら、その判定と、何が変わったかの説明を読んでください。
- 3差異が本物でも無害なら、アサーションの厳密さを「緩和」に設定するか、新しい見た目を採用してください。
クリックが間違った場所に落ちる
この順に試してください
- 1クリックの直前にアサーションがあることを確かめてください: クリックは、要素が見つかった場所にどこへでも付いていきます。
- 2ウィンドウが記録時と同じ場所に、同じサイズであるか確認してください。
- 3表示の拡大縮小を確認してください: 拡大縮小が変わると、画面上のすべての位置が変わります。
日付、合計、注文番号でテストが不合格になる
まだ表示途中だった画面でアサーションが不合格になる
テストが遅い
この順に試してください
- 1固定の待機をアサーションに置き換えてください: アサーションは画面の準備ができた瞬間に先へ進みます。
- 2検索範囲を小さくしてください: 小さな範囲の方が速く検索できます。
- 3コンピューターにグラフィックスカードがあれば、環境設定でオンにしてください。
テキストアサーション
テキストが読み取られない、または誤って読み取られる
この順に試してください
- 1アサーションで「自動」の代わりにテキストの言語を選んでください。特に短い単語に有効です。
- 2認識品質を「最高」に設定してください。
- 3検索範囲をテキストより少し大きく描き、文字が端に触れないようにしてください。
- 4一致精度は「許容」のままにしてください: 似た形の文字や間隔の違いを許します。
記録と保存
記録の保存に時間がかかる
この順に試してください
- 1それは正常です: 保存の時点で、使った要素ごとに 1 つ、表示された内容に対して 1 つずつ、アサーションが作られます。「テキストを検証」がオンの長い記録が最も時間がかかります。進行状況バーが各段階を示します。
スマートフォンが見つからない
この順に試してください
- 1スマートフォンの開発者向けオプションで USB デバッグをオンにしてください。
- 2データ転送用のケーブルを使ってください: 充電しかできないケーブルもあります。
- 3スマートフォンのロックを解除し、このコンピューターについて尋ねられたら「許可」をタップしてください。
実行が始まらない: 画面がテストの開始位置にない
この順に試してください
- 1記録開始時に表示していたページと状態にアプリを戻してから、「再試行」をクリックしてください。
- 2違いが問題にならないなら、「そのまま実行」をクリックしてください。
- 3このコンピューターでこの比較を省くには、環境設定の「全般」ページでオフにしてください。
ブラウザーまたはデバイスに注意が必要
この順に試してください
- 1「ブラウザーとデバイス」パネルから、そのブランチを GUI Test Studio で開いてください。実行できなかったステップには琥珀色の角が付き、「プロパティ」パネルがその理由を示します。
- 2その画面でページが隠している要素、つまり GUI Test Studio が開けなかったメニューの裏にある要素が、よくある原因です。そのブランチでステップを修正するか、その部分を記録し直してください。
- 3ページを変更した後は、ブランチを再生成してください。
テストが間違ったモニターで実行される
この順に試してください
- 1テストは GUI Test Runner-Recorder があるディスプレイで実行されますが、別のモニターで記録されたか、プロジェクト設定でモニターが指定されている場合は別です。プロジェクト設定を開いて「実行先」を変更してください: GUI Test Runner-Recorder のディスプレイ、メインディスプレイ、1 台のモニター、またはすべてです。
- 2テストを記録したモニターが接続されていないときはメインディスプレイに置き換えられます: アプリが先に確認します。
- 3記録の前にアプリはテストが使うディスプレイを尋ねます: 環境設定の「記録の既定値」がその答えを保持します。
このコンピューターでは「オフラインにする」を実行できない
この順に試してください
- 1Web ページはブラウザーを通じてオフラインになり、常に動作します。プログラムやコンピューター全体には、GUI Test Studio の小さな Windows サービスが必要です。
- 2GUI Test Studio を管理者としてすべてのユーザー向けにインストールしてください: インストーラーがサービスを設定します。
パイプライン
gtr-cli が終了コード 3 で終わる
この順に試してください
- 1テストを実行できませんでした: コンソールにその理由が出ています。多くの場合、画面が記録時と異なるか、テスト対象のアプリにウィンドウがありません。
- 2マシンを記録時に合わせるか、違いが想定内なら --ignore-screen-mismatch または --ignore-missing-target を追加してください。
- 3フォルダーに対して gtr-cli check を実行すると、実行せずにすべてのテストの準備状況を確認できます。
ビルドマシンで実行がすぐに失敗する
この順に試してください
- 1ビルドエージェントは、バックグラウンドサービスとしてではなく、サインイン済みでロックされていないデスクトップセッションで実行する必要があります: GUI テストには本物の画面が必要です。
- 2そのマシンのスクリーンセーバー、スリープ、通知をオフにしてください。
サインインとシート
ブラウザーが開かない、またはコードが受け付けられない
この順に試してください
- 1アプリの「ブラウザーをもう一度開く」をクリックしてください。
- 2自分で Web サイトを開いてサインインし、アプリが示すアドレスに移動してください。そこでコードを入力します。
- 3コードは 15 分間有効です。それより古い場合は、アプリを終了してもう一度起動し、新しいコードを取得してください。
アプリにもう一度サインインするよう求められる
この順に試してください
- 1このコンピューターがアカウントページで無効化されたか、3 つのプログラムのいずれかでサインアウトしました: これらは 1 つのサインインを共有しています。もう一度サインインしてください。
- 2アプリを新しくインストールした後は、もう一度サインインしてください: シートはそのまま自分のものです。
起動時にアプリが更新を提案する
この順に試してください
- 1新しいバージョンが公開されています。「今すぐ更新」はダウンロードとインストールを行い、アプリは最新の状態で再起動します: 「後で」は次の起動までアプリをそのままにします。
- 2アプリを続行する前にインストールが必須なのは重要な更新だけです: その場合はメッセージがそう伝えます。
- 3ブラウザーでのサインインがないコンピューターでは、「ダウンロードページを開く」からインストーラーを入手できます: ビルドマシンのコマンドライン実行ツールも同じことを伝え、更新を待ちます。
アプリが「今はこのコンピューターで使用できません」と言う
この順に試してください
- 1表示される理由を読んでください。トライアルまたはサブスクリプションが終了した場合: アカウントページでプランを選び、「再試行」をクリックしてください。
- 2チームのメンバーなら、チームの所有者に尋ねてください: プランが終了したか、シートが削除されたのかもしれません。
すべてのシートが使用中
この順に試してください
- 1アカウントページの「コンピューター」の下で、もう使っていないコンピューターを無効化してください。
- 2チームの所有者なら、不要になったメンバーやキーを削除するか、プランにユーザーを追加してください。
コンピューターを替えたら、新しい方が拒否される
この順に試してください
- 1シートが別のコンピューターに移れるのは 30 日に 1 回までです。メッセージに、次に移れる日付が示されます。
- 2それまでは、前にサインインしたコンピューターをお使いください。
- 3そのコンピューターを紛失したり壊れたりした場合は、サポートまでご連絡ください: シートを解放します。
招待メールが届かない
この順に試してください
- 1迷惑メールフォルダーを確認してください。
- 2所有者に、アカウントページの招待の横にある「再送信」をクリックするよう頼んでください。
- 3招待が送られたまさにそのアドレスでサインインしてください: 別のアドレスは拒否されます。
まだ解決しませんか?何をしようとしていたかをお知らせください。1 営業日以内に回答します。Ask our team