Commentaires de document

Lorsqu’ils sont intégrés à un Workspace connecté, les projets Altium Designer permettent à une équipe de conception distribuée de travailler de manière collaborative sur des projets stockés et gérés de façon centralisée. L’interface de conception prend en charge les commentaires sur différents 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 panneau Comments and Tasks 

Les commentaires placés sont disponibles en temps réel pour les utilisateurs collaborant sur le document (ceux qui ont 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 constituent. 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 ou à un point défini 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 qui travaillent sur le document d’ajouter des commentaires et d’afficher 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 procéder à une fusion physique et sans générer 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 et clôturés. Les commentaires placés sont disponibles en temps réel pour les utilisateurs collaborant sur le document – ceux qui y ont un accès partagé – et sont enregistrés dans le Workspace indépendamment du projet, sans modifier d’aucune manière les documents qui le constituent.

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 la vue de conception de son 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.

Là 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 routage 2D) – .

Draftsman

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

Schématique multi-carte

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

Assemblage multi-carte

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

Schéma de câblage et dessin d’implantation de harnais

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 dessin d’implantation d’un projet de conception de harnais.

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 en l’absence de 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 concernant 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 la vue 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 est 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é de commentaire dans cette conception (All), uniquement pour les commentaires dans lesquels vous êtes mentionné ou assigné (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 de sortie comprendra des informations sur les commentaires dans 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é effectués, ou uniquement les commentaires effectués entre des versions spécifiques de la conception. Il existe également quelques options pour définir quelles captures d’écran inclure dans le document PDF généré. Ensemble, elles donnent des informations sur l’emplacement d’un commentaire et sur ce à 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 période Period spécifiée. Cela fournit une confirmation visuelle de l’emplacement du commentaire sur le document grâce à un repère 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 repère 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 fonctionnalité 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 document schématique, 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.

• À l’aide du 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 assignés à un objet, un point spécifique ou une zone du document actif. La commande lance le mode de placement de commentaire, et le curseur devient une croix avec un cercle bleu qui détecte et met en surbrillance les objets pour la sélection :

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

• Cliquez dans une zone non surlignée pour attacher un commentaire à ce point spécifique 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 spécifiée ().

Dans un document ActiveBOM, cliquez sur une cellule du document ActiveBOM pour ajouter un commentaire à cette ligne de 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 qui propose un champ pour entrer le texte du commentaire et, pour les documents graphiques, également une option supplémentaire permettant d’ajouter un dessin à main levée au commentaire lorsque cela s’applique (). 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 repère 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

Outre le 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/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 ex. : « 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 actuel, il vous sera proposé de le partager avec cet utilisateur. 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 l’accès partagé. Si vous annulez la boîte de dialogue Share, le projet ne sera pas partagé, mais le commentaire sera placé comme d’habitude.

► 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 de commentaire et de la vignette de commentaire dans le panneau Comments and Tasks. En outre, la tâche sera nommée avec le nom du projet et le numéro de séquence (par ex., 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 de 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 d’édition est déplacé 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é.

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 copie l’image 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é sur l’image à droite.

Vous pouvez également publier un commentaire s’il contient uniquement 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 à l’aide du curseur en forme de stylo obtenu. Cliquez et faites glisser pour créer des lignes, puis cliquez avec le bouton 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, ainsi que 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 de projet ou à un document) 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 (assignataire, priorité, etc.).

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

Cliquez sur une entrée Tâche générale dans le panneau pour accéder à ses boîtes de dialogue de commentaires. 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 réductible 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 la forme d’une séquence d’entrées numérotées) et dans l’éditeur de document correspondant (sous la 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 la date, le texte du commentaire initial, les mentions/attributions appliquées et 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 toutes les réponses des utilisateurs. Si un 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 de repère dans l’espace de conception et en sélectionnant les 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 attribué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’ensemble du fil sera supprimé si le commentaire initial (au lieu d’une réponse) est supprimé.

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

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

Résoudre

Cliquez sur le bouton / pour basculer l’état du commentaire entre Resolved et Unresolved (par défaut). Un commentaire résolu (fermé 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 grisés.

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

Si un commentaire de tâche a été attribué à un utilisateur, sa priorité et son statut peuvent être définis. Une tâche est initialement immédiatement définie 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 l’étiquette de commit, l’ID de révision de version et la révision de conception 

Les étiquettes de commit et les ID de révision de version sont affichés lors de l’affichage 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 l’affichage de l’instantané de conception d’un commit étiqueté incluront le nom de l’étiquette associée. Cliquez sur le lien du nom de l’étiquette pour ouvrir l’instantané de commit associé dans le Web Viewer.

• Les commentaires créés dans le Web Viewer lors de l’affichage 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 l’affichage d’un instantané de Design Review incluront l’entrée de révision de conception. Cliquez sur le lien de révision de conception pour ouvrir la page de la révision.

Utilisation des tâches Jira

Si l’intégration Jira est activée et configurée pour votre Altium 365 Workspace, un commentaire placé inclura l’option supplémentaire permettant de créer et de lier un ticket Jira dans votre service Atlassian Jira®. Comme les commentaires conventionnels et leurs tâches associées, les tickets Jira placés peuvent être affichés, modifiés et commentés depuis les documents de conception, et affiché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 en conjonction avec Altium 365.

Créer un ticket Jira

Pour placer une tâche de type 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 dans le menu déroulant Comment. Appelez 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 comprend ceux disponibles dans votre service Jira. Saisissez un Summary de ticket ainsi qu’une description/un assignataire facultatifs. 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 initiale du commentaire 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 à sa priorité de tâche (Medium, High, etc.) et à ses paramètres 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 dans 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, Assignataire et Commentaires, sont mis en correspondance entre les deux instances. L’utilisateur 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 en tant que 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 du Workspace placée créera un ticket Jira synchronisé dans l’espace Jira. Les deux sont liés par la mise en correspondance du Task ID du Workspace avec le Issue Key Jira.

En plus des paramètres mis en correspondance entre les tickets Workspace et Jira, les paramètres liés à la tâche Priority et au statut Progress sont également synchronisés. Par exemple, le passage de la tâche de ticket Workspace d’un état de priorité Medium à High sera immédiatement répercuté dans le ticket côté Jira, et le changement de l’état d’avancement de To Do à In Progress côté Jira modifiera de manière similaire l’état du ticket Jira du 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 à un ticket Jira

L’intégration Jira d’Altium 365 permet également de lier une tâche du Workspace à un ticket Jira existant 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 quel ticket du projet Jira spécifié, qui sera alors synchronisé avec la tâche Jira du Workspace.

❯ ❮ Javascript ID: LinkJiraIssue

Placez une instance de commentaire sur la zone ou l’objet du document 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) qui sera lié à l’instance de tâche Jira nouvellement placée. Commencez à saisir dans le champ de texte pour rechercher le ticket Jira souhaité. La liste déroulante Jira Issue de la boîte de dialogue affichera le ticket sélectionné de 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 du Workspace et le ticket Jira sélectionné. La nouvelle tâche de ticket 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.

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

Un ticket Jira existant est lié à 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 du 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 assurer le suivi de 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 devra être effectuée plus tard en relation 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 du domaine particulier du projet auquel 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. 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 selon vos besoins, 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 texte (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, Owner et un 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 selon vos besoins, cliquez sur OK pour fermer la boîte de dialogue et revenir au document actif. Une entrée pour l’élément To-Do apparaîtra dans le panneau To-Do ainsi qu’au point 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), incluant le texte réel de l’élément et un identifiant unique, comme montré dans l’image ci-dessous.

Menu du clic droit

Le menu du clic droit 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 de nouveau pour trier par ordre décroissant.
• Le filtrage direct vous permet d’accéder rapidement à une entrée d’élément de tâche en saisissant directement du texte 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 que vous tapez sera sélectionnée, et la lettre sera mise en surbrillance pour indiquer que le filtrage du contenu de la colonne repose sur la lettre saisie.