SDK integracji PLM
PLM Integration SDK umożliwia zbudowanie niestandardowego konektora między obszarem roboczym Altium 365 Workspace a dowolnym systemem PLM – w tym systemami, które nie są obsługiwane od razu po wdrożeniu – przy jednoczesnym dopasowaniu do tego samego przepływu pracy PLM Integration, 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 używać
Użyj PLM Integration SDK, gdy ma zastosowanie którekolwiek z poniższych:
-
Your PLM is not natively supported – Altium 365 bezpośrednio obsługuje kilka systemów PLM. W przypadku wszystkich pozostałych model Generic Connector umożliwia zbudowanie pełnoprawnej integracji, która z perspektywy Workspace działa w ten sam sposób.
-
You need custom integration logic – reguły mapowania, zachowania cyklu życia lub niuanse synchronizacji wykraczają poza to, co można wyrazić za pomocą standardowego interfejsu konfiguracji lub konfiguracji opartej na XML.
-
Enterprise deployment constraints – lokalne bramy, kontrolowane pakowanie lub wzorce wdrożenia wymagają 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 Twoim 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 obiekt IContext zawierający te poświadczenia jest udostępniany w całym łańcuchu wywołań poprzez wstrzykiwanie zależności – nie musisz ręcznie przekazywać poświadczeń między operacjami.
Operacje
PLM Integration SDK 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 |
Wysyła zapytania do systemu PLM o elementy i zapisuje dane z powrotem w Altium 365 |
Publish BOM |
Uruchamia się podczas publikowania projektu; tworzy definicje relacji między projektem a jego elementami PLM |
Publish Project |
Tworzy lub aktualizuje wszystkie komponenty projektu, przesyła załączniki plików i ustanawia relacje; może przejść do kolejnego stanu workflow, jeśli jest tak skonfigurowany |
Aby zobaczyć szczegółowy opis każdego przepływu, przejdź do artykułu Operations Flow.
Pierwsze kroki
-
Sklonuj repozytorium lub utwórz fork AltiumDeveloper/plm-integration-sdk-cs. Repozytorium zawiera działającą przykładową implementację opartą na pamięci systemu plików – to przydatny punkt odniesienia do zrozumienia, jak operacje mapują się na wywołania PLM.
-
Zapoznaj się z tym, jak działa PLM Integration w Altium 365 – szczególnie z modelem Generic Connector, konfiguracją połączenia i konfiguracją kierunku synchronizacji.
-
Zaimplementuj interfejsy konektora dla swojego systemu PLM i wdroż usługę tam, gdzie Altium 365 może się z nią połączyć.
-
Zarejestruj konektor w swoim Workspace w sekcji Admin → PLM Integration.
Wymagania
Enterprise license – PLM Integration (w tym sterownik Generic Connector) jest funkcją Enterprise Toolkit. Opcja Generic Connector nie pojawi się w konfiguracji połączenia PLM bez odpowiedniej licencji przypisanej do Twojego Workspace.
Dalsza lektura
-
PLM Integration w Altium 365 – konfiguracja po stronie Workspace i podstawowe pojęcia
-
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 działania konektora
-
Tłumaczenie SI