Création de projets et de documents

Altium Training

Altium Essentials: Project Creation and Storage

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

Toute conception dans Altium Designer commence par un projet qui regroupe ses documents de conception. Cet article explique comment créer un projet dans Altium Designer, choisir un type de projet et un modèle, puis configurer son stockage dans un Workspace connecté, un dépôt de gestion de versions externe ou un dossier local. Il présente également les options de configuration, telles que la gestion de versions, la gestion des contraintes, les chemins d’accès aux dossiers et les paramètres du projet. Poursuivez votre lecture pour partir sur de bonnes bases pour votre prochaine conception.

- Découvrez les options de stockage des projets disponibles et les avantages de la gestion au sein d’un Workspace.
- Apprenez à utiliser la boîte de dialogue Créer un projet pour sélectionner des modèles et configurer les paramètres du projet.
- Découvrez comment les nouveaux projets apparaissent dans le panneau Projets et dans quels cas un projet ne contient qu’une structure vide.
Approfondissez avec l'IA :

Le point de départ de toute conception créée dans Altium Designer est un projet. Un projet Altium Designer regroupe un ensemble de documents de conception dont les données de sortie définissent, à terme, une réalisation unique de ce que vous souhaitez créer. Par exemple, les schémas et le PCB d’un projet PCB comprennent l’ensemble des fichiers nécessaires à la fabrication d’un circuit imprimé. En revanche, l’ensemble des fichiers générés à partir d’un projet de faisceau sert à acheter les composants et à assembler un faisceau de câbles, tandis que les fichiers de schéma logique et d’assemblage physique d’un projet multi-cartes permettent de générer les fichiers nécessaires à la fabrication et à l’assemblage d’un produit complet comportant plusieurs PCB interconnectés.

Les documents de conception du projet peuvent provenir de toute source accessible, qu’elle soit locale à la machine ou non, le fichier de projet les reliant pour former une conception unifiée. Le logiciel utilise la compilation dynamique pour créer et gérer un modèle de données unifié des composants du projet et de leur connectivité. Ce modèle de données peut ensuite servir à propager les modifications entre les domaines de conception, par exemple en effectuant une synchronisation pour résoudre les différences entre les documents des domaines Schéma et PCB.

Les documents du projet peuvent être créés et stockés dans votre espace de travail Altium, dans votre système de gestion de versions ou localement, sous forme de fichiers sur le réseau disponible.

Les sections ci-dessous expliquent comment créer un projet et ajouter des documents de conception à un projet existant.

Création d’un projet à l’aide de la boîte de dialogue Créer un projet

Vous pouvez créer un projet dans Altium Designer à l’aide de la boîte de dialogue Create Project (File » New » Project).

La boîte de dialogue Create Project permet de créer un projet dans votre espace de travail connecté, d’ajouter un projet à un dépôt externe de gestion de versions existant (avec une copie de travail à l’emplacement de votre choix) et de créer un projet dans un dossier spécifique de votre disque dur local.

  1. Dans la liste Locations, sélectionnez l’entrée correspondant à votre espace de travail (elle apparaît sous le nom qui lui a été attribué). Vous devez être connecté à cet espace de travail pour que cette option figure dans la liste. Il s’agit du serveur cible sur lequel sera stocké votre nouveau projet d’espace de travail.

    En résumé, la gestion de projet vise à stocker les données en toute sécurité et à suivre les modifications tout au long du processus de conception, puis à utiliser la conception obtenue pour créer un objet physique, tel qu’un PCB assemblé destiné au produit final. Pour répondre à ces besoins, Altium Designer propose différentes approches de gestion de projet offrant des niveaux croissants de sophistication et de fonctionnalités, tout en simplifiant le processus pour le concepteur. Ces approches vont du stockage et de la gestion de fichiers locaux aux solutions de stockage dans un système de gestion de versions (VCS) local ou distant, jusqu’à la forme avancée et recommandée, dans laquelle la gestion des données de conception repose sur les fonctionnalités d’un espace de travail.

    Un espace de travail connecté et son service VCS interne hébergent et gèrent les projets Altium Designer. Ils offrent également des opérations VCS simplifiées, des fonctionnalités intégrées de collaboration sur la conception, un partage avancé des données de conception, un suivi de l’historique, une gestion du cycle de vie et bien plus encore. Les projets intégrés à un espace de travail sont accessibles directement depuis Altium Designer, notamment depuis le panneau Projects, ou depuis l’espace de travail lui-même via son interface Web.

    Grâce à l’intelligence intégrée aux services fournis par un espace de travail, les tâches telles que les opérations VCS sont simplifiées et automatisées. Des fonctionnalités supplémentaires de collaboration sur la conception, telles que le contrôle d’accès des utilisateurs (partage), les commentaires et l’historique, sont disponibles directement dans Altium Designer. Vous disposez ainsi d’un format et d’un emplacement de stockage des projets fiables et sécurisés, qui peuvent devenir le point central de la conception collaborative.

    Lorsque vous êtes connecté à un espace de travail comportant une ou plusieurs définitions de processus actives pour le thème de processus de création de projets, la création d’un projet via la boîte de dialogue Create Project est limitée aux projets de type Local et VCS. La création de projets dans l’espace de travail est alors régie par les définitions de processus actives. En savoir plus sur la création de projets basée sur les processus.

  2. Dans la liste Project Type, choisissez le type de projet à créer et, si nécessaire, sélectionnez l’un des modèles disponibles correspondants. L’entrée <Empty> crée un projet vide, sans document source initial.

    En savoir plus sur la création d’un modèle de projet.

  3. Saisissez un Project Name et, si vous le souhaitez, une Description de projet.

    Le nom du projet doit commencer par et peut contenir les caractères A-Z, a-z ou 0-9. Les traits de soulignement, les tirets et les espaces sont autorisés, mais ces derniers ne peuvent être utilisés qu’à l’intérieur du nom (les espaces en début et en fin de nom sont ignorés). Vous ne pouvez pas utiliser les mots suivants : AUX, COM1-COM9, LPT1-LPT9, CON, NUL et PRN. De plus, le nom ne peut pas contenir les caractères suivants : \ . / ? % * : | " < >.

La boîte de dialogue Create Project comprend d’autres options :

  • Cochez l’option Version Control (activée par défaut) pour appliquer au projet toutes les fonctionnalités VCS, telles que l’historique et les fonctionnalités de partage avancées. Lorsque cette option est décochée, le projet est stocké dans l’espace de travail et synchronisé avec la copie locale : il s’agit d’un projet « en miroir » au format Simple Sync.

    L’option Version Control n’est disponible que lorsque vous êtes connecté à un espace de travail Altium 365. Lorsque vous êtes connecté à un espace de travail Enterprise Server, cette option est implicitement cochée.
  • Lors de la création d’un projet de type PCB, cochez l’option Constraint Management pour gérer les contraintes de conception de ce projet à l’aide du gestionnaire de contraintes. Lorsque cette option est désactivée, le système de règles de conception est utilisé pour ce projet.

    L’option Constraint Management est activée par défaut dans la boîte de dialogue Create Project lorsque l’option System.ConstraintManager est activée dans la boîte de dialogue Paramètres avancés.

  • Lorsque vous êtes connecté à un espace de travail Enterprise Server, le menu déroulant Repository (s’il est présent) répertorie tous les dépôts de conception gérés par le service de gestion de versions de l’espace de travail et qui ont été partagés avec vous. Choisissez le dépôt dans lequel stocker le nouveau projet et ses fichiers. Un seul dépôt basé sur Git (Versioned Storage) est disponible par défaut. Si vous sélectionnez un dépôt de type SVN, une option supplémentaire Repository Folder permet de spécifier un autre dossier cible au sein du dépôt ou de le sélectionner en parcourant ce dernier.

    Le menu déroulant Repository n’apparaît que si vous avez mis à niveau votre Enterprise Server à partir d’une version ou d’un produit serveur dans lequel l’utilisation de dépôts SVN était activée. Dans les autres cas, Enterprise Server fournit un seul dépôt de conception basé sur Git pour héberger tous les projets de conception de votre espace de travail, et le menu déroulant Repository n’apparaît pas.

    SVN n’est plus pris en charge dans Altium On-Prem Enterprise Server à partir de la version 7.2. Pour éviter les limitations liées à la gestion d’un projet SVN, il est recommandé de migrer les projets SVN vers le dépôt Git intégré de l’espace de travail Enterprise Server. Cette opération peut être effectuée avant la mise à niveau du serveur, comme décrit ici.

    Pour plus d’informations sur l’abandon de SVN dans Altium On-Prem Enterprise Server, consultez l’article de la base de connaissances Arrêt de la prise en charge de SVN avec Altium On-Prem Enterprise Server 7.2.1.

  • Cliquez sur la commande Advanced pour spécifier les chemins des dossiers.

    • Utilisez le champ Folder pour spécifier où le dossier du projet doit être créé dans l’arborescence des dossiers de l’espace de travail. Le chemin par défaut des nouveaux projets est défini sur la page Admin – Settings – Projects de l’interface Web de l’espace de travail (par défaut, il s’agit de Projects\<ProjectName>). Cliquez sur le bouton pour parcourir les dossiers et sélectionner un autre dossier de l’espace de travail, si nécessaire.

      Si l’utilisateur qui crée un projet dans l’espace de travail connecté ne dispose pas des autorisations d’écriture sur le dossier de projet par défaut, le système crée automatiquement une structure Personal Folder propre à cet utilisateur pour stocker le nouveau projet. Celle-ci se présente sous la forme d’un dossier de premier niveau nommé d’après l’adresse e-mail du membre (pour un espace de travail Altium 365) ou son nom d’utilisateur (pour un espace de travail Enterprise Server), avec un sous-dossier My Projects qui stocke les projets de cet utilisateur. Cette arborescence de dossiers n’est accessible qu’à l’utilisateur connecté et aux administrateurs ; elle n’est pas visible par les autres utilisateurs. Pour en savoir plus sur Managing Project Creation Permissions (espace de travail Altium 365, espace de travail Enterprise Server).

    • Utilisez le champ Local Storage pour spécifier où la version locale du projet sera stockée sur votre disque dur. L’emplacement par défaut est défini sur la page Système – Emplacements par défaut de la boîte de dialogue Preferences. Cliquez sur le bouton pour parcourir les dossiers et sélectionner un autre emplacement, si nécessaire. Il s’agit du dossier de travail du projet et du dépôt Git local dans lequel il est enregistré par un commit. Le projet est, à terme ou au moment du commit, envoyé vers le dépôt de conception centralisé de l’espace de travail (Versioned Storage), qui constitue le dépôt Git remote.

     

  • Utilisez la zone de liste Parameters pour ajouter ou supprimer des paires de paramètres Nom/Valeur personnalisées, associées au projet et enregistrées dans l’espace de travail. Utilisez le bouton pour ajouter une nouvelle paire de paramètres Nom/Valeur à la liste, ou le bouton  pour supprimer la paire sélectionnée. Les champs Nom et Valeur acceptent au maximum 255 caractères. Lors de la création d’un projet dans l’espace de travail, ces paramètres sont enregistrés avec le nouveau projet en tant que paramètres de projet côté espace de travail.

    Lorsqu’un modèle de projet est sélectionné dans la liste Project Type de la boîte de dialogue, la zone de liste Parameters est renseignée avec les paramètres de ce modèle. Si nécessaire, vous pouvez modifier ces paramètres (noms et/ou valeurs) ou les supprimer. Lors de la création d’un projet dans l’espace de travail, un paramètre issu du modèle sélectionné est enregistré en tant que paramètre de projet côté conception si son nom n’a pas été modifié. Dans le cas contraire, il est enregistré en tant que paramètre de projet côté espace de travail.

    Les paramètres de projet côté espace de travail peuvent être modifiés dans l’espace de travail. En revanche, les paramètres côté conception sont enregistrés dans le fichier du projet (*.PrjPcb) et peuvent être modifiés dans Altium Designer. Les paramètres de projet des deux types peuvent être consultés dans l’onglet Paramètres de la boîte de dialogue Project Options (Project » Project Options) et peuvent être utilisés comme chaînes spéciales dans Altium Designer.

Une fois le projet défini comme souhaité, cliquez sur le bouton . La structure du nouveau projet est créée dans les dossiers locaux et de l’espace de travail spécifiés. Le projet s’ouvre dans le panneau Projects, qui indique que les fichiers du dépôt de conception distant (dans l’espace de travail) et ceux du dépôt local (copie de travail) sont entièrement synchronisés, comme le signalent les icônes associées. Si le projet est créé avec l’option Version Control décochée (disponible uniquement dans un espace de travail Altium 365), le projet en miroir s’affiche dans le panneau Projects avec une icône associée.

Le projet nouvellement créé, enregistré par un commit dans le dépôt de conception Versioned Storage de l’espace de travail.Le projet nouvellement créé, enregistré par un commit dans le dépôt de conception Versioned Storage de l’espace de travail.

En revanche, si le nouveau projet n’a not reçu de modèle comprenant des documents, seul le fichier du projet (*.PrjPcb), et donc uniquement la structure du projet, est créé. Le projet s’ouvre ensuite dans le panneau Projects, où il apparaît comme Scheduled for addition, ce qu’indique l’icône associée. À ce stade, vous pouvez ajouter des documents au projet ou simplement enregistrer sa structure vide dans l’espace de travail. Pour ce faire, cliquez sur la commande Save to Server associée à l’entrée du projet dans le panneau Projects ; cette commande est également disponible dans le menu contextuel accessible par clic droit et dans le menu principal File. Dans la boîte de dialogue Enregistrer sur le serveur qui s’affiche, sélectionnez ou désélectionnez les fichiers à inclure, ajoutez éventuellement un Comment, puis confirmez l’enregistrement avec le bouton . Une fois le projet ajouté au serveur, le panneau Projects indique que les fichiers du dépôt du serveur et ceux de la copie de travail locale sont entièrement synchronisés, comme le signalent les icônes .

  • Le projet apparaît dans le panneau Projects, sous une entrée correspondant à l’espace de travail cible et portant son nom.

  • Une entrée correspondant au projet apparaît également sur la page Projects de l’interface Web de l’espace de travail.

  • Le projet est initialement partagé avec un accès en lecture/écriture pour le concepteur qui l’a créé (propriétaire) et pour tous les administrateurs de l’espace de travail.

    Consultez Partager une conception pour plus d’informations sur la configuration des autorisations d’accès au projet.

  • Un nouveau projet peut également être créé directement dans un espace de travail, via la page des conceptions de son interface Web (sélectionnez Projects), puis ouvert dans Altium Designer pour le modifier et y ajouter des éléments.

  • Le fichier de structure du projet (*.PrjPCBStructure) est créé en même temps que le fichier du projet (*.PrjPcb). Ce fichier contient des informations sur la hiérarchie du projet, qu’il soit à plat ou hiérarchique. Il est régénéré lors de la compilation dynamique du projet (à l’ouverture d’un document du projet).

  • La boîte de dialogue Create Project est également accessible en cliquant avec le bouton droit sur l’entrée de l’espace de travail dans le panneau Projects , puis en choisissant la commande Create Project dans le menu.

Copier un projet

Pour copier un projet d’un espace de travail depuis Altium Designer, cliquez avec le bouton droit sur l’entrée du projet dans le panneau Projects et choisissez la commande Make a copy  dans le menu contextuel. Utilisez la boîte de dialogue Create Project Copy pour définir le Project Name (par défaut, il s’agit du nom du projet d’origine suivi du suffixe - Copy), la Description (qui n’est pas préremplie), le chemin Folder (dans l’espace de travail) et le chemin Local Storage (vers la copie de travail).

Aucune autorisation particulière n’est nécessaire pour copier un projet. Le projet copié est une copie exacte du projet d’origine de l’espace de travail et possède les mêmes propriétés de modification, sans restrictions : vous ne pouvez donc pas créer un projet « en lecture seule ». Notez également que le projet copié sera créé dans le même dépôt de conception que l’original ; vous ne pouvez pas modifier ce paramètre lors de la copie.

Par défaut, le Folder de l’espace de travail correspond au dossier dans lequel le projet d’origine est stocké. Cliquez sur pour ouvrir la boîte de dialogue Choose Folder (une version simplifiée du panneau Explorateur) et changer de dossier si nécessaire. Par défaut, le Local Storage utilise l’emplacement défini sur la page Système - Emplacements par défaut de la boîte de dialogue Preferences. Cliquez sur pour ouvrir une boîte de dialogue Windows standard permettant de modifier cet emplacement si nécessaire.

Copier un projet d’un espace de travail depuis Altium Designer.
Copier un projet d’un espace de travail depuis Altium Designer.

Chaque fois que vous copiez le projet, une vignette d’événement Project Copied est ajoutée à la chronologie de l’historique du projet copié. De plus, la vignette Project Created de la copie du projet contient un lien vers le projet d’origine. En savoir plus sur l’historique du projet.
Vous pouvez copier un projet existant de l’espace de travail depuis la boîte de dialogue Ouvrir un projet. Sélectionnez le projet dans l’espace de travail auquel vous êtes connecté, puis cliquez sur la commande Open Project As Copy en bas du volet Information de droite. De plus, lorsque vous parcourez le projet dans le panneau Explorer d’Altium Designer, configuré dans son mode Project View par défaut plutôt que dans le mode Classic View, vous pouvez copier le projet en cliquant sur le bouton Copy  en haut à droite du panneau.
Vous ne pouvez copier un projet d’espace de travail que s’il a été ouvert depuis l’espace de travail Altium auquel vous êtes actuellement connecté. Si Altium Designer n’est pas actuellement connecté à l’espace de travail du projet, ou si le projet n’est pas un projet d’espace de travail, la commande Make a copy ne sera pas disponible dans le menu contextuel.

Ajout et suppression d’un document de conception

Une fois le projet créé, vous pouvez ajouter, modifier ou supprimer des documents de conception dans le projet actif. La façon la plus simple d’ajouter de nouveaux documents de conception à un projet consiste à cliquer avec le bouton droit sur le nom du projet dans le panneau Projects et à sélectionner Add New to Project dans le menu contextuel. Vous pouvez également choisir le type de document souhaité dans le sous-menu Project » Add New to Project des menus principaux pour ajouter un nouveau document au projet actif.

  • Si des valeurs par défaut peuvent être définies pour le type de document choisi sur la page Gestion des données - Modèles de la boîte de dialogue Preferences, le document sera créé en utilisant ces valeurs par défaut comme modèle.
  • Le document n’est pas enregistré à sa création.

Ajouter un document spécifique ou un autre type de document à un projet.
Ajouter un document spécifique ou un autre type de document à un projet.

D’autres types de documents utiles au projet peuvent également y être ajoutés, tels que des fichiers texte, des PDF, des feuilles de calcul, etc. Pour ce faire, utilisez l’option Add Existing to Project (ou la commande Project » Add Existing to Project du menu principal de l’éditeur du document actif) et réglez la liste déroulante File Type de la boîte de dialogue de sélection de fichiers Choose Document to Add sur All Files (*.*) pour accéder à tous les types de fichiers.

Les projets de conception ne sont pas limités aux fichiers créés par Altium Designer : pratiquement n’importe quel document peut être inclus dans un projet. Lorsque vous accédez au document depuis Altium Designer, le système tente de déterminer l’outil de création ou de visualisation correspondant en fonction de l’extension du fichier et des paramètres du Registre Windows. Si une correspondance est trouvée, Altium Designer lance l’éditeur associé, soit dans son propre environnement d’édition, soit en tant qu’application distincte. Vous pouvez ainsi inclure toutes sortes de documents de test, de documentation, de référence et de spécification dans vos projets de conception, avec l’assurance que, où que le projet soit transféré, toute la documentation associée l’accompagnera.
Lors de l’ajout de documents existants à un projet d’un espace de travail Altium 365, notez qu’une limitation s’applique aux fichiers zip, 7z et rar de plus de 256 Mo. Les projets contenant de tels fichiers ne peuvent pas être enregistrés dans l’espace de travail : une erreur Git s’affiche. Consultez l’article de la base de connaissances Comment corriger les données d’un projet après une erreur Git avec le code d’état 471 pour savoir comment résoudre ce problème.

Pour supprimer un document de la structure du projet, cliquez avec le bouton droit sur son nom dans le panneau Projects et sélectionnez l’option de menu Remove from Project, ou choisissez la commande Project » Exclude from Project dans les menus principaux. Vous serez invité à choisir :

  • Delete File – pour supprimer définitivement le fichier source du document lui-même.
  • Exclude from Project – pour supprimer le lien du projet vers ce document (sans supprimer le fichier source du document lui-même). S’il est actuellement ouvert dans la fenêtre de l’éditeur de conception, il sera retiré de son projet parent, mais restera ouvert dans le panneau en tant que document libre. En revanche, s’il n’est pas actuellement ouvert dans l’espace de conception, sa suppression entraînera sa fermeture.

Vous pouvez également retirer de leur projet parent tous les documents de la catégorie (sous-dossier) sélectionnée en cliquant avec le bouton droit sur l’entrée de la catégorie souhaitée et en choisissant la commande Remove All dans le menu contextuel.

Suppression d’un projet

Pour les projets locaux, la suppression d’un projet consiste à supprimer les fichiers de votre disque dur. Ouvrez le dossier du projet dans l’Explorateur Windows et supprimez son contenu.

Pour ouvrir rapidement une fenêtre de l’Explorateur Windows à l’emplacement où le projet est stocké, cliquez avec le bouton droit sur l’entrée du projet dans le panneau Projects et sélectionnez la commande Explore.

Pour les projets d’espace de travail (et les autres contenus de l’espace de travail, tels que les composants et les données publiées), des fonctionnalités de suppression souples sont disponibles directement dans Altium Designer, depuis le panneau Explorateur. Fonctionnant comme une « suppression réversible », le processus de suppression propose davantage d’options et d’informations au fil des étapes, notamment des liens pertinents vers les éléments sources pour vous permettre de les examiner. Dans l’espace de travail, le contenu supprimé est déplacé vers un emplacement Trash dédié, d’où il peut être restauré ou supprimé définitivement depuis la page Trash de l’interface Web de l’espace de travail.

Pour un projet, seuls son propriétaire ou un administrateur peuvent le supprimer définitivement ou le restaurer depuis la Trash.

Pour effectuer une suppression réversible d’un projet de l’espace de travail, accédez au dossier du projet dans le panneau Explorer, faites un clic droit sur son entrée et sélectionnez la commande Delete Folder dans le menu contextuel. Confirmez la suppression dans la boîte de dialogue Confirm Delete qui s’affiche. Si le projet contient des données publiées, une autre boîte de dialogue de confirmation s’ouvre pour vous informer que ces données seront également supprimées. Cliquez sur Delete pour continuer.

Pour ouvrir rapidement le panneau Explorer avec le dossier du projet sélectionné, faites un clic droit sur l’entrée du projet dans le panneau Projects et sélectionnez la commande Show in Explorer.

La suppression réversible en action. Ici, un projet est supprimé, ainsi que la révision publiée qui lui est associée (si des dossiers de fabrication avaient été créés à partir de révisions publiées, ils seraient également supprimés).
La suppression réversible en action. Ici, un projet est supprimé, ainsi que la révision publiée qui lui est associée (si des dossiers de fabrication avaient été créés à partir de révisions publiées, ils seraient également supprimés).

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