Dodatkowa instalacja i konfiguracja dla Teamcenter EDA Gateway

Parent page: Integracja z PLM

Integracja PLM z Siemens Teamcenter® wymaga dodatkowej konfiguracji, która nie jest wykonywana automatycznie przez instalator instancji Enterprise Server. Zasadniczo potrzebne są dwa poziomy konfiguracji – w zależności od wymaganych funkcji integracji. Pierwszy poziom włącza synchronizację części (Parts Synchronization) i jest też warunkiem wstępnym dla drugiego poziomu, który włącza procesy PLM publikowania/inicjalizacji projektu (Project Publish/Initialization). Mimo to zaleca się wykonanie obu poziomów konfiguracji.

Synchronizacja części z Teamcenter

Aby włączyć synchronizację elementów biblioteki, musisz zainstalować oprogramowanie Siemens Teamcenter^® EDA (Electronic Design Automation) Gateway na maszynie hostującej Enterprise Server. Ten dokument zakłada, że Enterprise Server oraz serwer Teamcenter są już zainstalowane na oddzielnych maszynach – zalecamy takie podejście, aby zapewnić separację obu instalacji, choć mogą one być zainstalowane na tej samej maszynie.

Instalacja i konfiguracja Teamcenter EDA

Cała procedura instalacji i konfiguracji EDA Gateway jest szczegółowo opisana w dokumentacji EDA Integration specyficznej dla danej wersji, dostępnej w Siemens Support Center. Postępuj dokładnie zgodnie z tą dokumentacją. Instrukcje tutaj obejmują jedynie odstępstwa od dokumentacji Siemens lub doprecyzowują szczegóły po stronie Altium, które w dokumentacji Siemens są wskazane jako wymagania.

Wybierz wersję EDA Gateway, która obsługuje wersję Twojego serwera Teamcenter – informacje o kompatybilności powinny znajdować się w odpowiednich TcEDA<version>_README.pdfplikach dostępnych w centrum pobierania. Następnie zapoznaj się z dokumentacją Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications (przykładowy link dotyczy EDA w wersji 5.1), w temacie Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications for part library management, aby przeprowadziła Cię przez konfigurację:

W ramach instalacji i konfiguracji interfejsu Enterprise Server/Teamcenter musisz również zainstalować (oraz w razie potrzeby licencjonować itd.) następujące funkcje Teamcenter – patrz 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

Dodatkowo wykonaj Install and set up Common Integration Services, aby obsłużyć publikowanie projektów (Design Publishing).

Następnie wykonaj kolejne kroki i zainstaluj EDA Gateway CLIENT na maszynie Enterprise Server. Aby uprościć proces, sugerujemy użycie folderu C:\Siemens\TeamcenterEDA2.

Skonfiguruj EDA Gateway do zarządzania biblioteką części

Podobnie jak wyżej, w tej sekcji również należy skonsultować dokumentację Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications (przykładowy link dotyczy EDA w wersji 5.1), w temacie Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications for part library management.

Wróć do tego zestawu instrukcji, gdy dotrzesz do konkretnych rozdziałów w dokumentacji Teamcenter. Poniższe sekcje odwołują się do tych rozdziałów po nazwie.

Rozdział: 'Configure the EDA client for part library management'

W tym kroku zostaniesz poproszony o przygotowanie library gateway configuration file – zamiast tego użyj pliku dostarczonego przez Altium. Możesz go pobrać w pakiecie plików konfiguracyjnych z interfejsu przeglądarkowego Enterprise Server Workspace: Otwórz Admin » PLM Integration, użyj przycisku Add Configuration, aby otworzyć widok Add New Instance, wybierz Teamcenter EDA z listy rozwijanej Driver, a następnie wybierz link Download Teamcenter EDA client definition files powiązany z polem URL – zobacz przykład.

W pobranym pliku PLMClientConfigurationFiles.zip będzie znajdował się plik altiumLibrary_edadef.xml – umieść ten plik w katalogu wskazywanym przez zmienną środowiskową systemu: %TCEDAECAD_ROOT%. Dodaj również dostarczony plik altiumPcb_edadef.xml do tego katalogu.

Rozdział: 'Setting up Teamcenter server for part library management'

Otwórz Teamcenter Rich Client jako użytkownik infodba lub jako inny użytkownik z uprawnieniami administracyjnymi.
► Zobacz informacje o Teamcenter Rich Client.

Poniższe zrzuty ekranu ilustrują kroki opisane w Create external applications for your ECAD tool in Teamcenter. W naszym przypadku dodamy altiumLibrary,15 do preferencji EDALIB_External_Applications:

Kliknij polecenie , aby dodać nową wartość, następnie Save, po czym zamknij preferencję. Wyloguj się, a następnie zaloguj ponownie do Teamcenter Rich client.

• Otwórz aplikację Organization.
• Przejdź do sekcji External Applications i dodaj aplikację altiumLibrary, jak pokazano poniżej:

• Wybierz Create.

Rozdział: 'Mapping ECAD part attributes to Teamcenter attributes'

Z poziomu wiersza poleceń Teamcenter uruchom narzędzie export_attr_mappings, aby wyeksportować mapowanie do pliku, na przykład:

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

Zmodyfikuj plik mappings.txt zgodnie z wymaganiami, aby mapować rzeczywiste atrybuty Teamcenter na komponenty. Przykład działającego mapowania, dodanego do zawartości wyeksportowanego 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"}

Po zakończeniu mapowania zaimportuj je z powrotem do Teamcenter:

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

Aby rozwiązywać problemy z mapowaniem atrybutów, możesz włączyć szczegółowe logi, dodając linię rootLogger.level= DEBUG w pliku C:\Program Files\Siemens\TeamcenterEDA2\eda\log4j2.properties.

Logi z wykonania Teamcenter EDA można znaleźć w C:\Windows\TEMP\eis_eda_log.log.

Rozdział: 'Creating classification mapping for ECAD parts with Teamcenter classes' (opcjonalnie)

Mapowanie klasyfikacji jest opcjonalnym wymaganiem konfiguracyjnym i może nie być używane ani potrzebne w Twojej instalacji Teamcenter PLM. Zwróć uwagę, że aby używać atrybutów klasyfikacji, muszą one zostać uwzględnione w konfiguracji/pliku mapowania atrybutów podczas wykonywania poprzedniej sekcji 'Mapping ECAD part attributes to Teamcenter attributes' powyżej.

Przed rozpoczęciem tego etapu konfiguracji upewnij się, że masz włączoną funkcjonalność klasyfikacji. Następnie postępuj zgodnie z instrukcjami, aby skonfigurować mapowanie klasyfikacji.

Upewnij się, że _eda2tc.csv ma kolumny w kolejności category,classId, a _tc2eda.csv ma kolumny w kolejności classId,category. W razie potrzeby zamień nazwy plików.

Aby używać atrybutów klasyfikacji, musisz uwzględnić je w mapowaniu atrybutów. Przykład mapowania atrybutu klasyfikacji:

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

Gdzie numer -60262 można znaleźć za pomocą narzędzia Classification Admin w Teamcenter.

Mapowanie klasyfikacji w Enterprise Server

Informacje o klasyfikacji mogą być wysyłane za pomocą specjalnego atrybutu Classification uwzględnionego w Twoim pliku konfiguracyjnym XML dla PLM (typically dm-config.xml lub podobnym). Na przykład:

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

Wartość tego atrybutu powinna być ścieżką rozdzielaną przecinkami w drzewie klasyfikacji, na przykład: „Components,SMT,Capacitor”.

Podobnie, atrybuty klasyfikacji mogą być przywoływane po nazwie skonfigurowanej w mapowaniu atrybutów na serwerze Teamcenter, na przykład:

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

Zdefiniuj bibliotekę na Enterprise Server

Zanim synchronizacja z Enterprise Server będzie możliwa, konieczne jest utworzenie biblioteki poleceniem eda_cli.bat (znajdującym się w katalogu %TCEDAECAD_ROOT% na maszynie Enterprise Server), a także upewnienie się, że utworzone pliki są dostępne dla Enterprise Server:

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

Na tym etapie powinno być możliwe wykonanie w Enterprise Server procesu Component Sync oraz procesu Part Request with PLM Part Create.

Dodatkowe informacje o synchronizacji części biblioteki:

• Synchronization of Released/Unreleased Teamcenter parts – Domyślnie z Teamcenter do Altium będą synchronizowane tylko komponenty oznaczone release_status_list.name = ‘TCM Released’ . Można to zmienić w Teamcenter Query Builder, modyfikując zapytanie używane przez Teamcenter do wybierania komponentów (zobacz przykład).

Nazwa zapytania jest przechowywana w preferencji EDALIB_Sync_FindNewParts. Domyślne zapytanie to __EDALIB_find_newparts i jest pokazane poniżej.

Ostatni warunek można usunąć, aby synchronizować komponenty, które nie są jeszcze „TCM Released”.

► Więcej informacji znajdziesz w powiązanej dokumentacji Siemens Teamcenter.

• Multisite synchronization – Możliwe jest również użycie Teamcenter jako źródła informacji o komponentach dla wielu lokalizacji (jedną z nich jest Enterprise Server). Zwróć uwagę, że wymaga to specjalnej konfiguracji opisanej w dokumentacji.
• Unit-of-measure parameter synchronization– Integracja Workspace z Teamcenter obsługuje mapowanie parametrów z uwzględnieniem jednostek dzięki dodatkowym kolumnom danych Data Type i SiPrefix w tabeli Component Parameter Mapping table w interfejsie użytkownika. Użyj opcji z menu rozwijanego danego wpisu, aby wybrać odpowiedni typ danych (see options) oraz prefiks jednostki (see options).

• Destination folder for parts – Folder docelowy dla części synchronizowanych z Altium do Teamcenter można ustawić per lokalizacja/użytkownik za pomocą preferencji Teamcenter EDALIB_SaveAsFolderDefault.
• Current Part Synchronization limitations:
  • Numery części PLM są generowane wyłącznie po stronie Enterprise Server.
  • Folderu docelowego nie można określić dla komponentów w pliku konfiguracyjnym – po stronie Teamcenter istnieje ustawienie globalne. Ustawienie folderu docelowego w pliku PLM XML Configuration (dm-config.xml) zostanie zignorowane bez ostrzeżenia. Folder docelowy jest pobierany z poziomu użytkownika Teamcenter lub z opcji na poziomie lokalizacji EDALIB_SaveAsFolderDefault dla wszystkich typów komponentów.
  • Wybór natywnych części (Approved Manufacturer/Vendor List, czyli AML/AVL) nie jest obsługiwany. Jak dotychczas, obsługiwane są wyłącznie wybory części oparte na parametrach komponentu.

Publikowanie projektów z Teamcenter EDA

Publikowanie projektu z Altium do Teamcenter jest możliwe wyłącznie przez Altium Designer. Aby włączyć publikowanie projektu, musisz zainstalować bramę Teamcenter EDA (Electronic Design Automation) Gateway na komputerze, na którym zainstalowany jest Altium Designer . Będziesz też potrzebować dostępu zarówno do Enterprise Server, jak i do serwera Teamcenter.

Procedura instalacji i konfiguracji EDA Gateway jest szczegółowo opisana w dokumentacji specyficznej dla danej wersji EDA Integration, dostępnej w Siemens Support Center. Postępuj dokładnie zgodnie z tą dokumentacją. Instrukcje tutaj obejmują jedynie odstępstwa od dokumentacji Siemens lub doprecyzowują szczegóły po stronie Altium, które w dokumentacji Siemens są wskazane jako wymagania.

Wybierz wersję EDA Gateway, która obsługuje wersję Twojego serwera Teamcenter – informacje o kompatybilności powinny znajdować się w odpowiednich plikach TcEDA<version>_README.pdf dostępnych w centrum pobierania. Następnie zapoznaj się z dokumentacją Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications (przykładowy link dotyczy EDA w wersji 5.1), w temacie Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications for design management, aby przeprowadzić konfigurację:

Jeśli ma być obsługiwane tworzenie komponentów podczas publikowania projektu, część konfiguracji biblioteki musi zostać wykonana na serwerze. Dotyczy to domyślnej strategii sekcji <pt:BomStrategy>CreateNewAndLink</pt:BomStrategy> w szablonie publikacji.

Folder docelowy dla projektów można ustawić za pomocą opcji na poziomie lokalizacji/użytkownika: EDA_SaveAsFolderDefault.

Mapowanie atrybutów linii BOM

Atrybuty linii BOM Reference Designator i Quantity są obsługiwane automatycznie, ale muszą zostać uwzględnione w sekcji <BOM> pliku PLM connector XML Configuration:

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

Aby użyć innych atrybutów linii BOM, należy uwzględnić je w sekcji mapowania atrybutów linii BOM w pliku altiumPcb_edadef.xml. Na przykład poniższy wpis dodaje mapowanie atrybutu Altium part_source na atrybut linii BOM Teamcenter bl_part_source:

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

Po dodaniu takiego mapowania można zdefiniować jego wartość w sekcji <BOMAttributes> pliku PLM connector XML Configuration:

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

Konfiguracja publikowania części alternatywnych w BOM

ActiveBOM w Altium Designer obsługuje dodawanie części alternatywnych do pozycji BOM (learn more). Aby obsłużyć takie części alternatywne podczas publikowania projektu do Teamcenter PLM, konieczna jest dodatkowa konfiguracja Teamcenter EDA, jak opisano poniżej (w terminologii Teamcenter te alternatywne komponenty w kontekście konkretnego BOM nazywane są komponentami zastępczymi, substitute components). Umożliwi to wywołania zwrotne (callbacks) Altium z logiką transferu zamienników.

1. Znajdź plik soa_client.zip w plikach instalacyjnych dla aktualnie używanej wersji serwera Teamcenter.

2. Wewnątrz tego pliku zip znajdź następujące pliki:

   soa_client\java\libs\TcSoaStructureManagementStrong*.jar

   soa_client\java\libs\TcSoaBomStrong*.jar

3. Skopiuj te dwa pliki do katalogu %TCEDAECAD_ROOT% na komputerze hostującym Teamcenter EDA Gateway i Altium Designer.

4. Otwórz plik %TCEDAECAD_ROOT%\setup_eda.bat i znajdź następujące linie:

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

5. Dodaj poniższe linie poniżej:

   
   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
   

   Zwróć uwagę na numer wersji (tj. 14000.3.0 w przykładzie powyżej). Musi on odpowiadać numerowi wersji zawartemu w nazwie pliku skopiowanego w poprzednim kroku.

6. Otwórz plik %TCEDAECAD_ROOT%\altiumPcb_edadef.xml. Dodaj następujące wpisy <callback …/> w sekcji <CallbackDefs> (już istnieje w pliku):

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

   Powyższe wpisy są już obecne w pliku altiumPcb_edadef.xml, w wielowierszowym komentarzu w sekcji <CallbackDefs>. Możesz przenieść te wpisy z komentarza (np. umieszczając je tuż pod częścią --> w tej sekcji).
7. Uruchom ponownie komputer, aby upewnić się, że Teamcenter EDA załaduje nowe biblioteki.

Notes:

• Teamcenter EDA musi być skonfigurowany do działania na Java 11.
• Jeśli używasz Teamcenter 13, upewnij się, że używasz wersji dodatkowych bibliotek z instalacji Teamcenter 13.
• Upewnij się, że zaktualizowano pliki CustomEDACallbacks.jar oraz altiumPcb_edadef.xml w katalogu %TCEDAECAD_ROOT%.
• W Altium Designer wszystkie design variants współdzielą ten sam zestaw zamienników, tzn. nie jest możliwe zdefiniowanie różnych zamienników dla tej samej pozycji BOM w różnych wariantach.
• Lista komponentów zastępczych w Teamcenter jest listą rewizji komponentów. Wpisy komponentów zastępczych nie tworzą linii BOM i nie można im przypisać właściwości linii BOM. W Altium Designer możliwe jest posiadanie kolumny BOM z inną wartością dla zamienników, ale do właściwości linii BOM w Teamcenter zostaną przeniesione wyłącznie właściwości z komponentu bazowego.
• Jeśli projekt z zamiennikami w BOM został opublikowany do Teamcenter, a następnie zamiennik z BOM projektu został usunięty i projekt opublikowano ponownie, zamiennik zostanie również usunięty z BOM w Teamcenter.
• Jeśli projekt z zamiennikami w BOM został opublikowany do Teamcenter, a następnie BOM został ręcznie zmodyfikowany w Teamcenter, BOM w Teamcenter zostanie nadpisany przy następnym opublikowaniu tego projektu, tzn. ręcznie wprowadzone zmiany zostaną utracone.

• Komponenty używane jako zamienniki w ActiveBOM muszą być zsynchronizowane z Teamcenter. Ten warunek jest sprawdzany przez callback preSave. Jeśli istnieją komponenty, które nie zostały zsynchronizowane z Teamcenter, zostanie wyświetlony komunikat o błędzie, a operacja zostanie przerwana, więc w Teamcenter nie zostaną wprowadzone żadne zmiany.

Konfiguracja Business Modeler IDE (BMIDE) dla pochodnych zestawów danych

Po utworzeniu konfiguracji danych pochodnych (zob. odwołania w pliku altiumPcb_edadef.xml), możesz określić nazwę konfiguracji w preferencji EDA_DerivedDataConfigDefault.

1. W BMIDE otwórz folder Extensions.
2. W folderze Extensions kliknij prawym przyciskiem myszy EDA Derived Data i wybierz New EDA Derived Data. Zostanie wyświetlony kreator New EDA Derived Data.
3. W oknie dialogowym EDA Derived Data wprowadź informacje i kliknij Next.
4. Dla pochodnego zestawu danych PCB dodaj nowy wpis w sekcji „Configure datasets”.

Ścieżka: $TEMP\Altium\TcEda\Project\pcb\*.*

5. Dla pochodnego zestawu danych schematu dodaj nowy wpis w sekcji „Configure datasets”.

Ścieżka: $TEMP\Altium\TcEda\Project\schematic\*.*

6. Kolejny pochodny zestaw danych dla zestawów danych wariantów:

Ścieżka: $TEMP\Altium\TcEda\Project\$VARIANT\pcb\*.*

7. Aby zapisać zmiany w modelu danych, wybierz File » Save Data Model lub kliknij przycisk Save Data Model na głównym pasku narzędzi.
8. Wdróż zmiany na serwer testowy. Wybierz Deploy Template na pasku menu lub zaznacz projekt, a następnie kliknij przycisk Deploy Template na głównym pasku narzędzi.
9. W Rich Client ustaw preferencję EDA_DerivedDataConfigDefault tak, aby wskazywała na konfigurację danych pochodnych EDA, którą właśnie utworzyłeś(-aś).
10. Wybierz Edit » Options, kliknij łącze Search na dole okna dialogowego Options, znajdź preferencję EDA_DerivedDataConfigDefault i zmień jej wartość na nową konfigurację.

Dodatkowe informacje dotyczące publikowania projektu

Current Project Publishing Limitations:

• Odwoływanie się do konkretnych rewizji komponentów („Precise BOM”) nie jest obsługiwane przez Siemens EDA Gateway.
• ECO nie jest obecnie obsługiwane.