Historial del proyecto

No poder acceder fácilmente a una vista histórica del recorrido de desarrollo de un proyecto suele ser, con bastante frecuencia, una molestia para diseñadores y gestores de producto. Con demasiada frecuencia, un diseñador tiene que familiarizarse con herramientas externas de gestión de VCS, que pueden requerir un nivel considerable de experiencia para utilizarlas, algo que consume bastante tiempo cuando se quieren realizar tareas básicas de gestión de proyectos. Incluso si domina las herramientas externas de VCS, estas solo cubren ciertos aspectos del proyecto: acciones relacionadas con VCS como abrir, clonar y revertir. Pero ¿qué ocurre con el alcance más amplio de la gestión del proyecto, incluidas las versiones y los intercambios MCAD? Además, no olvidemos tener en cuenta que, por lo general, la mayor parte de esto requiere estar atado al equipo de escritorio.

Ofreciendo una solución elegante a la necesidad de ver este tipo de información e interactuar con ella desde una única ubicación, el Altium 365 Workspace facilita el concepto de Project History. Accesible a través de la interfaz del navegador del Workspace (una parte constituyente de la interfaz de la plataforma principal Altium 365 Platform Interface) o desde Altium Designer, una History vista dedicada proporciona una línea de tiempo progresiva de los principales eventos relacionados con el proyecto: su creación, commits, versiones, clones e intercambios MCAD, con varias acciones compatibles cuando corresponde (como ver una instantánea del código fuente del diseño).

Acceso al historial del proyecto

Se accede a la History vista de un proyecto desde la página de gestión detallada de ese proyecto. Haga clic en la entrada History en el panel izquierdo.

La propia página de gestión detallada se abre seleccionando el proyecto requerido (en la Projects página de la interfaz), haciendo clic en el control situado encima de la lista de proyectos y eligiendo la entrada Open en el menú asociado. Como alternativa, haga doble clic directamente en la entrada del proyecto requerido en la lista. La página se abrirá en una nueva pestaña del navegador. Para obtener más información, consulte Management of a Specific Project.

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

En el caso de un proyecto de su Workspace que ya existía antes de la llegada de la función Project History, su historial inicialmente no estará completo. La reindexación de los datos de eventos de ese proyecto se realizará automáticamente cuando se acceda por primera vez a la History vista de ese proyecto. Aparecerá una notificación en la parte inferior de la vista una vez que la reindexación haya finalizado; haga clic en el control para actualizar la línea de tiempo con todos los datos históricos de eventos.

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 secciones clave, como se muestra en la siguiente imagen y se detalla a continuación.

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

1. Main trunk of the timeline. La dirección cronológica 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 encima, 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, ese evento 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á vinculado directamente al tronco principal de la línea de tiempo, o tendrá algún icono adicional junto a él (como ocurre en el caso de 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 su 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 Filtered Searching.

Eventos compatibles

La línea de tiempo muestra una progresión de eventos que ocurren 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. En las siguientes secciones se analiza la gama de eventos actualmente compatibles y que pueden presentarse como parte de la línea de tiempo histórica de un proyecto.

Creación del proyecto

Related pages: Crear un nuevo proyecto gestionado (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ñadirá 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 variaciones distintas:

• Cuando el proyecto se crea por primera vez dentro del Workspace. El creador del proyecto se presenta por nombre (y fotografía), junto con la fecha y la hora de creación del proyecto. La descripción del proyecto también se muestra dentro del mosaico, si se introdujo una en el momento de la creación.

• Cuando el proyecto es un clon de un proyecto existente. La persona que creó el proyecto clonado se presenta por nombre (y fotografía), junto con la fecha y la hora de creación del proyecto. La descripción del proyecto también se muestra dentro del mosaico, si se introdujo una en el momento de la clonación. Se proporciona un enlace al proyecto original; al hacer clic en él, se accederá a la página de gestión detallada 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 continuos: .

Commit del proyecto

Cada vez que realiza un Commit & Push del proyecto al Workspace (cuando el proyecto está gestionado bajo el Versioned Storagerepositorio Git interno del Workspace), se añadirá a la línea de tiempo un mosaico de evento Project Committed. La persona que realizó el commit y el push se presenta por nombre (y fotografía), 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 Commit to Version Control, 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 la confirmación actual y la anterior. Los elementos compatibles incluyen archivos, componentes, redes, variantes y estructura de PCB. La sección de comparación del mosaico resume los distintos elementos afectados por el evento de confirmación, agrupados por los siguientes estados:

– elemento añadido.

– elemento eliminado.

– elemento modificado.

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

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

Haga clic en el control 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 de la confirmación seleccionada en el Web Viewer como una instantánea del diseño en ese momento.
• Create Tag – añada un nombre de etiqueta de VCS a la confirmación seleccionada actualmente. Las etiquetas adjuntas a una confirmación aparecen en el mosaico de la vista History, en el encabezado de su vista de instantánea en el Web Viewer y en cualquier comentario adjunto a esa vista de instantánea. Una vez que se ha añadido una etiqueta a una confirmación, el comando del menú del mosaico cambia a Tag y ofrece subopciones para modificar (Edit) o eliminar (Remove) la etiqueta de la confirmación.

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

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

Cuando los comentarios se visualizan en el diseño WIP activo, aquellos creados en la instantánea de diseño de una confirmación etiquetada incluirán el nombre de etiqueta asociado. Seleccione el enlace del nombre de la etiqueta para abrir la instantánea de confirmación relacionada. 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 confirmación etiquetado incluirán el nombre de etiqueta asociado.

El evento Commit asociado con una versión del proyecto, tal como lo crea el Project Releaser de Altium Designer, se etiqueta automáticamente con el Release Revision ID. Si es necesario, la etiqueta de confirmación de revisión resultante puede editarse o eliminarse posteriormente. Consulte Releasing to a Workspace para obtener información relacionada.

El Commit asociado con una versión se etiqueta automáticamente con el ID de versión mediante Altium Designer.

• Schematic to – le permite comparar los datos del esquemático de esta confirmación con los de otra confirmación o evento de versión. Utilice el submenú para comparar con los datos fuente de la confirmación anterior, o seleccione entre todas las confirmaciones o versiones posibles. Una vez elegida la versión/confirmación de comparación, los resultados de la comparación 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.
• PCB to – le permite comparar los datos de PCB de esta confirmación con los de otra confirmación o evento de versión. Utilice el submenú para comparar con los datos fuente de la confirmación anterior, o seleccione entre todas las confirmaciones o versiones posibles. Una vez elegida la versión/confirmación de comparación, los resultados de la comparación 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 PCB Comparison.
• BOM to – le permite comparar los datos de BOM de esta confirmación con los de otra confirmación o evento de versión. Utilice el submenú asociado para comparar con los datos de BOM de la confirmación anterior, o seleccione entre todas las confirmaciones/versiones que se hayan realizado 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 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 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, con la que podrá determinar el Name, el Description y el Parent Folder del proyecto (dentro del Workspace). 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 requerida, haga clic en el botón . El proyecto se creará y se añadirá un mosaico de evento Project Cloned a la línea de tiempo.

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 de tiempo mediante una línea y un nodo de conexión azules sólidos: . La revisión más reciente del proyecto (es decir, la última confirmación) se distingue por tener un relleno blanco en su nodo: .

Versión del proyecto

Related page: Versión del proyecto de diseño

Cada vez que realiza una versión del proyecto, utilizando el Project Releaser de Altium Designer, se añadirá un mosaico de evento Project Released a la línea de tiempo. La persona que realizó la versión se muestra por nombre (y foto), junto con la fecha y la hora. Si se añadió una nota de versión en el momento de publicar los datos generados en el Workspace, mediante el cuadro de diálogo Confirm Release dialog, esta también se mostrará dentro del mosaico. También se enumerarán cada uno de los conjuntos de datos incluidos en la versión, con indicación del estado del ciclo de vida.

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 separada del navegador) con el que inspeccionar más de cerca los datos publicados. Desde este portal puede ver y navegar por los datos de archivos publicados, 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 varios niveles de granularidad (desde conjuntos de datos completos hasta archivos de salida generados individuales). Una versión seleccionada también puede enviarse, como Manufacturing Package, directamente a su fabricante. Para obtener más información, consulte Browsing a Release Package through the Manufacturing Portal.

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

• Schematic to – le permite comparar los datos del esquemático de esta versión con los de otra versión o evento de confirmación. Utilice el submenú para comparar con los datos fuente de la versión anterior, o seleccione entre todas las versiones y confirmaciones posibles. Una vez elegida la versión/confirmación de comparación, los resultados de la comparación 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.

Comparación de datos del esquemático entre dos versiones del proyecto de diseño.

• PCB to – le permite comparar los datos de PCB de esta versión con los de otra versión o evento de confirmación. Utilice el submenú para comparar con los datos fuente de la versión anterior, o seleccione entre todas las versiones y confirmaciones posibles. Una vez elegida la versión/confirmación de comparación, los resultados de la comparación 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 PCB Comparison.

Comparación de datos de PCB entre dos versiones del proyecto de diseño.

• Gerber to – le permite comparar los datos Gerber generados para esta versión con otro conjunto de datos Gerber. Utilice el submenú asociado para comparar con los datos de fabricación de la versión anterior, seleccionar entre todas las versiones que se hayan realizado para el proyecto (la línea de tiempo se filtrará para mostrar solo mosaicos de evento Project Released) o comparar con un conjunto de archivos generado localmente (y cargado) de su elección. Una vez elegido el objetivo de la comparación, los resultados se presentan en la vista Gerber Compare , que se abre en una pestaña separada del navegador. Para obtener más información, consulte Gerber Comparison.

Comparación de datos Gerber generados entre dos versiones del proyecto de diseño.

• BOM to – le permite comparar los datos de la BOM de esta versión con los de otro commit o evento de liberación. Use el submenú asociado para comparar con los datos de la BOM del commit anterior, o seleccione entre todos los commits/liberaciones que se hayan realizado 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 color que representan los elementos que han cambiado entre los eventos de Commit/Release especificados. Se genera un resumen consolidado de los cambios en un formato CSV estándar y se pone a disposición para su descarga en un archivo ZIP. Para obtener más información, consulte Comparación de BOM.

Descargue una comparación de los datos de BOM generados entre dos eventos del proyecto de diseño.

• Download Outputs – le permite elegir, a través de una ventana posterior, qué conjuntos de datos de salida del paquete de liberación desea descargar. Una vez realizadas 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 los datos fuente de la versión del diseño que se utilizó para crear ese paquete de liberación, como un archivo ZIP.

Clonación de proyectos

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

Cada vez que clone el proyecto, ya sea a través de la interfaz del navegador del Workspace o desde Altium Designer, se añadirá a la línea de tiempo un mosaico de evento Project Cloned. La persona que realizó la clonación se muestra por nombre (y fotografía), junto con la fecha y la hora. Si se añadió una descripción en el momento de la clonación, mediante la ventana Clone Project (basada en navegador) o el cuadro de diálogo Clone Project dialog (Altium Designer), esta también se mostrará dentro del mosaico. Se proporciona un enlace al proyecto clonado; al hacer clic en él, se accederá a la página de gestión detallada de ese proyecto, que se abrirá en una pestaña independiente del navegador.

Ejemplo de mosaico de evento Project Cloned.

Los comandos principales de Clone , disponibles desde la página Projects de la interfaz del navegador del Workspace, o desde Altium Designer (haciendo clic con el botón derecho en la entrada del proyecto en el panel Projects, o haciendo clic en el botón en la parte superior derecha del panel Explorer al explorar el proyecto), actúan sobre la revisión más reciente (o Head) del proyecto. Desde la vista History , tiene la posibilidad de clonar una revisión específica de un proyecto. Para ello, localice el mosaico de evento Project Committed correspondiente a la revisión requerida del proyecto y, a continuación, haga clic en el control en la esquina superior derecha del mosaico. En el menú posterior, elija el comando Clone .

El mosaico de evento Project Cloned está conectado físicamente al tronco principal de la línea de tiempo mediante una línea de conexión verde punteada y un nodo sin rellenar: .

Intercambios MCAD

Related page: Más información sobre ECAD-MCAD CoDesign

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 directo ECAD-MCAD. Siempre que se realicen cambios en el diseño de PCB del proyecto y esos cambios se envíen al Workspace a través del panel CoDesigner correspondiente, se añadirá a la línea de tiempo un mosaico de evento MCAD Changes Suggested. La persona que realizó el envío se muestra por nombre (y fotografía), junto con la fecha y la hora. Si se publicó un mensaje en el momento del envío, mediante el panel MCAD CoDesigner (Altium Designer) o el panel Altium CoDesigner (en el software MCAD compatible), este también se mostrará dentro del mosaico.

Ejemplo de mosaico de evento MCAD Changes Suggested.

Cuando el ingeniero de MCAD realiza cambios en la PCB en su software MCAD compatible y envía esos cambios al Workspace, el evento de envío correspondiente se mostrará automáticamente en la línea de tiempo del historial del proyecto. Tenga en cuenta que puede que necesite actualizar la página Historial para que se muestre el cambio más reciente.

Ejemplo que muestra dos eventos relacionados con MCAD. A la izquierda del tronco de la línea de tiempo, el evento de envío desde el lado ECAD; a la derecha, el evento de envío desde el lado MCAD.

El mosaico de evento MCAD Changes Suggested no está conectado físicamente al tronco principal de la línea de tiempo. En su lugar, se utiliza un símbolo de flecha direccional que apunta hacia el tronco: .

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 de tiempo. La función de búsqueda admite búsquedas básicas en el historial del proyecto, con filtrado dinámico aplicado a medida que escribe la 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 de tiempo se filtra dinámicamente a medida que escribe el término de búsqueda (sin distinguir entre mayúsculas y minúsculas), con las entradas coincidentes resaltadas 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 procedente de un comentario/nota/descripción cuando ocurrió el evento correspondiente).
• Texto de datos de diferencias, 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 de tiempo completa, borre 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 ocurra un evento compatible relacionado con el proyecto, ese evento se detectará y se pondrá a disposición de la vista History automáticamente. Poco después de que tenga lugar 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.