SDK de Integração PLM
O SDK de integração com PLM permite que você crie 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 com 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 com PLM quando qualquer uma das seguintes condições 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 na perspectiva 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-based setup conseguem expressar.
-
Enterprise deployment constraints – gateways on-premises, empacotamento controlado ou padrões de implantação que exigem que você tenha 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. Um IContext contendo essas credenciais então fica disponível 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 com PLM implementa as seguintes operações:
Operação |
Descrição |
Sync to PLM |
Lê componentes do Altium 365 e cria ou atualiza os 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 |
É executada durante a publicação do projeto; cria definições de relacionamento entre o projeto e seus itens de PLM |
Publish Project |
Cria ou atualiza todos os componentes do projeto, faz upload de anexos de arquivos e estabelece relacionamentos; pode avançar o estado do fluxo de trabalho, se configurado |
Para uma explicação detalhada de cada fluxo, consulte o artigo Operations Flow.
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 de PLM.
-
Familiarize-se com o funcionamento da integração com PLM no Altium 365 – principalmente o modelo Generic Connector, a configuração de conexão e a configuração da direção de sincronização.
-
Implemente as interfaces do conector para o 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 com 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 com PLM no Altium 365 – configuração e conceitos do lado do Workspace
-
Documentação do SDK – referência da API e artigos
-
Fluxo de Operações – sequência detalhada para cada operação de sincronização e publicação
-
Perguntas frequentes – perguntas comuns sobre autenticação, depuração e comportamento do conector
-