Navigating a Project

Now reading version 17.0. For the latest, read: Navigating a Project for version 22

 

Design projects can quickly become complicated as they evolve, and frequently contain a large number of design documents of varying complexity and amounts of data. While this can present document navigation challenges,  a project and its constituent documents is normally navigated through the Projects or Storage panels. These panels also offer direct access to high-level management functions such as document comparison and Version Control.

Altium Designer also provides visually orientated project navigation aids that present selectable previews of a project's contents, which are available from the Projects panel (Project Insight) and the Workspace project overview (Project Previews). The primary advantage of using a preview-based navigation approach is that it avoids the need to open each document to ascertains its contents. This makes the task of finding the right document simple and fast, and provides a quick, visual approach to gaining an overview of a project.

Project Insight

Accessed in the Projects panel, an intuitive and visual aid to project navigation is available with Project Insight, which is part of Altium Designer's Design Insight feature. Design Insight provides a number of advanced features that assist navigation at the project, document and even connectivity level, allowing automatic preview without having to physically open multiple sheets.

The Design insight features are enabled in the System – Design Insight page of the Preferences dialog (DXP » Preferences). Activate the Project Insight overview by checking the Enable Project Insight box, and optionally, the Enable Document Insight box to preview document entries.

Project Insight allows you to preview all of the documents and navigate to a particular document in your project with ease. Hover over the Project icon  in the Projects panel to gain 'insight' into a project's constituent design documents. Navigate to and open a specific document by clicking on its preview image. Project Insight displays both Schematic and PCB documents.

Visually preview the documents in a project by hovering over the Project icon in the Projects panel. Click to open a document.
Visually preview the documents in a project by hovering over the Project icon in the Projects panel. Click to open a document.

If there are a large number of documents in a project, left and right arrows become active in the preview. Use these to navigate through the project files.
If there are a large number of documents in a project, left and right arrows become active in the preview. Use these to navigate through the project files.

Documents appear in the Project Insight overview in the order they were added to the project. To view the order that files were added, enable Show document position in project in the System – Projects Panel page in the Preferences dialog. A number will appear next to the document entries in the Projects panel.

The Design Insight preview function also applies to individual document entries in the Projects panel – as a Document Insight. Again, simply hover the cursor over a document icon to view a preview graphic of that document, and click on the image to open the document in its editor.

Project Previews

Beyond the immediate preview capabilities provided by the Project Insight feature in the Projects panel, Altium Designer also provides a dedicated preview system that caters for multiple projects, and all types of documents.

Using the same graphical preview approach as Project Insight, the Workspace view provides full browsing, preview and selection capabilities for all currently open projects. It also presents additional project documents, such as Output Jobs, Harness Definition files, Annotation files, Libraries, or even generated documentation.  The Workspace view is one of several views available under Altium Designer's Home page.

The Workspace view - command central for graphically browsing open projects and their documents.
The Workspace view - command central for graphically browsing open projects and their documents.

The Workspace view can be accessed in the following ways:

  • With the Home page the active document, click the Workspace tab.
  • Use the View » Workspace menu command.
  • Click the  icon, from an Editor's Standard toolbar.
  • Use the Ctrl+` keyboard shortcut.

Browse a specific Project

The Workspace view page is divided into several sections, with each applying to a group of document types.

The Opened Projects region of the view lists, as its name suggests, all projects that are currently open. Different icons are used to depict each project type, which assists browsing when many projects of differing types are open concurrently. Only one project can be browsed within the view at any given time, and this is distinguished by a highlighted background. Click on a project entry to select it for browsing.

The project currently being browsed is highlighted in the Opened Projects list.
The project currently being browsed is highlighted in the Opened Projects list.

Clicking a project's entry in the Projects panel will select that project in the Workspace view, ready for browsing. Conversely, clicking a project's entry in the Workspace view will make that project the focused project in the Projects panel.

With the desired project selected in the list, the remaining sections in the Wokspace view present the project's constituent documents. Documents are gathered into logical groupings, similar to the sub-folder structuring found in the Projects panel. The exact groupings will depend on the type of project being viewed.

For Schematic, PCB and OpenBus documents, document previews are available. Previews are generated for the currently focused project in the Projects panel, when accessing the Workspace view. Previews for another open project are only generated when that project has been selected.

Constituent documents displayed when browsing different example projects.
Constituent documents displayed when browsing different example projects.

Expand and collapse sections of documents within the view using the   control, available to the left of each section name.

Use Ctrl+mouse wheel to effectively zoom in and out, making the graphical previews of documents (where applicable) bigger or smaller. Note that if you zoom out to full extent, the document previews will be replaced with document icons.

Project and Document actions

Actions can be performed at the project and document -level, directly from within the Workspace view. Select the project or constituent document, then right-click to access the menu of available commands – as determined by the type of project/document selected. These commands are identical to those found when right-clicking over the project or document entry in the Projects panel.

Perform actions on projects or documents directly from the Workspace view.       
Perform actions on projects or documents directly from the Workspace view.

Double-click on a document in the view to open it as the active document in the design workspace.

Filtering

Use the filtering control at the top-right of the view to quickly find a particular project or document. This is particularly useful when many projects are open, or a project contains a large number of documents. The content of the view will dynamically update as you enter a filter string.

In terms of documents, filtering will be performed only on the documents for the current project being viewed.

Use filtering to quickly locate a project or document of interest.
Use filtering to quickly locate a project or document of interest.

Preferences

Click the Preferences link at the top-right of the view to gain access to various display-related options. Note that these options are global, and apply to all open projects in the view.

Access display-based preferences for the Workspace view.
Access display-based preferences for the Workspace view.

  • Enable the Show VCS status option to display the current VCS state of each file that is under version control. The applicable state icon is displayed at the bottom-right of a project/document icon, or document preview.

    Example of VCS states displayed for a project under version control.
  • Enable the Mark Device Sheets option to add a 'Recycle' watermark graphic to the graphical preview of any device sheets used in a project. This helps to quickly distinguish device sheets from standard schematic sheets.

    Example marking of device sheets with option disabled (top) and then enabled (bottom).
  • Enable the Show full path in hint option to have a document's location displayed in a pop-up hint when the cursor is hovered over that document's entry.

    Quickly view where a document is stored, through enabled path hints.
  • Enable the Show file extensions option to display the extensions for each document in the view. This is useful if you are not familiar with the icons used to represent the various file types.

    Displaying file extensions can make browsing a project's documents that much easier.

By default, all Preference options are enabled, with the exception of Show file extensions.

If you find an issue, select the text/image and pressCtrl + Enterto send us your feedback.
Note

The features available depend on your Altium product access level. Compare features included in the various levels of Altium Designer Software Subscription and functionality delivered through applications provided by the Altium 365 platform.

If you don’t see a discussed feature in your software, contact Altium Sales to find out more.

Content