SDK de Integração PLM
O SDK de Integração PLM permite criar um conector personalizado entre um Workspace do Altium 365 e qualquer sistema PLM — incluindo sistemas que não são suportados nativamente —, encaixando-se no mesmo fluxo de trabalho de Integração PLM que os usuários do Altium 365 já conhecem.
O SDK é um framework em C# que implementa a interface Generic PLM Connector: um serviço gRPC que o Altium 365 chama para se comunicar com uma instância de PLM. Você implementa a lógica do conector; o Altium 365 cuida do lado do Workspace na integração.
SDK repository and full documentation: AltiumDeveloper/plm-integration-sdk-cs
Quando usar
Use o SDK de Integração PLM quando qualquer uma das situações abaixo se aplicar:
-
Your PLM is not natively supported – o Altium 365 oferece suporte direto a vários sistemas PLM. Para todo o restante, o modelo Generic Connector permite criar uma integração de primeira classe que se comporta da mesma forma do ponto de vista do Workspace.
-
You need custom integration logic – regras de mapeamento, comportamentos de ciclo de vida ou nuances de sincronização que vão além do que a interface padrão de configuração ou a configuração baseada em XML conseguem expressar.
-
Enterprise deployment constraints – gateways on-premises, empacotamento controlado ou padrões de implantação que exigem possuir o conector como um serviço implantável.
Como funciona
O Altium 365 se comunica com o conector via gRPC. Seu conector é executado como um serviço que recebe chamadas da plataforma e as traduz em operações no seu sistema PLM.
Antes de cada operação, o Altium 365 chama um Auth endpoint para verificar se as credenciais configuradas pelo usuário permitirão acesso ao PLM. Em seguida, um IContext contendo essas credenciais é disponibilizado em toda a cadeia de chamadas por meio de injeção de dependência — você não precisa passar credenciais manualmente entre as operações.
Operações
O SDK de Integração PLM implementa as seguintes operações:
Operação |
Descrição |
Sync to PLM |
Lê componentes do Altium 365 e cria ou atualiza itens correspondentes no PLM |
Sync to Altium |
Consulta o PLM em busca de itens e armazena os dados de volta no Altium 365 |
Publish BOM |
Executa durante a publicação do projeto; cria definições de relacionamento entre o projeto e seus itens no PLM |
Publish Project |
Cria ou atualiza todos os componentes do projeto, faz upload de anexos de arquivo e estabelece relacionamentos; pode avançar o estado do fluxo de trabalho, se configurado |
Para um passo a passo detalhado de cada fluxo, consulte o artigo Fluxo das operações.
Primeiros passos
-
Clone ou faça um fork de AltiumDeveloper/plm-integration-sdk-cs. O repositório inclui uma implementação de exemplo funcional baseada em armazenamento no sistema de arquivos — uma referência útil para entender como as operações são mapeadas para chamadas ao PLM.
-
Familiarize-se com o funcionamento da Integração PLM no Altium 365 – especialmente o modelo Generic Connector, a configuração da conexão e a configuração da direção de sincronização.
-
Implemente as interfaces do conector para seu sistema PLM e implante o serviço onde o Altium 365 possa alcançá-lo.
-
Registre o conector no seu Workspace em Admin → PLM Integration.
Requisitos
Enterprise license – A Integração PLM (incluindo o driver Generic Connector) é um recurso do Enterprise Toolkit. A opção Generic Connector não aparecerá na configuração de conexão PLM sem a licença apropriada atribuída ao seu Workspace.
Leitura adicional
-
Integração PLM no Altium 365 – configuração e conceitos do lado do Workspace
-
Documentação do SDK – referência da API e artigos
-
Fluxo das operações – sequência detalhada de cada operação de sincronização e publicação
-
Perguntas frequentes – dúvidas comuns sobre autenticação, depuração e comportamento do conector
-