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





