Configurazione Globale

Panoramica della Configurazione Globale

Il pannello Globale di Axe Configuration offre un modo centralizzato per gestire e controllare le impostazioni dei test di accessibilità in tutta l'organizzazione. Questa potente funzionalità consente agli amministratori aziendali di stabilire standard di test coerenti, lasciando al contempo ai singoli team e sviluppatori la flessibilità di cui hanno bisogno per lavorare in modo efficace.

Cos'è la Configurazione Globale?

La configurazione globale (la scheda Globale di Axe Configuration) è un insieme di controlli che determinano come Axe Watcher opera durante i test di accessibilità. Queste impostazioni includono:

• Quali standard di accessibilità testare (come WCAG 2.1 AA o EN 301 549)
• Se includere controlli di migliori pratiche
• Se abilitare regole sperimentali
• Quale versione di axe-core utilizzare per i test

Queste impostazioni possono essere gestite sia a livello aziendale che a livello di singolo utente, creando un ambiente di test flessibile ma controllato.

Perché Usare la Configurazione Globale?

La configurazione globale risolve diverse sfide comuni nei test di accessibilità aziendale:

• Coerenza: Assicurare che tutti i team testino gli stessi standard di accessibilità
• Conformità: Applicare requisiti di test specifici in tutta l'organizzazione
• Flessibilità: Consentire ai team di personalizzare il loro approccio di test entro i parametri approvati
• Controllo Versioni: Gestire quali versioni di axe-core possono essere utilizzate nei progetti
• Assicurazione Qualità: Mantenere gli standard di test consentendo ottimizzazioni specifiche per i team

Come Funziona la Configurazione Globale

Amministratori

Gli amministratori impostano i valori predefiniti a livello aziendale e definiscono quali impostazioni gli utenti possono modificare tramite la proprietà configurationOverrides (JavaScript/TypeScript) o il metodo AxeWatcherOptions.setConfgurationOverrides() (Java). Queste impostazioni stabiliscono la base per i test di Axe Watcher all'interno dell'organizzazione. Queste impostazioni vengono modificate nel pannello Globale di Axe Configuration.

Utenti

I singoli utenti personalizzano Axe Watcher cambiando o aggiungendo l'opzione configurationOverrides nel loro codice di configurazione dei test per scegliere valori diversi da quelli configurati dall'amministratore dell'organizzazione (ma solo per le impostazioni in cui l'amministratore ha selezionato il checkbox Consentire agli utenti di cambiare).

L'opzione configurationOverrides interagisce con le impostazioni nel pannello Globale come definito nella tabella in Scenari Comuni di Configurazione Globale e Sovrascrittura di Configurazione.

I riferimenti API includono più informazioni su (JavaScript/TypeScript) configurationOverrides o (Java) ConfigurationsOverrides e le sue proprietà.

Scenari Comuni di Configurazione Globale e Sovrascrittura di Configurazione

Quando viene eseguito un test, Axe Developer Hub unisce le impostazioni aziendali e quelle utente per creare la configurazione finale del test. Questo garantisce che tutte le personalizzazioni rimangano entro parametri approvati, offrendo agli utenti la necessaria flessibilità.

La seguente tabella illustra scenari comuni con cui vi imbatterete lavorando con configurazioni globali. Ogni scenario mostra come le impostazioni aziendali interagiscono con la configurazione del progetto.

Comprendere i Risultati

• ✅ Successo: La configurazione funziona come previsto
• ⚠️ Avvertenza: La configurazione funziona ma non è consigliata
• ❌ Errore: La configurazione fallirà

Raccomandazioni

1. Preferisci sempre configurationOverrides a runOptions.
2. Verifica le impostazioni aziendali prima di configurare sovrascritture.
3. Sovrascrivi le impostazioni solo quando necessario.
4. Usa la configurazione più semplice che soddisfi le tue esigenze.

Esempio di Configurazione di Sovrascrittura

Ecco un esempio di configurazione che dimostra le sovrascritture per seguire WCAG 2.1 AA, impostare axe-core alla versione 4.9.1, e consentire regole sperimentali e migliori pratiche:

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
    }
};

Vedi (JavaScript/TypeScript) ConfigurationOverrides Interfaccia o (Java) ConfigurationOverrides Classe per una spiegazione delle proprietà.

Errori e Avvertenze

Errori

Standard Non Permesso

Se tenti di utilizzare uno standard non permesso, riceverai un codice di risposta del server 422, Contenuto Non Elaborabile. Messaggio di esempio:

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"

Utilizzo di runOptions.runOnly con configurationOverrides

Se utilizzi entrambi runOptions.runOnly con configurationOverrides, i tuoi test falliranno immediatamente.

Avvertenze

Utilizzo di runOptions con runOnly o rules

Se imposti le proprietà runOnly o rules sull'oggetto runOptions, riceverai questo messaggio:

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

L'uso di runOnly o rules potrebbe consentire al tuo codice di utilizzare regole di accessibilità non consentite dalla configurazione globale utilizzata dalla tua organizzazione.

@axe-core/watcher Senza Supporto per la Configurazione Globale

Se utilizzi una versione di @axe-core/watcher troppo vecchia per supportare la configurazione globale, riceverai questo messaggio:

Vedi Anche

• Configurazione Axe
• (JavaScript/TypeScript) riferimento configurationOverrides
• (Java) ConfigurationOverrides Classe