Révision (CMMI)

Cette rubrique vous explique comment indiquer les détails d'un élément de travail Révision. Une équipe peut utiliser l'élément de travail Révision pour documenter les résultats d'une révision de design ou de code. Les membres de l'équipe peuvent capturer des détails relatifs à la façon dont le design ou le code sont conformes aux normes dans les domaines de la correction du nom, de la pertinence du code, de l'extensibilité, de la complexité du code, de la complexité algorithmique et de la sécurité du code. Pour plus d'informations, consultez Implémentation des tâches de développement.

Pour plus d'informations sur la création de ce type d'élément de travail, consultez Éléments de travail et flux de travail (CMMI).

Autorisations requises

Pour afficher une révision, vous devez être membre du groupe Readers ou disposer de l'autorisation Afficher les éléments de travail dans ce nœud avec la valeur Autoriser. Pour modifier une révision, vous devez être membre du groupe Contributors ou disposer des autorisations Modifier les éléments de travail dans ce nœud avec la valeur Autoriser. Pour plus d'informations, consultez Gestion des autorisations.

Définition d'une révision

Le formulaire d'élément de travail d'une révision stocke des données dans les champs et onglets indiqués dans l'illustration suivante :

Lorsque vous définissez un examen, vous devez définir le Titre dans la section supérieure du formulaire d'élément de travail et l'Objectif sous l'onglet Détails. Vous pouvez laisser tous les autres champs vides ou accepter leurs valeurs par défaut.

Pour définir une révision unique

1. Dans la section supérieure du formulaire d'élément de travail, spécifiez un ou plusieurs des types d'informations suivants :

   • Dans Titre (obligatoire), tapez une description courte qui distingue la révision des autres éléments de travail Révision.

     Un titre approprié identifie la section de code ou la zone de conception ayant été révisée.

   • Dans la liste Type de réunion, cliquez sur le type de réunion utilisé pour la révision.

     Les valeurs valides sont Réunion ou Hors connexion.

   • Dans la liste Assigné à, cliquez sur le nom du membre de l'équipe responsable de la gestion de la révision.

     Notes

     Vous ne pouvez assigner des éléments de travail qu'aux membres du groupe Contributors.

     Si vous laissez la révision non assignée, elle vous est automatiquement assignée.

   • Dans la liste État, conservez la valeur par défaut Actif.

   • Dans la section Facilitateurs, cliquez sur le nom du membre de l'équipe qui a convoqué la réunion et tapez la date de celle-ci.

2. Sous l'onglet Détails, fournissez autant de détails que vous le souhaitez pour décrire la zone de code ou conception ayant été révisée, en plus des critères appliqués pour la révision.

3. Sous l'onglet Minutes, fournissez autant de détails que vous le souhaitez pour décrire les résultats, discussions, critères et décisions qui ont résulté de la réunion de révision.

   Ces informations peuvent inclure les éléments révisés, les critères appliqués et les problèmes identifiés.

4. Sous l'onglet Commentaires, tapez les éventuelles diverses informations relatives à la révision qui ne sont pas capturées de façon appropriée ailleurs.

5. Sous l'onglet Participants, cliquez sur le nom de chaque membre de l'équipe qui est un participant obligatoire, facultatif ou réel de la révision.

   Ces membres de l'équipe sont membres du comité de révision.

6. Sous l'onglet Tous les liens, liez la révision à un ou plusieurs autres éléments de travail, tels qu'une spécification ou une tâche.

7. Sous l'onglet Pièces jointes, joignez des spécifications, des images ou d'autres fichiers qui fournissent des détails supplémentaires sur la révision à effectuer.

   Pour plus d'informations, consultez les sections suivantes plus loin dans cette rubrique :

   • Liaison d'une révision à une spécification, une tâche ou un autre élément de travail

   • Ajout de détails, pièces jointes ou liens hypertexte à une révision

8. Cliquez sur Enregistrer l'élément de travail .

   Notes

   Une fois que vous avez enregistré la révision, l'identificateur s'affiche dans le titre situé sous la barre d'outils d'élément de travail.

Liaison d'une révision à une spécification, une tâche ou un autre élément de travail

Vous utilisez l'onglet Liens pour créer des liens vers des types spécifiques d'éléments de travail et pour des types spécifiques de liens. Pour plus d'informations, consultez Liaison d'éléments de travail (CMMI).

Pour créer et lier une tâche, une spécification ou un autre élément de travail à une révision

1. Ouvrez le formulaire de l'élément de travail Révision, cliquez sur l'onglet Tous les liens, puis choisissez Nouveau.

   La boîte de dialogue Ajouter un nouvel élément de travail lié s'ouvre.

   

2. Dans la liste Type de lien, cliquez sur Associé ou sur un autre type de lien qui représente la relation dont vous souhaitez effectuer le suivi.

3. Dans la liste Type d'élément de travail, cliquez sur le type d'élément de travail que vous souhaitez créer.

4. Dans Titre, tapez une description brève mais spécifique.

5. (Facultatif) Dans Commentaire, tapez des informations supplémentaires.

6. Cliquez sur OK.

   Un formulaire du type d'élément de travail spécifié s'ouvre avec les informations que vous avez fournies.

7. Spécifiez les champs restants comme décrit dans les rubriques suivantes :

   • Spécification (CMMI)

   • Demande de modification (CMMI)

   • Tâche (CMMI)

   • Bogue (CMMI)

   • Cas de test (Agile)

   • Problème (CMMI)

8. Cliquez sur Enregistrer l'élément de travail.

Pour lier un ou plusieurs éléments de travail existants à une révision

1. Ouvrez le formulaire de l'élément de travail Révision, cliquez sur l'onglet Tous les Liens, puis choisissez Lier à.

   La boîte de dialogue Ajouter un lien à Révision s'ouvre.

   

2. Dans la liste Type de lien, cliquez sur Associé ou un autre type de lien qui représente la relation que vous souhaitez suivre selon le type d'élément de travail auquel vous établissez une liaison.

3. Effectuez l'une des actions suivantes :

   • Dans ID des éléments de travail, tapez les ID des éléments de travail que vous souhaitez rechercher. Séparez-les par des virgules ou des espaces.

   • Cliquez sur Parcourir pour spécifier des éléments de travail à partir d'une liste.

     La boîte de dialogue Choisir des éléments de travail liés s'affiche.

     

     Dans la liste Requête enregistrée, cliquez sur une requête qui contient les éléments de travail que vous voulez ajouter. Par exemple, vous pouvez cliquer sur Éléments de travail ouverts, Bogues actifs ou Tâches actives.

     Cliquez sur Rechercher, activez la case à cocher située en regard de chaque élément de travail à lier au problème, puis cliquez sur OK.

   • (Facultatif) Tapez une description pour les éléments auxquels vous voulez établir un lien.

4. Cliquez sur OK.

   Pour plus d'informations, consultez Rechercher les éléments de travail à lier ou importer.

5. Cliquez sur Enregistrer l'élément de travail .

   Notes

   La révision et les éléments de travail auxquels vous la liez sont tous mis à jour.

Ajout de détails, pièces jointes ou liens hypertexte à une révision

À mesure que des informations deviennent disponibles, vous pouvez les ajouter à une révision de différentes façons :

• Tapez les informations dans les zones sur les onglets Détails, Minutes ou Commentaires.

• Joignez un fichier.

  Par exemple, vous pouvez joindre un thread de messagerie électronique, un document, une image, un fichier journal ou un autre type de fichier.

• Ajouter un lien hypertexte à un site Web ou à un fichier stocké sur un serveur ou un site Web.

Pour ajouter des détails à une révision

1. Cliquez sur l'onglet Détails, Minutes ou Commentaires, et tapez des informations dans les zones.

   Vous pouvez mettre en forme des informations pour insister sur leur importance ou capturer une liste à puces.

   Notes

   Chaque fois qu'un membre de l'équipe met à jour l'élément de travail, son historique affiche la date de la modification, le nom du membre de l'équipe qui l'a apportée et les champs qui ont été modifiés.

   Pour plus d'informations, consultez Champs de réunion de révision (CMMI) et Titres, ID, descriptions et historique (Agile).

2. Cliquez sur Enregistrer l'élément de travail .

Pour ajouter une pièce jointe à une révision

1. Sous l'onglet Pièces jointes, effectuez l'une des opérations suivantes :

   • Faites glisser un fichier vers la zone des pièces jointes.

   • Cliquez sur ou appuyez sur CTRL+V pour coller un fichier que vous avez copié.

   • Cliquez sur Ajouter, sur Parcourir, puis, dans la boîte de dialogue Pièce jointe, tapez ou recherchez le nom du fichier que vous souhaitez joindre.

     (Facultatif) Dans la zone Commentaire, tapez des informations supplémentaires sur la pièce jointe. Pour fermer la boîte de dialogue Pièce jointe, cliquez sur OK.

2. Cliquez sur Enregistrer l'élément de travail .

Pour ajouter un lien hypertexte à une révision

1. Sous l'onglet Tous les liens, cliquez sur Lier à .

   

2. Dans la liste Type de lien, cliquez sur Lien hypertexte.

3. Dans la zone Adresse, exécutez l'une des actions suivantes :

   • Si la cible est un site Web, tapez l'URL ou copiez-la depuis votre navigateur Internet et collez-la dans la zone Adresse.

   • Si la cible est un emplacement de serveur, tapez son adresse UNC.

4. (Facultatif) Dans la zone Commentaire, tapez des informations supplémentaires sur le lien hypertexte.

5. Cliquez sur OK.

6. Cliquez sur Enregistrer l'élément de travail.

Modification de l'état d'une révision

Si la révision indique que le design ou le code n'a pas besoin d'être modifié, l'élément de travail Révision peut être fermé. Si le design ou le code a besoin de modifications mineures ou majeures, l'élément de travail Révision actif est assigné à un développeur pour être résolu. Si seuls des changements mineurs sont requis, le développeur peut fermer l'élément de travail Révision. Si des modifications majeures sont nécessaires, une deuxième révision est obligatoire, et l'élément de travail Révision est fermé uniquement si la deuxième révision réussit.

Les membres de l'équipe peuvent utiliser les états suivants pour effectuer le suivi de la progression des révisions :

• Active

• Résolu

• Closed

Vous créez une révision avec l'état Actif.

Pour plus d'informations sur les champs de données que vous pouvez utiliser pour effectuer le suivi des états des éléments de travail, consultez Assignations, flux de travail et planification (CMMI).

Pour changer l'état d'une révision

1. Ouvrez l'élément de travail Révision.

2. Dans la liste État, cliquez sur Résolu ou Fermé.

   • Si vous remplacez l'état Actif par Résolu, le champ Raison devient automatiquement Accepté avec des modifications mineures.

   • Si vous remplacez l'état Résolu par Fermé, le champ Raison affiche Modifications mineures terminées.

3. Cliquez sur Enregistrer l'élément de travail .

Progression classique de flux de travail : Un membre de l'équipe crée une révision avec l'état Actif et la raison par défaut Nouveau. Un membre de l'équipe remplace l'état de la révision Actif par Résolu lorsque le comité de révision détermine que le code est acceptable si des modifications mineures sont apportées. Un membre de l'équipe remplace l'état Résolu par Fermé une fois que toutes les modifications obligatoires ont été apportées. Transitions atypiques : Un membre de l'équipe remplace l'état Actif par Fermé avec la raison par défaut Accepté (tel quel). Le comité de révision détermine que des modifications majeures doivent être apportées au code et remplace l'état Résolu par Actif. Un membre de l'équipe détermine que la révision a été fermée par erreur et remplace l'état Fermé par Actif.

Diagramme d'état des révisions

Actif (Nouveau)

Un élément de travail Révision actif documente les résultats d'une révision de design ou de code. Les participants de la réunion de révision déterminent quelles doivent être les étapes suivantes. L'élément de travail Révision est fermé si aucune modification n'est nécessaire. Il reste actif et est assigné au développeur approprié si des modifications sont requises. Le développeur résout l'élément de travail Révision une fois les modifications effectuées.

De l'état Actif à Résolu

Un membre de l'équipe peut résoudre une révision active pour les raisons décrites dans le tableau suivant :

Les champs de données suivants sont capturés lorsqu'un membre de l'équipe résout une révision active :

• Résolu par : nom du membre de l'équipe qui a résolu la révision.

• Date de résolution : date et heure de résolution de la révision selon l'enregistrement de l'horloge du serveur.

• Date de modification d'état : date et heure de modification de l'état de la révision.

De l'état Actif à Fermé

Un membre de l'équipe peut fermer une révision active lorsque le comité de révision décide, pour quelque raison que ce soit, qu'aucune modification n'est requise. Le champ Raison prend automatiquement la valeur Accepté (tel quel).

Les champs de données suivants sont capturés lorsqu'un membre de l'équipe ferme une révision active :

• Fermé par : nom du membre de l'équipe qui a fermé la révision.

• Date de fermeture : date et heure de fermeture de la révision selon l'enregistrement de l'horloge du serveur.

• Date de modification d'état : date et heure de modification de l'état de la révision.

Résolu

Un élément de travail Révision résolu indique que les modifications requises, qu'elles soient mineures ou majeures, ont été apportées. S'il s'agissait de modifications majeures, une deuxième révision est requise pour que l'élément de travail Révision puisse être fermé. Si la deuxième révision révèle des modifications supplémentaires, l'élément de travail Révision est réactivé.

De l'état Résolu à Fermé

Un membre de l'équipe peut fermer une révision résolue pour la raison décrite dans le tableau suivant :

Les champs de données suivants sont automatiquement capturés lorsqu'un membre de l'équipe ferme une révision résolue :

• Fermé par : nom du membre de l'équipe qui a fermé la révision.

• Date de fermeture : date et heure de fermeture de la révision selon l'enregistrement de l'horloge du serveur.

• Date de modification d'état : date et heure de modification de l'état de la révision.

De l'état Résolu à Actif

Vous pouvez réactiver une révision résolue pour la raison décrite dans le tableau suivant :

Les données suivantes sont automatiquement capturées lorsqu'un membre de l'équipe réactive une révision résolue :

• Activé par : nom du membre de l'équipe qui a réactivé la révision.

• Date d'activation : date et heure de réactivation de la révision selon l'enregistrement de l'horloge du serveur.

• Date de modification d'état : date et heure de modification de l'état de la révision.

Closed

Il n'est pas possible de travailler sur une révision fermée, mais celle-ci peut être réactivée si elle revient dans la portée. Le plus souvent, un analyste d'entreprise ou un chef de projet réactive une révision fermée.

De l'état Fermé à Actif

Un élément de travail Révision fermé indique que la révision est terminée et que toutes les modifications nécessaires ont été apportées. Vous pouvez réactiver une révision fermée si elle a été fermée par erreur. La raison de la réactivation a la valeur Fermé avec erreur.

Les données suivantes sont automatiquement capturées lorsqu'un membre de l'équipe réactive une révision fermée :

• Activé par : nom du membre de l'équipe qui a réactivé la révision.

• Date d'activation : date et heure de réactivation de la révision selon l'enregistrement de l'horloge du serveur.

• Date de modification d'état : date et heure de modification de l'état de la révision.

Voir aussi

Concepts

MSF for CMMI Process Improvement v5.0

Autres ressources

Champs de réunion de révision (CMMI)

Tâche (CMMI)

Éléments de travail et flux de travail (CMMI)