Integração com PLM usando arquivos XML

Num relance

Saiba como conectar um Workspace do Altium 365 a um sistema PLM compatível usando arquivos de configuração XML editados manualmente e modelos de publicação. Este artigo aborda a configuração de instâncias de PLM, o mapeamento de dados de componentes, a configuração da publicação de liberações de projetos e a validação da conexão. Continue lendo para criar uma configuração que atenda aos requisitos do seu Workspace e do seu sistema PLM.

- Aprenda a adaptar arquivos XML de exemplo ou a gerar uma configuração básica a partir do modelo de dados do seu Workspace.
- Entenda como os modelos de publicação controlam a criação e a vinculação de componentes, bem como os arquivos de saída de liberação enviados ao PLM.
- Descubra como a validação da conexão identifica erros e avisos de configuração antes de você usar a integração.
Aprofunde-se com a IA:
 

Esta página descreve como estabelecer uma conexão entre um Workspace do Altium 365 e um sistema PLM compatível usando um processo manual baseado na edição de arquivos XML de configuração do PLM. A interface PLM baseada na edição manual de arquivos XML é ativada ao desmarcar a opção Enable new PLM Configuration page na página Administração – Configurações – Integração PLM da interface do Workspace.

Quando essa opção está marcada (configuração padrão e recomendada), é utilizada uma interface de usuário avançada e semiautomatizada, conforme descrito na página Integração PLM. Observe que essa interface também permite a manipulação manual de arquivos XML de configuração por meio de seus recursos de importação/exportação de XML.

Leia sobre a interface automatizada de integração PLM.

Conexão à sua instância PLM

A conexão à sua instância PLM é realizada na página Admin – PLM Integration da interface do Workspace no navegador. Isso envolve carregar o arquivo de configuração baseado em XML e o modelo de publicação aplicáveis, além de habilitar/configurar a sincronização dos componentes do PLM com os do Workspace.

Para criar uma nova instância de interface PLM, clique no botão  . É possível definir quantas instâncias forem necessárias para conectar seu Workspace a diferentes instâncias PLM. Por exemplo, seus componentes podem estar em uma instância PLM e os arquivos de saída gerados pelos projetos liberados em outra, ou talvez diferentes divisões estejam usando instâncias distintas (do mesmo sistema PLM ou de sistemas diferentes). Cada instância deve ter um nome exclusivo, um arquivo de configuração e um ou mais modelos de publicação definidos. Para testar a conexão de uma instância definida, clique no botão  – consulte Validação da conexão abaixo.

Arquivos de configuração e modelos de publicação de exemplo são fornecidos como parte da instalação – expanda as seções abaixo para obter mais informações:

Ao adicionar uma nova entrada PLM pelo botão  , use o botão  para localizar e aplicar uma configuração PLM devidamente salva/modificada.

 

Da mesma forma, um modelo de publicação compatível é adicionado pelo botão  na guia Publish Template. Na caixa de diálogo Publish Template exibida em seguida, use o botão  para localizar e selecionar o arquivo de modelo correto.

Adicione e configure a interface com o sistema PLM da sua empresa. Com uma conexão válida, você poderá publicar os dados de liberação do projeto no sistema PLM (usando as definições de processo estabelecidas) de acordo com um modelo de publicação ativo para a instância e também agendar a sincronização de componentes entre esse PLM e o Workspace.

Em vez de usar os arquivos de configuração fornecidos para criar uma nova instância do sistema corporativo, é possível usar o gerador de configuração interno do Workspace para criar uma configuração adaptada cuja estrutura deriva do modelo de dados do Workspace. O gerador solicita informações de conexão (tipo de PLM e URL) e, em seguida, consulta os dados do Workspace para identificar os tipos de componentes registrados (capacitores, diodos etc.) e seus respectivos modelos de componentes para criar um arquivo de configuração básico – clique na seção expansível a seguir para obter mais informações:

Quando um arquivo de configuração for editado e depois reenviado à instância de PLM, certifique-se de testar (validar) a conexão para detectar possíveis problemas introduzidos – veja abaixo.

Suporte a PLM de terceiros

O Workspace do Altium 365 oferece suporte adicional a configurações de sistemas PLM “não nativos” desenvolvidas por terceiros. Esse suporte é habilitado pelo Generic Connector da Altium, que requer a licença Altium 365 PLM Generic Connector Addon.

Ao adicionar uma instância de PLM do Workspace para esse tipo de sistema, os arquivos XML pré-configurados fornecidos pelo terceiro são carregados na configuração dessa instância de PLM, conforme descrito acima.

Entre em contato pelo e-mail sales.na@altium.com ou com seu gerente de contas da Altium para solicitar acesso à licença Altium 365 PLM Generic Connector Addon.

Validação da conexão

O Workspace oferece uma verificação abrangente de validação da conexão da instância de PLM, disponível no botão da página Add/Edit Instance. Essa verificação executa uma série de testes de compatibilidade da configuração e apresenta os resultados imediatamente.

Quando o relatório de validação da conexão é executado, o Workspace analisa a configuração atual e as definições do modelo de publicação para verificar a compatibilidade com os dados da instância do Workspace e do sistema corporativo de destino. Problemas de configuração, como erros de caminho, definições e parâmetros de tipos de componentes sem correspondência e configurações inválidas de ciclo de vida ou revisão, são detectados e informados na caixa de diálogo Configuration Validation Report a seguir.

Se forem relatados erros de configuração – resultando em um status geral ERROR (Status) –, eles precisarão ser resolvidos antes que a nova instância possa ser criada. Um status WARNING, que indica problemas como tipos de componentes do Workspace não incluídos na configuração ou atributos especificados que não estão disponíveis no sistema corporativo, permite que a instância configurada seja salva e utilizada.

Os erros e avisos relatados podem então ser corrigidos nos arquivos de configuração/publicação aplicados e/ou por meio de alterações nas configurações do Workspace ou do sistema corporativo. Certifique-se de clicar no botão  depois que sua instância for definida com sucesso. Essa instância aparecerá na lista atual de instâncias conectadas, de volta à página principal PLM Integration da interface.

Quando um arquivo de configuração for editado e depois reenviado à nova instância, use o botão  novamente para detectar possíveis problemas introduzidos.

Sincronização de componentes

A sincronização de componentes entre o Workspace do Altium 365 e a instância conectada do sistema corporativo – ou, mais especificamente, de seus dados paramétricos – baseia-se no LibSync fluxo de trabalho do processo. O processo LibSync é predefinido no Workspace e não pode ser acessado (nem editado) na página Admin - Processes. No entanto, por se tratar de um processo baseado em fluxo de trabalho, os resultados de sua ação de sincronização podem ser visualizados e eventuais erros podem ser tratados.

O uso do processo de sincronização envolve o seguinte:

  • Definir a configuração de sincronização para cada tipo de componente, o que, na prática, significa:
    • Determinar a direção da sincronização (para o Workspace ou para o PLM).
    • Determinar quais tipos de componentes estão envolvidos e onde os novos componentes serão criados.
    • Configurar o mapeamento ou os atributos dos parâmetros.
  • Configurar o mapeamento de dados das opções de peças, se aplicável.
  • Executar a sincronização.

Os dois primeiros grupos de itens acima são tratados no arquivo de configuração usado para a instância conectada do sistema corporativo (como um PLM). A sincronização em si pode ser executada sob demanda, na página PLM Integration da interface do Workspace, e/ou pode ser agendada – sincronização automatizada em intervalos periódicos, definidos durante a configuração da conexão com a instância de PLM.

Configuração da sincronização

No arquivo de configuração, a conectividade com a instância do sistema corporativo é definida entre as tags Instance como um tipo de driver especificado e uma URL de destino. Quando o Gerador de configuração é usado para criar o arquivo de configuração, as referências de driver e URL incluídas são aquelas inseridas na caixa de diálogo Generate Configuration durante o processo de geração.

<Instance>
    <Driver>[Driver Type]</Driver>
    <Url>[PLM API URL]</Url>
</Instance>
  • Quando o driver do PLM Arena® é especificado no arquivo de configuração, uma entrada adicional fica disponível para acomodar os workspaces do Arena disponíveis para uma conta de usuário do Arena. O atributo opcional de referência de ID com vários dígitos é adicionado à seção Instance entre as tags context, conforme mostrado no exemplo abaixo.

    •  

      <Instance>
          <Driver>Arena</Driver>
          <Url>https:∕∕api.arenasolutions.com/v1/</Url>
          <Context>12345678</Context>
          <!-- If a workspace ID is not defined, the PLM instance will work with Arena's default workspace for that account. -->
          <!-- The server will report an error if another PLM synchronization session is attempting to use a second workspace from the Arena user account. -->
      </Instance>

       

     

  • Quando o sistema conectado é o PTC Windchill PLM, pode ser necessário adicionar uma linha de configuração para habilitar as unidades de medida para as leituras de valor.
    • <Instance>
          <Driver>Windchill</Driver>
          <Url>URL</Url>
          <EnableUOMRead>true</EnableUOMRead>
      </Instance>

Na seção Schema a seguir do arquivo de configuração, você define uma seção de mapeamento de sincronização para cada tipo específico de peça. No lado do Workspace, esse é o componente do tipo altiumType – seu valor é uma das opções de parâmetros de tipo que podem ser vistas na página Gerenciamento de dados - Tipos de componentes da caixa de diálogo Preferences no Altium Designer. No lado do PLM, uma peça é criada com o tipo plmType, conforme determinado por seu valor no ambiente PLM.

A seção é declarada como um Entity no arquivo. Para capacitores, um exemplo poderia ser:

<Entity altiumType="Capacitor" plmType="Capacitor">
  .
  .
</Entity>
O valor de plmType pode variar, dependendo da instância específica de PLM que você estiver usando.

Dentro do Entity, duas seções são usadas para controlar e configurar a sincronização do Workspace para a instância do PLM e da instância do PLM para o Workspace, permitindo a sincronização unidirecional ou bidirecional. Consulte as seções a seguir, juntamente com os comentários disponíveis nos arquivos de configuração de exemplo, para saber mais. Em última análise, o que é definido no arquivo de configuração varia de acordo com suas necessidades específicas e também com os atributos (PLM) definidos na instância do sistema corporativo conectado.

A seção para definir o mapeamento de dados de Opções de Peças encontra-se no final do arquivo de configuração de exemplo (ou de um arquivo gerado).

  • Os Parâmetros, Atributos e Valores incluídos em um arquivo de configuração diferenciam maiúsculas de minúsculas.

  • Além da inclusão comum de uma chave primária de sincronização (como PlmPartNumber), não é recomendável incluir os mesmos atributos/parâmetros de componente nas seções ToAltium e ToPlm de um arquivo de configuração. A sincronização bidirecional ocorre nessa ordem (primeiro do PLM para a Altium); portanto, os dados do PLM sempre prevalecerão nessa situação.

  • Consulte os arquivos de exemplo de configuração e publicação para obter informações sobre como configurar a integração com seu sistema corporativo.

O Enterprise Server permite atualizar itens existentes do Arena PLM ao trabalhar com os processos Project Releaser e Component Sync da Altium. Isso permite que dados de projetos e componentes recém-liberados no lado da Altium sejam enviados para revisões de trabalho de itens de peças da BOM do Arena (dados de PCBA, FAB e componentes).

Com a liberação de um projeto Altium para o Arena PLM — usando o processo Project Release with Publish to PLM —, a revisão anteriormente liberada da BOM do Projeto no Arena será atualizada, e as atualizações adicionais de peças filhas serão vinculadas ao respectivo item pai. Nesse caso, o log do PLM incluirá um aviso informando que uma revisão de trabalho foi atualizada e que revisões efetivas foram adicionadas à BOM correspondente no Arena.

Como realizar a sincronização de componentes

A sincronização de componentes (biblioteca) pode ser realizada como um processo manual ou programado, respectivamente pelo botão Sync action de uma entrada de instância PLM na página PLM Integration do Workspace ou como um ciclo automatizado especificado na configuração da instância. Clique no  controle associado à instância PLM que você deseja sincronizar. O processo de sincronização seguirá o fluxo de trabalho LibSync, de acordo com as configurações definidas no arquivo de configuração associado.

O controle muda para  . Se quiser interromper o processo de sincronização, clique nesse controle. Uma janela de confirmação será exibida, na qual você poderá clicar em  para cancelar a sincronização – todos os componentes já sincronizados permanecerão assim, mas nenhuma sincronização adicional ocorrerá a partir desse ponto.

Sincronização de componentes em andamento entre o Workspace e a instância PLM indicada.Sincronização de componentes em andamento entre o Workspace e a instância PLM indicada.

A sincronização envolverá only os componentes que foram modificados desde a última sincronização (ou seja, cujo registro de data e hora é posterior à data da última sincronização) e que atendem aos critérios de sincronização do arquivo de configuração. Isso é chamado de Incremental Synchronization.

Quando a sincronização de componentes é executada, o processo LibSync percorre seu fluxo de trabalho predefinido até ser concluído ou encontrar um erro. Atualize o navegador (F5) para exibir o estado atual do processo de sincronização. Para monitorar ou revisar o processo LibSync, selecione a guia Synchronization status e escolha a opção de listagem Closed – se um processo ainda estiver em execução, ele aparecerá na listagem Active. O botão , disponível para administradores, pode ser usado para baixar um registro detalhado de todas as atividades de sincronização listadas em um arquivo CSV delimitado por vírgulas (Synchronisation status.csv).

As subguias da visualização fornecem as seguintes informações:

  • Diagram – um gráfico que representa o fluxo de trabalho do processo, com sua etapa atual destacada (concluído ou no estado de erro/falha).

  • Data – um resumo informativo da ação do processo, incluindo o sucesso ou a falha de suas etapas e um link para o relatório de registro do processo – veja abaixo.

  • History – um registro cronológico dos principais eventos de sincronização do Workspace, listados em sequência.

Os resultados do processo LibSync também estão disponíveis na página Process Management (Admin » Processes), na guia Browser.

 

Os detalhes do evento LibSync selecionado, exibidos na subguia Data, incluem um link para o arquivo de log do sistema (PLM [data-número].log) referente ao evento.

Se um processo LibSync falhar, será criada uma tarefa Handle errors com os dados de erro associados, incluindo informações resumidas e um diagrama do processo. As tarefas de ação atuais estão disponíveis na página Tasks Management, acessada pela opção Tasks do menu principal.

Sincronização agendada

Você também pode agendar a sincronização automática. Para isso, edite a instância PLM (na página principal PLM Integration, clique no nome dela ou no controle associado), selecione a guia Component Synchronisation e habilite a opção Synchronize PLM Components with server on schedule. Use os controles Synchronize every para configurar o agendamento da sincronização automática conforme necessário. O sistema é muito flexível e permite:

  • Configurar a sincronização agendada a cada 15/30/45/60/75/90 minutos.
  • Configurar a sincronização agendada a cada x horas.
  • Configurar a sincronização diária agendada para ser executada em um horário especificado.

O agendamento definido será exibido na página principal PLM Integration, na coluna Sync scheduled.

Configuração de um agendamento de sincronização.Configuração de um agendamento de sincronização.

Para configurar a sincronização agendada, é necessário fornecer credenciais de usuário válidas (do seu sistema PLM). As credenciais já devem ter sido registradas durante a configuração da instância PLM; caso contrário, clique no botão  e insira seu User name e sua Password na janela PLM Credentials exibida em seguida. Sem credenciais válidas, a sincronização agendada permanecerá desativada. A sincronização sob demanda também não será possível.

Você também pode executar o processo de sincronização sob demanda. Clique no botão  e escolha o modo de sincronização necessário:

  • Incremental – neste modo, only os componentes que foram modificados desde a última sincronização (ou seja, cujo registro de data e hora é posterior à data da última sincronização) e que atendem aos critérios de sincronização do arquivo de configuração serão incluídos na sincronização, com as alterações propagadas de acordo. Esse é o modo padrão e é o mesmo executado ao clicar no controle  de uma instância PLM na página principal PLM Integration.
  • Full – este modo força uma sincronização completa. Todos os componentes que atendem aos critérios de sincronização do arquivo de configuração serão incluídos na sincronização, com as alterações propagadas de acordo.

Fluxos de trabalho de processos

As seguintes definições de processo (e seus respectivos fluxos de trabalho) estão disponíveis no Workspace para dar suporte à integração com PLM:

Essas definições de processo não podem ser ativadas e usadas como estão. Portanto, cada uma delas funciona mais como um “modelo” – edite-a para atender aos requisitos da sua empresa, atribua um nome e salve-a como uma nova definição de processo, que você can então ativar e usar, juntamente com todas as outras definições do respectivo tema de processo.
  • Part Requests tema de processo:
    • Part Request with PLM Part Create – oferece suporte à criação automática de um componente na sua instância PLM e à posterior propagação do número de peça gerado para o componente do Workspace. O diagrama do fluxo de trabalho é mostrado abaixo.

Um ponto importante a observar é que, ao modificar essa definição de exemplo para criar a sua própria, você deve especificar a instância PLM na qual as peças serão criadas. Selecione a entidade Create Part in PLM no diagrama do fluxo de trabalho e escolha a instância PLM no menu suspenso associado ao campo PLM Instance. Esse menu lista todas as instâncias PLM atualmente definidas (conforme configuradas na página PLM Integration da interface).

► Consulte Criação e gerenciamento de processos para obter mais informações sobre como trabalhar com fluxos de trabalho de processos.

  • Project Activities tema de processo:
  • Publish to PLM (User selects) – publicação das saídas liberadas de projetos gerenciados na instância PLM integrada, permitindo que o usuário selecione exatamente quais saídas serão publicadas. O diagrama do fluxo de trabalho é mostrado abaixo.

  • Project Releaser with Publish – publicação na instância PLM integrada como uma etapa adicional do Project Releaser. O diagrama do fluxo de trabalho é mostrado abaixo.

  • Project Creations tema de processo:
    • Project with initialise in PLM – oferece suporte à criação automática de números de peça na sua instância PLM e à posterior propagação desses números como parâmetros do projeto de design do Workspace. O diagrama do fluxo de trabalho é mostrado abaixo.

Acesso a processos relacionados ao PLM

As seções a seguir destacam onde acessar os processos relacionados ao PLM que estão ativados. Como os exemplos não podem ser usados diretamente da forma como são fornecidos, os seguintes processos foram criados a partir deles para fins de ilustração:

  • PR with PLM Part Create – criado a partir da definição de processo de exemplo: Part Request with PLM Part Create.
  • Publish to Company PLM – Choose Data – criado a partir da definição de processo de exemplo: Publish to PLM (User selects).
  • Project Releaser with Publish to Company PLM – criado a partir da definição de processo de exemplo: Project Releaser with Publish.
  • Create Project with PLM Initialise – criado a partir da definição de processo de exemplo: Project with Initialise in PLM.
Observe que os administradores do Workspace podem iniciar uma nova instância de qualquer definição de processo ativada – diretamente na guia do tema de processo correspondente, na área Processes da interface do Workspace – clicando no controle  .

Solicitações de peças

Acesse pelo Altium Designer a partir do painel Explorer, após realizar uma pesquisa, no painel Details do painel Manufacturer Part Search, ou pelo link na parte inferior da lista de componentes no painel Components.

Na interface do Workspace, a definição de processo ativada pode ser acessada na página Part Requests, clicando no botão  no canto superior direito da página.

Atividades do projeto

Os dados de projeto liberados do Altium Designer para o Workspace podem ser propagados para o PLM de forma controlada com os processos de publicação no PLM do Workspace. Os processos do Workspace definem a interface e a metodologia da atividade de publicação, e o Modelo de Publicação XML especificado define como os dados dos arquivos são propagados para o sistema PLM de destino.

Consulte Publicação em um PLM para obter informações mais detalhadas sobre o processo de publicação.

Processo de publicação padrão

No ambiente de projeto, o processo padrão de publicação no PLM pode ser acessado no Altium Designer pelo submenu Project » Project Activities do projeto ativo.

Os processos relacionados ao projeto também estão disponíveis no submenu de contexto Project Activities, acessado clicando com o botão direito na entrada do projeto no painel Projects.

Na interface do Workspace, as definições de processo ativas podem ser acessadas na visualização Project Management, clicando no botão  .

Publicação com o Project Releaser

O processo de publicação em uma instância do PLM como parte do Project Releaser pode ser acessado no Altium Designer pelo submenu Project » Project Releaser do projeto ativo.

Os processos relacionados à liberação também estão disponíveis no submenu de contexto Project Releaser, acessado clicando com o botão direito na entrada do projeto no painel Projects.

O Project Releaser será exibido com uma etapa adicional — 7: Publish to PLM. Além disso, um comando está disponível no menu associado ao botão  — Prepare & Release & Publish to PLM — caso você queira executar o Project Releaser sem parar para revisar os dados gerados e o relatório de execução.

Se você executar o Project Releaser com o comando padrão Prepare , após revisar e liberar os dados, o botão  será apresentado na etapa Execution Report. Clique nele para continuar o fluxo de trabalho subjacente do processo e publicar no PLM. A caixa de diálogo Login Credentials será exibida. Insira o Username e a Password da sua instância do PLM e selecione o modelo de PLM que deseja usar (que aparece no formato <PLMInstance>:<PublishingTemplate>).

Se você optar por usar o comando Prepare & Release & Publish to PLM, a caixa de diálogo Login Credentials será apresentada diretamente ao final. O Project Releaser não será pausado na etapa Execution Report, e nenhum botão  será apresentado.
Observe que as credenciais de login da sua instância do PLM são necessárias apenas na primeira publicação nessa instância. Elas serão armazenadas no Workspace conectado. Depois disso, qualquer publicação desse projeto na mesma instância do PLM prosseguirá diretamente, de acordo com o fluxo de trabalho definido e o modelo de publicação escolhido.

Clique na guia Diagram para ver o fluxo de trabalho subjacente do processo.

Clique no botão  para prosseguir com o processo de publicação, de acordo com esse fluxo de trabalho.

Se você estiver publicando pela primeira vez e os números de peça (no lado do PLM) ainda não estiverem associados ao projeto gerenciado, esses números serão criados no PLM e associados ao projeto como parte dessa publicação inicial. Você também pode definir entradas de componentes para os componentes do Workspace na instância do PLM como parte da operação de publicação, para obter uma BOM de componentes no PLM (opcional, com base no modelo de publicação definido e usado ao publicar o projeto na instância do PLM).

Verifique o status do processo de publicação no PLM pela interface do Workspace, selecionando a visualização Activities na visualização detalhada desse projeto, quando o projeto tiver sido aberto pela visualização Projects. Selecione a opção de visualização Opened para ver o status enquanto o processo estiver em execução, e a opção de atividades Closed para acessar as informações de status quando o processo tiver sido concluído.

 

Você pode ver exatamente o que foi criado, como os números de peça na instância do PLM, na guia Data do fluxo de trabalho do processo.

Criação de projetos

No ambiente de projeto, acesse pelo submenu principal File » New » Project in <workspace> no Altium Designer.

Na interface do Workspace, a definição de processo ativada pode ser acessada na visualização Projects, clicando no botão  .

E também ao clonar um projeto, opção acessada pelo botão de menu  na visualização Projects.

O fluxo de trabalho do processo prosseguirá com uma caixa de diálogo que permite definir o projeto em termos de nome, descrição, tipo e qualquer Item de modelo de projeto que deva ser usado em sua criação. Após clicar em Start, a caixa de diálogo Login Credentials será exibida. Insira o Username e a Password da sua instância do PLM e selecione o modelo de PLM que deseja usar (que aparece no formato <PLMInstance>:<PublishingTemplate>). Em seguida, clique em Submit para prosseguir com o fluxo de trabalho.

Os números de peça pertinentes serão criados automaticamente para o projeto na sua instância do PLM e, em seguida, propagados de volta ao Workspace como parâmetros do projeto. Esses parâmetros estarão disponíveis para uso como strings especiais — acesse pelo painel Properties com uma string de texto posicionada selecionada no editor de projeto. Os parâmetros do servidor do Workspace definidos para o projeto também podem ser visualizados na guia Parâmetros do servidor da caixa de diálogo Project Options (Project » Project Options).

 

AI-LocalizedLocalizado por IA
Caso encontre um problema, selecione o texto/imagem e primaCtrl + Enterpara nos enviar o seu feedback.
Contents
Disponibilidade de Recursos

Os recursos disponíveis para você dependem de qual solução Altium você possui – Altium Develop, Altium Agile Teams, Altium Agile Enterprise ou Altium Designer (com assinatura ativa).

Se você não vir um recurso documentado no software que está usando no momento, entre em contato com a equipe de vendas da Altium para saber mais.

Contents