Un problème dans Google Issue Tracker est un rapport de bug, une demande de fonctionnalité, une demande de modification ou un élément du flux de travail qu'un utilisateur souhaite suivre, ou qu'un autre utilisateur ou une autre équipe souhaite suivre. Les problèmes sont organisés en composants, chacun contenant un groupe de problèmes associés. Dans Issue Tracker, chaque problème a sa propre page d'informations, sur laquelle les utilisateurs peuvent suivre l'activité liée, et sur laquelle ils peuvent ajouter des commentaires et mettre à jour les données concernant le 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é, et l'enregistrement de l'activité concernant 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 tout nouveau problème, plusieurs champs sont obligatoires. Celles-ci incluent le Composant, le Titre, la Priorité et le Type. Certains composants comportent également des champs personnalisés obligatoires.
Sur la page d'informations d'un problème, la plupart des champs se trouvent à droite dans le panneau Issue Fields (Champs du problème). Certains champs supplémentaires se trouvent dans la barre Problèmes associés en haut de la page. Presque tous les champs peuvent être modifiés dans Issue Tracker en cliquant sur le lien, la liste déroulante ou l'icône en forme de crayon associés. Lorsque vous pointez sur un champ, l'Issue Tracker fournit de brèves informations à son sujet lorsque vous passez la souris dessus.
Pour obtenir une description des champs par défaut qui posent problème, 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 nombreux groupes courants. Ce champ est obligatoire. Le tableau suivant indique 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 concerne un tiers et risque de 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 s'agir d'un bug ou d'une demande de fonctionnalité. |
| Nettoyage interne | Le problème n'a pas d'effet extérieur sur le comportement d'un produit, mais le résoudre permet une interaction plus rationalisée 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 diverses 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 des tâches administratives. |
| Faille | Les failles de confidentialité et de sécurité sont soumises aux SLO définis par les consignes de Google en matière de confidentialité et de sécurité. Lecture seule jusqu'au 01/11/2017. |
| Projet | un effort axé sur les objectifs avec un début et une fin finis, axés sur la création d’un produit, d’un service ou d’un résultat unique. |
| Étape | Une collection de travaux qui représentent une réalisation importante sur le chemin de la réalisation d’un projet. Les jalons peuvent également être utilisés pour représenter des lancements ou des versions. |
| Fonctionnalité | Ensemble de travaux qui fournissent une valeur spécifique à l'utilisateur. |
| Récit | Une grande collection de travaux pour atteindre un objectif commun. |
| Story | Une petite collection de travaux qui fournit une valeur spécifique à l’utilisateur. |
| Tâche | Une petite unité de travail. |
| Programme | Ensemble d'objectifs thématiques (projets, fonctionnalités, jalons, récits). |
Priorité du problème
Le champ Priorité vous permet d'indiquer 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. Ce type de problème entraîne une panne complète ou empêche tous les utilisateurs d'accéder à une fonction essentielle du produit, sans solution de contournement connue. |
| P1 | Un problème qui doit être traité rapidement. Ce type de problème a un impact significatif sur un grand pourcentage d'utilisateurs. S'il existe une solution de secours, elle est partielle ou trop pénible. L'impact du problème est sur une fonction organisationnelle essentielle ou entrave fondamentalement une autre équipe. |
| P2 | Un problème qui doit être traité dans un délai raisonnable. Il peut s'agir de l'un des problèmes suivants: 1) un problème de type P0 ou P1, mais avec une solution de contournement raisonnable ; 2) un problème important pour un grand pourcentage d'utilisateurs et lié à des fonctions organisationnelles principales ; 3) un problème qui entrave le travail d'autres équipes et ne dispose d'aucune solution raisonnable. Le niveau P2 est particulièrement adapté aux 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 traité dans la mesure du possible. Ce type de problème est pertinent pour les fonctions organisationnelles de base ou le travail d'autres équipes, mais n'entrave pas la progression ou n'a pas de solution de secours raisonnable. |
| P4 | Un problème qui doit être résolu au final. Ce type de problème n'est pas pertinent pour les fonctions organisationnelles de base ni pour le travail d'autres équipes. Il ne concerne que l'attractivité ou la convivialité 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 se produire pour qu'un problème change d'état ou soit résolu. Il n'est pas nécessaire d'utiliser toutes les valeurs disponibles des champs Status (État) pour suivre la résolution d'un problème. Le tableau suivant présente des utilisations courantes du champ Status:
| État du problème | Description |
|---|---|
| Nouveau | Aucune personne ou aucun groupe n'est attribué à ce problème. |
| Attribué | Le problème est attribué à une personne. Cette personne apparaît dans le champ Personne responsable. |
| En cours (accepté) | La personne responsable a pris connaissance du problème et a commencé à le résoudre. |
| Fixe | Le problème a été résolu. |
| Corrigé (validé) | Le problème a été résolu, et l'utilisateur a confirmé l'exactitude de sa correction dans le champ Vérificateur. |
| Won't fix (Not reproducible) (Ne sera pas corrigé, non reproductible) | Les informations sont insuffisantes pour résoudre le problème, ou le problème signalé ne peut pas être reproduit. |
| Won't fix (Intended behavior) (Ne sera pas corrigé, comportement intentionnel) | Le problème décrit le comportement attendu du produit dans les circonstances signalées. |
| Won't Fix (Obsolete) (Ne sera pas résolu, obsolète) | Ce problème n'est plus pertinent en raison des modifications apportées au produit. |
| Won't Fix (Infeasible) (Ne sera pas corrigé, infaisable) | Les modifications nécessaires pour résoudre le problème ne sont pas raisonnablement possibles. |
| Doublon | Le problème a été signalé ailleurs. Pour définir l'état d'un problème sur En double, consultez Dupliquer un problème. |
L'outil Issue Tracker considère que les problèmes sont ouverts ou fermés selon leur état. Les problèmes en cours sont ceux qui attendent d'être résolus. Cela inclut tous les problèmes dont l'état est Nouveau, Attribué ou En cours. Les problèmes fermés sont ceux qui ne nécessitent aucune autre action, à l'exception éventuellement d'une vérification. Cela inclut tous les problèmes dont l'état est Fixed (Résolu), Won't Fix (Ne sera pas corrigé) ou Duplicate (Double).
Icônes d'état
Les icônes d'état sont une représentation visuelle de l'état d'un problème. Une icône d'état apparaît à gauche d'un problème dans la liste déroulante Bloqué par ou Blocage. Ces icônes permettent d'évaluer rapidement la progression d'un problème de blocage sans avoir à quitter la page actuelle. Vous pouvez également définir la colonne État d'une page de résultats de recherche pour afficher des icônes d'état au lieu du texte d'état.
État des changements rapides
Il existe deux façons de modifier rapidement l'état d'un problème afin de le faire passer à l'étape type suivante du processus de résolution. Le premier est le bouton Change Status (Modifier l'état) situé dans la barre d'application, en haut de la page d'informations sur le problème, et le lien Change Status (Modifier l'état) dans le panneau Issue Fields (Champs du problème) à droite de la page. Cliquez sur l'une ou l'autre de ces options pour faire avancer l'état du problème comme suit:
Si le problème est nouveau et n'est pas attribué, ou si la personne responsable n'est pas la vôtre, l'invite de modification rapide indique M'assigner. Si vous modifiez rapidement l'état, la personne responsable vous désignera et, s'il est actuellement défini autrement, l'état du problème sera défini sur Assigned (Attribué).
Si vous êtes la personne responsable d'un problème et que son état est Assigned (Attribué), l'invite de modification rapide indique Start work (Commencer la tâche). Une modification rapide fait passer l'état du problème à En cours.
Si vous êtes la personne responsable d'un problème et que son état est En cours, l'invite de modification rapide indique Marquer comme résolu. Le changement rapide fait passer l'état du problème à Fixed (Résolu).
Si un problème affiche l'état Fixed (Résolu) et que vous êtes l'vérificateur, l'invite de modification rapide indique Verify (Vérifier). Une modification rapide fait passer l'état du problème à Fixed (Verified) (Corrigé (validé)).
Si un problème est à l'état fermé (Résolu, Doublon ou Ne sera pas résolu), l'invite de modification rapide indique Rouvrir (sauf dans le cas mentionné ci-dessus). Le changement rapide fait passer l'état à New (Nouveau) si aucun responsable n'a été attribué au problème, ou à Assigned (Attribué) s'il s'agit d'une personne responsable.
Fiches informatives sur les problèmes
La fiche informative sur un problème contient des informations telles que le titre, l'ID, la description et l'état actuel du problème. De plus, il contient un bouton M'envoyer une copie qui vous ajoute à la liste de destinataires du problème (si vous figurez déjà dans la liste, le bouton indique Un-CC Me). Exemple :
Des cartes de visite s'affichent lorsque vous pointez sur les éléments suivants:
- Identifiant du problème figurant dans l'onglet Bloqué par, Blocage ou Doublons de la barre Problèmes associés.
- ID du problème dans la colonne Bloqué par, Blocage ou Double de de la page des résultats de recherche d'un problème.
- Lien vers un problème détecté dans le panneau Recent Issues (Problèmes récents), à droite de la page Create Issue (Créer un problème).
- Status (État) sur une page de problème marquée comme doublon.
- Lien vers le problème canonique identifié dans la barre jaune en haut d'une page marquée comme doublon.
Problèmes de modification
Si vous disposez des autorisations Afficher et modifier pour un composant, vous pouvez modifier ses champs et y ajouter des commentaires. Toutefois, certains champs ne peuvent pas du tout être modifiés, tels que la date de création du problème ou les commentaires précédemment publiés.
Modifier les niveaux
Les modifications apportées à un problème ont un niveau d'importance variable. Elles déterminent si elles s'affichent dans le panneau d'historique du problème et si les utilisateurs reçoivent une notification par e-mail lorsque la modification se produit.
Dernières modifications
Lorsque vous arrêtez une modification, l'état d'un problème passe de Ouvert à Fermé. Les modifications finales s'affichent dans le panneau d'historique du problème. Les modifications de clôture sont envoyées sous forme de notifications par e-mail aux utilisateurs disposant de l'un des paramètres de notification suivants : Toutes les mises à jour, Mises à jour importantes ou Fermeture uniquement.
Pour obtenir la liste complète des états clôturer un problème ouvert, consultez État du problème.
Modifications importantes
Les modifications importantes 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 Toutes les mises à jour ou Mises à jour importantes. 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 a été déplacé vers un nouveau composant.
- Modifications apportées à la priorité, à la gravité, à la conservation ou à la personne responsable
- si l'état est Fermé, Validé ou Rouvert ;
- Modifications apportées aux champs personnalisés marqués comme Major
Modifications mineures
Les modifications mineures n'apparaissent dans le panneau d'historique d'un problème que si le niveau de filtre est défini sur Historique complet. De même, les modifications mineures sont uniquement envoyées sous forme de notifications par e-mail aux utilisateurs dont le rôle pour le problème est défini sur Toutes les mises à jour.
Voici quelques exemples de modifications considérées comme mineures:
- Modifications des titres
- Modifications de la liste de problèmes connus
- Ajout de pièces jointes
- Modifications apportées aux problèmes associés (blocage, blocage, doublons)
- Les changements d'état ne sont pas explicitement indiqués comme étant des modifications majeures.
- Modifications apportées aux champs suivants: Reporter, Type, Verifier, Found In, Targeted To, Verified In, In Prod
- Modifications apportées aux champs personnalisés marqués comme Mineurs
Modifications silencieuses
Les modifications silencieuses ne génèrent pas d'e-mails de notification pour les utilisateurs. Voici quelques exemples de modifications considérées comme silencieuses:
- Ajout ou suppression d'entrées dans les champs CC ou Collaborator (sauf si l'utilisateur ou le groupe vient d'être ajouté ou supprimé)
- Modification d'un commentaire
- Modification d'un champ personnalisé marqué comme Silencieux
Limites d'accès aux problèmes
Issue Tracker prend en charge les restrictions de contrôle d'accès qui permettent aux problèmes d'avoir un ensemble d'accesseurs plus petit que les autres problèmes concernant le même composant.
Les administrateurs de problèmes sont autorisés à mettre à jour l'état de restriction d'un problème en choisissant 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 présente 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 que responsables, collaborateurs, vérificateurs ou Cc seront autorisées à commenter le problème, qu'elles disposent ou non d'autorisations de commentaires pour d'autres problèmes dans le composant. Les identités disposant de l'autorisation "Problèmes d'administration" sur le composant conservent également l'accès en commentaire. L'accès en lecture reste la valeur par défaut.
Visibilité limitée : seules les identités explicitement répertoriées (responsable, collaborateur, vérificateur ou Cc) conservent l'accès en lecture au problème.
Visibilité limitée + Google : seules les identités explicitement répertoriées (personne responsable, collaborateur, vérificateur ou Cc), les Googleurs à temps plein et les comptes d'automatisation interne conservent un accès en lecture au problème.