Configuración para Teamcenter PLM

Parent page: Integración de PLM

La integración de PLM con Siemens Teamcenter® requiere una configuración adicional que no administra automáticamente el instalador de la instancia de Enterprise Server. Básicamente, se necesitan dos niveles de configuración, según las funciones de integración requeridas. El primer nivel habilita la Sincronización de piezas y también es un requisito previo para el segundo nivel, que habilita los procesos PLM de publicación/inicialización de proyectos. No obstante, se recomienda realizar ambos niveles de configuración.

Sincronización de piezas con Teamcenter

Para habilitar la sincronización de piezas de biblioteca, debe instalar el software Siemens Teamcenter^® EDA (Electronic Design Automation) Gateway en la máquina que aloja Enterprise Server. Este documento asume que Enterprise Server y el servidor Teamcenter ya están instalados en máquinas separadas; recomendamos este enfoque para garantizar la separación entre ambas instalaciones, aunque podrían instalarse en la misma máquina.

Instalación y configuración de Teamcenter EDA

Todo el procedimiento de instalación y configuración de EDA Gateway se describe en detalle en la documentación EDA Integration específica de la versión disponible en el Siemens Support Center. Siga esa documentación detenidamente. Las instrucciones aquí solo cubren desviaciones respecto de la documentación de Siemens, o especifican detalles del lado de Altium que se mencionan como requisitos en la documentación de Siemens.

Elija una versión de EDA Gateway que sea compatible con la versión de su servidor Teamcenter; debería encontrar información de compatibilidad en los archivos TcEDA<version>_README.pdf correspondientes de Gateway disponibles en el centro de descargas. A continuación, debe consultar la documentación Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications (el enlace de ejemplo corresponde a la versión EDA 5.1), sobre el tema de Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications for part library management para guiarse durante la configuración:

Como parte de la instalación y configuración de la interfaz Enterprise Server/Teamcenter, también debe instalar (y licenciar, etc., según sea necesario) las siguientes funciones de 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

Además, realice Install and set up Common Integration Services para admitir la publicación de diseños.

A continuación, siga los pasos e instale EDA Gateway CLIENT en la máquina de Enterprise Server. Para simplificar el proceso, sugerimos usar la carpeta C:\Siemens\TeamcenterEDA2.

Configure EDA Gateway para la gestión de bibliotecas de piezas

Como se indicó antes, para esta sección también debe consultar la documentación Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications (el enlace de ejemplo corresponde a la versión EDA 5.1), sobre el tema de Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications for part library management.

Consulte nuevamente este conjunto de instrucciones cuando llegue a capítulos específicos de la documentación de Teamcenter. Las secciones siguientes se refieren a esos capítulos por nombre.

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

Durante ese paso, se le pedirá que prepare un library gateway configuration file; en su lugar, utilice uno proporcionado por Altium. Puede descargarlo junto con un paquete de archivos de configuración desde la interfaz del navegador de Workspace de Enterprise Server: abra Admin » PLM Integration, use el botón Add Configuration para abrir la vista Add New Instance, elija Teamcenter EDA en el menú desplegable Driver y luego seleccione el enlace Download Teamcenter EDA client definition files asociado al campo URL; vea el ejemplo.

Dentro del archivo PLMClientConfigurationFiles.zip descargado habrá un archivo altiumLibrary_edadef.xml; coloque este archivo en el directorio indicado por la variable de entorno del sistema: %TCEDAECAD_ROOT%. Agregue también el archivo altiumPcb_edadef.xml proporcionado a ese directorio.

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

Abra Teamcenter Rich Client como usuario infodba, o como otro usuario con privilegios de administración.
► Consulte la información sobre Teamcenter Rich Client.

Las capturas de pantalla siguientes ilustran los pasos descritos en Create external applications for your ECAD tool in Teamcenter. En nuestro caso, agregaremos altiumLibrary,15 a la preferencia EDALIB_External_Applications:

Haga clic en el comando para agregar el nuevo valor, luego en Save y después cierre la preferencia. Cierre sesión y vuelva a iniciarla en Teamcenter Rich client.

• Abra la aplicación Organization.
• Vaya a la sección External Applications y agregue una aplicación altiumLibrary como se muestra a continuación:

• Seleccione Create.

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

Desde el símbolo del sistema de Teamcenter, ejecute la utilidad export_attr_mappings para generar la asignación a un archivo, por ejemplo:

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

Modifique el archivo mappings.txt según sus requisitos para asignar atributos reales de Teamcenter en los componentes. Un ejemplo de asignación funcional, agregado al contenido 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"}

Una vez completada la asignación, impórtela de nuevo en Teamcenter:

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

Para solucionar problemas de asignación de atributos, puede activar registros detallados incluyendo la línea rootLogger.level= DEBUG en el archivo C:\Program Files\Siemens\TeamcenterEDA2\eda\log4j2.properties.

Los registros de la ejecución de Teamcenter EDA se pueden encontrar en C:\Windows\TEMP\eis_eda_log.log.

Capítulo: 'Creating classification mapping for ECAD parts with Teamcenter classes' (opcional)

La asignación de clasificación es un requisito de configuración opcional y puede no utilizarse o no ser necesaria para su instalación PLM de Teamcenter. Tenga en cuenta que, para usar atributos de clasificación, deben incluirse en la configuración/archivo de asignación de atributos al completar la sección anterior 'Mapping ECAD part attributes to Teamcenter attributes'.

Antes de comenzar esta etapa de configuración, asegúrese de tener habilitada la funcionalidad de clasificación. Luego siga las instrucciones para configurar la asignación de clasificación.

Asegúrese de que _eda2tc.csv tenga las columnas en el orden category,classId y que _tc2eda.csv tenga las columnas en el orden classId,category. Si es necesario, intercambie los nombres de los archivos.

Para utilizar atributos de clasificación, debe incluirlos en la asignación de atributos. Un ejemplo de asignación de atributos de clasificación es:

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

Donde el número -60262 puede encontrarse con la herramienta Classification Admin en Teamcenter.

Asignación de clasificación en Enterprise Server

La información de clasificación se puede enviar con un atributo especial Classification incluido en su archivo de configuración XML del PLM (typically dm-config.xml o similar). Por ejemplo:

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

El valor de este atributo debe ser una ruta separada por comas en el árbol de clasificación, por ejemplo: “Components,SMT,Capacitor”.

De forma similar, se puede hacer referencia a los atributos de clasificación mediante el nombre que se configuró en la asignación de atributos en el servidor Teamcenter, por ejemplo:

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

Definir biblioteca en Enterprise Server

Antes de que la sincronización sea posible con Enterprise Server, es necesario crear una biblioteca con el comando eda_cli.bat (ubicado en el directorio de %TCEDAECAD_ROOT% en la máquina de Enterprise Server), y también asegurarse de que los archivos creados sean accesibles para Enterprise Server:

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

En esta etapa, debería ser posible realizar un proceso de Component Sync de Enterprise Server y un proceso de Part Request with PLM Part Create de Enterprise Server.

Información adicional sobre la sincronización de piezas de biblioteca:

• Synchronization of Released/Unreleased Teamcenter parts – De forma predeterminada, solo los componentes marcados con release_status_list.name = ‘TCM Released’ se sincronizarán desde Teamcenter a Altium. Esto puede cambiarse en el Teamcenter Query Builder modificando la consulta utilizada por Teamcenter para seleccionar componentes (vea el ejemplo).

El nombre de la consulta se almacena en la preferencia EDALIB_Sync_FindNewParts. La consulta predeterminada es __EDALIB_find_newparts y se muestra a continuación.

La última condición puede eliminarse para sincronizar componentes que aún no hayan sido “TCM Released”.

► Consulte la documentación relacionada de Siemens Teamcenter para obtener más información.

• Multisite synchronization – También es posible utilizar Teamcenter como fuente de información de componentes para varios sitios (uno de ellos, Enterprise Server). Tenga en cuenta que esto requiere una configuración especial que se describe en la documentación.
• Destination folder for parts – La carpeta de destino para las piezas sincronizadas desde Altium a Teamcenter se puede establecer por sitio/usuario mediante la preferencia de Teamcenter EDALIB_SaveAsFolderDefault.
• Current Part Synchronization limitations:
  • Los números de pieza de PLM se generan únicamente del lado de Enterprise Server.
  • La carpeta de destino no se puede especificar para los componentes en el archivo de configuración; existe una configuración global del lado de Teamcenter. Una configuración de carpeta de destino en el archivo PLM XML Configuration (dm-config.xml) se ignorará sin advertencia. La carpeta de destino se toma de la opción del nivel de usuario de Teamcenter, o de la opción de nivel de sitio EDALIB_SaveAsFolderDefault para todos los tipos de componentes.
  • No se admite la selección de piezas nativas (Approved Manufacturer/Vendor List, o AML/AVL). Como anteriormente, solo se admiten selecciones de piezas basadas en parámetros del componente.

Publicación de diseños con Teamcenter EDA

La publicación de diseños desde Altium a Teamcenter solo es posible a través de Altium Designer. Para habilitar la publicación de diseños, necesita instalar Teamcenter EDA (Electronic Design Automation) Gateway en la máquina donde está instalado Altium Designer . También necesitará acceso tanto al Enterprise Server como al servidor Teamcenter.

El procedimiento de instalación y configuración de EDA Gateway se describe en detalle en la documentación específica de la versión EDA Integration disponible en el Siemens Support Center. Siga esa documentación cuidadosamente. Las instrucciones aquí solo cubren desviaciones respecto de la documentación de Siemens, o especifican detalles del lado de Altium que se mencionan como requisitos en la documentación de Siemens.

Elija una versión de EDA Gateway que sea compatible con la versión de su servidor Teamcenter; debería encontrar información de compatibilidad en los archivos TcEDA<version>_README.pdf correspondientes de Gateway disponibles en el centro de descargas. Después, debería consultar la documentación Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications (el enlace de ejemplo es para EDA versión 5.1), sobre el tema de Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications for design management para guiarse durante la configuración:

Si se debe admitir la creación de componentes durante la publicación del proyecto, entonces parte de la configuración de la biblioteca debe realizarse en el servidor. Esto aplica a la estrategia de sección predeterminada <pt:BomStrategy>CreateNewAndLink</pt:BomStrategy> en la plantilla de publicación.

La carpeta de destino para los diseños se puede establecer mediante las opciones de sitio/usuario: EDA_SaveAsFolderDefault.

Asignación de atributos de línea de BOM

Los atributos de línea de BOM Reference Designator y Quantity se gestionan automáticamente, pero deben incluirse en la sección <BOM> del archivo XML Configuration del 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 usar otros atributos de línea de BOM, es necesario incluirlos en la sección de asignación de atributos de línea de BOM del archivo altiumPcb_edadef.xml. Por ejemplo, la siguiente entrada agrega la asignación del atributo de Altium part_source al atributo de línea de BOM de Teamcenter bl_part_source:

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

Cuando se agrega dicha asignación, es posible definir su valor en la sección <BOMAttributes> del archivo XML Configuration del 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>

Configuración para la publicación de piezas alternativas de BOM

ActiveBOM de Altium Designer admite agregar piezas alternativas a elementos de la BOM (más información). Para admitir dichas piezas alternativas al publicar un diseño en Teamcenter PLM, se debe realizar una configuración adicional de Teamcenter EDA como se describe a continuación (en la terminología de Teamcenter, estos componentes alternativos dentro del alcance de una BOM específica se denominan componentes sustitutos). Esto habilitará callbacks de Altium con lógica de transferencia de sustitutos.

1. Ubique el archivo soa_client.zip en los archivos de instalación de la versión del servidor Teamcenter que utiliza actualmente.

2. Ubique los siguientes archivos dentro de este archivo zip:

   soa_client\java\libs\TcSoaStructureManagementStrong*.jar

   soa_client\java\libs\TcSoaBomStrong*.jar

3. Copie estos dos archivos en el directorio %TCEDAECAD_ROOT% de la PC que aloja Teamcenter EDA Gateway y Altium Designer.

4. Abra el archivo %TCEDAECAD_ROOT%\setup_eda.bat y localice las siguientes líneas:

   
   rem
   rem Add customer callbacks
   rem
   if exist CustomEDACallbacks.jar (
   	SET EDA_CP=%EDA_CP%;CustomEDACallbacks.jar
   )
   

5. Agregue las siguientes líneas debajo:

   
   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 atención al número de versión (es decir, 14000.3.0 en el ejemplo anterior). Debe coincidir con el número de versión incluido en el nombre del archivo que se copió en el paso anterior.

6. Abra el archivo %TCEDAECAD_ROOT%\altiumPcb_edadef.xml. Agregue las siguientes entradas de <callback …/> dentro de la sección <CallbackDefs> (ya existe en el archivo):

   
   <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"/>
   

   Las entradas anteriores ya están presentes en el archivo altiumPcb_edadef.xml, dentro de un comentario multilínea en la sección <CallbackDefs>. Puede mover estas entradas fuera del comentario (por ejemplo, moviéndolas justo debajo de la parte --> en esta sección).
7. Reinicie la PC para asegurarse de que Teamcenter EDA cargue las nuevas bibliotecas.

Notes:

• Teamcenter EDA debe configurarse para ejecutarse en Java 11.
• Si utiliza Teamcenter 13, asegúrese de usar versiones de las bibliotecas adicionales de su instalación de Teamcenter 13.
• Asegúrese de actualizar los archivos CustomEDACallbacks.jar y altiumPcb_edadef.xml en el directorio %TCEDAECAD_ROOT%.
• En Altium Designer, todas las variantes de diseño comparten el mismo conjunto de sustitutos; es decir, no es posible tener distintos sustitutos definidos para el mismo elemento de BOM entre variantes.
• La lista de componentes sustitutos en Teamcenter es una lista de revisiones de componentes. Las entradas de componentes sustitutos no crean líneas de BOM y no pueden tener propiedades de línea de BOM asignadas. En Altium Designer, es posible tener una columna de BOM con un valor diferente para los sustitutos, pero solo las propiedades del componente base se transferirán a las propiedades de línea de BOM de Teamcenter.
• Si un proyecto con sustitutos en la BOM se ha publicado en Teamcenter y luego se elimina un sustituto de la BOM del proyecto y el proyecto se publica nuevamente, el sustituto también se eliminará de la BOM en Teamcenter.
• Si un proyecto con sustitutos en la BOM se ha publicado en Teamcenter y luego la BOM se ha modificado manualmente en Teamcenter, la BOM en Teamcenter se sobrescribirá en la siguiente publicación de este proyecto; es decir, los cambios realizados manualmente se perderán.

• Los componentes usados como sustitutos en ActiveBOM deben estar sincronizados con Teamcenter. Esta condición es verificada por el callback preSave. Si hay componentes que no se han sincronizado con Teamcenter, se mostrará un mensaje de error y la operación se abortará, por lo que no se realizará ningún cambio en Teamcenter.

Configuración de Business Modeler IDE (BMIDE) para datasets derivados

Después de crear una configuración de datos derivados (consulte las referencias en el archivo altiumPcb_edadef.xml), puede especificar el nombre de la configuración en la preferencia EDA_DerivedDataConfigDefault.

1. En BMIDE, abra la carpeta Extensions.
2. En la carpeta Extensions, haga clic con el botón derecho en EDA Derived Data y elija New EDA Derived Data. Se muestra el asistente de New EDA Derived Data.
3. En el cuadro de diálogo EDA Derived Data, introduzca la información y haga clic en Next.
4. Para el conjunto de datos PCB derivado, agregue una nueva entrada en ‘Configure datasets’.

Nombre de ruta: $TEMP\Altium\TcEda\Project\pcb\*.*

5. Para el conjunto de datos esquemático derivado, agregue una nueva entrada en ‘Configure datasets'.

Nombre de ruta: $TEMP\Altium\TcEda\Project\schematic\*.*

6. Otro conjunto de datos derivado para los conjuntos de datos de variantes:

Nombre de ruta: $TEMP\Altium\TcEda\Project\$VARIANT\pcb\*.*

7. Para guardar los cambios en el modelo de datos, elija File » Save Data Model o haga clic en el botón Save Data Model de la barra de herramientas principal.
8. Implemente sus cambios en el servidor de prueba. Elija Deploy Template en la barra de menús, o seleccione el proyecto y luego haga clic en el botón Deploy Template de la barra de herramientas principal.
9. En Rich Client, configure la preferencia EDA_DerivedDataConfigDefault para que apunte a la configuración de datos derivados de EDA que acaba de crear.
10. Elija Edit » Options, haga clic en el enlace Search situado en la parte inferior del cuadro de diálogo Options, localice la preferencia EDA_DerivedDataConfigDefault y cambie su valor a la nueva configuración.

Información adicional sobre la publicación del diseño

Current Project Publishing Limitations:

• La referencia a revisiones específicas de componentes ('Precise BOM') no es compatible con Siemens EDA Gateway.
• Actualmente, ECO no es compatible.