Configuração do Teamcenter PLM
Num relance
- Entenda quais são as licenças necessárias, a versão compatível do EDA Gateway e os recursos do Teamcenter.
- Saiba como configurar o cliente EDA, as configurações da biblioteca do Teamcenter e os mapeamentos de atributos de peças, com mapeamento opcional de classificação.
- Confira as etapas para preparar e iniciar o Hybrid Agent, testar a conexão com o Workspace e tentar uma sincronização de componentes em caráter experimental.
Como solução PLM local baseada em servidor, o Siemens Teamcenter® PLM deve se integrar a um Workspace do Altium 365 por meio do Hybrid Agent da Altium. O serviço Hybrid Agent é instalado na mesma rede que o servidor Teamcenter (como a LAN da sua empresa) e atua como um retransmissor seguro de dados entre o Teamcenter e seu Workspace do Altium 365. Configure a integração do Hybrid Agent após concluir a configuração do Teamcenter EDA Gateway, conforme descrito abaixo.
► Consulte Integração PLM do Hybrid Agent para obter mais informações.
Além da instalação do Hybrid Agent, a integração com o Siemens Teamcenter® PLM exige uma configuração adicional inicial que não é gerenciada automaticamente por uma instância de configuração do Teamcenter no Workspace. Essencialmente, são necessários dois níveis de configuração, dependendo dos recursos de integração desejados. O primeiro nível permite a sincronização de componentes e também é um pré-requisito para o segundo nível, que permite os processos PLM de publicação/inicialização de projetos. Ainda assim, recomenda-se realizar os dois níveis de configuração.
Sincronização de componentes com o Teamcenter
Para habilitar a sincronização de componentes da biblioteca, você precisa instalar o software Siemens Teamcenter® EDA (Electronic Design Automation) Gateway na máquina que hospeda o software Hybrid Agent — por conveniência, ela é chamada de máquina Agent/EDA neste documento. Este guia também pressupõe que o software Hybrid Agent e o servidor Teamcenter estejam instalados em máquinas separadas — recomendamos essa abordagem para garantir a separação entre as duas instalações, embora possam ser instalados na mesma máquina.
Instalação e configuração do Teamcenter EDA
Todo o procedimento de instalação e configuração do EDA Gateway é descrito em detalhes na documentação EDA Integration específica da versão, disponível no Centro de Suporte da Siemens. Siga essa documentação rigorosamente. As instruções aqui abrangem apenas diferenças em relação à documentação da Siemens ou especificam detalhes do lado da Altium que são mencionados como requisitos na documentação da Siemens.
Escolha uma versão do EDA Gateway compatível com a versão do seu servidor Teamcenter. Você deve encontrar informações de compatibilidade nos arquivos TcEDA<version>_README.pdf correspondentes do EDA Gateway disponíveis no centro de downloads ou, alternativamente, baixando o arquivo de dados EDA Integration Compatibility do centro de suporte da Siemens (exemplo de localização). Em seguida, consulte a documentação Instalação e configuração do EDA Gateway para aplicações ECAD (não Mentor) (o link de exemplo é para a versão 5.1 do EDA), no tópico Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications for part library management, para orientar a configuração:
Como parte da instalação e configuração da interface Workspace/Teamcenter, você também deve instalar (e licenciar etc., conforme necessário) os seguintes recursos do Teamcenter — consulte Configuração do EDA Gateway para aplicações ECAD:
- Extensões » Gerenciamento de processos mecatrônicos » Suporte ao servidor EDA
- Extensões » Gerenciamento de processos mecatrônicos » EMPS-Foundation
- Extensões » Gerenciamento de processos mecatrônicos » Gerenciamento de bibliotecas ECAD
- Extensões » Gerenciamento de processos mecatrônicos » EDA para Business Modeler IDE
- Extensões » Gerenciamento de relacionamento com fornecedores » Gerenciamento de fornecedores
- Instalação básica » Active Workspace » Extensões do servidor » Suporte ao servidor EDA para Active Workspace
- Instalação básica » Active Workspace » Cliente » Automação de projeto eletrônico para Active Workspace
Além disso, execute Instalação e configuração dos Serviços de Integração Comuns para oferecer suporte à publicação de projetos.
Em seguida, siga as etapas e instale o EDA Gateway na máquina Agent/EDA.
Configurar o EDA Gateway para gerenciamento de bibliotecas de componentes
Assim como acima, para esta seção você também deve consultar a documentação Instalação e configuração do EDA Gateway para aplicações ECAD (não Mentor) (o link de exemplo é para a versão 5.1 do EDA), no tópico Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications for part library management.
Consulte novamente este conjunto de instruções ao chegar a capítulos específicos da documentação do Teamcenter. As seções abaixo fazem referência a esses capítulos pelo nome.
Capítulo: 'Configure the EDA client for part library management
Durante essa etapa, será solicitado que você prepare um library gateway configuration file — em vez disso, use um fornecido pela Altium. Você pode baixá-lo com um pacote de arquivos de configuração na interface do navegador do Workspace do Altium 365: abra Admin » PLM Integration, use o botão Add Configuration para abrir a visualização Add New Instance, escolha Teamcenter EDA no menu suspenso Driver e selecione o link Download Teamcenter EDA client definition files associado ao campo URL — veja o exemplo.
Dentro do arquivo ZIP baixado, haverá dois arquivos XML: altiumLibrary_edadef.xml e altiumPcb_edadef.xml. Copie/mova esses arquivos para o diretório indicado pela variável de ambiente do sistema: %TCEDAECAD_ROOT%.
Setting the User name — Você precisará definir o nome de usuário do cliente EDA como aquele que será usado para executar os programas Hybrid Agent e Teamcenter EDA. Para isso, defina a propriedade User= no arquivo %USERPROFILE%\Teamcenter\EDA\TCEDAClient.properties com o nome de usuário do Teamcenter que será usado para a sincronização de componentes. Se isso não for especificado, ocorrerá um tempo limite excedido e um erro de ID/senha ao tentar usar o Hybrid Agent. Observe que o nome de usuário fornecido na interface do Workspace será ignorado e, em vez dele, será usado o nome de usuário do arquivo de propriedades. Reinicie o sistema após essa alteração.
Running the Hybrid Agent as a Windows service — Se você planeja iniciar o Hybrid Agent dessa forma (ou seja, não no terminal), o usuário do Windows em questão provavelmente será o usuário System , a menos que seja configurado de outra forma, e seu arquivo TCEDAClient.properties estará em %SystemRoot%\System32\config\systemprofile\Teamcenter\EDA\TCEDAClient.properties. Consulte Hybrid Agent como um serviço do Windows.
Verifique o arquivo de log do TC EDA no nível INFO para confirmar se as alterações acima estão em vigor (veja o exemplo) quando você executar Testar conexão na configuração PLM posteriormente.
Capítulo: 'Setting up Teamcenter server for part library management'
Abra Teamcenter Rich Client como o usuário infodba ou como outro usuário com privilégios de administração.
► Consulte as informações sobre o Teamcenter Rich Client.
As capturas de tela abaixo ilustram as etapas descritas em Criar aplicações externas para sua ferramenta ECAD no Teamcenter. No nosso caso, adicionaremos altiumLibrary,15 à preferência EDALIB_External_Applications:
Clique no comando
para adicionar o novo valor, seguido de Save, e feche a preferência. Saia e entre novamente no Teamcenter Rich client.
- Abra a aplicação Organization.
-
Navegue até a seção External Applications e adicione uma aplicação
altiumLibraryconforme mostrado abaixo:
- Selecione Create.
Capítulo: 'Mapping ECAD part attributes to Teamcenter attributes'
No prompt de comando do Teamcenter, execute o utilitário export_attr_mappings para exportar o mapeamento para um arquivo, por exemplo:
export_attr_mappings.exe -file=mappings.txt -u=infodba -p=infodba
Modifique o arquivo mappings.txt de acordo com seus requisitos para mapear os atributos reais do Teamcenter nos componentes. Um exemplo de mapeamento funcional, adicionado ao conteúdo do arquivo mappings.txt exportado:
{ Item type="EDAComPart"
Cost : Item.GRM(IMAN_master_form).object_desc /description="Cost"
Tolerance : ItemRevision.GRM(IMAN_master_form).object_desc /description="Tolerance"}
Após concluir o mapeamento, importe-o de volta para o Teamcenter:
import_attr_mappings.exe -file=mappings.txt -u=infodba -p=infodba
Para solucionar problemas de mapeamento de atributos, você pode ativar logs detalhados incluindo a linha rootLogger.level= DEBUG in the C:\Program Files\Siemens\TeamcenterEDA2\eda\log4j2.properties file.
Os logs de execução do Teamcenter EDA podem ser encontrados em C:\Windows\TEMP\eis_eda_log.log.
Capítulo: 'Creating classification mapping for ECAD parts with Teamcenter classes' (opcional)
O mapeamento de classificação é um requisito de configuração opcional e pode não ser utilizado ou necessário na sua instalação do Teamcenter PLM. Observe que, para usar atributos de classificação, eles precisam ser incluídos na configuração/no arquivo de mapeamento de atributos ao concluir a seção 'Mapping ECAD part attributes to Teamcenter attributes' anterior.
Antes de iniciar esta etapa de configuração, certifique-se de que a funcionalidade de classificação esteja habilitada. Em seguida, siga as instruções para configurar o mapeamento de classificação.
Certifique-se de que _eda2tc.csv tenha as colunas na ordem category,classId and _tc2eda.csv tenha as colunas na ordem classId,category. Se necessário, troque os nomes dos arquivos.
Para usar atributos de classificação, você precisa incluí-los no mapeamento de atributos. Um exemplo de mapeamento de atributos de classificação é:
"SMT attribute" : ItemRevision.ICS(-60262) /description="SMT"
O número -60262 pode ser encontrado com a ferramenta Classification Admin no Teamcenter.
Configurar o Hybrid Agent
Antes que seja possível sincronizar com o Workspace do Altium 365, é necessário criar uma biblioteca com o comando eda_cli.bat (localizado no diretório de %TCEDAECAD_ROOT% na máquina do Agent/EDA) e também garantir que os arquivos criados estejam acessíveis ao Hybrid Agent:
edacli.bat -configureLibrary -application altiumLibrary -status %userprofile%\status.xml
Além disso, defina as variáveis de ambiente JAVA_HOME ou TCEDA_JAVA_HOME com o caminho do JDK usado pelo Teamcenter EDA (edacli.bat). Consulte a documentação do Teamcenter EDA para obter mais detalhes sobre a configuração do ambiente Java para o Teamcenter EDA.
Nesta etapa, você pode instalar o Hybrid Agent na máquina do Agent/EDA, conforme detalhado na página Integração PLM do Hybrid Agent. Para iniciar o Hybrid Agent, use o arquivo agent-tceda.bat em vez de agent.bat.
Informações adicionais sobre a sincronização de peças da biblioteca:
-
Synchronization of Released/Unreleased Teamcenter parts – Por padrão, somente os componentes marcados com
release_status_list.name = ‘TCM Released’serão sincronizados do Teamcenter para o Altium. Isso pode ser alterado no Query Builder do Teamcenter, modificando a consulta usada pelo Teamcenter para selecionar componentes (veja o exemplo).
O nome da consulta é armazenado na preferência EDALIB_Sync_FindNewParts. A consulta padrão é __EDALIB_find_newparts e é mostrada abaixo.
A última condição pode ser removida para sincronizar componentes que ainda não estejam “TCM Released”.
► Consulte a documentação relacionada do Siemens Teamcenter para obter mais informações.
- Multisite synchronization – Também é possível usar o Teamcenter como fonte de informações de componentes para vários sites (sendo um deles o Workspace do Altium 365). Observe que isso exige uma configuração especial, descrita na documentação.
- Unit-of-measure parameter synchronization – A integração do Workspace com o Teamcenter oferece suporte ao mapeamento de parâmetros com reconhecimento de unidades por meio das colunas de dados adicionais Data Type e SiPrefix na tabela de mapeamento de parâmetros de componentes da interface do usuário. Use as opções do menu suspenso de uma entrada para selecionar um tipo de dado adequado (veja as opções) e um prefixo de unidade (veja as opções).
-
Destination folder for parts – A pasta de destino das peças sincronizadas do Altium para o Teamcenter pode ser definida por site/usuário pela preferência EDALIB_SaveAsFolderDefault do Teamcenter.
-
Current Part Synchronization limitations:
- Os números de peça do PLM são gerados apenas no lado do Workspace do Altium.
-
A pasta de destino dos componentes não pode ser especificada no arquivo de configuração — há uma configuração global no lado do Teamcenter. Uma configuração de pasta de destino no arquivo de configuração XML do PLM (
dm-config.xml) será ignorada sem aviso. A pasta de destino é obtida no nível de usuário do Teamcenter ou na opção de nível de site EDALIB_SaveAsFolderDefault para todos os tipos de componentes. - Não há suporte a opções de peças nativas (Lista de fabricantes/fornecedores aprovados, ou AML/AVL). Como antes, somente opções de peças baseadas em parâmetros de componentes são compatíveis.
Publicação de projetos com o Teamcenter EDA
A publicação de projetos do Altium no Teamcenter só é possível por meio do Altium Designer. Para habilitar a publicação de projetos, você precisa instalar o Teamcenter EDA (Electronic Design Automation) Gateway na máquina em que o Altium Designer está instalado. Você também precisará de acesso às configurações do Workspace do Altium 365 e do servidor Teamcenter.
O procedimento de instalação e configuração do EDA Gateway é descrito em detalhes na documentação EDA Integration específica da versão, disponível no Centro de suporte da Siemens. Siga essa documentação rigorosamente. As instruções aqui abrangem apenas as diferenças em relação à documentação da Siemens ou especificam detalhes do lado do Altium mencionados como requisitos na documentação da Siemens.
Escolha uma versão do EDA Gateway compatível com a versão do seu servidor Teamcenter — você deverá encontrar informações de compatibilidade nos arquivos TcEDA<version>_README.pdf correspondentes do Gateway, disponíveis no centro de downloads. Em seguida, consulte a documentação Instalação e configuração do EDA Gateway para aplicações ECAD (não Mentor) (o link de exemplo é para a versão 5.1 do EDA), no tópico Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications for design management, para orientar a configuração:
A pasta de destino dos projetos pode ser definida pelas opções de site/usuário: EDA_SaveAsFolderDefault.
Setting the User name – Você precisará definir o nome de usuário do cliente EDA configurando a propriedade User= no arquivo %USERPROFILE%\Teamcenter\EDA\TCEDAClient.properties com o nome do usuário do Altium Designer que realizará a Publicação de projetos.
Configuração do Business Modeler IDE (BMIDE) para conjuntos de dados derivados
Após criar uma configuração de dados derivados (consulte as referências no arquivo altiumPcb_edadef.xml ), você pode especificar o nome da configuração na preferência EDA_DerivedDataConfigDefault.
- No BMIDE, abra a pasta Extensions.
- Na pasta Extensions, clique com o botão direito do mouse em EDA Derived Data e escolha New EDA Derived Data. O assistente New EDA Derived Data será exibido.
- Na caixa de diálogo EDA Derived Data, insira as informações e clique em Next.
- Para o conjunto de dados derivados de PCB, adicione uma nova entrada em ‘Configure datasets’.
Caminho: $TEMP\Altium\TcEda\Project\pcb\*.*
- Para o conjunto de dados derivados de esquemáticos, adicione uma nova entrada em ‘Configure datasets’.
Caminho: $TEMP\Altium\TcEda\Project\schematic\*.*
- Outro conjunto de dados derivados para conjuntos de dados de variantes:
Caminho: $TEMP\Altium\TcEda\Project\$VARIANT\pcb\*.*
- Para salvar as alterações no modelo de dados, escolha File » Save Data Model ou clique no botão Save Data Model na barra de ferramentas principal.
- Implante suas alterações no servidor de teste. Escolha Deploy Template na barra de menus ou selecione o projeto e clique no botão Deploy Template na barra de ferramentas principal.
- No Rich Client, defina a preferência EDA_DerivedDataConfigDefault para apontar para a configuração de dados derivados de EDA que você acabou de criar.
- Escolha Edit » Options, clique no link de pesquisa na parte inferior da caixa de diálogo Options, localize a preferência EDA_DerivedDataConfigDefault e altere seu valor para a nova configuração.
Informações adicionais sobre a publicação de projetos
Current Project Publishing Limitations:
- O Siemens EDA Gateway não oferece suporte à referência a revisões específicas de componentes ('BOM precisa').
- Atualmente, não há suporte a ECO.






