Creating Projects and Documents

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 la sortie définit au final une implémentation 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é. À l’inverse, l’ensemble des fichiers générés à partir d’un projet de faisceau est utilisé pour acheter et assembler un faisceau de câbles, et les fichiers de schéma logique et d’assemblage physique d’un projet multi-cartes produisent l’ensemble des fichiers nécessaires à la fabrication et à l’assemblage d’un produit complet comportant plusieurs PCB connectés.

L’ensemble des documents de conception du projet peut être rassemblé à partir de toute source accessible, locale à la machine ou non, le fichier de projet les reliant entre eux en une conception unifiée. Le logiciel utilise une 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 être utilisé pour propager les modifications de conception entre les domaines de conception – par exemple, en synchronisant pour résoudre les différences entre les documents des domaines Schématique et PCB.

Les documents du projet peuvent être créés et stockés dans votre Workspace Altium, dans votre système de contrôle de version, ou localement sous forme de fichiers sur le réseau disponible.

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

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

Un nouveau projet peut être créé dans Altium Designer à l’aide de la boîte de dialogue Create Project (File » New » Project).

1. Dans la liste Locations, sélectionnez l’entrée correspondant à votre Workspace (elle apparaîtra avec le nom qui lui a été défini) – vous devez être connecté activement au Workspace pour voir cette option dans la liste. Ce sera le serveur cible dans lequel stocker votre nouveau projet Workspace.

   En bref, la gestion de projet vise à stocker en toute sécurité et à suivre les modifications tout au long du processus de conception, puis, au final, à orienter la conception résultante vers la création d’un élément physique – tel qu’un PCB assemblé destiné à être utilisé dans le produit final. Pour répondre à ces besoins, Altium Designer propose une gamme d’approches de gestion de projet offrant des niveaux croissants de sophistication et de capacités, tout en simplifiant le processus du point de vue du concepteur. Celles-ci vont du stockage et de la gestion locaux basés sur des fichiers, aux approches de stockage via un système de contrôle de version (VCS) local/distant, jusqu’à sa forme avancée et recommandée où la gestion des données de conception est centrée sur les capacités d’un Workspace.

   Un Workspace connecté et son service VCS interne hébergent et gèrent les projets Altium Designer, et fournissent également des opérations VCS simplifiées, des capacités inhérentes de collaboration de conception, un partage avancé des données de conception, le suivi de l’historique, la gestion du cycle de vie, et bien plus encore. Les projets intégrés à un Workspace sont accessibles directement depuis Altium Designer, par exemple depuis le panneau Projects, ou depuis le Workspace lui-même via son interface basée sur navigateur.

   Grâce à l’intelligence intégrée aux services fournis par un Workspace, des tâches telles que les opérations VCS sont simplifiées et automatisées, et des fonctionnalités supplémentaires de collaboration de conception telles que le contrôle d’accès utilisateur (partage), les commentaires et l’historique sont disponibles directement dans Altium Designer. Le résultat final est un format et un emplacement de stockage de projet robustes et sécurisés pouvant devenir le point central de la conception collaborative de projets.

   Lorsqu’il est connecté à un Workspace avec une ou plusieurs définitions de processus actives pour le thème de processus Project Creations, la possibilité de créer un nouveau projet via la boîte de dialogue gh the Create Project dialog est limitée aux projets de type Local et VCS uniquement. À la place, la création de projets basés sur Workspace est soumise au contrôle des définitions de processus actives. En savoir plus sur la création de projet basée sur les processus.

2. Dans la liste Project Type, choisissez le type de projet que vous souhaitez créer, puis sélectionnez parmi les modèles applicables disponibles selon vos besoins. L’entrée <Empty> créera un projet vide sans documents source initiaux.

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

3. Saisissez un Project Name et, éventuellement, une Description de projet.

   Le nom du projet doit commencer par et peut contenir A-Z, a-z ou 0-9. Les caractères de soulignement, les tirets et les espaces sont autorisés, mais ces derniers ne peuvent être utilisés qu’au milieu du nom (les espaces en début et en fin seront ignorés). Vous ne pouvez pas utiliser les mots suivants : AUX, COM1-COM9, LPT1-LPT9, CON, NUL et PRN. En outre, 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 (par défaut) pour appliquer au projet toutes les capacités VCS, telles que l’historique et les capacités avancées de partage. Lorsqu’elle est décochée, le projet est stocké dans le Workspace et synchronisé avec la copie locale – un projet « miroir » au format Simple Sync.

  L’option Version Control est disponible uniquement lorsque vous êtes connecté à un Altium 365 Workspace. Lorsque vous êtes connecté à un Enterprise Server Workspace, cette option est effectivement 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 Constraint Manager. Lorsque l’option est désactivée, le système de règles de conception sera 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 Advanced Settings dialog.

• Lorsque vous êtes connecté à un Enterprise Server Workspace, le menu déroulant Repository (s’il est présent) répertorie tous les dépôts de conception gérés via le Version Control Service du Workspace et qui vous ont été partagés pour utilisation. Choisissez le dépôt dans lequel stocker le nouveau projet et ses fichiers – un dépôt unique basé sur Git (Versioned Storage) est disponible par défaut. Si un dépôt de type SVN est sélectionné, une option supplémentaire Repository Folder est disponible pour spécifier ou parcourir jusqu’à un autre dossier cible dans le dépôt lui-même.

  Le menu déroulant Repository n’apparaît que si vous avez mis à niveau votre Enterprise Server depuis une version ou un produit serveur où l’utilisation de dépôts SVN était activée. Sinon, l’Enterprise Server fournit un dépôt de conception unique basé sur Git pour accueillir tous vos projets de conception Workspace, et le menu déroulant Repository n’apparaît pas dans ce cas.

  SVN n’est pas 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é du Workspace Enterprise Server. Cela peut être fait 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 SVN Discontinuation with Altium On-Prem Enterprise Server 7.2.1.

• Cliquez sur le contrôle Advanced pour spécifier les chemins de dossier.

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

    Si l’utilisateur qui crée un projet dans le Workspace connecté ne dispose pas des autorisations d’écriture sur le dossier de projet par défaut, le système créera automatiquement une structure spécifique à l’utilisateur Personal Folder pour stocker le nouveau projet. Celle-ci apparaît comme un dossier de niveau supérieur basé sur l’adresse e-mail du membre (pour un Altium 365 Workspace) ou le nom d’utilisateur (pour un Enterprise Server Workspace), avec un sous-dossier My Projects qui stocke les projets de cet utilisateur. La structure/hierarchie de dossiers n’est disponible que pour l’utilisateur connecté et les administrateurs – elle n’est pas visible par les autres utilisateurs. En savoir plus sur Managing Project Creation Permissions (Altium 365 Workspace, Enterprise Server Workspace).

  • 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 System – Default Locations de la boîte de dialogue Preferences. Cliquez sur le bouton pour parcourir et sélectionner un autre emplacement de dossier, si nécessaire. Il s’agit du dossier de « travail » du projet et du dépôt Git local auquel il est validé. Le projet est finalement, ou au moment de la validation, envoyé vers le dépôt de conception centralisé dans le Workspace (Versioned Storage), qui est 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 le Workspace. Utilisez le bouton pour ajouter une nouvelle paire Nom/Valeur à la liste, ou le bouton pour supprimer une paire sélectionnée. Les champs Nom et Valeur autorisent un maximum de 255 caractères. Lors de la création d’un projet Workspace, ces paramètres de projet Workspace sont enregistrés dans le Workspace avec le nouveau projet en tant que paramètres de niveau projet côté Workspace.

  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 chargé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 Workspace, un paramètre issu du modèle sélectionné sera enregistré comme paramètre de niveau projet côté conception si le nom du paramètre n’a pas été modifié. Sinon, il sera enregistré comme paramètre de niveau projet côté Workspace.

  Les paramètres de niveau projet côté Workspace peuvent être modifiés dans le Workspace. En revanche, les paramètres côté conception sont enregistrés dans le fichier projet (*.PrjPcb) et peuvent être modifiés dans Altium Designer. Les paramètres de niveau projet des deux types peuvent être affichés dans l’onglet Parameters de la boîte de dialogue Project Options (Project » Project Options) et peuvent être utilisés comme Special Strings dans Altium Designer.

Une fois le projet défini comme souhaité, cliquez sur le bouton . La nouvelle structure du projet sera créée dans les dossiers locaux et Workspace spécifiés. Le projet sera ouvert dans le Projects panel, qui reflétera l’état entièrement synchronisé existant entre les fichiers du dépôt de conception distant (dans le Workspace) et le dépôt local (copie de travail), comme l’indiquent les icônes associées. S’il est créé avec l’option Version Control décochée (disponible uniquement dans un Workspace Altium 365), le projet miroir sera affiché dans le panneau Projects avec une icône associée.

Le projet nouvellement créé est validé dans le dépôt de conception Versioned Storage du Workspace.

Sinon, si un modèle a été attribué au nouveau projet avec des documents constitutifs, seuls le fichier projet (*.PrjPcb) et, par conséquent, la structure du projet seront créés. Le projet est ensuite ouvert dans le Projects panel, qui l’affichera comme étant Scheduled for addition, comme l’indique l’icône associée. À ce stade, vous pouvez ajouter des documents au projet ou simplement enregistrer la structure dans le Workspace dans son état de coquille actuel. Pour ce faire, cliquez sur le contrôle Save to Server associé à l’entrée du projet dans le panneau Projects — également disponible depuis le menu contextuel par clic droit et depuis le menu principal File. Dans la boîte de dialogue suivante Save to Server dialog, sélectionnez/désélectionnez les fichiers à inclure, ajoutez un Comment facultatif, puis confirmez le processus d’enregistrement avec le bouton . Une fois le projet ajouté au serveur, le panneau Projects reflétera l’état entièrement synchronisé existant entre les fichiers du dépôt serveur et la copie de travail locale, comme l’indiquent les icônes .

Copie d’un projet

Pour copier un projet Workspace 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’agira du nom du projet d’origine avec le suffixe - Copy), le Description (qui n’est pas prérempli), le chemin Folder (dans le Workspace) et le chemin Local Storage (vers la copie de travail).

Le Folder du Workspace sera, par défaut, le même dossier que celui 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 Explorer) afin de changer de dossier si nécessaire. Le Local Storage sera, par défaut, défini pour utiliser l’emplacement défini sur la page System - Default Locations 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 Workspace depuis Altium Designer.

Ajout et suppression d’un document de conception

Une fois un projet établi, des documents de conception peuvent être ajoutés, modifiés ou supprimés du projet actif. La manière 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 les options du menu contextuel. Vous pouvez également choisir le type de document requis dans le sous-menu Project » Add New to Project des menus principaux pour ajouter un nouveau document au projet actif.

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

D’autres types de documents pertinents pour le projet peuvent également être ajoutés à un projet, 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 dans la boîte de dialogue de navigation Choose Document to Add sur All Files (*.*) afin que tous les types de fichiers soient accessibles.

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. Il vous sera demandé de choisir :

• Delete File– pour supprimer définitivement le fichier du document source lui-même.

• Exclude from Project – pour supprimer le lien du projet vers ce document (sans supprimer le fichier du document source 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 effectivement sa fermeture.

  

Suppression d’un projet

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

Pour les projets Workspace (et les autres contenus Workspace tels que les composants et les données publiées), une fonctionnalité flexible permet la suppression directe depuis Altium Designer, à partir du panneau Explorer panel. Fonctionnant comme une « suppression logicielle », le processus de suppression offre davantage d’options et d’informations au fur et à mesure, y compris des liens pertinents vers les éléments source à des fins de vérification. Dans le Workspace, le contenu supprimé est déplacé vers un emplacement dédié Trash , où il peut être récupéré ou complètement supprimé depuis la page Trash de l’interface navigateur du Workspace.

Pour supprimer de manière logicielle un projet Workspace, accédez au dossier du projet dans le panneau Explorer, cliquez avec le bouton 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 apparaît. Si le projet contient des données publiées, une autre boîte de dialogue de confirmation s’ouvrira pour vous informer que ces données seront également supprimées. Cliquez sur Delete pour continuer.

Suppression logicielle en action. Ici, un projet est en cours de suppression, ainsi que sa publication associée (si des dossiers de fabrication avaient été créés à partir de publications, ils seraient également supprimés).