SDK do integracji z PLM
SDK integracji z PLM umożliwia tworzenie niestandardowego konektora między przestrzenią roboczą Altium 365 a dowolnym systemem PLM — również takim, który nie jest obsługiwany standardowo — z zachowaniem znanego użytkownikom Altium 365 procesu integracji z PLM.
SDK to platforma programistyczna w języku C#, która implementuje interfejs konektora PLM: usługę gRPC wywoływaną przez Altium 365 w celu komunikacji z instancją PLM. Ty implementujesz logikę konektora, a Altium 365 obsługuje integrację po stronie przestrzeni roboczej.
SDK repository and full documentation: AltiumDeveloper/plm-integration-sdk-cs
Kiedy z niego korzystać
Użyj SDK integracji z PLM w następujących sytuacjach:
-
Your PLM is not natively supported – Altium 365 obsługuje bezpośrednio kilka systemów PLM. W przypadku pozostałych model Generic Connector umożliwia stworzenie pełnoprawnej integracji, która z perspektywy przestrzeni roboczej działa w taki sam sposób.
-
You need custom integration logic – Potrzebujesz reguł mapowania, zachowań związanych z cyklem życia lub szczegółowych mechanizmów synchronizacji, których nie da się zdefiniować za pomocą standardowego interfejsu konfiguracji ani konfiguracji opartej na XML.
-
Enterprise deployment constraints – Korzystasz z lokalnych bram, kontrolowanego pakowania lub modeli wdrażania, które wymagają zarządzania konektorem jako usługą możliwą do wdrożenia.
Jak to działa
Altium 365 komunikuje się z konektorem za pośrednictwem gRPC. Konektor działa jako usługa, która odbiera wywołania z platformy i przekształca je w operacje w systemie PLM.
Przed każdą operacją Altium 365 wywołuje Auth endpoint, aby sprawdzić, czy dane uwierzytelniające skonfigurowane przez użytkownika umożliwiają dostęp do PLM. Następnie obiekt IContext zawierający te dane jest udostępniany w całym łańcuchu wywołań za pomocą wstrzykiwania zależności — nie trzeba ręcznie przekazywać danych uwierzytelniających między operacjami.
Operacje
SDK integracji z PLM implementuje następujące operacje:
Operacja |
Opis |
Sync to PLM |
Odczytuje komponenty z Altium 365 i tworzy lub aktualizuje odpowiadające im pozycje w PLM |
Sync to Altium |
Wyszukuje pozycje w PLM i zapisuje pobrane dane w Altium 365 |
Publish BOM |
Uruchamia się podczas publikowania projektu; tworzy definicje relacji między projektem a jego pozycjami w PLM |
Publish Project |
Tworzy lub aktualizuje wszystkie komponenty projektu, przesyła załączniki i ustanawia relacje; jeśli tak skonfigurowano, może zmienić stan przepływu pracy na kolejny |
Szczegółowy opis każdego przebiegu znajdziesz w artykule Przebieg operacji.
Pierwsze kroki
-
Sklonuj repozytorium AltiumDeveloper/plm-integration-sdk-cs lub utwórz jego fork. Repozytorium zawiera działającą przykładową implementację wykorzystującą system plików do przechowywania danych — to przydatny punkt odniesienia pozwalający zrozumieć, jak operacje przekładają się na wywołania PLM.
-
Zapoznaj się z tym, jak działa integracja z PLM w Altium 365 – w szczególności z modelem Generic Connector, konfiguracją połączenia i ustawieniami kierunku synchronizacji.
-
Zaimplementuj interfejsy konektora dla swojego systemu PLM i wdróż usługę w miejscu dostępnym dla Altium 365.
-
Zarejestruj konektor w swojej przestrzeni roboczej w sekcji Admin → PLM Integration.
Wymagania
Enterprise license – Integracja z PLM (w tym sterownik Generic Connector) jest funkcją pakietu Enterprise Toolkit. Opcja Generic Connector nie pojawi się w konfiguracji połączenia PLM, jeśli do przestrzeni roboczej nie zostanie przypisana odpowiednia licencja.
Dodatkowe materiały
-
Integracja z PLM w Altium 365 – konfiguracja i pojęcia związane z przestrzenią roboczą
-
Dokumentacja SDK – dokumentacja API i artykuły
-
Przebieg operacji – szczegółowa sekwencja każdej operacji synchronizacji i publikowania
-
Najczęściej zadawane pytania – typowe pytania dotyczące uwierzytelniania, debugowania i działania konektora
-
Tłumaczenie SI