Configuração para o Teamcenter PLM

Parent page: Integração PLM

A integração PLM com 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, 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 Projeto. Ainda assim, recomenda-se a execuçã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 documentação EDA Integration específica da versão disponível no Siemens Support Center. Siga essa documentação cuidadosamente. As instruções aqui apenas abrangem desvios à documentação da Siemens, ou especificam detalhes do lado do Altium 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 (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 orientação 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:

• Extensões » Gestão de Processos de Mecatrónica » EDA Server Support
• Extensões » Gestão de Processos de Mecatrónica » EMPS-Foundation
• Extensões » Gestão de Processos de Mecatrónica » ECAD Library Management
• Extensões » Gestão de Processos de Mecatrónica » EDA for Business Modeler IDE
• Extensões » Gestão de Relacionamento com Fornecedores » Vendor Management
• Instalação Base » Active Workspace » Extensões de Servidor » EDA Server Support for Active Workspace
• Instalação Base » Active Workspace » Cliente » 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 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 (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 de exemplo a partir da interface do navegador do Workspace do Enterprise Server: abra Admin » PLM Integration, use o botão Add Instance para abrir a janela Add new instance, selecione o separador Configuration e depois Download sample configuration.

Dentro do ficheiro ZIP transferido haverá 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 Teamcenter Rich Client como utilizador infodba, ou como outro utilizador com privilégios de administração.
► Consulte 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 depois 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 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 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, assegure-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 na ordem category,classId e de que _tc2eda.csv tem colunas na 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 atributo 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 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 de Component Sync do Enterprise Server e um processo de Part Request with PLM Part Create do Enterprise Server.

Informação adicional sobre 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 o 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 o Enterprise Server um deles). Tenha em atenção que isto requer uma configuração especial descrita na documentação.
• Destination folder for parts – A pasta de destino para as peças sincronizadas do Altium para o Teamcenter pode ser definida por site/utilizador através da preferência do Teamcenter EDALIB_SaveAsFolderDefault.
• Current Part Synchronization limitations:
  • Os números de peça PLM são gerados apenas do 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 de Configuração XML do PLM (dm-config.xml) será ignorada sem aviso. A pasta de destino é obtida a partir do nível do utilizador do Teamcenter, ou da opção ao nível do 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. Tal como anteriormente, apenas são suportadas escolhas de peças baseadas em parâmetros de componentes.

Publicação de Design com Teamcenter EDA

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

O procedimento de instalação e configuração do EDA Gateway é descrito em detalhe na EDA Integration documentação específica da versão disponível no Siemens Support Center. Siga cuidadosamente essa documentação. As instruções aqui apenas abrangem desvios em relação à 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. Em 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), sobre o tópico Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications for design management, para o orientar durante a 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 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 de BOM

Os atributos de linha de BOM Reference Designator e Quantity 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>
        <!-- "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 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 esse mapeamento é adicionado, é possível definir o respetivo valor na secção <BOMAttributes> do ficheiro de Configuração XML 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 do Business Modeler IDE (BMIDE) para conjuntos de dados derivados

Após 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 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’.

Nome do caminho: $TEMP\Altium\TcEda\Project\pcb\*.*

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

Nome do caminho: $TEMP\Altium\TcEda\Project\schematic\*.*

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

Nome do 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 depois 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.