Modelli di Integrazione Jira

I modelli sono mappature preimpostate dei campi di problema di axe ai campi di Jira che aiutano a creare formati standardizzati per i ticket di Jira. I modelli possono essere creati per qualsiasi coppia di progetto e tipo di problema e possono essere utilizzati da chiunque nella vostra organizzazione quando si inviano problemi a Jira.

Gestione dell'Accesso ai Modelli

Chi Può Creare Modelli

Chiunque abbia accesso al prodotto di integrazione Jira può creare modelli.

Chi Può Modificare o Eliminare Modelli

• Autori dei modelli: Gli utenti che hanno creato il modello possono modificarlo o eliminarlo
• Amministratori del Portale Account axe: Possono modificare o eliminare qualsiasi modello nell'organizzazione

Permessi dei Modelli

• I modelli sono risorse a livello organizzativo
• Tutti gli utenti con accesso all'integrazione Jira possono usare qualsiasi modello
• Solo gli autori dei modelli e gli amministratori possono modificare i modelli
• I modelli non possono essere limitati a utenti o gruppi specifici

Creare un Modello

1. Navigare alla pagina "CONFIGURAZIONE" all'interno del Portale Account axe (o navigare direttamente a https://axe.deque.com/configuration/integrations e saltare il passaggio 2)
2. Fare clic sul collegamento "Integrazioni" all'interno della navigazione "Configurazione"
3. Fare clic sul collegamento "Configura Modelli Jira"
4. Fare clic sul pulsante "Aggiungi Modello"
5. Compilare i campi nei passaggi "Informazioni sul Modello", "Mappatura del Campo" e "Mappatura dell'Impatto". È possibile visualizzare maggiori dettagli su ogni passaggio nelle sezioni seguenti.
6. Rivedere le informazioni compilate nei passaggi da 1 a 3
7. Fare clic su "Salva"

Per utilizzare un modello, fare riferimento alla Sezione Inviare Problemi a Jira.

Aggiungere Informazioni al Modello

Il primo passo nella creazione di un modello è configurare le informazioni di base che determinano dove e come verranno creati i problemi in Jira.

1. Nome del Modello: Inserire un nome descrittivo per il modello. Questo nome apparirà nell'elenco dei modelli quando si inviano problemi a Jira. Esempio: "Bug A11Y", "Accessibilità Mobile", "Violazioni WCAG 2.1"
2. Progetto: Selezionare il progetto di Jira in cui saranno creati i problemi quando si utilizza questo modello. Il menu a discesa mostra tutti i progetti in cui avete il permesso di creare problemi.
3. Tipo di Problema: Scegliere il tipo di problema che verrà creato in Jira. Le opzioni disponibili dipendono dalla configurazione del progetto selezionato. Tipi comuni: Bug, Task, Story, Sotto-task
4. Abilitare Schermate di Problema Axe come Allegati: Quando selezionato, gli screenshot catturati dagli strumenti axe verranno automaticamente allegati al ticket di Jira. Questo fornisce un contesto visivo per gli sviluppatori che correggono i problemi.

Configurare la Mappatura dei Campi

Nella pagina di mappatura dei campi, l'utente può mappare i campi di axe ai campi di Jira per trasferire automaticamente i dati dei problemi di accessibilità quando si creano i ticket:

1. Nel menu a discesa dei campi di Jira, selezionare il campo di Jira che si desidera mappare
2. Nel menu a discesa dei campi di axe, scegliere il campo dati di axe corrispondente
3. Fare clic su + Aggiungi Campo di axe per mappare campi aggiuntivi
4. Fare clic sul pulsante meno (−) per rimuovere una mappatura
5. Fare clic su Avanti per salvare

Importante: Tutti i campi Jira obbligatori (es. Sommario) sono automaticamente visualizzati su questa pagina. Se non vengono mappati ai campi axe, gli utenti verranno invitati a compilarli manualmente quando inviano problemi.

I campi axe comuni disponibili per la mappatura includono:

1. Regola: l'ID della regola di accessibilità violata
2. Descrizione: descrizione dettagliata del problema di accessibilità
3. Come risolvere: istruzioni per risolvere il problema
4. URL di aiuto: link alla documentazione della regola
5. Riepilogo del problema: breve riepilogo del problema
6. Selettore: selettore CSS per l'elemento
7. Sorgente elemento: codice sorgente HTML dell'elemento
8. URL dello screenshot del problema: URL dello screenshot associato al problema
9. Tag: array di tag di stringa di metadati per il problema (categorie, identificatori di checkpoint wcag, ecc.)
10. Nome del test: nome del test salvato in cui è stato trovato il problema
11. URL di condivisione del problema: link diretto al problema condiviso nel prodotto axe
12. Creato il: la data in cui è stato rilevato il problema
13. URL del test del problema: URL della pagina testata
14. Trovato da: utente che ha eseguito il test in cui è stato sollevato il problema
15. Titolo della pagina: titolo del documento della pagina testata
16. Versione di Axe: la versione di axe-core utilizzata per il test

Campo Descrizione Jira

Il campo descrizione Jira segue una struttura standardizzata che non può essere personalizzata o mappata. Quando i problemi vengono inviati a Jira, includono automaticamente una descrizione strutturata con le seguenti sezioni:

• Descrizione del problema: descrizione del problema
• Come risolvere: istruzioni passo-passo per la risoluzione
• Posizione del problema:
  • Selettore: selettore CSS dell'elemento con problema
  • Sorgente elemento: codice sorgente HTML dell'elemento con problema
• URL della pagina: URL della pagina testata
• Dettagli aggiuntivi:
  • Impatto: livello di gravità del problema
  • Collegamento al Problema Axe: link al report del problema nel Portale Aziendale Axe (se disponibile)
  • Guida alla Regola: link alla documentazione della regola

Configurare la Mappatura degli Impatti

I problemi di accessibilità in axe sono classificati per livello di impatto, indicando quanto gravemente influenzano gli utenti. Nella pagina Mappatura degli Impatti, è possibile associare questi livelli di impatto ai valori di priorità di Jira al fine di garantire un'adeguata prioritizzazione dei problemi.

Gestione degli Errori

Validazione dei Campi Obbligatori

Se un campo obbligatorio è lasciato vuoto nel modello

Durante l'invio del problema, il sistema visualizzerà un messaggio di errore e gli utenti dovranno fornire un valore per il campo obbligatorio prima di inviare il problema a Jira. Un problema axe non può essere inviato a Jira finché tutti i campi obbligatori non hanno valori.

Se un modello associa un valore a un campo obbligatorio di Jira ma il valore non esiste in tutti i prodotti axe

• Durante la creazione del modello, il sistema mostrerà un messaggio di avviso che indica che il campo mappato non è disponibile in tutti i prodotti axe, ma gli utenti possono procedere con la creazione del modello nonostante l'avviso.
• Durante l'invio dei problemi a Jira, se un modello contiene mappature a campi mancanti in un prodotto Deque, apparirà un messaggio di avviso. Il sistema evidenzierà i campi che richiedono l'inserimento manuale e gli utenti dovranno inserire manualmente i valori per i campi obbligatori mancanti prima che il problema possa essere inviato. I problemi saranno inviati a Jira solo una volta che tutti i campi obbligatori saranno popolati, sia tramite mappature esistenti che tramite inserimento manuale.

Modifica ed Eliminazione dei Modelli

Per modificare o eliminare un modello, attiva il menu "Opzioni" per il modello specifico e ti verranno presentate 2 opzioni:

• Modifica modello
• Elimina modello