Modèles d'intégration Jira

Les modèles sont des mappages prédéfinis des champs d'incident axe aux champs Jira qui aident à créer des formats standardisés pour les tickets Jira. Les modèles peuvent être créés pour toute combinaison de projet et de type d'incident et peuvent être utilisés par toute personne de votre organisation lors de l'envoi d'incidents à Jira.

Gestion de l'accès aux modèles

Qui peut créer des modèles

Toute personne ayant accès au produit d'intégration Jira peut créer des modèles.

Qui peut modifier ou supprimer des modèles

• Auteurs des modèles : Les utilisateurs qui ont créé le modèle peuvent modifier ou supprimer leurs propres modèles
• Administrateurs du portail de compte axe : Peuvent modifier ou supprimer n'importe quel modèle dans l'organisation

Permissions des modèles

• Les modèles sont des ressources à l'échelle de l'organisation
• Tous les utilisateurs ayant accès à l'intégration Jira peuvent utiliser n'importe quel modèle
• Seuls les auteurs des modèles et les administrateurs peuvent modifier les modèles
• Les modèles ne peuvent pas être restreints à des utilisateurs ou des groupes spécifiques

Créer un modèle

1. Accédez à la page "CONFIGURATION" dans le portail de compte axe (ou naviguez directement à https://axe.deque.com/configuration/integrations et passez l'étape 2)
2. Cliquez sur le lien "Intégrations" dans la navigation "Configuration"
3. Cliquez sur le lien "Configurer les modèles Jira"
4. Cliquez sur le bouton "Ajouter un modèle"
5. Remplissez les champs des étapes "Informations sur le modèle", "Mappage de champs" et "Mappage d'impact". Vous pouvez voir plus de détails pour chaque étape dans les sections suivantes.
6. Examinez les informations remplies aux étapes 1 à 3
7. Cliquez sur "Enregistrer"

Pour utiliser un modèle, consultez la section Envoyer des incidents à Jira.

Ajouter des informations sur le modèle

La première étape de la création d'un modèle consiste à configurer les informations de base qui déterminent où et comment les incidents seront créés dans Jira.

1. Nom du modèle : Entrez un nom descriptif pour votre modèle. Ce nom apparaîtra dans la liste des modèles lors de l'envoi d'incidents à Jira. Exemple : "A11Y Bug", "Accessibilité mobile", "Violations WCAG 2.1"
2. Projet : Sélectionnez le projet Jira où les incidents seront créés lors de l'utilisation de ce modèle. Le menu déroulant affiche tous les projets pour lesquels vous avez la permission de créer des incidents.
3. Type d'incident : Choisissez le type d'incident qui sera créé dans Jira. Les options disponibles dépendent de la configuration de votre projet sélectionné. Types courants : Bug, Tâche, Histoire, Sous-tâche
4. Activer les captures d'écran axe comme pièces jointes : Lorsqu'il est coché, les captures d'écran capturées par les outils axe seront automatiquement jointes au ticket Jira. Cela fournit un contexte visuel pour les développeurs réparant les incidents.

Configurer le mappage des champs

Sur la page de mappage des champs, l'utilisateur peut mapper les champs axe aux champs Jira pour transférer automatiquement les données des incidents d'accessibilité lors de la création des tickets :

1. Dans le menu déroulant Champ Jira, sélectionnez le champ Jira que vous souhaitez mapper
2. Dans le menu déroulant Champ axe, choisissez le champ de données axe correspondant
3. Cliquez sur + Ajouter un champ axe pour mapper des champs supplémentaires
4. Cliquez sur le bouton moins (−) pour supprimer un mappage
5. Cliquez sur le bouton Suivant pour enregistrer

Important : Tous les champs Jira requis (par exemple, Résumé) sont automatiquement affichés sur cette page. Si vous ne les mappez pas aux champs axe, les utilisateurs devront les remplir manuellement lors de l'envoi d'incidents.

Les champs axe courants disponibles pour le mappage incluent :

1. Règle : l'ID de la règle d'accessibilité qui a été violée
2. Description : description détaillée du problème d'accessibilité
3. Comment résoudre : instructions pour résoudre le problème
4. URL d'aide : lien vers la documentation de la règle
5. Résumé du problème : bref résumé du problème
6. Sélecteur : sélecteur CSS pour l'élément
7. Source de l'élément : code source HTML de l'élément
8. URL de la capture d'écran du problème : l'URL de la capture d'écran associée au problème
9. Étiquettes : tableau d'étiquettes de chaîne de métadonnées pour le problème (catégories, identifiants de contrôle WCAG, etc.)
10. Nom du test : nom du test enregistré dans lequel le problème a été trouvé
11. URL de partage du problème : lien direct vers le problème partagé dans le produit axe
12. Créé le : la date à laquelle le problème a été détecté
13. URL du test du problème : URL de la page testée
14. Trouvé par : utilisateur qui a effectué le test dans lequel le problème a été soulevé
15. Titre de la page : titre du document de la page testée
16. Version d'Axe : la version axe-core utilisée pour le test

Champ de description Jira

Le champ de description Jira suit une structure standardisée qui ne peut pas être personnalisée ou mappée. Lorsque des problèmes sont envoyés à Jira, ils incluent automatiquement une description structurée avec les sections suivantes :

• Description du problème : description du problème
• Comment résoudre : instructions de remédiation étape par étape
• Emplacement du problème :
  • Sélecteur : sélecteur CSS de l'élément avec le problème
  • Source de l'élément : code source HTML de l'élément avec le problème
• URL de la page : URL de la page testée
• Détails supplémentaires :
  • Impact : niveau de gravité du problème
  • Lien vers le problème Axe : lien vers le rapport de problème dans le portail Axe Account (si disponible)
  • Aide sur les règles : lien vers la documentation des règles

Configurer la cartographie des impacts

Les problèmes d'accessibilité dans axe sont classés par niveau d'impact, indiquant leur gravité pour les utilisateurs. Sur la page de cartographie des impacts, vous pouvez faire correspondre ces niveaux d'impact avec vos valeurs de priorité Jira pour assurer une priorisation correcte des problèmes.

Gestion des erreurs

Validation des champs obligatoires

Si un champ obligatoire est laissé vide dans le modèle

Lors de l'envoi du problème, le système affichera un message d'erreur et les utilisateurs devront fournir une valeur pour le champ obligatoire avant d'envoyer le problème à Jira. Un problème axe ne peut pas être envoyé à Jira tant que tous les champs obligatoires ne sont pas remplis.

Si un modèle fait correspondre une valeur à un champ obligatoire de Jira mais que la valeur n'existe pas dans tous les produits axe

• Lors de la création du modèle, le système affichera un message d'avertissement indiquant que le champ associé n'est pas disponible dans tous les produits axe, mais les utilisateurs peuvent continuer à créer le modèle malgré l'avertissement.
• Lors de l'envoi de problèmes à Jira, si un modèle contient des correspondances à des champs absents dans un produit Deque, un message d'avertissement apparaîtra. Le système mettra en évidence les champs nécessitant une saisie manuelle et les utilisateurs devront entrer manuellement des valeurs pour tous les champs obligatoires manquants avant que le problème puisse être envoyé. Les problèmes seront seulement envoyés à Jira une fois que tous les champs obligatoires seront complétés—soit via les correspondances existantes, soit par saisie manuelle.

Modification et suppression de modèles

Pour modifier ou supprimer un modèle, activez le menu "Options" pour le modèle donné et vous aurez deux options :

• Modifier le modèle
• Supprimer le modèle