Configuración para Teamcenter PLM

Parent page: Integración de PLM

La integración de PLM de 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 de publicación/inicialización de proyectos en PLM. 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 independientes; 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 EDA Integrationdocumentación específica de la versión disponible en el Siemens Support Center. Siga minuciosamente esa documentación. Las instrucciones aquí solo cubren las diferencias con respecto a la documentación de Siemens o especifican detalles del lado de Altium que en la documentación de Siemens se mencionan como requisitos.

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.pdfcorrespondientesTcEDA<version>_README.pdf de Gateway disponibles en el centro de descargas. Luego debe 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), en el tema 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:

• Extensiones » Mechatronics Process Management » EDA Server Support
• Extensiones » Mechatronics Process Management » EMPS-Foundation
• Extensiones » Mechatronics Process Management » ECAD Library Management
• Extensiones » Mechatronics Process Management » EDA for Business Modeler IDE
• Extensiones » Supplier Relationship Management » Vendor Management
• Instalación base » Active Workspace » Extensiones del servidor » EDA Server Support for Active Workspace
• Instalación base » Active Workspace » Cliente » Electronic Design Automation for Active Workspace

Además, realice Install and set up Common Integration Services para dar soporte a 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 arriba, 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 es para EDA versión 5.1), en el tema 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 hacen referencia a esos capítulos por su nombre.

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

Durante ese paso se le pedirá preparar un library gateway configuration file; en su lugar, use uno proporcionado por Altium. Puede descargarlo 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, a continuación, seleccione el enlace Download Teamcenter EDA client definition files asociado al campo URL; vea el ejemplo.

Dentro del archivo descargado PLMClientConfigurationFiles.zip 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 el usuario infodba o como otro usuario con privilegios de administración.
► Consulte la información sobre Teamcenter Rich Client.

Las capturas de pantalla a continuación 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 luego vuelva a iniciarla en el 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'

A través del símbolo del sistema de Teamcenter, ejecute la utilidad export_attr_mappings para exportar 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 nuevamente 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 usarse o no ser necesaria para su instalación PLM de Teamcenter. Tenga en cuenta que, para utilizar atributos de clasificación, estos 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 la funcionalidad de clasificación habilitada. 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 de que _tc2eda.csv tenga las columnas en el orden classId,category. Si es necesario, intercambie los nombres de los archivos.

Para usar 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 se puede encontrar 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 dentro del árbol de clasificación, por ejemplo: “Components,SMT,Capacitor”.

Del mismo modo, se puede hacer referencia a los atributos de clasificación por el nombre configurado 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 sea posible la sincronización 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 ya debería ser posible ejecutar 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 de Teamcenter a Altium. Esto puede cambiarse en Teamcenter Query Builder modificando la consulta que Teamcenter utiliza 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 estén “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.
• Unit-of-measure parameter synchronization – La integración de Workspace con Teamcenter admite el mapeo de parámetros con reconocimiento de unidades mediante las columnas de datos adicionales Data Type y SiPrefix en la tabla Component Parameter Mapping table de la interfaz de usuario. Use las opciones del menú desplegable de una entrada para seleccionar un tipo de datos adecuado (see options) y un prefijo de unidad (see options).

• 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.
  • No se puede especificar la carpeta de destino 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 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 admiten las selecciones de piezas nativas (Approved Manufacturer/Vendor List, o AML/AVL). Como antes, solo se admiten las selecciones de piezas basadas en parámetros de componentes.

Publicación de diseño con Teamcenter EDA

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

El procedimiento de instalación y configuración de EDA Gateway se describe en detalle en la EDA Integration documentación específica de la versión disponible en el Siemens Support Center. Siga minuciosamente esa documentación. Las instrucciones aquí solo cubren desviaciones respecto a 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. Luego, consulte la documentación Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications (el enlace de ejemplo es para la versión EDA 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 va a 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 se 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.

Mapeo de atributos de líneas 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 mapeo de atributos de línea de BOM del archivo altiumPcb_edadef.xml. Por ejemplo, la siguiente entrada añade el mapeo 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 añade dicho mapeo, 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 la adición de piezas alternativas a los elementos de la BOM (learn more). Para admitir dichas piezas alternativas al publicar un diseño en Teamcenter PLM, debe realizarse 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á las devoluciones de llamada de Altium con lógica de transferencia de sustitutos.

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

2. Localice 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 al directorio %TCEDAECAD_ROOT% en el 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. Añada 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. Añada 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 desde el comentario (por ejemplo, moviéndolas justo debajo de la parte --> en esta sección).
7. Reinicie el PC para asegurarse de que Teamcenter EDA cargue las nuevas bibliotecas.

Notes:

• Teamcenter EDA debe configurarse para ejecutarse con Java 11.
• Si usa 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 design variants comparten el mismo conjunto de sustitutos; es decir, no es posible tener distintos sustitutos definidos para el mismo elemento de la 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 se les pueden asignar propiedades de línea de BOM. En Altium Designer, es posible tener una columna de BOM con un valor diferente para 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 ha eliminado un sustituto de la BOM del proyecto y el proyecto se ha publicado de nuevo, 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 utilizados como sustitutos en ActiveBOM deben sincronizarse con Teamcenter. Esta condición se verifica mediante el preSave callback. 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 conjuntos de datos 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 mostrará el asistente 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 derivado de PCB, agregue una nueva entrada en «Configure datasets».

Ruta de acceso: $TEMP\Altium\TcEda\Project\pcb\*.*

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

Ruta de acceso: $TEMP\Altium\TcEda\Project\schematic\*.*

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

Ruta de acceso: $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.
• ECO no es compatible actualmente.