Configuration pour Teamcenter PLM

En un coup d'œil

La connexion de Siemens Teamcenter PLM à un espace de travail Altium 365 nécessite une configuration supplémentaire d’EDA Gateway et de l’Hybrid Agent d’Altium. Cet article présente les prérequis d’installation et la configuration propre à Altium nécessaires à la synchronisation des composants, notamment les fichiers de définition du client, les paramètres utilisateur, le mappage des attributs et les tests de connexion. Poursuivez votre lecture pour préparer votre intégration et passer à l’étape suivante vers la synchronisation de vos composants.

- Découvrez les licences requises, la version compatible d’EDA Gateway et les fonctionnalités Teamcenter nécessaires.
- Apprenez à configurer le client EDA, les paramètres de la bibliothèque Teamcenter et le mappage des attributs des composants, ainsi que le mappage facultatif des classifications.
- Découvrez les étapes à suivre pour préparer et démarrer l’Hybrid Agent, tester la connexion à l’espace de travail et effectuer un essai de synchronisation des composants.
Approfondissez avec l'IA :
 

En tant que solution PLM sur site basée sur un serveur, Siemens Teamcenter® PLM doit être intégré à un espace de travail Altium 365 via le Hybrid Agent d'Altium. Le service Hybrid Agent est installé sur le même réseau que le serveur Teamcenter (par exemple, le réseau local de votre entreprise) et sert de relais de données sécurisé entre Teamcenter et votre espace de travail Altium 365. Configurez l'intégration Hybrid Agent après avoir terminé la configuration de Teamcenter EDA Gateway, comme décrit ci-dessous.

► Consultez Intégration PLM avec Hybrid Agent pour plus d'informations.

Outre l'installation de Hybrid Agent, l'intégration de Siemens Teamcenter® PLM nécessite au préalable une configuration supplémentaire qui n'est pas gérée automatiquement par une instance de configuration Teamcenter de l'espace de travail. Deux niveaux de configuration sont essentiellement nécessaires, selon les fonctionnalités d'intégration requises. Le premier niveau permet la synchronisation des composants et constitue également un prérequis pour le second niveau, qui active les processus PLM de publication et d'initialisation des projets. Il est néanmoins recommandé d'effectuer les deux niveaux de configuration.

  • Une licence spéciale pour l'espace de travail Altium est requise pour utiliser l'intégration hybride.

  • Une licence spéciale pour l'espace de travail Altium est requise pour l'intégration de la connectivité Teamcenter.

Synchronisation des composants avec Teamcenter

Pour activer la synchronisation des composants de bibliothèque, vous devez installer le logiciel Siemens Teamcenter® EDA (Electronic Design Automation) Gateway sur la machine qui héberge le logiciel Hybrid Agent — par commodité, cette machine est appelée Agent/EDA dans ce document. Ce guide suppose également que le logiciel Hybrid Agent et le serveur Teamcenter sont installés sur des machines distinctes. Nous recommandons cette approche afin de séparer les deux installations, même si elles peuvent être effectuées sur la même machine.

Installation et configuration de Teamcenter EDA

La procédure complète d'installation et de configuration d'EDA Gateway est décrite en détail dans la documentation EDA Integration propre à chaque version, disponible dans le centre d'assistance Siemens. Veuillez suivre scrupuleusement cette documentation. Les instructions présentées ici couvrent uniquement les différences par rapport à la documentation Siemens ou précisent les détails côté Altium mentionnés comme exigences dans la documentation Siemens.

Choisissez une version d'EDA Gateway compatible avec la version de votre serveur Teamcenter. Vous trouverez les informations de compatibilité dans les fichiers TcEDA<version>_README.pdf correspondants d'EDA Gateway, disponibles dans le centre de téléchargement, ou en téléchargeant le fichier de données EDA Integration Compatibility depuis le centre d'assistance Siemens (exemple d'emplacement). Consultez ensuite la documentation Installation et configuration d'EDA Gateway pour les applications ECAD (autres que Mentor) (le lien fourni à titre d'exemple concerne la version 5.1 d'EDA), à la rubrique Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications for part library management, pour vous guider dans la configuration :

Dans le cadre de l'installation et de la configuration de l'interface entre l'espace de travail et Teamcenter, vous devez également installer les fonctionnalités Teamcenter suivantes (et activer les licences, etc., si nécessaire) — consultez Configuration d'EDA Gateway pour les applications ECAD :

  • Extensions » Gestion des processus mécatroniques » Prise en charge du serveur EDA
  • Extensions » Gestion des processus mécatroniques » EMPS-Foundation
  • Extensions » Gestion des processus mécatroniques » Gestion des bibliothèques ECAD
  • Extensions » Gestion des processus mécatroniques » EDA pour Business Modeler IDE
  • Extensions » Gestion des relations fournisseurs » Gestion des fournisseurs
  • Installation de base » Active Workspace » Extensions serveur » Prise en charge du serveur EDA pour Active Workspace
  • Installation de base » Active Workspace » Client » Automatisation de la conception électronique pour Active Workspace

Effectuez également la procédure Installation et configuration de Common Integration Services pour prendre en charge la publication des conceptions.

Suivez ensuite les étapes et installez EDA Gateway sur la machine Agent/EDA.

Configuration d'EDA Gateway pour la gestion des bibliothèques de composants

Comme précédemment, pour cette section, consultez également la documentation Installation et configuration d'EDA Gateway pour les applications ECAD (autres que Mentor) (le lien fourni à titre d'exemple concerne la version 5.1 d'EDA), à la rubrique Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications for part library management.

Reportez-vous à ces instructions lorsque vous atteignez les chapitres correspondants de la documentation Teamcenter. Les sections ci-dessous font référence à ces chapitres par leur nom.

Chapitre : 'Configure the EDA client for part library management

Lors de cette étape, il vous sera demandé de préparer un library gateway configuration file — utilisez plutôt celui fourni par Altium. Vous pouvez le télécharger avec un ensemble de fichiers de configuration depuis l'interface de navigateur de l'espace de travail Altium 365 : ouvrez Admin » PLM Integration, utilisez le bouton Add Configuration pour ouvrir la vue Add New Instance, choisissez Teamcenter EDA dans le menu déroulant Driver, puis sélectionnez le lien Download Teamcenter EDA client definition files associé au champ URL — voir l'exemple.

Le fichier ZIP téléchargé contient deux fichiers XML : altiumLibrary_edadef.xml et altiumPcb_edadef.xml.  Copiez ou déplacez ces fichiers dans le répertoire désigné par la variable d'environnement système : %TCEDAECAD_ROOT%.

  • Notez que l'archive ZIP contient également un fichier CustomEDACallbacks.jar . Son ajout dans le même répertoire permet à Teamcenter de transmettre au côté Altium les références d'identification (ID) qu'il a créées.  ► Plus d'informations.
  • Si vous utilisez l'ancienne interface d'intégration PLM (sans interface graphique), ces fichiers sont disponibles dans le téléchargement Sample configuration files — voir l'exemple d'emplacement.

Setting the User name – Vous devez définir le nom d'utilisateur du client EDA sur celui qui sera utilisé pour exécuter les programmes Hybrid Agent et Teamcenter EDA. Pour ce faire, définissez la propriété User= du fichier %USERPROFILE%\Teamcenter\EDA\TCEDAClient.properties sur le nom d'utilisateur Teamcenter qui sera utilisé pour la synchronisation des composants. Si ce nom n'est pas spécifié, un dépassement du délai d'attente et une erreur d'identifiant/mot de passe se produiront lors de l'utilisation de Hybrid Agent. Notez que le nom d'utilisateur fourni dans l'interface de l'espace de travail sera ignoré au profit de celui du fichier de propriétés. Redémarrez le système après cette modification.

Running the Hybrid Agent as a Windows service - Si vous prévoyez de démarrer Hybrid Agent de cette manière (c'est-à-dire sans passer par le terminal), l'utilisateur Windows concerné sera probablement l'utilisateur System , sauf configuration contraire, et son fichier TCEDAClient.properties se trouve dans %SystemRoot%\System32\config\systemprofile\Teamcenter\EDA\TCEDAClient.properties. Consultez Hybrid Agent en tant que service Windows.

Vérifiez le fichier journal TC EDA au niveau INFO pour confirmer que les modifications ci-dessus ont pris effet (voir l'exemple), lorsque vous exécuterez ultérieurement la commande Tester la connexion de la configuration PLM.

Les journaux Teamcenter EDA sont disponibles dans %TMP%\eda et peuvent être configurés à l'aide du fichier %TCEDAECAD_ROOT%\log4j2.properties . Définissez la propriété rootLogger.level sur DEBUG pour obtenir le maximum d'informations. Redémarrez le système si vous modifiez cette configuration.

Chapitre : 'Setting up Teamcenter server for part library management'

Ouvrez Teamcenter Rich Client en tant qu'utilisateur infodba ou en tant qu'autre utilisateur disposant de privilèges d'administration.
► Consultez les informations sur le client riche Teamcenter.

Les captures d'écran ci-dessous illustrent les étapes décrites dans Création d'applications externes pour votre outil ECAD dans Teamcenter. Dans notre cas, nous ajouterons altiumLibrary,15 à la préférence EDALIB_External_Applications :

Cliquez sur la commande pour ajouter la nouvelle valeur, puis sur Save, et fermez la préférence. Déconnectez-vous, puis reconnectez-vous à Teamcenter Rich client.

  • Ouvrez l'application Organization.
  • Accédez à la section External Applications et ajoutez une application altiumLibrary comme illustré ci-dessous :

  • Sélectionnez Create.

NOTE: Le nom de l’application ne doit pas contenir de caractère de soulignement (_)

NOTE: L’option Allow deletion of replicated master objects to this site doit être cochée.

Chapitre : 'Mapping ECAD part attributes to Teamcenter attributes'

Depuis l’invite de commandes Teamcenter, exécutez l’utilitaire export_attr_mappings pour exporter le mappage dans un fichier, par exemple :

export_attr_mappings.exe -file=mappings.txt -u=infodba -p=infodba

Modifiez le fichier mappings.txt selon vos besoins pour mapper les attributs Teamcenter réels aux composants. Exemple de mappage fonctionnel, ajouté au contenu du fichier mappings.txt exporté :

{ Item type="EDAComPart"
    Cost : Item.GRM(IMAN_master_form).object_desc /description="Cost"
    Tolerance : ItemRevision.GRM(IMAN_master_form).object_desc /description="Tolerance"}

Une fois le mappage terminé, réimportez-le dans Teamcenter :

import_attr_mappings.exe -file=mappings.txt -u=infodba -p=infodba

Pour résoudre les problèmes de mappage des attributs, vous pouvez activer les journaux détaillés en ajoutant la ligne rootLogger.level= DEBUG in the C:\Program Files\Siemens\TeamcenterEDA2\eda\log4j2.properties file.

Les journaux d’exécution de Teamcenter EDA se trouvent dans C:\Windows\TEMP\eis_eda_log.log.

Chapitre : 'Creating classification mapping for ECAD parts with Teamcenter classes' (facultatif)

Le mappage des classifications est une étape de configuration facultative qui peut ne pas être utilisée ou nécessaire pour votre installation PLM Teamcenter. Notez que, pour utiliser les attributs de classification, vous devez les inclure dans la configuration ou le fichier de mappage des attributs lors de l’exécution des étapes de la section 'Mapping ECAD part attributes to Teamcenter attributes' précédente.

Avant de commencer cette étape de configuration, assurez-vous que la fonctionnalité de classification est activée. Suivez ensuite les instructions pour configurer le mappage des classifications.

Assurez-vous que _eda2tc.csv présente les colonnes dans l’ordre category,classId and _tc2eda.csv présente les colonnes dans l’ordre classId,category. Si nécessaire, intervertissez les noms des fichiers.

Pour utiliser les attributs de classification, vous devez les inclure dans le mappage des attributs. Voici un exemple de mappage d’attributs de classification :

"SMT attribute" : ItemRevision.ICS(-60262) /description="SMT"

Le numéro -60262 peut être trouvé à l’aide de l’outil Classification Admin dans Teamcenter.

Configurer Hybrid Agent

Avant de pouvoir effectuer une synchronisation avec l’espace de travail Altium 365, vous devez créer une bibliothèque à l’aide de la commande eda_cli.bat (située dans le répertoire de %TCEDAECAD_ROOT% sur la machine Agent/EDA), et vous assurer que les fichiers créés sont accessibles à Hybrid Agent :

edacli.bat -configureLibrary -application altiumLibrary -status %userprofile%\status.xml

Définissez également les variables d’environnement JAVA_HOME ou TCEDA_JAVA_HOME sur le chemin du JDK utilisé par Teamcenter EDA (edacli.bat). Consultez la documentation de Teamcenter EDA pour en savoir plus sur la configuration de l’environnement Java pour Teamcenter EDA.

À ce stade, vous pouvez installer Hybrid Agent sur la machine Agent/EDA, comme indiqué sur la page Intégration PLM avec Hybrid Agent. Pour démarrer Hybrid Agent, utilisez le fichier agent-tceda.bat au lieu de agent.bat.

Une fois qu’Hybrid Agent est correctement connecté à votre espace de travail, configurez une connexion à Teamcenter dans l’espace de travail (Admin - PLM Integration - Add Configuration), activez l’option Hybrid Agent, puis testez et établissez la connexion ().

Vous devriez alors pouvoir effectuer un essai de synchronisation des composants et exécuter un processus de demande de composant avec création d’article PLM dans l’espace de travail Altium 365.

Informations complémentaires sur la synchronisation des composants de bibliothèque :

  • Synchronization of Released/Unreleased Teamcenter parts – Par défaut, seuls les composants marqués avec release_status_list.name = ‘TCM Released’ sont synchronisés de Teamcenter vers Altium. Ce comportement peut être modifié dans le générateur de requêtes Teamcenter en modifiant la requête utilisée par Teamcenter pour sélectionner les composants (voir l’exemple).

Le nom de la requête est enregistré dans la préférence EDALIB_Sync_FindNewParts. La requête par défaut est __EDALIB_find_newparts et est présentée ci-dessous.

La dernière condition peut être supprimée pour synchroniser les composants qui ne sont pas encore marqués « TCM Released ».

► Consultez la documentation Siemens Teamcenter correspondante pour plus d’informations.

  • Multisite synchronization – Teamcenter peut également être utilisé comme source d’informations sur les composants pour plusieurs sites (dont l’espace de travail Altium 365). Notez que cela nécessite une configuration particulière, décrite dans la documentation.
  • Unit-of-measure parameter synchronization – L’intégration Teamcenter de l’espace de travail prend en charge le mappage des paramètres tenant compte des unités grâce aux colonnes de données supplémentaires Data Type et SiPrefix du tableau de mappage des paramètres de composants de l’interface utilisateur. Utilisez les options du menu déroulant d’une entrée pour sélectionner un type de données approprié (voir les options) et un préfixe d’unité (voir les options).

  • Destination folder for parts – Le dossier de destination des articles synchronisés d’Altium vers Teamcenter peut être défini par site ou par utilisateur à l’aide de la préférence Teamcenter EDALIB_SaveAsFolderDefault.

  • Current Part Synchronization limitations:

    • Les numéros d’article PLM sont générés uniquement du côté de l’espace de travail Altium.
    • Le dossier de destination des composants ne peut pas être spécifié dans le fichier de configuration : il existe un paramètre global du côté de Teamcenter. Tout paramètre de dossier de destination dans le fichier de configuration XML PLM (dm-config.xml) sera ignoré sans avertissement. Le dossier de destination est déterminé au niveau utilisateur de Teamcenter, ou par l’option de niveau site EDALIB_SaveAsFolderDefault pour tous les types de composants.
    • Les choix de composants natifs (liste des fabricants/fournisseurs approuvés, ou AML/AVL) ne sont pas pris en charge. Comme auparavant, seuls les choix de composants basés sur les paramètres des composants sont pris en charge.

     

► Consultez le document principal sur l’intégration PLM pour en savoir plus sur les configurations et les méthodes de synchronisation des composants.

Publication de conceptions avec Teamcenter EDA

La publication de conceptions d’Altium vers Teamcenter n’est possible que via Altium Designer. Pour activer la publication de conceptions, vous devez installer Teamcenter EDA (Electronic Design Automation) Gateway sur la machine où Altium Designer est installé. Vous devez également disposer d’un accès permettant de configurer l’espace de travail Altium 365 et le serveur Teamcenter.

La procédure d’installation et de configuration d’EDA Gateway est décrite en détail dans la documentation EDA Integration propre à chaque version, disponible sur le centre d’assistance Siemens. Veuillez suivre scrupuleusement cette documentation. Les instructions présentées ici couvrent uniquement les différences par rapport à la documentation Siemens, ou précisent les détails côté Altium mentionnés comme prérequis dans la documentation Siemens.

Choisissez une version d’EDA Gateway compatible avec la version de votre serveur Teamcenter. Vous trouverez les informations de compatibilité dans les fichiers TcEDA<version>_README.pdf correspondants de Gateway, disponibles dans le centre de téléchargement. Consultez ensuite la documentation Installation et configuration d’EDA Gateway pour les applications ECAD (autres que Mentor) (le lien fourni en exemple concerne la version 5.1 d’EDA), à la rubrique Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications for design management, pour vous guider dans la configuration :

Le dossier de destination des conceptions peut être défini à l’aide des options de site ou d’utilisateur : EDA_SaveAsFolderDefault.

Setting the User name – Vous devrez définir le nom d’utilisateur du client EDA en attribuant à la propriété User= du fichier %USERPROFILE%\Teamcenter\EDA\TCEDAClient.properties le nom de l’utilisateur Altium Designer qui effectuera la publication du projet.

Comme indiqué dans le chapitre Configurer la gestion des bibliothèques ci-dessus, le fichier altiumPCB_edadef.xml (provenant des fichiers de configuration téléchargés) doit être ajouté au répertoire %TCEDAECAD_ROOT% sur la machine Altium Designer , afin que la création et la publication de projets lancées depuis Altium Designer puissent être effectuées.

De plus, grâce à l’ajout du fichier source Java CustomEDACallbacks.jar (disponible dans l’archive ZIP des fichiers de configuration à télécharger), Teamcenter peut être configuré pour transmettre les références d’identification (ID) qu’il crée pour les articles de circuits imprimés nus (PCB/PWB) aux entrées de paramètres de projet côté Altium. Ajoutez ce fichier Java au répertoire %TCEDAECAD_ROOT% , puis redémarrez le PC hébergeant Altium Designer.

En pratique, cela signifie que lorsqu’un projet de PCB Altium Designer a été créé ou mis à jour dans le PLM Teamcenter, les identifiants des pièces associées deviennent automatiquement disponibles sous forme de paramètres PLM Altium associés au projet.

Configuration de Business Modeler IDE (BMIDE) pour les jeux de données dérivés

Après avoir créé une configuration de données dérivées (voir les références dans le fichier altiumPcb_edadef.xml ), vous pouvez spécifier le nom de cette configuration dans la préférence EDA_DerivedDataConfigDefault.

  1. Dans BMIDE, ouvrez le dossier Extensions.
  2. Dans le dossier Extensions, faites un clic droit sur EDA Derived Data et choisissez New EDA Derived Data. L’assistant New EDA Derived Data s’affiche.
  3. Dans la boîte de dialogue EDA Derived Data, saisissez les informations et cliquez sur Next.
  4. Pour le jeu de données PCB dérivé, ajoutez une nouvelle entrée sous « Configure datasets ».

Chemin d’accès : $TEMP\Altium\TcEda\Project\pcb\*.*

  1. Pour le jeu de données de schéma dérivé, ajoutez une nouvelle entrée sous « Configure datasets ».

Chemin d’accès : $TEMP\Altium\TcEda\Project\schematic\*.*

  1. Autre jeu de données dérivé pour les jeux de données de variantes :

Chemin d’accès : $TEMP\Altium\TcEda\Project\$VARIANT\pcb\*.*

  1. Pour enregistrer les modifications apportées au modèle de données, choisissez File » Save Data Model ou cliquez sur le bouton Save Data Model dans la barre d’outils principale.
  2. Déployez vos modifications sur le serveur de test. Choisissez Deploy Template dans la barre de menus, ou sélectionnez le projet, puis cliquez sur le bouton Deploy Template dans la barre d’outils principale.
  3. Dans le client riche, définissez la préférence EDA_DerivedDataConfigDefault pour qu’elle pointe vers la configuration de données dérivées EDA que vous venez de créer.
  4. Choisissez Edit » Options, cliquez sur le lien de recherche en bas de la boîte de dialogue Options, recherchez la préférence EDA_DerivedDataConfigDefault et remplacez sa valeur par la nouvelle configuration.

Informations supplémentaires sur la publication des conceptions

Current Project Publishing Limitations:

  • Le référencement de révisions spécifiques de composants (« nomenclature précise ») n’est pas pris en charge par Siemens EDA Gateway.
  • Les ECO ne sont pas pris en charge actuellement.
AI-LocalizedLocalisé par IA
Si vous trouvez un problème, sélectionnez le texte/l’image et appuyez surCtrl + Enterpour nous envoyer vos commentaires.
Contents
Disponibilité des fonctionnalités

Les fonctionnalités auxquelles vous avez accès dépendent de la solution Altium dont vous disposez – Altium Develop, Altium Agile Teams, Altium Agile Enterprise, ou Altium Designer (avec un abonnement actif).

Si vous ne voyez pas une fonctionnalité documentée dans votre logiciel actuel, contactez le service commercial d’Altium pour en savoir plus.

Contents