Un problème dans Google Issue Tracker est un rapport de bug, une demande de fonctionnalité, une demande de modification ou un élément de workflow de processus qu'un utilisateur souhaite suivre ou qu'il s'attend à ce qu'un autre utilisateur ou une autre équipe suive. Les problèmes sont organisés en composants, chacun contenant un groupe de problèmes associés. Chaque problème dans Issue Tracker dispose de sa propre page d'informations, sur laquelle les utilisateurs peuvent suivre l'activité liée au problème, ajouter des commentaires et mettre à jour les données du problème.
Champs du problème
Chaque problème est associé à un ensemble de champs qui le décrivent et indiquent son état actuel. Cela inclut le type de problème, son importance en termes de gravité et de priorité, ainsi que l'enregistrement de l'activité sur le problème. Certains champs sont communs à tous les problèmes. Issue Tracker est également compatible avec les champs personnalisés qui ne sont disponibles que lorsqu'un problème est associé à un composant spécifique. Pour tous les nouveaux problèmes, plusieurs champs sont obligatoires. Il s'agit de Composant, Titre, Priorité et Type. Certains composants comportent également des champs personnalisés obligatoires.
Sur la page d'informations sur le problème, la plupart des champs se trouvent sur la droite, dans le panneau Champs du problème. Presque tous les champs sont modifiables dans Issue Tracker en cliquant sur la valeur, la liste déroulante ou l'icône en forme de crayon qui leur sont associés. Lorsque vous pointez sur un champ, Issue Tracker fournit une brève description du champ en texte en survol.
Pour obtenir une description des champs de problème par défaut, consultez le Glossaire des champs.
Type de problème
Le champ Type vous permet de classer les problèmes d'un composant dans l'un des groupes courants. Ce champ est obligatoire. Le tableau suivant présente les types de problèmes possibles:
| Type de problème | Description |
|---|---|
| Bug | Le comportement est contraire à ce qui est censé se produire ou à ce qui a été documenté, ou le produit ne fonctionne pas comme prévu. |
| Demande de fonctionnalité | Le produit fonctionne comme prévu, mais pourrait être amélioré grâce aux modifications spécifiées. |
| Problème client | Le problème affecte un tiers et peut ne pas être reproductible par la personne qui le signale. Il peut s'agir d'un problème de dépannage ou de formation, mais il peut également s'agir d'un bug ou d'une demande de fonctionnalité. |
| Nettoyage interne | Le problème n'a aucun effet extérieur sur le comportement d'un produit, mais le résoudre permettrait une interaction plus fluide ou intuitive lors du développement du produit. Vous pouvez également utiliser ce type pour suivre les problèmes de maintenance. |
| Procédure | Le processus est une catégorie diverse qui a des utilisations différentes en fonction du projet. Par exemple, vous pouvez utiliser ce type pour les problèmes générés par une API ou pour suivre les tâches administratives. |
| Faille | Vulnérabilités liées à la confidentialité et à la sécurité soumises aux SLO définies par les consignes de Google en matière de confidentialité et de sécurité. |
| Problème de confidentialité | Autres problèmes de confidentialité soumis aux SLO définies par les consignes de Google en matière de confidentialité et de sécurité |
| Programme | Ensemble d'objectifs thématiques (projets, fonctionnalités, jalons, epics). |
| Projet | Effort axé sur un objectif, avec un début et une fin définis, visant à créer un produit, un service ou un résultat unique. |
| Fonctionnalité | Ensemble de tâches qui offre une valeur spécifique à l'utilisateur. |
| Étape | Ensemble de travaux qui représente un accomplissement important sur la voie de la réalisation d'un projet. Les jalons peuvent également être utilisés pour représenter des lancements ou des versions. |
| Epic | Ensemble de travaux visant un objectif commun. |
| Story | Petit ensemble de travaux qui offre une valeur spécifique à l'utilisateur. |
| Tâche | Petite unité de travail. |
Priorité du problème
Le champ Priority (Priorité) vous permet de spécifier l'importance d'un problème. Ce champ est obligatoire. Les équipes ont généralement des critères différents pour déterminer l'importance d'un problème. Le tableau suivant présente une méthode courante de hiérarchisation des problèmes:
| Priorité du problème | Description |
|---|---|
| P0 | Problème qui doit être résolu immédiatement et avec autant de ressources que nécessaire. Un tel problème entraîne une panne complète ou rend une fonction critique du produit indisponible pour tous, sans solution de secours connue. |
| P1 | Problème qui doit être résolu rapidement. Un tel problème affecte de manière significative un grand pourcentage d'utilisateurs. S'il existe une solution de contournement, elle est partielle ou trop pénible. L'impact du problème affecte une fonction organisationnelle de base ou entrave fondamentalement une autre équipe. |
| P2 | Problème qui doit être résolu dans un délai raisonnable. Il peut s'agir de l'un des problèmes suivants: 1) Un problème qui serait classé P0 ou P1, mais qui dispose d'un contournement raisonnable ; 2) Un problème important pour un grand pourcentage d'utilisateurs et lié aux fonctions organisationnelles de base ; 3) Un problème qui entrave le travail d'autres équipes et qui ne dispose d'aucun contournement raisonnable. P2 est particulièrement pertinent pour les problèmes de première utilisation ou d'installation. Il s'agit du niveau de priorité par défaut. |
| P3 | Problème qui doit être résolu si possible. Un tel problème concerne les fonctions organisationnelles de base ou le travail d'autres équipes, mais n'entrave pas la progression ou dispose d'un moyen de contourner le problème. |
| P4 | Problème qui devrait être résolu à terme. Un tel problème n'est pas pertinent pour les fonctions organisationnelles de base ni pour le travail d'autres équipes, ou il ne concerne que l'attrait ou l'agrément du système. |
État du problème
Le champ État vous permet de spécifier l'état d'un problème dans le processus de résolution. Les équipes ont généralement des définitions différentes des activités qui doivent être effectuées pour qu'un problème change d'état ou soit résolu. Toutes les valeurs de champ État disponibles ne doivent pas être utilisées pour suivre la résolution d'un problème. Le tableau suivant présente les utilisations courantes du champ État:
| État du problème | Description |
|---|---|
| Nouveauté | Aucune personne ni aucun groupe n'est attribué au problème. |
| Attribué | Le problème est attribué à une personne. Cette personne apparaît dans le champ Affectation. |
| En cours (accepté) | La personne concernée a confirmé le problème et a commencé à le résoudre. |
| Correction | Le problème a été résolu. |
| Corrigé (validé) | Le problème a été résolu et la pertinence de la solution apportée a été confirmée par l'utilisateur dans le champ Verifier. |
| Won't fix (Infeasible) (Ne sera pas résolu, infaisable) | Les modifications nécessaires pour résoudre le problème ne sont pas raisonnablement possibles. |
| Won't fix (Not reproducible) (Ne sera pas corrigé, non reproductible) | Il n'y a pas suffisamment d'informations pour résoudre le problème, ou le problème signalé ne peut pas être reproduit. |
| Won't fix (Obsolete) (Ne sera pas corrigé, obsolète) | Ce problème n'est plus pertinent en raison des modifications apportées au produit. |
| Won't fix (Intended behavior) (Ne sera pas corrigé, fonctionnement intentionnel) | Le problème décrit le comportement attendu du produit dans les circonstances signalées. |
| Dupliquer | Le problème a été signalé ailleurs. Pour définir l'état d'un problème sur Dupliquer, consultez Dupliquer un problème. |
Issue Tracker considère les problèmes comme étant ouverts ou fermés, selon leur état. Les problèmes ouverts sont ceux qui attendent d'être résolus. Cela inclut tout problème dont l'état est Nouveau, Attribué ou En cours. Les problèmes clôturés ne nécessitent aucune autre action, sauf éventuellement une vérification. Cela inclut tout problème dont l'état est Corrigé, Impossible à corriger ou Duplique.
Icônes d'état
Les icônes d'état sont une représentation visuelle de l'état d'un problème. Vous pouvez définir la colonne État d'une page de résultats de recherche pour afficher des icônes d'état au lieu d'un texte.
État de la modification rapide
Un lien permettant de modifier rapidement l'état s'affiche sur la page d'informations du problème dans le panneau Champs du problème. Le lien fait passer le problème à l'étape suivante du processus de résolution. En cliquant sur le lien, l'état du problème évoluera comme suit:
Si le problème est nouveau et non attribué, l'invite de modification rapide indique M'attribuer. Si vous modifiez rapidement l'état, vous serez désigné comme responsable et l'état passera à Attribué. Cette option s'affiche également si le problème est attribué ou en cours et que vous n'êtes pas l'utilisateur responsable. Dans ce cas, vous êtes défini comme l'utilisateur responsable et l'état ne change pas.
Si vous êtes le responsable d'un problème et que son état est Attribué, l'invite de modification rapide indique Commencer le travail. La modification rapide fait passer l'état du problème à En cours.
Si vous êtes le responsable d'un problème et que son état est En cours, l'invite de modification rapide indique Marquer comme résolu. La modification rapide définit l'état du problème sur Corrigé.
Si l'état d'un problème est Corrigé et que vous êtes le vérificateur, l'invite de modification rapide indique Valider. L'état du problème passe à Corrigé (Validé).
Si un problème est clôturé (Résolu, Duplique ou Ne sera pas corrigé), l'invite de modification rapide indique Réouvrir (sauf dans le cas mentionné ci-dessus). La modification rapide définit l'état sur Nouveau si le problème n'a pas de responsable ou sur Attribué s'il en a un.
Fiches d'information sur les problèmes
Une info-bulle de problème contient des informations telles que le titre, l'ID, la description et l'état actuel du problème. Il contient également deux boutons: un bouton +1 pour indiquer que vous êtes concerné par le problème et un bouton Me CC (M'ajouter à la copie) qui vous ajoute à la liste de diffusion du problème (si vous figurez déjà dans la liste de diffusion, le bouton indique Me Un-CC (Me retirer de la copie). Exemple :
Les info-bulles de problème s'affichent lorsque vous pointez sur les éléments suivants:
- ID du problème dans la colonne Bloqué par, Blocage ou Duplique de d'une page de résultats de recherche sur les problèmes.
- Lien vers un problème détecté dans le panneau Possibles doublons, situé en bas de la page Créer un problème.
- Champ État sur une page de problème marquée comme doublon.
- Lien vers le problème de canonique détecté dans la barre en haut d'une page marquée comme en double.
Problèmes de modification
Si vous disposez de l'autorisation Modifier les problèmes pour un composant, vous pouvez modifier les champs des problèmes et ajouter des commentaires. Toutefois, certains champs ne peuvent pas être modifiés du tout, comme la date de création du problème.
Modifier les niveaux
Les modifications apportées à un problème ont un niveau de pertinence variable qui détermine si elles apparaissent dans le panneau "Historique" du problème et si les utilisateurs reçoivent une notification par e-mail lorsque le changement se produit.
Modifications de clôture
Lorsque vous fermez une modification, l'état du problème passe de Ouvert à Fermé. Les modifications de clôture apparaissent dans le panneau "Historique" du problème. Les modifications de clôture sont envoyées par e-mail aux utilisateurs qui ont configuré l'un des paramètres de notification suivants: Toutes les mises à jour, Mises à jour importantes ou Clôture uniquement.
Pour obtenir la liste complète des états qui clôturent un problème ouvert, consultez État du problème.
Modifications importantes
Les modifications majeures apparaissent toujours dans le panneau "Historique" du problème. Après une modification majeure, une notification par e-mail est envoyée aux utilisateurs dont le paramètre de notification est défini sur Toutes les mises à jour ou Mises à jour majeures. Voici quelques exemples de modifications considérées comme majeures:
- Création initiale du problème.
- Commentaires ajoutés au problème.
- Le problème est déplacé vers un nouveau composant.
- Modifications apportées à la priorité, à la gravité, à la conservation ou à l'affectataire.
- Modification de l'état en Fermé, Validé ou Réouvert.
- Modifications apportées aux champs personnalisés marqués comme Importantes.
Modifications mineures
Les modifications mineures n'apparaissent dans le panneau "Historique" d'un problème que si le niveau de filtrage est défini sur Historique complet. De même, les modifications mineures ne sont envoyées par e-mail qu'aux utilisateurs dont le rôle pour le problème est défini sur Toutes les mises à jour.
Les modifications mineures incluent les suivantes:
- Modifications apportées au titre.
- Modifications apportées aux listes de diffusion sur le problème.
- Ajout de pièces jointes.
- Modifications apportées aux relations entre les problèmes (blocage, bloqué par, doublon).
- Modifications de l'état qui ne sont pas explicitement indiquées comme étant des modifications majeures.
- Modifications apportées aux champs suivants: Signalant, Type, Validateur, Trouvé dans, Cible, Validé dans, En production.
- Modifications apportées aux champs personnalisés marqués comme Mineures.
Modifications silencieuses
Les modifications silencieuses ne génèrent aucune notification par e-mail pour les utilisateurs, sauf si elles consistent à ajouter ou à supprimer ces utilisateurs du problème. Les modifications considérées comme silencieuses incluent les suivantes:
- Ajout ou suppression d'entrées dans les champs Cc ou Collaborateur (sauf si l'utilisateur ou le groupe est ajouté ou supprimé pour la première fois).
- Modification d'un commentaire.
- Modification d'un champ personnalisé marqué comme Silencieux.
Émettre des limites d'accès
Issue Tracker prend en charge les restrictions de contrôle des accès qui permettent aux problèmes d'avoir un ensemble d'accesseurs plus petit que les autres problèmes du même composant.
Les administrateurs des problèmes peuvent mettre à jour l'état de restriction d'un problème en définissant l'un des quatre niveaux d'accès suivants:
Accès par défaut : les règles normales s'appliquent : un problème avec le niveau d'accès par défaut a les mêmes accesseurs que tous les autres problèmes du composant.
Commentaires limités : seules les identités explicitement listées sur le problème en tant qu'affecté, collaborateur, vérificateur ou copie de l'e-mail seront autorisées à commenter le problème, qu'elles aient ou non des autorisations de commentaire pour d'autres problèmes du composant. Les identités disposant de l'autorisation "Problèmes d'administration" sur le composant conservent également l'accès aux commentaires. L'accès en lecture reste par défaut.
Visibilité limitée : seules les identités explicitement listées (affecté, collaborateur, vérificateur ou copie) conservent l'accès en lecture au problème.
Visibilité limitée + Google : seules les identités explicitement listées (affecté, collaborateur, vérificateur ou copie), les Googleurs à temps plein et les comptes d'automatisation internes conservent l'accès en lecture au problème.