Configuration de Teamcenter PLM

Parent page: Intégration PLM

L’intégration PLM de 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 l’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 Integration spécifique à la version, disponible dans le Siemens Support Center. Veuillez suivre attentivement cette documentation. Les instructions ci-dessous couvrent uniquement 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), à 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 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 afin de 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 de fichiers de configuration depuis l’interface navigateur du Workspace Enterprise Server : 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.

Dans le fichier PLMClientConfigurationFiles.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'

Depuis l’invite de commande Teamcenter, exécutez l’utilitaire export_attr_mappings pour exporter le mappage 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 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 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 mappage de classification est une exigence de configuration facultative et peut ne pas être utilisé ni 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 mappage d’attributs lors de l’exécution de la section précédente 'Mapping ECAD part attributes to Teamcenter attributes' 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 mappage 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 mappage d’attributs. Un exemple de mappage d’attribut d classification est :

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

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

Mappage de classification dans l’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 mappage 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 l’Enterprise Server

Avant que la synchronisation avec l’Enterprise Server soit possible, 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 à l’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 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 XML PLM (dm-config.xml) sera ignoré sans avertissement. Le dossier cible est récupéré à partir de l’option de niveau utilisateur Teamcenter, ou de l’option de niveau 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 des composants sont prises en charge.

Publication de conception avec Teamcenter EDA

La publication de conception d’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 à l’Enterprise Server et au serveur Teamcenter.

La procédure d’installation et de configuration d’EDA Gateway est décrite en détail dans la documentation spécifique à la version EDA Integration, 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 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 ê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 pour la publication des pièces alternatives de nomenclature

L’ActiveBOM d’Altium Designer prend en charge l’ajout de pièces alternatives aux éléments de nomenclature (en savoir plus). Pour prendre en charge ces pièces alternatives lors de la publication d’une conception vers Teamcenter PLM, une configuration supplémentaire de Teamcenter EDA doit être effectuée comme décrit ci-dessous (dans la terminologie Teamcenter, ces composants alternatifs dans le périmètre d’une nomenclature spécifique sont appelés composants de substitution). Cela activera les callbacks Altium avec une logique de transfert des substitutions.

1. Localisez le fichier soa_client.zip dans les fichiers d’installation de la version du serveur Teamcenter que vous utilisez actuellement.

2. Localisez les fichiers suivants dans ce fichier zip :

   soa_client\java\libs\TcSoaStructureManagementStrong*.jar

   soa_client\java\libs\TcSoaBomStrong*.jar

3. Copiez ces deux fichiers dans le répertoire %TCEDAECAD_ROOT% sur le PC hébergeant Teamcenter EDA Gateway et Altium Designer.

4. Ouvrez le fichier %TCEDAECAD_ROOT%\setup_eda.bat et localisez les lignes suivantes :

   
   rem
   rem Add customer callbacks
   rem
   if exist CustomEDACallbacks.jar (
   	SET EDA_CP=%EDA_CP%;CustomEDACallbacks.jar
   )
   

5. Ajoutez les lignes suivantes en dessous :

   
   rem Added for Altium support of BOM substitutes
   set EDA_CP=%EDA_CP%;TcSoaStructureManagementStrong_14000.3.0.jar
   set EDA_CP=%EDA_CP%;TcSoaBomStrong_14000.3.0.jar
   

   Faites attention au numéro de version (c.-à-d. 14000.3.0 dans l’exemple ci-dessus). Il doit correspondre au numéro de version inclus dans le nom du fichier copié à l’étape précédente.

6. Ouvrez le fichier %TCEDAECAD_ROOT%\altiumPcb_edadef.xml. Ajoutez les entrées <callback …/> suivantes dans la section <CallbackDefs> (déjà présente dans le fichier) :

   
   <callback type="java" operation="preSave" command="com.altium.eis.teamcenter.eda.callback.SubstituteCallbacks:checkSubstitutes"/>
   <callback type="java" operation="preSaveAs" command="com.altium.eis.teamcenter.eda.callback.SubstituteCallbacks:checkSubstitutes"/>
   <callback type="java" operation="postSave" command="com.altium.eis.teamcenter.eda.callback.SubstituteCallbacks:updateSubstitutes"/>
   <callback type="java" operation="postSaveAs" command="com.altium.eis.teamcenter.eda.callback.SubstituteCallbacks:updateSubstitutes"/>
   

   Les entrées ci-dessus sont déjà présentes dans le fichier altiumPcb_edadef.xml, dans un commentaire multiligne au sein de la section <CallbackDefs>. Vous pouvez déplacer ces entrées hors du commentaire (par exemple, en les plaçant juste sous la partie --> dans cette section).
7. Redémarrez le PC pour vous assurer que Teamcenter EDA charge les nouvelles bibliothèques.

Notes:

• Teamcenter EDA doit être configuré pour s’exécuter avec Java 11.
• Si vous utilisez Teamcenter 13, assurez-vous d’utiliser les versions des bibliothèques supplémentaires provenant de votre installation Teamcenter 13.
• Veillez à mettre à jour les fichiers CustomEDACallbacks.jar et altiumPcb_edadef.xml dans le répertoire %TCEDAECAD_ROOT%.
• Dans Altium Designer, toutes les variantes de conception partagent le même ensemble de substitutions ; il n’est donc pas possible d’avoir des substitutions différentes définies pour le même élément de nomenclature selon les variantes.
• La liste des composants de substitution dans Teamcenter est une liste de révisions de composants. Les entrées de composants de substitution ne créent pas de lignes de nomenclature et ne peuvent pas recevoir de propriétés de ligne de nomenclature. Dans Altium Designer, il est possible d’avoir une colonne de nomenclature avec une valeur différente pour les substitutions, mais seules les propriétés du composant de base seront transférées vers les propriétés de ligne de nomenclature Teamcenter.
• Si un projet avec des substitutions dans la nomenclature a été publié dans Teamcenter puis qu’une substitution de la nomenclature du projet a été supprimée et que le projet a été publié à nouveau, la substitution sera également supprimée de la nomenclature dans Teamcenter.
• Si un projet avec des substitutions dans la nomenclature a été publié dans Teamcenter puis que la nomenclature a été modifiée manuellement dans Teamcenter, la nomenclature dans Teamcenter sera remplacée lors de la prochaine publication de ce projet, c’est-à-dire que les modifications effectuées manuellement seront perdues.

• Les composants utilisés comme substitutions dans ActiveBOM doivent être synchronisés avec Teamcenter. Cette condition est vérifiée par le callback preSave. S’il existe des composants qui n’ont pas été synchronisés avec Teamcenter, un message d’erreur s’affichera et l’opération sera interrompue ; aucune modification ne sera donc apportée dans Teamcenter.

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 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.
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 de manière à pointer 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 la passerelle Siemens EDA.
• L’ECO n’est actuellement pas pris en charge.