Globale Configuratie

Overzicht van Globale Configuratie

Het Globale paneel van Axe Configuratie biedt een gecentraliseerde manier om de instellingen voor toegankelijkheidstests binnen uw organisatie te beheren en te controleren. Deze krachtige functie stelt bedrijfsbeheerders in staat om consistente teststandaarden vast te stellen, terwijl individuele teams en ontwikkelaars de flexibiliteit krijgen die ze nodig hebben om effectief te werken.

Wat is Globale Configuratie?

Globale configuratie (de Globale tab van Axe Configuratie) is een set controles die bepalen hoe Axe Watcher opereert tijdens toegankelijkheidstests. Deze instellingen omvatten:

• Tegen welke toegankelijkheidsstandaarden moet worden getest (zoals WCAG 2.1 AA of EN 301 549)
• Of beste praktijken controles moeten worden opgenomen
• Of experimentele regels moeten worden ingeschakeld
• Welke versie van axe-core moet worden gebruikt voor testen

Deze instellingen kunnen zowel op bedrijfsniveau als individueel gebruikersniveau worden beheerd, waardoor een flexibele maar gecontroleerde testomgeving ontstaat.

Waarom Globale Configuratie Gebruiken?

Globale configuratie lost verschillende veelvoorkomende uitdagingen in bedrijfs-toegankelijkheidstests op:

• Consistentie: Zorg ervoor dat alle teams testen tegen dezelfde toegankelijkheidsstandaarden
• Naleving: Handhaaf specifieke testvereisten binnen uw organisatie
• Flexibiliteit: Sta teams toe hun testaanpak aan te passen binnen goedgekeurde parameters
• Versiebeheer: Beheer welke axe-core versies in projecten kunnen worden gebruikt
• Kwaliteitsborging: Handhaaf teststandaarden terwijl team-specifieke optimalisaties mogelijk worden gemaakt

Hoe Werkt Globale Configuratie

Beheerders

Beheerders stellen organisatiebrede standaarden in en bepalen welke instellingen gebruikers kunnen wijzigen via de configurationOverrides eigenschap (JavaScript/TypeScript) of AxeWatcherOptions.setConfgurationOverrides() methode (Java). Deze instellingen vormen de basis voor Axe Watcher tests binnen de organisatie. Deze instellingen worden gewijzigd in het Globale paneel van Axe Configuratie.

Gebruikers

Individuele gebruikers personaliseren Axe Watcher door de configurationOverrides optie in hun testconfiguratiecode te wijzigen of toe te voegen, om waarden te kiezen die afwijken van wat hun organisatiebeheerder heeft ingesteld (maar alleen voor instellingen waarbij de beheerder het Sta gebruikers toe te wijzigen selectievakje heeft aangevinkt).

De configurationOverrides optie werkt samen met de instellingen in het Globale paneel zoals gedefinieerd in de tabel in Veelvoorkomende Scenario's voor Globale Configuratie en Configuratie-Overschrijvingen.

De API-referenties bevat meer informatie over (JavaScript/TypeScript) configurationOverrides of (Java) ConfigurationsOverrides en de eigenschappen ervan.

Veelvoorkomende globale configuratie- en configuratieoverschrijdingsscenario's

Wanneer een test wordt uitgevoerd, combineert Axe Developer Hub zakelijke en gebruikersinstellingen om de uiteindelijke testconfiguratie te maken. Dit zorgt ervoor dat alle aanpassingen binnen de goedgekeurde parameters blijven terwijl gebruikers de nodige flexibiliteit krijgen.

De volgende tabel illustreert veelvoorkomende scenario's die je tegenkomt bij het werken met globale configuraties. Elk scenario laat zien hoe bedrijfsinstellingen samenwerken met je projectconfiguratie.

De Resultaten Begrijpen

• ✅ Succes: Configuratie werkt zoals verwacht
• ⚠️ Waarschuwing: Configuratie werkt, maar wordt niet aanbevolen
• ❌ Fout: Configuratie zal falen

Aanbevelingen

1. Geef altijd de voorkeur aan configurationOverrides boven runOptions.
2. Controleer je bedrijfinstellingen voordat je overschrijvingen configureert.
3. Overschrijf instellingen alleen wanneer dat nodig is.
4. Gebruik de eenvoudigst mogelijke configuratie die aan je behoeften voldoet.

Voorbeeld configuratie-overschrijving

Hier is een voorbeeldconfiguratie die laat zien hoe overschrijvingen worden gevolgd WCAG 2.1 AA, stel axe-core in op versie 4.9.1, en sta experimentele regels en best practices toe:

const config = {
  axe: {
    apiKey: 'YOUR_API_KEY',
    projectId: 'YOUR_PROJECT_ID',

    configurationOverrides: {
      accessibilityStandard: 'WCAG 2.1 AA',
      axeCoreVersion: '4.9.1',
      experimentalRules: true,
      bestPractices: true
    }
};

Zie (JavaScript/TypeScript) ConfigurationOverrides Interface of (Java) ConfigurationOverrides Klasse voor een uitleg van de eigenschappen.

Fouten en Waarschuwingen

Fouten

Niet-toegestaan Standaard

Als je probeert een standaard te gebruiken die niet is toegestaan, ontvang je een serverresponscode 422, Onverwerkbare Inhoud. Voorbeeldbericht:

Error: Server responded to https://axe.deque.com/api-pub/watcher/sessions with status code 422: "error": "Invalid accessibility standard: WCAG 2.0 AA. Allowed options: EN 301 549, Trusted Tester v5"

Gebruik van runOptions.runOnly met configurationOverrides

Als je zowel runOptions.runOnly als configurationOverrides gebruikt, zullen je tests onmiddellijk falen.

Waarschuwingen

Gebruik van runOptions met runOnly of rules

Als je de eigenschappen runOnly of rules instelt op het runOptions object, ontvang je dit bericht:

This scan was created using runOptions. This may not be aligned with your organization's global configurations.

Het gebruik van zowel runOnly als rules kan je code toestaan om toegankelijkheidsregels te gebruiken die niet zijn toegestaan door de wereldwijde configuratie die je organisatie gebruikt.

@axe-core/watcher Zonder Wereldwijde Configuratie Ondersteuning

Als je een versie van @axe-core/watcher gebruikt die te oud is om wereldwijde configuratie ondersteuning te hebben, ontvang je dit bericht:

Zie Ook

• Axe Configuratie
• (JavaScript/TypeScript) configurationOverrides referentie
• (Java) ConfigurationOverrides Klasse