SDK per l'integrazione PLM
L'SDK di integrazione PLM consente di creare un connettore personalizzato tra un Workspace Altium 365 e qualsiasi sistema PLM, inclusi quelli non supportati in modo nativo, inserendosi nello stesso flusso di lavoro di integrazione PLM che gli utenti di Altium 365 già conoscono.
L'SDK è un framework C# che implementa l'interfaccia PLM Connector: un servizio gRPC che Altium 365 richiama per comunicare con un'istanza PLM. Tu implementi la logica del connettore; Altium 365 gestisce il lato Workspace dell'integrazione.
SDK repository and full documentation: AltiumDeveloper/plm-integration-sdk-cs
Quando utilizzarlo
Utilizza l'SDK di integrazione PLM nei seguenti casi:
-
Your PLM is not natively supported – Altium 365 supporta direttamente diversi sistemi PLM. Per tutti gli altri, il modello Generic Connector consente di creare un'integrazione completa che si comporta allo stesso modo dal punto di vista del Workspace.
-
You need custom integration logic – Regole di mappatura, comportamenti del ciclo di vita o particolarità della sincronizzazione che vanno oltre ciò che è possibile definire tramite l'interfaccia di configurazione standard o la configurazione basata su XML.
-
Enterprise deployment constraints – Gateway on-premise, pacchettizzazione controllata o modelli di distribuzione che richiedono il pieno controllo del connettore come servizio distribuibile.
Come funziona
Altium 365 comunica con il connettore tramite gRPC. Il connettore viene eseguito come servizio che riceve chiamate dalla piattaforma e le traduce in operazioni sul sistema PLM.
Prima di ogni operazione, Altium 365 richiama un Auth endpoint per verificare che le credenziali configurate dall'utente consentano l'accesso al PLM. Un IContext contenente tali credenziali viene quindi reso disponibile lungo l'intera catena di chiamate tramite l'iniezione delle dipendenze: non è necessario passare manualmente le credenziali tra le operazioni.
Operazioni
L'SDK di integrazione PLM implementa le seguenti operazioni:
Operazione |
Descrizione |
Sync to PLM |
Legge i componenti da Altium 365 e crea o aggiorna gli elementi corrispondenti nel PLM |
Sync to Altium |
Interroga il PLM per recuperare gli elementi e memorizza i dati in Altium 365 |
Publish BOM |
Viene eseguita durante la pubblicazione del progetto; crea le definizioni delle relazioni tra il progetto e i suoi elementi PLM |
Publish Project |
Crea o aggiorna tutti i componenti del progetto, carica i file allegati e stabilisce le relazioni; se configurata, può far avanzare lo stato del flusso di lavoro |
Per una descrizione dettagliata di ciascun flusso, consulta l'articolo Flusso delle operazioni.
Per iniziare
-
Clona o crea un fork di AltiumDeveloper/plm-integration-sdk-cs. Il repository include un'implementazione di esempio funzionante basata sull'archiviazione nel file system: un utile riferimento per comprendere come le operazioni si traducono in chiamate al PLM.
-
Acquisisci familiarità con il funzionamento dell'integrazione PLM in Altium 365 – in particolare con il modello Generic Connector, la configurazione della connessione e l'impostazione della direzione di sincronizzazione.
-
Implementa le interfacce del connettore per il tuo sistema PLM e distribuisci il servizio in modo che sia raggiungibile da Altium 365.
-
Registra il connettore nel tuo Workspace in Admin → PLM Integration.
Requisiti
Enterprise license – L'integrazione PLM (incluso il driver Generic Connector) è una funzionalità di Enterprise Toolkit. L'opzione Generic Connector non viene visualizzata nella configurazione della connessione PLM se al Workspace non è assegnata la licenza appropriata.
Approfondimenti
-
Integrazione PLM in Altium 365 – Configurazione e concetti relativi al lato Workspace
-
Documentazione dell'SDK – Riferimento API e articoli
-
Flusso delle operazioni – Sequenza dettagliata per ogni operazione di sincronizzazione e pubblicazione
-
FAQ – Domande frequenti su autenticazione, debug e comportamento del connettore
-
Localizzato tramite A