Łączenie obszaru roboczego Altium 365 z systemami zewnętrznymi

Design data in Altium 365 does not have to stay in Altium 365. The Altium 365 API gives external systems programmatic access to Workspace data – for reading, writing, and reacting to changes.

API Altium 365 zapewnia dostęp po stronie serwera do pełnego zakresu encji Workspace: komponentów, projektów, BOM-ów, metadanych projektów, użytkowników, uprawnień oraz stanów cyklu życia. Systemy zewnętrzne mogą odpytywać te dane, przesyłać aktualizacje i integrować zdarzenia Altium Workspace z szerszymi przepływami pracy w przedsiębiorstwie. Dostęp opiera się na tokenach; operacje są wykonywane po stronie serwera bez konieczności otwierania Altium Designer ani obecności użytkownika.

To jest właściwy punkt integracji dla każdego przypadku użycia, w którym system zewnętrzny musi programowo wymieniać dane z Altium 365 – pulpity nawigacyjne, synchronizacja z ERP, niestandardowe potoki raportowania, systemy audytowe oraz automatyzacja działająca poza środowiskiem projektowym.

Typowe wzorce integracji

• Data extraction and reporting – pobieranie danych o komponentach, zawartości BOM-ów, metadanych projektów i stanów cyklu życia do zewnętrznych systemów raportowych, pulpitów nawigacyjnych lub hurtowni danych. Przydatne dla widoczności na potrzeby zarządzania inżynierią, planowania zakupów oraz raportowania zgodności, które wymaga danych z Altium, ale funkcjonuje w oddzielnym systemie.

• ERP and inventory synchronization – przesyłanie zmian cyklu życia komponentów i list zatwierdzonych części z Altium 365 do ERP. Pobieranie zatwierdzonych materiałów i danych magazynowych do Altium w celu wyświetlania ich w środowisku projektowym. API jest warstwą synchronizacji między tymi dwoma systemami.

• Automation pipelines – wyzwalanie działań następczych, gdy w Altium 365 wystąpią zdarzenia – projekt zostanie zwolniony, stan cyklu życia komponentu ulegnie zmianie, przegląd projektu zostanie zakończony. API pozwala zewnętrznym systemom orkiestracji reagować na stan Altium Workspace bez odpytywania lub ręcznych wyzwalaczy.

• Custom tooling and portals – tworzenie wewnętrznych narzędzi, które prezentują dane Altium w kontekstach, w których pełny interfejs Workspace nie jest odpowiedni – portal zatwierdzania komponentów, pulpit statusu wydań, widok dla działu zakupów pokazujący wyłącznie dane potrzebne zakupom. API dostarcza warstwę danych; Twoje narzędzie zapewnia interfejs.

• User and permission management – programowe zarządzanie członkostwem w Workspace, poziomami dostępu i strukturą zespołów. Przydatne dla organizacji, w których provisionowanie Altium Workspace musi pozostawać zsynchronizowane z centralnym systemem tożsamości lub HR.

Czego API nie zastępuje

API Altium 365 zapewnia dostęp do danych i operacji na poziomie Workspace. Nie udostępnia modelu edytora projektu – prymitywów PCB, obiektów schematu, topologii sieci – który znajduje się wewnątrz Altium Designer. W przypadkach użycia wymagających dostępu do danych na poziomie projektu podczas aktywnej sesji edycji, odpowiednim narzędziem jest SDK Altium Designer. W przypadkach użycia wymagających dostępu do prymitywów projektu PCB na potrzeby dalszego przetwarzania, API danych projektowych Nexar zapewnia oddzielną ścieżkę dostępu.

Uwagi dotyczące podejścia integracyjnego

• Token management – API używa uwierzytelniania opartego na tokenach. Osobiste tokeny dostępu są powiązane z użytkownikiem i przypisują działania temu użytkownikowi. Tokeny aplikacyjne są przypisane do nazwanej aplikacji i są odpowiednie dla zautomatyzowanych potoków oraz integracji serwer-serwer. Wybór zależy od tego, czy integracja reprezentuje działanie osoby, czy systemu.

• Eventual consistency – w niektórych przypadkach zmiany danych Workspace propagują się asynchronicznie. Integracje zależne od stanu w czasie rzeczywistym powinny uwzględniać opóźnienie między wystąpieniem zmiany a jej widocznością przez API.

• Error handling and retries – integracje produkcyjne powinny implementować logikę ponawiania prób z mechanizmem backoff dla przejściowych błędów. Operacje Workspace są trwałe, ale warunki sieciowe i limity szybkości nie są gwarantowane.