Gestión de documentos del proyecto

Panel Projects

El panel Projects muestra todos los proyectos que están abiertos actualmente, así como sus documentos constituyentes y su estructura. Los menús contextuales disponibles con clic derecho en el panel ofrecen la mayoría de los comandos necesarios para trabajar con documentos de diseño.

El panel Projects

Tenga en cuenta que la presentación de los documentos en el panel Projects no refleja cómo están almacenados en el disco duro o en otra ubicación. El contenido del panel puede considerarse una representación lógica del proyecto, mientras que la ubicación física y la organización del almacenamiento de archivos de documentos (y su tipo) dependen de usted: los documentos pueden estar almacenados en una carpeta de su máquina local o de una LAN y, por supuesto, alojados en un repositorio con control de versiones proporcionado por un sistema VCS básico Git/SVN o por un sistema totalmente administrado como un Workspace.

El comportamiento del panel Projects puede configurarse mediante las opciones de la página System – Projects panel del cuadro de diálogo Preferences. Estas opciones también pueden abrirse usando el control  en la parte superior del panel.

Cuando está conectado a un Workspace, el icono de Workspace (/) se muestra junto a la entrada superior de este Workspace. Cuando se abre la copia de trabajo local de un proyecto pero el Workspace donde reside el proyecto no está conectado, aparecerá un icono de Workspace atenuado (/).

Un proyecto de Workspace también puede compartirse con usted sin invitarlo al equipo del Workspace donde reside dicho proyecto. Un proyecto que se ha abierto desde acceso compartido se indica mediante una etiqueta Shared with me asociada con el icono junto a ella.

Si un proyecto fue compartido con usted de modo que solo pueda verlo, se mostrará la etiqueta View Only junto a la entrada del proyecto en el panel para indicarlo: mostrar ejemplo.

Los proyectos locales se enumeran bajo la entrada del grupo de proyectos ( *.DsnWrk): ya sea el predeterminado (Project Group 1.DsnWrk) o uno que usted haya creado o abierto.

Para acceder al menú contextual relacionado con su Workspace conectado actualmente, haga clic con el botón derecho sobre el nombre de su Workspace o haga clic en el control  ubicado en el extremo derecho. Estos comandos incluyen:

• Open Project – abre el cuadro de diálogo Open Project dialog.
• Create Project – abre el cuadro de diálogo Create Project dialog.
• Show in Explorer – abre el panel Explorer panel.
• Show in Web Browser – abre la página Projects de la interfaz de navegador del Workspace en su navegador predeterminado.
• Sign out – cierra su sesión en el Workspace.
• Sign in – inicia sesión en el Workspace. Este comando está disponible siempre que tenga al menos un elemento del Workspace (por ejemplo, un proyecto) abierto en el panel Projects y que actualmente esté desconectado del Workspace donde reside dicho elemento.

Debe estar conectado a un Workspace para acceder a estos comandos. Cuando haya cerrado sesión en un Workspace, haga clic con el botón derecho en el Workspace al que desea conectarse y haga clic en el comando Sign In.

Árbol de documentos del proyecto

Cuando abre un proyecto existente o crea uno nuevo, su entrada aparecerá en el panel Projects. Cualquier documento existente que forme parte de un proyecto (y cualquier documento nuevo que se haya agregado) aparecerá bajo subcarpetas según su propósito y/o tipo. Por ejemplo, las siguientes carpetas comunes y tipos de documentos de contenido pueden aparecer bajo un proyecto:

• Source Documents – documentos de diseño principales como esquemáticos, PCB, etc.
• Settings – proporciona varios archivos utilizados dentro del proyecto, incluidos archivos Output Job, archivos Harness Definitions y documentos de anotación, entre otros archivos pertinentes.
• Libraries – documentos de bibliotecas fuente locales. Los documentos se subdividen además según el tipo de biblioteca (por ejemplo, bibliotecas esquemáticas, bibliotecas PCB, etc.).
• Documentation – documentos adicionales que se han agregado al proyecto, de un tipo conocido por Altium Designer (por ejemplo, texto, PDF, etc.).
• Other Documents – documentos adicionales que se han agregado al proyecto, de un tipo no conocido por Altium Designer. Estos pueden abrirse con Altium Designer si la aplicación propietaria es conocida por Windows (por ejemplo, documentos de Word, hojas de cálculo de Excel, etc.).
• Generated – documentos generados como salida. Los documentos se subdividen además según el tipo (por ejemplo, documentos BOM, documentos de texto, etc.). A medida que se genera la salida del proyecto, las subcarpetas correspondientes en el árbol principal se crearán y se irán llenando.
• Components – esta carpeta enumera cada componente y la cantidad de componentes en cada grupo. Valide el proyecto si esta carpeta no aparece (Project » Validate). Los componentes se agrupan de forma predeterminada por la primera letra del designador; haga clic con el botón derecho en la entrada de un componente (o en la carpeta de agrupación de componentes) y elija el comando Component Grouping en el menú contextual para acceder rápidamente a los controles Components Grouping del panel Projects y cambiar el estilo de agrupación o desactivar la agrupación, según sea necesario. Consulte la sección Searching for Components and Nets in the Project Structure de la página Creating Circuit Connectivity in Your Schematics para obtener más información.
• Nets – esta carpeta enumera cada red utilizada en el proyecto. Valide el proyecto si esta carpeta no aparece (Project » Validate). Consulte la sección Searching for Components and Nets in the Project Structure de la página Creating Circuit Connectivity in Your Schematics para obtener más información.

Notes on working in the documents tree:

• Cualquier documento que sea independiente de un proyecto aparecerá como Free Documents y aparecerá bajo las subcarpetas correspondientes. Al hacer clic con el botón derecho en un documento libre y elegir el comando Add to Project <ActiveProjectName> en el menú contextual, puede agregar al proyecto activo un documento libre que esté abierto actualmente. Como alternativa, puede arrastrarlo y soltarlo sobre el nombre del proyecto requerido en el panel Projects.
• Además de permitir tener múltiples documentos abiertos para edición, el entorno también admite que varios proyectos estén abiertos al mismo tiempo. Estos pueden ser proyectos relacionados o no relacionados.
• Los documentos del panel Projects se organizan automáticamente en grupos lógicos o “carpetas”, como documentos fuente (Schematic, PCB, etc.), documentos de configuración (Harness, Outjob, etc.) y, en el caso de un diseño jerárquico, documentos esquemáticos de nivel superior. Los documentos dentro de cada grupo de carpetas se muestran de forma predeterminada en el orden en que fueron agregados, pero pueden arrastrarse y soltarse a una nueva posición dentro del grupo.
• En el caso de un nuevo diseño jerárquico, la relación padre-hijo entre documentos se mostrará en el panel. Tenga en cuenta que las relaciones de conectividad no pueden definirse arrastrando y soltando documentos esquemáticos, ya que las conexiones entre hojas y la jerarquía de diseño se definen realmente mediante símbolos de hoja y definiciones de puerto.
• Haga clic con el botón derecho en una subcarpeta de documentos del proyecto, esté expandida o cerrada, para acceder a comandos adicionales de administración de documentos, como abrir, cerrar o guardar todos los documentos dentro de la subcarpeta de documentos del proyecto enfocada.
• Los documentos pueden transferirse entre proyectos en el panel haciendo clic y arrastrando. No es necesario arrastrar el documento a la subcarpeta correcta; se colocará automáticamente en la ubicación adecuada dentro de la estructura del proyecto.
• Los atajos de teclado Up Arrow, Home, End y Down Arrow pueden utilizarse para mostrar la entrada anterior, la primera, la última y la siguiente en el panel, respectivamente. Use las teclas Right Arrow y Left Arrow para expandir y contraer una entrada de nivel superior o su subcarpeta, respectivamente.
• Para realizar cross-probe desde la entrada del componente o red seleccionada en el panel Projects hasta esa entidad en el documento esquemático o PCB del proyecto de diseño PCB principal, haga clic con el botón derecho en la entrada y elija el comando Cross Probe to Schematic o Cross Probe to PCB en el menú contextual.
• Para abrir una instancia del Explorador de Windows en la ubicación donde se almacena un documento de proyecto, haga clic con el botón derecho en su entrada en el panel Projects y seleccione el comando Explore. Para el documento que tiene el foco en el panel Projects, esto puede hacerse haciendo clic en el control  situado en la parte superior del panel.

Opciones del proyecto

Un proyecto existente o recién creado está asociado a un conjunto de ajustes de opciones específicos de ese proyecto. Estos se almacenan en el archivo del proyecto (*.PrjPcb, por ejemplo) y variarán según el tipo de proyecto.

Los ajustes de opciones se configuran en el cuadro de diálogo Project Options dialog, al que se puede acceder desde Project » Project Options en el menú principal o haciendo clic con el botón derecho en el nombre del proyecto en el panel Projects y seleccionando después Project Options en el menú contextual. Para el proyecto que tiene el foco en el panel Projects, se puede acceder al cuadro de diálogo haciendo clic en el control  situado en la parte superior del panel.

Otros ajustes del proyecto que se definen en otros cuadros de diálogo y luego se almacenan en el archivo del proyecto incluyen:

• Ajustes de anotación del esquemático.
• Ajustes de salida como informes, impresión, Gerber, etc. Tenga en cuenta que estos son los ajustes de salida a los que se accede mediante los menús del editor esquemático o PCB, en lugar de los ajustes de salida definidos en un documento OutJob document.

Indicación del estado del documento

A medida que trabaja con documentos de proyecto en Altium Designer, el panel Projects proporciona un resumen visual de qué archivos de documentos han sido modificados o guardados mediante iconos de estado asociados a cada documento de diseño y al archivo principal del proyecto. Esto proporciona un resumen visual rápido de qué documentos están modificados, guardados, si pertenecen al Workspace o son locales, y su estado de control de versiones. Los iconos de documento y sus significados se enumeran a continuación.

Iconos de estado de Abierto/Modificado

[blank]	El documento está cerrado.
	Abierto – El documento está abierto como un documento con pestañas en la ventana del editor de diseño.
	Abierto/Modificado – El documento está abierto y ha sido modificado (aún no se ha guardado). Un documento modificado se marca con un sufijo de asterisco junto a su entrada en el panel Projects . Un documento modificado también tiene un asterisco junto a su nombre en su pestaña de documento abierta (o en el menú emergente asociado si los documentos están agrupados).
	El archivo del documento está abierto y bloqueado por esta instancia de Altium Designer.
	El archivo del documento está abierto y ha sido bloqueado por otra instancia de Altium Designer.
	El documento está siendo editado por otro usuario. Esta condición de estado está habilitada por la función Collaborators Visualization & Conflict Prevention.
	El documento que está siendo editado por otro usuario está actualmente abierto en el editor. Esta condición de estado está habilitada por la función Collaborators Visualization & Conflict Prevention.
	Falta el documento (más información sobre documentos faltantes).

Iconos de estado del control de versiones

El sistema de control de versiones supervisa y compara esencialmente los archivos de documentos de la carpeta de trabajo con sus equivalentes en el repositorio de diseño. Altium Designer solicita e intercambia información con el sistema de control de versiones a través de su interfaz VCS, y responde en consecuencia a las condiciones comparativas de estado de los archivos. En la práctica, esto se manifiesta en los iconos de archivo de Projects, mediante una serie de alertas de VCS, y a través de cambios apropiados en los comandos de gestión de archivos disponibles.

Los iconos y su significado son los siguientes:

[blank]	N/D	El documento no está bajo control de versiones en un repositorio VCS.
	Sin modificaciones	La copia local del documento coincide con el documento del repositorio y está actualizada.
	Programado para adición	Se ha agregado un documento al control de versiones, pero todavía no se ha confirmado mediante Commit (registrado) en el repositorio VCS.
	Modificado	La copia local del documento ha sido modificada y guardada en la carpeta de trabajo. Confirme el documento para crear una nueva revisión en el repositorio. En el caso de un documento PCB, también puede usar la funcionalidad PCB CoDesign para comparar los cambios locales con el último commit en el Workspace mediante el comando Local Changes to Remote Document Version del menú contextual History & Version Control » Compare To del panel Projects o del menú principal Projects » History & Version Control » Compare To.
	Desactualizado	La copia local del documento (en la carpeta de trabajo) es más antigua que su equivalente en el repositorio y, por tanto, está desactualizada. Use el comando Update Project From Server del menú contextual History & Version Control del panel Projects o del menú principal Projects » History & Version Control para recuperar desde el Workspace la versión más reciente del documento. Tenga en cuenta que guardar un documento en este estado creará una condición de conflicto. Cuando el proyecto contiene solo documentos en estado Desactualizado y Sin modificaciones, también puede usar el control Update from Server que aparece junto al nombre del proyecto en el panel Projects para recuperar desde el Workspace las versiones más recientes de los documentos desactualizados – mostrar imagen.
	Prevención de conflictos	Otro usuario ha confirmado el documento antes de que usted confirmara su propia versión editada y guardada localmente de ese documento. Use el comando Revert Local Changes de Control de versiones para descartar las modificaciones locales del documento del proyecto. En el caso de un documento PCB, también puede usar la funcionalidad PCB CoDesign para comparar y fusionar cambios.
	Conflicto detectado	Al intentar guardar un proyecto en el Workspace cuando el proyecto contiene documentos en el estado Conflict Prevention, estos documentos pasarán al estado Conflict Detected. Se mostrará el cuadro de diálogo informativo Action Required, que enumerará los documentos en conflicto que necesitan resolverse. Use los siguientes comandos del menú contextual History & Version Control » Resolve Conflict del panel Projects para resolver el conflicto: Compare To Remote Version & Merge – use este comando para resolver el conflicto de un documento PCB comparando y fusionando cambios mediante la funcionalidad PCB CoDesign. Use Remote Version – use este comando para resolver el conflicto actualizando el documento con su revisión más reciente desde el Workspace. Keep Local Version – use este comando para resolver el conflicto utilizando la versión local del documento.
	Por delante del servidor (Git)	El documento del repositorio de trabajo local es más reciente que su equivalente en el repositorio Git remoto. Esto ocurre cuando un documento local ha sido modificado, guardado y confirmado en el repositorio local, pero aún no se ha Pushed en el repositorio remoto.
	Programado para eliminación	El documento del proyecto ha sido eliminado del control de versiones y se eliminará del repositorio y de la base de datos de VCS durante el proceso Version Control Commit. Este icono también aparece cuando falta un documento en la carpeta de trabajo local (ha sido eliminado, renombrado o movido), lo cual se resuelve repoblando la carpeta desde el repositorio con el comando Restore document from VCS del menú contextual de VCS.
	Fusionado	El documento PCB se ha fusionado con una revisión más reciente del repositorio mediante la funcionalidad PCB CoDesign . Confirme el proyecto en el Workspace para guardar el documento PCB fusionado en el repositorio del Workspace.

Cambiar el orden de los documentos del proyecto

Los documentos del panel Projects se organizan automáticamente en grupos lógicos o “carpetas”, como documentos fuente (esquemático, PCB, etc.), documentos de configuración (Harness, Outjob, etc.) y, en el caso de un diseño jerárquico, documentos esquemáticos de nivel superior. Los documentos dentro de cada grupo de carpetas se muestran, de forma predeterminada, en el orden en que fueron agregados, pero se pueden arrastrar y soltar a una nueva posición de orden dentro del grupo.

En el caso de un nuevo diseño jerárquico, la relación padre-hijo entre los documentos se mostrará en el panel Projects . Tenga en cuenta que las relaciones de conectividad no pueden definirse arrastrando y soltando documentos esquemáticos, ya que las conexiones entre hojas y la jerarquía del diseño están definidas en realidad por los símbolos de hoja y las definiciones de puertos.

► Para obtener más información sobre la jerarquía del proyecto, consulte Creating Connectivity y la sección Net Identifier Scope del tab Options del cuadro de diálogo Project Options.

Cambio de nombre de documentos

Puede cambiar directamente el nombre de cualquiera de los documentos de diseño que forman parte de un proyecto PCB (*.PcbDoc, *.SchDoc, etc.), del propio proyecto PCB (*.PrjPcb) o del grupo de proyectos (*.DsnWrk) usando el comando Rename, disponible en el menú contextual al hacer clic con el botón derecho sobre un proyecto en el panel Projects panel , y el posterior cuadro de diálogo Rename.

Ejemplos de cambio de nombre de un proyecto y de uno de sus documentos de diseño, localmente desde Altium Designer. Esos cambios se sincronizarán con el Workspace cuando guarde y envíe los cambios a ese Workspace.

Una vez realizado el cambio de nombre, guarde los cambios en el Workspace usando el comando Save to Server (disponible en el mismo menú contextual del proyecto). La sincronización del cambio de nombre del archivo se mantiene entre la copia de trabajo local del proyecto y su contraparte en el Workspace. Además, cuando se renombra el nombre del archivo del proyecto y el proyecto se guarda en el servidor, el Workspace cambia automáticamente el parámetro Name del proyecto administrado para que coincida.

Por el contrario, cuando el nombre de un proyecto administrado se actualiza a través de la interfaz del navegador del Workspace, el cambio se propaga a Altium Designer la próxima vez que se abra el proyecto.

Para editar las propiedades de un proyecto administrado existente en el Workspace, seleccione su entrada en la página Projects, haga clic en el control situado encima de la lista de proyectos y elija la entrada Edit en el menú asociado. Cambie el nombre del proyecto en la ventana Edit Project que aparece a continuación.

Cuando el proyecto actualizado se abre en Altium Designer (File » Open Project), un cuadro de diálogo inicial ofrece la opción de alinear el nombre del archivo del proyecto local con el nuevo Name del proyecto, o forzar que el Name del proyecto del servidor coincida con el nombre existente del archivo del proyecto.

Opciones disponibles si ha cambiado el nombre del proyecto del lado del Workspace.

Compartir documentos entre proyectos

Debido a que un proyecto de Altium Designer define y guarda vínculos a archivos de documentos almacenados, se puede crear cualquier cantidad de proyectos que enlacen a esos mismos archivos de documentos.

Aunque esta puede ser una forma práctica de reutilizar documentos de diseño ya establecidos —por ejemplo, incluir un esquema estándar de fuente de alimentación en varios proyectos—, no es una práctica recomendada porque un cambio en el documento afectará a todos los proyectos a los que esté vinculado. Un enfoque mucho mejor para la reutilización de diseños es establecer y aplicar Managed Sheets.

Para obtener más información sobre la reutilización de documentos de diseño y Managed Schematic Sheets, consulte la página Working with Managed Schematic Sheets.

Administración de documentos faltantes

Si no se encuentra un documento de proyecto definido dentro del archivo del proyecto en la carpeta del proyecto (por ejemplo, el documento se eliminó desde el Explorador de Windows), se considera faltante. Al abrir un proyecto que contiene un archivo faltante, se mostrará una notificación correspondiente en el panel Messages. La entrada del documento aparecerá atenuada y marcada como faltante con un icono distintivo en el panel Projects.

Hay comandos asociados disponibles que le brindan control total sobre el manejo de documentos faltantes. Use el menú contextual al hacer clic con el botón derecho sobre un documento faltante en el panel Projects para eliminar el archivo faltante seleccionado o todos los archivos faltantes del proyecto, o para actualizar la ruta al archivo (es decir, reemplazar el archivo faltante por uno seleccionado). En el caso de un proyecto bajo control de versiones, también puede revertir modificaciones locales para restaurar un archivo faltante desde el repositorio VCS del proyecto.

Al agregar un archivo existente al proyecto usando el comando Add Existing to Project desde el menú contextual de la entrada del proyecto, si el nombre y la ruta del archivo que se está agregando son los mismos que el nombre y la ruta de un archivo faltante (lo cual es posible cuando, por ejemplo, el archivo faltante se agregó a la carpeta del proyecto después de abrir el proyecto en Altium Designer), se abrirá un cuadro de diálogo de confirmación preguntando si desea reemplazar el archivo faltante por el seleccionado.

Comparar documentos locales con datos de commit o release

Para proyectos alojados en un Workspace, puede comparar documentos esquemáticos, PCB y BOM guardados localmente con los datos de un commit o release de este proyecto. Los comandos para seleccionar el conjunto de datos requerido con el que deben compararse los documentos locales pueden elegirse desde las siguientes ubicaciones:

• El menú contextual History & Version Control » Compare To del documento del proyecto en el panel Projects panel.
• El menú del botón Compare en el cuadro de diálogo Save to Server dialog.
• El menú de control del mosaico Local Changes de la vista Project History view.

❯ ❮ Javascript ID: LocalCompare_AD24

• Cuando se selecciona el comando Latest Commit o Latest Release, se iniciará la comparación de los datos del proyecto con los de la última entrada de commit/release.
• Cuando se selecciona el comando Select Document Version or Release (desde el panel Projects) o el comando Select Commit or Release (desde el cuadro de diálogo Save to Server), se abrirá la vista Document History o Project History, respectivamente, para el documento/proyecto seleccionado. Seleccione el mosaico de un commit o release para comparar los datos guardados localmente con los datos de ese commit/release.

Una vez completado, los resultados de la comparación se presentan en la vista Compare, que se abre como una nueva pestaña en su navegador predeterminado.

Panel Clipboard

Para almacenar y mostrar objetos copiados que pueden agregarse (pegarse) a documentos de Altium Designer en cualquier etapa, permitiendo múltiples operaciones de copiar/pegar, se puede usar el panel Clipboard .

Visualice y aplique (pegue) el contenido del panel Clipboard para todos los tipos de datos de diseño.