Proyectos del espacio de trabajo

Parent page: Altium On-Prem Enterprise Server

Altium Designer, en combinación con el Workspace de Enterprise Server, ofrece compatibilidad para Workspace Projects. Los proyectos del Workspace están orientados a la etapa de desarrollo del ciclo de vida del proyecto, lo que simplifica la creación y el flujo de trabajo continuo de proyectos con control de versiones. El almacenamiento centralizado bajo el control del Workspace también permite que esta función sirva como base para otros servicios colaborativos.

Algunos beneficios clave de usar proyectos del Workspace son:

• Almacenamiento simplificado. No es necesario tomar decisiones sobre ubicaciones de almacenamiento. Las copias de seguridad y otros servicios básicos ya están cubiertos.
• Base para funciones colaborativas.
• Control de versiones obligatorio.
• Ventajas de un sistema de comentarios dedicado.
• Notificaciones y estado. El estado del documento, incluidas las modificaciones locales, es visible para todos los equipos de diseño.
• El diseño concurrente de PCB funciona sin ninguna configuración compleja.
• Capacidad de compartir con otros usuarios una vista interactiva de solo lectura de un proyecto, basada en navegador, mediante el Web Viewer.
• Una gama de funciones avanzadas de control de versiones, como una vista interactiva de Historial del proyecto.

Técnicamente, un proyecto del Workspace es la combinación de metainformación almacenada en el Workspace de Enterprise Server junto con una integración estrecha con el propio servicio de control de versiones del Workspace. El flujo de trabajo típico es el siguiente:

1. Un usuario crea un nuevo proyecto del Workspace mediante el cuadro de diálogo Create Project de Altium Designer, al convertir un proyecto local existente mediante el cuadro de diálogo Make Available On Server , o desde la interfaz del navegador del Workspace (detallado a continuación). Durante la creación, ese usuario define el nombre, la descripción y el repositorio de diseño del proyecto.
2. El acceso al proyecto se define y administra en la interfaz basada en navegador del Workspace, o directamente dentro de Altium Designer.
3. Todos los colaboradores seleccionan el proyecto para abrirlo (ya sea desde Altium Designer o desde la interfaz del navegador del Workspace), tras lo cual se extrae automáticamente como archivos de diseño.

Este documento analiza el trabajo con proyectos a través de la interfaz del navegador del Workspace de Enterprise Server. Para obtener información sobre cómo trabajar con proyectos en su software de diseño, consulte Familiarizarse con el entorno de diseño de Altium.

Crear un nuevo proyecto del Workspace

Existen varias formas de crear un proyecto del Workspace:

• Creación de un nuevo proyecto desde la interfaz basada en navegador del Workspace, o desde Altium Designer.
• Poner un proyecto existente (un proyecto local o un proyecto local actualmente bajo control de versiones externo) a disposición del Workspace desde Altium Designer – es decir, convertir un proyecto local en un proyecto del Workspace. Consulte la página Poner un proyecto existente a disposición en el Workspace para obtener más información.
• Clonación de un proyecto existente del Workspace mediante la interfaz basada en navegador del Workspace, o clonando un proyecto desde el panel Projects de Altium Designer.
• Carga de un proyecto local desde la interfaz basada en navegador del Workspace.

Para crear un proyecto del Workspace directamente mediante la interfaz del navegador del Workspace:

1. Inicie sesión en la interfaz y seleccione la opción de menú Projects para acceder a la página Designs . Aquí aparecerán todos los proyectos creados previamente.

2. Haga clic en el botón en la parte superior de la página y luego en la opción de menú Create Project para abrir la ventana Create Project .

   Si hay definiciones de proceso activas disponibles para el tema de proceso Creaciones de proyecto, definidas en la pestaña Project Creations de la página Processes de la interfaz del navegador del Workspace, entonces el menú del botón ofrecerá esos procesos como opciones en lugar de la opción Create Project. Elija la entrada requerida para invocar ese flujo de trabajo del proceso.

3. La ventana se presentará inicialmente en una vista simplificada. Introduzca el nombre deseado para el proyecto, una descripción (si es necesario) y elija una Plantilla de proyecto adecuada en el menú desplegable Templates.

   El nombre del proyecto debe comenzar con, y puede contener, A-Z, a-z o 0-9. Se permiten guiones bajos, guiones y espacios, pero estos últimos solo pueden usarse en medio del nombre (los espacios iniciales y finales se ignorarán). No puede usar las siguientes palabras: AUX, COM1-COM9, LPT1-LPT9, CON, NUL y PRN. Además, el nombre no puede contener los siguientes caracteres: \ . / ? % * : | " < >.
4. Para acceder a más controles, haga clic en el botón . Se mostrarán los siguientes campos:
   1. Parent Folder – use este campo para especificar dónde se creará la carpeta del proyecto dentro de la estructura de carpetas del Workspace. Por defecto, será Projects\<ProjectName>. La ruta predeterminada para los nuevos proyectos se especifica en la página Admin – Settings – Projects de la interfaz del navegador del Workspace.

   2. Repository – este campo mostrará todos los repositorios de diseño administrados mediante el servicio local de control de versiones del Workspace y que se hayan compartido con usted para su uso. Elija el repositorio en el que almacenar el nuevo proyecto y sus archivos. De forma predeterminada, se seleccionará el repositorio Versioned Storage (basado en Git).

      Si actualizó a Enterprise Server desde una tecnología de servidor anterior y aún tiene la capacidad de usar repositorios de diseño internos (SVN) y/o externos (SVN/Git), se mostrará el campo Repository . Este enumera todos los repositorios de diseño administrados mediante el servicio local de control de versiones del Workspace y que se hayan compartido con usted para su uso. Elija el repositorio en el que almacenar el nuevo proyecto y sus archivos. Si se elige un repositorio basado en SVN, se mostrará el campo Repository Folder. Utilice este campo para especificar el nombre de la carpeta dentro del repositorio en la que se alojará el proyecto y sus archivos asociados. De forma predeterminada, tomará el nombre del proyecto.

Definición de un nuevo proyecto del Workspace directamente mediante la interfaz del navegador del Workspace.

Después de definir el nuevo proyecto según sea necesario, haga clic en – se creará el nuevo proyecto. Volverá a la lista de proyectos de nivel resumido, donde ahora verá una entrada para el proyecto recién creado.

Un proyecto adicional del Workspace, creado mediante la interfaz del navegador.

Explorar proyectos del Workspace

La lista de proyectos en la página Projects de la interfaz del navegador del Workspace incluye todos los proyectos compartidos con usted y ofrece una variedad de controles para acceder a funciones de administración de proyectos. Use el botón  para cambiar la página a su modo de vista previa del proyecto (mosaicos gráficos) y el botón  para cambiar la página a su modo de lista detallada.

La página Designs de la interfaz del navegador del Workspace: el centro de mando para trabajar con sus proyectos del Workspace. Aquí se muestra el modo de lista detallada de la página. Pase el cursor sobre la imagen para ver el modo de vista previa del proyecto.

Las entradas de proyecto de la vista se ordenan automáticamente por fecha de Last modified, apareciendo primero en la lista el proyecto modificado más recientemente. Haga clic en el botón para cambiar la ordenación por nombre del proyecto, y vuelva a hacer clic para alternar entre orden ascendente y descendente.

La vista en modo Lista () puede ordenarse por Name, Author o Date, usando el encabezado de columna en cada caso. Haga clic una vez para ordenar en orden ascendente; haga clic de nuevo para ordenar en orden descendente. Las flechas a la derecha del nombre de la columna indicarán la dirección de ordenación activa en ese momento.

La vista Projects proporciona datos de Properties y Activities relacionados con el proyecto seleccionado, disponibles en el panel lateral derecho de la vista.

La información del panel lateral incluye: Propertiespestaña : Project – un resumen de alto nivel del estado del proyecto, incluida la vista 3D de la placa (cuando hay una PCB disponible para el proyecto). Shared With – los usuarios y/o roles que tienen acceso al proyecto. Pase el cursor sobre una entrada para ver el nombre completo del usuario/rol. Parameters – metadatos detallados extraídos o calculados a partir del propio diseño del proyecto. Haga clic en el control Show More para expandir la lista completa. Where Used – una lista de otros proyectos, como proyectos multi-board, que incorporan el contenido de este proyecto. Haga clic en una entrada para abrir y ver ese proyecto en una nueva pestaña del navegador. Releases – una lista de versiones del proyecto en orden cronológico. Haga clic en una entrada para abrir esa versión en el Manufacturing Portal del Workspace. Activity pestaña: una lista cronológica de eventos del proyecto, como un Commit, Release o un flujo de proceso completado asociado con el proyecto.

Para cada proyecto, también se proporcionan las siguientes operaciones mediante los botones de la parte superior de la vista (y se detallan en las secciones enlazadas que siguen):

• Share – controles de acceso con los que configurar los permisos de acceso al proyecto.
• Functions – acceso mediante menú a las funciones del proyecto. También disponible desde el botón de un proyecto seleccionado cuando está en modo Preview:
  • Open – abre el proyecto en su vista detallada orientada a CAD. Equivale a hacer clic (modo Preview) o doble clic (modo List) en una entrada del nombre del proyecto.
  • Move – reubica el proyecto en otra carpeta principal dentro de la estructura de carpetas del Workspace.
  • Edit – edita el proyecto en términos de su Name, Description y Workspace Parameters.
  • Clone – crea una copia idéntica del proyecto con otro nombre.
  • Watch/Unwatch – seguir/dejar de seguir la actividad de un proyecto recibiendo notificaciones relacionadas (actualizado, liberado, etc.) en la pestaña Activitiy del proyecto, y también por correo electrónico si Email Notifications están habilitadas.
  • Delete – elimina la entrada del proyecto moviendo su estructura y datos a la Trash del Workspace , donde puede eliminarse permanentemente del Workspace o restaurarse a su estado anterior.

También se incluye una función de Search del proyecto que puede filtrar el listado de proyectos por una variedad de propiedades como Name, Author, Description, etc. Escriba cualquier parte de una cadena de búsqueda en el campo situado en la parte superior de la interfaz del navegador. La lista se actualizará para incluir solo aquellas entradas de proyecto cuyos atributos incluyan la cadena de búsqueda.

Para borrar el filtrado de búsqueda, haga clic en la entrada principal de la página Projects en el panel de navegación izquierdo, o borre el campo de búsqueda y pulse Enter.

Ejemplo de uso de la función de búsqueda, en este caso encontrando un proyecto según su Description.

Trabajar con carpetas del Workspace

El Workspace también proporciona la capacidad de crear y administrar carpetas de proyectos dentro de su estructura. Luego, los proyectos pueden crearse en cualquier carpeta o moverse a cualquiera de ellas dentro de la jerarquía de carpetas resultante.

Para crear una nueva carpeta bajo la carpeta de nivel superior (predeterminada) Project, elija la opción Create Folder del menú del botón . En la siguiente ventana Create Folder, especifique el nombre de la nueva carpeta, su carpeta principal y una descripción opcional. Una carpeta nueva siempre se crea bajo la carpeta seleccionada actualmente, que pasa a ser su carpeta principal.

Abra una carpeta creada seleccionando su título y vuelva a subir por la jerarquía usando la ruta de navegación de arriba.

Use las opciones del menú para modificar los detalles de una carpeta (Edit), reubicar la carpeta bajo una carpeta principal diferente (Move) o eliminar la carpeta de la estructura de carpetas del Workspace (Delete). Al mover una carpeta, seleccione una nueva carpeta principal del árbol jerárquico en la ventana Move folder <folder> to.

Subir un proyecto

En Altium Designer, el comando Make Available on Server cargará un proyecto local al Workspace, donde pasará a ser un proyecto del Workspace bajo su control de versiones. Puede realizarse un proceso equivalente dentro de la interfaz del navegador del Workspace desde la opción Upload Project disponible en el menú del botón . Busque y seleccione la carpeta host de un proyecto local para cargar ese proyecto en la carpeta del Workspace seleccionada actualmente de forma predeterminada, o use la opción Change en la lista Upload Project de las ventanas Parent Folder para seleccionar una ubicación alternativa en la jerarquía de carpetas.

Se ignoran todos los vínculos de control de versiones existentes en el proyecto local, y el proyecto cargado pasa a ser un proyecto del Workspace totalmente controlado por versiones – el proyecto fuente local no se modifica de ninguna manera.

Mover un proyecto

Para reubicar un proyecto en una carpeta diferente del Workspace, seleccione la opción Move de las opciones desplegables del menú y seleccione una nueva ubicación de la jerarquía de carpetas en la ventana Move project <project> to. Cuando se confirme con el botón , el proyecto seleccionado pasará a alojarse bajo la nueva carpeta principal especificada.

Compartir un proyecto del Workspace

Una vez que un proyecto está en el Workspace, querrá determinar qué usuarios pueden acceder realmente a ese proyecto. Esto se hace compartiendo el proyecto o, más concretamente, configurando sus permisos de acceso. Un proyecto del Workspace se comparte, de forma predeterminada, con lo siguiente:

• El propietario del proyecto, que normalmente es el diseñador que lo creó (o lo puso a disposición en el Workspace): permisos de acceso completos (Read/Write).
• El grupo de roles Administrators: permisos de acceso completos (Read/Write).
• Todos los miembros del Workspace: con acceso de solo visualización.

Los permisos predeterminados para proyectos nuevos pueden definirse o cambiarse en la página Admin – Settings – Projects de la interfaz del navegador del Workspace. Tenga en cuenta que al propietario del proyecto se le asigna implícitamente permiso para acceder a él y, por lo tanto, no aparece en la lista.

La configuración de permisos de acceso puede realizarse a través de la interfaz del navegador del Workspace y también directamente desde Altium Designer.

Para configurar el acceso a un proyecto desde la interfaz del navegador del Workspace, seleccione la entrada del proyecto en la página Designs  (Projects en el menú principal) y haga clic en el botón para acceder a la ventana Share:<project>, o en la opción Share del menú asociado con una entrada de proyecto. Esto ofrece todos los controles necesarios para compartir el proyecto con otros usuarios o grupos de usuarios (Roles).

Con los proyectos administrados de forma centralizada en el Workspace, compartir con otros es simplemente una cuestión de gestionar los permisos de cada proyecto.

Dentro de la ventana Share <project>:

• Un usuario/rol tiene acceso Read/Write cuando la opción Can Edit está habilitada. Si esta opción está deshabilitada, solo tiene acceso Read.
• Un proyecto puede compartirse con todos los miembros del Workspace con acceso de solo lectura (Can View) o de lectura/escritura (Can Edit) usando el menú desplegable de la entrada Workspace Members en la región Shared With.
• Para quitar a un usuario/rol existente del acceso compartido a un proyecto, haga clic en la opción Remove del menú desplegable asociado.

Aspectos que debe tener en cuenta:

• De forma predeterminada, todos los usuarios del Workspace podrán ver el proyecto. Si desea restringir el acceso a un conjunto específico de usuarios y/o grupos, primero debe seleccionar No access en el menú desplegable de la entrada Workspace Members .
• El propietario de un proyecto tiene acceso permanente de Read/Write.
• También puede compartir un enlace directo al proyecto. El enlace se obtiene haciendo clic en el control Copy Link, en la parte inferior de la ventana Sharing. El enlace se copia al portapapeles. Cuando se usa, proporciona al usuario correspondiente —cuando está permitido— acceso a la página de administración detallada del proyecto, cuya vista general se presenta en la siguiente sección.

Actividades de proyectos del Workspace

El Workspace ofrece la capacidad única de aplicar Process Workflows configurables a los proyectos del Workspace para realizar tareas personalizadas, como llevar a cabo revisiones de diseño y crear nuevos proyectos. Los procesos y sus Workflows subyacentes son creados y configurados por un administrador del Workspace y, cuando están habilitados, pasan a estar disponibles para los usuarios tanto de Altium Designer como de la interfaz del navegador del Workspace.

► Consulte Creating & Managing Processes para obtener más información.
► Consulte Performing Design Reviews para obtener información sobre estos procesos en Altium Designer.

Desde la perspectiva del usuario, los Process Workflows y sus pasos inherentes se consideran como Activities. Los usuarios pueden iniciar las actividades disponibles, y los pasos de su workflow pueden ser completados por los usuarios asignados como una secuencia de tareas, disponibles a través de la página Tasks page.

Seleccione el menú en la página Designs (Projects) y elija entre los Process disponibles para iniciar una actividad para el proyecto actualmente seleccionado. Complete los campos y opciones requeridos en las siguientes ventanas del formulario del proceso y luego inicie el proceso (). Dependiendo del Process Workflow que se haya invocado, puede que sea necesario enviar un paso posterior () para preparar los datos para revisión.

Luego se crean Workflow Tasks para el usuario o los usuarios asignados a la actividad. Una tarea que se aplique a un usuario que haya iniciado sesión aparecerá en la página Tasks page, donde se podrá actuar sobre ella para hacer avanzar el Workflow a su siguiente etapa.

Tenga en cuenta que si una actividad se ha asignado a un grupo de Roles —Engineers por ejemplo— una Task relacionada estará disponible para todos los miembros de ese grupo, así como para cualquier usuario individual que haya sido asignado a la actividad. En esos casos, cualquiera de estos usuarios puede completar el paso de revisión y enviar el resultado ().

Funciones de proyectos del Workspace

Las operaciones funcionales asociadas con los proyectos están disponibles desde el menú en la página Designs  e incluyen la capacidad de abrir, mover, editar, clonar, seguir y eliminar un proyecto del Workspace. El menú también está disponible desde el botón de una entrada de proyecto seleccionada:

Abrir un proyecto

Seleccione la opción Open del menú de una entrada de proyecto o del menú superior para abrir un proyecto en su vista CAD orientada a fabricación, o bien, cuando esté en modo Preview (), haga clic en el nombre del proyecto. La vista proporciona acceso a varias subvistas disponibles desde el panel de navegación:

• Design – navegar e interactuar con los documentos de diseño del proyecto, inspeccionar propiedades de objetos y colocar comentarios de revisión. La vista se aplica a la revisión actual (más reciente) del proyecto y utiliza la interfaz Web Viewer.
• Tasks – ver e interactuar con una interfaz de tipo flujo que presenta todas las Tasks (trabajos de actividad) que se aplican al proyecto actual.
• Releases – ver información resumida de todos los Releases del proyecto actual, cada uno de los cuales puede abrirse en la vista Manufacturing Portal . Esta, a su vez, proporciona subvistas para los archivos del paquete de release, los documentos de diseño y los datos de suministro de ese release seleccionado.
• Activities – ver Process workflow Activities activas o cerradas que se aplican al proyecto actual.
• History – explorar una línea de tiempo progresiva de los eventos importantes relacionados con el proyecto, incluida su creación, commits, releases y clones. Cada vez que ocurre un evento compatible asociado con el proyecto, ese evento se agrega a la línea de tiempo como un mosaico dedicado con varias acciones compatibles cuando corresponda (como comparaciones de datos de diseño).

► Consulte Management of a Specific Project para obtener más información.

Editar un proyecto

Para editar las propiedades de un proyecto existente en el Workspace, seleccione su entrada en la página Designs  (Projects) y luego la opción Edit de su menú o del menú superior . En la siguiente ventana Project Editing puede cambiar el Name del proyecto, la Description y administrar las entradas de Parameters del Workspace .

Haga clic en el botón en la ventana Project Editing para mostrar datos de propiedades adicionales derivados del proyecto y almacenados con él. Seleccione el control Parameters para acceder y añadir (), editar o eliminar () pares Nombre/Valor de parámetros. Estos se guardan en el Workspace con el proyecto y pueden usarse como Special Strings en Altium Designer; acceda a ellos desde el panel Properties con un objeto de texto colocado seleccionado en el espacio de diseño. En cambio, los parámetros de tipo Project se guardan en el archivo del proyecto (*.PrjPcb) y pueden editarse en Altium Designer.

Clonar un proyecto

Para clonar (duplicar) un proyecto existente del Workspace, seleccione su entrada en la página Designs (Projects) y luego la opción Clone de su menú o del menú superior . Utilice la ventana Clone Project para establecer el nombre y la descripción del proyecto clonado; de forma predeterminada, se utilizará el nombre del proyecto original con el sufijo - Copy.

Haga clic en el botón para mostrar campos de propiedades adicionales, que incluyen la información de la carpeta principal de destino y del Repository. La configuración de la carpeta de destino coincidirá automáticamente con el nombre del proyecto, a menos que se especifique manualmente o se asigne a una carpeta principal existente diferente mediante la opción Change.

Un proyecto puede clonarse en Altium Designer desde la opción Clone del menú  en el panel Explorer panel, o haciendo clic con el botón derecho en un nombre de proyecto en el panel Projects panel y eligiendo la opción Clone del menú contextual.

Después de establecer los campos según sea necesario, haga clic en el botón para confirmar. El proyecto original se clonará (duplicará) junto con sus archivos y datos constituyentes, y se añadirá como una nueva entrada de proyecto al listado de la página Projects.

Seguir un proyecto

Para “seguir” un proyecto del Workspace —es decir, recibir notificaciones sobre él—, seleccione su entrada en la página Designs (Projects) y luego la opción Watch de su menú o del menú superior .

Cuando sigue (observa) un proyecto, recibirá notificaciones relacionadas con el proyecto (como mensajes de confirmación, publicación y cambio de propiedades) en la pestaña Activities del panel derecho de la interfaz. El creador del proyecto quedará configurado automáticamente para seguir ese proyecto. Cuando esté habilitado, el comando cambiará a Unwatch; selecciónelo para dejar de seguir el proyecto y dejar de recibir notificaciones de los eventos relacionados con ese proyecto.

Eliminar un proyecto del Workspace

Para eliminar (quitar) un proyecto existente del Workspace, seleccione su entrada en la página Designs (Projects) y luego la opción Delete de su menú o del menú superior . En la práctica, la acción es una "eliminación lógica", en la que el repositorio del proyecto se mueve al área Trash del Workspace. Un proyecto se puede eliminar en Altium Designer usando la opción Delete del menú  en el panel Explorer.

Desde esa vista (seleccione Trash en el menú principal), la entrada del proyecto se puede eliminar por completo (Permanently Delete) o revertir la acción (Restore). Tenga en cuenta que el botón eliminará todas las entradas (cuando sea posible) almacenadas en la Papelera del Workspace.