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é. Il n’est pas nécessaire 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 imposé.
• 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 typique 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 le 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 Travailler avec les projets.

Création d’un nouveau projet Workspace

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

• Création d’un nouveau projet depuis l’interface navigateur du Workspace, ou depuis Altium Designer.
• Rendre un projet existant (un projet local, ou un projet local actuellement sous contrôle de version externe) disponible dans le Workspace, depuis Altium Designer – c’est-à-dire convertir 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.

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 précédemment créés 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 se présentera 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 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 : \ . / ? % * : | " < >.
4. Pour accéder à davantage de contrôles, cliquez sur le bouton . Les champs suivants apparaîtront :
   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 effectué une mise à niveau 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 prendra 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 comme requis, 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 comprend 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 – le 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 la colonne indiqueront le sens de tri actuellement actif.

La vue Projects fournit les 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 : Properties onglet : Project – un résumé général 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 – des 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. 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-dessous) :

• Share – contrôles d’accès permettant de configurer les autorisations d’accès au projet.
• Activities – accès par menu aux activités de processus disponibles pour le projet.
• Functions – accès par menu aux fonctions du projet. Également disponible depuis le bouton d’un projet sélectionné en mode Aperçu :
  • Open – ouvre le projet dans sa vue détaillée centrée CAO. Équivalent à cliquer (mode Aperçu) ou double-cliquer (mode Liste) 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 Parameters de l’Espace de travail.
  • 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 Trash de l’Espace de travail, où il peut être supprimé définitivement de l’Espace de travail ou restauré dans son état précédent.

Une fonctionnalité de Search projet est également incluse et 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 de niveau supérieur 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éverser un projet

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

Tout lien de contrôle de version existant dans le projet local est ignoré, et le projet téléversé devient un projet d’Espace de travail entièrement géré par contrôle de version – le projet source local n’est modifié d’aucune manière.

Déplacer un projet

Pour déplacer un projet vers un autre dossier de l’Espace de travail, sélectionnez l’option Move dans les options du menu déroulant et choisissez un nouvel emplacement dans la hiérarchie des dossiers dans 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é.

Partage d’un projet d’Espace de travail

Une fois qu’un projet se trouve dans l’Espace de travail, 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. Un projet d’Espace de travail est partagé, par défaut, 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 l’Espace de travail) : 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 de l’Espace de travail : avec un 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 de l’Espace de travail. 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 de l’Espace de travail, ainsi que directement depuis Altium Designer.

Pour configurer l’accès à un projet depuis l’interface navigateur de l’Espace de travail, 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 l’Espace de travail, le partage avec d’autres consiste 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 de l’Espace de travail 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 à connaître :

• Par défaut, tous les utilisateurs de l’Espace de travail 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é – 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 du Workspace

Le Workspace offre la capacité unique d’appliquer des workflows de processus configurables aux projets du Workspace 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 du Workspace et, lorsqu’ils sont activés, deviennent disponibles pour les utilisateurs d’Altium Designer et de l’interface navigateur du Workspace.

► Voir Création et gestion des processus pour plus d’informations.
► Voir Réalisation de revues de conception pour des informations sur ces processus dans Altium Designer.

Du point de vue de l’utilisateur, les workflows de processus 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 workflow de processus qui a été lancé, une étape suivante peut devoir être soumise () afin de préparer les données pour révision.

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

Notez que lorsqu’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é – ici, l’utilisateur Bruce (membre du rôle Engineers). Dans de tels cas, n’importe lequel de ces utilisateurs peut terminer l’étape de révision et soumettre le résultat ().

Fonctions de projet du Workspace

Les opérations fonctionnelles associées aux projets sont disponibles depuis le menu sur la page Designs , et incluent la possibilité d’ouvrir, déplacer, modifier, cloner, surveiller et supprimer un projet du Workspace. 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 – naviguer et interagir avec les documents de conception du projet, inspecter les propriétés des objets et placer 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.
• Supply – examiner de manière interactive les données de nomenclature BOM en cours de développement (WIP) extraites des documents de conception, y compris les entrées pour les données de pièces fabricant et fournisseur dérivées d’un document ActiveBOM renseigné du projet.
• Releases – afficher 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 release, les documents de conception et les données d’approvisionnement de cette release sélectionnée.
• Activities – afficher les activités de workflow de processus actives ou closes qui s’appliquent au projet actuel.
• History – parcourir une chronologie progressive des événements majeurs liés au projet, y compris 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.

► Voir Gestion d’un projet spécifique pour plus d’informations.

Modifier un projet

Pour modifier les propriétés d’un projet existant dans le Workspace, 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 du Workspace.

Cliquez sur le bouton dans la fenêtre Project Editing pour afficher des données de propriétés 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 (), modifier ou supprimer (). Celles-ci sont enregistrées dans le Workspace 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 du Workspace, 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és supplémentaires, qui incluent le dossier parent cible et les informations de référentiel. Le paramètre du dossier cible correspondra automatiquement au nom du projet sauf s’il est spécifié manuellement, ou assigné à 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.

Surveiller un projet

Pour « surveiller » – recevoir des notifications concernant – un projet dans le Workspace, 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 recevrez des notifications liées au projet (telles que des messages de commit, de publication et de modification de propriété) sous l’onglet Activities dans le panneau de droite de l’interface. Le créateur du projet sera 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 lié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 . Cette action correspond en pratique à une « suppression douce », où 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.