Creación de proyectos y documentos

El punto de partida de todo diseño creado en Altium Designer es un proyecto. Un proyecto de Altium Designer reúne un conjunto de documentos de diseño cuya salida define, en última instancia, una única implementación de lo que pretende crear. Por ejemplo, los esquemáticos y la PCB en un proyecto de PCB incluyen el conjunto de archivos necesario para fabricar una placa de circuito impreso. En cambio, el conjunto de archivos que se genera a partir de un proyecto de arnés se utiliza para comprar y ensamblar un arnés de cableado, y los archivos de esquemático lógico y ensamblaje físico de un proyecto multitarjeta generan el conjunto de archivos para fabricar y ensamblar un producto completo con varias PCB conectadas.

El conjunto de documentos de diseño del proyecto puede reunirse desde cualquier fuente accesible, local a la máquina o de otro tipo, relacionándolos entre sí mediante el archivo del proyecto como un diseño unificado. El software utiliza compilación dinámica para crear y administrar un modelo de datos unificado de los componentes del proyecto y sus conexiones. Este modelo de datos puede utilizarse después para propagar cambios de diseño entre los dominios de diseño; por ejemplo, sincronizando para resolver diferencias entre documentos en los dominios de esquemático y PCB.

Los documentos del proyecto pueden crearse y almacenarse en su Workspace de Altium, dentro de su sistema de control de versiones o localmente como archivos en la red disponible.

Las secciones siguientes describen cómo crear un proyecto nuevo y agregar documentos de diseño a un proyecto existente.

Creación de un nuevo proyecto mediante el cuadro de diálogo Create Project

Se puede crear un nuevo proyecto dentro de Altium Designer mediante el cuadro de diálogo Create Project (File » New » Project).

1. En la lista Locations, seleccione la entrada correspondiente a su Workspace (aparecerá con el nombre definido para él); debe estar conectado activamente al Workspace para ver esta opción en la lista. Este será el servidor de destino en el que se almacenará su nuevo proyecto de Workspace.

   En pocas palabras, la gestión de proyectos se centra en almacenar de forma segura y hacer seguimiento de los cambios durante todo el proceso de diseño y, en última instancia, en canalizar el diseño resultante hacia la creación de un elemento físico, como una PCB ensamblada para usar en el producto final. Para satisfacer estas necesidades, Altium Designer proporciona una gama de enfoques de gestión de proyectos que ofrecen niveles crecientes de sofisticación y capacidades, al tiempo que simplifican el proceso desde la perspectiva del diseñador. Estos abarcan desde el almacenamiento y la gestión local basados en archivos, pasando por enfoques de almacenamiento local/remoto en sistemas de control de versiones (VCS), hasta su forma avanzada y recomendada, en la que la gestión de los datos de diseño se centra en las capacidades de un Workspace.

   Un Workspace conectado y su servicio VCS interno alojan y gestionan proyectos de Altium Designer, y además proporcionan operaciones VCS simplificadas, capacidades inherentes de colaboración de diseño, uso compartido avanzado de datos de diseño, seguimiento del historial, gestión del ciclo de vida y mucho más. Los proyectos integrados con un Workspace se acceden directamente desde Altium Designer, por ejemplo desde el panel Projects, o desde el propio Workspace a través de su interfaz basada en navegador.

   Gracias a la inteligencia incorporada en los servicios proporcionados por un Workspace, tareas como las operaciones VCS se simplifican y automatizan, y funciones adicionales de colaboración de diseño, como el control de acceso de usuarios (uso compartido), los comentarios y el historial, están disponibles directamente desde Altium Designer. El resultado final es un formato y una ubicación de almacenamiento de proyectos sólidos y seguros que pueden convertirse en el punto central para el diseño colaborativo de proyectos.

   Cuando está conectado a un Workspace con una o más definiciones de proceso activas para el tema de proceso Project Creations, la capacidad de crear un nuevo proyecto a través del cuadro de diálogo Create Project está restringida únicamente a proyectos de tipo Local y VCS. En su lugar, la creación de proyectos basados en Workspace queda bajo el control de las definiciones de proceso activas. Obtenga más información sobre Process-based Project Creation.

2. En la lista Project Type, elija el tipo de proyecto que desea crear y seleccione, según sea necesario, entre las plantillas aplicables disponibles. La entrada <Empty> creará un proyecto base sin documentos fuente iniciales.

   Obtenga más información sobre Creating a Project Template.

3. Introduzca un Project Name y, opcionalmente, una Description del proyecto.

   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 utilizarse en medio del nombre (los espacios al principio y al final se ignorarán). No puede utilizar las siguientes palabras: AUX, COM1-COM9, LPT1-LPT9, CON, NUL y PRN. Además, el nombre no puede contener los siguientes caracteres: \ . / ? % * : | " < >.

El cuadro de diálogo Create Project incluye más opciones:

• Marque la opción Version Control (predeterminada) para aplicar al proyecto todas las capacidades de VCS, como historial y capacidades avanzadas de uso compartido. Cuando está desmarcada, el proyecto se almacena en el Workspace y se sincroniza con la copia local: un proyecto "reflejado" en formato Simple Sync.

  La opción Version Control solo está disponible cuando se está conectado a un Altium 365 Workspace. Cuando se está conectado a un Enterprise Server Workspace, esta opción está efectivamente marcada.

• Al crear un proyecto de tipo PCB, marque la opción Constraint Management para administrar las restricciones de diseño de este proyecto mediante Constraint Manager. Cuando la opción está deshabilitada, se utilizará el sistema de reglas de diseño para este proyecto.

  La opción Constraint Management está habilitada en el cuadro de diálogo Create Project de forma predeterminada cuando la opción System.ConstraintManager está habilitada en el cuadro de diálogo Advanced Settings dialog.

• Cuando está conectado a un Enterprise Server Workspace, el menú desplegable Repository (si está presente) mostrará todos los repositorios de diseño administrados a través del Version Control Service del Workspace y que se han compartido con usted para su uso. Elija el repositorio en el que desea almacenar el nuevo proyecto y sus archivos: de forma predeterminada hay disponible un único repositorio basado en Git (Versioned Storage). Si se selecciona un repositorio de tipo SVN, habrá una opción Repository Folder adicional disponible para especificar o buscar una carpeta de destino alternativa dentro del propio repositorio.

  El menú desplegable Repository solo aparece si ha actualizado su Enterprise Server desde una versión o producto de servidor en el que estaba habilitado el uso de repositorios SVN. Como alternativa, Enterprise Server proporciona un único repositorio de diseño basado en Git para alojar todos sus proyectos de diseño de Workspace, y el menú desplegable Repository no aparecerá en ese caso.

  SVN no es compatible con Altium On-Prem Enterprise Server a partir de la versión 7.2. Para evitar las limitaciones de administrar un proyecto SVN, se recomienda migrar los proyectos SVN al repositorio Git integrado del Workspace de Enterprise Server. Esto puede hacerse antes de actualizar el servidor, como se describe aquí.

  Para obtener más información sobre la retirada de SVN en Altium On-Prem Enterprise Server, consulte el artículo de la base de conocimientos SVN Discontinuation with Altium On-Prem Enterprise Server 7.2.1.

• Haga clic en el control Advanced para especificar rutas de carpetas.

  • Utilice el campo Folder para especificar dónde debe crearse la carpeta del proyecto dentro de la estructura de carpetas del Workspace. La ruta predeterminada para proyectos nuevos se especifica en la página Admin – Settings – Projects de la interfaz del navegador del Workspace (de forma predeterminada, será Projects\<ProjectName>). Haga clic en el botón para buscar y seleccionar una carpeta diferente del Workspace, si es necesario.

    Si el usuario que crea un proyecto en el Workspace conectado no tiene permisos de escritura en la carpeta predeterminada del proyecto, el sistema creará automáticamente una estructura específica del usuario Personal Folder para almacenar el nuevo proyecto. Esta aparece como una carpeta de nivel superior basada en la dirección de correo electrónico del miembro (para un Altium 365 Workspace) o en el nombre de usuario (para un Enterprise Server Workspace), con una subcarpeta My Projects que almacena los proyectos de ese usuario. La estructura/jerarquía de carpetas está disponible solo para el usuario que ha iniciado sesión y los administradores; no es visible para otros usuarios. Obtenga más información sobre Managing Project Creation Permissions (Altium 365 Workspace, Enterprise Server Workspace).

  • Utilice el campo Local Storage para especificar dónde se almacenará la versión local del proyecto en su disco duro. La ubicación predeterminada se define en la página System – Default Locations del cuadro de diálogo Preferences. Haga clic en el botón para buscar y seleccionar una ubicación de carpeta diferente, si es necesario. Esta es la carpeta de trabajo del proyecto y del repositorio Git local al que se confirma. En última instancia, o en el momento de la confirmación, el proyecto se envía al repositorio de diseño centralizado en el Workspace (Versioned Storage), que es el repositorio Git remote.

   

• Use el área de lista Parameters para agregar o eliminar pares personalizados de parámetros Nombre/Valor asociados con el proyecto y guardados en el Workspace. Use el botón para agregar a la lista una nueva pareja Nombre-Valor de parámetro, o el botón para eliminar una pareja seleccionada. Los campos Name y Value permiten un máximo de 255 caracteres. Al crear un proyecto de Workspace, estos parámetros del proyecto de Workspace se guardan en el Workspace con el nuevo proyecto como parámetros de nivel de proyecto del lado del Workspace.

  Cuando se selecciona una plantilla de proyecto en la lista Project Type del cuadro de diálogo, el área de lista Parameters se cargará con los parámetros de esa plantilla. Si es necesario, puede cambiar estos parámetros (nombres y/o valores) o eliminarlos. Al crear un proyecto de Workspace, un parámetro de la plantilla seleccionada se guardará como parámetro de nivel de proyecto del lado del diseño si el nombre del parámetro no ha sido cambiado. De lo contrario, se guardará como parámetro de nivel de proyecto del lado del Workspace.

  Los parámetros de nivel de proyecto del lado del Workspace pueden editarse dentro del Workspace. En cambio, los parámetros del lado del diseño se guardan en el archivo del proyecto (*.PrjPcb) y pueden editarse en Altium Designer. Los parámetros de nivel de proyecto de ambos tipos pueden verse en la pestaña Parameters del cuadro de diálogo Project Options (Project » Project Options) y pueden usarse como Special Strings en Altium Designer.

Una vez definido el proyecto según sea necesario, haga clic en el botón . La nueva estructura del proyecto se creará en las carpetas local y del Workspace especificadas. El proyecto se abrirá en el Projects panel, que reflejará el estado totalmente sincronizado existente entre los archivos del repositorio de diseño remoto (en el Workspace) y el repositorio local (copia de trabajo), tal como indican los iconos asociados. Si se crea con la opción Version Control desmarcada (disponible solo en un Altium 365 Workspace), el proyecto reflejado se mostrará en el panel Projects con un icono asociado.

El proyecto recién creado se confirma en el repositorio de diseño Versioned Storage del Workspace.

Como alternativa, si al nuevo proyecto not se le ha asignado una plantilla con documentos constituyentes, solo se crearán el archivo del proyecto (*.PrjPcb) y, por lo tanto, la estructura del proyecto. Luego, el proyecto se abre en el Projects panel, que lo mostrará como Scheduled for addition, indicado por el icono asociado. En este punto puede agregar documentos al proyecto o simplemente guardar la estructura en el Workspace en su estado actual de contenedor. Para ello, haga clic en el control Save to Server asociado con la entrada del proyecto en el panel Projects; también disponible desde el menú contextual al hacer clic con el botón derecho y desde el menú principal File. En el siguiente cuadro de diálogo Save to Server dialog, seleccione o deseleccione archivos para incluir, agregue un Comment opcional y, a continuación, confirme el proceso de guardado con el botón . Una vez que el proyecto se agregue al servidor, el panel Projects reflejará el estado totalmente sincronizado existente entre los archivos del repositorio del servidor y la copia de trabajo local, tal como indican los iconos .

Copiar un proyecto

Para copiar un proyecto de Workspace desde Altium Designer, haga clic con el botón derecho en la entrada del proyecto en el panel Projects y elija el comando Make a copy  en el menú contextual. Use el cuadro de diálogo Create Project Copy para determinar el Project Name (de forma predeterminada, será el nombre del proyecto original con el sufijo - Copy), el Description (que no se completa previamente), la ruta Folder (dentro del Workspace) y la ruta Local Storage (a la copia de trabajo).

La Folder del Workspace será, de forma predeterminada, la misma carpeta en la que se almacena el proyecto original. Haga clic en para abrir el cuadro de diálogo Choose Folder (una versión reducida del panel Explorer) y cambiar la carpeta según sea necesario. La Local Storage se configurará, de forma predeterminada, para usar la ubicación definida en la página System - Default Locations del cuadro de diálogo Preferences. Haga clic en para abrir un cuadro de diálogo estándar de Windows con el que cambiar esta ubicación según sea necesario.

Copie un proyecto de Workspace desde Altium Designer.

Agregar y quitar un documento de diseño

Una vez establecido un proyecto, los documentos de diseño pueden agregarse, editarse o quitarse del proyecto activo. La forma más sencilla de agregar nuevos documentos de diseño a un proyecto es hacer clic con el botón derecho en el nombre del proyecto en el panel Projects y seleccionar Add New to Project en las opciones del menú contextual. Como alternativa, elija el tipo de documento requerido desde el submenú Project » Add New to Project de los menús principales para agregar un nuevo documento al proyecto activo.

Agregue un tipo específico u otro tipo de documento a un proyecto.

También pueden agregarse a un proyecto otros tipos de documentos relevantes para el proyecto, como archivos de texto, PDF, hojas de cálculo, etc. Para ello, use la opción Add Existing to Project (o el comando Project » Add Existing to Project del menú principal del editor del documento activo) y configure la lista desplegable File Type en el cuadro de diálogo del navegador Choose Document to Add en All Files (*.*), para que se pueda acceder a todos los tipos de archivo.

Para eliminar un documento de la estructura del proyecto, haga clic con el botón derecho en su nombre en el panel Projects y seleccione la opción de menú Remove from Project, o elija el comando Project » Exclude from Project desde los menús principales. Se le pedirá que elija:

• Delete File – para eliminar permanentemente el propio archivo del documento fuente.

• Exclude from Project – para eliminar el vínculo del proyecto con ese documento (y no borrar el propio archivo del documento fuente). Si está actualmente abierto en la ventana del editor de diseño, se eliminará de su proyecto principal pero permanecerá abierto en el panel como un documento libre. Sin embargo, si no está actualmente abierto en el espacio de diseño, al eliminarlo se cerrará de forma efectiva.

  

Eliminar un proyecto

En el caso de proyectos locales, eliminar un proyecto consiste en borrar archivos de su disco duro. Abra la carpeta del proyecto en el Explorador de Windows y elimine su contenido.

Para proyectos de Workspace (y otro contenido del Workspace, como componentes y datos liberados), hay disponible una funcionalidad flexible para eliminar directamente desde Altium Designer, desde el panel Explorer panel. Al funcionar como una “eliminación lógica”, el proceso de eliminación ofrece más opciones e información a medida que avanza, incluidos enlaces relevantes a los elementos de origen con fines de revisión. En el Workspace, el contenido eliminado se mueve a una ubicación dedicada de Trash , donde puede recuperarse o eliminarse por completo desde la página Trash de la interfaz del navegador del Workspace.

Para eliminar lógicamente un proyecto de Workspace, navegue hasta la carpeta del proyecto en el panel Explorer, haga clic con el botón derecho en su entrada y seleccione el comando Delete Folder en el menú contextual. Confirme la eliminación en el cuadro de diálogo Confirm Delete que aparece. Si el proyecto contiene datos liberados, se abrirá otro cuadro de diálogo de confirmación para notificarle que esos datos también se eliminarán. Haga clic en Delete para continuar.

Ejemplo de eliminación lógica en acción. Aquí se está eliminando un proyecto, junto con su liberación relacionada (si se hubieran creado paquetes de fabricación a partir de alguna liberación, también se eliminarían).