Einrichtung für Teamcenter PLM

Parent page: PLM-Integration

Die Siemens Teamcenter® PLM-Integration erfordert zusätzliche Einrichtungsschritte, die nicht automatisch vom Installer der Enterprise Server-Instanz verwaltet werden. Grundsätzlich sind je nach benötigten Integrationsfunktionen zwei Einrichtungsebenen erforderlich. Die erste Ebene aktiviert die Teile-Synchronisierung und ist zugleich Voraussetzung für die zweite Ebene, die PLM-Prozesse für Projektveröffentlichung/-initialisierung aktiviert. Dennoch wird empfohlen, beide Einrichtungsebenen durchzuführen.

Teile-Synchronisierung mit Teamcenter

Um die Synchronisierung von Bibliotheksteilen zu aktivieren, müssen Sie die Siemens Teamcenter^® EDA (Electronic Design Automation) Gateway-Software auf dem Rechner installieren, der den Enterprise Server hostet. Dieses Dokument geht davon aus, dass der Enterprise Server und der Teamcenter-Server bereits auf getrennten Rechnern installiert sind – wir empfehlen dieses Vorgehen, um eine Trennung zwischen den beiden Installationen sicherzustellen, auch wenn sie auf demselben Rechner installiert werden könnten.

Installation und Konfiguration von Teamcenter EDA

Das vollständige Installations- und Konfigurationsverfahren für EDA Gateway ist ausführlich in der versionsspezifischen EDA IntegrationDokumentation beschrieben, die im Siemens Support Center verfügbar ist. Bitte folgen Sie dieser Dokumentation sorgfältig. Die Anweisungen hier behandeln nur Abweichungen von der Siemens-Dokumentation oder nennen Details auf Altium-Seite, auf die in der Siemens-Dokumentation als Anforderungen verwiesen wird.

Wählen Sie eine Version von EDA Gateway, die Ihre Teamcenter-Serverversion unterstützt – Kompatibilitätsinformationen sollten Sie in den entsprechenden TcEDA<version>_README.pdfDateien finden, die im Download Center verfügbar sind. Ziehen Sie anschließend die Dokumentation Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications heran (Beispiellink gilt für EDA-Version 5.1), insbesondere zum Thema Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications for part library management, um sich durch die Einrichtung führen zu lassen:

Im Rahmen der Installation und Konfiguration der Enterprise Server/Teamcenter-Schnittstelle müssen Sie außerdem die folgenden Teamcenter-Funktionen installieren (und bei Bedarf lizenzieren usw.) – siehe 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

Führen Sie zusätzlich Install and set up Common Integration Services aus, um Design Publishing zu unterstützen.

Folgen Sie anschließend den Schritten und installieren Sie EDA Gateway CLIENT auf dem Enterprise Server-Rechner. Zur Vereinfachung des Prozesses empfehlen wir die Verwendung des Ordners C:\Siemens\TeamcenterEDA2.

EDA Gateway für die Verwaltung der Teilebibliothek konfigurieren

Wie oben erwähnt, sollten Sie für diesen Abschnitt ebenfalls die Dokumentation Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications heranziehen (Beispiellink gilt für EDA-Version 5.1), insbesondere zum Thema Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications for part library management.

Bitte greifen Sie auf diese Anweisungen zurück, wenn Sie in der Teamcenter-Dokumentation bestimmte Kapitel erreichen. Die folgenden Abschnitte beziehen sich namentlich auf diese Kapitel.

Kapitel: 'Configure the EDA client for part library management'

Während dieses Schritts werden Sie aufgefordert, eine library gateway configuration file vorzubereiten – verwenden Sie stattdessen eine von Altium bereitgestellte Datei. Sie können sie zusammen mit einem Paket von Beispiel-Konfigurationsdateien über die Browser-Oberfläche des Enterprise Server Workspace herunterladen: Öffnen Sie Admin » PLM Integration, verwenden Sie die Schaltfläche Add Instance, um das Fenster Add new instance zu öffnen, wählen Sie die Registerkarte Configuration und dann Download sample configuration.

Innerhalb der heruntergeladenen ZIP-Datei befindet sich eine altiumLibrary_edadef.xml-Datei – legen Sie diese Datei in das Verzeichnis, auf das die Systemumgebungsvariable verweist: %TCEDAECAD_ROOT%. Fügen Sie außerdem die bereitgestellte Datei altiumPcb_edadef.xml diesem Verzeichnis hinzu.

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

Öffnen Sie Teamcenter Rich Client als Benutzer infodba oder als anderen Benutzer mit Administratorrechten.
► Siehe Informationen zum Teamcenter Rich Client.

Die folgenden Screenshots veranschaulichen die in Create external applications for your ECAD tool in Teamcenter beschriebenen Schritte. In unserem Fall fügen wir altiumLibrary,15 zur Einstellung EDALIB_External_Applications hinzu:

Klicken Sie auf den Befehl , um den neuen Wert hinzuzufügen, anschließend auf Save, und schließen Sie dann die Einstellung. Melden Sie sich ab und anschließend wieder beim Teamcenter Rich client an.

• Öffnen Sie die Anwendung Organization.
• Navigieren Sie zum Abschnitt External Applications und fügen Sie wie unten gezeigt eine Anwendung altiumLibrary hinzu:

• Wählen Sie Create.

Kapitel: 'Mapping ECAD part attributes to Teamcenter attributes'

Führen Sie über die Teamcenter-Befehlszeile das Dienstprogramm export_attr_mappings aus, um das Mapping in eine Datei auszugeben, zum Beispiel:

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

Ändern Sie die Datei mappings.txt entsprechend Ihren Anforderungen, um reale Teamcenter-Attribute auf die Komponenten abzubilden. Ein Beispiel für ein funktionierendes Mapping, ergänzt zum Inhalt der exportierten mappings.txt:

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

Nachdem das Mapping abgeschlossen ist, importieren Sie es zurück nach Teamcenter:

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

Zur Fehlerbehebung bei Problemen mit dem Attribut-Mapping können Sie detaillierte Logs aktivieren, indem Sie die Zeile rootLogger.level= DEBUG in die Datei C:\Program Files\Siemens\TeamcenterEDA2\eda\log4j2.properties aufnehmen.

Logs aus der Teamcenter-EDA-Ausführung finden Sie in C:\Windows\TEMP\eis_eda_log.log.

Kapitel: 'Creating classification mapping for ECAD parts with Teamcenter classes' (optional)

Das Klassifikations-Mapping ist eine optionale Einrichtungsanforderung und wird für Ihre Teamcenter-PLM-Installation möglicherweise nicht verwendet oder benötigt. Beachten Sie, dass Klassifikationsattribute zur Verwendung in die Attribut-Mapping-Konfiguration/-Datei aufgenommen werden müssen, wenn Sie den vorherigen Abschnitt 'Mapping ECAD part attributes to Teamcenter attributes' oben abschließen.

Bevor Sie mit dieser Einrichtungsphase beginnen, stellen Sie sicher, dass die Klassifikationsfunktionalität aktiviert ist. Folgen Sie dann den Anweisungen zum Einrichten des Klassifikations-Mappings.

Stellen Sie sicher, dass _eda2tc.csv die Spalten in der Reihenfolge category,classId enthält und _tc2eda.csv die Spalten in der Reihenfolge classId,category. Tauschen Sie bei Bedarf die Dateinamen.

Um Klassifikationsattribute zu verwenden, müssen Sie sie in das Attribut-Mapping aufnehmen. Ein Beispiel für ein Klassifikationsattribut-Mapping ist:

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

Die Nummer -60262 finden Sie mit dem Werkzeug Classification Admin in Teamcenter.

Klassifikations-Mapping im Enterprise Server

Klassifikationsinformationen können mit einem speziellen Attribut Classification gesendet werden, das in Ihrer XML-Konfigurationsdatei des PLM (typically dm-config.xml oder ähnlich) enthalten ist. Zum Beispiel:

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

Der Wert dieses Attributs sollte ein durch Kommas getrennter Pfad im Klassifikationsbaum sein, zum Beispiel: „Components,SMT,Capacitor“.

Ebenso können Klassifikationsattribute über den Namen referenziert werden, der im Attribut-Mapping auf dem Teamcenter-Server konfiguriert wurde, zum Beispiel:

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

Bibliothek auf dem Enterprise Server definieren

Bevor eine Synchronisierung mit dem Enterprise Server möglich ist, muss mit dem Befehl eda_cli.bat eine Bibliothek erstellt werden (befindet sich im Verzeichnis von %TCEDAECAD_ROOT% auf dem Enterprise Server-Rechner). Außerdem muss sichergestellt werden, dass die erstellten Dateien für den Enterprise Server zugänglich sind:

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

In diesem Stadium sollte es möglich sein, eine Enterprise Server-Component Sync sowie einen Enterprise Server-Part Request with PLM Part Create-Prozess durchzuführen.

Zusätzliche Informationen zur Synchronisierung von Bibliotheksteilen:

• Synchronization of Released/Unreleased Teamcenter parts – Standardmäßig werden nur Komponenten, die mit release_status_list.name = ‘TCM Released’ gekennzeichnet sind, von Teamcenter nach Altium synchronisiert. Dies kann im Teamcenter Query Builder geändert werden, indem die von Teamcenter verwendete Abfrage zur Auswahl von Komponenten angepasst wird (siehe Beispiel).

Der Name der Abfrage ist in der Einstellung EDALIB_Sync_FindNewParts gespeichert. Die Standardabfrage ist __EDALIB_find_newparts und wird unten gezeigt.

Die letzte Bedingung kann entfernt werden, um Komponenten zu synchronisieren, die noch nicht „TCM Released“ sind.

► Weitere Informationen finden Sie in der zugehörigen Siemens Teamcenter documentation.

• Multisite synchronization – Teamcenter kann außerdem als Quelle für Komponenteninformationen für mehrere Standorte verwendet werden (einer davon ist Enterprise Server). Beachten Sie, dass dies eine spezielle Einrichtung erfordert, die in der Dokumentation beschrieben ist.
• Destination folder for parts – Der Zielordner für von Altium nach Teamcenter synchronisierte Teile kann pro Standort/Benutzer über die Teamcenter-Einstellung EDALIB_SaveAsFolderDefault festgelegt werden.
• Current Part Synchronization limitations:
  • PLM-Teilenummern werden ausschließlich auf der Enterprise Server-Seite generiert.
  • Der Zielordner kann für Komponenten nicht in der Konfigurationsdatei angegeben werden – auf der Teamcenter-Seite gibt es dafür eine globale Einstellung. Eine Einstellung des Zielordners in der PLM-XML-Konfigurationsdatei (dm-config.xml) wird ohne Warnung ignoriert. Der Zielordner wird aus der Teamcenter-Benutzerebene oder aus der Option auf Site-Ebene EDALIB_SaveAsFolderDefault für alle Komponententypen übernommen.
  • Native Teileauswahlen (Approved Manufacturer/Vendor List bzw. AML/AVL) werden nicht unterstützt. Wie bisher werden nur teileauswahlen auf Basis von Komponentenparametern unterstützt.

Design Publishing mit Teamcenter EDA

Die Veröffentlichung von Designs aus Altium nach Teamcenter ist nur über Altium Designer möglich. Um Design Publishing zu aktivieren, müssen Sie Teamcenter EDA (Electronic Design Automation) Gateway auf dem Rechner installieren, auf dem Altium Designer installiert ist. Außerdem benötigen Sie Zugriff sowohl auf den Enterprise Server als auch auf den Teamcenter-Server.

Das Installations- und Konfigurationsverfahren für EDA Gateway ist in der versionsspezifischen EDA IntegrationDokumentation, die im Siemens Support Center verfügbar ist, ausführlich beschrieben. Bitte folgen Sie dieser Dokumentation sorgfältig. Die Anweisungen hier behandeln nur Abweichungen von der Siemens-Dokumentation oder nennen Details auf Altium-Seite, die in der Siemens-Dokumentation als Anforderungen aufgeführt sind.

Wählen Sie eine Version von EDA Gateway, die Ihre Teamcenter-Serverversion unterstützt – Kompatibilitätsinformationen sollten Sie in den entsprechenden TcEDA<version>_README.pdfDateien finden, die im Download Center verfügbar sind. Konsultieren Sie anschließend die Dokumentation Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications (der Beispiel-Link gilt für EDA-Version 5.1), insbesondere zum Thema Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications for design management, um sich durch die Einrichtung führen zu lassen:

Wenn die Erstellung von Komponenten während der Projektveröffentlichung unterstützt werden soll, muss ein Teil der Bibliothekskonfiguration auf dem Server durchgeführt werden. Dies gilt für die Standard-Abschnittsstrategie <pt:BomStrategy>CreateNewAndLink</pt:BomStrategy> in der Publish-Vorlage.

Der Zielordner für Designs kann über die Site-/Benutzeroptionen festgelegt werden: EDA_SaveAsFolderDefault.

Zuordnung von BOM-Zeilenattributen

Die BOM-Zeilenattribute Reference Designator und Quantity werden automatisch verarbeitet, müssen jedoch im Abschnitt <BOM> der XML-Konfigurationsdatei des PLM-Connectors enthalten sein:

<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>

Um andere BOM-Zeilenattribute zu verwenden, müssen diese im Abschnitt zur Zuordnung von BOM-Zeilenattributen der Datei altiumPcb_edadef.xml aufgenommen werden. Im folgenden Beispiel wird etwa eine Zuordnung des Altium-Attributs part_source zum Teamcenter-BOM-Zeilenattribut bl_part_source hinzugefügt:

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

Wenn eine solche Zuordnung hinzugefügt wird, kann ihr Wert im Abschnitt <BOMAttributes> der XML-Konfigurationsdatei des PLM-Connectors definiert werden:

<!-- 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>

Business Modeler IDE (BMIDE)-Konfiguration für abgeleitete Datasets

Nach dem Erstellen einer Konfiguration für abgeleitete Daten (siehe Verweise in der Datei altiumPcb_edadef.xml) können Sie den Namen der Konfiguration in der Einstellung EDA_DerivedDataConfigDefault angeben.

1. In BMIDE öffnen Sie den Ordner Extensions.
2. Im Ordner Extensions klicken Sie mit der rechten Maustaste auf EDA Derived Data und wählen New EDA Derived Data. Der Assistent New EDA Derived Data wird angezeigt.
3. Geben Sie im Dialogfeld EDA Derived Data die Informationen ein und klicken Sie auf Next.
4. Fügen Sie für das abgeleitete PCB-Dataset unter „Configure datasets“ einen neuen Eintrag hinzu.

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

5. Fügen Sie für das abgeleitete Schaltplan-Dataset unter „Configure datasets' einen neuen Eintrag hinzu.

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

6. Ein weiteres abgeleitetes Dataset für Variantendatasets:

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

7. Um die Änderungen am Datenmodell zu speichern, wählen Sie File » Save Data Model oder klicken Sie in der Hauptsymbolleiste auf die Schaltfläche Save Data Model.
8. Stellen Sie Ihre Änderungen auf dem Testserver bereit. Wählen Sie in der Menüleiste Deploy Template oder markieren Sie das Projekt und klicken Sie dann in der Hauptsymbolleiste auf die Schaltfläche Deploy Template.
9. Legen Sie im Rich Client die Einstellung EDA_DerivedDataConfigDefault so fest, dass sie auf die soeben erstellte EDA-Konfiguration für abgeleitete Daten verweist.
10. Wählen Sie Edit » Options, klicken Sie unten im Dialogfeld Options auf den Link Search, suchen Sie die Einstellung EDA_DerivedDataConfigDefault und ändern Sie ihren Wert auf die neue Konfiguration.

Zusätzliche Informationen zum Design Publishing

Current Project Publishing Limitations:

• Die Referenzierung bestimmter Komponentenrevisionen („Precise BOM“) wird vom Siemens EDA Gateway nicht unterstützt.
• ECO wird derzeit nicht unterstützt.