SDK integracji PLM
SDK integracji PLM umożliwia zbudowanie niestandardowego konektora między obszarem roboczym Altium 365 Workspace a dowolnym systemem PLM — w tym systemami niewspieranymi standardowo — przy jednoczesnym dopasowaniu do tego samego przepływu pracy integracji PLM, który użytkownicy Altium 365 już znają.
SDK to framework C#, który implementuje interfejs Generic PLM Connector: usługę gRPC, którą Altium 365 wywołuje, aby komunikować się z instancją PLM. Implementujesz logikę konektora; Altium 365 obsługuje stronę Workspace tej integracji.
SDK repository and full documentation: AltiumDeveloper/plm-integration-sdk-cs
Kiedy go używać
Użyj SDK integracji PLM, gdy zachodzi którykolwiek z poniższych przypadków:
-
Your PLM is not natively supported – Altium 365 bezpośrednio obsługuje kilka systemów PLM. Dla wszystkich pozostałych model Generic Connector pozwala zbudować pełnoprawną integrację, która z perspektywy Workspace działa tak samo.
-
You need custom integration logic – reguły mapowania, zachowania cyklu życia lub niuanse synchronizacji wykraczające poza to, co można wyrazić za pomocą standardowego interfejsu konfiguracji lub konfiguracji opartej na XML.
-
Enterprise deployment constraints – bramy lokalne, kontrolowane pakietowanie lub wzorce wdrożeniowe wymagające posiadania konektora jako wdrażalnej usługi.
Jak to działa
Altium 365 komunikuje się z konektorem przez gRPC. Twój konektor działa jako usługa, która odbiera wywołania z platformy i tłumaczy je na operacje w systemie PLM.
Przed każdą operacją Altium 365 wywołuje Auth endpoint, aby zweryfikować, czy poświadczenia skonfigurowane przez użytkownika umożliwią dostęp do systemu PLM. Następnie IContext zawierający te poświadczenia jest udostępniany w całym łańcuchu wywołań poprzez dependency injection — nie musisz ręcznie przekazywać poświadczeń między operacjami.
Operacje
SDK integracji PLM implementuje następujące operacje:
Operacja |
Opis |
Sync to PLM |
Odczytuje komponenty z Altium 365 oraz tworzy lub aktualizuje odpowiadające im elementy w systemie PLM |
Sync to Altium |
Odpytuje system PLM o elementy i zapisuje dane z powrotem w Altium 365 |
Publish BOM |
Uruchamia się podczas publikacji projektu; tworzy definicje relacji między projektem a jego elementami PLM |
Publish Project |
Tworzy lub aktualizuje wszystkie komponenty projektu, przesyła załączniki plikowe i ustanawia relacje; może przejść do kolejnego stanu workflow, jeśli jest to skonfigurowane |
Szczegółowy opis każdego przepływu znajdziesz w artykule Operations Flow.
Jak zacząć
-
Sklonuj lub sforkuj AltiumDeveloper/plm-integration-sdk-cs. Repozytorium zawiera działającą przykładową implementację opartą na pamięci systemu plików — to przydatne źródło wiedzy, pomagające zrozumieć, jak operacje mapują się na wywołania PLM.
-
Zapoznaj się z tym, jak działa integracja PLM w Altium 365 – szczególnie z modelem Generic Connector, konfiguracją połączenia oraz konfiguracją kierunku synchronizacji.
-
Zaimplementuj interfejsy konektora dla swojego systemu PLM i wdroż usługę w miejscu dostępnym dla Altium 365.
-
Zarejestruj konektor w swoim Workspace w sekcji Admin → PLM Integration.
Wymagania
Enterprise license – Integracja PLM (w tym sterownik Generic Connector) jest funkcją pakietu Enterprise Toolkit. Opcja Generic Connector nie pojawi się w konfiguracji połączenia PLM bez odpowiedniej licencji przypisanej do Twojego Workspace.
Dalsza lektura
-
Integracja PLM w Altium 365 – konfiguracja i pojęcia po stronie Workspace
-
Dokumentacja SDK – dokumentacja API i artykuły
-
Operations Flow – szczegółowa sekwencja dla każdej operacji synchronizacji i publikacji
-
FAQ – najczęstsze pytania dotyczące uwierzytelniania, debugowania i zachowania konektora
-
Tłumaczenie SI