Configuração para o Teamcenter PLM

Parent page: Integração PLM

A integração PLM com o Siemens Teamcenter® requer configuração adicional que não é gerida automaticamente pelo instalador da instância do Enterprise Server. Essencialmente, são necessários dois níveis de configuração, dependendo das funcionalidades de integração pretendidas. O primeiro nível ativa a Sincronização de Peças e é também um pré-requisito para o segundo nível, que ativa os processos PLM de Publicação/Inicialização de Projeto. Ainda assim, recomenda-se a realização de ambos os níveis de configuração.

Sincronização de Peças com o Teamcenter

Para ativar a sincronização de peças de biblioteca, é necessário instalar o software Siemens Teamcenter^® EDA (Electronic Design Automation) Gateway na máquina que aloja o Enterprise Server. Este documento assume que o Enterprise Server e o servidor Teamcenter já estão instalados em máquinas separadas – recomendamos esta 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 está descrito em detalhe na EDA Integrationdocumentação específica da versão, disponível no Siemens Support Center. Siga essa documentação cuidadosamente. As instruções aqui apresentadas abrangem apenas desvios em relação à documentação da Siemens, ou especificam detalhes do lado da Altium que são referidos como requisitos na documentação da Siemens.

Escolha uma versão do EDA Gateway que suporte a versão do seu servidor Teamcenter – deverá encontrar informações de compatibilidade nos ficheiros TcEDA<version>_README.pdf correspondentes do Gateway, disponíveis no centro de transferências. Deverá depois consultar a documentação Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications (o link de exemplo é para a versão EDA 5.1), no tópico Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications for part library management, para o orientar durante a configuração:

Como parte da instalação e configuração da interface Enterprise Server/Teamcenter, deverá também instalar (e licenciar, etc., conforme necessário) as seguintes funcionalidades do Teamcenter – consulte Setting up EDA Gateway for ECAD applications:

• Extensions » Mechatronics Process Management » EDA Server Support
• Extensions » Mechatronics Process Management » EMPS-Foundation
• Extensions » Mechatronics Process Management » ECAD Library Management
• Extensions » Mechatronics Process Management » EDA for Business Modeler IDE
• Extensions » Supplier Relationship Management » Vendor Management
• Base Install » Active Workspace » Server Extensions » EDA Server Support for Active Workspace
• Base Install » Active Workspace » Client » Electronic Design Automation for Active Workspace

Além disso, execute Install and set up Common Integration Services para suportar a Publicação de Design.

De seguida, siga os passos e instale o EDA Gateway CLIENT na máquina do Enterprise Server. Para simplificar o processo, sugerimos a utilização da pasta C:\Siemens\TeamcenterEDA2.

Configurar o EDA Gateway para Gestão da Biblioteca de Peças

Tal como acima, para esta secção deverá também consultar a documentação Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications (o link de exemplo é para a versão EDA 5.1), no tópico Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications for part library management.

Consulte novamente este conjunto de instruções quando chegar a capítulos específicos na documentação do Teamcenter. As secções abaixo referem esses capítulos pelo nome.

Capítulo: 'Configure the EDA client for part library management'

Durante esse passo ser-lhe-á pedido que prepare um library gateway configuration file – em vez disso, utilize um fornecido pela Altium. Pode transferi-lo num pacote de ficheiros de configuração a partir da interface de navegador do Workspace do Enterprise Server: abra Admin » PLM Integration, utilize o botão Add Configuration para abrir a vista Add New Instance, escolha Teamcenter EDA no menu pendente Driver e, em seguida, selecione a ligação Download Teamcenter EDA client definition files associada ao campo URL – ver exemplo.

Dentro do ficheiro transferido PLMClientConfigurationFiles.zip existirá um ficheiro altiumLibrary_edadef.xml – coloque este ficheiro no diretório indicado pela variável de ambiente do sistema: %TCEDAECAD_ROOT%. Adicione também o ficheiro fornecido altiumPcb_edadef.xml a esse diretório.

Capítulo: 'Setting up Teamcenter server for part library management'

Abra Teamcenter Rich Client como utilizador infodba, ou como outro utilizador com privilégios de administração.
► Ver informações sobre o Teamcenter Rich Client.

As capturas de ecrã abaixo ilustram os passos descritos em Create external applications for your ECAD tool in Teamcenter. No nosso caso, iremos adicionar altiumLibrary,15 à preferência EDALIB_External_Applications:

Clique no comando para adicionar o novo valor, seguido de Save, e depois feche a preferência. Termine a sessão e volte a iniciar sessão no Teamcenter Rich client.

• Abra a aplicação Organization.
• Navegue até à secção External Applications e adicione uma aplicação altiumLibrary, conforme mostrado abaixo:

• Selecione Create.

Capítulo: 'Mapping ECAD part attributes to Teamcenter attributes'

Através da linha de comandos do Teamcenter, execute o utilitário export_attr_mappings para exportar o mapeamento para um ficheiro, por exemplo:

export_attr_mappings.exe -file=mappings.txt -u=infodba -p=infodba

Modifique o ficheiro mappings.txt de acordo com os seus requisitos para mapear atributos reais do Teamcenter nos componentes. Um exemplo de mapeamento funcional, adicionado ao conteúdo de 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"}

Depois de concluir o mapeamento, importe-o novamente para o Teamcenter:

import_attr_mappings.exe -file=mappings.txt -u=infodba -p=infodba

Para diagnosticar problemas de mapeamento de atributos, pode ativar registos detalhados incluindo a linha rootLogger.level= DEBUG no ficheiro C:\Program Files\Siemens\TeamcenterEDA2\eda\log4j2.properties.

Os registos da 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 usado nem necessário para a sua instalação PLM do Teamcenter. Tenha em atenção que, para utilizar atributos de classificação, estes têm de ser incluídos na configuração/ficheiro de mapeamento de atributos ao concluir a secção 'Mapping ECAD part attributes to Teamcenter attributes' anterior.

Antes de iniciar esta fase de configuração, certifique-se de que tem a funcionalidade de classificação ativada. Depois, siga as instruções para configurar o mapeamento de classificação.

Certifique-se de que _eda2tc.csv tem colunas pela ordem category,classId e de que _tc2eda.csv tem colunas pela ordem classId,category. Se necessário, troque os nomes dos ficheiros.

Para utilizar atributos de classificação, é necessário incluí-los no mapeamento de atributos. Um exemplo de mapeamento de atributos de classificação é:

"SMT attribute" : ItemRevision.ICS(-60262) /description="SMT"

Onde o número -60262 pode ser encontrado com a ferramenta Classification Admin no Teamcenter.

Mapeamento de classificação no Enterprise Server

A informação de classificação pode ser enviada com um atributo especial Classification incluído no seu ficheiro de configuração XML do PLM (typically dm-config.xml ou semelhante). Por exemplo:

<common:Attribute>
    <common:Key>Classification</common:Key>
    <common:Value>${parameter.Classification}</common:Value>
</common:Attribute>

O valor deste atributo deve ser um caminho separado por vírgulas na árvore de classificação, por exemplo: “Components,SMT,Capacitor”.

De forma semelhante, os atributos de classificação podem ser referenciados pelo nome que foi configurado no mapeamento de atributos no servidor Teamcenter, por exemplo:

<common:Attribute>
    <common:Key>SMT attribute</common:Key>
    <common:Value>smt attr value</common:Value>
</common:Attribute>

Definir Biblioteca no Enterprise Server

Antes de ser possível a sincronização com o Enterprise Server, é necessário criar uma biblioteca com o comando eda_cli.bat (localizado no diretório de %TCEDAECAD_ROOT% na máquina do Enterprise Server), e também garantir que os ficheiros criados estão acessíveis ao Enterprise Server:

edacli.bat -configureLibrary -application altiumLibrary -status %userprofile%\status.xml

Nesta fase, já deverá ser possível executar um processo Component Sync do Enterprise Server e um processo Part Request with PLM Part Create do Enterprise Server.

Informações adicionais sobre a sincronização de peças de biblioteca:

• Synchronization of Released/Unreleased Teamcenter parts – Por predefinição, apenas os componentes marcados com release_status_list.name = ‘TCM Released’ serão sincronizados do Teamcenter para a Altium. Isto pode ser alterado no Teamcenter Query Builder, modificando a consulta utilizada pelo Teamcenter para selecionar componentes (ver exemplo).

O nome da consulta é armazenado na preferência EDALIB_Sync_FindNewParts. A consulta predefinida é __EDALIB_find_newparts e é apresentada 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 mais informações.

• Multisite synchronization – Também é possível utilizar o Teamcenter como fonte de informação de componentes para vários sites (sendo um deles o Enterprise Server). Tenha em atenção que isto requer uma configuração especial, descrita na documentação.
• Destination folder for parts – A pasta de destino para peças sincronizadas do Altium para o Teamcenter pode ser definida por site/utilizador através da preferência EDALIB_SaveAsFolderDefault do Teamcenter.
• Current Part Synchronization limitations:
  • Os números de peça PLM são gerados apenas no lado do Enterprise Server.
  • A pasta de destino não pode ser especificada para componentes no ficheiro de configuração – existe uma definição global do lado do Teamcenter. Uma definição de pasta de destino no ficheiro de Configuração XML do PLM (dm-config.xml) será ignorada sem aviso. A pasta de destino é obtida a partir da opção ao nível do utilizador do Teamcenter, ou da opção ao nível do site EDALIB_SaveAsFolderDefault para todos os tipos de componentes.
  • As opções de peça nativas (Approved Manufacturer/Vendor List, ou AML/AVL) não são suportadas. Tal como anteriormente, apenas são suportadas opções de peça baseadas em parâmetros de componente.

Publicação de Designs com Teamcenter EDA

A publicação de designs do Altium para o Teamcenter só é possível através do Altium Designer. Para ativar a publicação de designs, tem de instalar o Teamcenter EDA (Electronic Design Automation) Gateway na máquina onde o Altium Designer está instalado. Também precisará de acesso tanto ao Enterprise Server como ao servidor Teamcenter.

O procedimento de instalação e configuração do EDA Gateway é descrito detalhadamente na EDA Integration documentação específica da versão disponível no Siemens Support Center. Siga essa documentação atentamente. As instruções aqui abrangem apenas desvios relativamente à documentação da Siemens, ou especificam detalhes do lado do Altium que são referidos como requisitos na documentação da Siemens.

Escolha uma versão do EDA Gateway que suporte a versão do seu servidor Teamcenter – deverá encontrar informação de compatibilidade nos ficheiros TcEDA<version>_README.pdf correspondentes do Gateway disponíveis no centro de transferências. Depois, deverá consultar a documentação Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications (o link de exemplo é para a versão EDA 5.1), sobre o tópico Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications for design management para o orientar ao longo da configuração:

Se a criação de componentes durante a publicação do projeto tiver de ser suportada, então parte da configuração da biblioteca tem de ser realizada no servidor. Isto aplica-se à estratégia de secção predefinida <pt:BomStrategy>CreateNewAndLink</pt:BomStrategy> no modelo de publicação.

A pasta de destino para designs pode ser definida pelas opções de site/utilizador: EDA_SaveAsFolderDefault.

Mapeamento de atributos de linhas de BOM

Os atributos Reference Designator e Quantity da linha de BOM são tratados automaticamente, mas têm de ser incluídos na secção <BOM> do ficheiro de Configuração XML do conector PLM:

<BOM>
    <BOMAttributes>
        <!-- O atributo "Reference Designator" é obrigatório para o conector Teamcenter EDA -->
        <common:BOMAttribute>
        <common:Key>Reference Designator</common:Key>
        <common:Value>${parameter.LogicalDesignator}</common:Value>
        </common:BOMAttribute>
        <!-- O atributo "Quantity" é obrigatório para o conector Teamcenter EDA -->
        <common:BOMAttribute>
        <common:Key>Quantity</common:Key>
        <common:Value>${parameter.Quantity}</common:Value>
        </common:BOMAttribute>
    </BOMAttributes>
</BOM>

Para utilizar outros atributos de linha de BOM, é necessário incluí-los na secção de mapeamento de atributos de linha de BOM do ficheiro altiumPcb_edadef.xml. Por exemplo, a entrada abaixo adiciona o mapeamento do atributo do Altium part_source para o atributo de linha de BOM do Teamcenter bl_part_source:

<RdnAttrMapDefs>
    <RdnAttrDesign cadAttrName="part_source" tcAttrName="bl_part_source"/>
</RdnAttrMapDefs>

Quando este tipo de mapeamento é adicionado, é possível definir o seu valor na secção <BOMAttributes> do ficheiro de Configuração XML do conector PLM:

<!-- Pode adicionar quaisquer outros atributos personalizados, mas estes têm de ser mapeados para o atributo Teamcenter no ficheiro altiumPcb_edadef.xml -->
<common:BOMAttribute>
    <common:Key>part_source</common:Key>
    <common:Value>${parameter.MakeOrBuy}</common:Value>
</common:BOMAttribute>

Configuração para Publicação de Peças Alternativas da BOM

O ActiveBOM do Altium Designer suporta a adição de peças alternativas a itens da BOM (saiba mais). Para suportar essas peças alternativas ao publicar um design para o PLM Teamcenter , tem de ser realizada uma configuração adicional do Teamcenter EDA, conforme descrito abaixo (na terminologia do Teamcenter, estes componentes alternativos no âmbito de uma BOM específica são designados por componentes substitutos). Isto ativará callbacks do Altium com lógica de transferência de substitutos.

1. Localize o ficheiro soa_client.zip nos ficheiros de instalação da versão do servidor Teamcenter que utiliza atualmente.

2. Localize os seguintes ficheiros dentro deste ficheiro zip:

   soa_client\java\libs\TcSoaStructureManagementStrong*.jar

   soa_client\java\libs\TcSoaBomStrong*.jar

3. Copie estes dois ficheiros para o diretório %TCEDAECAD_ROOT% no PC que aloja o Teamcenter EDA Gateway e o Altium Designer.

4. Abra o ficheiro %TCEDAECAD_ROOT%\setup_eda.bat e localize as seguintes linhas:

   
   rem
   rem Adicionar callbacks do cliente
   rem
   if exist CustomEDACallbacks.jar (
   	SET EDA_CP=%EDA_CP%;CustomEDACallbacks.jar
   )
   

5. Adicione as seguintes linhas por baixo:

   
   rem Adicionado para suporte do Altium a substitutos de BOM
   set EDA_CP=%EDA_CP%;TcSoaStructureManagementStrong_14000.3.0.jar
   set EDA_CP=%EDA_CP%;TcSoaBomStrong_14000.3.0.jar
   

   Preste atenção ao número da versão (isto é, 14000.3.0 no exemplo acima). Tem de corresponder ao número da versão incluído no nome do ficheiro que foi copiado no passo anterior.

6. Abra o ficheiro %TCEDAECAD_ROOT%\altiumPcb_edadef.xml. Adicione as seguintes entradas <callback …/> dentro da secção <CallbackDefs> (já existente no ficheiro):

   
   <callback type="java" operation="preSave" command="com.altium.eis.teamcenter.eda.callback.SubstituteCallbacks:checkSubstitutes"/>
   <callback type="java" operation="preSaveAs" command="com.altium.eis.teamcenter.eda.callback.SubstituteCallbacks:checkSubstitutes"/>
   <callback type="java" operation="postSave" command="com.altium.eis.teamcenter.eda.callback.SubstituteCallbacks:updateSubstitutes"/>
   <callback type="java" operation="postSaveAs" command="com.altium.eis.teamcenter.eda.callback.SubstituteCallbacks:updateSubstitutes"/>
   

   As entradas acima já estão presentes no ficheiro altiumPcb_edadef.xml, num comentário multilinha dentro da secção <CallbackDefs>. Pode mover estas entradas para fora do comentário (por exemplo, movendo-as logo abaixo da parte --> nesta secção).
7. Reinicie o PC para garantir que o Teamcenter EDA carrega as novas bibliotecas.

Notes:

• O Teamcenter EDA tem de estar configurado para ser executado em Java 11.
• Se utilizar o Teamcenter 13, certifique-se de que utiliza versões das bibliotecas adicionais da sua instalação do Teamcenter 13.
• Certifique-se de que atualiza os ficheiros CustomEDACallbacks.jar e altiumPcb_edadef.xml no diretório %TCEDAECAD_ROOT%.
• No Altium Designer, todas as variantes de design partilham o mesmo conjunto de substitutos, ou seja, não é possível ter substitutos diferentes definidos para o mesmo item de BOM entre variantes.
• A lista de componentes substitutos no Teamcenter é uma lista de revisões de componentes. As entradas de componentes substitutos não criam linhas de BOM e não podem ter propriedades de linha de BOM atribuídas. No Altium Designer, é possível ter uma coluna de BOM com um valor diferente para substitutos, mas apenas as propriedades do componente base serão transferidas para as propriedades da linha de BOM do Teamcenter.
• Se um projeto com substitutos na BOM tiver sido publicado no Teamcenter e, depois, um substituto da BOM do projeto tiver sido removido e o projeto tiver sido publicado novamente, o substituto também será removido da BOM no Teamcenter.
• Se um projeto com substitutos na BOM tiver sido publicado no Teamcenter e depois a BOM tiver sido modificada manualmente no Teamcenter, a BOM no Teamcenter será substituída na publicação seguinte deste projeto, ou seja, as alterações feitas manualmente serão perdidas.

• Os componentes utilizados como substitutos no ActiveBOM têm de ser sincronizados com o Teamcenter. Esta condição é verificada pelo callback preSave. Se existirem componentes que não tenham sido sincronizados com o Teamcenter, será apresentada uma mensagem de erro e a operação será abortada, pelo que não serão feitas alterações no Teamcenter.

Configuração do Business Modeler IDE (BMIDE) para datasets derivados

Depois de criar uma configuração de dados derivados (consulte as referências no ficheiro altiumPcb_edadef.xml), 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 rato em EDA Derived Data e escolha New EDA Derived Data. É apresentado o assistente New EDA Derived Data.

Na caixa de diálogo EDA Derived Data, introduza as informações e clique em Next.

Para o conjunto de dados PCB derivado, adicione uma nova entrada em “Configure datasets”.

Caminho: $TEMP\Altium\TcEda\Project\pcb\*.*

5. Para o conjunto de dados esquemático derivado, adicione uma nova entrada em “Configure datasets”.

Caminho: $TEMP\Altium\TcEda\Project\schematic\*.*

6. Outro conjunto de dados derivado para conjuntos de dados de Variants:

Caminho: $TEMP\Altium\TcEda\Project\$VARIANT\pcb\*.*

7. Para guardar as alterações ao modelo de dados, escolha File » Save Data Model ou clique no botão Save Data Model na barra de ferramentas principal.
8. Implemente as suas alterações no servidor de teste. Escolha Deploy Template na barra de menus ou selecione o projeto e, em seguida, clique no botão Deploy Template na barra de ferramentas principal.
9. No Rich Client, defina a preferência EDA_DerivedDataConfigDefault para apontar para a configuração de dados derivados EDA que acabou de criar.
10. Escolha Edit » Options, clique na ligação Search na parte inferior da caixa de diálogo Options, localize a preferência EDA_DerivedDataConfigDefault e altere o respetivo valor para a nova configuração.

Informações adicionais sobre publicação de designs

Current Project Publishing Limitations:

• A referenciação de revisões específicas de componentes (“Precise BOM”) não é suportada pelo Siemens EDA Gateway.
• Atualmente, o ECO não é suportado.