Einrichtung für Teamcenter PLM

Parent page: PLM-Integration

Die Siemens Teamcenter® PLM-Integration erfordert zusätzliche Einrichtungsschritte, die vom Installer der Enterprise Server-Instanz nicht automatisch verwaltet werden. Grundsätzlich sind je nach benötigten Integrationsfunktionen zwei Einrichtungsstufen erforderlich. Die erste Stufe aktiviert die Teile-Synchronisierung und ist zugleich Voraussetzung für die zweite Stufe, die PLM-Prozesse für Projektveröffentlichung/-initialisierung aktiviert. Dennoch wird empfohlen, beide Einrichtungsstufen 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, auf dem der Enterprise Server gehostet wird. Dieses Dokument setzt voraus, 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, obwohl sie auch auf demselben Rechner installiert werden könnten.

Installation und Konfiguration von Teamcenter EDA

Das vollständige Installations- und Konfigurationsverfahren für EDA Gateway ist in der versionsspezifischen EDA IntegrationDokumentation im Siemens Support Center 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, 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. Konsultieren Sie anschließend die Dokumentation Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications (Beispiellink gilt für EDA-Version 5.1), insbesondere das 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 Parts Library Management konfigurieren

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

Bitte greifen Sie auf diese Anleitung zurück, wenn Sie in der Teamcenter-Dokumentation die entsprechenden 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 diese zusammen mit einem Paket von Konfigurationsdateien über die Browser-Oberfläche des Enterprise Server Workspace herunterladen: Öffnen Sie Admin » PLM Integration, verwenden Sie die Schaltfläche Add Configuration, um die Ansicht Add New Instance zu öffnen, wählen Sie Teamcenter EDA aus dem Dropdown-Menü Driver und wählen Sie dann den Link Download Teamcenter EDA client definition files, der dem Feld URL zugeordnet ist – siehe Beispiel.

In der heruntergeladenen Datei PLMClientConfigurationFiles.zip befindet sich eine Datei altiumLibrary_edadef.xml – legen Sie diese Datei in das Verzeichnis, auf das die Systemumgebungsvariable %TCEDAECAD_ROOT% verweist. 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 anderer 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

Passen Sie die Datei mappings.txt entsprechend Ihren Anforderungen an, 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"
    Kosten : Item.GRM(IMAN_master_form).object_desc /description="Cost"
    Toleranz : 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: (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 Konfiguration/Datei des Attribut-Mappings 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 Spalten in der Reihenfolge category,classId hat und _tc2eda.csv Spalten in der Reihenfolge classId,category hat. Tauschen Sie bei Bedarf die Dateinamen aus.

Um Klassifikationsattribute zu verwenden, müssen Sie diese 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 gesendet werden, das in Ihrer XML-Konfigurationsdatei des PLM enthalten ist (typically dm-config.xml oder ähnlich). 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, einen Enterprise Server-Component Sync sowie einen Enterprise Server-Part Request with PLM Part Create-Prozess auszufü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’ markiert sind, von Teamcenter nach Altium synchronisiert. Dies kann im Teamcenter Query Builder geändert werden, indem die von Teamcenter verwendete Abfrage zur Auswahl der 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-Dokumentation.

• Multisite synchronization – Teamcenter kann auch als Quelle für Komponenteninformationen für mehrere Standorte verwendet werden (einer davon ist Enterprise Server). Beachten Sie, dass hierfür eine spezielle Einrichtung erforderlich ist, die in der Dokumentation beschrieben wird.
• Destination folder for parts – Der Zielordner für aus Altium nach Teamcenter synchronisierte Teile kann pro Standort/Benutzer über die EDALIB_SaveAsFolderDefault Teamcenter-Voreinstellung festgelegt werden.
• Current Part Synchronization limitations:
  • PLM-Teilenummern werden ausschließlich serverseitig auf dem Enterprise Server erzeugt.
  • 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 Option auf Teamcenter-Benutzerebene oder aus der Option auf Standortebene EDALIB_SaveAsFolderDefault für alle Komponententypen übernommen.
  • Native Teileauswahl (Approved Manufacturer/Vendor List bzw. AML/AVL) wird nicht unterstützt. Wie bisher wird nur die parameterbasierte Teileauswahl für Komponenten unterstützt.

Design Publishing mit Teamcenter EDA

Das Veröffentlichen von Designs aus Altium nach Teamcenter ist nur über Altium Designer möglich. Um das 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 ausführlich in der versionsspezifischen EDA Integration Dokumentation 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, die in der Siemens-Dokumentation als Anforderungen aufgeführt sind.

Wählen Sie eine Version von EDA Gateway, die Ihre Teamcenter-Serverversion unterstützt – Informationen zur Kompatibilität sollten Sie in den entsprechenden TcEDA<version>_README.pdf Dateien 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 Standort-/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 die 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 wurde, 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>

Konfiguration für das Publishing von BOM-Ersatzteilen

ActiveBOM in Altium Designer unterstützt das Hinzufügen von Ersatzteilen zu BOM-Positionen (mehr erfahren). Um solche Ersatzteile beim Veröffentlichen eines Designs in Teamcenter PLM zu unterstützen, muss eine zusätzliche Konfiguration von Teamcenter EDA wie unten beschrieben durchgeführt werden (in der Terminologie von Teamcenter werden diese alternativen Komponenten im Kontext einer bestimmten BOM als Ersatzkomponenten bezeichnet). Dadurch werden Altium-Callbacks mit Logik zur Übertragung von Ersatzteilen aktiviert.

1. Suchen Sie die Datei soa_client.zip in den Installationsdateien für die Teamcenter-Serverversion, die Sie derzeit verwenden.

2. Suchen Sie in dieser ZIP-Datei die folgenden Dateien:

   soa_client\java\libs\TcSoaStructureManagementStrong*.jar

   soa_client\java\libs\TcSoaBomStrong*.jar

3. Kopieren Sie diese beiden Dateien in das Verzeichnis %TCEDAECAD_ROOT% auf dem PC, auf dem Teamcenter EDA Gateway und Altium Designer gehostet werden.

4. Öffnen Sie die Datei %TCEDAECAD_ROOT%\setup_eda.bat und suchen Sie die folgenden Zeilen:

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

5. Fügen Sie darunter die folgenden Zeilen hinzu:

   
   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
   

   Achten Sie auf die Versionsnummer (d. h. 14000.3.0 im obigen Beispiel). Sie muss mit der Versionsnummer im Dateinamen übereinstimmen, der im vorherigen Schritt kopiert wurde.

6. Öffnen Sie die Datei %TCEDAECAD_ROOT%\altiumPcb_edadef.xml. Fügen Sie die folgenden <callback …/> Einträge innerhalb des Abschnitts <CallbackDefs> hinzu (dieser ist bereits in der Datei vorhanden):

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

   Die obigen Einträge sind bereits in der Datei altiumPcb_edadef.xml vorhanden, und zwar in einem mehrzeiligen Kommentar innerhalb des Abschnitts <CallbackDefs>. Sie können diese Einträge aus dem Kommentar übernehmen (z. B. indem Sie sie direkt unter den Teil --> in diesem Abschnitt verschieben).
7. Starten Sie den PC neu, damit Teamcenter EDA die neuen Bibliotheken lädt.

Notes:

• Teamcenter EDA muss für die Ausführung mit Java 11 konfiguriert sein.
• Wenn Sie Teamcenter 13 verwenden, stellen Sie sicher, dass Sie Versionen der zusätzlichen Bibliotheken aus Ihrer Teamcenter-13-Installation verwenden.
• Stellen Sie sicher, dass Sie die Dateien CustomEDACallbacks.jar und altiumPcb_edadef.xml im Verzeichnis %TCEDAECAD_ROOT% aktualisieren.
• In Altium Designer verwenden alle Designvarianten denselben Satz an Ersatzteilen, d. h. es ist nicht möglich, für dieselbe BOM-Position in verschiedenen Varianten unterschiedliche Ersatzteile zu definieren.
• Die Liste der Ersatzkomponenten in Teamcenter ist eine Liste von Komponentenrevisionen. Einträge von Ersatzkomponenten erzeugen keine BOM-Zeilen und ihnen können keine BOM-Zeileneigenschaften zugewiesen werden. In Altium Designer ist es möglich, eine BOM-Spalte mit einem anderen Wert für Ersatzteile zu haben, aber nur Eigenschaften der Basiskomponente werden auf BOM-Zeileneigenschaften in Teamcenter übertragen.
• Wenn ein Projekt mit Ersatzteilen in der BOM in Teamcenter veröffentlicht wurde und anschließend ein Ersatzteil aus der Projekt-BOM entfernt und das Projekt erneut veröffentlicht wurde, wird das Ersatzteil auch aus der BOM in Teamcenter entfernt.
• Wenn ein Projekt mit Ersatzteilen in der BOM in Teamcenter veröffentlicht wurde und die BOM anschließend manuell in Teamcenter geändert wurde, wird die BOM in Teamcenter bei der nächsten Veröffentlichung dieses Projekts überschrieben, d. h. die manuell vorgenommenen Änderungen gehen verloren.

• Komponenten, die in ActiveBOM als Ersatzteile verwendet werden, müssen mit Teamcenter synchronisiert sein. Diese Bedingung wird durch den Callback preSave geprüft. Wenn es Komponenten gibt, die nicht mit Teamcenter synchronisiert wurden, wird eine Fehlermeldung angezeigt und der Vorgang abgebrochen, sodass in Teamcenter keine Änderungen vorgenommen werden.

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 Voreinstellung EDA_DerivedDataConfigDefault angeben.

1. Öffnen Sie in BMIDE 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 den abgeleiteten PCB-Datensatz unter „Configure datasets“ einen neuen Eintrag hinzu.

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

5. Fügen Sie für den abgeleiteten Schaltplandatensatz unter „Configure datasets“ einen neuen Eintrag hinzu.

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

6. Ein weiterer abgeleiteter Datensatz für Variantendatensätze:

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 zur Design-Veröffentlichung

Current Project Publishing Limitations:

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