Configuration pour Teamcenter PLM
En un coup d'œil
- 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.
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.
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%.
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.
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
altiumLibrarycomme illustré ci-dessous :
- Sélectionnez Create.
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.
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.
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.
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.
- Dans BMIDE, ouvrez le dossier Extensions.
- 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.
- Dans la boîte de dialogue EDA Derived Data, saisissez les informations et cliquez sur Next.
- 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\*.*
- 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\*.*
- 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\*.*
- 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.
- 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.
- 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.
- 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.






