Historial del proyecto

Parent page: Proyectos del Workspace

El Workspace de Enterprise Server ofrece 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. Accesible a través de la interfaz del navegador del Workspace o desde Altium Designer, la History vista del proyecto proporciona una línea de tiempo progresiva de los principales eventos 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 del evento cuando corresponda.

Acceso al historial del proyecto

Se accede a la History vista de un proyecto desde la página detallada de gestión centrada en 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 de gestión detallada de ese proyecto.

Línea de tiempo del historial: resumen

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 dirección de 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 por encima, y el más reciente (el evento más actual) 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 distinto color y estará vinculado directamente al tronco principal de la línea de tiempo, o tendrá un icono de asociación junto a él (como es el caso de los eventos MCAD Exchange; ).
3. Search. Haga clic en el control 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 Búsqueda filtrada.

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 presentables como parte de la línea de tiempo histórica de un proyecto.

Creación de proyecto

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

Cuando se crea un proyecto, el mosaico de evento Project Created se añadirá a la línea de tiempo. Este evento marca el inicio 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 recientemente dentro del Workspace. El creador del proyecto se presenta por nombre (y 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 su 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 presenta por nombre (y 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 de gestión detallada de ese proyecto, que se abrirá 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 con una línea de conexión azul continua y un nodo:

Commit de proyecto

Cada vez que guarda el proyecto en el Worskpace (donde el proyecto se gestiona bajo el repositorio interno Versioned Storage Git del Worskpace), se añadirá un mosaico de evento Project Committed a la línea de tiempo. La persona que realizó el commit y push se presenta por nombre (y foto), junto con la fecha y hora. Si se añadió un comentario en el momento del commit y push —mediante el 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 diffing del diseño, mostrando información más detallada sobre qué ha cambiado entre el commit actual y los anteriores. Los elementos compatibles incluyen archivos, componentes, nets, variantes y estructura de PCB. La sección de diffing 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 diffing para mostrar los elementos afectados por nombre.

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

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

• Clone – utilice 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, Description del proyecto 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. Con la información definida según sea necesario, haga clic en el botón . Se creará el proyecto 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 Snapshot – utilice este comando para descargar el código fuente del proyecto para 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 hora UTC) en la que esa revisión del proyecto fue committed y enviada mediante push al Workspace.

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

Release del proyecto

Related page: Release de diseño de placa

Cada vez que realiza un release 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ó el release se presenta por nombre (y foto), junto con la fecha y hora. Si se añadió una nota de release en el momento de publicar los datos generados en el Workspace —mediante el cuadro de diálogo Confirm Release—, esta también se mostrará dentro del mosaico. También se listarán cada uno de los conjuntos de datos incluidos en el release.

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 archivos de datos 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 los datos de fabricación con distintos niveles de granularidad (desde conjuntos de datos completos hasta archivos de salida generados individuales). Un release elegido también puede enviarse —como un Manufacturing Package— directamente a su fabricante. Para obtener más información, consulte la exploración de un Release Package en el Manufacturing Portal.

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

• BOM To – le permite comparar los datos de la lista de materiales (BoM) de esta versión con los de otra versión. Use el submenú asociado para comparar con los datos de BOM de la versión anterior, o seleccione entre todas las versiones que se hayan creado para el proyecto. La función de comparación de datos detecta diferencias en los datos BOM sin procesar entre las versiones de proyecto especificadas, y también está disponible desde la vista Releases del proyecto en el Workspace. Los resultados de la comparación se proporcionan mediante la descarga de un archivo CSV que detalla los datos BOM que han cambiado — añadidos, eliminados o actualizados — entre las versiones de proyecto especificadas.

• Download – le permite elegir, mediante una ventana posterior, qué conjuntos de datos del paquete de versión 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 Snapshot – le permite descargar la instantánea de la versión del diseño que se utilizó para crear ese paquete de versión, como un archivo Zip.

Clonado de proyectos

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

Cada vez que clone el proyecto — ya sea mediante la interfaz de navegador del Workspace o desde dentro de Altium Designer — se añadirá a la línea de tiempo un mosaico de evento Project Cloned. Se mostrará el nombre de la persona que realizó el clonado (y su imagen), junto con la fecha y la hora. En el momento del clonado se añade al mosaico una descripción generada, que puede sustituirse introduciendo una nueva descripción. Se proporciona un enlace al proyecto clonado; al hacer clic en él se accederá a la página de administración detallada de ese proyecto, que se abrirá en una pestaña separada del navegador.

Ejemplo de mosaico de evento Project Cloned.

Intercambios MCAD

Related page: Altium MCAD CoDesigner

Al trabajar entre los dominios del 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 PCB del proyecto y esos cambios se envíen al Workspace mediante el panel CoDesigner correspondiente, se añadirá a la línea de tiempo un mosaico de evento MCAD Changes Suggested. Se mostrará el nombre de la persona que realizó el envío (y su imagen), 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.

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

Ejemplo que muestra dos eventos relacionados con MCAD. El evento inferior en el tronco de la línea de tiempo 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 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), y las entradas coincidentes se resaltan dentro de cada mosaico de evento relevante.

La función de búsqueda trabaja 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 datos de diffing — 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 clonado).

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 en el 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 admitido relacionado con el proyecto, ese evento se detectará y se pondrá a disposición en la History vista automáticamente. 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 esquina superior derecha de la vista.