Commentaires

Requirements Portal prend en charge les commentaires au sein de vos projets d’exigences. Un commentaire est une note ajoutée par un utilisateur, associée à une exigence spécifique, à laquelle d’autres utilisateurs peuvent répondre. Les commentaires favorisent la collaboration entre 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 à l’aide d’une fenêtre de commentaire contextuelle. Les commentaires sont également présentés dans le volet Comments and Tasks, affiché sur le côté droit, qui sert davantage d’outil de vue d’ensemble/de navigation que d’interface opérationnelle. Utilisez la commande  en haut à droite pour afficher ou masquer le volet Comments and Tasks.

Placer un commentaire

Le mode de placement de commentaire peut être activé de l’une des façons suivantes :

• Cliquez sur le bouton  en haut du volet Comments and Tasks, puis utilisez le curseur de placement obtenu () pour sélectionner une ligne d’exigence à commenter.

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

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

Une fois le commentaire saisi, les mentions ajoutées et l’attribution effectuée si nécessaire, cliquez sur le bouton  ci-dessous. Le commentaire sera enregistré et apparaîtra à la fois dans la fenêtre de commentaire contextuelle et dans le volet Comments and Tasks.

L’image de séquence suivante montre l’ajout d’un exemple de commentaire à une exigence, ainsi que l’ajout d’une mention d’un membre de l’équipe et l’attribution d’une tâche à celui-ci (voir ci-dessous pour plus de détails).

Utilisation de la fenêtre de commentaire contextuelle

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

• La fenêtre de commentaire est accessible en cliquant sur l’entrée de commentaire dans le volet Comments and Tasks.

  

• La fenêtre peut être déplacée librement en cliquant sur sa barre supérieure et en la faisant glisser.

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

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

• Une fois un premier commentaire créé, la fenêtre de commentaire, lorsqu’elle est ouverte, sera prête pour la saisie d’une réponse. Saisissez votre texte dans le champ prévu, 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 accéder à une fenêtre contextuelle listant tous les membres de l’équipe du Workspace. Vous pouvez également rechercher le groupe ou la personne (cette dernière par son nom ou son e-mail) en saisissant @ suivi d’un ou plusieurs caractères : une liste des groupes correspondants, des membres de l’équipe et des personnes extérieures à l’équipe (mais au sein de votre organisation) s’affichera pour vous permettre de choisir. Vous pouvez soit cliquer sur une entrée pour l’ajouter, soit utiliser les touches Up Arrow / Down Arrow et appuyer sur Enter pour l’ajouter.

  Une personne mentionnée qui est soit membre de l’équipe, soit membre d’un groupe mentionné, recevra un e-mail de notification du commentaire.

  

  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 comprend les membres du Workspace, d’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 ou les personnes, ou les groupes requis apparaîtront comme mentionnés dans le texte du commentaire (par leur nom lorsque cela est possible).

   

• Vous pouvez attribuer une tâche à une personne qui a été mentionnée. Activez l’option Assign a Task to en conséquence : par défaut, elle s’applique à 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 auquel attribuer la tâche. La personne désignée est affichée dans l’entrée du volet Comments and Tasks sous la forme de son image/lettre de profil utilisateur, avec une référence de tâche associée. L’attribution de la tâche peut être modifiée ou supprimée lors de l’édition du commentaire.

  

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

  • 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 du Workspace à partir de la liste déroulante.

  • la référence alphanumérique de la tâche, composée de l’identifiant de l’exigence avec un suffixe de numéro de tâche. Cliquez sur la référence pour effectuer un cross-probe vers l’entrée de cette tâche sur la page Tasks page du Workspace.

    Depuis la page Tasks du Workspace, vous pouvez également voir 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é à partir du 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 du Workspace en sélectionnant son entrée dans la liste déroulante ouverte depuis l’avatar du destinataire (en haut à gauche).

  

• La fenêtre de commentaire accepte également un fichier image ou une capture d’écran copiée 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 toute note textuelle et mention d’utilisateur. Les images sont affichées dans le corps de la fenêtre de commentaire ; cliquez sur l’image pour l’ouvrir en taille réelle. L’entrée du commentaire placé dans le volet Comment and Tasks inclura une note includes images associée.

  

• Un commentaire peut être modifié ou supprimé, uniquement via 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 seront disponibles que pour un commentaire que vous avez vous-même créé : vous ne pouvez pas modifier ni supprimer un commentaire créé par un autre utilisateur. Si vous modifiez un commentaire existant, effectuez vos changements, puis cliquez sur le bouton  pour les enregistrer. 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 la fenêtre de commentaire est ouverte, seuls les commentaires initial et le plus récent du fil sont affichés. Pour voir tous les commentaires du fil, cliquez sur la commande disponible entre ces entrées. Utilisez la barre de défilement pour parcourir tous les commentaires.

  

• Un commentaire peut être résolu (ou réactivé) en basculant le contrôle en haut de la fenêtre de commentaires. Lorsqu’un commentaire comporte une tâche assignée, son statut actuel peut être modifié en Resolved (ou à un autre niveau) à partir du menu déroulant de statut. Les commentaires résolus ne sont pas affichés par défaut dans le volet Comments and Tasks, mais peuvent être affichés via son option d’affichage/masquage des repères – voir la section suivante pour plus d’informations.

  

Utilisation du volet des commentaires

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

• Le volet Comments and Tasks sert d’outil de vue d’ensemble/de navigation pour les commentaires dans l’ensemble du projet, plutôt que d’interface opérationnelle pour publier, modifier et répondre. Cette fonctionnalité est laissée exclusivement à la fenêtre contextuelle de commentaires.

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

  

  Les options de filtrage du volet limitent les entrées de commentaires à :

  • Tasks only – uniquement les commentaires qui ont été assignés comme tâches utilisateur, et qui sont à leur tour disponibles dans le flux de la page Tâches.

  • Assigned to – uniquement les commentaires assignés aux sélections d’utilisateurs listées ci-dessous. Lorsqu’une case utilisateur est cochée, le volet (et le document affiché) inclura uniquement les commentaires dont des tâches sont assignées à cet utilisateur. Notez que l’utilisateur actuellement connecté est inclus en haut de la liste, indépendamment de toute assignation de tâche de commentaire.

  Le niveau secondaire de filtrage, appliqué conjointement à la méthode de filtrage principale, propose deux options qui vous permettent de masquer tous les commentaires ou tâches résolus (Unresolved only activé) et/ou d’afficher uniquement les commentaires du contexte actuellement sélectionné (c’est-à-dire dossier, spécification ou section) plutôt que de l’ensemble du projet (Current context only activé).

  

• Cliquez sur l’entrée Notification Settings (en 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. Choisissez de recevoir des notifications pour tous les fils de commentaires, pour aucun, ou uniquement pour ceux dans lesquels vous êtes impliqué(e) (que vous avez initiés, auxquels vous avez répondu, ou dans lesquels vous avez été mentionné(e)).

  

• En ce qui concerne l’ordre des fils de commentaires dans le volet, il existe là encore deux niveaux. Premièrement, les commentaires sont ordonnés selon la spécification dans laquelle ils se trouvent, en suivant le même ordre que la structure Requirements dans l’arborescence du projet à gauche. Deuxièmement, pour chaque exigence, les commentaires sont ordonnés selon leur date de création, par ordre décroissant.

• Lorsque vous cliquez sur une entrée de fil de commentaire dans le volet, ce commentaire s’ouvre dans la fenêtre contextuelle de commentaires. L’entrée correspondante dans le volet Comments and Tasks est également surlignée en bleu. Si vous cliquez sur un commentaire qui ne se trouve pas dans la spécification actuellement affichée, vous serez redirigé(e) vers cette spécification.

  

• Chaque entrée de commentaire dans le volet fournit un résumé des informations clés relatives à ce commentaire, comme illustré dans l’exemple ci-dessous.