Intégration PLM à l’aide de fichiers XML
En un coup d'œil
- Apprenez à adapter des exemples de fichiers XML ou à générer une configuration de base à partir du modèle de données de votre espace de travail.
- Comprenez comment les modèles de publication contrôlent la création des composants, leur liaison et les fichiers de sortie de version envoyés au système PLM.
- Découvrez comment la validation de la connexion permet de détecter les erreurs et les avertissements de configuration avant d’utiliser votre intégration.
Connexion à votre instance PLM
La connexion à votre instance PLM s’effectue depuis la page Admin – PLM Integration de l’interface Web du Workspace. Cela implique de charger le fichier de configuration XML et le modèle de publication appropriés, puis d’activer et de configurer la synchronisation de vos composants PLM avec ceux du Workspace.
Des exemples de fichiers de configuration et de modèles de publication sont fournis avec l’installation. Développez les sections ci-dessous pour en savoir plus :
Exemples de fichiers de configuration
Des exemples de fichiers de configuration sont disponibles dans la vue Add new instance : sous l’onglet Configuration, cliquez sur le lien Download sample configuration pour obtenir le fichier ZIP ConfigurationSamples.zip. Ce fichier ZIP contient des fichiers de configuration initiaux pour les systèmes PLM Windchill, Arena, Aras et Agile :
- dm-Windchill-config-basic.xml
- dm-Arena-config-basic.xml
- dm-Agile-config-basic.xml
-
dm-Aras-config-basic.xml
Des exemples de fichiers de configuration sont fournis pour être utilisés dans le cadre de l’instance du Workspace.
Les configurations fournies comprennent quelques sections représentatives d’entités de composants (par exemple, Capacitors et Diodes), chacune contenant une sous-section de base de correspondance des attributs/paramètres ToPLM et ToAltium. Complétez et modifiez un fichier d’exemple en fonction de l’instance PLM et des exigences de votre entreprise, créez le vôtre ou utilisez le générateur de configuration pour créer un fichier de configuration de base correspondant au modèle de données de votre Workspace.
Exemples de modèles de publication
Des exemples de modèles de publication sont disponibles dans la vue Add new instance : cliquez sur le bouton
sous l’onglet Publish Template, puis sur le lien Download sample configuration dans la fenêtre Publish Template pour obtenir le fichier ZIP PublishTemplateSamples.zip. Ce fichier ZIP contient les fichiers suivants :
- dm-Windchill-publish-template-basic.xml
- dm-Arena-publish-template-basic.xml
- dm-Agile-publish-template-basic.xml
-
dm-Aras-publish-template-basic.xml
Des exemples de modèles de publication sont fournis pour être utilisés dans le cadre de l’instance du Workspace.
Modifiez-les en fonction de l’instance PLM et des exigences de votre entreprise, ou créez les vôtres.
Notez que les éléments importants suivants sont configurés dans les exemples de fichiers de publication :
-
La gestion de la création et de l’association des composants côté PLM pendant un processus de publication (la « stratégie de nomenclature »). Les options suivantes sont disponibles :
- LinkExistingOnly – associer les composants qui existent déjà dans le PLM, sans créer ceux qui n’existent pas.
- CreateNewAndLink – associer les composants qui existent déjà dans le PLM, et créer et associer ceux qui n’existent pas.
- LinkIfAllExists – ne pas créer les composants qui n’existent pas côté PLM ; effectuer l’association uniquement si tous les composants existent dans le PLM.
-
Des ensembles de règles qui définissent comment et où les fichiers de sortie de la version publiée sont publiés dans le PLM :
- Règles de traitement des données du projet (parent).
- Règles de traitement des données sources.
- Règles de traitement des données d’assemblage.
- Règles de traitement des données de fabrication.
Lors de l’ajout d’une nouvelle entrée PLM à l’aide du bouton
, utilisez le bouton
pour rechercher, puis appliquer une configuration PLM correctement enregistrée ou modifiée.
De même, un modèle de publication compatible s’ajoute à l’aide du bouton
sous l’onglet Publish Template. Dans la boîte de dialogue Publish Template qui s’affiche ensuite, utilisez le bouton
pour rechercher et sélectionner le fichier de modèle approprié.
Flux de travail des ordres de modification (ECO)
Les fichiers de configuration des instances PLM Windchill, Agile et Arena prennent également en charge le flux de travail formalisé Change Order (ECO), qui est activé dans le fichier XML du modèle de publication et défini dans le fichier XML de configuration, sous la section d’entité altiumType="ProjectChangeOrder" – voir l’exemple.
Selon l’instance PLM, les définitions de configuration comprennent un schéma d’identification des ordres de modification (numérotation, emplacement, identifiant, etc.), des attributs spécifiques aux ordres de modification tels que le nom/titre, la description et la complexité de la modification (Windchill uniquement), ainsi que des options telles que la stratégie de création des ordres de modification (aucune création, création d’un nouvel ordre ou réutilisation d’un ordre existant) et le passage au statut Lifecycle (Windchill et Agile uniquement). L’ordre de modification défini est activé pendant la publication par la déclaration de sa référence publishId dans le modèle de publication associé – voir l’exemple.
Une fois définis dans les fichiers XML de configuration et de modèle de publication du serveur, les ordres de modification sont disponibles dans les flux de travail PLM de création de projet et de processus de publication lancés depuis Altium Designer ou via l’interface du Workspace Enterprise. Un formulaire d’ordre de modification associé s’affiche au cours du flux de travail pour permettre de spécifier la configuration et les options de l’ordre de modification.
► Pour plus d’informations sur l’utilisation de la fonctionnalité d’ordres de modification PLM (ECO) pour les instances PLM Windchill, Agile et Arena, consultez les commentaires dans les exemples de fichiers XML de configuration et de fichiers XML de modèles de publication disponibles en téléchargement depuis le Workspace Enterprise.
Plutôt que d’utiliser les fichiers de configuration fournis pour créer une nouvelle instance de système d’entreprise, vous pouvez utiliser le générateur de configuration interne du Workspace pour créer une configuration adaptée dont la structure est dérivée du modèle de données du Workspace. Le générateur demande les informations de connexion (type de PLM et URL), puis interroge les données du Workspace pour identifier les types de composants enregistrés (condensateurs, diodes, etc.) et les modèles de composants correspondants afin de construire un fichier de configuration de base. Cliquez sur la section dépliable suivante pour en savoir plus :
Générateur de configuration
Une fonction de configuration adaptative est accessible depuis le lien Générer la configuration de la page Add new instance, ouverte à l’aide du bouton
dans le Workspace.
Dans la boîte de dialogue Generate Configuration, sélectionnez le type de système d’entreprise auquel vous souhaitez vous connecter — l’un des types de PLM disponibles (Windchill, Arena, etc.) — puis son URL distante. Cliquez sur le bouton
pour créer un nouveau fichier dm-configuration.xml, qui peut ensuite être enregistré puis ajouté à la nouvelle instance PLM à l’aide du bouton
.
Le générateur crée une configuration correspondant au modèle de données de l’instance actuelle du Workspace. Par exemple, les types de composants enregistrés dans le Workspace sont ajoutés en tant que types d’entités dans le fichier de configuration (dm-configuration.xml). Chaque section d’entité comporte des sections ToPlm et ToAltium correspondantes, ainsi que des paramètres mappés issus du modèle de composant correspondant (s’il est disponible). Des sections de publication de projet sont également incluses pour mapper les éléments du package de publication vers le système d’entreprise.
Toutes les sections de la configuration générée comprennent des commentaires TODO qui signalent les éléments à ajouter ou à modifier pour assurer la compatibilité avec votre configuration Workspace/PLM. Pour plus d’informations sur la modification du fichier de configuration afin de l’adapter à votre environnement Workspace/PLM, consultez les commentaires explicatifs inclus dans les exemples de fichiers de configuration fournis.
Prise en charge des PLM tiers
Le Workspace Altium 365 offre une prise en charge supplémentaire des configurations de systèmes PLM « non natifs » développées par des tiers. Cette prise en charge est assurée par le Generic Connector d’Altium, qui nécessite la licence Altium 365 PLM Generic Connector Addon.
Lors de l’ajout d’une instance PLM du Workspace pour un tel système, les fichiers XML préconfigurés fournis par le tiers sont chargés dans la configuration de cette instance PLM, comme décrit ci-dessus.
Validation de la connexion
Le Workspace propose une vérification complète de validation de la connexion à l’instance PLM, accessible à l’aide du bouton
de la page Add/Edit Instance. Cette fonction effectue une série de vérifications de compatibilité de la configuration et affiche immédiatement les résultats.
Lors de l’exécution du rapport de validation de la connexion, le Workspace analyse la configuration actuelle et les paramètres du modèle de publication pour vérifier leur compatibilité avec l’instance du Workspace et les données du système d’entreprise cible. Les problèmes de configuration, tels que les erreurs de chemin, les définitions de types de composants et les paramètres sans correspondance, ou les paramètres de cycle de vie ou de révision non valides, sont détectés et signalés dans la boîte de dialogue Configuration Validation Report qui s’affiche ensuite.
Si des erreurs de configuration sont signalées — entraînant un statut global ERROR (Status) — elles doivent être corrigées avant de pouvoir créer la nouvelle instance. Un statut WARNING, qui indique des problèmes tels que des types de composants du Workspace absents de la configuration ou des attributs spécifiés non disponibles côté système d’entreprise, permet d’enregistrer et d’utiliser l’instance configurée.
Les erreurs et avertissements signalés peuvent ensuite être corrigés dans les fichiers de configuration/publication utilisés et/ou en modifiant les paramètres du Workspace ou du système d’entreprise. Veillez à cliquer sur le bouton
une fois votre instance correctement définie. Cette instance apparaîtra dans la liste actuelle des instances connectées, sur la page principale PLM Integration de l’interface.
Synchronisation des composants
La synchronisation des composants entre le Workspace Altium 365 et l’instance du système d’entreprise connectée — ou, plus précisément, de leurs données paramétriques — repose sur le LibSync workflow de processus. Le processus LibSync est prédéfini dans le Workspace et n’est pas accessible (ni modifiable) depuis la page Admin - Processes. Toutefois, puisqu’il s’agit d’un processus basé sur un workflow, les résultats de son action de synchronisation peuvent être consultés et les éventuelles erreurs traitées.
L’utilisation du processus de synchronisation implique les opérations suivantes :
-
Définir les paramètres de synchronisation pour chaque type de composant, ce qui consiste en pratique à :
- Déterminer le sens de la synchronisation (vers le Workspace ou vers le PLM).
- Déterminer les types de composants concernés et l’emplacement de création des nouveaux composants.
- Configurer le mappage ou les attributs des paramètres.
- Configurer le mappage des données de choix de composants, le cas échéant.
- Effectuer la synchronisation.
Les deux premiers groupes d’opérations ci-dessus sont gérés dans le fichier de configuration utilisé pour l’instance du système d’entreprise connectée (un PLM, par exemple). La synchronisation elle-même peut être effectuée à la demande depuis la page PLM Integration de l’interface du Workspace et/ou être planifiée : une synchronisation automatique à intervalles réguliers, définie lors de la configuration de la connexion à l’instance PLM.
Configuration de la synchronisation
Dans le fichier de configuration, la connexion à l’instance du système d’entreprise est définie entre les balises Instance par un type de pilote et une URL cible. Lorsque le générateur de configuration a été utilisé pour créer le fichier de configuration, les références du pilote et de l’URL incluses sont celles saisies dans la boîte de dialogue Generate Configuration au cours de la génération.
<Instance>
<Driver>[Driver Type]</Driver>
<Url>[PLM API URL]</Url>
</Instance>
Dans la section Schema suivante du fichier de configuration, vous définissez une section de mappage de synchronisation pour chaque type de pièce spécifique. Côté Workspace, il s’agit du composant de type altiumType : sa valeur est l’une des options du paramètre de type visibles sur la page Gestion des données - Types de composants de la boîte de dialogue Preferences dans Altium Designer. Côté PLM, une pièce de type plmType est créée, selon sa valeur dans l’environnement PLM.
La section est déclarée en tant que Entity dans le fichier. Voici un exemple pour les condensateurs :
<Entity altiumType="Capacitor" plmType="Capacitor">
.
.
</Entity>
Au sein de Entity, deux sections permettent de contrôler et de configurer la synchronisation de l'espace de travail vers l'instance PLM, et de l'instance PLM vers l'espace de travail, autorisant ainsi une synchronisation unidirectionnelle ou bidirectionnelle. Pour en savoir plus, consultez les sections suivantes ainsi que les commentaires disponibles dans les exemples de fichiers de configuration. En définitive, le contenu du fichier de configuration varie en fonction de vos besoins spécifiques, mais aussi des attributs (PLM) définis dans l'instance du système d'entreprise connectée.
ToPlm
Cette section permet de contrôler et de configurer la synchronisation de l'espace de travail vers l'instance PLM sous la forme suivante :
<ToPlm sync="true">
.
.
</ToPlm>
La section ToPlm comprend les sections suivantes :
- La manière dont les nouveaux composants sont créés dans l'instance PLM, entre les balises <CreateInfo> et </CreateInfo>. Par exemple, vous pouvez choisir un schéma de nommage des éléments défini dans le système d'entreprise cible et spécifier un préfixe de numérotation des éléments :
<CreateInfo>
<Numbering name="Electrical">
<Fields>
<Field name="Code" value="120"/>
</Fields>
</Numbering>
</CreateInfo>
-
Le filtrage permettant de limiter les composants de l'espace de travail synchronisés avec le PLM, entre les balises <SourceCriteria> et </SourceCriteria>. La propagation des données sources peut être restreinte à l'aide de combinaisons logiques booléennes d'attributs de paramètres. Plusieurs ensembles d'attributs peuvent ainsi produire un résultat de filtrage spécifique par simple application de clauses logiques AND, OR et NOT. Pour en savoir plus, consultez les notes relatives à
SourceCriteriadans les exemples de fichiers XML de configuration.
Cette fonctionnalité est extrêmement utile si vous disposez, par exemple, de 6 000 condensateurs dans votre espace de travail, mais que vous souhaitez synchroniser uniquement un dossier précis contenant 85 condensateurs céramiques. Dans ce cas, il suffit de spécifier le chemin de ce dossier entre les balises SourceCriteria (<Folder>Components/Capacitors/Ceramic</Folder>) et, éventuellement, tout autre attribut de paramètre nécessaire pour affiner davantage les restrictions appliquées aux données sources, par exemple le type de boîtier 0603. La relation entre les critères regroupés correspond à un opérateur logique AND implicite. Ainsi, l'exemple ci-dessous synchronisera les condensateurs céramiques en boîtier 0603 de l'espace de travail vers le PLM.
<SourceCriteria>
<Folder>Components/Capacitors/Ceramic</Folder>
<common:Attribute>
<common:Key>Case/Package</common:Key>
<common:Value>0603</common:Value>
</common:Attribute>
</SourceCriteria>
Des ensembles de balises dédiés à la logique OR (<Or>…</Or>) et à l'exclusion logique NOT (<Not>…</Not>) sont également disponibles et peuvent être ajoutés dans la section du nœud SourceCriteria. Avec ces options, la logique OR s'applique aux ensembles d'attributs de paramètres ajoutés entre les balises <Or></Or>, et la logique NOT à l'ensemble d'attributs de paramètres situé entre les balises <Not>…</Not>. Par exemple, une exigence supplémentaire pourrait imposer un état du cycle de vie Approved ou Released, tout en excluant (NOT) les éléments dont le paramètre Classification a pour valeur SpecialOrder. Le filtrage logique complet serait alors le suivant :
<SourceCriteria>
<Folder>Components/Capacitors/Ceramic</Folder>
<common:Attribute>
<common:Key>Case/Package</common:Key>
<common:Value>0603</common:Value>
</common:Attribute>
<Or>
<common:Attribute>
<common:Key>Lifecycle</common:Key>
<common:Value>Released</common:Value>
</common:Attribute>
<common:Attribute>
<common:Key>Lifecycle</common:Key>
<common:Value>Approved</common:Value>
</common:Attribute>
</Or>
<Not>
<common:Attribute>
<common:Key>Classification</common:Key>
<common:Value>SpecialOrder</common:Value>
</common:Attribute>
</Not>
</SourceCriteria>
- La liste des attributs (paramètres) à transmettre pour les composants de l'espace de travail vers le PLM, entre les balises <Attributes> et </Attributes>. En voici un exemple :
<Attributes>
<!-- Name/Comment from Workspace will be passed to PLM field Name 'as is' -->
<common:Attribute>
<common:Key>name</common:Key>
<common:Value>${parameter.Name}</common:Value>
</common:Attribute>
<!-- Number generated on PLM side will be propagated to workspace -->
<!-- as PlmPartNumber parameter (note: any parameter name can be used)-->
<common:Attribute attributeType="item" primaryKeyOrdinal="1">
<common:Key>number</common:Key>
<common:Value>${parameter.PlmPartNumber}</common:Value>
</common:Attribute>
<!-- Workspace component description will go to PLM field Description. Value will be prefixed with 'Extended' -->
<!-- Description on Workspace side is a revision level parameter -->
<common:Attribute attributeType="revision">
<common:Key>description</common:Key>
<common:Value>Extended ${parameter.Description}</common:Value>
</common:Attribute>
<!-- This attribute will not be pushed to PLM component as part of library synchronization -->
<!-- It is being used to pass values during project publish with BOM -->
<common:Attribute>
<common:Key>refDes</common:Key>
<common:Value>${parameter.LogicalDesignator}</common:Value>
</common:Attribute>
<!-- RoHS field in PLM will be set to 'YES' -->
<common:Attribute>
<common:Key>RoHS</common:Key>
<common:Value>YES</common:Value>
</common:Attribute>
</Attributes>
ToAltium
Cette section permet de contrôler et de configurer la synchronisation de l'instance PLM vers l'espace de travail sous la forme suivante :
<ToAltium sync="true" mode="createAndUpdate">
.
.
</ToAltium>
L'instruction facultative
mode détermine la manière dont les données des composants sont synchronisées du système d'entreprise vers l'espace de travail. Le mode par défaut (createAndUpdate) permet de créer de nouveaux composants dans l'espace de travail et de mettre à jour les composants existants, tandis que l'autre mode, updateExisting, permet uniquement de mettre à jour les composants existants de l'espace de travail.
La section ToAltium comprend les sections suivantes :
- La manière dont les nouveaux composants sont créés dans l'espace de travail et leur emplacement, entre les balises <CreateInfo> et </CreateInfo>.
<CreateInfo>
<!-- <ComponentTemplate>TODO component template Revision ID</ComponentTemplate> -->
<RevisionNamingScheme>1-Level Revision Scheme</RevisionNamingScheme>
<LifecycleDefinition>Component Lifecycle</LifecycleDefinition>
<Folder>Components/Inbox/Capacitors</Folder>
</CreateInfo>
Lorsqu'une entrée de composant est créée dans l'espace de travail, le modèle de composant associé au dossier cible de l'espace de travail (Components/Inbox/Capacitors dans l'exemple ci-dessus) est utilisé, si un modèle a été spécifié. Celui-ci définit également le schéma de nommage des éléments utilisé pour les composants créés et remplace celui éventuellement spécifié dans le dossier cible de l'espace de travail. À l'inverse, si le dossier ne définit ni modèle ni schéma de nommage, la synchronisation échoue.
Notez également que les exemples de configuration définissent un schéma de nommage des révisions (1-Level Revision Scheme) et une définition du cycle de vie (Component Lifecycle) à utiliser par défaut. Ces paramètres sont remplacés si un modèle de composant est associé au dossier cible de l'espace de travail.
Si une référence à un modèle de composant spécifique est ajoutée à la configuration (par exemple : CMPT-00001), ce modèle est utilisé à la place de celui associé au dossier cible de l'espace de travail. Ses paramètres prévalent sur tous les paramètres du fichier de configuration (tels que la définition du cycle de vie, etc.), à l'exception du dossier cible défini.
<CreateInfo>
<!-- A specified Template overrules other CreateInfo settings, except the target Folder -->
<ComponentTemplate>CMPT-00001</ComponentTemplate>
<RevisionNamingScheme>1-Level Revision Scheme</RevisionNamingScheme>
<LifecycleDefinition>Component Lifecycle</LifecycleDefinition>
<!-- A specified target Folder overrules that defined in an applied Template -->
<Folder>Components/Inbox/Capacitors</Folder>
</CreateInfo>
Notez que le modèle spécifié s'applique uniquement aux composants nouvellement créés dans l'espace de travail. Cette approche est particulièrement utile pour gérer l'importation ou la synchronisation de paramètres de composants propriétaires depuis un système externe vers l'espace de travail. Dans ce cas, un modèle de composant personnalisé peut être appliqué pour interpréter les données des paramètres entrants, définir des valeurs par défaut adaptées, spécifier les types de données des unités, ainsi que la définition du cycle de vie et le schéma de nommage des révisions des composants nouvellement créés dans l'espace de travail.
- Le filtrage des données récupérées depuis l'instance du système d'entreprise (PLM), entre les balises <SourceCriteria> et </SourceCriteria>. Une instruction de filtrage peut limiter les données de composants reçues du PLM aux composants créés par un auteur spécifique (comme illustré dans l'exemple de configuration fourni), ou aux éléments de composants présentant une valeur d'attribut particulière (Business Unit = Engineering_RD), comme indiqué ci-dessous.
<SourceCriteria>
<ns2:Attribute>
<ns2:Key>Business Unit</ns2:Key>
<ns2:Value>Engineering_RD</ns2:Value>
</ns2:Attribute>
</SourceCriteria>
- La liste des attributs (paramètres) à transmettre pour les composants du PLM vers l'espace de travail, entre les balises <Attributes> et </Attributes>. En voici un exemple :
<Attributes>
<!-- Name field from PLM will be passed to name/comment field in Workspace-->
<common:Attribute attributeType="revision">
<common:Key>name</common:Key>
<common:Value>${attribute.name}</common:Value>
</common:Attribute>
<!-- Description field from PLM will be passed to Description field in Workspace on revision level -->
<!-- Revision level attributes will cause new revision to be created in case parameter value is changed -->
<common:Attribute attributeType="revision">
<common:Key>Description</common:Key>
<common:Value>${attribute.description}</common:Value>
</common:Attribute>
<!-- Number field from PLM will be passed to PlmPartNumber field in Workspace on revision level -->
<!-- Note: any attribute name can be used -->
<common:Attribute attributeType="revision" primaryKeyOrdinal="1">
<common:Key>PlmPartNumber</common:Key>
<common:Value>${attribute.Number}</common:Value>
</common:Attribute>
<common:Attribute attributeType="item">
<common:Key>DynamicCONTS</common:Key>
<common:Value>Will not cause revision update if changed ${attribute.LastModified}</common:Value>
</common:Attribute>
</Attributes>
La section permettant de définir le mappage des données de choix de pièces se trouve à la fin du fichier de configuration d’exemple (ou d’un fichier généré).
Choix de pièces
Outre les déclarations d’entités dans le schéma de configuration, une section supplémentaire permet de définir le mappage des données de choix de pièces des composants entre le système d’entreprise (PLM) et le Workspace. Cette section permet de mapper les paramètres d’attributs propres aux choix de pièces pour la plupart des systèmes PLM pris en charge, ainsi que les relations de données de la liste des fabricants approuvés (AML) pour les systèmes PLM Aras, Windchill et Arena. Il s’agit d’une définition bidirectionnelle exclusive — c’est-à-dire utilisable dans l’un ou l’autre sens, mais pas dans les deux simultanément — qui spécifie les attributs de fabricant et de référence des composants utilisés pour la propagation des données de choix de pièces.
Lorsque la synchronisation des choix de pièces est activée dans le fichier de configuration (sync="true"), la valeur des attributs spécifiés est transférée au système cible. Le sens de cette propagation des données est déterminé par l’expression « To » : ToAltium indique que les données paramétriques du composant PLM sont appliquées au composant créé ou mis à jour dans le Workspace, tandis que ToPlm entraîne le transfert des données de choix de pièces associées au composant du Workspace vers le système PLM. La configuration activée s’applique à toutes les entités de composants définies ; les données de choix de pièces sont donc transférées vers la cible spécifiée chaque fois qu’un jeu de données de composant est rencontré.
Voici un exemple d’entrée de mappage des choix de pièces ToAltium dans un fichier de configuration, où les attributs du système PLM sont MFR1 (nom du fabricant) et MPN1 (référence fabricant) :
<PartChoices>
<ToAltium sync="true">
<MfrMappings>
<MfrMapping>
<MfrName>MFR1</MfrName>
<MfrPartNumber>MPN1</MfrPartNumber>
</MfrMapping>
</MfrMappings>
</ToAltium>
</PartChoices>
La synchronisation des données de choix de pièces prend également en charge plusieurs entrées de données de choix de pièces. Ces attributs supplémentaires doivent être spécifiés dans le mappage du fichier de configuration sous la forme d’une autre paire de définitions d’attributs, par exemple : MFR2 et MPN2, comme illustré ci-dessous :
<MfrMappings>
<MfrMapping>
<MfrName>MFR1</MfrName>
<MfrPartNumber>MPN1</MfrPartNumber>
</MfrMapping>
<MfrMapping>
<MfrName>MFR2</MfrName>
<MfrPartNumber>MPN2</MfrPartNumber>
</MfrMapping>
</MfrMappings>
Les systèmes d’entreprise dotés d’une fonctionnalité native ou intégrée de choix de pièces fabricant, telle que Manufacturer Parts dans Windchill et Vendor Parts dans Arena, ne nécessitent pas de paramètres mappés dans le fichier de configuration. Dans ce cas, il suffit d’activer l’acceptation des données de choix de pièces dans la section de configuration correspondante.
<PartChoices>
<ToAltium sync="true"/>
</PartChoices>
Ou, lorsque le transfert de données vers le système d’entreprise est pris en charge :
<PartChoices>
<ToPlm sync="true"/>
</PartChoices>
Prise en charge de PTC Windchill PartsLink
Le système PLM PTC Windchill propose un module PartsLink en option qui permet de classified les pièces par groupes. Les classifications de pièces spécifiées dans Windchill peuvent également inclure des paires attribut/valeur associées afin de préciser leur définition au sein de la classification. Le système PartsLink permet de cibler facilement et rapidement des types de composants spécifiques. Il est pris en charge par l’intégration PLM du Workspace pour la synchronisation bidirectionnelle et l’accès en lecture/écriture.
Dans une instance de configuration du Workspace pour Windchill, une classification PartsLink est créée dans Windchill en spécifiant un attribut de liaison dans la section ToPLM, au format présenté dans l’exemple ci-dessous :
<common:Attribute>
<common:Key>Classification</common:Key>
<common:Value>102-Capacitor</common:Value>
</common:Attribute>
Dans le cas ci-dessus, la paire clé/valeur définit une classification nommée 102-Capacitor. Un attribut de classification associé peut être créé dans Windchill en spécifiant un nom et un paramètre de valeur (ici, Capacitance). Notez que plusieurs attributs peuvent être appliqués à une même classification :
<common:Attribute>
<common:ClassificationName>102-Capacitor</common:ClassificationName>
<common:Key>Capacitance</common:Key>
<common:Value>${parameter.Value}</common:Value>
</common:Attribute>
Dans la section de synchronisation ToAltium de la configuration, les données provenant de Windchill peuvent être filtrées selon la classification de pièces souhaitée au sein du jeu de balises <SourceCritera>, en spécifiant son ClassificationName.
<SourceCriteria>
<ClassificationName>102-Capacitor</ClassificationName>
</SourceCriteria>
Pour récupérer toutes les pièces correspondant à une valeur d’attribut de classification donnée (par exemple, tous les condensateurs de 10 µF), la section <SourceCriteria> doit inclure des paramètres d’attributs de configuration définissant un ClassificationName ainsi que la clé et la valeur de son attribut de classification associé.
<SourceCriteria>
<common:Attribute>
<common:ClassificationName>102-Capacitor</common:ClassificationName>
<common:Key>Capacitance</common:Key>
<common:Value>10uF</common:Value>
</common:Attribute>
</SourceCriteria>
Pour extraire une valeur d’attribut de classification spécifique depuis Windchill, récupérez le paramètre Value à partir du nom d’attribut spécifique associé à un ClassificationName.
<common:Attribute attributeType="revision">
<common:ClassificationName>102-Capacitor</common:ClassificationName>
<common:Key>Value</common:Key>
<common:Value>${attribute.Capacitance}</common:Value>
</common:Attribute>
Dans Windchill même, une classification PartsLink est définie en créant un binding attribute qui peut être appliqué à un type de pièce. Un attribut de classification de pièce est ensuite ajouté à une classe de classification définie.
Les entrées de composants dans Windchill intègrent leur classification définie ainsi que tous les paramètres d’attributs de classification spécifiés, qui sont ensuite disponibles pour le processus de synchronisation des composants PLM du Workspace.
Lorsqu’une entrée de composant est synchronisée de Windchill vers le Workspace et que l’interaction avec PartsLink a été spécifiée dans la configuration PLM du Workspace, les attributs de configuration de cette pièce dans Windchill sont propagés au composant côté Altium.
Exécution de la synchronisation des composants
La synchronisation des composants (de bibliothèque) peut être effectuée manuellement ou de manière planifiée : respectivement, à partir du bouton Sync action d’une entrée d’instance PLM sur la page PLM Integration du Workspace, ou sous la forme d’un cycle automatisé spécifié dans la configuration de l’instance. Cliquez sur le bouton
la commande associée à l’instance PLM que vous souhaitez synchroniser. Le processus de synchronisation suivra le workflow LibSync, conformément aux paramètres définis dans le fichier de configuration associé.
La commande devient
. Pour arrêter le processus de synchronisation, cliquez sur cette commande. Une fenêtre de confirmation s’affiche, dans laquelle vous pouvez cliquer sur
pour annuler la synchronisation. Tous les composants déjà synchronisés le resteront, mais aucune synchronisation supplémentaire ne sera effectuée.
Synchronisation des composants en cours entre le Workspace et l’instance PLM indiquée.
Lors de la synchronisation des composants, le processus LibSync suit son workflow prédéfini jusqu’à son achèvement ou jusqu’à ce qu’une erreur survienne. Actualisez le navigateur (F5) pour afficher l’état actuel du processus de synchronisation. Pour surveiller ou consulter le processus LibSync, sélectionnez l’onglet Synchronization status et choisissez l’option d’affichage Closed. Si un processus est toujours en cours, il apparaît dans la liste Active. Le bouton
, accessible aux administrateurs, permet de télécharger un relevé détaillé de toutes les activités de synchronisation répertoriées au format CSV, avec des valeurs séparées par des virgules (Synchronisation status.csv).
Les sous-onglets de cette vue fournissent les informations suivantes :
-
Diagram – une représentation graphique du workflow du processus, dont l’étape actuelle est mise en évidence (terminé ou état d’erreur/d’échec).
-
Data – un récapitulatif de l’action du processus, indiquant notamment la réussite ou l’échec de ses étapes et comportant un lien vers le rapport du processus consigné dans le journal ; voir ci-dessous.
-
History – un journal horodaté des principaux événements de synchronisation du Workspace, présentés dans l’ordre chronologique.
Les résultats du processus LibSync sont également disponibles sur la page Process Management (Admin » Processes), sous l’onglet Browser.
Les détails de l’événement LibSync sélectionné, affichés sous le sous-onglet Data, comprennent un lien vers le fichier journal système (PLM [date-numéro].log) correspondant à cet événement.
Synchronisation planifiée
Vous pouvez également planifier une synchronisation automatique. Pour ce faire, modifiez l’instance PLM (depuis la page principale PLM Integration, cliquez sur son nom ou sur la commande associée), sélectionnez l’onglet Component Synchronisation et activez l’option Synchronize PLM Components with server on schedule. Utilisez les commandes Synchronize every pour définir la planification de la synchronisation automatique selon vos besoins. Le système est très souple et vous permet de :
- Planifier une synchronisation toutes les 15/30/45/60/75/90 minutes.
- Planifier une synchronisation toutes les x heures.
- Planifier une synchronisation quotidienne à une heure définie.
La planification définie sera indiquée sur la page principale PLM Integration, dans la colonne Sync scheduled.
Configuration d’une planification de synchronisation.
Vous pouvez également lancer le processus de synchronisation à la demande. Cliquez sur le bouton
et choisissez le mode de synchronisation souhaité :
-
Incremental – dans ce mode, only les composants qui ont été modifiés depuis la dernière synchronisation (c’est-à-dire dont l’horodatage est postérieur à la date de la dernière synchronisation) et qui répondent aux critères de synchronisation du fichier de configuration seront inclus dans la synchronisation, et les modifications seront propagées en conséquence. Il s’agit du mode par défaut, qui est également utilisé lorsque vous cliquez sur la commande
d’une instance PLM sur la page principale PLM Integration.
- Full – ce mode force une synchronisation complète. Tous les composants qui répondent aux critères de synchronisation du fichier de configuration seront inclus dans la synchronisation, et les modifications seront propagées en conséquence.
Workflows des processus
Les définitions de processus suivantes (et leurs workflows sous-jacents) sont disponibles dans le Workspace pour prendre en charge l’intégration PLM :
-
Part RequestsThème de processus :
- Part Request with PLM Part Create – permet la création automatique d’un composant dans votre instance PLM, puis la propagation du numéro de pièce généré vers le composant du Workspace. Le diagramme du workflow est présenté ci-dessous.
Point important : lorsque vous modifiez cet exemple de définition pour créer le vôtre, vous devez spécifier l’instance PLM dans laquelle les pièces seront créées. Sélectionnez l’entité Create Part in PLM dans le diagramme du workflow, puis choisissez l’instance PLM dans le menu déroulant associé au champ PLM Instance. Ce menu répertorie toutes les instances PLM actuellement définies (sur la page PLM Integration de l’interface).
► Consultez Création et gestion des processus pour en savoir plus sur l’utilisation des workflows de processus.
- Project ActivitiesThème de processus :
- Publish to PLM (User selects) – publication des données de sortie validées d’un projet géré vers l’instance PLM intégrée, avec la possibilité pour l’utilisateur de sélectionner précisément les données à publier. Le diagramme du workflow est présenté ci-dessous.
- Project Releaser with Publish – publication vers l’instance PLM intégrée en tant qu’étape supplémentaire du Project Releaser. Le diagramme du workflow est présenté ci-dessous.
-
Project CreationsThème de processus :
- Project with initialise in PLM – permet la création automatique de numéros de pièce dans votre instance PLM, puis leur propagation en tant que paramètres du projet de conception du Workspace. Le diagramme du workflow est présenté ci-dessous.
Accès aux processus liés au PLM
Les sections suivantes indiquent où accéder aux processus activés liés au PLM. Les exemples ne pouvant pas être utilisés directement tels qu’ils sont fournis, les processus suivants ont été créés à partir de ces exemples à des fins d’illustration :
- PR with PLM Part Create – créé à partir de l’exemple de définition de processus : Part Request with PLM Part Create.
- Publish to Company PLM – Choose Data – créé à partir de l’exemple de définition de processus : Publish to PLM (User selects).
- Project Releaser with Publish to Company PLM – créé à partir de l’exemple de définition de processus : Project Releaser with Publish.
- Create Project with PLM Initialise – créé à partir de l’exemple de définition de processus : Project with Initialise in PLM.
Demandes de pièces
Accès depuis Altium Designer à partir du panneau Explorer, après avoir effectué une recherche, depuis le volet Details du panneau Manufacturer Part Search, ou à partir du lien situé au bas de la liste des composants dans le panneau Components.
Depuis l’interface de l’espace de travail, la définition de processus activée est accessible depuis la page Part Requests, en cliquant sur le bouton
en haut à droite de la page.
Exemple de demande de composant
L’exemple suivant présente brièvement la création d’un composant dans l’espace de travail, suivie de la création automatique d’un composant correspondant dans l’instance PLM. Le numéro de composant généré est ensuite transmis de l’instance PLM au composant dans l’espace de travail, sous la forme d’un paramètre d’élément. Il n’est donc pas nécessaire de publier une nouvelle révision du composant de l’espace de travail. Dans cet exemple, la définition de processus utilisée est Part Request with PLM Part Create, dérivée de la définition fournie en exemple Part Request with PLM Part Create.
- Lancez le processus de demande de composant, puis remplissez le formulaire qui s’affiche en détaillant la demande initiale selon les besoins. Dans l’image ci-dessous, la demande est soumise depuis la page Part Requests de l’interface de l’espace de travail et porte sur un seul composant.
- La nouvelle demande de composant apparaît comme un processus actif sur la page Part Requests. Son état actuel est indiqué dans l’entrée principale ainsi que dans le diagramme du workflow sous-jacent.
-
Une fois que l’utilisateur concerné a pris en charge la tâche de traitement de la demande, ou que celle-ci lui a été attribuée, il crée les composants demandés. Chaque composant créé et/ou choisi pour répondre à la demande est ajouté au champ Components de la tâche. Les composants ajoutés sont automatiquement créés dans le PLM. Dans l’image ci-dessous, un seul composant, CMP-007-00004, a été créé et ajouté. Assurez-vous que le champ Next step est défini sur Completed, puis cliquez sur le bouton
.
Il peut vous être demandé de fournir vos identifiants de connexion au système PLM spécifié dans le workflow du processus de demande de composant.
- Le workflow du processus se poursuit avec la création du composant spécifié dans l’instance PLM. Une fois le processus terminé, vous pouvez consulter le numéro de composant PLM généré dans l’onglet Data des processus. Veillez à modifier le filtre en haut à gauche pour afficher les processus Closed.
- De retour dans Altium Designer, accédez au composant créé dans le panneau Explorer, puis ouvrez son onglet Preview . Dans la zone des paramètres, remarquez qu’un paramètre supplémentaire, PlmPartNumber, a été ajouté. Sa valeur correspond au numéro du composant créé dans le PLM.
Notez que le paramètre a été ajouté au composant, mais que sa révision reste inchangée : le composant n’a pas été republié. En effet, ce paramètre est défini au niveau de l’élément : il est ajouté à l’élément de composant lui-même et est disponible dans toutes ses révisions.
Activités du projet
Les données de conception du projet publiées depuis Altium Designer dans l’espace de travail peuvent être transférées vers le PLM de manière contrôlée à l’aide des processus de publication vers le PLM de l’espace de travail. Ces processus définissent l’interface et la méthodologie de l’activité de publication, tandis que le modèle de publication XML spécifié définit la manière dont les données des fichiers sont transférées vers le système PLM cible.
Prise en charge des dossiers de publication pour Windchill PLM
Lors de la configuration d’un processus de publication vers le PLM pour Windchill® PLM, vous pouvez également spécifier et créer un dossier Windchill cible pour les documents publiés depuis l’espace de travail.
Les paramètres du dossier Windchill associé sont définis dans le fichier XML du modèle de publication appliqué à votre entrée d’intégration Windchill PLM dans l’espace de travail. Les nœuds de définition de dossier utilisent le format de balise <pt:Folder>xxx</pt:Folder>, où pt est l’espace de noms actuel et xxx le chemin complet du dossier. Ils sont placés en tant que règle de publication dans la section FileDistribution de chaque type de document, par exemple une sortie de fabrication PCB.zip.
Voici un exemple de hiérarchie de la structure XML de publication :
<pt:EntityRule id="FAB">
<pt:FileDistributions>
<pt:FileDistribution archiveName="PCB.zip">
<pt:Folder>PRODUCT/Projects/${project.name}/FAB data</pt:Folder>
La dernière ligne spécifierait ou créerait un dossier cible de publication pour la sortie de fabrication PCB.zip, avec la structure de dossiers Windchill suivante (où le nom du projet est MyProject) :
PRODUCT
Projects
MyProject
FAB data
Notez que le chemin du dossier défini dans le fichier XML de publication est absolu, et non relatif, et qu’il peut inclure d’autres propriétés du projet, telles que son nom (${project.name}) et son numéro d’assemblage (${project.PLM_ASSEMBLY_NUMBER}).
Processus de publication standard
Côté conception, le processus standard de publication vers le PLM est accessible depuis Altium Designer, à partir du sous-menu Project » Project Activities du projet actif.
Depuis l’interface de l’espace de travail, les définitions de processus actives sont accessibles depuis la vue Project Management, en cliquant sur le bouton
.
Publication avec le Project Releaser
Le processus de publication vers une instance PLM dans le cadre du Project Releaser est accessible depuis Altium Designer, à partir du sous-menu Project » Project Releaser du projet actif.
Le Project Releaser s’affiche 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.
Définition du nom de l’étape
Si vous utilisez la définition de processus fournie en exemple, Project Releaser with Publish, pour créer votre propre définition, le nom de l’étape affiché côté client de conception est Publish to PLM par défaut. La commande composée du menu déroulant du bouton Project Releaser
reprend également ce nom : Prepare & Release & Publish to PLM.
Cependant, vous pouvez modifier la manière dont cette information (ainsi que l’info-bulle de description associée à l’étape) est présentée aux utilisateurs. Les champs permettant d’effectuer ces modifications sont disponibles dans le workflow sous-jacent du processus, lorsque l’élément Start (de type Start Release) est sélectionné. Ces champs sont les suivants :
- Action name – le nom de l’action suivant la publication du projet, qui correspond au nom de l’étape présentée comme l’étape 7 dans Project Releaser. Ce champ doit obligatoirement être renseigné si des tâches sont définies dans le workflow du processus. Ce nom sera également utilisé pour la commande de menu, au format Prepare & Release & <Action name>.
- Action description – la description de l’action suivant la publication du projet, présentée à l’utilisateur dans Project Releaser sous forme d’info-bulle pour l’étape 7.
Paramètres par défaut de l’élément Start dans un workflow basé sur l’exemple de définition de processus Project Releaser with Publish, et présentation dans Project Releaser.
L’image suivante montre ces champs modifiés dans le workflow sous-jacent, ainsi que l’incidence de ces modifications sur les entrées dans Project Releaser.
Paramètres modifiés de l’élément Start lorsqu’il est utilisé dans un workflow pour publier vers le PLM via Project Releaser.
Si vous exécutez Project Releaser avec la commande standard Prepare , après avoir vérifié et publié les données, le bouton
s’affiche à l’étape Execution Report. Cliquez dessus pour poursuivre le workflow sous-jacent du processus et publier vers le PLM. La boîte de dialogue Login Credentials s’affiche. Saisissez les informations Username et Password de votre instance PLM, puis sélectionnez le modèle PLM que vous souhaitez utiliser (qui apparaît sous la forme <PLMInstance>:<PublishingTemplate>).
Cliquez sur l’onglet Diagram pour afficher le workflow sous-jacent du processus.
Cliquez sur le bouton
pour poursuivre le processus de publication conformément à ce workflow.
Vérifiez l’état du processus de publication vers le PLM depuis l’interface du Workspace en sélectionnant la vue Activities dans la vue détaillée du projet, après avoir ouvert celui-ci depuis la vue Projects. Sélectionnez l’option d’affichage Opened pour consulter l’état pendant l’exécution du processus, et l’option d’activités Closed pour accéder aux informations d’état une fois le processus terminé.
Création de projets
Côté conception, l’accès s’effectue depuis Altium Designer, via le sous-menu principal File » New » Project in <workspace>.
Depuis l’interface du Workspace, la définition de processus activée est accessible dans la vue Projects en cliquant sur le bouton
.
Elle est également accessible lors du clonage d’un projet, via le bouton de menu
de la vue Projects.
Le workflow du processus se poursuit en affichant une boîte de dialogue permettant de définir le nom, la description et le type du projet, ainsi que tout élément de modèle de projet à utiliser pour sa création. Après avoir cliqué sur Start, la boîte de dialogue Login Credentials s’affiche. Saisissez les informations Username et Password de votre instance PLM, puis sélectionnez le modèle PLM que vous souhaitez utiliser (qui apparaît sous la forme <PLMInstance>:<PublishingTemplate>). Cliquez ensuite sur Submit pour poursuivre le workflow.
Exemple de création de projet
L’exemple suivant présente brièvement la création d’un nouveau projet, avec initialisation dans le PLM. Le processus est lancé depuis Altium Designer à l’aide de la définition Create Project with PLM Initialise, dérivée de l’exemple de définition Project with Initialise in PLM.
- Après le lancement du processus (File » New » Project in <workspace> » Create Project with PLM Initialise), une boîte de dialogue (portant le nom de la définition du processus) s’affiche pour vous permettre de définir le projet. Pour cet exemple, nous allons simplement nommer le projet Example_Project_with_PLM_Init, lui donner une description et laisser tous les autres champs inchangés, y compris ceux de l’onglet Advanced .
-
Une fois le projet défini, cliquez sur le bouton
. La boîte de dialogue Login Credentials s’affiche. Comme il s’agit d’un nouveau projet, vous devez fournir vos identifiants de connexion au PLM et préciser l’instance PLM ainsi que le modèle de publication associé à utiliser. Cet exemple utilise un fichier de configuration et un modèle de publication associé (comme demandé) pour un PLM Arena.
Une fois les identifiants renseignés, l’instance PLM et le modèle de publication choisis, cliquez sur le bouton
.
-
Le processus se poursuit jusqu’à son terme (si aucune erreur ne survient), comme vous pouvez le voir dans le panneau Tasklist, dans la liste des activités clôturées Activities ; cochez l’option Show closed dans le menu du bouton
associé. Sélectionnez l’entrée de l’activité pour obtenir davantage d’informations sur le processus terminé et son jeu de données.
Le processus terminé et les informations associées peuvent également être consultés dans l’interface du Workspace en sélectionnant la vue Activities dans la vue détaillée du projet, après avoir ouvert celui-ci depuis la vue Projects. Sélectionnez l’option d’activités Closed (en haut à droite) pour accéder aux informations d’état du processus terminé.
-
Dans Altium Designer, le nouveau projet apparaît dans le panneau Projects, prêt à être validé dans le dépôt de conception Versioned Storage basé sur Git de l'espace de travail. Pour ce faire, cliquez avec le bouton droit sur l'entrée du projet et utilisez la commande Save to server. Vous pouvez ensuite ajouter des documents sources et commencer la conception. Au moment de la publication, le projet est déjà lié aux articles correspondants dans l'instance PLM.
Depuis l'onglet Server Parameters de la boîte de dialogue Project Options, ou dans la liste des paramètres du projet du panneau Explorer, vous pouvez consulter les références attribuées dans l'instance PLM aux entités correspondantes du projet pouvant être livrées/publiées.
La correspondance entre les noms des paramètres PLM et les packages de livraison du projet est définie dans le fichier de configuration PLM, lui-même déterminé par les attributs de nom et de numérotation requis par le système PLM.
Lorsque vous placez une chaîne de texte sur un schéma, les paramètres PLM associés au projet sont disponibles sous forme de chaînes spéciales :













































