Commentaires de document

Lorsqu’ils sont intégrés à un espace de travail connecté, les projets Altium Designer permettent à une équipe de conception géographiquement dispersée de collaborer sur des projets stockés et gérés de manière centralisée. L’interface de conception permet d’ajouter des commentaires à différents documents de conception afin de faciliter la collaboration. Les commentaires, c’est-à-dire les notes ajoutées par les utilisateurs, peuvent être placés dans les documents et recevoir des réponses d’autres utilisateurs.

Le panneau Comments and Tasks 

Les commentaires placés sont accessibles en temps réel aux utilisateurs qui collaborent au projet (ceux qui disposent d’un accès partagé au document) et sont enregistrés sur le serveur indépendamment du projet, sans modifier d’aucune manière les documents qui le composent. La fonctionnalité de commentaire est gérée dans le panneau Comments and Tasks. Lorsqu’une entrée de commentaire est sélectionnée dans le panneau Comments and Tasks, le système ouvre (et charge, si nécessaire) le document de conception associé.

Le panneau Comments and Tasks vous permet d’ajouter des commentaires à une zone définie ou à un point du document actif d’un projet d’espace de travail, puis de les attribuer à des membres de cet espace, créant ainsi des tâches à leur intention. Le panneau permet à tous les utilisateurs qui travaillent sur le document d’ajouter des commentaires et de les consulter sans modifier le document lui-même. Cette fonctionnalité favorise une collaboration efficace et s’avère précieuse lorsqu’il faut signaler des problèmes dans le document sans avoir à fusionner les modifications ni à gérer les conflits qui en résultent. Le panneau Comments and Tasks peut ainsi servir à créer une liste de tâches à effectuer et, à mesure que la conception avance, les commentaires peuvent être résolus et clôturés. Les commentaires placés sont accessibles en temps réel aux utilisateurs qui collaborent au projet — ceux qui disposent d’un accès partagé au document — et sont enregistrés dans l’espace de travail indépendamment du projet, sans modifier d’aucune manière les documents qui le composent.

Notez que les commentaires et les tâches peuvent être ajoutés et gérés à la fois dans Altium Designer et dans l’espace de travail associé, depuis la vue de conception de son interface Web. Les deux systèmes de commentaires offrent des fonctionnalités globalement identiques et, puisque les données du projet et des commentaires sont stockées dans l’espace de travail, ils fonctionnent ensemble en temps réel.

Consultez Commenting in the Web Viewer (Espace de travail Altium 365, Espace de travail Enterprise Server) pour obtenir des informations détaillées sur le système de commentaires de l’interface Web d’un espace de travail.

Documents prenant en charge les commentaires

Schéma

Un commentaire peut être appliqué à un objet, à un point précis ou à une zone dans un document schématique.

PCB

Un commentaire peut être appliqué à un objet, à un point précis ou à une zone dans un document PCB (en mode de conception 2D) – .

Draftsman

Un commentaire peut être appliqué à un point précis ou à une zone dans un document Draftsman d’un projet PCB, multicarte ou de conception de faisceau – .

Schéma multicarte

Un commentaire peut être appliqué à un objet ou à un point précis dans un document schématique multicarte – .

Assemblage multicarte

Un commentaire peut être appliqué à un point précis dans le document d’assemblage multicarte – .

Schéma de câblage et plan d’implantation de faisceau

Un commentaire peut être appliqué à un objet, à un point précis ou à une zone dans un document de schéma de câblage ou de plan d’implantation d’un projet de conception de faisceau .

ActiveBOM

Un commentaire peut être appliqué à une ligne dans un document ActiveBOM – .

Accès au panneau Commentaires et tâches

Le panneau est accessible depuis un projet d’espace de travail de plusieurs façons :

• Cliquez sur le bouton Panels en bas à droite de l’espace de conception, puis sélectionnez Comments and Tasks.

  L’icône d’espace de travail située à côté du nom d’un panneau dans le menu en bas à droite de l’espace de conception indique qu’une connexion à un espace de travail est nécessaire pour consulter les données du panneau associé. Une icône bleue () indique qu’une connexion à un espace de travail est actuellement établie. Une icône grise () indique qu’aucune connexion à un espace de travail n’est actuellement établie ; vous serez alors invité à vous connecter à un espace de travail pour pouvoir accéder aux données du panneau.

• Sélectionnez la commande View » Panels » Comments and Tasks dans les menus principaux.

• Double-cliquez sur l’épingle de repérage d’un commentaire placé dans l’espace de conception.

Ajout d’un commentaire sans connexion à un espace de travail

Avant d’utiliser la fonctionnalité de commentaires, assurez-vous d’être connecté à votre espace de travail et d’avoir ouvert un projet ainsi qu’un document d’un type prenant en charge les commentaires (notamment un schéma, un PCB 2D, un document Draftsman ou ActiveBOM). Utilisez la commande File » Open Project pour choisir un projet d’espace de travail parmi ceux qui ont été partagés avec vous. Le panneau Comments and Tasks vous fournira des indications sur ces prérequis.

Options du panneau Commentaires et tâches

Utilisez les boutons en haut du panneau Comments and Tasks pour définir l’affichage des commentaires dans le panneau et dans l’espace de l’éditeur, et pour préciser si les utilisateurs mentionnés reçoivent des notifications.

Le bouton  du panneau permet d’afficher ou de masquer les marqueurs de commentaires sur le document. Les entrées de commentaires dans la liste du panneau Commentaires et tâches peuvent toujours être sélectionnées comme d’habitude.

Utilisez le menu déroulant de filtrage du panneau () pour configurer le filtrage des commentaires, et le bouton  associé pour basculer entre la vue filtrée et la vue non filtrée.

• TYPE - activez le type à afficher. Tous sont activés par défaut.

• SCOPE - activez Current document pour afficher uniquement les commentaires du document actif.

• ASSIGNEE - toutes les options sont désactivées par défaut. Par conséquent, toutes les tâches et tous les commentaires sont affichés et triés par nom (la première entrée de la liste correspond à l’utilisateur actuel). Lorsque les cases d’un ou de plusieurs utilisateurs sont cochées, les entrées correspondant à ces utilisateurs sont affichées. 

• Clear Filters - permet de rétablir rapidement les paramètres de filtrage par défaut.

Utilisez les options du menu du bouton  pour configurer la visibilité des commentaires et les notifications :

• Unresolved Only – les commentaires résolus ne sont pas inclus dans la liste.

• Notification settings – cliquez pour ouvrir la boîte de dialogue Notification Settings et configurer la réception d’alertes par e-mail pour toute activité liée aux commentaires dans cette conception (All), uniquement pour les commentaires dans lesquels vous êtes mentionné ou qui vous sont attribués (My), ou pour ne recevoir aucune alerte par e-mail (None). ► Exemple de contenu d’e-mail.

• Export Comments – cliquez pour ouvrir la boîte de dialogue Comment Export Configuration afin de configurer l’exportation des commentaires dans un fichier PDF.

  

Le PDF généré contiendra des informations sur les commentaires de la conception : identifiant du commentaire, auteur, date et heure de création, texte du commentaire, personne assignée (pour les tâches) et état (pour un commentaire, s’il est Resolved ; pour une tâche, son état To Do / In Progress / Resolved). Vous pouvez choisir d’exporter tous les commentaires associés à la conception, quelle que soit leur date de création, ou uniquement ceux créés entre des versions publiées spécifiques de la conception. Quelques options permettent également de définir les captures d’écran à inclure dans le document PDF généré. Ensemble, ces deux types de captures indiquent où se trouve un commentaire et à quoi il s’applique (point, composant, zone). Si vous laissez les deux options décochées, vous obtiendrez uniquement les commentaires eux-mêmes. Une fois la configuration terminée, cliquez sur Export pour générer le PDF, puis utilisez la boîte de dialogue qui s’affiche pour définir son emplacement et son nom (par défaut, celui du projet).

• Entire designs snapshots - inclure un instantané de chaque document source comportant un commentaire pendant la période Period spécifiée. Cela permet de confirmer visuellement l’emplacement du commentaire sur le document grâce à son marqueur numéroté.
• Original design screenshots - inclure l’instantané d’origine pris lors de la création d’un commentaire (cet instantané est accessible depuis la fenêtre Contextual Commenting lorsque vous cliquez sur un marqueur de commentaire dans l’espace de conception principal). Il montre le point, la zone ou le composant auquel le commentaire s’applique.

Placement

Pour placer un commentaire dans l’espace de conception d’un éditeur graphique basé sur des objets, tel qu’un éditeur de schémas, de PCB 2D ou Draftsman, commencez par exécuter la commande correspondante. Pour ce faire, effectuez l’une des actions suivantes :

• Cliquez sur le bouton  disponible dans le panneau Comments and Tasks.

• Cliquez sur  près du coin supérieur droit de l’espace de conception.

• Cliquez sur Place » Comment dans les menus principaux.

• Utilisez le raccourci clavier Ctrl+Alt+C.

• Faites un clic droit dans l’espace de conception, puis sélectionnez Comment.

Selon le type de document (voir ci-dessus), les commentaires peuvent être associés à un objet, à un point précis ou à une zone du document actif. La commande active le mode de placement des commentaires, et le curseur se transforme en réticule entouré d’un cercle bleu qui détecte et met en surbrillance les objets pouvant être sélectionnés :

• Cliquez sur un objet en surbrillance pour y attacher (épingler) un commentaire.

• Cliquez dans une zone non mise en surbrillance pour attacher un commentaire à ce point précis du document.

• Cliquez à l’écart d’un objet et faites glisser le curseur pour créer une zone rectangulaire en surbrillance et attacher un commentaire à la zone définie ().

Dans un document ActiveBOM, cliquez sur une cellule pour ajouter un commentaire à la ligne correspondante de la nomenclature. Faites un clic droit sur une ligne, puis sélectionnez la commande Comment pour ajouter un commentaire à cette ligne.

L’action de placement ouvre alors une boîte de dialogue de saisie de commentaire comprenant un champ pour saisir le texte du commentaire et, pour les documents graphiques, une option supplémentaire permettant d’ajouter un dessin à main levée au commentaire, le cas échéant (). Sélectionnez l’option Assign a task to pour vous attribuer une tâche ou l’attribuer à l’un des utilisateurs mentionnés dans le commentaire (voir les détails ci-dessous). Cliquez sur  pour confirmer la création du commentaire, ce qui l’associera à un marqueur numéroté sur le document et ajoutera également une entrée récapitulative au panneau Comments and Tasks.

Placement d’un commentaire sur un objet, mention d’un autre utilisateur enregistré dans le commentaire, déplacement du marqueur du commentaire et ajout d’un dessin à main levée au commentaire.

Mentions et attribution de tâches

En plus du texte saisi dans la boîte de dialogue de commentaire, vous pouvez ajouter une « mention » faisant référence à tout autre utilisateur ou rôle enregistré dans l'espace de travail connecté en saisissant le caractère @. Sélectionnez un nom ou une adresse e-mail dans la liste déroulante pour ajouter la référence à l'utilisateur (membre de l'espace de travail) au commentaire, ainsi qu'une entrée Assign a task to : en pratique, une task sera attribuée à l'utilisateur. Décochez cette dernière option si vous ne souhaitez pas que le commentaire soit considéré comme spécifiquement attribué à cet utilisateur. Un groupe de rôles (par exemple, « Ingénieurs »), et donc les utilisateurs qui le composent, peut également être ajouté en tant que mention.

Si un utilisateur mentionné n'a pas accès au projet actuel, vous serez invité à le partager avec lui. Cette option est disponible si vous êtes le propriétaire du projet ou un administrateur de l'espace de travail. Les droits d'accès de l'utilisateur sont accordés via la boîte de dialogue Share ; l'utilisateur recevra un e-mail l'informant du partage de l'accès. Si vous annulez la boîte de dialogue Share, le projet ne sera pas partagé, mais le commentaire sera placé comme d'habitude.

► En savoir plus sur le partage d'une conception.

Lorsqu'une tâche est attribuée à un utilisateur, l'image ou la photo de cet utilisateur s'affiche en haut à gauche de la boîte de dialogue de commentaire et de la vignette du commentaire dans le panneau Comments and Tasks. De plus, la tâche est nommée à partir du nom du projet et du numéro de séquence (par exemple, Kame_FMU-1), au lieu d'un simple numéro comme pour les commentaires ordinaires. Ce nom est également affiché dans la boîte de dialogue de commentaire et sur la vignette du commentaire. Cliquez dessus pour ouvrir la page Tasks du projet dans l'interface Web de l'espace de travail, avec la tâche sélectionnée mise en évidence dans la liste des tâches.

Positionnement

Pour déplacer un commentaire dans l'espace de l'éditeur, faites glisser son « repère » vers une nouvelle position, pendant ou après son placement. Lorsqu'il est sélectionné, le repère du commentaire comporte une ligne de liaison vers l'objet ou la zone qui lui est associé.

Notez qu'un commentaire peut également être positionné lors de son placement initial en cliquant et en faisant glisser le curseur en mode de placement ().

Collage d'images

Vous pouvez ajouter une image à un commentaire en la copiant d'abord depuis une fenêtre Explorer ou une page Web par un clic droit sur l'image, ce qui la copie dans le presse-papiers. Pour joindre l'image, faites un clic droit et choisissez Paste (ou utilisez le raccourci Ctrl+V ) dans le commentaire lui-même (dans le champ indiquant Add others with @ or paste images). 

La taille de chaque image ne doit pas dépasser 2 Mo. Une fois l'image collée dans le commentaire, cliquez dessus pour l'afficher en entier, comme illustré dans l'image de droite.

Vous pouvez également publier un commentaire contenant uniquement une image collée, sans texte, comme illustré ci-dessous.

Dessin

Lors du placement ou de la modification d'un commentaire, sélectionnez le bouton d'option  pour ajouter un dessin à main levée à l'aide du curseur en forme de stylo qui apparaît. Cliquez et faites glisser pour tracer des lignes, puis faites un clic droit pour terminer et associer le dessin au commentaire actuellement sélectionné.

Pour accéder au mode Freehand Drawing du panneau Properties, appuyez sur la touche Tab lorsque le mode de dessin à main levée est actif (ce qui est indiqué par l'icône  dans l'espace de conception). Ces options vous permettent d'annuler et de rétablir les commentaires dans la liste déroulante Commands, ainsi que de modifier l'épaisseur, la taille et la couleur dans la liste déroulante Properties .

Tâches générales

Les tâches générales (tâches appliquées au projet actuel, mais qui ne sont pas associées à un commentaire ou à un document du projet) sont répertoriées dans le panneau dans un groupe distinct, sous l'entrée du projet. Les mêmes contenus et attributs sont affichés dans le panneau pour les tâches générales (responsable, priorité, etc.).

Les tâches générales sont répertoriées dans le panneau Comments and Tasks.

Cliquez sur une entrée de tâche générale dans le panneau pour accéder à ses boîtes de dialogue de commentaire. Utilisez la boîte de dialogue pour publier des commentaires (y compris ceux contenant des images collées) pour la tâche générale sélectionnée.

Commentaires détachés

Lorsqu’un document de projet est supprimé ou que son UniqueID a changé, les commentaires du document peuvent devenir « détachés ». Ces commentaires restent accessibles depuis la section repliable Detached Comments du panneau. Cliquez sur la vignette d’un commentaire détaché dans le panneau Comments and Tasks pour afficher sa boîte de dialogue dans l’espace de conception du document actuellement ouvert.

Utilisation des commentaires

Les commentaires placés dans un document de conception sont enregistrés à la fois dans le panneau Comments and Tasks (sous forme d’une suite d’entrées numérotées) et dans l’éditeur du document correspondant (sous forme de repères numérotés). Chaque entrée du panneau représente un fil de commentaires et fournit des informations récapitulatives, notamment l’auteur du commentaire et sa date de création, le texte du commentaire initial, les éventuelles mentions ou affectations, ainsi que le nombre de réponses dans le fil.

Pour ouvrir un fil de commentaires, sélectionnez son entrée dans le panneau Comments and Tasks ou cliquez sur le repère associé dans l’espace de conception. Le commentaire est alors mis en surbrillance dans l’éditeur du document et la boîte de dialogue de commentaire s’ouvre, affichant le commentaire initial et les réponses des utilisateurs. Si le commentaire sélectionné est associé à un autre document de conception, le système ouvre ce document (et le charge si nécessaire).

Navigation dans les commentaires en sélectionnant les repères dans l’espace de conception ou les entrées dans le panneau Comments and Tasks.

Boîte de dialogue des commentaires

Les interactions avec un commentaire placé s’effectuent dans une boîte de dialogue contextuelle, qui affiche toutes les entrées du fil de commentaires sélectionné et propose des options pour prévisualiser une entrée, y répondre, la modifier, la résoudre ou la supprimer. Cette boîte de dialogue s’ouvre lors du placement initial d’un commentaire ou lorsqu’un commentaire existant est sélectionné dans le panneau Comments and Tasks ou dans l’espace de conception. Appuyez sur Esc ou cliquez dans l’espace de conception pour fermer la boîte de dialogue des commentaires.

Aperçu

Sélectionnez l’option Original Snapshot dans le commentaire initial pour afficher une capture de la zone de l’éditeur au moment où le commentaire a été placé. Cliquez sur l’icône en haut à droite de la capture d’écran ou sur la capture elle-même pour ouvrir un aperçu en taille réelle (cliquez sur l’icône  en haut à droite de cet aperçu ou sur l’image elle-même pour le fermer).

Répondre

Saisissez du texte et, si vous le souhaitez, une mention d’utilisateur (« @ ») dans le champ Reply pour ajouter une nouvelle entrée au fil de commentaires. Sélectionnez l’option Assign a task to pour créer une tâche affectée à un utilisateur choisi dans la liste déroulante. Cliquez sur  pour confirmer l’entrée.

Modifier et supprimer

Un commentaire existant peut être modifié par son auteur à l’aide de l’option Edit disponible dans le menu  du commentaire. Cliquez sur le bouton  pour confirmer la modification du commentaire.

Utilisez l’option Delete pour supprimer le commentaire actuellement sélectionné. Notez que l’ensemble du fil sera supprimé si vous supprimez le commentaire initial plutôt qu’une réponse.

Utilisez l’option Convert to Task pour convertir le commentaire en une tâche qui vous est affectée.

Utilisez l’option Copy Link pour copier l’URL du fil de commentaires. Ce lien permet d’ouvrir ce projet dans le Web Viewer de l’interface Web de l’espace de travail, avec un zoom centré sur l’objet, le point ou la zone du commentaire.

Résoudre

Cliquez sur le bouton / pour faire passer l’état du commentaire de Resolved à Unresolved (état par défaut), ou inversement. Un commentaire résolu (clôturé comme terminé) est inactif et ne peut plus être modifié ; son entrée dans le panneau Comments and Tasks et son repère sur le document sont grisés.

Définition des priorités et des états des tâches

Si un commentaire de tâche a été affecté à un utilisateur, sa priorité et son état peuvent être définis. Une tâche est initialement définie avec la priorité Medium et l’état To Do, mais ces valeurs peuvent être modifiées en cliquant sur la commande correspondante en haut de la boîte de dialogue des commentaires.

Étiquette de commit, identifiant de révision de publication et informations de revue de conception 

Les étiquettes de commit et les identifiants de révision de publication sont affichés lors de la consultation des commentaires ou tâches concernés, aussi bien dans le panneau Comments and Tasks que dans la boîte de dialogue des commentaires d’Altium Designer.

• Les commentaires créés dans le Web Viewer lors de la consultation de l’instantané de conception d’un commit étiqueté incluent le nom de l’étiquette associée. Cliquez sur le lien du nom de l’étiquette pour ouvrir l’instantané du commit correspondant dans le Web Viewer.

• Les commentaires créés dans le Web Viewer lors de la consultation d’une publication spécifique incluent l’identifiant de révision de la publication. Cliquez sur le lien de cet identifiant pour ouvrir le portail de fabrication de cette publication.

• Les commentaires créés dans le Web Viewer lors de la consultation d’un instantané de revue de conception incluent l’entrée de la revue de conception. Cliquez sur le lien de la revue de conception pour ouvrir la page de cette revue.

Utilisation des tâches Jira

Si l’intégration Jira est activée et configurée pour votre espace de travail Altium 365, un commentaire placé propose une option supplémentaire permettant de créer un ticket dans votre service Atlassian Jira® et de l’y associer. Comme les commentaires classiques et les tâches qui leur sont associées, les tickets Jira placés peuvent être consultés, modifiés et commentés depuis les documents de conception, et consultés ou sélectionnés via le panneau Comments and Tasks.

Une instance de tâche Jira placée est synchronisée avec le ticket correspondant dans l’espace Jira. La synchronisation bidirectionnelle des données entre les tickets Jira et les tâches de l’espace de travail permet de gérer les projets de conception depuis l’espace Jira conjointement avec Altium 365.

Créer un ticket Jira

Pour créer une tâche de ticket Jira pour un projet de conception, placez d’abord un commentaire de la manière habituelle, puis sélectionnez l’option Jira Issue dans la boîte de dialogue des commentaires. Choisissez ensuite un type de ticket et ajoutez un résumé pour créer la tâche synchronisée avec le ticket Jira.

Sélectionnez le Task ID du ticket Jira de l’espace de travail dans la boîte de dialogue de commentaire ou le panneau Comments and Tasks pour ouvrir directement ce ticket dans l’espace Jira, dans un nouvel onglet de votre navigateur par défaut. Le Task ID de l’espace de travail correspond au Issue Key dans l’espace Jira, et les principaux paramètres Jira, tels que le résumé, la description, la personne assignée et les commentaires, sont mis en correspondance entre les deux instances. L’utilisateur de l’espace de travail qui a créé le ticket Jira est le rapporteur du ticket côté Jira. Notez qu’une capture du document actuel de l’espace de travail est ajoutée en pièce jointe Jira si l’option Attach original snapshot a été sélectionnée lors de la création du ticket Jira dans l’espace de travail (voir ci-dessus).

Une tâche Jira placée dans l’espace de travail crée un ticket Jira synchronisé dans l’espace Jira. Les deux sont liés par la mise en correspondance du Task ID de l’espace de travail avec le Issue Key Jira.

Outre les paramètres mis en correspondance entre les tickets de l’espace de travail et de Jira, les paramètres de statut Priority et Progress liés à la tâche sont également synchronisés. Par exemple, faire passer la priorité de la tâche du ticket de l’espace de travail de Medium à High est immédiatement répercuté dans le ticket côté Jira. De même, faire passer l’état d’avancement de To Do à In Progress côté Jira modifie l’état du ticket Jira dans l’espace de travail. Une actualisation des données (effectuée en cliquant sur le bouton  en haut du panneau Comments and Tasks) peut être nécessaire pour afficher les données mises à jour.

Lier à un ticket Jira

L’intégration Jira d’Altium 365 permet également de lier une tâche de l’espace de travail à un ticket Jira existant dans votre service Atlassian Jira via le mode Jira Issue de la boîte de dialogue de commentaire. Vous pouvez établir un lien vers n’importe quel ticket du projet Jira spécifié, qui est alors synchronisé avec la tâche Jira de l’espace de travail.

❯ ❮ Javascript ID : LinkJiraIssue

Placez une instance de commentaire sur la zone du document ou sur l’objet que vous souhaitez associer à un ticket Jira existant, puis sélectionnez le mode Jira Issue et l’option Link Issue dans la boîte de dialogue de commentaire. Utilisez la liste déroulante Select or search issues pour sélectionner le ticket Jira (affiché sous forme de texte Summary) à lier à l’instance de tâche Jira nouvellement placée. Commencez à saisir du texte dans le champ pour rechercher le ticket Jira souhaité. La liste déroulante Jira Issue de la boîte de dialogue affiche le ticket sélectionné dans l’espace Jira. Si nécessaire, cochez l’option Attach original snapshot pour transférer vers Jira une image de la vue actuelle du document. Cliquez sur le bouton Post pour établir le lien entre la tâche Jira de l’espace de travail et le ticket Jira sélectionné. La nouvelle tâche associée au ticket Jira apparaît dans le panneau Comments and Tasks et dans la boîte de dialogue de commentaire, qui inclut tous les commentaires existants (ou ajoutés). Sélectionnez l’option Show all Replies de la boîte de dialogue pour afficher la liste complète.

Le ticket Jira lié est désormais synchronisé avec la tâche Jira de l’espace de travail, qui inclut le Comments du ticket et reprend les états Progress et Priority définis par le ticket Jira, à savoir In Progress et High dans cet exemple. Notez que les entrées Web links du ticket Jira indiquent désormais qu’une tâche Jira de l’espace de travail Altium 365 a été liée (ou liée à nouveau) à ce ticket.

Un ticket Jira existant est lié à une tâche de l’espace de travail en spécifiant son entrée Jira Issue dans le mode Link Issue de la boîte de dialogue de commentaire de l’espace de travail.

Panneau des tâches à faire

Bien que votre espace de travail connecté propose l’ensemble complet des fonctionnalités de commentaire et d’attribution de tâches décrites ci-dessus, vous pouvez également accéder au panneau To-Do pour suivre vos tâches. Le panneau To-Do répertorie tous les éléments à faire actuellement définis pour le projet actif. Un élément à faire sert de rappel pour une tâche à effectuer ultérieurement en lien avec un document.

Le panneau To-Do

Contenu et utilisation du panneau des tâches à faire

Le panneau To-Do peut répertorier deux types d’éléments à faire pour le projet actif :

• Un élément à faire au niveau du projet.
• Un élément à faire au niveau du document, ajouté à un document texte du projet.

Pour chaque élément à faire, les informations suivantes sont affichées :

• Done - cette case vous permet de marquer l’élément lorsque la tâche définie est terminée.
• Action Item - la tâche à effectuer.
• Priority - l’importance de la tâche à effectuer (Lowest, Low, Normal (par défaut), High, Highest).
• Document - une référence au document source auquel un élément à faire au niveau du document a été ajouté.
• Owner - il peut s’agir du nom de la personne qui saisit la tâche ou de celle qui doit l’effectuer.
• Category - il peut s’agir du domaine particulier du projet auquel se rapporte la tâche à effectuer (par exemple, schémas, règles de conception, routage, contraintes, etc.).

Ajout de tâches à faire au niveau du projet

Les tâches à faire au niveau du projet sont ajoutées directement depuis le panneau. Avant d’ajouter des tâches, assurez-vous que le document actif dans la fenêtre de l’éditeur de conception est l’un des documents de conception du projet pour lequel vous souhaitez définir des tâches à faire.

Pour ajouter une nouvelle tâche à faire, cliquez avec le bouton droit dans le panneau et choisissez l’entrée Add Project To-Do Item dans le menu contextuel qui s’affiche. La boîte de dialogue Edit To-Do Item s’ouvre.

Utilisez cette boîte de dialogue pour saisir un texte décrivant la tâche à effectuer pour le projet. Utilisez les champs disponibles dans la boîte de dialogue pour définir un task's Priority, Owner, and Category. Une fois la tâche définie selon vos besoins, cliquez sur OK pour l’ajouter au panneau.

Ajout de tâches à faire au niveau du document

Les tâches à faire au niveau du document sont ajoutées à un document source textuel (par exemple, un fichier VHDL, un fichier de contraintes, un document de code source embarqué, etc.). Avant d’ajouter des tâches, assurez-vous que le document souhaité est actif dans la fenêtre de l’éditeur de conception et qu’il appartient au projet dont vous définissez actuellement l’ensemble des tâches à faire.

Pour ajouter une nouvelle tâche à faire, placez le curseur de texte à l’endroit du document où vous souhaitez insérer la tâche, cliquez avec le bouton droit et choisissez l’entrée Add To-Do Item dans le menu contextuel qui s’affiche. La boîte de dialogue Edit To-Do Item apparaît. Utilisez cette boîte de dialogue pour saisir un texte décrivant la tâche à effectuer dans le document. Utilisez les champs disponibles dans la boîte de dialogue pour définir les éléments Priority, Owner et Category de la tâche (par exemple, passe de mise en forme, revue de code, etc.). Une fois la tâche à faire définie selon vos besoins, cliquez sur OK pour fermer la boîte de dialogue et revenir au document actif. Une entrée correspondant à la tâche à faire apparaît dans le panneau To-Do, ainsi qu’à l’emplacement actuel du curseur de texte. L’entrée apparaît sous forme de commentaire (entre les délimiteurs de commentaire définis pour ce type de document) et comprend le texte de la tâche ainsi qu’un identifiant unique, comme illustré dans l’image ci-dessous.

Menu contextuel

Le menu contextuel propose les commandes suivantes :

• Goto Source - cette commande est disponible lorsque l’élément sélectionné dans le panneau est une tâche à faire au niveau du document. Utilisez cette commande pour ouvrir le document source associé indiqué dans le champ Document de la tâche (s’il n’est pas déjà ouvert) et en faire le document actif dans la fenêtre de l’éditeur de conception. Le curseur de texte est placé au début du texte de la tâche à faire.
• Add Project To-Do Item - ajouter au panneau une tâche à faire au niveau du projet actif.
• Edit - modifier la tâche à faire sélectionnée. La boîte de dialogue Edit To-Do Item apparaît et vous permet d’effectuer les modifications nécessaires.
• Delete - supprimer du panneau la tâche à faire sélectionnée.
• Show Completed Items - lorsque cette option est activée, seules les tâches à faire marquées comme terminées (option Done activée) restent affichées dans le panneau.
• Report - générer un rapport contenant toutes les tâches à faire actuellement affichées dans le panneau. Après le lancement de la commande, la boîte de dialogue Report Preview s’ouvre et vous permet de configurer, d’imprimer et d’exporter le rapport dans différents formats de fichier.

Remarques

• Si une tâche à faire au niveau du document a été définie dans le panneau et que le document source correspondant est le document actif dans la fenêtre de l’éditeur de conception, l’intégralité du texte de l’entrée correspondante dans le panneau s’affiche en gras.
• Double-cliquer sur une entrée de tâche à faire dans le panneau ouvre la boîte de dialogue Edit To-Do Item, qui vous permet de modifier la définition de la tâche.
• Les entrées du panneau peuvent être triées selon n’importe quelle colonne en cliquant sur son en-tête. Cliquez une fois pour trier par ordre croissant, puis une seconde fois pour trier par ordre décroissant.
• Le filtrage direct vous permet d’accéder rapidement à une entrée de tâche à faire en saisissant du texte directement dans le panneau. Vous pouvez filtrer selon n’importe quelle colonne de données du panneau. Utilisez les touches Right Arrow et Left Arrow pour changer de colonne de filtrage, ou cliquez directement sur un champ dans une colonne. Pour utiliser cette fonction de filtrage, cliquez dans une colonne de données et saisissez la première lettre de l’entrée à laquelle vous souhaitez accéder. La première entrée de cette colonne commençant par la lettre saisie est sélectionnée, et la lettre est mise en surbrillance pour indiquer que le filtrage du contenu de la colonne repose sur cette lettre.