トラブルシューティング
Axe Developer Hubを使用する際に遭遇する可能性のある問題の解決ガイド
プロジェクトを開くと「スキャンデータが利用できません」と表示される
すでにアクセシビリティスキャンを実行しており、結果を期待している場合は、プロジェクトの設定を確認してください。
APIキーを確認する
個人用APIキーは、プロジェクトの種類に合ったものであるべきです。Axe Watcher、Web API、またはCLIを統合しているプロジェクトの場合は、Axe Developer Hub APIキーを使用しなければなりません。モバイルプロジェクトの場合は、Axe DevTools for Mobile APIキーを使用する必要があります。 APIキーを作成するには、Axe Developer Hubおよび/またはAxe DevTools for Mobileの有効なライセンスが必要です。アクセスを取得したら、APIキーにアクセスして新しいキーを追加してください。
- + 新しいAPIキーを追加ボタンをクリックすると、下に表示されているようなポップアップウィンドウが表示されます:
- 製品 ドロップダウンで Axe Developer Hub または Axe DevTools for Mobile を選択します。
- APIキーに名前を付けます。
- 保存をクリックします。
数秒後、更新された「APIキーを管理する」ページが表示され、APIキーが正常に追加されたというメッセージも表示されます。
APIキーのアクション列でクリックしてAPIキーをクリップボードにコピーします。APIキーが正常にコピーされたというメッセージが表示されるはずです。
プロジェクト設定を設定したときに、コードをコピーしてエンドツーエンドテストに貼り付けた可能性があります。このコードを見直し、対応するAPIキーでAPI_KEYを置き換えたことを確認してください。
プロジェクトIDを確認する
プロジェクトIDを見つけるには、プロジェクトページからインストール手順に移動します。プロジェクトの設定ドロップダウンを開き、プロジェクトの設定を選択します。プロジェクトIDが表示されるので、クリックしてクリップボードにコピーできます。「プロジェクトの設定」の間にコピー＆ペーストしたコードを見直し、すべてのPROJECT_IDを対応するプロジェクトIDで置き換えたことを確認してください。
スキャンの出力にエラーが表示されないことを確認する
テストを実行しているウィンドウで、結果がAxe Developer Hubに送信されるのを妨げるエラーがあるかもしれません。これらのエラーを慎重に確認し、解決してください。
テストが正常に完了することを確認する
テストがまだ実行中の場合、結果がDeveloper Hubに送信されていない可能性があります。テストが正常に完了するまで待ち、その後ページを更新して結果を確認してください。
すべてのスキャンの結果が表示されない
同じコミット（同じコミットSHA）を複数回スキャンすると、結果が「上書き」されて最新のものだけが表示されることがあります。Gitデータを使用している場合、新しいスキャンを表示するには新しいコミットを作成する必要があります。テストを実行するたびに新しいコミットを作成したくない場合、またこのプロジェクトがまだGitロックされていない場合は、Gitlessテストを使用するとこの問題を回避できます。
テストスイートのGitなしビューを取得するには、既存のプロジェクトのデータ形式を変更しようとするのではなく、その結果を別のGitロックされていないプロジェクトに送信します。プロジェクトが最初の成功したセッションでGitにロックされると、.gitフォルダーを削除したり、Gitのデータ収集をオフにしたりしても、Gitなしのセッションは生成されず、実行が拒否されます。拒否がどのように見えるか、またそれを解決する方法については実行拒否: データの形式またはリポジトリがプロジェクトと一致しませんを参照してください。
ベストプラクティスとして、新しいコミットが作成されるたびにテストスイートを実行するべきです。
Gitデータがコードに対応していない
エンドツーエンドテストがテストするコードとは別のリポジトリで実行されている場合、表示されるGitデータはテスト用のものであり、ではないテストするコードのものではありません。これが混乱を招く場合で、このプロジェクトがまだGitロックされていない場合、Gitlessテストを使用するとこの問題を避けられます。
テストスイートのGitなしビューを取得するには、既存のプロジェクトのデータ形式を変更しようとするのではなく、その結果を別のGitロックされていないプロジェクトに送信します。プロジェクトが最初の成功したセッションでGitにロックされると、.gitフォルダーを削除したり、Gitのデータ収集をオフにしたりしても、Gitなしのセッションは生成されず、実行が拒否されます。拒否がどのように見えるか、またそれを解決する方法については実行拒否: データの形式またはリポジトリがプロジェクトと一致しませんを参照してください。
ベストプラクティスとして、エンドツーエンドテストはテストするコードと同じリポジトリに保持することをお勧めします。
実行が拒否されました: データの形式またはリポジトリがプロジェクトに一致しません
プロジェクトが初めての成功セッションを取り込むと、そのデータ形式（GitまたはGitless）および、Gitプロジェクトの場合はリポジトリがロックされます。ロックに一致しない実行は取り込み時に拒否され、結果は保存されません。拒否メッセージにはプロジェクトが期待するもの、実行で送信されたもの、およびそれに対処する方法が示されます。例えば：
This project is locked to a different repository. Project expects {lockedRepo}; this run sent {incomingRepo}. The results were not ingested. Send this run to its own Axe Developer Hub project, or check that CI is providing git information for the locked repository.一般的な原因とその解決方法：
- 2番目のリポジトリまたはテストスイートが同じプロジェクトを指しています。 代わりに、既に別のリポジトリにロックされているプロジェクトではなく、独自のプロジェクトに送信してください。
- 浅いクローン、デタッチされたHEAD状態、または
originリモートの欠落が、リポジトリURL、ブランチ、またはCIからのコミットSHAを取り去っている、Gitの実行がGitlessのように見えるようにしています。CI構成が完全なGit情報を提供していることを確認してください。CI専用のガイダンスについては継続的インテグレーション (CI) 環境でのAxe Watcherをご覧ください。 - 既にGitにロックされているプロジェクトでGitデータ収集がオフになりました。
git: falseを使用して、または.gitフォルダーを削除して実行を送信しても、プロジェクトがGitlessに変換されることはなく、実行は拒否されます。Gitlessの実行は代わりに別のGitlessプロジェクトに送信してください。
実行が拒否されました：Webクライアントがモバイルプロジェクトに結果を送信した
Axe WatcherおよびAxe DevTools CLIは、結果をウェブプロジェクトにしか送信できません。テスト設定のプロジェクトIDがモバイルプロジェクトのものである場合、セッションは開始時に拒否され、結果は保存されません。エラー内容は次のとおりです：
This is a mobile project. Axe Watcher and the axe DevTools CLI can only send results to a web project.それを解決するには、プロジェクトIDを確認してくださいし、必要であればウェブプロジェクトのIDに置き換えてください。モバイルプロジェクトはAxe DevTools Mobileツールからのみ結果を受け取ります。
ヘルプ
support.deque.comにアクセスして、ナレッジベースの記事、DequeのSaaS製品のステータスレポート、その他の製品サポートにアクセスしてください。問題が解決しない場合は、メールでお問い合わせくださいしてください。お手伝いいたします。