Commentaires

Requirements Portal permet d’ajouter des commentaires dans vos projets d’exigences. Un commentaire est une note ajoutée par un utilisateur et associée à une exigence, une spécification, une section, une activité de V&V ou un bloc spécifique, à laquelle d’autres utilisateurs peuvent répondre. Les commentaires favorisent la collaboration entre les utilisateurs sans modifier les données partagées elles-mêmes, car ils sont stockés par le Workspace indépendamment de ces données. Vous pouvez mentionner une ou plusieurs personnes ou groupes dans le commentaire. Un commentaire peut également être attribué à un membre du Workspace.

Les commentaires sont publiés, reçoivent des réponses et sont gérés directement dans le tableau des exigences et l’arborescence du projet à l’aide d’une fenêtre de commentaires contextuelle. Ils sont également affichés dans le volet Comments and Tasks, situé sur la droite, qui offre principalement une vue d’ensemble et un outil de navigation plutôt qu’une interface de travail. Utilisez la commande  en haut à droite pour afficher ou masquer le volet Comments and Tasks.

Ajout d’un commentaire

Vous pouvez activer le mode d’ajout de commentaire de l’une des manières suivantes :

• Cliquez sur le bouton  en haut du volet Comments and Tasks, puis utilisez le curseur de placement qui apparaît () pour sélectionner une ligne d’exigence dans le tableau ou une spécification, une section, une activité de V&V ou un bloc dans l’arborescence du projet à gauche afin d’y ajouter un commentaire ().

• Cliquez sur le bouton  sur la ligne de l’exigence, puis sélectionnez la commande Comment dans le menu qui apparaît ().

• Faites un clic droit sur l’entrée de la spécification, de la section, de l’activité de V&V ou du bloc dans l’arborescence du projet à gauche, puis sélectionnez la commande Comment dans le menu contextuel ().

Dans chaque cas, une fenêtre de commentaires s’affiche pour vous permettre de rédiger le commentaire dans le contexte de l’entité sélectionnée. Saisissez votre commentaire dans le champ prévu à cet effet. Vous pouvez y mentionner une ou plusieurs personnes ou groupes. Saisissez le caractère @ dans le champ du commentaire pour accéder rapidement à la liste des membres du Workspace. Un commentaire peut également être attribué à un membre. Pour en savoir plus sur ces fonctionnalités supplémentaires, consultez la section Utilisation de la fenêtre de commentaires contextuelle.

Une fois le commentaire saisi, les mentions ajoutées et l’attribution effectuée si nécessaire, cliquez sur le bouton  en dessous. Le commentaire est alors enregistré et apparaît à la fois dans la fenêtre de commentaires contextuelle et dans le volet Comments and Tasks. Un marqueur de commentaire () s’affiche dans la colonne Identifier pour toute exigence comportant un commentaire.

La séquence d’images suivante montre un exemple d’ajout d’un commentaire à une exigence, avec la mention d’un membre de l’équipe et l’attribution d’une tâche à ce membre (voir les détails ci-dessous).

Utilisation de la fenêtre de commentaires contextuelle

Les points suivants concernent l’utilisation des commentaires et de la fenêtre de commentaires contextuelle de l’interface :

• Vous pouvez accéder à la fenêtre de commentaires en cliquant sur l’entrée du commentaire dans le volet Comments and Tasks.

  

• Vous pouvez déplacer librement la fenêtre en cliquant sur sa barre supérieure et en la faisant glisser.

• Utilisez les boutons en haut à gauche de la fenêtre de commentaires pour passer respectivement au commentaire précédent ou suivant.

  Vous pouvez également utiliser Shift+Left Arrow et Shift+Right Arrow pour passer respectivement au commentaire précédent ou suivant.

• Une fois le premier commentaire ajouté, la fenêtre de commentaires est prête à recevoir une réponse lorsque vous l’ouvrez. Saisissez votre texte dans le champ prévu à cet effet, puis cliquez sur le bouton pour l’enregistrer. Pour quitter sans répondre, appuyez sur Esc.

• Vous pouvez mentionner une personne ou un groupe dans un commentaire. Saisissez le caractère @ pour afficher une liste contextuelle de tous les membres de l’équipe du Workspace. Vous pouvez également rechercher un groupe ou une personne (par son nom ou son adresse e-mail) en saisissant @ suivi d’un ou plusieurs caractères : une liste des groupes, des membres de l’équipe et des personnes extérieures à l’équipe (mais appartenant à votre organisation) correspondant à la recherche s’affiche pour vous permettre de faire votre choix. Vous pouvez cliquer sur une entrée pour l’ajouter, ou utiliser les touches Up Arrow / Down Arrow et appuyer sur Enter pour l’ajouter.

  Une personne mentionnée qui est membre de l’équipe, ou qui appartient à un groupe mentionné, reçoit une notification du commentaire par e-mail.

  

  Vous pouvez mentionner n’importe quelle personne ou n’importe quel groupe dans un commentaire. Saisissez le caractère @ pour accéder à une liste de tous les membres et groupes du Workspace.

  

  Vous pouvez également saisir @ et commencer à taper pour rechercher un groupe ou une personne. La liste dynamique inclut les membres du Workspace, les autres personnes de votre organisation et les groupes définis pour le Workspace.

  

  Lorsque vous répondez à un commentaire, vous pouvez également attribuer une tâche à la personne nouvellement mentionnée.

  

  La personne, les personnes ou les groupes choisis apparaissent comme mentions dans le texte du commentaire (avec leur nom lorsque cela est possible).

   

• Vous pouvez attribuer une tâche à une personne mentionnée. Pour ce faire, activez l’option Assign a Task to : par défaut, la tâche est attribuée à la première personne mentionnée ou, si aucune mention n’est incluse, à vous-même (Me). Vous pouvez également utiliser le menu déroulant pour choisir un autre membre du Workspace à qui attribuer la tâche. La personne désignée est représentée dans l’entrée du volet Comments and Tasks par sa photo de profil ou sa lettre d’utilisateur, accompagnée d’une référence à la tâche. L’attribution de la tâche peut être modifiée ou supprimée lors de la modification du commentaire.

  

  Lorsqu’une tâche est associée à un commentaire, la bordure supérieure de sa fenêtre comprend :

  • une icône (image/lettre) indiquant le membre auquel la tâche du commentaire a été attribuée. Sélectionnez l’icône pour réattribuer la tâche à un autre membre de l’espace de travail dans la liste déroulante.

  • la référence alphanumérique de la tâche, composée de l’identifiant de l’entité suivi du numéro de la tâche. Cliquez sur la référence pour accéder directement à l’entrée de cette tâche sur la page Tasks de l’espace de travail.

    Depuis la page Tasks de l’espace de travail, vous pouvez également consulter et modifier la priorité de la tâche (Medium par défaut).

  • l’état d’activité actuel de la tâche (To Do, In Progress, Resolved), qui peut être modifié dans le menu déroulant associé ().

  

• Une tâche peut être ajoutée à un commentaire existant à l’aide de l’option Convert to Task disponible dans le menu  de la fenêtre. La nouvelle tâche vous est initialement attribuée et peut être réattribuée à un autre membre de l’espace de travail en sélectionnant son entrée dans la liste déroulante accessible depuis l’avatar de la personne assignée (en haut à gauche).

  

• La fenêtre de commentaire accepte également un fichier image ou une capture d’écran collés depuis le presse-papiers Windows. Vous pouvez coller la capture d’écran (ou le fichier image copié) dans le champ de commentaire avant ou après les notes textuelles et les mentions d’utilisateurs. L’image s’affiche dans le corps de la fenêtre de commentaire : cliquez dessus pour l’ouvrir en taille réelle. L’entrée du commentaire ajouté dans le panneau Comment and Tasks comprendra une note includes images correspondante.

  

• Un commentaire peut être modifié ou supprimé, uniquement depuis la fenêtre de commentaire, à l’aide des commandes Edit et Delete respectivement. Celles-ci sont disponibles dans le menu associé à la commande . Notez que ces commandes ne sont disponibles que pour les commentaires que vous avez vous-même rédigés : vous ne pouvez ni modifier ni supprimer un commentaire rédigé par un autre utilisateur. Pour modifier un commentaire existant, apportez vos modifications, puis cliquez sur le bouton  pour les valider. Pour quitter sans appliquer les modifications, appuyez sur Esc.

  Si vous supprimez un commentaire, sachez que toutes les réponses associées seront également supprimées.

  

• Lorsque vous ouvrez la fenêtre de commentaire, seuls le premier et le dernier commentaire du fil sont affichés. Pour afficher tous les commentaires du fil, cliquez sur la commande située entre ces entrées. Utilisez la barre de défilement pour parcourir l’ensemble des commentaires.

  

• Un commentaire peut être marqué comme résolu (ou réactivé) en actionnant la commande en haut de la fenêtre de commentaire. Lorsque le commentaire est associé à une tâche attribuée, son état actuel peut être défini sur Resolved (ou une autre valeur) dans le menu déroulant des états. Les commentaires résolus ne sont pas affichés par défaut dans le panneau Comments and Tasks, mais peuvent être rendus visibles à l’aide de son option d’affichage/masquage des repères. Consultez la section suivante pour plus d’informations.

  

Utilisation du panneau Comments

Les points suivants concernent l’utilisation des commentaires et du panneau Comments and Tasks de l’interface :

• Le panneau Comments and Tasks sert d’outil de vue d’ensemble et de navigation parmi les commentaires du projet, plutôt que d’interface permettant de publier, de modifier et de répondre aux commentaires. Ces fonctionnalités sont exclusivement disponibles dans la fenêtre de commentaire contextuelle.

• Le panneau Comments and Tasks peut également être ouvert en cliquant sur un repère de commentaire dans la zone d’affichage principale. Cette action ouvre également la fenêtre de commentaire contextuelle.

• Utilisez la commande en haut à droite du panneau pour afficher les repères de commentaires dans le tableau des exigences () ou les masquer ().

  

  

   

• En haut du panneau Comments and Tasks se trouvent des commandes donnant accès aux options de filtrage des fils de commentaires, afin de déterminer ce qui s’affiche dans le panneau. Deux niveaux de filtrage peuvent être définis. Le premier niveau, ou niveau principal, permet de contrôler quels commentaires d’utilisateurs sont affichés.

  

  Les options de filtrage du panneau limitent les entrées de commentaires aux éléments suivants :

  • Tasks only – uniquement les commentaires attribués en tant que tâches utilisateur, qui sont à leur tour accessibles dans le flux de la page Tasks.

  • Assigned to – uniquement les commentaires attribués aux utilisateurs sélectionnés dans la liste ci-dessous. Lorsque la case d’un utilisateur est cochée, le panneau (et le document affiché) n’inclut que les commentaires dont les tâches sont attribuées à cet utilisateur. Notez que l’utilisateur actuellement connecté figure en tête de liste, qu’une tâche de commentaire lui soit attribuée ou non.

  Le second niveau de filtrage, appliqué conjointement à la méthode de filtrage principale, propose deux options permettant de masquer tous les commentaires ou tâches résolus (Unresolved only activé) et/ou de n’afficher que les commentaires du contexte actuellement sélectionné (c’est-à-dire un dossier, une spécification, une section, une activité V&V ou un bloc), plutôt que ceux de l’ensemble du projet (Current context only activé).

  

• Cliquez sur l’entrée Notification Settings (au bas de la fenêtre d’options ci-dessus) pour accéder à une fenêtre permettant de configurer les commentaires du projet pour lesquels vous recevrez des notifications par e-mail. Vous pouvez choisir de recevoir des notifications pour tous les fils de commentaires, pour aucun, ou uniquement pour ceux auxquels vous participez (que vous avez créés, auxquels vous avez répondu ou dans lesquels vous avez été mentionné).

  

• Le classement des fils de commentaires dans le panneau comporte lui aussi deux niveaux. Tout d’abord, les commentaires sont classés selon les entités auxquelles ils appartiennent, dans le même ordre que la structure du projet dans l’arborescence de gauche. Ensuite, pour chaque entité, les commentaires sont classés par date de création, par ordre décroissant.

• Lorsque vous cliquez sur l’entrée d’un fil de commentaires dans le panneau, le commentaire correspondant s’ouvre dans la fenêtre de commentaire contextuelle. L’entrée du commentaire dans le panneau Comments and Tasks est également surlignée en bleu. Si vous cliquez sur un commentaire qui n’appartient pas à l’entité actuellement affichée, vous êtes redirigé vers l’entité qui le contient.

  

• Chaque entrée de commentaire du panneau présente un résumé des informations essentielles relatives à ce commentaire, comme illustré dans l’exemple ci-dessous.