Revues

Une revue est un ensemble d'artefacts que vous créez pour les faire réviser par des membres précis de l'équipe. La revue suit un cycle de vie qui évolue au fur et à mesure que les participants l'effectuent.

Vous pouvez créer une revue pour certains artefacts que vous sélectionnez ou bien vous pouvez créer une revue d'une collection.

Vous créez une revue pour certains artefacts en cliquant sur l'icône Créer une revue dans la section Revues de la barre latérale. Après avoir indiqué un nom pour la revue, vous y ajoutez des artefacts et des participants en cliquant sur les boutons appropriés dans l'Editeur de revue, puis en cliquant sur le bouton Démarrer la revue. Des notifications par e-mail sont automatiquement envoyées aux participants lorsqu'une revue est démarrée et chaque fois que certains événements se produisent au cours de la revue. Les participants se joignent à la revue en cliquant sur le nom de la revue, qui apparaît dans le tableau de bord de chaque participant.

Il existe deux sortes de revue : une revue formelle et une revue informelle.

Lorsque vous ajoutez un participant à une revue, vous attribuez au participant un rôle qui détermine les actions requises pour effectuer la revue. Le tableau suivant décrit ces rôles et actions.

Tableau 1. Rôle de réviseur et action requise
Rôle de participant Action requise
Valideur Ce participant doit approuver (icône), rejeter (icône) ou bien s'abstenir (icône) pour chaque artefact de la revue pour que cette dernière puisse passer à l'état Révisé ou Finalisé. Notez que l'icône qui correspond au choix du participant apparaît dans la colonne d'état des fenêtres de l'éditeur de revue.
Réviseur Ce participant doit réviser un artefact (icône révisé) ou bien s'abstenir (icône) d'analyser l'artefact pour que la revue puisse passer à l'état Révisé ou Finalisé.
Facultatif Ce participant peut aussi réviser ou s'abstenir de réviser un artefact. Toutefois, la revue peut passer à l'état Finalisé ou Révisé indépendamment de ce que fait ce participant.

Etats de la revue au cours de son cycle de vie

L'état de la revue change en fonction de sa finalisation. Voici la séquence principale parcourue par une revue au cours de son cycle de vie :

Brouillon > En cours > Révisé > Finalisé

Le tableau suivant décrit les états du cycle de vie d'une revue :
Tableau 2. Etats d'une revue au cours de son cycle de vie
Etats d'une revue Description
Brouillon L'état initial d'une revue dans lequel le créateur de la revue attribue une date limite, ajoute des instructions de revue, ajoute des participants, attribue des rôles aux participants et ajoute des artefacts à la revue. Les participants ne sont pas avisés lorsque la revue est à l'état de brouillon.
En cours Lorsque le créateur de la revue clique sur le bouton Démarrer la revue, la revue passe à l'état En cours. Les participants se joignent à la revue en cliquant sur le titre de la revue, qui apparaît sur leur tableau de bord. Lorsque tous les participants ont terminé de réviser les artefacts, la revue passe à l'état Révisé.
Suspendu Etat temporaire dans lequel la revue a été suspendue. Cet état permet au créateur de la revue de modifier les participants, leurs rôles ou les artefacts qui constituent la revue. Dans une revue formelle, le créateur peut aussi choisir d'obtenir la dernière version des artefacts, auquel cas tous les artefacts qui ont été initialement capturés dans la revue sont remplacés par les dernières versions des artefacts. Notez que les participants ne peuvent pas ajouter des commentaires de revue ou marquer les artefacts comme révisés lorsque la revue est suspendue. Le créateur de la revue doit cliquer sur le bouton Continuer pour reprendre la revue.
Revisé Les réviseurs ont ajouté des commentaires aux artefacts et ont cliqué sur le bouton Terminé dans leur revue. Le créateur de la revue (ou un administrateur) peut toujours apporter des modifications à la revue à ce stade en suspendant la revue et en apportant les modifications.
Finalisé Tous les réviseurs nécessaires ont terminé la revue et le créateur a cliqué sur le bouton Finaliser la revue. La revue est enregistrée et ne peut plus être modifiée. Dans le cas d'une revue formelle, les versions spécifiques des artefacts qui ont été approuvées sont également enregistrées. Vous pouvez maintenant créer une collection contenant les artefacts révisés pour continuer d'utiliser ces artefacts en dehors de la revue.

Sections de l'éditeur de revue

Lorsqu'un participant ouvre une revue, l'éditeur de revue apparaît avec deux sections réductibles : Revue du participant et Revue générale. Les participants peuvent basculer entre les deux sections en cliquant sur la flèche de la revue du participant (flèche du participant) ou bien sur la flèche de la revue générale (flèche générale) (ou en cliquant dans les en-têtes des sections)

Dans la Revue du participant, le participant voit le rôle de participant et les artefacts qui constituent la revue. Le participant affiche un artefact en cliquant deux fois dessus, ce qui affiche l'artefact en mode lecture seule. Ensuite, suivant le rôle attribué au participant, le participant approuve, marque comme révisé, rejette ou s'abstient.

Dans la Revue générale, le participant voit les artefacts et les participants qui constituent la revue, mais seul le créateur de la revue (ou un administrateur) peut apporter des modifications à la revue. Le créateur de la revue peut la modifier en cliquant sur Suspendre, puis en apportant les modifications. Le créateur peut modifier les participants, leurs rôles ou les artefacts qui constituent la revue. Le créateur peut même remplacer la version en cours des artefacts de la revue par la version la plus récente des artefacts du projet.

Notification par courrier électronique

Vous pouvez ajouter manuellement des commentaires à une revue dans la barre latérale de l'éditeur de revue. Toutefois, la plupart des événements génèrent automatiquement une notification par e-mail aux participants à la revue.
Remarque : Si la messagerie n'a pas été configurée lors de la première installation du produit, vous devez d'abord configurer les paramètres de messagerie sur le serveur pour activer les notifications automatiques par e-mail.
Le tableau suivant fournit une description des événements qui entraînent l'envoi des notifications par e-mail.
Tableau 3. Evénements pour la notification par courrier électronique
Destinataire de la notification Evénements entraînant l'envoi de notifications par e-mail
Tous les participants Lorsque la revue est démarrée ou que des ajouts ou des modifications sont apportés à certaines propriétés, telles que la date de fin, le statut et des instructions de revue.
Tous les participants Des artefacts sont ajoutés à la revue ou supprimés de la revue
Participants spécifiques Des participants sont ajoutés à la revue ou supprimés de la revue.
Participants spécifiques Modification de leur statut ou d'un statut d'artefact qui les concerne. Cet événement se produit lorsque le créateur de la revue réinitialise le statut du participant.
Participant spécifique Le rôle de réviseur se modifie.

Revue d'une collection.

Vous pouvez non seulement créer une revue pour certains artefacts, mais aussi créer une revue pour une collection. Vous créez une revue d'une collection depuis l'éditeur de collection ou depuis le menu contextuel de collection. Lorsque vous créez une revue d'une collection, tenez compte des points suivants :

Vos commentaires