Commentaires sur les artefacts

Un commentaire est un élément de discussion textuel associé à un artefact ou à un élément intégré à un artefact. Vous pouvez utiliser des commentaires pour fournir des retours d'informations à votre équipe au cours du développement d'un artefact. Les commentaires s'affichent dans la section Commentaires de la barre latérale d'un artefact, dans la section Commentaires récents de la barre latérale de la page de projet et dans Commentaires récents pour moi sur le Tableau de bord de l'utilisateur.
Pourquoi et quand exécuter cette tâche

Vous pouvez commenter un artefact dans son ensemble (en utilisant des commentaires au niveau de l'artefact) et des éléments spécifiques situés dans l'artefact. Dans le cas des documents, vous pouvez commenter le document dans son intégralité (en utilisant des commentaires au niveau du document), un paragraphe ou un élément d'une liste à puces. Tous les membres de l'équipe ayant accès à l'artefact peuvent voir les commentaires.

Lorsque vous créez un commentaire, vous pouvez l'adresser à un ou plusieurs utilisateurs, auquel cas il sera affiché sur leurs tableaux de bord. Si les notifications par e-mail sont configurées sur votre serveur, vous recevrez un e-mail lorsque des commentaires vous seront adressés.

Un commentaire et ses réponses sont regroupés dans la section Commentaires. Les réponses à un commentaire sont indentées sous le commentaire de niveau supérieur. Le numéro situé en regard de l'icône des commentaires dans une barre d'outils d'artefact indique le nombre total de commentaires contenus dans l'artefact. Cliquez sur l'icône pour mettre les commentaires de l'artefact en évidence ou ajouter un commentaire. Vous pouvez également consulter le nombre total de commentaires dans la page de projet Artefacts en affichant la liste détaillée des artefacts. Il est également possible d'ajouter un commentaire à partir de cette page sans ouvrir l'artefact.

Lorsque vous sélectionnez un commentaire dans un artefact, l'élément qui lui est associé est sélectionné dans l'éditeur. Lorsque vous sélectionnez un élément dans un éditeur d'artefacts, le commentaire qui lui est associé est sélectionné dans la barre latérale.

Les commentaires apportés à des artefacts incorporés ou réutilisables ne peuvent être consultés que dans le contexte de leur création. Par exemple, si vous intégrez une esquisse à un document, les commentaires sur l'esquisse intégrée au document sont invisibles lors de la consultation de l'esquisse dans son propre éditeur.

Le tableau suivant décrit des tâches supplémentaires de gestion des commentaires.

Tableau 1. Commandes et tâches associées de la section Commentaires de la barre latérale
Tâche Icône Etapes
Développer/réduire un commentaire.   Cliquez sur l'en-tête du commentaire de niveau supérieur. Le texte du commentaire et ses réponses sont affichés ou masqués.
Développer ou réduire des commentaires. Cliquez sur les icônes Développer tout et Réduire tout pour afficher ou masquer le texte et les réponses de tous les commentaires de la section Commentaires.
Ajouter un commentaire ou ajouter une réponse à un commentaire dans un artefact.

Pour créer un commentaire qui s'applique à l'intégralité d'un artefact, dans la section Commentaires de la barre latérale, cliquez sur l'icône Commentaire , puis sur Créer un commentaire pour l'artefact. Vous pouvez également cliquer sur l'icône Commentaires dans l'en-tête de l'artefact et sélectionner Ajouter un commentaire à l'artefact.

Pour créer un commentaire associé à un élément, sélectionnez un élément dans l'éditeur, puis cliquez sur l'icône Ajouter un commentaire située au-dessus de l'élément. Vous pouvez également ajouter un commentaire à un élément sélectionné en cliquant sur l'icône Commentaire dans la barre latérale. Si aucun commentaire n'est sélectionné, vous pouvez cliquer sur l'option pour Créer un commentaire pour <élément>.

Pour ajouter un commentaire dans un document ou une exigence, cliquez avec le bouton droit de la souris dans un paragraphe ou un élément d'une liste à puces, puis cliquez sur Ajouter un commentaire.

Pour créer une réponse, sélectionnez un commentaire et cliquez sur l'icône Commentaire ou cliquez avec le bouton droit de la souris sur le commentaire, puis cliquez sur Répondre à <commentaire>.

Mettre en évidence les éléments ou paragraphes de l'éditeur auxquels sont associés des commentaires.

Sélectionnez cette icône pour mettre en évidence tous les éléments de l'éditeur d'artefacts qui disposent de commentaires. Lorsque vous travaillez avec un document, tous les paragraphes contenant des commentaires sont mis en évidence.

Le nombre de commentaires associés à chaque élément ou paragraphe est lui aussi indiqué dans l'éditeur. Il varie suivant vos paramètres de filtrage pour la section Commentaires de la barre latérale.

Sélectionnez de nouveau l'icône pour supprimer la mise en évidence.

Filtrer les commentaires de cette vue.

Cliquez sur l'icône Filtrer pour limiter l'affichage des commentaires à ceux qui correspondent à vos critères.

Il est possible de filtrer les commentaires par priorité, auteur (Par), destinataire ciblé par le commentaire (Pour), l'état de résolution (par défaut, non résolus uniquement) et une plage de dates pour les commentaires récents uniquement.

Cliquez sur l'icône Filtrer pour réduire la section Filtrer. La réduction de cette section n'efface pas le filtrage : seuls les commentaires répondant aux critères de filtrage sont affichés.

Cliquez sur Effacer les filtres pour afficher tous les commentaires.

Résoudre un commentaire en indiquant qu'il ne nécessite aucune autre action ou en y répondant. Pour résoudre un commentaire, sélectionnez le commentaire, puis cliquez sur l'icône Commentaire ou cliquez avec le bouton droit sur le commentaire, puis sélectionnez Résoudre le commentaire. Les commentaires résolus s'affichent en gris clair. Une fois qu'un commentaire est résolu, vous pouvez le rouvrir et y répondre.
Editer un commentaire. Pour éditer un commentaire, sélectionnez-le, puis cliquez sur l'icône Commentaire ou cliquez avec le bouton droit de la souris sur le commentaire et sélectionnez Editer le commentaire. Un commentaire ne peut être édité que par l'utilisateur qui l'a créé.
Afficher l'intégralité du texte du commentaire.   Les commentaires longs sont tronqués dans la vue Commentaires. Pour afficher le texte complet, il suffit de survoler le commentaire.
Trier et regrouper des commentaires. Cliquez sur l'icône Trier et regrouper de la section Commentaires pour accéder aux options de tri et de regroupement. L'Auteur fait référence à l'émetteur du commentaire d'origine. La Date fait référence à la date de dernière activité pour le commentaire, réponses incluses.
Afficher la section Commentaires récents dans la barre latérale de la page du projet.   Ouvrez un projet en utilisant le bouton Ouvrir dans la barre d'outils de l'éditeur. Développez la barre latérale dans la page du projet en cliquant sur la flèche du the coin supérieur droit. Développez la barre latérale de la section Commentaires récents.
Afficher la section Commentaires récents pour moi dans la barre latérale de la page du projet.   Ouvrez votre Tableau de bord à l'aide du bouton Ouvrir dans la barre d'outils de l'éditeur. Les commentaires récents qui vous sont destinés d'affichent dans la section Commentaires récents pour moi.
Supprimer des commentaires.   Les commentaires ne sont jamais supprimés, même si l'élément associé est supprimé. Ces commentaires sont marqués avec le texte "(l'élément ne figure pas dans cette revue) dans le titre du commentaire. Ces commentaires peuvent être masqués dans la section de commentaire avec l'option (Masquer les commentaires sur les éléments orphelins) dans le panneau des filtres.

Vos commentaires