Document Commenting

Lorsqu’ils sont intégrés à un Workspace connecté, les projets Altium Designer permettent à une équipe de conception distribuée de travailler en collaboration sur des projets stockés et gérés de manière centralisée. L’interface de conception prend en charge les commentaires sur divers documents de conception afin d’améliorer le processus de 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 Comments and Tasks panneau

Les commentaires placés sont disponibles en temps réel pour les utilisateurs collaborant sur le 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 façon les documents qui le composent. La fonctionnalité de commentaire est gérée via 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 Workspace et d’assigner ces commentaires à des membres du Workspace, créant ainsi essentiellement des tâches pour eux. Le panneau permet à tous les utilisateurs travaillant sur le document d’ajouter des commentaires et de voir tous les commentaires sans modifier réellement le document lui-même. Cette fonctionnalité favorise des processus de collaboration solides et s’avère inestimable lorsqu’il faut signaler des problèmes dans le document sans effectuer de fusion physique ni provoquer de conflits. Le panneau Comments and Tasks peut essentiellement être utilisé pour créer une liste de tâches, et à mesure que la conception progresse, les commentaires peuvent être résolus puis fermés. Les commentaires placés sont disponibles en temps réel pour les utilisateurs collaborant sur le projet – ceux qui disposent d’un accès partagé au document – et sont enregistrés dans le Workspace indépendamment du projet, sans modifier d’aucune façon 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 le Workspace associé via sa vue de conception dans l’interface navigateur. La fonctionnalité des deux systèmes de commentaires est essentiellement la même et, puisque les données du projet et des commentaires sont toutes deux stockées dans le Workspace, les systèmes fonctionnent ensemble en temps réel.

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

Où les commentaires sont pris en charge

Schématique

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

PCB

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

Draftsman

Un commentaire peut être appliqué à un point spécifique ou à une zone dans un document Draftsman d’un projet de conception PCB, Multi-board ou de faisceau – .

Schématique Multi-board

Un commentaire peut être appliqué à un objet ou à un point spécifique dans un document Schématique Multi-board – .

Assemblage Multi-board

Un commentaire peut être appliqué à un point spécifique dans le document Assemblage Multi-board – .

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

Un commentaire peut être appliqué à un objet, à un point spécifique 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 Comments and Tasks

Le panneau est accessible depuis un projet Workspace des façons suivantes :

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

  L’icône Workspace à côté du nom d’un panneau dans le menu en bas à droite de l’espace de conception indique qu’une connexion à un Workspace est requise pour afficher les données du panneau associé. Une icône bleue () signifie qu’il existe actuellement une connexion à un Workspace. Une icône grise () indique qu’il n’existe actuellement aucune connexion à un Workspace, et vous serez invité à vous connecter à un Workspace avant de 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 repère d’un commentaire placé dans l’espace de conception.

Ajout d’un commentaire sans connexion à un Workspace

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

Options du panneau Comments and Tasks

Utilisez les boutons en haut du panneau Comments and Tasks pour définir la disponibilité des commentaires dans le panneau et dans l’espace d’édition, et pour préciser si les utilisateurs mentionnés sont notifiés.

Le bouton du panneau active/désactive la visibilité des épingles repères de commentaire sur le document. Les entrées de commentaire dans la liste du panneau Comments and Tasks peuvent toujours être sélectionnées comme d’habitude.

Utilisez le menu déroulant de filtre dans le panneau Comments and Tasks () pour configurer le filtrage des commentaires et le bouton associé  pour basculer entre la vue filtrée et non filtrée.

• Tasks only - activez cette option pour afficher uniquement les commentaires assignés à un utilisateur.
• ASSIGNED TO - toutes les options sont désactivées par défaut. Par conséquent, toutes les tâches/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 à cocher sont activées pour un ou plusieurs utilisateurs, les entrées correspondantes seront affichées. 

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

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

• Current document only – afficher uniquement les commentaires placés sur le document actuellement actif.

• Notification settings – cliquez pour ouvrir la boîte de dialogue Notification Settings et configurer la réception des alertes par e-mail pour toute l’activité des commentaires dans cette conception (All), uniquement pour les commentaires dans lesquels vous êtes mentionné ou assigné (My), ou 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é inclura des informations sur les commentaires de la conception : ID du commentaire, auteur, date et heure de création, texte du commentaire, assignataire (pour les tâches) et statut (pour un commentaire, s’il est Resolved ; pour une tâche, son statut To Do / In Progress / Resolved). Vous pouvez choisir d’exporter tous les commentaires associés à la conception, indépendamment du moment où ils ont été créés, ou uniquement les commentaires créés entre des versions spécifiques de la conception. Quelques options permettent également de définir quelles captures d’écran inclure dans le document PDF généré. Ensemble, elles indiquent à la fois où se trouve un commentaire et à quoi il s’applique (point, composant, zone). Si vous laissez les deux options décochées, vous n’obtiendrez que 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 suivante pour déterminer l’emplacement d’enregistrement et le nom du fichier (par défaut, celui du projet).

  • Entire designs snapshots - inclure un instantané de chaque document source contenant un commentaire dans la Period période spécifiée. Cela fournit une confirmation visuelle de l’emplacement du commentaire dans le document grâce à un marqueur de commentaire numéroté.
  • Original design screenshots - inclure l’instantané d’origine pris lors de la création d’un commentaire (et qui est l’instantané disponible depuis la fenêtre Contextual Commenting lorsqu’un marqueur de commentaire est cliqué dans l’espace de conception principal). Cela montre le point, la zone ou le composant auquel le commentaire s’applique.

  L’exportation des commentaires vers un PDF peut également être configurée et générée via un fichier Output Job dans le cadre de la publication du projet. Ajoutez un générateur de sortie Export Comments dans la catégorie Report Outputs.

  Notez que la fonction d’exportation des commentaires n’est disponible que pour les membres du Workspace où réside le projet. Elle n’est pas disponible pour les utilisateurs avec lesquels le projet a été partagé en dehors du Workspace.

Placement

Pour placer un commentaire dans l’espace de conception d’un éditeur graphique basé sur des objets, tel qu’un schéma, un PCB 2D ou Draftsman, exécutez d’abord la commande correspondante. Cela peut être fait de l’une des façons 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, puis sélectionnez Comment dans l’espace de conception.

Selon le type de document (voir ci-dessus), les commentaires peuvent être affectés à un objet, à un point spécifique ou à une zone du document actif. La commande active le mode de placement des commentaires, et le curseur devient un réticule avec un cercle bleu qui détecte et met en surbrillance les objets sélectionnables :

• Cliquez sur un objet mis 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 mise en surbrillance et attacher un commentaire à la zone spécifiée ().

Dans un document ActiveBOM, cliquez sur une cellule pour ajouter un commentaire à cette ligne 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 ensuite une boîte de dialogue de saisie de commentaire qui propose un champ pour entrer le texte du commentaire et, pour les documents graphiques, une option supplémentaire permettant d’ajouter, le cas échéant, un dessin à main levée au commentaire (). Sélectionnez l’option Assign a task to pour vous assigner une tâche à vous-même ou à 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 associera le commentaire à un marqueur d’épingle numéroté sur le document et ajoutera également une entrée récapitulative du commentaire dans le panneau Comments and Tasks.

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

Mentions et assignation de tâches

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

Si un utilisateur mentionné n’a pas accès au projet en cours, il vous sera proposé de partager ce projet avec lui. Cette option est disponible si vous êtes le propriétaire du projet ou un administrateur du Workspace. Les droits d’accès utilisateur sont accordés via la boîte de dialogue Share dialog; l’utilisateur recevra un e-mail l’informant de cet accès partagé. Si vous annulez la boîte de dialogue Share, le projet ne sera pas partagé, mais le commentaire sera placé normalement.

► Voir plus d’informations sur le partage d’une conception.

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

Positionnement

L’emplacement d’un commentaire dans l’espace de l’éditeur se déplace en faisant glisser son « épingle » associée vers une nouvelle position, pendant ou après son placement. Lorsqu’elle est sélectionnée, l’épingle du commentaire comprend une ligne de connexion vers l’objet ou la zone associés.

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

Collage d’images

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

Chaque image peut avoir une taille maximale de 2 Mo. Après l’avoir collée dans le commentaire, cliquez sur l’image pour l’afficher en taille réelle, comme montré dans l’image à droite.

Vous pouvez également publier un commentaire s’il ne contient qu’une image collée sans aucun 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 avec le curseur en forme de stylo qui en résulte. Cliquez et faites glisser pour créer 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 (cela est indiqué par l’icône dans l’espace de conception). Ces options vous permettent d’annuler et de rétablir des commentaires dans la liste déroulante Commands et de modifier la largeur, 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 en cours mais non 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. Le même contenu et les mêmes attributs sont affichés dans le panneau pour les tâches générales (assigné, 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 avec 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 région 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 séquence d’entrées numérotées) et dans l’éditeur de document correspondant (sous forme de repères graphiques 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 la date, le texte du commentaire initial, les mentions/assignations appliquées, ainsi que le nombre de réponses dans le fil.

Un fil de commentaires s’ouvre en sélectionnant son entrée dans le panneau Comments and Tasks ou en cliquant sur son repère associé dans l’espace de conception. Cela met le commentaire en surbrillance dans l’éditeur de document et ouvre la boîte de dialogue d’entrée du commentaire, qui comprend le commentaire initial et les éventuelles réponses des utilisateurs. Si le commentaire sélectionné est associé à un autre document de conception, le système ouvrira (et chargera, si nécessaire) ce document.

Navigation entre les commentaires en sélectionnant les marqueurs d’épingle dans l’espace de conception et en sélectionnant des entrées dans le panneau Comments and Tasks.

Boîte de dialogue des commentaires

L’interaction avec un commentaire placé s’effectue via la boîte de dialogue contextuelle de commentaire, qui affiche toutes les entrées du fil de commentaires sélectionné et inclut des options pour prévisualiser, répondre, modifier, résoudre et supprimer une entrée. La boîte de dialogue s’ouvre lors du placement initial d’un commentaire ou lorsqu’un commentaire placé 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 de commentaire.

Aperçu

Sélectionnez l’option Original Snapshot dans le commentaire initial pour voir une capture graphique 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, éventuellement, 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 assignée à un utilisateur spécifié dans la liste déroulante. Cliquez sur  pour confirmer l’entrée.

Modifier et supprimer

Un commentaire existant peut être modifié par l’auteur de ce commentaire à 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’intégralité du fil sera supprimée si le commentaire initial (au lieu d’une réponse) est supprimé.

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

Utilisez l’option Copy Link pour copier l’URL du fil de commentaires. Ce lien peut être utilisé pour ouvrir ce projet dans le Web Viewer de l’interface navigateur du Workspace, avec un objet, un point ou une zone du commentaire agrandi(e) et centré(e).

Résoudre

Cliquez sur le bouton / pour basculer l’état du commentaire entre Resolved et Unresolved (par défaut). Un commentaire résolu (clos comme terminé) est inactif et non modifiable, et son entrée dans le panneau Comments and Tasks ainsi que son repère sur le document apparaissent en grisé.

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

Si un commentaire de tâche a été assigné à un utilisateur, sa priorité et son statut peuvent être définis. Une tâche est initialement définie immédiatement avec la priorité Medium et le statut To Do, mais ils peuvent être modifiés en cliquant sur un contrôle associé en haut de la boîte de dialogue de commentaire.

Informations sur le tag de commit, l’ID de révision de version et la revue de conception 

Les tags de commit et les ID de révision de version sont affichés lors de la consultation des commentaires/tâches applicables à la fois dans le panneau Comments and Tasks et dans la boîte de dialogue de commentaire dans Altium Designer.

• Les commentaires créés dans le Web Viewer lors de la consultation de l’instantané de conception d’un commit tagué incluront le nom du tag associé. Cliquez sur le lien du nom du tag 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 version spécifique incluront l’ID de révision de version. Cliquez sur le lien de l’ID de révision de version pour ouvrir le Manufacturing Portal de cette version.

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

Utilisation des tâches Jira

Si l’intégration Jira est activée et configurée pour votre Altium 365 Workspace, alors un commentaire placé inclura l’option supplémentaire de créer et lier un ticket Jira dans votre service Atlassian Jira®. Comme les commentaires classiques et leurs tâches associées, les tickets Jira placés peuvent être consultés, modifiés et commentés depuis les documents de conception, et consultés/sélectionnés via le panneau Comments and Tasks.

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

Créer un ticket Jira

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

❯ ❮ Javascript ID: CreateJiraIssue

Placez une tâche Jira dans le document de projet actuel en plaçant d’abord une instance de commentaire. Le mode Jira alternatif est disponible depuis le menu déroulant Comment. Invoquez le placement de la tâche Jira en sélectionnant l’option Jira Issue dans le menu Comment de la boîte de dialogue. Cliquez sur l’option Create Issue si elle n’est pas déjà sélectionnée. Sélectionnez le type de ticket à créer dans la liste déroulante Issue Type, qui inclut ceux disponibles dans votre service Jira. Saisissez un Summary de ticket ainsi qu’une description/un assigné facultatif. La liste déroulante Assignee n’inclura que les utilisateurs enregistrés comme membres de votre compte Jira. Sélectionnez Post pour confirmer. Le ticket Jira est placé à la position du commentaire initial dans le document, est inclus dans le panneau Comments and Tasks, fournit un lien vers le ticket dans l’espace Jira et inclut un accès interactif à ses paramètres de priorité de tâche (Medium, High, etc.) et de statut (To Do, In Progress, etc.).

Sélectionnez le Task ID du ticket Jira du Workspace 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 du Workspace correspond au Issue Key dans l’espace Jira, et les principaux paramètres Jira, tels que Résumé, Description, Assigné et Commentaires, sont mappés entre les deux instances. L’utilisateur du Workspace qui a créé le ticket Jira est le rapporteur du ticket côté Jira. Notez qu’une image instantanée du document Workspace actuel est incluse comme pièce jointe Jira si l’option Attach original snapshot a été sélectionnée lors de la création du ticket Jira du Workspace (voir ci-dessus).

Une tâche Jira Workspace placée créera une issue Jira synchronisée dans l’espace Jira. Les deux sont liés par le mappage du Task ID Workspace avec le Issue Key Jira.

En plus des paramètres mappés entre les issues Workspace et Jira, les réglages d’état liés à la tâche Priority et Progress sont également synchronisés. Par exemple, le passage de la tâche d’issue Workspace d’un état de priorité Medium à High sera immédiatement répercuté sur l’issue côté Jira, et le changement de l’état d’avancement de To Do à In Progress côté Jira modifiera de la même manière l’état de l’issue Jira Workspace. Une actualisation des données (lancée en cliquant sur le bouton  en haut du panneau Comments and Tasks) peut être nécessaire pour voir les données mises à jour.

Lier à une issue Jira

Altium 365 Jira Integration permet également de lier une tâche Workspace à une issue Jira existante dans votre service Atlassian Jira via le mode Jira Issue de la boîte de dialogue de commentaire. Vous pouvez créer un lien vers n’importe quelle issue du projet Jira spécifié, qui sera alors synchronisée avec la tâche Jira Workspace.

❯ ❮ Javascript ID: LinkJiraIssue

Placez une instance de commentaire sur la zone du document ou l’objet que vous souhaitez associer à une issue Jira existante, 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 l’issue Jira (affichée sous forme de texte Summary) qui sera liée à l’instance de tâche Jira nouvellement placée. Commencez à saisir dans le champ de texte pour rechercher l’issue Jira souhaitée. La liste déroulante Jira Issue de la boîte de dialogue affichera l’issue sélectionnée depuis l’espace Jira. Si nécessaire, cochez l’option Attach original snapshot pour transférer une image de la vue actuelle du document vers Jira. Cliquez sur le bouton Post pour établir le lien entre la tâche Jira Workspace et l’issue Jira sélectionnée. La nouvelle tâche d’issue Jira s’affiche dans le panneau Comments and Tasks et dans la boîte de dialogue de commentaire, qui inclura tous les commentaires existants (ou ajoutés) — sélectionnez l’option Show all Replies de la boîte de dialogue pour voir la liste complète.

L’issue Jira liée est maintenant synchronisée avec la tâche Jira Workspace, ce qui inclut l’issue Comments et la définit sur les états Progress et Priority définis par l’issue Jira — In Progress et High dans cet exemple. Notez que les entrées Web links de l’issue Jira indiqueront désormais qu’une tâche Jira Altium 365 Workspace a été liée (ou reliée) à cette issue.

Une issue Jira existante est liée à une tâche Workspace en spécifiant son entrée Jira Issue dans le mode Link Issue de la boîte de dialogue de commentaire Workspace.

Panneau To-Do

Bien que votre Workspace connecté fournisse un ensemble complet de fonctionnalités pour les commentaires et l’attribution des 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 To-Do actuellement définis pour le projet actif. Un élément To-Do sert de rappel pour une tâche qui doit être effectuée ultérieurement en lien avec un document.

Le panneau To-Do

To-Do Panel Content and Use

Le panneau To-Do peut répertorier deux types d’éléments « to-do » pour le projet actif :

• Un élément To-Do au niveau du projet.
• Un élément To-Do au niveau du document — ajouté à un document texte du projet.

Pour chaque élément To-Do, les informations suivantes sont affichées :

• Done - cette case à cocher vous permet de cocher l’élément lorsque la tâche définie a été terminée.
• Action Item - la tâche réelle à 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 To-Do 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 effectivement l’exécuter.
• Category - il peut s’agir de la zone particulière du projet à laquelle se rapporte la tâche à effectuer (par ex. schémas, règles de conception, routage, contraintes, etc.).

Ajout d’éléments To-Do au niveau du projet

Les éléments To-Do au niveau du projet sont ajoutés depuis le panneau lui-même. Avant d’ajouter des éléments, 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 éléments To-Do.

Pour ajouter un nouvel élément To-Do, cliquez avec le bouton droit dans le panneau et choisissez l’entrée Add Project To-Do Item dans le menu contextuel qui apparaît ensuite. La boîte de dialogue Edit To-Do Item s’ouvrira.

Utilisez cette boîte de dialogue pour saisir un texte approprié pour 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. Après avoir défini l’élément comme souhaité, cliquez sur OK pour ajouter le nouvel élément au panneau.

Ajout d’éléments To-Do au niveau du document

Les éléments To-Do au niveau du document sont ajoutés à un document source textuel (par ex. fichier VHDL, fichier de contraintes, document de code source embarqué, etc.). Avant d’ajouter des éléments, assurez-vous que le document requis est actif dans la fenêtre de l’éditeur de conception et que ce document appartient au projet dont vous définissez actuellement les éléments To-Do globaux.

Pour ajouter un nouvel élément To-Do, placez le curseur de texte à l’emplacement souhaité dans le document où vous voulez placer un élément To-Do, cliquez avec le bouton droit et choisissez l’entrée Add To-Do Item dans le menu contextuel qui apparaît ensuite. La boîte de dialogue Edit To-Do Item apparaît. Utilisez cette boîte de dialogue pour saisir un texte approprié concernant la tâche à effectuer dans le document. Utilisez les champs disponibles dans la boîte de dialogue pour définir une Priority, un(e) Owner et un(e) Category pour la tâche (par ex. passe de mise en forme, passe de revue de code, etc.). Après avoir défini l’élément To-Do comme souhaité, cliquez sur OK pour fermer la boîte de dialogue et revenir au document en cours. Une entrée pour l’élément To-Do apparaîtra dans le panneau To-Do ainsi qu’à l’endroit marqué par la position actuelle du curseur de texte. L’entrée apparaîtra sous forme de commentaire (entre les délimiteurs de commentaire définis pour ce type de document), y compris le texte réel de l’élément et un identifiant unique, comme illustré dans l’image ci-dessous.

Menu contextuel

Le menu contextuel fournit les commandes suivantes :

• Goto Source - cette commande devient disponible lorsque l’élément sélectionné dans le panneau est un élément To-Do au niveau du document. Utilisez cette commande pour ouvrir (si ce n’est pas déjà fait) le document source associé référencé dans le champ Document de l’élément et en faire le document actif dans la fenêtre de l’éditeur de conception. Le curseur de texte sera placé au début du texte de l’élément To-Do.
• Add Project To-Do Item - ajouter un élément To-Do au niveau du projet au panneau pour le projet actif.
• Edit - modifier l’élément To-Do sélectionné. La boîte de dialogue Edit To-Do Item apparaîtra, vous permettant d’apporter les modifications nécessaires.
• Delete - supprimer l’élément To-Do sélectionné du panneau.
• Show Completed Items - lorsque cette option est activée, seuls les éléments To-Do marqués comme terminés (option Done activée) resteront affichés dans le panneau.
• Report - générer un rapport contenant tous les éléments To-Do actuellement affichés dans le panneau. Après le lancement de la commande, la boîte de dialogue Report Preview s’ouvrira, dans laquelle vous pourrez configurer, imprimer et exporter le rapport dans différents formats de fichier.

Remarques

• Si un élément To-Do au niveau du document a été défini dans le panneau et que le document source correspondant est le document actif dans la fenêtre de l’éditeur de conception, le texte de toute l’entrée To-Do dans le panneau apparaîtra en gras.
• Un double-clic sur une entrée d’élément To-Do dans le panneau ouvrira la boîte de dialogue Edit To-Do Item, vous permettant 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 l’en-tête de cette colonne. Cliquez une fois pour trier par ordre croissant ; cliquez à nouveau pour trier par ordre décroissant.
• Le filtrage direct vous permet d’accéder rapidement à une entrée d’élément To-Do en saisissant directement dans le panneau. Vous pouvez filtrer sur la base de n’importe quelle colonne de données du panneau. Utilisez les touches Right Arrow et Left Arrow pour passer d’une colonne à l’autre pour le 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 sera sélectionnée, et la lettre sera mise en évidence pour montrer que le filtrage du contenu de la colonne est basé sur la lettre saisie.