Liberación a un Workspace

De un vistazo

Aprende a publicar tu diseño en un Workspace conectado mediante el flujo de trabajo por etapas del modo en línea de Project Releaser en Altium Designer. Este artículo explica cómo seleccionar los datos de publicación, asignar tareas de salida, configurar los nombres de los elementos del Workspace y las revisiones de destino, y avanzar por las etapas de validación, generación de datos, revisión y carga. También aborda la publicación en PLM cuando se utiliza un proceso de publicación compatible. Sigue leyendo para configurar tu publicación y comprender qué ocurre en cada etapa.

- Identifica qué conjuntos de datos de origen, fabricación, ensamblaje, variantes y personalizados incluir, y cómo asignar las tareas de salida necesarias.
- Comprende las opciones de destino de la publicación, los esquemas de nomenclatura de los elementos del Workspace y los controles de las revisiones de destino.
- Sigue las etapas de publicación y descubre cómo los comandos de publicación automatizados afectan a la revisión, la generación de informes y la publicación en PLM.
Profundiza con IA:

Con la vista Release en Online Mode, el proceso de liberación sigue un flujo por etapas, con las entradas del lado izquierdo de la vista que le muestran de un vistazo en qué etapa se encuentra:

  1. Configure Server Release – en esta etapa del proceso de liberación se especifican los tipos de datos que se desean generar: datos de origen (siempre se generan), datos de fabricación y datos de ensamblaje (para el diseño base y cada variante detectada).

  2. Validate Project – esta siguiente etapa del proceso de liberación se ejecuta automáticamente cuando se detectan uno o más informes de tipo validación en los archivos OutJob asignados. Se ejecutan todos los generadores de salidas de validación definidos en un archivo Output Job asignado al elemento de datos que se está liberando.

  3. Generate Data – esta siguiente etapa del proceso de liberación se ejecuta automáticamente. Aquí se ejecutan todas las demás salidas, definidas en los archivos OutJob asignados a los elementos de datos incluidos, para generar los datos que se liberarán en los elementos de destino correspondientes del espacio de trabajo.

  4. Review Data – una vez superadas todas las comprobaciones de validación y generados los datos de salida, esta etapa del proceso de liberación permite revisar los datos generados.

    Si decide utilizar los comandos Prepare & Release o Prepare & Release & Publish to PLM (del menú asociado al botón ), el Project Releaser no se detendrá en la etapa Review Data.

  5. Upload Data – tras confirmar la liberación en la etapa anterior, se accede automáticamente a esta siguiente etapa. Simplemente muestra el progreso de la carga de datos en las revisiones de los elementos de datos correspondientes del espacio de trabajo de destino.

  6. Execution Report – esta es la etapa final del proceso y proporciona un resumen de la liberación. Se ofrecen enlaces de navegación para acceder rápidamente a las revisiones de elementos generadas en el panel Explorer. Si ha accedido al Project Releaser como parte de un proceso de liberación y publicación en un PLM, se mostrará el botón . Haga clic en él para continuar con el flujo de trabajo subyacente del proceso y publicar en el PLM.

    Si decide utilizar el comando Prepare & Release & Publish to PLM (del menú asociado al botón ), el Project Releaser no se detendrá en la etapa Execution Report y no se mostrará ningún botón .
  7. Publish to PLM – esta etapa solo está presente cuando se ejecuta la liberación mediante el proceso activado correspondiente (para liberar y, a continuación, publicar en un PLM). Se accede a esta etapa automáticamente al hacer clic en el botón de la etapa anterior (o se accede directamente si se ha utilizado el comando Prepare & Release & Publish to PLM del menú asociado al botón ). Aparecerá el cuadro de diálogo Login Credentials. Introduzca el Username y la Password de su instancia de PLM y seleccione la plantilla de PLM que desea utilizar (que aparece con el formato <PLMInstance>:<PublishingTemplate>).

    Tenga en cuenta que las credenciales de inicio de sesión de su instancia de PLM solo son necesarias la primera vez que publica en dicha instancia. Después, se almacenarán en el espacio de trabajo. A partir de ese momento, cualquier publicación de ese proyecto en la misma instancia de PLM se realizará directamente, de acuerdo con el flujo de trabajo definido y la plantilla de publicación seleccionada.
    Si publica por primera vez y los números de pieza (en el PLM) aún no están asociados al proyecto del espacio de trabajo, dichos números se crearán en el PLM y se asociarán al proyecto como parte de esa publicación inicial. También puede definir entradas de componentes en la instancia de PLM para los componentes del espacio de trabajo como parte de la operación de publicación, a fin de obtener una lista de materiales de componentes en el PLM (opcional, según la plantilla de publicación definida y utilizada al publicar el proyecto en la instancia de PLM).

Etapa en línea 1 – Configurar la liberación al servidor

En esta etapa del proceso de liberación se especifican los tipos de datos que se desean generar. Los elementos de datos que se pueden liberar son:

  • Source Data – una instantánea del diseño de origen.
  • Fabrication Data – los datos que necesita un fabricante de PCB para crear la placa sin componentes.
  • Assembly Data for the Base Design (no variations) – los datos que necesita un proveedor de ensamblaje para montar todos los componentes en la placa de acuerdo con una lista de materiales y para el diseño base sin variantes.
  • Assembly Data for Design Variant n – los datos que necesita un proveedor de ensamblaje para montar los componentes en la placa de acuerdo con una lista de materiales y para Variant n del diseño base.

El número de conjuntos de datos de ensamblaje corresponderá al diseño base (sin variantes) y a todas las variantes detectadas que estén definidas para ese diseño.

Además, puede añadir y configurar secciones Custom Data, lo que le permite crear un conjunto personalizado de datos de liberación. Esto está pensado principalmente para la compatibilidad con versiones anteriores o para flujos de datos personalizados. No se crean referencias, excepto para los datos de origen. Se puede añadir y configurar cualquier número de conjuntos de datos personalizados como parte de la liberación (haga clic en el control Add Section situado debajo de la lista de elementos de datos definidos actualmente).

Etapa 1 del proceso de liberación del proyecto: configurar qué se incluirá en la liberación (qué datos se generarán).
Etapa 1 del proceso de liberación del proyecto: configurar qué se incluirá en la liberación (qué datos se generarán).

El elemento Source Data siempre se incluye en una liberación. Los demás elementos de datos se pueden incluir de forma opcional.

Una vez configurados según sea necesario los elementos de datos que se crearán como parte de la publicación, haga clic en el botón situado en la parte inferior derecha de la vista para continuar.

El botón tiene dos estados. Al hacer clic en él, se ejecutará el comando estándar Prepare. Esto hará avanzar la publicación hasta la etapa Review Data, lo que le permitirá comprobar que todo está en orden antes de confirmar la publicación de los datos. Si no desea detenerse para revisar, utilice el menú desplegable asociado al botón y elija el comando Prepare & Release.

Como parte de la preparación, se realizan varias comprobaciones previas a la publicación, entre ellas:

  • Comprobar que se hayan guardado el proyecto y todos los archivos.
  • Comprobar que se hayan confirmado en el VCS el proyecto y todos los archivos pertinentes, si corresponde.
  • Comprobar que se haya asignado un nombre a cada elemento de datos habilitado.
  • Garantizar que el usuario tenga permisos para crear el elemento de destino (y su revisión).
  • Crear los elementos de destino necesarios (y las revisiones planificadas) en el espacio de trabajo, si aún no existen, y garantizar que se utilice la siguiente revisión para los elementos que ya existen.

Si se detecta algún problema, se le ofrecerán soluciones para resolverlo (como guardar los archivos modificados localmente y confirmarlos en el VCS).

Si se encuentran documentos externos en el proyecto que se está publicando (documentos asociados al proyecto, pero almacenados en una carpeta distinta de la carpeta del proyecto o de una de sus subcarpetas), se abrirá el cuadro de diálogo External files, con una lista de los documentos externos (). Para evitar posibles problemas, se recomienda almacenar todos los documentos asociados al proyecto en la carpeta del proyecto o en una de sus subcarpetas.

El elemento Source Data se genera en este momento, y se publica una instantánea de los archivos fuente del proyecto de diseño en la revisión del elemento de destino.

Etapa en línea 2: Validar el proyecto

Una vez completada la etapa 1 sin problemas, esta siguiente etapa del proceso de publicación se ejecuta automáticamente cuando se detectan uno o más informes de tipo validación en los archivos OutJob asignados. Se ejecutan todos los generadores de salidas de validación definidos en un archivo Output Job asignado al elemento de datos que se está publicando. Esto incluye la ejecución de cualquiera de las siguientes comprobaciones:

  • Differences Report – utilizar el comparador para determinar si los documentos fuente y los documentos de diseño de PCB están correctamente sincronizados.
  • Electrical Rules Check – comprobar la validez eléctrica y de dibujo del diseño fuente capturado.
  • Design Rules Check – comprobar la validez del documento de PCB con respecto a las restricciones de diseño especificadas a nivel de placa.
  • BOM Checks – comprobar si existen posibles infracciones asociadas a los elementos de diseño o a las opciones de componentes del documento BOM fuente (*.BomDoc), cuando esté disponible.
  • Footprint Comparison Report – comparar las huellas de la placa con su biblioteca de origen para garantizar que estén actualizadas y coincidan.
  • Component State Checking – comprobar si hay componentes en estados restringidos. Como parte de la configuración, se determina la acción que se debe realizar para cada estado definido de cada definición de ciclo de vida definida en el espacio de trabajo de destino: ninguna acción, una advertencia o generar un error. Esta última opción impedirá la publicación del diseño. Además, al ejecutar la comprobación se generará un práctico informe en HTML que le permitirá ver de un vistazo qué componentes del diseño no se encuentran en estados válidos.
  • Environment Configuration Compliance Check – comprobar que solo se utilicen elementos de datos permitidos por la configuración del entorno disponible para su rol asignado (si corresponde). Esta comprobación también puede garantizar que todos los elementos de diseño procedan de un espacio de trabajo.

Si la validación se completa correctamente, se muestra el icono con el texto Passed. De lo contrario, se mostrará el icono con el texto Failed.

La publicación fallará si no se supera alguna de las comprobaciones de validación.
Al hacer clic en en la parte inferior derecha de la vista, se detendrá el proceso de publicación.

Etapa en línea 3: Generar datos

Una vez completada la etapa 2 sin problemas, esta siguiente etapa del proceso de publicación se ejecuta automáticamente. En ella se ejecutan todas las demás salidas, definidas en los archivos OutJob asignados a los elementos de datos incluidos, para generar los datos que se publicarán en los elementos de destino correspondientes del espacio de trabajo.

Al igual que en las demás etapas, aunque resulta más evidente en esta porque tarda más en ejecutarse, se utilizan iconos para mostrar el progreso de la generación:

– aún no se ha ejecutado/generado.

– en proceso de ejecución/generación.

– generado correctamente.

– error de generación.

Al hacer clic en en la parte inferior derecha de la vista, se detendrá el proceso de publicación.

Etapa en línea 4: Revisar datos

Una vez superadas todas las comprobaciones de validación y generados los datos de salida, esta etapa del proceso de publicación le permite revisar los datos generados.

Si opta por utilizar el comando Prepare & Release (del menú asociado al botón ), Project Releaser no se detendrá en la etapa Review Data.

Revise los datos generados y compruebe que todo esté como debe antes de confirmar la publicación y cargar los datos en el espacio de trabajo.
Revise los datos generados y compruebe que todo esté como debe antes de confirmar la publicación y cargar los datos en el espacio de trabajo.

De forma predeterminada, la página muestra una vista simple (compacta) de los datos generados. Para cambiar a una vista más detallada, haga clic en el control Details asociado a la sección que le interese.

Haga clic en un control Details para cambiar de la vista simple a la vista detallada de los datos generados de la sección asociada. Para volver a la vista anterior, haga clic en el control Hide Details.
Haga clic en un control Details para cambiar de la vista simple a la vista detallada de los datos generados de la sección asociada. Para volver a la vista anterior, haga clic en el control Hide Details.

En la vista compacta de los datos generados, haga clic en un enlace View para abrir el archivo de datos o conjunto de archivos asociado, ya sea en el editor correspondiente de Altium Designer (p. ej., el editor CAM para archivos Gerber o archivos ODB++ comprimidos o sin comprimir) o en la aplicación externa correspondiente (p. ej., Microsoft Excel para una lista de materiales). En la vista detallada, haga doble clic en una entrada para ver únicamente ese archivo.

Una prueba habitual que utilizan muchos diseñadores para comprobar si todo está listo para la publicación consiste en comparar los archivos Gerber generados para la versión actual con los de la versión anterior. Haga clic en el enlace Compare Gerber situado junto a una salida Gerber y seleccione una versión anterior en el menú desplegable para comparar los datos Gerber preparados con los de la versión seleccionada. Su navegador predeterminado abrirá el Workspace de su empresa y mostrará los resultados.

Acceso a la función de comparación de Gerber desde Project Releaser, antes de publicar los datos en un Workspace.
Acceso a la función de comparación de Gerber desde Project Releaser, antes de publicar los datos en un Workspace.

► Obtenga más información sobre la función Gerber Comparison (Altium 365 Workspace, Workspace de Enterprise Server).

En la sección Source Data, en la vista compacta, al hacer clic en el enlace View se abrirá el Explorador de archivos de Windows en la carpeta temporal en la que se ha guardado la instantánea de los archivos fuente del proyecto. Esta función también está disponible mediante el enlace Explore, situado a la derecha del encabezado de la sección. De hecho, cada sección dispone de un control de este tipo para acceder rápidamente a la subcarpeta de esos datos dentro de la carpeta temporal.

En la vista detallada, los comandos del menú contextual que aparece al hacer clic con el botón derecho permiten abrir un documento y acceder a la ubicación donde se ha generado (en la carpeta temporal). También puede añadir columnas de datos para la ubicación de la carpeta y la fecha de creación: haga clic con el botón derecho en el área de encabezado de una tabla y elija el comando Select Columns para acceder a un cuadro de diálogo que le permitirá personalizar los datos mostrados.

Si, después de revisar los datos, necesita realizar modificaciones, haga clic en el botón situado en la esquina inferior derecha de la vista. Aparecerá un cuadro de diálogo de confirmación que le advertirá de que se perderán todos los datos generados: al hacer clic en OK, se cancelará la publicación y volverá a la etapa 1 del proceso.

El sistema impide cualquier modificación de los archivos de diseño entre la preparación de la publicación y la publicación de los datos en el Workspace. Si modifica los archivos de diseño de cualquier forma, el proceso de publicación finalizará y volverá a la etapa inicial, anterior a la preparación de la publicación.

Si todos los datos generados son correctos, continúe con la publicación haciendo clic en el botón (también situado en la esquina inferior derecha de la vista). Aparecerá el cuadro de diálogo Confirm Release, con un resumen de las configuraciones del proyecto que se publicarán en el Workspace. Aquí también puede añadir un Name (la entrada predeterminada es [ProjectName]), Description y las notas de publicación que considere pertinentes.

Confirmación de lo que se publicará, en términos de las revisiones de elementos generadas, y posibilidad de cambiar el nombre y la descripción y añadir notas de publicación.
Confirmación de lo que se publicará, en términos de las revisiones de elementos generadas, y posibilidad de cambiar el nombre y la descripción y añadir notas de publicación.

Etapa en línea 5: Cargar datos

Tras confirmar la publicación en la etapa anterior, se accede automáticamente a esta etapa. Simplemente muestra el progreso de la carga de datos en las revisiones de los elementos de datos correspondientes del Workspace.

Esta etapa solo refleja el progreso de la carga de los datos generados en las revisiones de elementos vinculadas del Workspace.
Esta etapa solo refleja el progreso de la carga de los datos generados en las revisiones de elementos vinculadas del Workspace.

Etapa en línea 6: Informe de ejecución

Esta es la última etapa del proceso y proporciona un resumen de la publicación.

El informe final de la publicación.
El informe final de la publicación.

Utilice los enlaces de navegación para acceder rápidamente a la revisión del elemento asociada, que contiene los datos publicados (datos de fabricación, datos de ensamblaje y cualquier conjunto de datos personalizados), en el panel Explorer, su portal de acceso al Workspace.

Visualización de los datos publicados del proyecto directamente en el Workspace, a través del panel Explorer.
Visualización de los datos publicados del proyecto directamente en el Workspace, a través del panel Explorer.

Los parámetros definidos para las variantes del proyecto se incluyen en las revisiones correspondientes de los conjuntos de datos de ensamblaje. Al visualizar el proyecto en Classic View del panel Explorer, seleccione la revisión del conjunto de datos de ensamblaje que necesite y cambie a la pestaña de vista de aspecto Parameters para ver los parámetros de la variante.

Se ha añadido un parámetro de variante VariantLabel = A a la variante del proyecto Default. El conjunto de datos de ensamblaje publicado incluye este parámetro, que se encuentra en la pestaña de vista de aspecto Parameters del panel Explorer.
Se ha añadido un parámetro de variante VariantLabel = A a la variante del proyecto Default. El conjunto de datos de ensamblaje publicado incluye este parámetro, que se encuentra en la pestaña de vista de aspecto Parameters del panel Explorer.

Eso es todo: una vez publicado el proyecto, puede cerrar la vista Release (mediante el botón situado en la esquina inferior derecha de la vista). Y cuando necesite volver a publicar el mismo proyecto en el futuro, Project Releaser le permitirá hacerlo de forma rápida y sencilla, e incrementará automáticamente las revisiones de los elementos de destino.

Cada vez que publique el proyecto, un Project Released se añadirá un recuadro de evento a la línea de tiempo de la vista History del proyecto. La persona que realizó la liberación se muestra con su nombre (y foto), junto con la fecha y la hora. Si se añadió una nota de liberación al liberar los datos generados al espacio de trabajo —a través del diálogo Confirmar liberación—, también se mostrará en el recuadro. También se enumerarán todos los conjuntos de datos incluidos en la liberación.

Tenga en cuenta que, si el último commit del proyecto aún no tiene una etiqueta, se le asignará una automáticamente. Esta etiqueta tendrá el formato RELEASE_<RevisionID>, donde <RevisionID> es el número de revisión de los archivos fuente del proyecto liberados (A.1, A.2, etc.), por ejemplo, RELEASE_A.3.

Ejemplo de recuadro de evento Project Released en la vista History del proyecto. Como el último commit del proyecto no tenía ninguna etiqueta, se le asignó una después de la liberación.
Ejemplo de recuadro de evento Project Released en la vista History del proyecto. Como el último commit del proyecto no tenía ninguna etiqueta, se le asignó una después de la liberación.

► Más información sobre el historial del proyecto.

Publicación en una instancia de PLM

Related pages: Integración con PLM (espacio de trabajo de Altium 365, espacio de trabajo de Enterprise Server), Publicación en un PLM

Puede publicar un diseño en una instancia de PLM como parte de la ejecución del Project Releaser en Altium Designer. La operación de publicación utiliza una plantilla de publicación —definida como parte de la configuración de integración de esa instancia de PLM— para controlar cómo se deben transferir los datos al PLM. Esta función está disponible mediante un proceso configurado adecuadamente. La instalación incluye una definición de proceso de ejemplo —Project Releaser with Publish— cuyo flujo de trabajo subyacente permite publicar en la instancia de PLM integrada como una etapa adicional de Project Releaser. A continuación se muestra el diagrama del flujo de trabajo.

Esta definición de proceso no se puede activar ni utilizar tal cual. Por lo tanto, funciona más bien como una «plantilla»: edítela para adaptarla a los requisitos de su empresa, asígnele un nombre y guárdela como una nueva definición de proceso, que can podrá activar y utilizar después.

El diagrama del flujo de trabajo de la definición de proceso de ejemplo predeterminada Project Releaser with Publish
El diagrama del flujo de trabajo de la definición de proceso de ejemplo predeterminada Project Releaser with Publish

Una vez activado, se puede acceder al proceso para publicar en una instancia de PLM como parte del Project Releaser desde Altium Designer, a través del submenú Project » Project Releaser del proyecto activo o del submenú contextual Project Releaser, al que se accede haciendo clic con el botón derecho en la entrada del proyecto de diseño en el panel Projects.

Acceso al proceso para publicar en una instancia de PLM como parte del Project Releaser
Acceso al proceso para publicar en una instancia de PLM como parte del Project Releaser

Aparecerá el 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 el Project Releaser sin detenerse a revisar los datos generados y el informe de ejecución.

Un comando adicional para ejecutar el Project Releaser sin detenerse a revisar los datos generados y el informe de ejecución
Un comando adicional para ejecutar el Project Releaser sin detenerse a revisar los datos generados y el informe de ejecución

Si ejecuta el 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 con el flujo de trabajo subyacente del proceso y publicar en el PLM. Aparecerá el diálogo Login Credentials. Introduzca el Username y la Password de su instancia de PLM y seleccione la plantilla de PLM que desee utilizar (que aparece con el formato <PLMInstance>:<PublishingTemplate>).

Si ha optado por utilizar el comando Prepare & Release & Publish to PLM, al final se le mostrará directamente el diálogo Login Credentials. El Project Releaser no se detendrá en la etapa Execution Report y no se mostrará ningún botón .
Tenga en cuenta que las credenciales de inicio de sesión de su instancia de PLM solo se solicitan la primera vez que publica en ella. Después, se almacenarán en el espacio de trabajo. A partir de ese momento, cualquier publicación de ese proyecto en la misma instancia de PLM se realizará directamente, de acuerdo con el flujo de trabajo definido y la plantilla de publicación elegida.

El diálogo Login Credentials al que se accede durante la primera publicación en la instancia de PLM.
El diálogo Login Credentials al que se accede durante la primera publicación en la instancia de PLM.

Haga clic en la pestaña Diagram para ver el flujo de trabajo subyacente del proceso.

La pestaña Diagram del diálogo Login Credentials
La pestaña Diagram del diálogo Login Credentials

Haga clic en el botón para continuar con el proceso de publicación de acuerdo con ese flujo de trabajo.

Si va a publicar por primera vez y los números de pieza (del lado del PLM) aún no están asociados al proyecto del espacio de trabajo, se crearán en el PLM y se asociarán al proyecto como parte de esa publicación inicial. También puede definir entradas de componentes en la instancia de PLM para los componentes del espacio de trabajo como parte de la operación de publicación, a fin de obtener una BOM de componentes en el PLM (opcional, según la plantilla de publicación definida y utilizada al publicar el proyecto en la instancia de PLM).
Consulte el estado del proceso de publicación en el PLM a través de la interfaz web del espacio de trabajo, desde la vista Activities de la página de gestión detallada del proyecto. Para abrir la página de gestión detallada del proyecto, seleccione el proyecto correspondiente en la página Projects de la interfaz web del espacio de trabajo, haga clic en el control situado sobre la lista de proyectos y elija la opción Open en el menú asociado. También puede hacer doble clic directamente en la entrada del proyecto correspondiente en la lista. La página se abrirá en una nueva pestaña del navegador. Siempre podrá ver exactamente qué se ha creado, como los números de pieza en la instancia de PLM, en el historial del flujo de trabajo del proceso (pestaña History).
AI-LocalizedLocalizado por IA
Si encuentra un problema, seleccione el texto/imagen y presioneCtrl + Enterpara enviarnos sus comentarios.
Contents
Disponibilidad de funciones

Las funciones disponibles para usted dependen de qué solución de Altium tenga: Altium Develop, Altium Agile Teams, Altium Agile Enterprise o Altium Designer (con suscripción activa).

Si no ve una función documentada en su software actual, contacte con Ventas de Altium para obtener más información.

Documentación heredada

La documentación de Altium Designer ya no está versionada. Si necesita acceder a la documentación de versiones anteriores de Altium Designer, visite la sección Documentación heredada de la página de Otros instaladores.

Contents