Commentaires de document

Altium Training

Altium Essentials: Design Review and Commenting

This content is part of the official Altium Professional Training Program. For full courses, materials and certification, visit Altium Training.

En un coup d'œil

Découvrez comment les commentaires sur les documents dans Altium Designer aident les équipes à examiner les projets partagés de l’espace de travail sans modifier les documents de conception sous-jacents. Ce guide présente les types de documents pris en charge, l’ajout de commentaires et de réponses, l’attribution de tâches lorsque cette fonction est disponible, ainsi que la gestion des retours dans le panneau Commentaires et tâches. Poursuivez votre lecture pour mieux exploiter les commentaires lors des revues de conception de votre équipe.

- Découvrez quels documents prennent en charge les commentaires et comment accéder au panneau Commentaires et tâches.
- Apprenez à associer des commentaires à des objets, à des points ou à des zones, selon le type de document.
- Explorez les filtres, les paramètres de notification et les exportations PDF pour organiser et partager les retours de revue.
Approfondissez avec l'IA :

Lorsqu’ils sont intégrés à un Workspace connecté, les projets Altium Designer permettent à une équipe de conception répartie sur plusieurs sites 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 à divers 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 les autres utilisateurs peuvent y répondre.

Le panneau Comments and Tasks 
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 aucun des documents qui le composent. La fonctionnalité de commentaire est gérée depuis 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 de les attribuer à des membres du Workspace, créant ainsi des tâches à leur intention. Le panneau permet à tous les utilisateurs travaillant sur le document d’ajouter des commentaires et de consulter l’ensemble des commentaires sans modifier le document lui-même. Cette fonctionnalité facilite une collaboration efficace et s’avère précieuse lorsqu’il faut signaler des problèmes dans le document sans avoir à effectuer de fusion ni à gérer les conflits qui peuvent en résulter. Le panneau Comments and Tasks peut ainsi servir à créer une liste de tâches à effectuer et, à mesure que la conception progresse, les commentaires peuvent être résolus et clos. 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 le Workspace indépendamment du projet, sans modifier aucun des documents qui le composent.

Si vous n’avez pas accès à la fonctionnalité de création et de gestion des tâches, celle-ci ne sera pas disponible et le panneau sera nommé Comments.

Pour plus d’informations sur les projets du point de vue d’un Workspace, consultez Workspace Projects (Workspace Altium 365, Workspace Enterprise Server ).

Notez que les commentaires et les tâches peuvent être ajoutés et gérés aussi bien dans Altium Designer que dans le Workspace associé, via la vue de conception de son interface de navigateur. Les fonctionnalités des deux systèmes de commentaires sont essentiellement identiques et, puisque les données du projet et des commentaires sont stockées dans le Workspace, les systèmes fonctionnent ensemble en temps réel.

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

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 d’implantation 2D) — .

Notez que la sélection d’un commentaire dans un document PCB active automatiquement la même vue que celle utilisée par le réviseur (couches visibles, couche active, vue de dessus/dessous). Un exemple de changement de configuration d’affichage lors de la sélection d’un commentaire est présenté ci-dessous.

Javascript ID : PCB_Support1

Configuration d’affichage avant la sélection d’un commentaire : toutes les couches de signal sont activées, Bottom est la couche active et la carte est vue de dessous.

La carte après la sélection d’un commentaire (la même vue que lors de l’ajout du commentaire est appliquée) : Top est la seule couche de signal activée, Top est la couche active et la carte est vue de dessus.

Draftsman

Un commentaire peut être appliqué à un point précis ou à une zone dans un document Draftsman d’un projet PCB, multi-cartes ou de conception de faisceaux — .

Schéma multi-cartes

Les commentaires dans les documents schématiques multi-cartes sont disponibles lorsque l’option MBS.Comments est activée dans la boîte de dialogue Paramètres avancés.

Un commentaire peut être appliqué à un objet ou à un point précis dans un document schématique multi-cartes — .

Assemblage multi-cartes

Les commentaires dans les documents d’assemblage multi-cartes sont disponibles lorsque l’option MBA.Comments est activée dans la boîte de dialogue Paramètres avancés.

Un commentaire peut être appliqué à un point précis dans le document d’assemblage multi-cartes — .

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

Les commentaires dans les documents de schéma de câblage et de plan d’implantation de faisceau sont disponibles lorsque l’option Harness.Comments est activée dans la boîte de dialogue Paramètres avancés.

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 faisceaux .

ActiveBOM

Les commentaires dans les documents ActiveBOM sont disponibles lorsque l’option BOM.Comments est activée dans la boîte de dialogue Paramètres avancés.

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 Workspace de l’une des manières 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 nécessaire pour consulter les données du panneau associé. Une icône bleue () indique qu’une connexion à un Workspace est actuellement établie. Une icône grise () indique qu’aucune connexion à un Workspace n’est actuellement établie ; vous serez alors 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 le repère d’un commentaire placé dans l’espace de conception.

Pour accéder au panneau Comments and Tasks, le document actif doit être un document schématique, PCB, ActiveBOM, schématique multi-cartes ou Draftsman d’un projet Workspace ouvert. Seuls les projets actuellement partagés avec vous pourront être sélectionnés.

Ajouter un commentaire sans être connecté à un Workspace

Avant d’utiliser la fonctionnalité de commentaires, assurez-vous d’être connecté à votre Workspace 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 Workspace parmi ceux qui ont été partagés avec vous. Le panneau Comments and Tasks vous guidera concernant ces prérequis.

Si vous profitez des avantages de votre abonnement, mais n’avez pas encore créé de Workspace Altium 365 pour votre entreprise, vous pouvez tester les fonctionnalités de commentaires en mode démonstration. Lorsque vous êtes connecté à votre compte Altium depuis Altium Designer et travaillez sur un projet local, vous pouvez placer jusqu’à trois commentaires. Pour utiliser toutes les fonctionnalités de commentaires et enregistrer les commentaires placés, le projet doit être mis à disposition dans le Workspace. Une commande appropriée est proposée à cet effet dans la zone de message située sous la boîte de dialogue contextuelle de commentaire dans l’espace de conception.

Essayez la fonctionnalité de commentaires en mode démonstration si vous ne disposez pas encore d’un Workspace Altium 365 activé.
Essayez la fonctionnalité de commentaires en mode démonstration si vous ne disposez pas encore d’un Workspace Altium 365 activé.

Options du panneau Comments and Tasks

Utilisez les boutons situés 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 indiquer si les utilisateurs mentionnés doivent recevoir 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 Comments and Tasks 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 les types sont activés par défaut.

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

  • 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, seules les entrées de 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 l’affichage 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 de 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’un 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 les informations relatives aux 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 publications 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, elles 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 suivante pour définir son emplacement et son nom (par défaut, celui du projet).

L’exportation des commentaires au format PDF peut également être configurée et effectuée à l’aide d’un fichier Output Job dans le cadre de la publication du projet. Ajoutez un Export Comments générateur de sortie dans la catégorie Report Outputs.

Notez que la fonctionnalité d’exportation des commentaires est uniquement disponible pour les membres du Workspace dans lequel réside le projet. Elle n’est pas disponible pour les utilisateurs avec lesquels le projet a été partagé en dehors du Workspace.
  • Entire designs snapshots - inclut une capture de chaque document source comportant un commentaire dans l’intervalle de temps Period spécifié. Cela permet de visualiser l’emplacement du commentaire sur le document grâce à un marqueur de commentaire numéroté.
  • Original design screenshots - inclut la capture d’origine prise lors de la création d’un commentaire (il s’agit de la capture disponible dans la fenêtre Contextual Commenting lorsque l’on clique sur un marqueur de commentaire dans l’espace de conception principal). Elle 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 de l’angle 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 prend la forme d’un réticule accompagné 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 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 spécifiée ().

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.

Cette action de placement ouvre une boîte de dialogue de saisie de commentaire comportant 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. Celui-ci sera associé à un marqueur numéroté sur le document, et une entrée récapitulative sera ajoutée 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.

Un commentaire placé est immédiatement accessible à tous les utilisateurs ayant accès au projet. Il est également disponible dans la vue du projet accessible depuis un navigateur dans le Workspace connecté.

Le nombre de caractères pouvant être saisis dans un commentaire standard et une tâche est limité à 2000.

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 ; concrètement, une task sera attribuée à cet 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 Partager ; l'utilisateur recevra un e-mail l'informant de ce partage d'accès. Si vous annulez la boîte de dialogue Partager, le projet ne sera pas partagé, mais le commentaire sera ajouté 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 s'affiche également dans la boîte de dialogue de commentaire et dans 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.

Une tâche peut être associée à un commit du projet lors de l'enregistrement du projet dans l'espace de travail connecté. Comme l'indique l'astuce dans la boîte de dialogue Enregistrer sur le serveur, ajoutez l'identifiant de la tâche dans le champ Comment (tel qu'il apparaît dans le panneau Comments and Tasks) ; la tâche sera liée au commit du projet qui sera créé après avoir cliqué sur OK dans la boîte de dialogue.

Le lien vers le commit s'affiche dans le volet des détails de la tâche lorsque sa vignette est sélectionnée sur la page Tasks de l'interface Web de l'espace de travail (espace de travail Altium 365, espace de travail Enterprise Server) ou dans la vue Tasks de la page de gestion détaillée du projet (espace de travail Altium 365, espace de travail Enterprise Server). Cliquez sur le lien pour ouvrir la vue History du projet avec le commit associé mis en évidence sur la chronologie.

Le lien vers le commit associé s'affiche dans le volet des détails de la tâche. Survolez l'image avec le curseur pour voir la page History qui s'ouvre après un clic sur le lien, ainsi que le commit associé mis en évidence sur la chronologie.
Le lien vers le commit associé s'affiche dans le volet des détails de la tâche. Survolez l'image avec le curseur pour voir la page History qui s'ouvre après un clic sur le lien, ainsi que le commit associé mis en évidence sur la chronologie.

Positionnement

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

Bien que vous puissiez déplacer l'épingle d'un commentaire par glisser-déposer dans l'éditeur de document, le point ou la zone définis initialement ne peuvent pas être modifiés.

Notez qu'un commentaire peut également être positionné lors de son placement initial par cliquer-glisser en mode 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 à l'aide d'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 affichant Add others with @ or paste images). 

La taille de chaque image est limitée à 2 Mo. Après l'avoir collée dans le commentaire, cliquez sur l'image pour l'afficher en entier, comme illustré sur 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 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 des commentaires dans le menu déroulant Commands, ainsi que de modifier l'épaisseur, la taille et la couleur dans le menu déroulant 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. Le panneau affiche le même contenu et les mêmes attributs 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.
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.

Une tâche générale pour un projet peut être créée depuis la page Tasks de l'interface Web de l'espace de travail, en accédant à la page de gestion détaillée du projet. Pour en savoir plus, consultez Management of a Specific Project ( Espace de travail Altium 365, Espace de travail Enterprise Server).

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 dans 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 répertoriés à la fois dans le panneau Comments and Tasks (sous forme d’une série d’entrées numérotées) et dans l’éditeur de documents correspondant (sous forme de repères numérotés). Chaque entrée du panneau représente un fil de discussion 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 et affectations, ainsi que le nombre de réponses dans le fil.

Pour ouvrir un fil de discussion, 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 de documents et la boîte de dialogue du commentaire s’ouvre, affichant 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 ouvre ce document (et le charge, si nécessaire).

Navigation entre 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 la boîte de dialogue contextuelle des commentaires, qui affiche toutes les entrées du fil de discussion sélectionné et propose des options permettant de prévisualiser une entrée, d’y répondre, de la modifier, de la résoudre ou de la supprimer. Cette 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 des commentaires.

Parcourez successivement tous les commentaires disponibles à l’aide des boutons précédent/suivant () situés dans l’en-tête de la boîte de dialogue.

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 discussion. 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 de discussion 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 discussion. 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), et 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 dans 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 reçoit immédiatement, lors de sa création, la priorité Medium et l’état To Do, mais ceux-ci peuvent être modifiés en cliquant sur la commande correspondante en haut de la boîte de dialogue des commentaires.

Informations sur l’étiquette de commit, l’identifiant de révision de publication et la revue de conception 

Les étiquettes de commit et les identifiants de révision de publication sont affichés lors de la consultation des commentaires/tâches concernés, à la fois dans le panneau Comments and Tasks et 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 cette publication. Cliquez sur le lien de l’identifiant de révision de publication 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 la 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 Jira dans votre service Atlassian Jira® et de l’y associer. 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, ainsi que consultés et 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.

  • Consultez la page Intégration Jira pour un aperçu des fonctionnalités.

  • Consultez la page Découverte de l’interface Web pour en savoir plus sur la configuration de l’intégration Jira pour votre espace de travail Altium 365.

  • Consultez la page Web Viewer pour en savoir plus sur l’utilisation des tâches Jira dans le Web Viewer de l’interface Web de l’espace de travail Altium 365.

Créer un ticket Jira

Pour placer une tâche de ticket Jira dans 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 des commentaires. Choisissez ensuite un type de ticket et ajoutez un résumé pour créer la tâche de ticket Jira synchronisée.

Placez une tâche Jira dans le document du projet actuel en commençant par placer une instance de commentaire. Le mode Jira alternatif est disponible dans le menu déroulant Comment.

Lancez le placement d’une 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 les types disponibles dans votre service Jira.

Saisissez un Summary pour le ticket et, si vous le souhaitez, une description et une personne assignée. La liste déroulante Assignee ne comprend que les utilisateurs membres de votre compte Jira. Sélectionnez Post pour confirmer.

Le ticket Jira est placé à la position initiale du commentaire dans le document et figure dans le panneau Comments and Tasks. Il fournit un lien vers le ticket dans l’espace Jira et permet de modifier de manière interactive les paramètres de priorité (Medium, High, etc.) et d’état (To Do, In Progress, etc.) de la tâche.

 
 
 
 
 
 
  • Le nombre de caractères pouvant être saisis lors de la publication d’un commentaire lié à Jira ou d’une réponse à celui-ci est limité à 20 000.

  • Lors de la création d’une tâche Jira depuis Altium Designer, les champs suivants sont pris en charge :

    • Texte

    • Nombre

    • Champ URL

    • Liste déroulante

    • Liste déroulante avec recherche (pour l’utilisateur assigné, la recherche de tickets Jira et la recherche d’une tâche parente lors de la création d’une sous-tâche)

    • Champ à sélection multiple (des cases à cocher accompagnées d’un « avertissement » demandant de sélectionner au moins une option pour continuer sont affichées – ).

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 en est le rapporteur 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).

Le placement d’une tâche Jira 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.
Le placement d’une tâche Jira 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 d’état 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 se répercute immédiatement sur 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 de 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 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) à 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 s’affiche dans le panneau Comments and Tasks et dans la boîte de dialogue de commentaire, qui comprend 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.
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 To-Do

Le panneau To-Do est disponible lorsque l’option UI.PanelToDoList est activée dans la boîte de dialogue Paramètres avancés.

Bien que votre espace de travail connecté offre un ensemble complet de 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 toutes les tâches à faire actuellement définies pour le projet actif. Une tâche à faire sert de rappel pour une action à effectuer ultérieurement dans un document.

Le panneau To-Do
Le panneau To-Do

AI-LocalizedLocalisé par IA
Si vous trouvez un problème, sélectionnez le texte/l’image et appuyez surCtrl + Enterpour nous envoyer vos commentaires.
Nav
Contents
Disponibilité des fonctionnalités

Les fonctionnalités auxquelles vous avez accès dépendent de la solution Altium dont vous disposez – Altium Develop, Altium Agile Teams, Altium Agile Enterprise, ou Altium Designer (avec un abonnement actif).

Si vous ne voyez pas une fonctionnalité documentée dans votre logiciel actuel, contactez le service commercial d’Altium pour en savoir plus.

Documentation héritée

La documentation d’Altium Designer n’est plus versionnée. Si vous devez accéder à la documentation des versions antérieures d’Altium Designer, consultez la section Documentation héritée de la page Other Installers.

Contents