Configuração para o Teamcenter PLM

Parent page: Integração PLM

A integração PLM com Siemens Teamcenter® requer uma 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, consoante as 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 Projetos. 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 da 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 também 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 detalhadamente na EDA Integrationdocumentação disponível no Siemens Support Center, específica para cada versão. Siga cuidadosamente essa documentação. As instruções aqui apenas abrangem desvios relativamente à 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. De seguida, deverá consultar a documentação Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications (a ligação 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 ao longo da configuração:

Como parte da instalação e configuração da interface Enterprise Server/Teamcenter, tem também de 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.

Em seguida, siga os passos e instale o CLIENT EDA Gateway 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 (a ligação 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 da documentação do Teamcenter. As secções abaixo referem-se a 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 juntamente com um 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.

No ficheiro PLMClientConfigurationFiles.zip transferido 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 altiumPcb_edadef.xml fornecido a esse diretório.

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

Abra o Teamcenter Rich Client como utilizador infodba, ou como outro utilizador com privilégios de administração.
► Veja as 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 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, como 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 do 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 concluído 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 utilizado nem necessário na sua instalação PLM do Teamcenter. Note 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 a funcionalidade de classificação está ativada. Em seguida, siga as instruções para configurar o mapeamento de classificação.

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

Para utilizar atributos de classificação, tem de os incluir 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”.

Da mesma forma, 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 a sincronização ser possível 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: 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ção adicional sobre sincronização de peças da 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 é 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 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). Note que isto requer uma configuração especial, descrita na documentação.
• Unit-of-measure parameter synchronization – A integração do Workspace com o Teamcenter suporta o mapeamento de parâmetros com reconhecimento de unidades através das colunas de dados adicionais Data Type e SiPrefix na tabela Component Parameter Mapping da interface do utilizador. Utilize as opções do menu pendente de uma entrada para selecionar um tipo de dados adequado (ver opções) e o prefixo de unidade (ver opções).

• 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 no lado do Teamcenter. Uma definição de pasta de destino no ficheiro PLM XML Configuration (dm-config.xml) será ignorada sem aviso. A pasta de destino é obtida a partir da opção de nível de utilizador do Teamcenter, ou da opção de nível de site EDALIB_SaveAsFolderDefault para todos os tipos de componentes.
  • As escolhas de peças nativas (Approved Manufacturer/Vendor List, ou AML/AVL) não são suportadas. Como anteriormente, apenas são suportadas escolhas de peças baseadas em parâmetros de componentes.

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, é necessário instalar o Teamcenter EDA (Electronic Design Automation) Gateway na máquina onde o Altium Designer está instalado. Também será necessário ter acesso ao Enterprise Server e ao servidor Teamcenter.

O procedimento de instalação e configuração do EDA Gateway é 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 apenas cobrem 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ções 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 (a ligação de exemplo é para a versão EDA 5.1), no tópico Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications for design management, para o orientar durante a configuração:

Se for necessário suportar a criação de componentes durante a publicação do projeto, então parte da configuração da biblioteca terá de ser efetuada 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 BOM

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

<BOM>
    <BOMAttributes>
        <!-- "Reference Designator" attribute is mandatory for Teamcenter EDA connector -->
        <common:BOMAttribute>
        <common:Key>Reference Designator</common:Key>
        <common:Value>${parameter.LogicalDesignator}</common:Value>
        </common:BOMAttribute>
        <!-- "Quantity" attribute is mandatory for Teamcenter EDA connector -->
        <common:BOMAttribute>
        <common:Key>Quantity</common:Key>
        <common:Value>${parameter.Quantity}</common:Value>
        </common:BOMAttribute>
    </BOMAttributes>
</BOM>

Para utilizar outros atributos de linha BOM, é necessário incluí-los na secção de mapeamento de atributos de linha 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 BOM do Teamcenter bl_part_source:

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

Quando esse mapeamento é adicionado, é possível definir o respetivo valor na secção <BOMAttributes> do ficheiro XML Configuration do conector PLM:

<!-- You can add any other custom attributes, but these need to be mapped to Teamcenter attribute in altiumPcb_edadef.xml file -->
<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 Teamcenter PLM, é necessário efetuar 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 de substituição). Isto permitirá callbacks do Altium com lógica de transferência de substituições.

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

2. Localize os ficheiros seguintes 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 Add customer callbacks
   rem
   if exist CustomEDACallbacks.jar (
   	SET EDA_CP=%EDA_CP%;CustomEDACallbacks.jar
   )
   

5. Adicione as linhas seguintes por baixo:

   
   rem Added for Altium support of BOM substitutes
   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 (ou seja, 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 do comentário (por exemplo, colocando-as imediatamente 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 substituições, ou seja, não é possível ter substituições diferentes definidas para o mesmo item BOM entre variantes.
• A lista de componentes de substituição no Teamcenter é uma lista de revisões de componentes. As entradas de componentes de substituição não criam linhas BOM e não lhes podem ser atribuídas propriedades de linha BOM. No Altium Designer, é possível ter uma coluna BOM com um valor diferente para substituições, mas apenas as propriedades do componente base serão transferidas para as propriedades de linha BOM do Teamcenter.
• Se um projeto com substituições na BOM tiver sido publicado no Teamcenter e, em seguida, uma substituição da BOM do projeto for removida e o projeto for publicado novamente, a substituição também será removida da BOM no Teamcenter.
• Se um projeto com substituições 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 preSave callback. 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 efetuadas alterações no Teamcenter.

Configuração do Business Modeler IDE (BMIDE) para conjuntos de dados 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.

1. No BMIDE, abra a pasta Extensions.
2. 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.
3. Na caixa de diálogo EDA Derived Data, introduza as informações e clique em Next.
4. 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 no 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 menu 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 design

Current Project Publishing Limitations:

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