よくある質問

コンセプト

Git プロジェクトと Gitless プロジェクトの違いは何ですか？

Developer Hub は、テストが Git を使用しているかどうかに応じて結果を異なる方法で整理します。

• Git プロジェクト はアクセシビリティの結果をブランチやコミットと関連付け、特定のコード変更まで問題を追跡できるようにします。
• Gitless プロジェクト は結果をタイムスタンプ順に並べられたテスト実行のシリーズとして整理し、Gitデータは一切含みません。
• Git データは Axe Watcher、Axe CLI またはウェブ API 用の Axe DevTools （CLI 経由で結果をアップロード）を使用する場合に利用可能です。モバイルプロジェクトは常に Gitless です。

さらに詳しい情報は結果を理解するおよびGitとGitlessの用語集の項目を参照してください。

A11y 閾値とは何で、それをどのように設定しますか？

A11y 閾値は組織のアクセシビリティ問題に対する許容度を反映し、CI/CD パイプラインで何が失敗と見なされるかを決定します。

• これは、すべての問題をカウントするか新しい問題のみをカウントするか、含める影響レベル（「重大度」は常に含まれます）の2つの基準から計算されます。
• プロジェクト管理者のみが閾値を設定できます。

詳細はA11y 閾値を変更するを参照してください。

影響レベル（重大度、深刻、 中程度、軽微）は何を意味しますか？

すべてのアクセシビリティ違反には、最も深刻なものから最も軽いものまでの4つの影響レベルのいずれかが割り当てられます。

• 重大度: 障害を持つユーザーが機能にアクセスしたり操作したりすることが完全にブロックされています。
• 深刻: 障害を持つユーザーがサイトを操作する際に大きな障壁に直面します。
• 中程度: 障壁はあるものの、基本的なコンテンツにはまだアクセス可能です。
• 軽微: それでも解決が必要な軽微な問題。

詳細な定義については用語集をご覧ください。

比較

Developer Hub はGitプロジェクトの2種類の比較を提供します。クロスブランチ比較はブランチビューに表示され、各ブランチがデフォルトブランチの最新パイプライン実行と比較されます（今すぐマージした場合の変更点を示します）。ブランチ内比較はコミットビューに表示され、各コミットが同じブランチで前回スキャンされたコミットと比較されます（特定のコミットが導入または修正した内容を示します）。全体像は結果を理解するを参照してください。

リリースごとの変化点をどのように把握すればよいですか？

Git プロジェクトのブランチビューでは、クロスブランチ比較を使用してリリース間のアクセシビリティの変化を追跡できます。

• 各ブランチの最新スキャンされたコミットは、デフォルトブランチの最新パイプライン実行と比較されます。
• 比較では、問題の総数、新たに導入された問題、解決された問題、およびスキャンされたページの状態数の変化が表示されます。

ブランチ内の個別コミットでの変更を確認するには、ブランチ内でコミット間で何が変更されたかを確認するにはどうすればよいですか？をご覧ください。

プルリクエストの影響をどのように判断できますか？

プルリクエストブランチでテストスイートを実行し、結果をAxe Developer Hubに表示させてください。

• ブランチビューでは、各非デフォルトブランチがデフォルトブランチとのクロスブランチ比較を表示し、新たに導入された問題、解決された問題、総差分が示されます。
• GitHubアクションを使用すると、PRに要約と完全な結果へのリンクを自動でコメントとして追加できます。

ブランチの各コミットがどのように変更されたかを詳しく見るには、ブランチ内でコミット間で何が変更されたかを確認するにはどうすればよいですか？をご覧ください。

ブランチ内でコミット間で何が変更されたかを確認するにはどうすればよいですか？

ブランチビューから、任意のブランチのコミットを見るをクリックしてその個別スキャン済みコミットを表示します。ブランチビューのクロスブランチ比較とは異なり、コミットビューではブランチ内の比較を使用します：

• 各コミットは、そのブランチの前回スキャンされたコミットと比較され、新しい問題、解決された問題、ページ状態の変化が示されます。
• テストスイートが実行されたコミットのみが表示されます。

ブランチ全体がデフォルトブランチとどのように比較されるかを見るには、最新のCI/CD実行でデフォルトブランチとブランチを比較するにはどうすればよいですか？をご覧ください。

最新のCI/CD実行でデフォルトブランチとブランチを比較するにはどうすればよいですか？

ブランチビューは、各非デフォルトブランチに対してデフォルトブランチの最新パイプライン実行と自動的にクロスブランチ比較を行います。

• これには、プロジェクト管理者がデフォルトブランチでAxe Watcherをパイプラインとして実行するように設定する必要があります。
• 比較には、総問題数、新しい問題、解決された問題、およびページ状態の差が示されます。

そのブランチ内の個別コミットで何が変更されたかを見るには、ブランチ内でコミット間で何が変更されたかを確認するにはどうすればよいですか？をご覧ください。

プルリクエストを作成する前に正確な比較結果を得るにはどうすればよいですか？

マージ前に正確なクロスブランチ比較を行うために、機能ブランチをデフォルトブランチと同期させ続けてください。

1. テストスイートを実行する前に、デフォルトブランチをフィーチャーブランチ（例：git merge main）にマージします。
2. マージコミットをプッシュして、Axe Developer Hubで更新されたブランチをスキャンできるようにしてください。
3. その後、ブランチビューではデフォルトブランチの最新パイプライン実行とあなたのブランチを比較し、実際にあなたのブランチが導入したアクセシビリティ変更のみを示します。

あなたの機能ブランチがデフォルトブランチより遅れている場合、デフォルトブランチで既に修正された問題が機能ブランチにまだマージされていないときには、その比較で問題が表面化することがあります。デフォルトブランチを先にマージすることで、これらの誤検知を排除し、プルリクエストをマージしたときの驚きを減少させます。

CI/CD

コードに新たなアクセシビリティの問題がマージされないようにするにはどうすればよいですか？

Axe Developer HubをCI/CDパイプラインに統合して、各コミットやプルリクエストで自動的にアクセシビリティチェックを実行させます：

• GitHubを使用している場合、Axe Developer Hub GitHubアクションでアクセシビリティエラーを引き起こすPRをブロックできます。
• GitLabやBitbucketなどの他のプラットフォーム向けには、RESTサービスAPIを使用して結果をクエリし、問題が検出された場合にパイプラインを失敗させます。
• a11yしきい値を設定することで、不具合と見なす内容を微調整できます。

GitHubを使用していない場合、Axe Developer HubをCI/CDパイプラインに統合するにはどうすればよいですか？

任意のCI/CDプラットフォームと統合するには、RESTサービスAPIを使用できます：

• RESTサービスAPIを使うことで、テストスイートの実行後にAxe Developer Hubから結果をクエリできます。
• APIは、問題数、新しい違反、解決された違反、およびDeveloper Hubでの完全な結果へのリンクを返します。
• このレスポンスを利用して、GitLab、Bitbucket、Jenkins、その他のプラットフォームでパイプラインを合格または失格にすることができます。

プロジェクト管理

他のチームメンバーのアクセシビリティスキャンをプロジェクトでどのように表示しますか？

プロジェクトのメンバー全員が追加されると、共有プロジェクト内のすべての結果を表示できます：

• メンバー設定ページを通じてチームメンバーを追加します。
• Gitプロジェクトでは、ブランチビューがAPIキーごとにグループ化された結果を表示するため、誰が各スキャンを実行したかが分かります。

役割と権限の詳細についてはチーム用プロジェクトの設定を参照してください。

アクセシビリティの結果をどのようにエクスポートするのですか？

デベロッパーハブはデータをエクスポートするいくつかの方法を提供しています：

• 問題の概要ビューから、問題をエクスポートボタンをクリックして結果をCSVまたはJSONでダウンロードします。
• プログラム的なアクセスの場合、RESTサービスAPIを使用して特定のコミットとプロジェクトの結果をクエリします。

その他のオプションについてはプログラムでの結果の取得を参照してください。