Integración con PLM mediante archivos XML
De un vistazo
- Aprenda a adaptar archivos XML de ejemplo o a generar una configuración base a partir del modelo de datos de su espacio de trabajo.
- Comprenda cómo las plantillas de publicación controlan la creación y vinculación de componentes, así como los archivos de salida de las versiones que se envían al sistema PLM.
- Descubra cómo la validación de la conexión identifica errores y advertencias de configuración antes de utilizar la integración.
Conexión a su instancia de PLM
La conexión a su instancia de PLM se realiza desde la página Admin – PLM Integration de la interfaz del Workspace en el navegador. Esto implica cargar el archivo de configuración basado en XML y la plantilla de publicación correspondientes, así como habilitar/configurar la sincronización de sus componentes de PLM con los del Workspace.
Como parte de la instalación, se proporcionan archivos de configuración y plantillas de publicación de ejemplo. Expanda las secciones siguientes para obtener más información:
Archivos de configuración de ejemplo
Los archivos de configuración de ejemplo se proporcionan a través de la vista Add new instance: en la pestaña Configuration, haga clic en el enlace Download sample configuration para obtener el archivo ZIP ConfigurationSamples.zip. Este ZIP contiene archivos de configuración iniciales para los sistemas PLM Windchill, Arena, Aras y Agile:
- dm-Windchill-config-basic.xml
- dm-Arena-config-basic.xml
- dm-Agile-config-basic.xml
-
dm-Aras-config-basic.xml
Se proporcionan archivos de configuración de ejemplo para utilizarlos como parte de la instancia del Workspace.
Las configuraciones suministradas incluyen un par de secciones representativas de entidades de componentes (por ejemplo, Capacitors y Diodes), cada una de las cuales incluye una subsección básica de asignación de atributos/parámetros ToPLM y ToAltium. Amplíe y edite un archivo de ejemplo para adaptarlo a la instancia de PLM y a los requisitos de su empresa, cree el suyo propio o utilice el Generador de configuración para crear un archivo de configuración base que coincida con el modelo de datos de su Workspace.
Plantillas de publicación de ejemplo
Las plantillas de publicación de ejemplo se proporcionan a través de la vista Add new instance: haga clic en el botón
de la pestaña Publish Template y, a continuación, en el enlace Download sample configuration de la ventana Publish Template para obtener el archivo ZIP PublishTemplateSamples.zip. Este ZIP contiene los siguientes archivos:
- dm-Windchill-publish-template-basic.xml
- dm-Arena-publish-template-basic.xml
- dm-Agile-publish-template-basic.xml
-
dm-Aras-publish-template-basic.xml
Se proporcionan plantillas de publicación de ejemplo para utilizarlas como parte de la instancia del Workspace.
Modifíquelas para adaptarlas a la instancia de PLM y a los requisitos de su empresa, o cree las suyas propias.
Tenga en cuenta que en los archivos de publicación de ejemplo se configuran las siguientes áreas importantes:
-
Cómo gestionar la creación y la vinculación de componentes en el sistema PLM durante un proceso de publicación (la «Estrategia de BOM»). Están disponibles las siguientes opciones:
- LinkExistingOnly: vincular los componentes que ya existen en el PLM, pero no crear los que no existen.
- CreateNewAndLink: vincular los componentes que ya existen en el PLM, y crear y vincular los que no existen.
- LinkIfAllExists: no crear componentes que no existan en el sistema PLM; vincularlos solo si todos los componentes existen en el PLM.
-
Conjuntos de reglas que definen cómo y dónde se publican en el PLM los archivos de salida de la liberación:
- Reglas para procesar los datos del proyecto (principal).
- Reglas para procesar los datos de origen.
- Reglas para procesar los datos de ensamblaje.
- Reglas para procesar los datos de fabricación.
Al añadir una nueva entrada de PLM mediante el botón
, utilice el botón
para buscar y aplicar una configuración de PLM guardada/modificada adecuadamente.
Del mismo modo, se añade una plantilla de publicación compatible mediante el botón
de la pestaña Publish Template. En el cuadro de diálogo Publish Template que aparece a continuación, utilice el botón
para buscar y seleccionar el archivo de plantilla correcto.
Flujo de trabajo de órdenes de cambio (ECO)
Los archivos de configuración de las instancias de PLM Windchill, Agile y Arena también admiten el flujo de trabajo formalizado de Change Order (ECO), que se habilita en el archivo XML de la plantilla de publicación y se define en el archivo XML de configuración, en la sección de entidad altiumType="ProjectChangeOrder"; vea el ejemplo.
Según la instancia de PLM, las definiciones de configuración incluyen el esquema de identificación de la orden de cambio (numeración, ubicación, ID, etc.), atributos específicos de la orden de cambio como Nombre/Título, Descripción y Complejidad del cambio (solo Windchill), y ajustes de opciones como la estrategia de creación de órdenes de cambio (ninguna, nueva o reutilizar una existente) y la promoción de estado de Lifecycle (solo Windchill y Agile). La orden de cambio definida se habilita durante la publicación mediante la declaración de su referencia publishId en la plantilla de publicación asociada; vea el ejemplo.
Una vez definidas en los archivos XML de configuración y de plantilla de publicación del servidor, las órdenes de cambio están disponibles durante los flujos de trabajo PLM de Creación de proyectos y Proceso de publicación iniciados desde Altium Designer o a través de la interfaz del Workspace empresarial. Durante el flujo se mostrará un formulario de orden de cambio asociado, en el que se especifican la configuración y las opciones de la orden de cambio.
► Para obtener información sobre el uso de la funcionalidad de órdenes de cambio (ECO) de PLM para las instancias de PLM Windchill, Agile y Arena, consulte los comentarios incluidos en sus archivos XML de configuración y archivos XML de plantillas de publicación de ejemplo, disponibles para su descarga desde el Workspace empresarial.
En lugar de utilizar los archivos de configuración suministrados para crear una nueva instancia del sistema empresarial, se puede utilizar el generador de configuración interno del espacio de trabajo para crear una configuración adaptada cuya estructura se derive del modelo de datos del espacio de trabajo. El generador solicita la información de conexión (tipo de PLM y URL) y, a continuación, consulta los datos del espacio de trabajo para identificar los tipos de componentes registrados (condensadores, diodos, etc.) y sus correspondientes plantillas de componentes para crear un archivo de configuración base. Haga clic en la siguiente sección desplegable para obtener más información:
Generador de configuración
Hay una función de configuración adaptativa disponible en el enlace Generar configuración de la página Add new instance, que se abre desde el botón
del espacio de trabajo.
En el cuadro de diálogo Generate Configuration, seleccione el tipo de sistema empresarial al que se conectará —uno de los tipos de PLM disponibles (Windchill, Arena, etc.)— y, a continuación, su URL remota. Seleccione el botón
para crear un nuevo archivo dm-configuration.xml, que podrá guardar y añadir a la nueva instancia de PLM mediante el botón
.
El generador crea la configuración de forma que coincida con el modelo de datos de la instancia actual del espacio de trabajo; por ejemplo, los tipos de componentes registrados en el espacio de trabajo se añaden como tipos de entidades en el archivo de configuración (dm-configuration.xml). Cada sección de entidad tiene sus correspondientes secciones ToPlm y ToAltium, así como parámetros asignados procedentes de la plantilla de componentes correspondiente (si está disponible). También se incluyen secciones de publicación de proyectos para asignar los elementos del paquete de lanzamiento al sistema empresarial.
Todas las secciones de la configuración generada incluyen comentarios TODO que señalan las áreas que se deben añadir o modificar para garantizar la compatibilidad con la configuración de su espacio de trabajo/PLM. Para obtener más información sobre cómo editar el archivo de configuración para que funcione con su espacio de trabajo/PLM, consulte los comentarios explicativos incluidos en los archivos de configuración de ejemplo suministrados.
Compatibilidad con PLM de terceros
El espacio de trabajo de Altium 365 ofrece compatibilidad adicional con configuraciones de sistemas PLM «no nativos» desarrolladas por terceros. Esta compatibilidad se habilita mediante Generic Connector de Altium, que requiere la licencia Altium 365 PLM Generic Connector Addon.
Al añadir una instancia de PLM del espacio de trabajo para uno de estos sistemas, se cargan los archivos XML preconfigurados proporcionados por el tercero en la configuración de dicha instancia de PLM, tal como se ha descrito anteriormente.
Validación de la conexión
El espacio de trabajo ofrece una comprobación exhaustiva de validación de la conexión de la instancia de PLM, disponible mediante el botón
de la página Add/Edit Instance. Esta función realiza una serie de comprobaciones de compatibilidad de la configuración e informa de los resultados de inmediato.
Al ejecutar el informe de validación de la conexión, el espacio de trabajo analiza la configuración actual y los ajustes de las plantillas de publicación para comprobar su compatibilidad tanto con la instancia del espacio de trabajo como con los datos del sistema empresarial de destino. Los problemas de configuración, como errores de rutas, definiciones de tipos de componentes y parámetros sin correspondencia, o ajustes de ciclo de vida o revisión no válidos, se detectan y se notifican en el siguiente cuadro de diálogo Configuration Validation Report.
Si se notifican errores de configuración —que dan lugar a un estado general de ERROR (Status)—, será necesario resolverlos antes de poder crear la nueva instancia. El estado WARNING, que indica problemas como tipos de componentes del espacio de trabajo que no están incluidos en la configuración o atributos especificados que no están disponibles en el sistema empresarial, permite guardar y utilizar la instancia configurada.
Los errores y las advertencias notificados se pueden corregir en los archivos de configuración/publicación aplicados y/o modificando los ajustes del espacio de trabajo o del sistema empresarial. Asegúrese de hacer clic en el botón
una vez que haya definido correctamente la instancia. Esa instancia aparecerá en la lista actual de instancias conectadas, en la página principal PLM Integration de la interfaz.
Sincronización de componentes
La sincronización de componentes entre el espacio de trabajo de Altium 365 y la instancia del sistema empresarial conectada —o, más concretamente, de sus datos paramétricos— se basa en el LibSync flujo de trabajo del proceso. El proceso LibSync está predefinido en el espacio de trabajo y no se puede acceder a él (ni editarlo) desde la página Admin - Processes. Sin embargo, al tratarse de un proceso basado en un flujo de trabajo, es posible consultar los resultados de su acción de sincronización y gestionar cualquier error.
El uso del proceso de sincronización implica lo siguiente:
-
Definir los ajustes de sincronización de cada tipo de componente, lo que en la práctica consiste en:
- Determinar la dirección de la sincronización (hacia el espacio de trabajo o hacia el PLM).
- Determinar qué tipos de componentes intervienen y dónde se crearán los nuevos componentes.
- Configurar la asignación o los atributos de los parámetros.
- Configurar la asignación de datos de las opciones de piezas, si procede.
- Realizar la sincronización.
Los dos primeros grupos de elementos anteriores se gestionan en el archivo de configuración utilizado para la instancia del sistema empresarial conectada (como un PLM). La sincronización en sí se puede realizar bajo demanda desde la página PLM Integration de la interfaz del espacio de trabajo y/o se puede programar: una sincronización automatizada a intervalos periódicos, definidos al configurar la conexión con la instancia de PLM.
Configuración de la sincronización
Dentro del archivo de configuración, la conectividad con la instancia del sistema empresarial se define entre las etiquetas Instance mediante un tipo de controlador y una URL de destino específicos. Cuando se ha utilizado el Generador de configuración para crear el archivo de configuración, las referencias al controlador y a la URL incluidas son las que se introdujeron en el cuadro de diálogo Generate Configuration durante el proceso de generación.
<Instance>
<Driver>[Driver Type]</Driver>
<Url>[PLM API URL]</Url>
</Instance>
En la siguiente sección Schema del archivo de configuración, se define una sección de asignación de sincronización para cada tipo de pieza específico. En el espacio de trabajo, se trata del componente de tipo altiumType: su valor es una de las opciones de los parámetros de tipo que se pueden ver en la página Gestión de datos - Tipos de componentes del cuadro de diálogo Preferences de Altium Designer. En el PLM, se crea una pieza de tipo plmType, según lo determinado por su valor en el entorno de PLM.
La sección se declara como un Entity en el archivo; un ejemplo de ello podría ser, para los condensadores:
<Entity altiumType="Capacitor" plmType="Capacitor">
.
.
</Entity>
Dentro de Entity, se utilizan dos secciones para controlar y configurar la sincronización del Workspace a la instancia de PLM y de la instancia de PLM al Workspace, lo que permite una sincronización unidireccional o bidireccional. Consulte las siguientes secciones, junto con los comentarios disponibles en los archivos de configuración de ejemplo, para obtener más información. En última instancia, lo que se defina en el archivo de configuración variará en función de sus necesidades específicas y de los atributos (PLM) que se hayan definido en la instancia del sistema empresarial conectado.
ToPlm
Esta sección se utiliza para controlar y configurar la sincronización del Workspace a la instancia de PLM de la siguiente forma:
<ToPlm sync="true">
.
.
</ToPlm>
Dentro de la sección ToPlm, se definen las siguientes secciones:
- Cómo se crean los nuevos componentes en la instancia de PLM: entre las etiquetas <CreateInfo> y </CreateInfo>. Un ejemplo podría ser elegir un esquema de nomenclatura de elementos definido en el sistema empresarial de destino y especificar un prefijo de numeración de elementos:
<CreateInfo>
<Numbering name="Electrical">
<Fields>
<Field name="Code" value="120"/>
</Fields>
</Numbering>
</CreateInfo>
-
Filtrado para limitar qué componentes del Workspace se sincronizan con el PLM: entre las etiquetas <SourceCriteria> y </SourceCriteria>. La propagación de los datos de origen se puede restringir mediante combinaciones de lógica booleana de atributos de parámetros, donde varios conjuntos de atributos pueden dar lugar a un resultado de filtrado específico mediante la aplicación básica de cláusulas lógicas AND, OR y NOT. Para obtener más información, consulte las notas relacionadas con
SourceCriteriaen los archivos XML de configuración de ejemplo.
Esta función resulta extremadamente útil si, por ejemplo, tiene 6000 condensadores en su Workspace, pero solo desea sincronizar una carpeta específica con 85 condensadores cerámicos. En este caso, basta con especificar la ruta de esa carpeta dentro del conjunto de etiquetas SourceCriteria (<Folder>Components/Capacitors/Ceramic</Folder>) y, opcionalmente, cualquier otro atributo de parámetro necesario para restringir aún más los datos de origen; por ejemplo, el tipo de encapsulado 0603. La relación entre los criterios agrupados es un operador lógico AND implícito, por lo que el siguiente ejemplo sincronizará los condensadores cerámicos con encapsulado 0603 del Workspace con el PLM.
<SourceCriteria>
<Folder>Components/Capacitors/Ceramic</Folder>
<common:Attribute>
<common:Key>Case/Package</common:Key>
<common:Value>0603</common:Value>
</common:Attribute>
</SourceCriteria>
También hay disponibles conjuntos de etiquetas específicos para la lógica OR (<Or>…</Or>) y conjuntos de etiquetas de exclusión lógica NOT (<Not>…</Not>), que se pueden añadir dentro de la sección del nodo SourceCriteria. Con estas opciones, la lógica OR se aplica a los conjuntos de atributos de parámetros añadidos dentro de las etiquetas <Or></Or>, y la lógica NOT, al conjunto de atributos de parámetros incluido dentro de las etiquetas <Not>…</Not>. Un ejemplo podría ser un requisito adicional de que el estado del ciclo de vida sea Approved o Released, pero con la exclusión (NOT) de los elementos cuyo parámetro de clasificación tenga el valor SpecialOrder. El filtrado lógico completo en este caso sería:
<SourceCriteria>
<Folder>Components/Capacitors/Ceramic</Folder>
<common:Attribute>
<common:Key>Case/Package</common:Key>
<common:Value>0603</common:Value>
</common:Attribute>
<Or>
<common:Attribute>
<common:Key>Lifecycle</common:Key>
<common:Value>Released</common:Value>
</common:Attribute>
<common:Attribute>
<common:Key>Lifecycle</common:Key>
<common:Value>Approved</common:Value>
</common:Attribute>
</Or>
<Not>
<common:Attribute>
<common:Key>Classification</common:Key>
<common:Value>SpecialOrder</common:Value>
</common:Attribute>
</Not>
</SourceCriteria>
- Una lista de atributos (parámetros) que deben transferirse para los componentes del Workspace al PLM: entre las etiquetas <Attributes> y </Attributes>. Un ejemplo es:
<Attributes>
<!-- Name/Comment from Workspace will be passed to PLM field Name 'as is' -->
<common:Attribute>
<common:Key>name</common:Key>
<common:Value>${parameter.Name}</common:Value>
</common:Attribute>
<!-- Number generated on PLM side will be propagated to workspace -->
<!-- as PlmPartNumber parameter (note: any parameter name can be used)-->
<common:Attribute attributeType="item" primaryKeyOrdinal="1">
<common:Key>number</common:Key>
<common:Value>${parameter.PlmPartNumber}</common:Value>
</common:Attribute>
<!-- Workspace component description will go to PLM field Description. Value will be prefixed with 'Extended' -->
<!-- Description on Workspace side is a revision level parameter -->
<common:Attribute attributeType="revision">
<common:Key>description</common:Key>
<common:Value>Extended ${parameter.Description}</common:Value>
</common:Attribute>
<!-- This attribute will not be pushed to PLM component as part of library synchronization -->
<!-- It is being used to pass values during project publish with BOM -->
<common:Attribute>
<common:Key>refDes</common:Key>
<common:Value>${parameter.LogicalDesignator}</common:Value>
</common:Attribute>
<!-- RoHS field in PLM will be set to 'YES' -->
<common:Attribute>
<common:Key>RoHS</common:Key>
<common:Value>YES</common:Value>
</common:Attribute>
</Attributes>
ToAltium
Esta sección se utiliza para controlar y configurar la sincronización de la instancia de PLM al Workspace de la siguiente forma:
<ToAltium sync="true" mode="createAndUpdate">
.
.
</ToAltium>
La instrucción opcional
mode determina cómo se sincronizan los datos de los componentes del sistema empresarial con el Workspace. El modo predeterminado (createAndUpdate) permite crear nuevos componentes en el Workspace y actualizar los componentes existentes, mientras que el modo alternativo updateExisting solo permite actualizar los componentes existentes del Workspace.
Dentro de la sección ToAltium, se definen las siguientes secciones:
- Cómo y dónde se crean los nuevos componentes en el Workspace: entre las etiquetas <CreateInfo> y </CreateInfo>.
<CreateInfo>
<!-- <ComponentTemplate>TODO component template Revision ID</ComponentTemplate> -->
<RevisionNamingScheme>1-Level Revision Scheme</RevisionNamingScheme>
<LifecycleDefinition>Component Lifecycle</LifecycleDefinition>
<Folder>Components/Inbox/Capacitors</Folder>
</CreateInfo>
Cuando se crea una entrada de componente en el Workspace, se utilizará la plantilla de componentes asociada a la carpeta de destino del Workspace (Components/Inbox/Capacitors en el ejemplo anterior), si se ha especificado alguna. Esta también definirá el esquema de nomenclatura de elementos utilizado para el componente creado, que tendrá prioridad sobre el especificado en la carpeta de destino del Workspace. Por el contrario, si la carpeta no define ni una plantilla ni un esquema de nomenclatura, la sincronización fallará.
Tenga en cuenta también que, en las configuraciones de ejemplo, se definen un esquema de nomenclatura de revisiones predeterminado (1-Level Revision Scheme) y una definición del ciclo de vida (Component Lifecycle); estos se sustituyen por los de la plantilla de componentes si hay una asociada a la carpeta de destino del Workspace.
Si se añade una referencia a una plantilla de componentes específica en la configuración (por ejemplo, CMPT-00001), se utilizará esta plantilla en lugar de la asociada a la carpeta de destino del Workspace. Sus ajustes tendrán prioridad sobre cualquier ajuste de parámetros del archivo de configuración (como la definición del ciclo de vida, etc.), a excepción de la carpeta de destino definida.
<CreateInfo>
<!-- A specified Template overrules other CreateInfo settings, except the target Folder -->
<ComponentTemplate>CMPT-00001</ComponentTemplate>
<RevisionNamingScheme>1-Level Revision Scheme</RevisionNamingScheme>
<LifecycleDefinition>Component Lifecycle</LifecycleDefinition>
<!-- A specified target Folder overrules that defined in an applied Template -->
<Folder>Components/Inbox/Capacitors</Folder>
</CreateInfo>
Tenga en cuenta que la plantilla especificada solo se aplicará a los componentes recién creados en el Workspace. Este enfoque resulta especialmente útil para gestionar la importación o sincronización de parámetros de componentes propios de un sistema externo al Workspace. En este caso, se puede aplicar una plantilla de componentes personalizada para interpretar los datos de parámetros entrantes, establecer valores predeterminados adecuados, especificar los tipos de datos de las unidades y también especificar la definición del ciclo de vida y el esquema de nomenclatura de revisiones de los componentes recién creados en el Workspace.
- Filtrado de los datos recuperados de la instancia del sistema empresarial (PLM): entre las etiquetas <SourceCriteria> y </SourceCriteria>. Una instrucción de filtrado podría restringir los datos de componentes recibidos del PLM a los creados por un autor específico (como se ilustra en la configuración de ejemplo proporcionada) o a los elementos de componentes que tengan un valor de atributo concreto (Business Unit = Engineering_RD), como se muestra a continuación.
<SourceCriteria>
<ns2:Attribute>
<ns2:Key>Business Unit</ns2:Key>
<ns2:Value>Engineering_RD</ns2:Value>
</ns2:Attribute>
</SourceCriteria>
- Una lista de atributos (parámetros) que deben transferirse para los componentes del PLM al Workspace: entre las etiquetas <Attributes> y </Attributes>. Un ejemplo es:
<Attributes>
<!-- Name field from PLM will be passed to name/comment field in Workspace-->
<common:Attribute attributeType="revision">
<common:Key>name</common:Key>
<common:Value>${attribute.name}</common:Value>
</common:Attribute>
<!-- Description field from PLM will be passed to Description field in Workspace on revision level -->
<!-- Revision level attributes will cause new revision to be created in case parameter value is changed -->
<common:Attribute attributeType="revision">
<common:Key>Description</common:Key>
<common:Value>${attribute.description}</common:Value>
</common:Attribute>
<!-- Number field from PLM will be passed to PlmPartNumber field in Workspace on revision level -->
<!-- Note: any attribute name can be used -->
<common:Attribute attributeType="revision" primaryKeyOrdinal="1">
<common:Key>PlmPartNumber</common:Key>
<common:Value>${attribute.Number}</common:Value>
</common:Attribute>
<common:Attribute attributeType="item">
<common:Key>DynamicCONTS</common:Key>
<common:Value>Will not cause revision update if changed ${attribute.LastModified}</common:Value>
</common:Attribute>
</Attributes>
La sección para definir la asignación de datos de opciones de piezas se encuentra al final del archivo de configuración de ejemplo (o de uno generado).
Opciones de piezas
Junto con las declaraciones de entidades del esquema de configuración, hay una sección adicional para definir la asignación de datos de opciones de piezas de componentes entre el sistema empresarial (PLM) y el Workspace. Esta sección permite asignar parámetros de atributos específicos de las opciones de piezas para la mayoría de los sistemas PLM compatibles, así como relaciones de datos de la lista de fabricantes aprobados (AML) para los sistemas PLM Aras, Windchill y Arena. Se trata de una definición bidireccional exclusiva —es decir, para cualquiera de las dos direcciones, pero no para ambas simultáneamente— que especifica los atributos de fabricante y número de pieza del componente utilizados para la propagación de los datos de opciones de piezas.
Cuando la sincronización de opciones de piezas está habilitada en el archivo de configuración (sync="true"), el valor de los atributos especificados se transfiere al sistema de destino. La dirección de esa propagación de datos se determina mediante la expresión «To», donde ToAltium especifica que los datos paramétricos del componente PLM se aplican al componente creado o actualizado en el Workspace, y ToPlm hará que los datos de opciones de piezas asociados al componente del Workspace se transfieran al sistema PLM. La configuración habilitada se aplica a todas las entidades de componentes definidas, de modo que los datos de opciones de piezas se transferirán al destino especificado cada vez que se encuentre un conjunto de datos de componente.
Una entrada de ejemplo para una asignación de opciones de piezas ToAltium en un archivo de configuración —donde los atributos del sistema PLM son MFR1 (nombre del fabricante) y MPN1 (número de pieza del fabricante)— podría ser:
<PartChoices>
<ToAltium sync="true">
<MfrMappings>
<MfrMapping>
<MfrName>MFR1</MfrName>
<MfrPartNumber>MPN1</MfrPartNumber>
</MfrMapping>
</MfrMappings>
</ToAltium>
</PartChoices>
La sincronización de datos de opciones de piezas también admite varias entradas de datos de opciones de piezas. Estos atributos adicionales deben especificarse en la asignación del archivo de configuración como otro par de definiciones de atributos, por ejemplo: MFR2 y MPN2, como se muestra a continuación:
<MfrMappings>
<MfrMapping>
<MfrName>MFR1</MfrName>
<MfrPartNumber>MPN1</MfrPartNumber>
</MfrMapping>
<MfrMapping>
<MfrName>MFR2</MfrName>
<MfrPartNumber>MPN2</MfrPartNumber>
</MfrMapping>
</MfrMappings>
Los sistemas empresariales que cuentan con funciones nativas o integradas de opciones de piezas de fabricante, como Manufacturer Parts en Windchill y Vendor Parts en Arena, no requieren parámetros asignados en el archivo de configuración. En este caso, basta con habilitar la aceptación de datos de opciones de piezas en la sección de configuración correspondiente.
<PartChoices>
<ToAltium sync="true"/>
</PartChoices>
O bien, cuando se admite la transferencia de datos al sistema empresarial:
<PartChoices>
<ToPlm sync="true"/>
</PartChoices>
Compatibilidad con PTC Windchill PartsLink
El sistema PLM PTC Windchill ofrece un módulo opcional PartsLink que permite classified las piezas en grupos. Las clasificaciones de piezas especificadas en Windchill también pueden incluir pares de atributo/valor asociados para aportar una definición más detallada dentro de esa clasificación. El sistema PartsLink permite seleccionar tipos de componentes específicos de forma fácil y rápida, y es compatible con la integración PLM del Workspace para la sincronización bidireccional y el acceso de lectura/escritura.
En una instancia de configuración del Workspace para Windchill, se crea una clasificación de PartsLink en Windchill especificando un atributo de vinculación en la sección ToPLM con el formato que se muestra en el siguiente ejemplo:
<common:Attribute>
<common:Key>Classification</common:Key>
<common:Value>102-Capacitor</common:Value>
</common:Attribute>
En el caso anterior, el par clave/valor define una clasificación denominada 102-Capacitor. Esta puede tener un atributo de clasificación asociado creado en Windchill mediante la especificación de un parámetro de nombre y valor (en este caso, Capacitance); tenga en cuenta que se pueden aplicar varios atributos a una misma clasificación:
<common:Attribute>
<common:ClassificationName>102-Capacitor</common:ClassificationName>
<common:Key>Capacitance</common:Key>
<common:Value>${parameter.Value}</common:Value>
</common:Attribute>
En la sección de sincronización ToAltium de la configuración, los datos procedentes de Windchill pueden filtrarse por la clasificación de piezas deseada dentro del conjunto de etiquetas <SourceCritera>, especificando su ClassificationName.
<SourceCriteria>
<ClassificationName>102-Capacitor</ClassificationName>
</SourceCriteria>
Para obtener todas las piezas que coincidan con un valor de atributo de clasificación (por ejemplo, todos los condensadores de 10 uF), la sección <SourceCriteria> debe incluir ajustes de atributos de configuración que definan una ClassificationName y la clave y el valor de su atributo de clasificación asociado.
<SourceCriteria>
<common:Attribute>
<common:ClassificationName>102-Capacitor</common:ClassificationName>
<common:Key>Capacitance</common:Key>
<common:Value>10uF</common:Value>
</common:Attribute>
</SourceCriteria>
Para extraer un valor de atributo de clasificación específico de Windchill, obtenga el parámetro Value a partir del nombre del atributo específico asociado a una ClassificationName.
<common:Attribute attributeType="revision">
<common:ClassificationName>102-Capacitor</common:ClassificationName>
<common:Key>Value</common:Key>
<common:Value>${attribute.Capacitance}</common:Value>
</common:Attribute>
En el propio Windchill, una clasificación de PartsLink se define creando una binding attribute que pueda aplicarse a un tipo de pieza. A continuación, se añade un atributo de clasificación de piezas a una clase de clasificación definida.
Las entradas de componentes en Windchill incorporarán su clasificación definida y los parámetros de atributos de clasificación especificados, que a su vez estarán disponibles para el proceso de sincronización de componentes PLM del Workspace.
Cuando se sincroniza una entrada de componente desde Windchill al Workspace y se ha especificado la interacción con PartsLink en la configuración PLM del Workspace, los atributos de configuración de Windchill para esa pieza se propagarán al componente en el lado de Altium.
Realización de la sincronización de componentes
La sincronización de componentes (biblioteca) puede realizarse como un proceso manual o programado, desde el botón Sync action de una entrada de instancia PLM en la página PLM Integration del Workspace o como un ciclo automatizado especificado en la configuración de la instancia, respectivamente. Haga clic en el
control asociado con la instancia de PLM que desea sincronizar. El proceso de sincronización seguirá el flujo de trabajo LibSync, de acuerdo con los ajustes definidos en el archivo de configuración asociado.
El control cambia a
. Si desea detener el proceso de sincronización, haga clic en este control. Aparecerá una ventana de confirmación, donde podrá hacer clic en
para cancelar la sincronización: todos los componentes ya sincronizados permanecerán así, pero no se realizarán más sincronizaciones a partir de ese momento.
Sincronización de componentes en curso entre el Workspace y la instancia de PLM indicada.
Cuando se ejecuta la sincronización de componentes, el proceso LibSync avanza por su flujo de trabajo predefinido hasta que finaliza o encuentra un error. Actualice el navegador (F5) para mostrar el estado actual del proceso de sincronización. Para supervisar o revisar el proceso LibSync, seleccione la pestaña Synchronization status y elija la opción de listado Closed; si un proceso sigue en ejecución, aparecerá en el listado Active. El botón
, disponible para los administradores, permite descargar un registro detallado de todas las actividades de sincronización enumeradas en un archivo CSV delimitado por comas (Synchronisation status.csv).
Las subpestañas de la vista proporcionan la siguiente información:
-
Diagram – un gráfico que representa el flujo de trabajo del proceso, con el paso actual resaltado (completado o el estado de error/fallo).
-
Data – un resumen informativo de la acción del proceso, que incluye el éxito o el fallo de sus pasos y un enlace al informe registrado del proceso; consulte más abajo.
-
History – un registro cronológico de los principales eventos de sincronización del Workspace, enumerados en secuencia.
Los resultados del proceso LibSync también están disponibles en la página Process Management (Admin » Processes), en la pestaña Browser.
Los detalles del evento LibSync seleccionado que se muestran en la subpestaña Data incluyen un enlace al archivo de registro del sistema (PLM [fecha-número].log) correspondiente al evento.
Sincronización programada
También puede programar la sincronización automática. Para ello, edite la instancia de PLM (en la página principal PLM Integration, haga clic en su nombre o en el control asociado), seleccione la pestaña Component Synchronisation y habilite la opción Synchronize PLM Components with server on schedule. Utilice los controles Synchronize every para configurar la programación de la sincronización automática según sus necesidades. El sistema es muy flexible y le permite:
- Configurar la sincronización programada cada 15/30/45/60/75/90 minutos.
- Configurar la sincronización programada cada x horas.
- Configurar una sincronización diaria programada para que se realice a una hora determinada.
La programación que defina se reflejará en la página principal PLM Integration, en la columna Sync scheduled.
Configuración de una programación de sincronización.
También puede ejecutar el proceso de sincronización bajo demanda. Haga clic en el botón
y elija el modo de sincronización que necesite:
-
Incremental – en este modo, se incluirán en la sincronización only aquellos componentes que se hayan modificado desde la última sincronización (es decir, cuya marca de tiempo sea posterior a la fecha de la última sincronización) y que cumplan los criterios de sincronización del archivo de configuración, propagándose los cambios según corresponda. Este es el modo predeterminado y es el mismo que se ejecuta al hacer clic en el control
de una instancia de PLM en la página principal PLM Integration.
- Full – este modo fuerza una sincronización completa. Todos los componentes que cumplan los criterios de sincronización del archivo de configuración se incluirán en la sincronización, propagándose los cambios según corresponda.
Flujos de trabajo de procesos
Las siguientes definiciones de procesos (y sus flujos de trabajo subyacentes) están disponibles a través del Workspace para permitir la integración con PLM:
-
Part Requests categoría de procesos:
- Part Request with PLM Part Create – permite la creación automática de un componente en su instancia de PLM y la posterior propagación del número de pieza generado al componente del Workspace. El diagrama del flujo de trabajo se muestra a continuación.
Es importante tener en cuenta que, al modificar esta definición de ejemplo para crear la suya propia, debe especificar la instancia de PLM en la que se crearán las piezas. Seleccione la entidad Create Part in PLM en el diagrama del flujo de trabajo y elija la instancia de PLM en el menú desplegable asociado al campo PLM Instance. Este menú muestra todas las instancias de PLM definidas actualmente (según lo definido en la página PLM Integration de la interfaz).
► Consulte Creación y gestión de procesos para obtener más información sobre cómo trabajar con flujos de trabajo de procesos.
- Project Activities categoría de procesos:
- Publish to PLM (User selects) – publicación de los archivos de salida liberados de un proyecto gestionado en la instancia de PLM integrada, donde el usuario puede seleccionar exactamente qué archivos de salida se publican. El diagrama del flujo de trabajo se muestra a continuación.
- Project Releaser with Publish – publicación en la instancia de PLM integrada como una etapa adicional de Project Releaser. El diagrama del flujo de trabajo se muestra a continuación.
-
Project Creations categoría de procesos:
- Project with initialise in PLM – permite la creación automática de números de pieza en su instancia de PLM y su posterior propagación como parámetros del proyecto de diseño del Workspace. El diagrama del flujo de trabajo se muestra a continuación.
Acceso a los procesos relacionados con PLM
Las siguientes secciones indican dónde acceder a los procesos activados relacionados con PLM. Dado que los ejemplos no se pueden utilizar directamente tal como se proporcionan, se han creado los siguientes a partir de ellos con fines ilustrativos:
- PR with PLM Part Create – creado a partir de la definición de proceso de ejemplo: Part Request with PLM Part Create.
- Publish to Company PLM – Choose Data – creado a partir de la definición de proceso de ejemplo: Publish to PLM (User selects).
- Project Releaser with Publish to Company PLM – creado a partir de la definición de proceso de ejemplo: Project Releaser with Publish.
- Create Project with PLM Initialise – creado a partir de la definición de proceso de ejemplo: Project with Initialise in PLM.
Solicitudes de piezas
Acceda desde Altium Designer a través del panel Explorer, después de realizar una búsqueda, desde el panel Details del panel Manufacturer Part Search, o desde el enlace situado en la parte inferior de la lista de componentes del panel Components.
Desde la interfaz del espacio de trabajo, se puede acceder a la definición de proceso activada desde la página Part Requests, haciendo clic en el botón
situado en la parte superior derecha de la página.
Ejemplo de solicitud de componente
El siguiente ejemplo muestra brevemente la creación de un nuevo componente en el espacio de trabajo, seguida de la creación automática de un componente correspondiente en la instancia de PLM. A continuación, el número de componente generado se propaga desde la instancia de PLM al componente del espacio de trabajo como parámetro de elemento, lo que significa que no es necesario publicar una nueva revisión del componente del espacio de trabajo. En este ejemplo, la definición de proceso utilizada es Part Request with PLM Part Create, derivada de la definición de ejemplo Part Request with PLM Part Create.
- Inicie el proceso de solicitud de componente y rellene el formulario que aparece a continuación, detallando la solicitud inicial según sea necesario. En la imagen siguiente, la solicitud se envía a través de la página Part Requests de la interfaz del espacio de trabajo y se solicita un único componente.
- La nueva solicitud de componente se mostrará como un proceso activo en la página Part Requests, con su estado actual reflejado tanto en la entrada principal como en el diagrama de su flujo de trabajo subyacente.
-
Una vez que el usuario correspondiente haya aceptado la tarea de trabajar en la solicitud (o se le haya asignado), creará los componentes solicitados. Cada componente creado (o seleccionado) para satisfacer la solicitud se añade al campo Components de la tarea. Los componentes añadidos se crearán automáticamente en el PLM. En la imagen siguiente, se ha creado y añadido un único componente: CMP-007-00004. Asegúrese de que el campo Next step esté configurado en Completed y haga clic en el botón
.
Es posible que se le soliciten las credenciales de acceso al sistema PLM especificado en el flujo de trabajo del proceso de solicitud de componente.
- El flujo de trabajo del proceso continuará y el componente especificado se creará en la instancia de PLM. Una vez finalizado el proceso, podrá ver el número de componente de PLM generado en la pestaña Data de los procesos. Asegúrese de cambiar el filtro (arriba a la izquierda) para ver los procesos Closed.
- De vuelta en Altium Designer, localice el componente creado en el panel Explorer y cambie a la vista de su pestaña Preview . En la sección de parámetros, observe que se ha añadido un parámetro adicional, PlmPartNumber, cuyo valor es el número del componente correspondiente creado en el PLM.
Tenga en cuenta que el parámetro se ha añadido al componente, pero su revisión sigue siendo la misma: el componente no se ha vuelto a publicar. Esto se debe a que el parámetro es de nivel de elemento: se añade al propio elemento de componente y está disponible en todas sus revisiones.
Actividades del proyecto
Los datos de diseño del proyecto publicados desde Altium Designer en el espacio de trabajo se pueden propagar al PLM de forma controlada mediante los procesos de publicación en PLM del espacio de trabajo. Estos procesos definen la interfaz y la metodología de la actividad de publicación, y la plantilla de publicación XML especificada define cómo se propagan los datos de los archivos al sistema PLM de destino.
Compatibilidad con carpetas de publicación para Windchill PLM
Al configurar un proceso de publicación en PLM para Windchill® PLM, también puede especificar (y crear) una carpeta de destino de Windchill para los documentos publicados desde el espacio de trabajo.
Los parámetros de la carpeta de Windchill correspondiente se definen en el archivo XML de la plantilla de publicación que se aplica a la entrada de integración de Windchill PLM en el espacio de trabajo. Los nodos de definición de carpetas tienen el formato de etiqueta <pt:Folder>xxx</pt:Folder>, donde pt es el espacio de nombres actual y xxx es la ruta completa de la carpeta, y se colocan como regla de publicación dentro de la sección FileDistribution para cada tipo de documento (por ejemplo, una salida de fabricación PCB.zip).
Un ejemplo de la jerarquía de la estructura XML de publicación sería:
<pt:EntityRule id="FAB">
<pt:FileDistributions>
<pt:FileDistribution archiveName="PCB.zip">
<pt:Folder>PRODUCT/Projects/${project.name}/FAB data</pt:Folder>
La última línea de entrada especificaría (o crearía) una carpeta de destino de publicación para la salida de fabricación PCB.zip con la estructura de carpetas de Windchill (donde el nombre del proyecto es MyProject):
PRODUCT
Projects
MyProject
FAB data
Tenga en cuenta que la ruta de la carpeta definida en el archivo XML de publicación es absoluta (no relativa) y puede incluir otras propiedades del proyecto, como el nombre del proyecto (${project.name}) y el número de ensamblaje (${project.PLM_ASSEMBLY_NUMBER}).
Proceso de publicación estándar
En el entorno de diseño, se puede acceder al proceso estándar de publicación en PLM desde Altium Designer a través del submenú Project » Project Activities del proyecto activo.
Desde la interfaz del espacio de trabajo, se puede acceder a las definiciones de proceso activas desde la vista Project Management, haciendo clic en el botón
.
Publicación con Project Releaser
Se puede acceder al proceso de publicación en una instancia de PLM como parte de Project Releaser desde Altium Designer, a través del submenú Project » Project Releaser del proyecto activo.
Aparecerá Project Releaser con una etapa adicional: 7: Publish to PLM. Además, en el menú asociado al botón
está disponible el comando Prepare & Release & Publish to PLM, por si desea ejecutar Project Releaser sin detenerse a revisar los datos generados y el informe de ejecución.
Definición del nombre de la etapa
Si utiliza la definición de proceso de ejemplo, Project Releaser with Publish, para crear su propia definición, el nombre de la etapa que se muestra en el cliente de diseño es Publish to PLM de forma predeterminada. El comando compuesto del menú desplegable del botón Project Releaser
también incorpora este nombre: Prepare & Release & Publish to PLM.
Sin embargo, puede cambiar la forma en que esto (y la descripción emergente asociada a la etapa) se presenta a los usuarios. Los campos para hacerlo están disponibles en el flujo de trabajo subyacente del proceso, cuando se selecciona el elemento Start (de tipo Start Release). Estos campos son:
- Action name – el nombre de la acción posterior a la liberación del proyecto, que es el nombre de la etapa que se muestra como etapa 7 en Project Releaser. Es obligatorio introducir un valor en este campo si hay tareas definidas en el flujo de trabajo del proceso. Este nombre también se utilizará para el comando de menú, con el formato Prepare & Release & <Action name>.
- Action description – descripción de la acción posterior a la liberación del proyecto, que se presenta al usuario en Project Releaser como información sobre herramientas de la entrada de la etapa 7.
Configuración predeterminada del elemento Start en un flujo de trabajo basado en la definición de proceso de ejemplo Project Releaser with Publish, y su presentación en Project Releaser.
La siguiente imagen muestra estos campos modificados en el flujo de trabajo subyacente y el efecto resultante en las entradas de Project Releaser.
Configuración modificada del elemento Start cuando se utiliza en un flujo de trabajo para publicar en PLM a través de Project Releaser.
Si ejecuta Project Releaser con el comando estándar Prepare , después de revisar y liberar los datos, se mostrará el botón
en la etapa Execution Report. Haga clic en él para continuar el flujo de trabajo subyacente del proceso y publicar en PLM. Aparecerá el cuadro de diálogo Login Credentials. Introduzca Username y Password de su instancia de PLM y seleccione la plantilla de PLM que desea utilizar (que aparece con el formato <PLMInstance>:<PublishingTemplate>).
Haga clic en la pestaña Diagram para ver el flujo de trabajo subyacente del proceso.
Haga clic en el botón
para continuar con el proceso de publicación, de acuerdo con ese flujo de trabajo.
Compruebe el estado del proceso de publicación en PLM a través de la interfaz del espacio de trabajo seleccionando la vista Activities dentro de la vista detallada del proyecto, una vez abierto el proyecto desde la vista Projects. Seleccione la opción de vista Opened para ver el estado mientras se ejecuta el proceso, y la opción de actividades Closed para acceder a la información de estado cuando el proceso haya finalizado.
Creación de proyectos
En el entorno de diseño, acceda desde Altium Designer a través del submenú principal File » New » Project in <workspace>.
Desde la interfaz del espacio de trabajo, se puede acceder a la definición de proceso activada desde la vista Projects haciendo clic en el botón
.
También se puede acceder al clonar un proyecto, desde el botón de menú
de la vista Projects.
El flujo de trabajo del proceso continuará y mostrará un cuadro de diálogo que le permitirá definir el nombre, la descripción y el tipo del proyecto, así como cualquier elemento de plantilla de proyecto que deba utilizarse para crearlo. Después de hacer clic en Start, aparecerá el cuadro de diálogo Login Credentials. Introduzca Username y Password de su instancia de PLM y seleccione la plantilla de PLM que desea utilizar (que aparece con el formato <PLMInstance>:<PublishingTemplate>). A continuación, haga clic en Submit para continuar con el flujo de trabajo.
Ejemplo de creación de un proyecto
El siguiente ejemplo muestra brevemente la creación de un nuevo proyecto, con inicialización en PLM. El proceso se inicia desde Altium Designer mediante la definición Create Project with PLM Initialise, derivada de la definición de ejemplo Project with Initialise in PLM.
- Después de iniciar el proceso (File » New » Project in <workspace> » Create Project with PLM Initialise), aparece un cuadro de diálogo (con el nombre de la definición de proceso) que permite definir el proyecto. En este ejemplo, simplemente llamaremos al proyecto Example_Project_with_PLM_Init, le daremos una descripción y dejaremos sin cambios todos los demás campos, incluidos los de la pestaña Advanced .
-
Una vez definido el proyecto, haga clic en el botón
. Aparecerá el cuadro de diálogo Login Credentials. Al tratarse de un proyecto nuevo, debe proporcionar sus credenciales de inicio de sesión en PLM e indicar la instancia de PLM y la plantilla de publicación asociada que se utilizarán. Este ejemplo utiliza un archivo de configuración y una plantilla de publicación asociada (según lo solicitado) para un PLM de Arena.
Una vez proporcionadas las credenciales y seleccionadas la instancia de PLM y la plantilla de publicación, haga clic en el botón
.
-
El proceso continuará hasta completarse (siempre que no se produzcan errores), tal como puede verse en el panel Tasklist, dentro de la lista de Activities cerradas: marque la opción Show closed en el menú del botón
asociado. Seleccione la entrada de actividad para obtener más información sobre el proceso completado y su conjunto de datos.
El proceso completado y su información relacionada también se pueden consultar en la interfaz del espacio de trabajo seleccionando la vista Activities dentro de la vista detallada del proyecto, una vez abierto el proyecto desde la vista Projects. Seleccione la opción de actividades Closed (arriba a la derecha) para acceder a la información de estado del proceso completado.
-
En Altium Designer, el nuevo proyecto aparece en el panel Projects, pendiente de confirmación en el repositorio de diseño Versioned Storage basado en Git del espacio de trabajo. Para confirmarlo, haga clic con el botón derecho en la entrada del proyecto y utilice el comando Save to server. A continuación, puede añadir documentos fuente y empezar a diseñar. Cuando llegue el momento de publicarlo, el proyecto ya estará vinculado a las piezas correspondientes de la instancia de PLM.
En la pestaña Server Parameters del cuadro de diálogo Project Options, o en la lista de parámetros del proyecto del panel Explorer, puede ver los números de pieza asignados en la instancia de PLM que corresponden a las entidades del proyecto que se pueden liberar o publicar.
La relación entre los nombres de los parámetros de PLM y los paquetes de liberación del proyecto se especifica en el archivo de configuración de PLM, que a su vez viene determinado por los atributos de nombre y numeración requeridos por el sistema PLM.
Al colocar una cadena de texto en un esquema, los parámetros de PLM asociados al proyecto estarán disponibles como cadenas especiales:













































