Projets de l’espace de travail

Parent page: Altium On-Prem Enterprise Server

Altium Designer, associé à l’espace de travail Enterprise Server, prend en charge les Workspace Projects. Les projets Workspace ciblent l’étape de développement du cycle de vie du projet, en simplifiant la création et le flux de travail continu des projets sous contrôle de version. Le stockage centralisé sous le contrôle du Workspace permet également à cette fonctionnalité de servir de base à d’autres services collaboratifs.

Voici quelques avantages clés de l’utilisation des projets Workspace :

• Stockage simplifié. Plus besoin de prendre des décisions concernant les emplacements de stockage. Les sauvegardes et autres services de base sont pris en charge.
• Base pour les fonctionnalités collaboratives.
• Contrôle de version appliqué.
• Avantages d’un système de commentaires dédié.
• Notifications et statut. Le statut des documents, y compris les modifications locales, est visible par l’ensemble des équipes de conception.
• La conception PCB simultanée fonctionne sans configuration complexe.
• Possibilité de partager avec d’autres utilisateurs une vue interactive en lecture seule d’un projet, basée sur navigateur, via le Web Viewer.
• Une gamme de fonctionnalités avancées de contrôle de version, comme une vue interactive de l’historique du projet.

Techniquement, un projet Workspace est la combinaison de métadonnées stockées dans l’espace de travail Enterprise Server, avec une intégration étroite au propre service de contrôle de version du Workspace. Le flux de travail type est le suivant :

1. Un utilisateur crée un nouveau projet Workspace via la boîte de dialogue Create Project d’Altium Designer, en convertissant un projet local existant via la boîte de dialogue Make Available On Server, ou depuis l’interface navigateur du Workspace (détaillée ci-dessous). Lors de la création, cet utilisateur définit le nom du projet, sa description et son dépôt de conception.
2. L’accès au projet est défini et géré dans l’interface navigateur du Workspace, ou directement dans Altium Designer.
3. Tous les collaborateurs sélectionnent le projet à ouvrir (soit depuis Altium Designer, soit depuis l’interface navigateur du Workspace), après quoi il est automatiquement extrait sous forme de fichiers de conception.

Ce document examine le travail avec les projets via l’interface navigateur de l’espace de travail Enterprise Server. Pour plus d’informations sur le travail avec les projets dans votre logiciel de conception, consultez Prise en main de l’environnement de conception Altium.

Création d’un nouveau projet Workspace

Il existe plusieurs façons de créer un projet Workspace :

• Création d’un nouveau projet depuis l’interface navigateur du Workspace, ou depuis Altium Designer.
• Mise à disposition d’un projet existant (un projet local, ou un projet local actuellement sous contrôle de version externe) dans le Workspace, depuis Altium Designer – c’est-à-dire conversion d’un projet local en projet Workspace. Consultez la page Rendre un projet existant disponible dans le Workspace pour en savoir plus.
• Clonage d’un projet Workspace existant via l’interface navigateur du Workspace, ou en clonant un projet depuis le panneau Projects d’Altium Designer.
• Téléversement d’un projet local depuis l’interface navigateur du Workspace.

Pour créer un projet Workspace directement via l’interface navigateur du Workspace :

1. Connectez-vous à l’interface et sélectionnez l’option de menu Projects pour accéder à la page Designs . Tous les projets créés précédemment y seront listés.

2. Cliquez sur le bouton en haut de la page, puis sur l’option de menu Create Project pour ouvrir la fenêtre Create Project .

   S’il existe des définitions de processus actives disponibles pour le thème de processus Project Creations – définies dans l’onglet Project Creations de la page Processes de l’interface navigateur du Workspace – alors le menu du bouton proposera ces processus comme options à la place de l’option Create Project. Choisissez l’entrée requise pour lancer le flux de travail de ce processus.

3. La fenêtre s’affichera initialement dans une vue simplifiée. Saisissez le nom souhaité pour le projet, une description (si nécessaire), et choisissez un modèle de projet approprié dans le menu déroulant Templates.

   Le nom du projet doit commencer par, et peut contenir, A-Z, a-z ou 0-9. Les tirets bas, tirets et 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 : \ . / ? % * : | " < >.
4. Pour accéder à davantage de contrôles, cliquez sur le bouton . Les champs suivants s’afficheront :
   1. Parent Folder – utilisez ce champ pour spécifier où le dossier du projet doit être créé dans la structure de dossiers du Workspace. Par défaut, ce sera Projects\<ProjectName>. Le chemin par défaut des nouveaux projets est spécifié sur la page Admin – Settings – Projects de l’interface navigateur du Workspace.

   2. Repository – ce champ listera tous les dépôts de conception gérés via le service local de contrôle de version 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. Par défaut, le dépôt Versioned Storage (basé sur Git) sera sélectionné.

      Si vous avez migré vers Enterprise Server depuis une technologie serveur précédente et conservez la possibilité d’utiliser des dépôts de conception internes (SVN) et/ou externes (SVN/Git), le champ Repository sera affiché. Il liste tous les dépôts de conception gérés via le service local de contrôle de version 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. Si un dépôt basé sur SVN est choisi, le champ Repository Folder sera affiché. Utilisez ce champ pour spécifier le nom du dossier dans le dépôt destiné à accueillir le projet et ses fichiers associés. Par défaut, il reprendra le nom du projet.

Définition d’un nouveau projet Workspace directement via l’interface navigateur du Workspace.

Après avoir défini le nouveau projet selon vos besoins, cliquez sur – le nouveau projet sera créé. Vous reviendrez à la liste récapitulative des projets, où vous verrez désormais une entrée pour le projet nouvellement créé.

Un projet Workspace supplémentaire, créé via l’interface navigateur.

Parcourir les projets Workspace

La liste des projets sur la page Projects de l’interface navigateur du Workspace inclut tous les projets qui vous sont partagés et offre une gamme de contrôles pour accéder aux fonctionnalités de gestion de projet. Utilisez le bouton  pour basculer la page en mode aperçu des projets (vignettes graphiques) et le bouton pour basculer la page en mode liste détaillée.

La page Designs de l’interface navigateur du Workspace – centre de commande pour travailler avec vos projets Workspace. Ici, le mode liste détaillée de la page est affiché. Survolez l’image avec la souris pour voir le mode aperçu des projets.

Les entrées de projet de la vue sont automatiquement triées par date de Last modified, le projet modifié le plus récemment apparaissant en premier dans la liste. Cliquez sur le bouton pour passer à un tri par nom de projet, puis cliquez à nouveau pour basculer entre l’ordre croissant et décroissant.

La vue en mode Liste () peut être triée par Name, Author ou Date, en utilisant l’en-tête de colonne dans chaque cas. Cliquez une fois pour trier par ordre croissant, cliquez à nouveau pour trier par ordre décroissant. Les flèches à droite du nom de colonne indiqueront le sens de tri actuellement actif.

La vue Projects fournit des données Properties et Activities relatives au projet sélectionné, disponibles dans le panneau latéral droit de la vue.

Les informations du panneau latéral comprennent : Propertiesonglet : Project – un résumé de haut niveau de l’état du projet, y compris la vue 3D de la carte (lorsqu’un PCB est disponible pour le projet). Shared With – les utilisateurs et/ou rôles qui ont accès au projet. Survolez une entrée pour voir le nom complet de l’utilisateur/du rôle. Parameters – métadonnées détaillées extraites ou calculées à partir de la conception du projet elle-même. Cliquez sur le contrôle Show More pour développer la liste complète. Where Used – une liste d’autres projets, tels que les projets multi-cartes, qui intègrent le contenu de ce projet. Cliquez sur une entrée pour ouvrir et afficher ce projet dans un nouvel onglet du navigateur. Releases – une liste des versions publiées du projet dans l’ordre chronologique. Cliquez sur une entrée pour ouvrir cette version dans le Manufacturing Portal de l’espace de travail. Activity onglet – une liste chronologique des événements du projet, tels qu’un Commit, une Release ou un workflow de processus terminé associé au projet.

Pour chaque projet, les opérations suivantes sont également proposées par les boutons en haut de la vue (et détaillées dans les sections liées ci-après) :

• Share – contrôles d’accès permettant de configurer les autorisations d’accès au projet.
• Functions – accès par menu aux fonctions du projet. Également disponible depuis le bouton d’un projet sélectionné en mode Preview :
  • Open – ouvre le projet dans sa vue détaillée orientée CAO. Équivalent à un clic (mode Preview) ou à un double-clic (mode List) sur une entrée de nom de projet.
  • Move – déplace le projet vers un autre dossier parent dans la structure de dossiers de l’espace de travail.
  • Edit – modifie le projet en termes de Name, Description et Workspace Parameters.
  • Clone – crée une copie identique du projet avec un nouveau nom.
  • Watch/Unwatch – suivre/ne plus suivre l’activité d’un projet en recevant les notifications associées (mis à jour, publié, etc.) dans l’onglet Activitiy du projet, ainsi que par e-mail si les Email Notifications sont activées.
  • Delete – supprime l’entrée du projet en déplaçant sa structure et ses données vers le Workspace Trash, où elles peuvent être supprimées définitivement de l’espace de travail ou restaurées à leur état précédent.

Une fonction de Search projet est également incluse ; elle permet de filtrer la liste des projets selon un ensemble de propriétés telles que le nom, l’auteur, la description, etc. Saisissez n’importe quelle partie d’une chaîne de recherche dans le champ en haut de l’interface du navigateur. La liste se mettra à jour pour n’inclure que les entrées de projet dont les attributs contiennent la chaîne recherchée.

Pour effacer le filtrage de recherche, cliquez soit sur l’entrée principale de la page Projects dans le volet de navigation de gauche, soit videz le champ de recherche et appuyez sur Enter.

Exemple d’utilisation de la fonction de recherche, ici pour trouver un projet à partir de sa description.

Utilisation des dossiers de l’espace de travail

L’espace de travail permet également de créer et de gérer des dossiers de projet dans sa structure. Les projets peuvent ensuite être créés dans n’importe quel dossier de la hiérarchie obtenue, ou déplacés vers celui-ci.

Pour créer un nouveau dossier sous le dossier racine Project (par défaut), choisissez l’option Create Folder dans le menu du bouton . Dans la fenêtre Create Folder qui suit, indiquez le nom du nouveau dossier, son dossier parent et une description facultative. Un nouveau dossier est toujours créé sous le dossier actuellement sélectionné, qui devient son dossier parent.

Ouvrez un dossier créé en sélectionnant son titre, puis remontez dans la hiérarchie à l’aide du fil d’Ariane situé au-dessus.

Utilisez les options du menu pour modifier les détails d’un dossier (Edit), déplacer le dossier sous un autre dossier parent (Move) ou supprimer le dossier de la structure de dossiers de l’espace de travail (Delete). Lors du déplacement d’un dossier, sélectionnez un nouveau dossier parent dans l’arborescence de la fenêtre Move folder <folder> to.

Télécharger un projet

Dans Altium Designer, la commande Make Available on Server télécharge un projet local vers l’espace de travail, où il devient un projet Workspace sous son contrôle de version. Un processus équivalent peut être effectué dans l’interface navigateur du Workspace à partir de l’option Upload Project disponible dans le menu du bouton . Parcourez jusqu’au dossier hôte d’un projet local et sélectionnez-le pour téléverser ce projet, par défaut, vers le dossier Workspace actuellement sélectionné, ou utilisez l’option Change dans la liste Upload Project des fenêtres Parent Folder pour choisir un autre emplacement dans la hiérarchie des dossiers.

Tous les liens de contrôle de version existants dans le projet local sont ignorés, et le projet téléversé devient un projet Workspace entièrement géré par contrôle de version – le projet source local n’est modifié d’aucune façon.

Déplacer un projet

Pour déplacer un projet vers un autre dossier Workspace, sélectionnez l’option Move dans les options déroulantes du menu , puis choisissez un nouvel emplacement dans la hiérarchie des dossiers de la fenêtre Move project <project> to. Une fois confirmé avec le bouton , le projet sélectionné sera alors hébergé sous le nouveau dossier parent spécifié.

Partager un projet Workspace

Une fois qu’un projet se trouve dans le Workspace, vous devez déterminer quels utilisateurs peuvent réellement y accéder. Cela se fait en partageant le projet, ou plus précisément en configurant ses autorisations d’accès. Par défaut, un projet Workspace est partagé avec les éléments suivants :

• Le propriétaire du projet, qui est généralement le concepteur qui l’a créé (ou l’a rendu disponible dans le Workspace) : autorisations d’accès complètes (lecture/écriture).
• Le groupe de rôles Administrators : autorisations d’accès complètes (lecture/écriture).
• Tous les membres du Workspace : accès en lecture seule.

Les autorisations par défaut pour les nouveaux projets peuvent être définies/modifiées sur la page Admin – Settings – Projects de l’interface navigateur du Workspace. Notez que le propriétaire du projet se voit intrinsèquement attribuer l’autorisation d’y accéder et n’apparaît donc pas dans la liste.

La configuration des autorisations d’accès peut être effectuée via l’interface navigateur du Workspace, ainsi que directement depuis Altium Designer.

Pour configurer l’accès à un projet depuis l’interface navigateur du Workspace, sélectionnez l’entrée du projet sur la page Designs  (Projects dans le menu principal) et cliquez sur le bouton pour accéder à la fenêtre Share:<project> – ou choisissez l’option Share dans le menu associé à une entrée de projet. Cela fournit tous les contrôles nécessaires pour partager le projet avec d’autres utilisateurs ou groupes d’utilisateurs (rôles).

Avec des projets gérés de manière centralisée dans le Workspace, le partage avec d’autres revient simplement à gérer les autorisations de chaque projet.

Dans la fenêtre Share <project> :

• Un utilisateur/rôle dispose d’un accès lecture/écriture lorsque l’option Can Edit est activée. Si cette option est désactivée, il dispose uniquement d’un accès en lecture.
• Un projet peut être partagé avec tous les membres du Workspace avec un accès en lecture seule (Can View) ou en lecture/écriture (Can Edit) à l’aide du menu déroulant de l’entrée Workspace Members dans la zone Shared With.
• Pour retirer à un utilisateur/rôle existant l’accès partagé à un projet, cliquez sur l’option Remove dans le menu déroulant associé.

Points à noter :

• Par défaut, tous les utilisateurs du Workspace pourront voir le projet. Si vous souhaitez restreindre l’accès à un ensemble spécifique d’utilisateurs et/ou de groupes, vous devez d’abord sélectionner No access dans le menu déroulant de l’entrée Workspace Members .
• Le propriétaire d’un projet dispose d’un accès permanent en lecture/écriture.
• Vous pouvez également partager un lien direct vers le projet. Le lien s’obtient en cliquant sur le contrôle Copy Link, en bas de la fenêtre Sharing. Le lien est copié dans le presse-papiers. Lorsqu’il est utilisé, il donne à l’utilisateur concerné – lorsque cela est autorisé – l’accès à la page de gestion détaillée du projet, dont une vue d’ensemble est présentée dans la section suivante.

Activités de projet de l’espace de travail

L’espace de travail offre la capacité unique d’appliquer des Process Workflows configurables aux projets de l’espace de travail afin d’exécuter des tâches adaptées, telles que la réalisation de revues de conception et la création de nouveaux projets. Les processus et leurs workflows sous-jacents sont créés et configurés par un administrateur de l’espace de travail et, lorsqu’ils sont activés, deviennent disponibles pour les utilisateurs d’Altium Designer et de l’interface navigateur de l’espace de travail.

► Voir Creating & Managing Processes pour plus d’informations.
► Voir Performing Design Reviews pour des informations sur ces processus dans Altium Designer.

Du point de vue de l’utilisateur, les Process Workflows et leurs étapes inhérentes sont considérés comme des Activities. Les activités disponibles peuvent être lancées par les utilisateurs, et les étapes de leur workflow peuvent être réalisées par les utilisateurs assignés sous forme d’une séquence de tâches – disponibles via la page Tasks.

Sélectionnez le menu sur la page Designs (Projects) et choisissez parmi les processus disponibles pour lancer une activité pour le projet actuellement sélectionné. Renseignez les champs et options requis dans les fenêtres de formulaire du processus qui suivent, puis démarrez le processus (). Selon le Process Workflow qui a été lancé, une étape suivante peut devoir être soumise () afin de préparer les données pour révision.

Des Workflow Tasks sont ensuite créées pour le ou les utilisateurs assignés à l’activité. Une tâche qui s’applique à un utilisateur connecté apparaîtra dans la page Tasks, où elle pourra être traitée pour faire progresser le workflow vers son étape suivante.

Notez que si une activité a été assignée à un groupe de rôles – Engineers par exemple – une tâche associée devient disponible pour tous les membres de ce groupe, ainsi que pour tous les utilisateurs individuels assignés à l’activité. Dans ce cas, n’importe lequel de ces utilisateurs peut effectuer l’étape de révision et soumettre le résultat ().

Fonctions de projet de l’espace de travail

Les opérations fonctionnelles associées aux projets sont disponibles depuis le menu de la page Designs , et incluent la possibilité d’ouvrir, déplacer, modifier, cloner, suivre et supprimer un projet de l’espace de travail. Le menu est également disponible depuis le bouton d’une entrée de projet sélectionnée :

Ouvrir un projet

Sélectionnez l’option Open dans le menu d’une entrée de projet ou dans le menu supérieur pour ouvrir un projet dans sa vue orientée fabrication et centrée CAO – ou, en mode Preview (), cliquez sur le nom du projet. La vue donne accès à plusieurs sous-vues disponibles depuis le volet de navigation :

• Design – naviguez et interagissez avec les documents de conception du projet, inspectez les propriétés des objets et placez des commentaires de révision. La vue s’applique à la révision actuelle (la plus récente) du projet et utilise l’interface Web Viewer.
• Tasks – affichez et utilisez une interface de type flux qui présente toutes les Tasks (tâches d’activité) applicables au projet actuel.
• Releases – affichez des informations récapitulatives sur toutes les Releases du projet actuel, chacune pouvant être ouverte dans la vue Manufacturing Portal . Celle-ci fournit à son tour des sous-vues pour les fichiers du package de version, les documents de conception et les données d’approvisionnement de la version sélectionnée.
• Activities – affichez les Process workflow Activities actives ou closes applicables au projet actuel.
• History – parcourez une chronologie progressive des événements majeurs liés au projet, notamment sa création, ses commits, ses releases et ses clones. Chaque fois qu’un événement pris en charge se produit en association avec le projet, cet événement est ajouté à la chronologie sous forme de vignette dédiée avec diverses actions prises en charge, le cas échéant (comme des comparaisons de données de conception).

► Voir Management of a Specific Project pour plus d’informations.

Modifier un projet

Pour modifier les propriétés d’un projet existant dans l’espace de travail, sélectionnez son entrée sur la page Designs (Projects), puis l’option Edit dans son menu ou dans le menu supérieur . Dans la fenêtre Project Editing qui suit, vous pouvez modifier le Name du projet, sa Description et gérer les entrées Parameters de l’espace de travail.

Cliquez sur le bouton dans la fenêtre Project Editing pour afficher des données de propriété supplémentaires dérivées du projet et stockées avec celui-ci. Sélectionnez le contrôle Parameters pour accéder aux paires Nom/Valeur de paramètres et les ajouter (), les modifier ou les supprimer (). Celles-ci sont enregistrées dans l’espace de travail avec le projet et peuvent être utilisées comme Special Strings dans Altium Designer – accessibles depuis le panneau Properties lorsqu’un objet texte placé est sélectionné dans l’espace de conception. En revanche, les paramètres de type Project sont enregistrés dans le fichier projet (*.PrjPcb) et peuvent être modifiés dans Altium Designer.

Cloner un projet

Pour cloner (dupliquer) un projet existant de l’espace de travail, sélectionnez son entrée sur la page Designs (Projects), puis l’option Clone dans son menu ou dans le menu supérieur . Utilisez la fenêtre Clone Project pour définir le nom et la description du projet cloné – par défaut, le nom du projet d’origine sera utilisé avec le suffixe - Copy.

Cliquez sur le bouton pour afficher des champs de propriété supplémentaires, notamment le dossier parent cible et les informations de dépôt. Le paramètre du dossier cible correspondra automatiquement au nom du projet, sauf s’il est spécifié manuellement ou affecté à un autre dossier parent existant via l’option Change.

Un projet peut être cloné dans Altium Designer depuis l’option Clone du menu dans le panneau Explorer, ou en cliquant avec le bouton droit sur un nom de projet dans le panneau Projects et en choisissant l’option Clone dans le menu contextuel.

Après avoir défini les champs selon les besoins, cliquez sur le bouton pour confirmer. Le projet d’origine sera cloné (dupliqué) avec ses fichiers et données constitutifs, et sera ajouté comme nouvelle entrée de projet dans la liste de la page Projects.

Suivre un projet

Pour « suivre » un projet dans l’espace de travail – c’est-à-dire recevoir des notifications le concernant –, sélectionnez son entrée sur la page Designs (Projects), puis l’option Watch dans son menu ou dans le menu supérieur .

Lorsque vous suivez (watch) un projet, vous recevez des notifications liées à ce projet (telles que des messages de commit, de publication et de modification de propriété) sous l’onglet Activities dans le volet droit de l’interface. Le créateur du projet est automatiquement configuré pour suivre ce projet. Lorsqu’elle est activée, la commande devient Unwatch ; sélectionnez-la pour cesser de suivre le projet et ne plus recevoir de notifications concernant les événements associés à ce projet.

Supprimer un projet Workspace

Pour supprimer (retirer) un projet Workspace existant, sélectionnez son entrée sur la page Designs (Projects), puis choisissez l’option Delete dans son menu ou dans le menu supérieur . L’action correspond en pratique à une « suppression réversible » : le dépôt du projet est déplacé vers la zone Trash du Workspace. Un projet peut être supprimé dans Altium Designer à l’aide de l’option Delete du menu dans le panneau Explorer.

Depuis cette vue (sélectionnez Trash dans le menu principal), l’entrée du projet peut être supprimée définitivement (Permanently Delete) ou l’action peut être annulée (Restore). Notez que le bouton supprimera toutes les entrées (lorsque cela est possible) stockées dans la corbeille du Workspace.