Historial del proyecto

Parent page: Proyectos del Workspace

El Workspace de Enterprise Server proporciona una solución elegante para la necesidad de contar con una visión histórica de la actividad del proyecto en forma de una vista History dedicada e interactiva. Se puede acceder a ella a través de la interfaz del navegador del Workspace o desde Altium Designer; la History vista del proyecto ofrece una línea de tiempo progresiva de los eventos principales relacionados con el proyecto. Los eventos incluyen la creación del proyecto, commits, releases, clones e intercambios MCAD, que a su vez ofrecerán comandos de acción de eventos cuando corresponda.

Acceso al historial del proyecto

Se accede a la History vista de un proyecto desde la página detallada de gestión orientada a CAD de ese proyecto: la página Projects Management. Haga clic en la opción History en el panel izquierdo.

La propia página Projects Management se abre desde la página principal Projects haciendo doble clic en una entrada de proyecto, haciendo clic en su título o eligiendo la opción Open del menú . Para obtener más información, consulte Gestión de un proyecto específico.

Acceda al historial de un proyecto desde la página detallada de gestión de ese proyecto.

Línea de tiempo del historial: descripción general

La History vista presenta una línea de tiempo de los eventos básicos que han ocurrido durante la evolución del proyecto. Esencialmente, puede dividirse en tres elementos clave, como se muestra en la siguiente imagen e información.

Identificación de los tres componentes clave de la History vista.

1. Main trunk of the timeline. La cronología de los eventos va de abajo hacia arriba. El primer evento —la creación del proyecto— aparecerá en la parte inferior de la línea de tiempo. Los eventos posteriores aparecen arriba, y el más reciente (el evento actual más reciente) aparece en la parte superior de la línea de tiempo.
2. Events. Cada vez que ocurre un evento compatible (véase más abajo) asociado al proyecto, se añade a la línea de tiempo como un mosaico dedicado. Cada tipo de evento tendrá un mosaico de color diferente y estará enlazado directamente al tronco principal de la línea de tiempo o tendrá un icono de asociación junto a él (como ocurre en los eventos de MCAD Exchange; ).
3. Search. Haga clic en el control situado en la parte superior derecha de la vista para acceder a un campo de búsqueda que facilita la búsqueda básica en el historial del proyecto. A medida que escriba la cadena de búsqueda, se aplicará un filtrado a la línea de tiempo para mostrar solo los eventos relevantes para esa búsqueda. Para obtener más información, consulte Búsqueda filtrada.

Eventos compatibles

La línea de tiempo muestra una progresión de los eventos que suceden durante la vida de un proyecto. Cada uno de estos eventos aparece a lo largo de la línea de tiempo como un “mosaico de evento” dedicado. Las secciones siguientes repasan el conjunto de eventos actualmente compatibles y que pueden mostrarse como parte de la línea de tiempo histórica de un proyecto.

Creación del proyecto

Related pages: Crear un nuevo proyecto del Workspace (interfaz del navegador / Altium Designer), Hacer que un proyecto existente esté disponible en línea, Clonar un proyecto (interfaz del navegador / Altium Designer)

Cuando se crea un proyecto, se añade a la línea de tiempo el mosaico de evento Project Created. Este evento marca el comienzo de la línea de tiempo histórica del proyecto. Como tal, siempre puede encontrarse como la entrada situada en la parte inferior de la línea de tiempo. El mosaico de este evento puede aparecer en dos variantes distintas:

• Cuando el proyecto se crea por primera vez dentro del Workspace. El creador del proyecto se muestra por nombre (e imagen/símbolo), junto con la hora de creación del proyecto. La descripción del proyecto, si se introdujo una en el momento de la creación, también se muestra dentro del mosaico.

• Cuando el proyecto es un clon de un proyecto existente. La persona que creó el proyecto clonado se muestra por nombre (e imagen/símbolo), junto con la hora de creación del proyecto. La descripción del proyecto, si se introdujo una en el momento de la clonación, también se muestra dentro del mosaico. Se proporciona un enlace al proyecto fuente original; al hacer clic en él, se accederá a la página detallada de gestión de ese proyecto, que se abre en una pestaña independiente del navegador.

El mosaico de evento Project Created está conectado físicamente al tronco principal de la línea de tiempo mediante una línea y un nodo de conexión azules sólidos:

Commit del proyecto

Cada vez que guarde el proyecto en el Workspace (donde el proyecto se gestiona en el repositorio interno de Versioned Storage Git del Workspace), se añadirá a la línea de tiempo un mosaico de evento Project Committed. La persona que realizó el commit y push se muestra por nombre (e imagen), junto con la fecha y la hora. Si se añadió un comentario en el momento del commit y push —a través del cuadro de diálogo Save to Server—, este también se mostrará dentro del mosaico.

Ejemplo de mosaico de evento inicial Project Committed.

El mosaico también admite y presenta información de comparación de diseño, mostrando información más detallada sobre lo que ha cambiado entre el commit actual y el anterior. Los elementos compatibles incluyen archivos, componentes, nets, variantes y estructura de PCB. La sección de comparación del mosaico resume los distintos elementos afectados por el evento de commit, agrupados por los siguientes estados:

– elemento añadido.

– elemento eliminado.

– elemento modificado.

Al hacer clic en el control del mosaico, se expandirá esta sección de comparación para presentar los elementos afectados por nombre.

Utilice los controles disponibles Show More y Show Less para examinar la lista completa de cada tipo de elemento. Haga clic en el control del mosaico para volver a la visualización resumida.

Haga clic en el control situado en la esquina superior derecha del mosaico para acceder a un menú con los siguientes comandos:

• View – use este comando para abrir los datos de diseño fuente del commit seleccionado en el Web Viewer como una instantánea del diseño en ese momento.
• Create Tag – añada un nombre de etiqueta VCS al commit actualmente seleccionado. Las etiquetas asociadas a un commit aparecen en su mosaico de la vista History, en el encabezado de su vista de instantánea en el Web Viewer y en cualquier comentario asociado a esa vista de instantánea. Una vez que se ha añadido una etiqueta a un commit, el comando del menú del mosaico cambia a Tag y ofrece subopciones para modificar (Edit) o eliminar (Remove) la etiqueta del commit.

Seleccione la opción de menú Create Tag para añadir un nombre de etiqueta a un evento History de commit.

La vista de instantánea de un evento History de commit etiquetado se identifica con el nombre de la etiqueta.

Cuando los comentarios se visualizan en el diseño WIP en vivo, aquellos creados en la instantánea de diseño de un commit etiquetado incluirán el nombre de la etiqueta asociada. Seleccione el enlace del nombre de la etiqueta para abrir la instantánea del commit relacionado. Consulte Web Viewer Comments para obtener más información sobre cómo trabajar con comentarios.

Los comentarios añadidos a una instantánea de un evento de commit etiquetado incluirán el nombre de la etiqueta asociada.

• Schematic to – le permite comparar los datos del esquema de este commit con los de otro evento de commit o release. Utilice el submenú para comparar con los datos fuente del commit anterior, o seleccione entre todos los commits o releases posibles. Una vez elegido el release/commit para la comparación, los resultados se presentan en la vista Compare, que se abre como una nueva pestaña en su navegador web predeterminado. Para obtener más información, consulte Schematic Comparison.
• BOM to – le permite comparar los datos de BOM de este commit con los de otro evento de commit o release. Utilice el submenú asociado para comparar con los datos de BOM del commit anterior, o seleccione entre todos los commits/releases realizados para el proyecto. Una vez elegido el objetivo de la comparación, los resultados se presentan como una lista de entradas de BOM codificadas por colores que representan los elementos que han cambiado entre los eventos Commit/Release especificados. Se genera un resumen consolidado de los cambios en formato CSV estándar y se pone a disposición para su descarga en un archivo ZIP. Para obtener más información, consulte BOM Comparison.

• Clone – use este comando para crear un clon a partir de esa revisión específica del proyecto. Aparecerá la ventana Clone Project, en la que podrá determinar el Name del proyecto, Description, y, en las opciones de Advanced, el Server Folder y Repository de destino. Tenga en cuenta que el texto del banner de la ventana refleja desde qué revisión del proyecto se está creando el clon. Una vez definida la información necesaria, haga clic en el botón . Se creará el proyecto y se agregará un mosaico de evento Project Cloned a la línea temporal.

Puede crear un clon a partir de cualquier revisión específica del proyecto activo, directamente desde el mosaico de evento Project Committed correspondiente a esa revisión.

• Download Sources – use este comando para descargar el código fuente del proyecto de esa revisión específica del proyecto, en un archivo Zip. El nombre del archivo Zip y del archivo del proyecto PCB incluirán la fecha y la hora (en UTC) en que esa revisión del proyecto se confirmó y se envió al Workspace.

Un mosaico de evento Project Committed está conectado físicamente al tronco principal de la línea temporal mediante una línea y un nodo de conexión azules sólidos: . La revisión más reciente del proyecto (es decir, el último commit) se distingue por tener un relleno blanco en su nodo: .

Lanzamiento del proyecto

Related page: Lanzamiento del proyecto de diseño

Cada vez que realiza un lanzamiento del proyecto, utilizando el Project Releaser de Altium Designer, se agregará un mosaico de evento Project Released a la línea temporal. La persona que realizó el lanzamiento se muestra por nombre (y foto), junto con la fecha y la hora. Si se añadió una nota de lanzamiento en el momento de publicar los datos generados en el Workspace, a través del Confirm Release dialog, esta también se mostrará dentro del mosaico. También se listarán cada uno de los conjuntos de datos incluidos en el lanzamiento.

Ejemplo de mosaico de evento Project Released.

Haga clic en el control en la esquina superior derecha del mosaico para acceder a un menú con los siguientes comandos:

• View – abre un portal de fabricación dedicado (en una pestaña independiente del navegador) desde el que se pueden inspeccionar más de cerca los datos publicados. Desde este portal puede ver y navegar por los archivos liberados, inspeccionar la BOM y ver y comentar la instantánea del propio diseño; la fuente de esos datos publicados. También tendrá acceso a controles para descargar datos de fabricación con distintos niveles de granularidad (desde conjunto(s) de datos completos hasta archivo(s) de salida generados individuales). Un lanzamiento elegido también puede enviarse, como Manufacturing Package, directamente a su fabricante. Para más información, consulte la exploración de un paquete de lanzamiento en el Manufacturing Portal.

Acceso a la pestaña dedicada Manufacturing Portal, con la que inspeccionar más de cerca el lanzamiento del proyecto.

• Schematic to – le permite comparar los datos esquemáticos de este lanzamiento con los de otro lanzamiento o evento de commit. Use el submenú para comparar con los datos fuente del lanzamiento anterior, o seleccione entre todos los lanzamientos y commits posibles. Una vez elegido el lanzamiento/commit de comparación, los resultados se presentan en la vista Compare, que se abre como una nueva pestaña en su navegador web predeterminado. Para más información, consulte Schematic Comparison.
• Gerber to – le permite comparar los datos Gerber generados para este lanzamiento con otro conjunto de datos Gerber. Use el submenú asociado para comparar con los datos de fabricación del lanzamiento anterior, seleccionar entre todos los lanzamientos realizados para el proyecto (la línea temporal se filtrará para mostrar solo mosaicos de evento Project Released) o comparar con un conjunto de archivos generado localmente (y cargado) seleccionado. Una vez elegido el objetivo de la comparación, los resultados se presentan en la Gerber Compare vista, que se abre en una pestaña independiente del navegador. Para más información, consulte Gerber Comparison.

• BOM To – le permite comparar los datos de la lista de materiales (BoM) de este lanzamiento con los de otro lanzamiento. Use el submenú asociado para comparar con los datos BOM del lanzamiento anterior, o seleccione entre todos los lanzamientos realizados para el proyecto. Una vez elegido el objetivo de la comparación, los resultados se presentan como una lista de entradas BOM codificadas por colores que representan los elementos que cambiaron entre los eventos de Commit/Release especificados. Se genera un resumen consolidado de los cambios en formato CSV estándar y se pone a disposición para su descarga en un archivo ZIP. Para más información, consulte BOM Comparison.
• Download Outputs – le permite elegir, a través de una ventana posterior, cuáles de los conjuntos de datos del paquete de lanzamiento desea descargar. Una vez hechas las selecciones, haga clic en el botón . Se descargará un único archivo Zip que contendrá carpetas para cada uno de los conjuntos de datos elegidos.
• Download Sources– le permite descargar la instantánea de la versión del diseño que se utilizó para crear ese paquete de lanzamiento, como un archivo Zip.

Clonado de proyectos

Related page: Clonado de un proyecto (interfaz del navegador / Altium Designer)

Cada vez que clona el proyecto, ya sea a través de la interfaz del navegador del Workspace o desde Altium Designer, se agregará un mosaico de evento Project Cloned a la línea temporal. La persona que realizó el clonado se muestra por nombre (y foto), junto con la fecha y la hora. En el momento del clonado se agrega una descripción generada al mosaico, que puede reemplazarse introduciendo una nueva descripción. Se proporciona un enlace al proyecto clonado; al hacer clic en él, accederá a la página detallada de gestión de ese proyecto, que se abre en una pestaña independiente del navegador.

Ejemplo de mosaico de evento Project Cloned.

Intercambios MCAD

Related page: Altium MCAD CoDesigner

Al trabajar entre los dominios de diseño electrónico y mecánico, el Workspace actúa como puente entre ambos, facilitando el codiseño ECAD-MCAD directo. Siempre que se realicen cambios en el diseño PCB del proyecto y esos cambios se envíen al Workspace a través del panel CoDesigner correspondiente, se agregará un mosaico de evento MCAD Changes Suggested a la línea temporal. La persona que realizó el envío se muestra por nombre (y foto), junto con la fecha y la hora. Si se publicó un mensaje en el momento del envío, a través del panel MCAD CoDesigner (Altium Designer) o del panel Altium CoDesigner (en el software MCAD compatible), este también se mostrará dentro del mosaico.

Cuando el ingeniero MCAD realiza cambios en el PCB en su software MCAD compatible y los devuelve al Workspace, el evento de envío correspondiente estará disponible en la línea temporal del historial del proyecto only después de extraer los cambios del Workspace en Altium Designer.

Ejemplo que muestra dos eventos relacionados con MCAD. El evento inferior en el tronco de la línea temporal representa un evento de envío desde el lado ECAD, mientras que el evento superior es el reenvío desde el lado MCAD.

Búsqueda filtrada

Haga clic en el control en la parte superior derecha de la vista para acceder a un campo de búsqueda con el que encontrar rápidamente eventos de interés a lo largo de la línea temporal. La función de búsqueda admite búsquedas básicas del historial del proyecto, con filtrado dinámico aplicado a medida que escribe su cadena de búsqueda, dejando en la página solo los eventos relevantes para esa búsqueda. El texto coincidente dentro de un mosaico de evento se resalta.

Ejemplo de búsqueda en el historial de un proyecto. La línea temporal se filtra dinámicamente a medida que escribe el término de búsqueda (sin distinguir entre mayúsculas y minúsculas), y las entradas coincidentes se resaltan dentro de cada mosaico de evento relevante.

La función de búsqueda funciona con la siguiente información:

• Título del mosaico de evento.
• Nombre de la persona que realizó el evento.
• Texto descriptivo (el texto obtenido de un comentario/nota/descripción cuando ocurrió el evento correspondiente).
• Texto de los datos de comparación: en un mosaico de evento Project Committed.
• Nombre del conjunto de datos: en un mosaico de evento Project Released.
• Nombre del proyecto: en un mosaico de evento Project Cloned y en un mosaico de evento Project Created (cuando se crea mediante clonación).

Para borrar el filtrado actual y volver a la línea temporal completa, vacíe el campo de búsqueda, ya sea seleccionando el texto actual y pulsando la tecla Backspace , o haciendo clic en el control situado en el extremo derecho del campo. Como alternativa, haga clic en el control Clear Filter del cuadro que resume cuántos eventos se están mostrando (en la parte superior de la vista).

Actualización con nuevos eventos

Siempre que se produzca un evento compatible relacionado con el proyecto, dicho evento se detectará y estará disponible automáticamente en la History vista. Poco después de que ocurra el evento, aparecerá una notificación en la parte inferior de la vista; haga clic en el control para actualizar la línea de tiempo con el nuevo evento.

También se proporciona una actualización manual, que se realiza haciendo clic en el control en la parte superior derecha de la vista.