Risoluzione dei problemi

This page is not available in the language you requested. You have been redirected to the English version of the page.

Link to this page copied to clipboard

Guida per risolvere i problemi che potresti incontrare quando usi Axe Developer Hub

Not for use with personal data

Apertura di un progetto mostra "Nessun dato di scansione disponibile"

Se hai già eseguito scansioni di accessibilità e ti aspetti di vedere i risultati, dovresti verificare la configurazione del progetto.

Verifica la tua chiave API

La tua API Key personale deve essere compatibile con il tipo di progetto. Per i progetti che integrano Axe Watcher, Web API o CLI, devi utilizzare una API Key di Axe Developer Hub. Per i progetti mobile, devi utilizzare una API Key di Axe DevTools for Mobile. Per creare una API Key devi avere una licenza attiva per Axe Developer Hub e/o Axe DevTools for Mobile. Una volta ottenuto l'accesso, visita API Keys per aggiungere una nuova chiave.

Fai clic sul pulsante + AGGIUNGI NUOVA CHIAVE API e vedrai una finestra pop-up simile a quella mostrata di seguito:
Seleziona Axe Developer Hub o Axe DevTools for Mobile nel menu a tendina Prodotto.
Dai un Nome alla API Key.
Fai clic su Salva.

Dopo alcuni secondi, la pagina aggiornata Gestisci Chiavi API verrà visualizzata insieme a un messaggio che conferma l'aggiunta della chiave API.

Nella colonna Azioni delle tue API Key, fai clic per copiare una API Key negli appunti. Dovresti quindi vedere un messaggio che informa che l'API Key è stata copiata con successo.

Quando hai impostatoprogetto, potresti aver copiato e incollato del codice nei tuoi test end-to-end. Rivedi questo codice e assicurati di aver sostituito API_KEY con la corrispondente API Key

Verifica il tuo ID Progetto

Per trovare il tuo Project ID, accedi alle Istruzioni di Installazione dalla pagina Progetti. Apri il menu a tendina Impostazioni per il tuo progetto e seleziona Configura Progetto. Vedrai il Project ID, che puoi fare clic e copiare negli appunti. Rivedi il codice che hai copiato e incollato nei tuoi test end-to-end durante configurazione del progetto e assicurati di aver sostituito tutte le istanze di PROJECT_ID con il corrispondente Project ID.

Verifica che l'output della scansione non mostri errori

Nella finestra in cui stai eseguendo il test, potresti avere errori che hanno impedito l'invio dei risultati ad Axe Developer Hub. Esamina attentamente questi errori e risolvili.

Verifica che il test sia stato completato con successo

Se il tuo test è ancora in esecuzione, i risultati potrebbero non essere ancora stati inviati a Developer Hub. Attendi che il test termini con successo e poi aggiorna la pagina per vedere i tuoi risultati.

Non vedi i risultati per tutte le scansioni

Se esegui più scansioni sullo stesso commit (stesso SHA del commit), i risultati possono essere "sovrascritti" per mostrare solo l'ultima. Quando si utilizzano i dati di Git, è necessario creare un nuovo commit per vedere le nuove scansioni. Se non vuoi creare un nuovo commit ogni volta che esegui il test e questo progetto non è ancora bloccato su Git, l'utilizzo di test senza Git evita il problema.

Per ottenere una vista Gitless di una suite di test, invia i suoi risultati a un progetto separato bloccato su Gitless, invece di cercare di modificare la forma dei dati di un progetto esistente. Una volta che un progetto è bloccato su Git dopo la sua prima sessione di successo, eliminare la cartella .git o disattivare la raccolta dati di Git non produce più una sessione Gitless: l'esecuzione viene invece rifiutata. Vedi Esecuzione Rifiutata: Forma dei Dati o Repository Non Corrisponde al Progetto per capire come appare il rifiuto e come risolverlo.

Come buona pratica, dovresti eseguire la suite di test ogni volta che viene creato un nuovo commit.

I dati Git non corrispondono al codice

Se i test end-to-end vengono eseguiti in un repository separato dal codice che stai testando, i dati di Git visualizzati saranno per il test, non il codice che stai testando. Se ciò causa confusione e questo progetto non è ancora bloccato su Git, l'utilizzo di test senza Git lo evita.

Come buona pratica, ti consigliamo di mantenere i test end-to-end nello stesso repository del codice che stai testando.

Esecuzione Rifiutata: La Forma dei Dati o il Repository Non Corrispondono al Progetto

Una volta che un progetto ha acquisito la sua prima sessione riuscita, la sua forma dati (Git o senza Git) e, per i progetti Git, il suo repository, sono bloccati. Un'esecuzione che non corrisponde al blocco viene rifiutata in fase di acquisizione e i risultati non vengono salvati. Il messaggio di rifiuto indica cosa si aspetta il progetto, cosa ha inviato l'esecuzione e cosa fare al riguardo, per esempio:

This project is locked to a different repository. Project expects {lockedRepo}; this run sent {incomingRepo}. The results were not ingested. Send this run to its own Axe Developer Hub project, or check that CI is providing git information for the locked repository.

Cause comuni e come risolverle:

Un secondo repository o suite di test è indirizzato allo stesso progetto. Inviarlo al suo progetto invece di quello già bloccato per un repository diverso.
Un clone superficiale, stato HEAD non collegato, o un origin remoto mancante sta rimuovendo l'URL del repository, il ramo o lo SHA del commit dalla CI, facendo sembrare un'esecuzione Git come senza Git. Verifica che la configurazione CI fornisca tutte le informazioni di Git. Vedi Axe Watcher negli Ambienti di Integrazione Continua (CI) per la guida specifica per CI.
La raccolta dati Git è stata disattivata su un progetto già bloccato su Git. Inviare un'esecuzione con git: false o con la cartella .git rimossa non converte più il progetto in senza Git; l'esecuzione viene rifiutata. Invia le esecuzioni senza Git a un progetto separato senza Git.

Esecuzione Rifiutata: Il Client Web Ha Inviato Risultati a un Progetto Mobile

Axe Watcher e la CLI di Axe DevTools possono inviare risultati solo a un progetto web. Se l'ID del progetto nella configurazione del test appartiene a un progetto mobile, la sessione viene rifiutata al momento dell'avvio e nessun risultato viene salvato. L'errore è il seguente:

This is a mobile project. Axe Watcher and the axe DevTools CLI can only send results to a web project.

Per risolvere il problema, verifica il tuo ID progetto e sostituiscilo con l'ID di un progetto web, creandone uno se necessario. I progetti mobili ricevono risultati solo dagli strumenti Axe DevTools Mobile.

Esecuzione Rifiutata: L'Amministratore dell'Org Non È Membro del Progetto

Gli amministratori dell'org vedono ogni progetto nella loro organizzazione, ma possono inviare risultati solo ai progetti di cui sono membri (con il ruolo di amministratore o membro), e solo con una licenza attiva per il tipo di quel progetto. Una licenza mancante o inattiva viene rifiutata separatamente, prima di questo controllo. Se sei un amministratore dell'org con una licenza attiva e l'ID del progetto nella tua configurazione di test appartiene a un progetto di cui non sei membro, l'esecuzione viene rifiutata con un errore 403 che recita:

You don't have access to this project <project ID>. Please ensure you have the required permissions.

Per risolverlo, aggiungi te stesso al progetto nella sua pagina Membri (vedi Aggiungere Membri a un Progetto) o invia i risultati a un progetto di cui sei già membro. Se scegli progetti con l'API Progetti, aggiungi member_only=true per elencare solo i progetti di cui sei membro.

Assistenza

Visita support.deque.com per accedere agli articoli della knowledge base, ai rapporti sullo stato del prodotto SaaS di Deque e ad altri supporti per i prodotti. Se non riesci a risolvere il tuo problema, per favore inviarci un'email in modo che possiamo aiutarti.