自動化、IGT、手動の問題のインポート
Axe Auditor ユーザーは、手動で問題をインポートすることも(axe DevTools Pro 拡張機能を使用して JSON ファイルとしてエクスポート)、テストユニットレベルで自動化された統合を通じてインポートすることもでき、一度の操作で自動化、IGT、および手動の問題をインポートできます。
注1 - 手動の問題にスクリーンショットを自動インポートする: 手動の問題をインポートすると、関連するスクリーンショットが JSON ファイル内の ScreenshotURL タグを使用して自動的にインポートされます。
注2 - インポート時に主要なバージョンのみを比較する: Axe Auditorは、axe DevTools Proの拡張機能によって生成された問題を、同じメジャーバージョンのaxe-coreを使用している限りインポートできます。したがって、テスト実行と拡張機能のメジャーバージョン番号(バージョン番号の最初の数字)が異なる場合にのみ、拡張機能生成ファイルのインポートを阻止します。 マイナーバージョンが異なる場合、axe Auditorはユーザーに警告を提供し、インポートされるaxe-coreのバージョンがaxe Auditorのバージョンと一致しない可能性があり、テストデータにいくつかのバリエーションがある可能性があることを示します。これらのバリエーションは、主にaxe Auditor内の問題に関連付けられたDequeチェックポイントの潜在的な違いに関連しています。
注3 - ネイティブモバイルAndroidおよびネイティブモバイルiOSのaxe DevTools Mobileから問題をインポートする - ネイティブモバイルベースのデジタル資産タイプからの問題をインポートする際、axe AuditorはExperimentalおよびNeeds Reviewの問題をインポートしません。また、AAAルールセットの問題も無視します。これは、AAAルールをサポートしていないためです。
注4 - テストと問題のオプションを保存する方法を使う: axe DevTools 拡張機能から問題をエクスポートする際には、「テストと問題の保存」オプションを使用してください。
注5 - 問題のないJSONファイルをインポートする: 問題がゼロのJSONファイルをDevTools Proを使用してインポートするとき、axe AuditorはIGTの一部としてテストされたチェックポイントを表示します。このことにより、axe DevTools Proとaxe Auditorを使用したテストの一部としてテストされたチェックポイントのより完全なリストを取得でき、まだテストされていないチェックポイントに集中することができます。
注6 - axe DevTools インポートで IGT の複数回実行: axe DevTools 拡張機能(プロ機能)のマルチラン機能を使用して、axe Auditor テストランにインポートするためのエクスポートを使用している場合、手動で重複を削除した後、複数回の実行でのすべての問題の合計をインポートすることができます。
インポート問題ボタンを使用する
テストユニットに含めることができる3つの異なる種類の問題は以下の通りです:
- 自動化された問題 - Auditor内またはユーザーがアップロードしたJSONファイルから。
- IGT問題 - ユーザーがアップロードしたJSONファイルからのIGTテストを実行中にaxe DevTools Pro拡張機能が見つけたすべての問題はIGT問題としてマークされます。
- 手動の問題 - Auditor内またはユーザーがアップロードしたJSONファイルから。
テストユニット概要ページでは、テストステータスと呼ばれるセクションを使用して、自動化、IGT、および手動の問題をインポートします。このセクションには以下が含まれています:
- 問題のインポートが開始された日付と時刻、
- インポートの状態を示すテストのステータスと、完了した日付と時刻、および、
- Deque Systemsが提供する事前定義された形式のJSONファイルをアップロードできるインポート問題ボタンがあります。
インポート問題ボタンをクリックすると、インポート問題確認ダイアログボックスが表示され、JSONファイルを使用して3種類の問題すべてをインポートできます。JSONファイルを生成するには、axe DevTools拡張機能のJSONオプション(エクスポート → 保存したテストと問題 → JSONオプション)を使用します。
問題をインポートすると、関連するスクリーンショットがJSONファイルのScreenshotURLタグを使用して自動的にインポートされます。ScreenshotURLタグが空の場合、問題にスクリーンショットは追加されません。
注1: 再度問題をインポートする際、テストユニットがすでにその問題を含んでいる場合、既存の問題を維持するか、ファイル内の問題と置き換えるかを選択できます。Axe Auditor は、JSONファイルを使用してインポートされた手動の問題のみを削除して置き換えます。ユーザーが手動で追加した手動の問題は影響を受けず、削除や再インポートはされません。
注2: デジタル資産タイプがデスクトップウェブまたはモバイルウェブでない場合、またはすべてのWCAGおよび信頼できるテスター基準では、自動テストを実行したり、IGTおよび手動の問題をインポートしたりすることはできません。デスクトップウェブまたはモバイルウェブでない資産タイプのテストラン概要ページのボタンには、「自動テストを実行」と「問題をインポート」という表示の代わりに「適用されません」と表示されます。
注3: Axe Auditor は違反のみを考慮するため、インポートされた問題に「レビューが必要」または「ベストプラクティス」問題が含まれている場合、axe Auditorはそれらの問題をインポートしません。
Axe Auditorでの自動統合の使用
概要
手動インポートに加えて、axe Auditorは自動統合 を通じた問題のインポートもサポートしています。
Axe AuditorはAPIを通じてaxe DevTools Pro 拡張機能と統合されており、Axe AuditorのインテグレーションにAxe アカウントを購読している場合、ワンクリックでAuditorに問題を送信できます。
Axe DevTools Pro 拡張機能からAuditorにデータを送信する方法
前提条件
データを送信する前に、Auditor内で以下の手順を完了してください:
- AuditorのインテグレーションはdevTools pro拡張機能で利用可能であり、Auditorのインテグレーション サブスクリプションに加入する必要があります。
- ユーザーはAuditorのライセンスユーザーである必要があります。
- テストケースを作成すると対応するテストラン。
- テストユニットを「進行中」にステータスを移動します。(テストユニットが「未開始」ステータスの場合、データはインポートできません。)
課題をインポートする手順
-
Axe DevTools Pro拡張機能でテストを実行する
- テストしたいURLを開きます。
- Axe DevTools Pro拡張機能を起動して、テストを完了します。
-
共有テストリンクを取得する
- テストが完了したら、共有テストリンクを取得し、新しいタブで開きます。
-
監査者に課題を送信する
- 「監査者に送信」ボタンをクリックします。
- テストユニットIDを入力してください。これは監査者テストユニットからコピーでき(テスト実行概要およびテストユニットページで利用可能)、
-
確認とデータ処理
- 送信後、DevToolsはデータを監査者に送信しますし、確認メッセージを表示します。
- 監査者テストユニットにはすでに問題が含まれています場合、既存のデータを上書きするかどうかを尋ねるプロンプトが表示されます。
- 上書きが選択された場合、監査者のすべての以前の問題は新しくインポートされたものと置き換えられます。
サポートされている問題タイプ
ユーザーは、次の問題タイプを統合を通じて監査者に直接送信できるようになりました:
- 自動問題
- IGT(インテリジェントガイド付きテスト)問題
- 手動問題
すべての検証—URLチェック、テスト方法論の基準、およびaxe-coreバージョンの互換性を含む—がインポートされたデータに適用され、正確性と一貫性を保証します。
エラーメッセージ
| エラーコード | 説明 |
|---|---|
| 409 - 競合 | テストユニットにすでに問題が含まれている場合に表示されます。ユーザーは「データを上書き」をクリックして問題を送信する必要があります。 |
| 500 - 内部サーバーエラー | URL、テスト基準、またはaxe-coreバージョンが監査者テストユニットと一致しない場合に表示されます。 |
この統合により、アクセシビリティテストのワークフローが合理化され、シームレス、正確、効率的課題の転送がAxe DevTools Pro拡張機能と監査者の間でシームレスに行われます。





