Workspace Projects

Parent page: Altium NEXUS Server

The Altium NEXUS design client, in conjunction with the NEXUS Server Workspace, brings support for Workspace Projects. Workspace projects target the development stage of the project lifecycle, simplifying the creation and ongoing workflow for version-controlled projects. Centralized storage under the control of the Workspace also enables this feature to be a foundation for other collaborative services.

Some key benefits to using Workspace projects are:

• Simplified storage. No need to make decisions about storage locations. Backup and other basic services are taken care of.
• Foundation for collaborative features.
• Enforced version control.
• Advantages of a dedicated commenting system.
• Notifications and status. Document status including local modifications is visible to entire design teams.
• Concurrent PCB design works without any complex setup.
• Ability to share a read-only, browser-based interactive view of a project with other users, via the Web Viewer.
• A range of advanced version control features, such as an interactive Project History view.

Technically, a Workspace project is the combination of meta-information stored on the NEXUS Server Workspace along with tight integration with the Workspace's own Version Control service. The typical workflow is as follows:

1. A user creates a new Workspace project via the NEXUS design client's Create Project dialog, by converting an existing local project via the Make Available On Server dialog, or from within the Workspace browser interface (detailed below). During creation, that user defines the project's name, description, and design repository.
2. Access to the project is defined and managed in the Workspace browser-based interface, or directly within the NEXUS design client.
3. All collaborators select the project for opening (either from within the design client or from the Workspace browser interface) after which it is automatically checked out as design files.

This document takes a look at working with projects through the Workspace's browser interface. For information on working with projects in your design software, see Working with Projects.

Creating a New Workspace Project

There are three main ways in which a Workspace project can be created:

• Creation of a new project from the Workspace browser-based interface, or from within the NEXUS design client.
• Making an existing project (a local project, or a local project currently under external version control) available to the Workspace, from within the NEXUS design client – that is, converting a local project to a Workspace project. See the Making an Existing Project Available in the Workspace page to learn more.
• Cloning an existing Workspace project through the Workspace browser-based interface, or by cloning a project from the NEXUS client's Projects panel.

To create a Workspace project directly through the NEXUS Server Workspace's browser interface:

1. Sign in to the interface and select the Projects menu option to access the Designs page. Any previously created projects will be listed here.

2. Click the button at the top of the page and then the Create Project menu option to open the Create Project  window.

   If there are any active process definitions available for the Project Creations process theme – defined on the Project Creations tab of the Processes page of the server's browser interface – then the button menu will offer those processes as options in place of the Create Project option. Choose the required entry to invoke that process workflow.

3. The window will initially present in a simplified view. Enter the desired name for the project, a description (if needed), and choose a suitable Project Template from the Templates drop-down menu.

   The project name should start with, and can contain A-Z, a-z, or 0-9. Underscores, dashes, and spaces are allowed, but the latter can only be used within the middle of the name (leading and trailing spaces will be ignored). You can not use the following words: AUX, COM1-COM9, LPT1-LPT9, CON, NUL, and PRN. In addition, the name cannot contain the following characters: \ . / ? % * : | " < >.
4. To access more controls click the button. The following fields will present:
   1. Parent Folder – use this field to specify where the folder for the project is to be created within the server's folder structure. By default, this will be Projects\<ProjectName>. The default path for new projects is specified on the Admin – Settings – Projects page of the Workspace's browser interface.

   2. Repository – this field will list all Design Repositories managed through the Workspace's local Version Control service, and which have been shared with you to use. Choose the repository in which to store the new project and its files. By default, the Versioned Storage (Git-based) repository will be selected.

      If you upgraded to Altium NEXUS Server from previous server technology and still have the ability to use internal (SVN) and/or external (SVN/Git) design repositories, the Repository field will be presented. This lists all design repositories managed through Workspace's local Version Control service, and which have been shared with you to use. Choose the repository in which to store the new project and its files. If an SVN-based repository is chosen, the Repository Folder field will be presented. Use this field to specify the name of the folder within the repository in which to accommodate the project and its associated files. By default, this will take the project's name.

Defining a new Workspace project directly through the Workspace's browser interface.

After defining the new project as required, click – the new project will be created. You will come back to the summary-level project list, where you will now see an entry for the newly-created project.

An additional Workspace project, created through the browser interface.

Browsing Workspace Projects

The projects listing on the Projects page of the Workspace browser interface includes all projects that are shared with you, and offers a range of controls to access project management features. Use the  button to switch the page to its project preview (graphical tiles) mode and the  button to switch the page to its detailed list mode.

The Designs page of the Workspace browser interface – command central for working with your Workspace projects. Here, the detailed list mode for the page is shown. Hover the mouse over the image to see the project preview mode.

The view's project entries are automatically sorted by Last modified date, with the most recently modified project appearing first in the list. Click the button to change to sorting by project Name, and click again to toggle between ascending and descending order.

The List mode view () can be sorted by Name, Author, or Date, using the column header in each case. Click once to sort in ascending order, click again to sort in descending order. The arrows to the right of the column name will indicate the currently active sort direction.

The Projects view provides Properties and Activities data that relate to the selected project, available in the view's right-hand sidebar pane.

The sidebar pane information includes: Properties tab: Project – a high-level summary of the project's state, including the 3D view of the board (where a PCB is available for the project). Shared With – the users and/or roles who have access to the project. Hover over an entry to see the full name of the user/role. Parameters – detailed metadata extracted or computed from the project design itself. Click the Show More control to expand the full list. Releases – a list of project releases in chronological order. Click on an entry to open that release in the Workspace's Manufacturing Portal. Activity tab – a chronological list of project events, such as a Commit, Release, or a completed process workflow associated with the project.

For each project, the following operations also are provided by the buttons at the top of the view (and detailed in the linked sections that follow):

• Share – access controls with which to configure project access permissions.
• Activities – menu access to the process activities available to the project.
• Functions – menu access to project functions. Also available from the button of a selected project when in Preview mode:
  • Open – open the project in its detailed CAD-centric view. Equivalent to clicking (Preview mode) or double-clicking (List mode) on a project name entry.
  • Move – relocate the project to another parent folder within the Workspace's folder structure.
  • Edit – edit the project in terms of its Name, Description and Workspace Parameters.
  • Clone – create a renamed identical copy of the project.
  • Watch/Unwatch – follow/unfollow a project's activity by receiving related notifications (updated, released, etc.) in the project's Activitiy tab, and also via email if Email Notifications are enabled.
  • Delete – remove the project entry by moving its structure and data to the Workspace Trash, where it can be permanently deleted from the Workspace or restored to its previous state.

Also included is a project Search feature that can filter the project listing by a range of properties such as Name, Author, Description, etc. Type any part of a search string in the field at the top of the browser interface. The list will update to include only those project entries whose attributes include the search string.

To clear the search filtering, either click on the main Projects page entry in the left-hand navigation pane, or clear the search field and press Enter.

Example use of the search feature, in this case finding a project based on its Description.

Working with Workspace Folders

The NEXUS Server Workspace also provides the ability to create and manage project folders within the Workspace's structure. Projects may then be created in or moved to any folder in the resulting folder hierarchy.

To create a new folder under the (default) top-level Project folder, choose the Create Folder option from the button menu. In the following Create Folder window, specify the name of the new folder, its parent folder, and an optional description. A new folder is always created under the currently selected folder, which becomes its parent folder.

Open a created folder by selecting its title, and navigate back up the hierarchy using the breadcrumbs above.

Use the menu options to modify a folder's details (Edit), relocate the folder under a different parent folder (Move), or remove the folder from the Workspace's folder structure (Delete). When moving a folder, select a new parent folder from the hierarchy tree in the Move folder <folder> to window.

Upload a Project

In the Altium NEXUS design client the Make Available on Server command will upload a local project to the NEXUS Server Workspace, where it becomes a Workspace project under its version control. An equivalent process can be performed within the Workspace browser interface from the Upload Project option available from the button menu. Browse to and select a local project's host folder to upload that project to the currently selected Workspace folder by default, or use the Change option in the Upload Project windows' Parent Folder list to select an alternative location in the folder hierarchy.

Any existing version control links in the local project are ignored, and the uploaded project becomes a fully version-controlled Workspace project – the local source project is not altered in any way.

Move a Project

To relocate a project to a different Workspace folder, select the Move option from the menu drop-down options and select a new location from the folder hierarchy in the Move project <project> to window. When confirmed with the button, the selected project will then be hosted under the newly specified parent folder.

Sharing a Workspace Project

Once a project is in the Workspace, you'll want to determine which users can actually access that project. This is done by sharing the project, or rather, by configuring its access permissions. A Workspace project is shared, by default, with the following:

• The Owner of the project, which is usually the designer who created it (or made it available on the Workspace): full (Read/Write) access permissions.
• The Administrators role group: full (Read/Write) access permissions.
• All members of the Workspace: with view-only access.

Default permissions for new projects can be defined/changed on the Admin – Settings – Projects page of the Workspace's browser interface. Note that the Owner of the project is inherently assigned permission to access it and therefore is not present in the list.

Configuration of access permissions can be performed through the NEXUS Server's browser interface, and also directly from within the NEXUS design client.

To configure access for a project from the Workspace's browser interface, select the project entry on the Designs page (Projects on the main menu) and click the button to access the Share:<project> window – or the Share option from the menu associated with a project entry. This offers all the controls necessary to share the project with other users or groups of users (Roles).

With projects centrally managed in the Workspace, sharing with others is simply a case of managing each project's permissions.

Within the Share <project> window:

• A user/role has Read/Write access when the Can Edit option is enabled. If this option is disabled, they have Read access only.
• A project may be shared with all members of the Workspace for read-only (Can View) or read/write (Can Edit) access using the drop-down menu of the Workspace Members entry in the Shared With region.
• To remove an existing user/role from having shared access to a project, click the Remove option in the associated drop-down menu.

Things to be aware of:

• By default, all Workspace users will be able to see the project. If you want to lock access down to a specific set of users and/or groups, you must first select No access in the drop-down menu of the Workspace Members entry.
• The owner of a project has permanent Read/Write access.
• You can also share a direct link to the project. The link is obtained by clicking the Copy Link control, at the bottom of the Sharing window. The link is copied to the clipboard. When used, it provides the applicable user – where permitted – access to the detailed management page for the project, an overview for which is presented in the next section.

Workspace Project Activities

The NEXUS Server Workspace offers the unique capability of applying configurable Process Workflows to Workspace projects in order to perform tailored tasks such as performing design reviews and creating new projects. Processes and their underlying Workflows are created and configured by a Workspace administrator, and when enabled, become available to users of both the NEXUS design client and the NEXUS Server Workspace browser interface.

► See Creating & Managing Processes for more information.
► See Performing Design Reviews for information on these processes in the NEXUS design client.

From a user perspective, Process Workflows and their inherent steps are considered as Activities. Available Activities can be invoked by users, and their workflow steps completed by assigned users as a sequence of tasks – available through the Tasks page.

Select the menu on the Designs page (Projects) and choose from the available Processes to initiate an activity for the currently selected project. Complete the required fields and options in the following process form windows, and then start the process (). Depending on the Process Workflow that has been invoked, a following step may need to be submitted () to prepare the data for review.

Workflow Tasks are then created for the user, or users, assigned to the Activity. A task that applies to a signed in user will appear in their Tasks page, where it can be acted upon to progress the Workflow to its next stage.

Note that when an Activity has been assigned to a Role Group – Engineers for example – a related Task becomes available to all members of that group, and also any individual users that have been assigned to the Activity – here, user Bruce (a member of the Engineers role). In such cases, any of these users can complete the review step and submit the result ().

Workspace Project Functions

Functional operations associated with projects are available from the menu on the Designs page, and include the ability to open, move, edit, clone, watch and remove a Workspace project. The menu also is available from the button of a selected project entry:

Open a Project

Select the Open option from a project entry's menu or from the upper menu to open a project into its manufacturing orientated CAD-centric view – or when in Preview mode (), click on the project's name. The view provides access to several sub-views available from the navigation pane:

• Design – navigate and interact with the project's design documents, inspect object properties and place review comments. The view applies to the current (latest) project revision, and uses the Web Viewer interface.
• Supply – Interactively examine work-in-progress (WIP) BOM data extracted from the design documents, including entries for Manufacturer and Supplier parts data derived from a project's populated ActiveBOM document.
• Releases – view summary information on all Releases for the current project, each of which can be opened in the Manufacturing Portal view. This in turn provides sub-views for the release package files, design documents and supply data in that selected release.
• Activities – view active or closed Process workflow Activities that apply to the current project.
• History – browse a progressive timeline of major events relating to the project, including its creation, commits, releases, and clones. Each time a supported event happens in association with the project, that event is added to the timeline as a dedicated tile with various actions supported where applicable.

► See Management of a Specific Project for more information.

Edit a Project

To edit the properties of an existing project in the Workspace, select its entry on the Designs page (Projects) and then the Edit option from its menu or the upper menu. In the following Project Editing window you can change the project's Name, Description and manage Workspace Parameters entries.

Click the button in the Project Editing window to expose additional property data derived from and stored with the project. Select the Parameters control to access and add (), edit, or remove () parameter Name/Value pairs. These are saved in the Workspace with the project, and may be used as Special Strings in the Altium NEXUS design client – access from the Properties panel with a placed text object selected in the design space. By contrast, Project type parameters are saved in the project file (*.PrjPcb), and can be edited in the NEXUS design client.

Clone a Project

To clone (duplicate) an existing Workspace project, select its entry on the Designs page (Projects) and then the Clone option from its menu or the upper menu. Use the Clone Project window to set the name and description for the cloned project – by default, the original project name will be used with a - Copy suffix.

Click the button to expose additional property fields, which include the target parent folder and Repository information. The target folder setting will automatically match the project name unless manually specified, or assigned to a different existing parent folder via the Change option.

A project can be cloned in the NEXUS design client from the  menu Clone option in the Explorer panel, or by right-clicking on a project name in the Projects panel and choosing the Clone option from the context menu.

After setting the fields as required, click the button to confirm. The original project will be cloned (duplicated) along with its constituent files and data, and be added as a new project entry to the Projects page listing.

Watch a Project

To 'watch' – receive notifications regarding – project in the Workspace, select its entry on the Designs page (Projects) and then the Watch option from its menu or the upper menu.

When you follow (watch) a project, you will receive notifications related to the project (such as commit, release and property change messages) under the Activities tab in the interface's right-hand pane. The creator of the project will automatically be set to watch that project. When enabled, the command will change to Unwatch – select to stop following the project and cease reception of notifications for events relating to that project.

Delete a Workspace Project

To delete (remove) an existing Workspace project, select its entry on the Designs page (Projects) and then the Delete option from its menu or the upper menu. The action is effectively a 'soft delete', where the project repository is moved into the Workspace's Trash area. A project can be deleted in the NEXUS design client using the  menu Delete option in the Explorer panel.

From within that view (select Trash from the main menu), the project entry can be completely removed (Permanently Delete) or the action reverted (Restore). Note that the button will remove all entries (where possible) that are stored in the Workspace's Trash.