Releasing to a Workspace

Avec la vue Release dans Online Mode, le processus de publication suit un flux par étapes, les entrées situées sur le côté gauche de la vue vous indiquant en un coup d’œil à quelle étape vous vous trouvez actuellement :

  1. Configure Server Release – cette étape du processus de publication est celle où vous spécifiez le ou les types de données que vous souhaitez générer : données source (toujours générées), données de fabrication, données d’assemblage (pour la conception de base et chaque variante détectée).

  2. Validate Project – cette étape suivante du processus de publication s’exécute automatiquement lorsqu’un ou plusieurs rapports de type Validation sont détectés dans le ou les fichiers OutJob assignés. Tous les générateurs de sortie de validation définis dans un fichier Output Job assigné à l’élément de données en cours de publication sont exécutés.

  3. Generate Data – cette étape suivante du processus de publication s’exécute automatiquement. C’est ici que toutes les autres sorties – définies dans le ou les fichiers OutJob assignés aux éléments de données inclus – sont exécutées afin de générer les données à publier dans les éléments cibles correspondants du Workspace.

  4. Review Data – une fois toutes les vérifications de validation réussies et les données de sortie générées, cette étape du processus de publication vous permet de passer en revue les données générées.

    Si vous choisissez d’utiliser les commandes Prepare & Release ou Prepare & Release & Publish to PLM (depuis le menu associé au bouton ), le Project Releaser ne s’arrêtera pas à l’étape Review Data.

  5. Upload Data – après confirmation de la publication à l’étape précédente, cette étape suivante est automatiquement lancée. Elle présente simplement la progression du chargement des données dans les révisions des éléments de données concernés dans le Workspace cible.

  6. Execution Report – il s’agit de l’étape finale du processus, fournissant un résumé de la publication. Des liens de navigation sont fournis pour parcourir rapidement les révisions d’éléments générées dans le panneau Explorer panel. Si vous avez accédé au Project Releaser dans le cadre d’un processus de publication et de diffusion vers un PLM, le bouton sera affiché. Cliquez dessus pour poursuivre le workflow sous-jacent du processus, afin de publier vers le PLM.

    Si vous choisissez d’utiliser la commande Prepare & Release & Publish to PLM (depuis le menu associé au bouton ), le Project Releaser ne s’arrêtera pas à l’étape Execution Report, et aucun bouton ne sera affiché.
  7. Publish to PLM – cette étape n’est présente que lors de l’exécution de la publication dans le cadre du processus activé correspondant (pour publier puis diffuser vers un PLM). Cette étape est lancée automatiquement lorsque le bouton est cliqué à l’étape précédente (ou directement si la commande Prepare & Release & Publish to PLM (depuis le menu associé au bouton ) a été utilisée). La boîte de dialogue Login Credentials apparaît. Saisissez le Username et le Password de votre instance PLM, puis sélectionnez le modèle PLM que vous souhaitez utiliser (qui apparaît sous la forme <PLMInstance>:<PublishingTemplate>).

    Notez que les identifiants de connexion de votre instance PLM ne sont requis que lors de la première publication vers cette instance. Ils seront ensuite stockés avec le Workspace. Après cela, toute publication de ce projet vers cette même instance PLM se fera directement, conformément au workflow défini et au modèle de publication choisi.
    Si vous publiez pour la première fois et que des références article (côté PLM) ne sont pas encore associées au projet du Workspace, ces références seront créées dans le PLM et associées au projet dans le cadre de cette publication initiale. Vous avez également la possibilité de définir des entrées de composants pour les composants du Workspace dans l’instance PLM, dans le cadre de l’opération de publication – afin d’obtenir une nomenclature de composants dans le PLM (facultatif, selon le modèle de publication défini et utilisé lors de la publication du projet vers l’instance PLM).

Étape en ligne 1 – Configurer la publication serveur

Cette étape du processus de publication est celle où vous spécifiez le ou les types de données que vous souhaitez générer. Les éléments de données pouvant être publiés sont :

  • Source Data – un instantané de la conception source.
  • Fabrication Data – les données requises par un fabricant de PCB pour créer la carte nue.
  • Assembly Data for the Base Design (no variations) – les données requises par un sous-traitant d’assemblage pour peupler complètement la carte nue conformément à une nomenclature, et pour la conception de base sans variantes.
  • Assembly Data for Design Variant n – les données requises par un sous-traitant d’assemblage pour peupler la carte nue conformément à une nomenclature, et pour Variant n de la conception de base.

Le nombre de jeux de données d’assemblage correspondra à la conception de base (sans variantes) et à toutes les variantes détectées définies pour cette conception.

En outre, vous pouvez ajouter et configurer des sections Custom Data – vous permettant de créer un ensemble personnalisé de données de publication. Cela concerne davantage la compatibilité descendante ou des flux de données personnalisés. Aucune référence n’est créée, à l’exception des données source. N’importe quel nombre de jeux de données personnalisés peut être ajouté et configuré dans le cadre de la publication (cliquez sur le contrôle Add Section sous la liste des éléments de données actuellement définis).

Étape 1 du processus de publication du projet – configuration de ce qui doit être inclus dans la publication (quelles données générer).
Étape 1 du processus de publication du projet – configuration de ce qui doit être inclus dans la publication (quelles données générer).

L’élément Source Data est toujours inclus dans une publication. Les autres éléments de données peuvent être inclus de manière facultative.

Une fois les éléments de données à créer dans le cadre de la publication configurés comme requis, cliquez sur le bouton en bas à droite de la vue pour continuer.

Le bouton possède deux états. En cliquant dessus, vous lancerez la commande standard Prepare. Celle-ci poursuivra la publication jusqu’à l’étape Review Data, vous permettant ainsi de vérifier une dernière fois que tout est en ordre avant de valider la publication des données. Si vous ne souhaitez pas faire de pause pour cette vérification, utilisez le menu déroulant associé au bouton et choisissez la commande Prepare & Release.

Plusieurs vérifications préalables à la publication sont effectuées dans le cadre de la préparation, notamment :

  • Vérifier que le projet et tous les fichiers ont été enregistrés.
  • Vérifier que le projet et tous les fichiers pertinents sont validés dans le VCS, le cas échéant.
  • Vérifier qu’un nom a été attribué à chaque élément de données activé.
  • S’assurer que l’utilisateur dispose des droits nécessaires pour créer l’élément cible (et la révision).
  • Créer dans le Workspace les éléments cibles requis (et les révisions planifiées), lorsqu’ils n’existent pas encore, et s’assurer que la révision suivante est utilisée pour les éléments qui existent déjà.

Si des problèmes sont détectés, des solutions vous seront proposées pour les résoudre (comme l’enregistrement local des fichiers modifiés et leur validation dans le VCS).

Si des documents externes sont détectés dans le projet en cours de publication (documents associés au projet mais stockés dans un dossier différent du dossier du projet ou d’un sous-dossier du dossier du projet), la boîte de dialogue External files s’ouvrira avec une liste des documents externes (). Pour éviter d’éventuels problèmes, il est recommandé de stocker tous les documents associés au projet dans le dossier du projet ou dans l’un de ses sous-dossiers.

L’élément Source Data est généré à ce moment-là — avec un instantané des fichiers source du projet de conception publié dans la révision cible de l’élément.

Étape en ligne 2 – Valider le projet

Une fois l’étape 1 terminée sans problème, cette étape suivante du processus de publication est exécutée automatiquement lorsqu’un ou plusieurs rapports de type Validation sont détectés dans le(s) fichier(s) OutJob attribué(s). Tous les générateurs de sortie de validation définis dans un fichier Output Job attribué à l’élément de données en cours de publication sont exécutés. Cela inclut l’exécution de l’un des éléments suivants :

  • Differences Report – utilisation du comparateur pour déterminer si les documents source et de conception PCB sont correctement synchronisés.
  • Electrical Rules Check – vérification de la validité électrique/de dessin de la conception source capturée.
  • Design Rules Check – vérification de la validité du document PCB par rapport aux contraintes de conception au niveau carte spécifiées.
  • BOM Checks – vérification d’éventuelles violations associées aux Design Items ou aux Part Choices dans le document BOM source (*.BomDoc), lorsqu’il est disponible.
  • Footprint Comparison Report – comparaison des empreintes sur la carte avec leur bibliothèque source afin de s’assurer qu’elles sont à jour et correspondent.
  • Component State Checking – vérification de la présence de composants dans des états restreints. Dans le cadre de la configuration, vous déterminez l’action à entreprendre pour chaque état actuellement défini, de chaque définition de cycle de vie actuellement définie dans le Workspace cible : aucune action, un avertissement ou la génération d’une erreur. Cette dernière empêchera la publication de la conception. En outre, l’exécution de cette vérification générera un rapport pratique au format HTML, vous permettant de voir en un coup d’œil quels composants de la conception ne sont pas dans des états valides.
  • Environment Configuration Compliance Check – vérification que seuls les éléments de données autorisés par la configuration d’environnement disponible pour votre rôle attribué (le cas échéant) sont utilisés. Cette vérification peut également garantir que tous les éléments de conception proviennent d’un Workspace.

Si la validation réussit, l’icône s’affiche, avec le texte Passed. Sinon, l’icône s’affichera, avec le texte Failed.

La publication échouera si l’une des vérifications de validation n’est pas passée avec succès.
Un clic sur en bas à droite de la vue arrêtera le processus de publication.

Étape en ligne 3 – Générer les données

Une fois l’étape 2 terminée sans problème, cette étape suivante du processus de publication est exécutée automatiquement. C’est ici que toutes les autres sorties — définies dans le(s) fichier(s) OutJob attribué(s) aux éléments de données inclus — sont exécutées afin de générer les données à publier dans les éléments cibles correspondants du Workspace.

Comme pour les autres étapes, mais de manière plus visible à cette étape puisqu’elle prend plus de temps à s’exécuter, des icônes sont utilisées pour présenter la progression de la génération :

– pas encore exécuté/généré.

– en cours d’exécution/de génération.

– généré avec succès.

– échec de la génération.

Un clic sur en bas à droite de la vue arrêtera le processus de publication.

Étape en ligne 4 – Examiner les données

Une fois toutes les vérifications de validation réussies et les données de sortie générées, cette étape du processus de publication vous permet de passer en revue les données générées.

Si vous choisissez d’utiliser la commande Prepare & Release (depuis le menu associé au bouton ), le Project Releaser ne s’arrêtera pas à l’étape Review Data.

Examinez les données générées et vérifiez que tout est conforme avant de valider la publication et de téléverser les données vers le Workspace.
Examinez les données générées et vérifiez que tout est conforme avant de valider la publication et de téléverser les données vers le Workspace.

Par défaut, la page présente une vue simple (compacte) des données générées. Passez à une vue plus détaillée en cliquant sur le contrôle Details associé à une section qui vous intéresse.

Cliquez sur un contrôle Details pour passer de la vue simple à la vue détaillée des données générées pour la section associée. Revenez ensuite en arrière en cliquant sur le contrôle Hide Details.
Cliquez sur un contrôle Details pour passer de la vue simple à la vue détaillée des données générées pour la section associée. Revenez ensuite en arrière en cliquant sur le contrôle Hide Details.

Dans la vue compacte des données générées, cliquez sur un lien View pour ouvrir le fichier de données ou l’ensemble de fichiers associé, soit dans l’éditeur approprié d’Altium Designer (par exemple, l’éditeur CAM pour les fichiers Gerber ou les fichiers ODB++ compressés/non compressés), soit dans l’application externe appropriée (par exemple, Microsoft Excel pour une nomenclature). Dans la vue détaillée, double-cliquez sur une entrée pour afficher uniquement ce fichier.

Un test courant de validation avant publication utilisé par de nombreux concepteurs consiste à comparer les fichiers Gerber générés pour la publication actuelle avec ceux de la publication précédente. Cliquez sur le lien Compare Gerber à côté d’une sortie Gerber et sélectionnez une publication précédente dans le menu déroulant pour comparer les données Gerber préparées avec celles de la publication choisie . Votre navigateur par défaut ouvrira le Workspace de votre entreprise et affichera les résultats.

Accès à la fonctionnalité de comparaison Gerber depuis le Project Releaser, avant de publier les données vers un Workspace.
Accès à la fonctionnalité de comparaison Gerber depuis le Project Releaser, avant de publier les données vers un Workspace.

En savoir plus sur la fonctionnalité Gerber Comparison (Altium 365 Workspace, Enterprise Server Workspace).

Dans la section Source Data, en vue compacte, cliquer sur le lien View ouvrira l’Explorateur de fichiers Windows dans le dossier temporaire où l’instantané des fichiers source du projet a été enregistré. Cette fonctionnalité est également disponible via le lien Explore, à droite de l’en-tête des sections. En fait, chaque section dispose d’un tel contrôle, permettant d’accéder rapidement au sous-dossier correspondant à ces données dans le dossier temporaire.

Dans la vue détaillée, les commandes du menu contextuel accessible par clic droit permettent d’ouvrir un document et d’explorer l’emplacement où il a été généré (dans le dossier temporaire). Vous pouvez également ajouter des colonnes de données pour l’emplacement du dossier et la date de création : cliquez avec le bouton droit dans la zone d’en-tête d’une grille et choisissez la commande Select Columns, ce qui donne accès à une boîte de dialogue permettant d’adapter les données affichées.

Si, après examen des données, vous constatez que des modifications sont nécessaires, cliquez sur le bouton en bas à droite de la vue. Une boîte de dialogue de confirmation apparaîtra pour vous avertir que toutes les données générées seront perdues ; cliquer sur OK annulera la publication et vous ramènera à l’étape 1 du processus.

Le système empêche naturellement toute modification des fichiers de conception entre la préparation de la publication et la publication des données vers le Workspace. Si vous modifiez les fichiers de conception de quelque manière que ce soit, le processus de publication prendra fin et vous reviendrez à l’étape initiale, avant la préparation de la publication.

Si toutes les données générées semblent correctes, poursuivez la publication en cliquant sur le bouton (également en bas à droite de la vue). La boîte de dialogue Confirm Release apparaîtra, résumant les configurations du projet qui seront publiées vers le Workspace. Vous avez également ici la possibilité d’ajouter un Name (par défaut, la valeur saisie ici est [ProjectName]), un Description, ainsi que toute note de publication pertinente.

Confirmation de ce qui sera publié, en termes d’Item-Revisions générées, avec la possibilité de modifier le nom/la description et d’ajouter des notes de publication.
Confirmation de ce qui sera publié, en termes d’Item-Revisions générées, avec la possibilité de modifier le nom/la description et d’ajouter des notes de publication.

Étape en ligne 5 – Téléversement des données

Après avoir confirmé la publication à l’étape précédente, cette étape suivante est automatiquement lancée. Elle affiche simplement la progression du téléversement des données dans les révisions des éléments de données concernés dans le Workspace.

Cette étape reflète simplement la progression du téléversement des données générées vers les Item-Revisions liées dans le Workspace.
Cette étape reflète simplement la progression du téléversement des données générées vers les Item-Revisions liées dans le Workspace.

Étape en ligne 6 – Rapport d’exécution

Il s’agit de l’étape finale du processus, qui fournit un résumé de la publication.

Le rapport final de la publication.
Le rapport final de la publication.

Utilisez les liens de navigation pour accéder rapidement à la révision d’élément associée, contenant les données publiées (données de fabrication, données d’assemblage et tout ensemble de données personnalisé), dans le panneau Explorer panel – votre portail vers votre Workspace.

Affichage des données publiées du projet, directement dans le Workspace, grâce au panneau Explorer.
Affichage des données publiées du projet, directement dans le Workspace, grâce au panneau Explorer.

Les paramètres définis pour les variantes du projet sont inclus dans les révisions correspondantes des ensembles de données d’assemblage. Lors de l’affichage du projet dans le Explorer du panneau Classic View, sélectionnez la révision requise de l’ensemble de données d’assemblage et basculez vers l’onglet de vue d’aspect Parameters pour voir les paramètres de variante.

Un paramètre de variante VariantLabel = A a été ajouté à la variante de projet Default. L’ensemble de données d’assemblage publié inclut ce paramètre, et il se trouve dans l’onglet de vue d’aspect Parameters du panneau Explorer.
Un paramètre de variante VariantLabel = A a été ajouté à la variante de projet Default. L’ensemble de données d’assemblage publié inclut ce paramètre, et il se trouve dans l’onglet de vue d’aspect Parameters du panneau Explorer.

Et voilà : une fois votre projet publié, vous pouvez simplement fermer la vue Release (à l’aide du bouton en bas à droite de la vue). Et lorsque vous devrez republier ce même projet à l’avenir, le Project Releaser vous permettra de le faire rapidement et facilement, tout en incrémentant automatiquement les Item-Revisions cibles.

Chaque fois que vous effectuez une publication du projet, une vignette d’événement Project Released sera ajoutée à la chronologie de la vue History du projet. La personne ayant effectué la publication est indiquée par son nom (et sa photo), ainsi que la date et l’heure. Si une note de publication a été ajoutée au moment de publier les données générées vers le Workspace – via la boîte de dialogue Confirm Release dialog – celle-ci sera également affichée dans la vignette. Chacun des ensembles de données inclus dans la publication sera également répertorié.

Notez que si le dernier commit du projet ne possède pas encore de balise, une balise sera automatiquement attribuée à ce dernier commit. Cette balise sera de la forme RELEASE_<RevisionID>, où <RevisionID> est le numéro de révision des sources du projet publiées (A.1A.2, etc.), par exemple, RELEASE_A.3.

Exemple de vignette d’événement Project Released dans la vue History du projet. Comme le dernier commit du projet n’avait pas de balise, il a été balisé après la publication.
Exemple de vignette d’événement Project Released dans la vue History du projet. Comme le dernier commit du projet n’avait pas de balise, il a été balisé après la publication.

En savoir plus sur Project History.

Publication vers une instance PLM

Related pages: Intégration PLM (Altium 365 Workspace, Enterprise Server Workspace), Publication vers un PLM

Vous avez la possibilité de publier une conception vers une instance PLM dans le cadre de l’exécution du Project Releaser dans Altium Designer. L’opération de publication utilise un modèle de publication – défini dans la configuration d’intégration de cette instance PLM – pour contrôler la manière dont les données doivent être propagées vers le PLM. Cette fonctionnalité est disponible via un processus correctement configuré. Un exemple de définition de processus est fourni dans l’installation – Project Releaser with Publish – dont le workflow sous-jacent permet la publication vers l’instance PLM intégrée comme étape supplémentaire du Project Releaser. Le diagramme du workflow est présenté ci-dessous.

Cette définition de processus ne peut pas être activée ni utilisée telle quelle. Elle s’apparente donc davantage à un « modèle » – modifiez-la selon les exigences de votre entreprise, renommez-la et enregistrez-la comme nouvelle définition de processus, que vous can pourrez ensuite activer et utiliser.

Le diagramme du workflow de la définition de processus d’exemple par défaut Project Releaser with Publish
Le diagramme du workflow de la définition de processus d’exemple par défaut Project Releaser with Publish

Une fois activé, le processus de publication vers une instance PLM dans le cadre du Project Releaser est accessible dans Altium Designer depuis le sous-menu Project » Project Releaser du projet actif ou depuis le sous-menu contextuel Project Releaser, accessible par clic droit sur l’entrée du projet de conception dans le panneau Projects.

Accès au processus de publication vers une instance PLM dans le cadre du Project Releaser
Accès au processus de publication vers une instance PLM dans le cadre du Project Releaser

Le Project Releaser apparaîtra, avec une étape supplémentaire – 7. Publish to PLM. En outre, une commande est disponible dans le menu associé au bouton Prepare & Release & Publish to PLM – si vous souhaitez exécuter le Project Releaser sans vous arrêter pour examiner les données générées et le rapport d’exécution.

Commande supplémentaire pour exécuter le Project Releaser sans s’arrêter pour examiner les données générées et le rapport d’exécution
Commande supplémentaire pour exécuter le Project Releaser sans s’arrêter pour examiner les données générées et le rapport d’exécution

Si vous exécutez le Project Releaser avec la commande standard Prepare, après examen et publication des données, le bouton sera présenté à l’étape Execution Report. Cliquez dessus pour poursuivre le workflow sous-jacent du processus, afin de publier vers le PLM. La boîte de dialogue Login Credentials apparaîtra. Saisissez le Username et le Password de votre instance PLM, puis sélectionnez le modèle PLM que vous souhaitez utiliser (qui apparaît sous la forme <PLMInstance>:<PublishingTemplate>).

Si vous choisissez d’utiliser la commande Prepare & Release & Publish to PLM, la boîte de dialogue Login Credentials vous sera finalement présentée directement. Le Project Releaser ne s’interrompra pas à l’étape Execution Report, et aucun bouton ne sera présenté.
Notez que les identifiants de connexion à votre instance PLM ne sont requis que lors de la première publication vers cette instance. Ils seront ensuite stockés avec le Workspace. Après cela, toute publication de ce projet vers cette même instance PLM se poursuivra directement, conformément au workflow défini et au modèle de publication choisi.

La boîte de dialogue Login Credentials accessible lors de la première publication vers l’instance PLM.
La boîte de dialogue Login Credentials accessible lors de la première publication vers l’instance PLM.

Cliquez sur l’onglet Diagram pour voir le workflow sous-jacent du processus.

L’onglet Diagram de la boîte de dialogue Login Credentials
L’onglet Diagram de la boîte de dialogue Login Credentials

Cliquez sur le bouton pour poursuivre le processus de publication, conformément à ce workflow.

Si vous publiez pour la première fois et que des numéros de pièce (côté PLM) ne sont pas encore associés au projet Workspace, ces numéros de pièce seront créés dans le PLM et associés au projet dans le cadre de cette publication initiale. Vous avez également la possibilité de définir des entrées de composants pour les composants Workspace dans l’instance PLM, dans le cadre de l’opération de publication – afin d’obtenir une nomenclature des composants dans le PLM (facultatif, selon le modèle de publication défini et utilisé lors de la publication du projet vers l’instance PLM).
Vérifiez l’état du processus de publication vers le PLM via l’interface navigateur du Workspace, depuis la vue Activities sur la page de gestion détaillée du projet. La page de gestion détaillée du projet s’ouvre en sélectionnant le projet requis sur la page Projects de l’interface navigateur du Workspace, en cliquant sur le contrôle au-dessus de la liste des projets, puis en choisissant l’entrée Open dans le menu associé. Vous pouvez également double-cliquer directement sur l’entrée du projet souhaité dans la liste. La page s’ouvrira dans un nouvel onglet du navigateur. Vous pourrez toujours voir exactement ce qui a été créé, comme les numéros de pièce dans l’instance PLM, dans l’historique du workflow du processus (onglet History).
AI-LocalizedAI-localized
If you find an issue, select the text/image and pressCtrl + Enterto send us your feedback.
Feature Availability

The features available to you depend on which Altium solution you have – Altium Develop, an edition of Altium Agile (Agile Teams or Agile Enterprise), or Altium Designer (on active term).

If you don’t see a discussed feature in your software, contact Altium Sales to find out more.

Legacy Documentation

Altium Designer documentation is no longer versioned. If you need to access documentation for older versions of Altium Designer, visit the Legacy Documentation section of the Other Installers page.

Contenu