Konfiguracja dla Teamcenter PLM

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 umożliwia synchronizację części (Parts Synchronization) i jest również warunkiem wstępnym dla drugiego poziomu, który uruchamia procesy PLM publikowania/inicjalizacji projektu (Project Publish/Initialization). Niemniej jednak zaleca się wykonanie obu poziomów konfiguracji.

Synchronizacja części z Teamcenter

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

Instalacja i konfiguracja Teamcenter EDA

Cała 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ą. Poniższe instrukcje 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 Gateway 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ć konfigurację:

W ramach instalacji i konfiguracji interfejsu Enterprise Server/Teamcenter musisz również zainstalować (oraz w razie potrzeby licencjonować itp.) 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 odwołać się do dokumentacji 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 w dokumentacji Teamcenter dotrzesz do konkretnych rozdziałów. 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 przykładowych plików konfiguracyjnych z interfejsu przeglądarkowego Enterprise Server Workspace: Otwórz Admin » PLM Integration, użyj przycisku Add Instance, aby otworzyć okno Add new instance, wybierz kartę Configuration, a następnie Download sample configuration.

W pobranym pliku ZIP będzie znajdował się plik altiumLibrary_edadef.xml – umieść go 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'

W wierszu 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 zmapować rzeczywiste atrybuty Teamcenter na komponentach. Przykładowe działające mapowanie, dodane 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ć przesyłane za pomocą specjalnego atrybutu Classification uwzględnionego w pliku konfiguracyjnym XML 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) oraz 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 bibliotecznych:

• Synchronization of Released/Unreleased Teamcenter parts – Domyślnie z Teamcenter do Altium będą synchronizowane tylko komponenty oznaczone jako 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.
• 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.
  • Nie można określić folderu docelowego 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 witryny EDALIB_SaveAsFolderDefault dla wszystkich typów komponentów.
  • Wybór części natywnych (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 projektu z Teamcenter EDA

Publikowanie projektu z Altium do Teamcenter jest możliwe wyłącznie przez Altium Designer. Aby włączyć publikowanie projektu, musisz zainstalować bramkę 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 szczególności z tematem 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 publikowania.

Folder docelowy dla projektów można ustawić za pomocą opcji witryny/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>
        <!-- Atrybut "Reference Designator" jest wymagany dla konektora Teamcenter EDA -->
        <common:BOMAttribute>
        <common:Key>Reference Designator</common:Key>
        <common:Value>${parameter.LogicalDesignator}</common:Value>
        </common:BOMAttribute>
        <!-- Atrybut "Quantity" jest wymagany dla konektora Teamcenter EDA -->
        <common:BOMAttribute>
        <common:Key>Quantity</common:Key>
        <common:Value>${parameter.Quantity}</common:Value>
        </common:BOMAttribute>
    </BOMAttributes>
</BOM>

Aby używać 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:

<!-- Możesz dodać dowolne inne atrybuty niestandardowe, ale muszą one zostać zmapowane na atrybut Teamcenter w pliku altiumPcb_edadef.xml -->
<common:BOMAttribute>
    <common:Key>part_source</common:Key>
    <common:Value>${parameter.MakeOrBuy}</common:Value>
</common:BOMAttribute>

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

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ś.
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 o publikowaniu 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.