Configuration de Teamcenter PLM

Parent page: Intégration PLM

L’intégration PLM Siemens Teamcenter® nécessite une configuration supplémentaire qui n’est pas gérée automatiquement par le programme d’installation de l’instance Enterprise Server. En pratique, deux niveaux de configuration sont nécessaires, selon les fonctionnalités d’intégration requises. Le premier niveau active la synchronisation des pièces et constitue également un prérequis pour le second niveau, qui active les processus PLM de publication/initialisation de projet. Néanmoins, il est recommandé d’effectuer les deux niveaux de configuration.

Synchronisation des pièces avec Teamcenter

Afin d’activer la synchronisation des pièces de bibliothèque, vous devez installer le logiciel Siemens Teamcenter^® EDA (Electronic Design Automation) Gateway sur la machine qui héberge Enterprise Server. Ce document suppose que l’Enterprise Server et le serveur Teamcenter sont déjà installés sur des machines distinctes — nous recommandons cette approche afin d’assurer une séparation entre les deux installations, bien qu’ils puissent être installés sur la même machine.

Installation et configuration de Teamcenter EDA

L’ensemble de la procédure d’installation et de configuration d’EDA Gateway est décrit en détail dans la documentation EDA Integrationspécifique à la version disponible dans le Siemens Support Center. Veuillez suivre attentivement cette documentation. Les instructions ci-dessous ne couvrent que les écarts par rapport à la documentation Siemens, ou précisent des 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 devriez trouver les informations de compatibilité dans les fichiers TcEDA<version>_README.pdfcorrespondantsTcEDA<version>_README.pdf de Gateway disponibles dans le centre de téléchargement. Vous devez ensuite consulter la documentation Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications (le lien d’exemple concerne la version EDA 5.1), à la rubrique Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications for part library management, afin de vous guider dans la configuration :

Dans le cadre de l’installation et de la configuration de l’interface Enterprise Server/Teamcenter, vous devez également installer (et obtenir les licences, etc. si nécessaire) les fonctionnalités Teamcenter suivantes — reportez-vous à Setting up EDA Gateway for ECAD applications :

• Extensions » Mechatronics Process Management » EDA Server Support
• Extensions » Mechatronics Process Management » EMPS-Foundation
• Extensions » Mechatronics Process Management » ECAD Library Management
• Extensions » Mechatronics Process Management » EDA for Business Modeler IDE
• Extensions » Supplier Relationship Management » Vendor Management
• Base Install » Active Workspace » Server Extensions » EDA Server Support for Active Workspace
• Base Install » Active Workspace » Client » Electronic Design Automation for Active Workspace

En outre, effectuez Install and set up Common Integration Services pour prendre en charge la publication de conception.

Ensuite, suivez les étapes et installez EDA Gateway CLIENT sur la machine Enterprise Server. Pour simplifier le processus, nous suggérons d’utiliser le dossier C:\Siemens\TeamcenterEDA2.

Configurer EDA Gateway pour la gestion de la bibliothèque de pièces

Comme ci-dessus, pour cette section vous devez également consulter la documentation Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications (le lien d’exemple concerne la version EDA 5.1), à la rubrique Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications for part library management.

Veuillez revenir à cet ensemble d’instructions lorsque vous atteignez des chapitres spécifiques dans 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'

Au cours de cette étape, il vous sera demandé de préparer un library gateway configuration file — utilisez à la place celui fourni par Altium. Vous pouvez le télécharger avec un package d’exemples de fichiers de configuration depuis l’interface navigateur du Workspace Enterprise Server : ouvrez Admin » PLM Integration, utilisez le bouton Add Instance pour ouvrir la fenêtre Add new instance, sélectionnez l’onglet Configuration puis Download sample configuration.

Dans le fichier ZIP téléchargé, vous trouverez un fichier altiumLibrary_edadef.xml — placez ce fichier dans le répertoire indiqué par la variable d’environnement système : %TCEDAECAD_ROOT%. Ajoutez également le fichier altiumPcb_edadef.xml fourni dans ce répertoire.

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.
► Voir les informations sur le client riche Teamcenter.

Les captures d’écran ci-dessous illustrent les étapes décrites dans Create external applications for your ECAD tool in Teamcenter. Dans notre cas, nous allons ajouter altiumLibrary,15 à la préférence EDALIB_External_Applications :

Cliquez sur la commande pour ajouter la nouvelle valeur, puis sur Save, puis 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 indiqué ci-dessous :

• Sélectionnez Create.

Chapitre : 'Mapping ECAD part attributes to Teamcenter attributes'

À l’aide de l’invite de commande Teamcenter, exécutez l’utilitaire export_attr_mappings pour exporter le mapping vers un fichier, par exemple :

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

Modifiez le fichier mappings.txt selon vos besoins afin de mapper les attributs Teamcenter réels sur les composants. Exemple de mapping 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 mapping terminé, réimportez-le dans Teamcenter :

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

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

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 mapping de classification est une exigence de configuration facultative et peut ne pas être utilisé ou nécessaire pour votre installation PLM Teamcenter. Notez que pour utiliser les attributs de classification, ils doivent être inclus dans la configuration/le fichier de mapping d’attributs lors de l’exécution de la section 'Mapping ECAD part attributes to Teamcenter attributes' précédente ci-dessus.

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

Assurez-vous que _eda2tc.csv comporte les colonnes dans l’ordre category,classId et que _tc2eda.csv comporte les colonnes dans l’ordre classId,category. Si nécessaire, échangez les noms de fichiers.

Pour utiliser les attributs de classification, vous devez les inclure dans le mapping d’attributs. Un exemple de mapping d’attribut de classification est :

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

Où le numéro -60262 peut être trouvé avec l’outil Classification Admin dans Teamcenter.

Mapping de classification dans Enterprise Server

Les informations de classification peuvent être envoyées avec un attribut spécial Classification inclus dans votre fichier de configuration XML du PLM (typically dm-config.xml ou similaire). Par exemple :

<common:Attribute>
    <common:Key>Classification</common:Key>
    <common:Value>${parameter.Classification}</common:Value>
</common:Attribute>

La valeur de cet attribut doit être un chemin séparé par des virgules dans l’arborescence de classification, par exemple : « Components,SMT,Capacitor ».

De même, les attributs de classification peuvent être référencés par le nom configuré dans le mapping d’attributs sur le serveur Teamcenter, par exemple :

<common:Attribute>
    <common:Key>SMT attribute</common:Key>
    <common:Value>smt attr value</common:Value>
</common:Attribute>

Définir la bibliothèque sur Enterprise Server

Avant que la synchronisation soit possible avec Enterprise Server, il est nécessaire de créer une bibliothèque avec la commande eda_cli.bat (située dans le répertoire de %TCEDAECAD_ROOT% sur la machine Enterprise Server), et de s’assurer également que les fichiers créés sont accessibles à Enterprise Server :

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

À ce stade, il devrait être possible d’exécuter un processus Enterprise Server Component Sync ainsi qu’un processus Enterprise Server Part Request with PLM Part Create.

Informations supplémentaires sur la synchronisation des pièces de bibliothèque :

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

Le nom de la requête est stocké 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 « TCM Released ».

► Reportez-vous à la documentation Siemens Teamcenter associée pour plus d’informations.

• Multisite synchronization – Il est également possible d’utiliser Teamcenter comme source d’informations sur les composants pour plusieurs sites (dont l’un est Enterprise Server). Notez que cela nécessite une configuration spéciale décrite dans la documentation.
• Destination folder for parts – Le dossier cible des pièces synchronisées d’Altium vers Teamcenter peut être défini par site/utilisateur via la préférence Teamcenter EDALIB_SaveAsFolderDefault.
• Current Part Synchronization limitations:
  • Les numéros de pièce PLM sont générés uniquement du côté Enterprise Server.
  • Le dossier de destination ne peut pas être spécifié pour les composants dans le fichier de configuration : il existe un paramètre global côté Teamcenter. Un paramètre de dossier de destination dans le fichier de configuration PLM XML (dm-config.xml) sera ignoré sans avertissement. Le dossier cible est repris du niveau utilisateur Teamcenter, ou de l’option au niveau du site EDALIB_SaveAsFolderDefault pour tous les types de composants.
  • La sélection de pièces natives (Approved Manufacturer/Vendor List, ou AML/AVL) n’est pas prise en charge. Comme auparavant, seules les sélections de pièces basées sur les paramètres de composant sont prises en charge.

Publication de conception avec Teamcenter EDA

La publication de conception depuis Altium vers Teamcenter n’est possible que via Altium Designer. Pour activer la publication de conception, vous devez installer Teamcenter EDA (Electronic Design Automation) Gateway sur la machine où Altium Designer est installé. Vous aurez également besoin d’un accès à la fois au serveur Enterprise et au serveur Teamcenter.

La procédure d’installation et de configuration d’EDA Gateway est décrite en détail dans la EDA Integrationdocumentation spécifique à la version disponible dans le Siemens Support Center. Veuillez suivre attentivement cette documentation. Les instructions ici ne couvrent que les écarts par rapport à la documentation Siemens, ou précisent des 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 devriez trouver les informations de compatibilité dans les fichiers TcEDA<version>_README.pdf correspondants de Gateway disponibles dans le centre de téléchargement. Vous devez ensuite consulter la documentation Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications (le lien d’exemple concerne la version EDA 5.1), sur le sujet de Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications for design management afin de vous guider dans la configuration :

Si la création de composants lors de la publication du projet doit être prise en charge, une partie de la configuration de la bibliothèque doit alors être effectuée sur le serveur. Cela s’applique à la stratégie de section par défaut <pt:BomStrategy>CreateNewAndLink</pt:BomStrategy> dans le modèle de publication.

Le dossier de destination des conceptions peut être défini par les options site/utilisateur : EDA_SaveAsFolderDefault.

Mappage des attributs de ligne de nomenclature

Les attributs de ligne de nomenclature Reference Designator et Quantity sont gérés automatiquement, mais doivent être inclus dans la section <BOM> du fichier de configuration XML du connecteur PLM :

<BOM>
    <BOMAttributes>
        <!-- "Reference Designator" attribute is mandatory for Teamcenter EDA connector -->
        <common:BOMAttribute>
        <common:Key>Reference Designator</common:Key>
        <common:Value>${parameter.LogicalDesignator}</common:Value>
        </common:BOMAttribute>
        <!-- "Quantity" attribute is mandatory for Teamcenter EDA connector -->
        <common:BOMAttribute>
        <common:Key>Quantity</common:Key>
        <common:Value>${parameter.Quantity}</common:Value>
        </common:BOMAttribute>
    </BOMAttributes>
</BOM>

Pour utiliser d’autres attributs de ligne de nomenclature, il est nécessaire de les inclure dans la section de mappage des attributs de ligne de nomenclature du fichier altiumPcb_edadef.xml. Par exemple, l’entrée ci-dessous ajoute le mappage de l’attribut Altium part_source vers l’attribut de ligne de nomenclature Teamcenter bl_part_source :

<RdnAttrMapDefs>
    <RdnAttrDesign cadAttrName="part_source" tcAttrName="bl_part_source"/>
</RdnAttrMapDefs>

Lorsqu’un tel mappage est ajouté, il est possible de définir sa valeur dans la section <BOMAttributes> du fichier de configuration XML du connecteur PLM :

<!-- You can add any other custom attributes, but these need to be mapped to Teamcenter attribute in altiumPcb_edadef.xml file -->
<common:BOMAttribute>
    <common:Key>part_source</common:Key>
    <common:Value>${parameter.MakeOrBuy}</common:Value>
</common:BOMAttribute>

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 la configuration dans la préférence EDA_DerivedDataConfigDefault.

1. Dans BMIDE, ouvrez le dossier Extensions.
2. Dans le dossier Extensions, cliquez avec le bouton 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 puis cliquez sur Next.
4. Pour le jeu de données PCB dérivé, ajoutez une nouvelle entrée sous « Configure datasets ».

Chemin : $TEMP\Altium\TcEda\Project\pcb\*.*

5. Pour le jeu de données schématique dérivé, ajoutez une nouvelle entrée sous « Configure datasets'.

Chemin : $TEMP\Altium\TcEda\Project\schematic\*.*

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

Chemin : $TEMP\Altium\TcEda\Project\$VARIANT\pcb\*.*

7. Pour enregistrer les modifications dans le modèle de données, choisissez File » Save Data Model, ou cliquez sur le bouton Save Data Model dans la barre d’outils principale.
8. 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.
9. Dans le Rich Client, 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.
10. Choisissez Edit » Options, cliquez sur le lien Search en bas de la boîte de dialogue Options, localisez la préférence EDA_DerivedDataConfigDefault et remplacez sa valeur par la nouvelle configuration.

Informations supplémentaires sur la publication de conception

Current Project Publishing Limitations:

• Le référencement de révisions spécifiques de composants (« Precise BOM ») n’est pas pris en charge par Siemens EDA Gateway.
• ECO n’est actuellement pas pris en charge.