Projects in a NEXUS Server Workspace

Вы просматриваете версию 1.1. Для самой новой информации, перейдите на страницу Projects in a NEXUS Server Workspace для версии 5.0
Applies to NEXUS Server version: 1.1

This documentation page references NEXUS Server (part of the deployed NEXUS solution), which has been discontinued. All your PCB design, data management and collaboration needs can now be delivered by Altium Designer and a connected Altium 365 Workspace. Check out the FAQs page for more information.

 

Parent page: Altium NEXUS Server

Altium NEXUS, in conjunction with the Altium NEXUS Server, brings support for Managed Projects. Managed 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 Altium NEXUS Server also enables this feature to be a foundation for other collaborative services.

Some key benefits to using Managed 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.
  • Beneficiary 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.

Technically a Managed Project is the combination of meta information stored on the server, along with tight integration with the NEXUS Server's local Version Control service. The typical work flow is as follows:

  1. A user creates a new managed project (via the New Project dialog in Altium NEXUS, from the NEXUS Server's browser-based interface, or by converting an existing project (in Altium NEXUS)). During creation, that user defines the project's name, description, and design repository.
  2. In the NEXUS Server's browser-based interface, or directly within Altium NEXUS, access to the project is defined and managed.
  3. All collaborators select the project for opening (either from within Altium NEXUS, or from the NEXUS Server's browser interface) after which it is automatically checked out.
The beauty of Managed Projects is that they are version controlled by default, and can be collaboratively worked upon without having to worry about shared drives, servers, agreements etc.
Prior to creating a new Managed Project, or converting an existing non-managed project, ensure that a Design Repository exists in which to store that project, and all future projects. Design Repositories are centrally managed as part of the Altium NEXUS Server, through its local Version Control service. A new installation of the Altium NEXUS Server provides a single Git-based design repository - Versioned Storage - for accommodating all of your managed design projects. If you have upgraded your Server from Altium NEXUS Server 1.0 (or Altium Vault 3.0), then use of SVN repositories will also be enabled, so that you can continue to use your previous (and established) design flow. In this case, you can continue to create repositories through the local Version Control service (SVN-only), or connect to external repositories (SVN or Git).

Creating a New Managed Project

There are three ways in which a Managed Project can be created:

  • Creation of a new project within Altium NEXUS.
  • Creation of a new project within the NEXUS Server's browser-based interface.
  • Conversion of an existing, non-managed project from within Altium NEXUS.

The following sections take a closer look at these three avenues of creation.

Through Altium NEXUS

From within Altium NEXUS, a new Managed Project can be created using the New Project dialog (File » New » Project):

If at least one process definition for the Project Creations process theme is active - on the Project Creations tab of the Processes page of the NEXUS Server's browser interface - the ability to create a new managed project (Project Kind = Managed) through the New Project dialog is disabled. Instead, the active process definitions will be available to choose from, on the File » New » Managed Project sub-menu.
  1. Select the project type, choosing from the applicable templates available as required.
  2. Give the project the desired name.
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: \ . / ? % * : | " < >.
  1. Use the Location field to determine where, on your local drive, to initially store the project, prior to its commital to the centralized Design Repository.
  2. Use the Project Kind field to choose the Managed option.
  3. The Repository field will list all Design Repositories managed through the Altium NEXUS Server'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.
  4. Use the Repository Folder 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. This field is not applicable for a Git repository.
  5. Use the Server Folder field to specify where the folder for the project - within the NEXUS Server's folder structure - is to be created. By default, this will be Projects\<ProjectName>.
The default path for new projects - within the NEXUS Server's folder structure - is specified on the Admin - Settings - Projects page of the NEXUS Server's browser interface.

Setting up to create a new Managed Project from within Altium NEXUS, courtesy of the New Project dialog. Note that only those central Design Repositories
that are shared with you will be available for selection from the Repository field.

After clicking OK, the new project will be created locally, in accordance with the defined Location. The project will be opened in the Projects panel, which will show the project as being Scheduled for addition, denoted by a blue cross icon ().

The project will appear in the Projects panel under an entry for the target Server, reflecting the name of that Server.

Right-click on the project in the Projects panel and choose the Version Control » Commit Whole Project command or Save Managed Project command. You will be presented with the Commit to Version Control dialog. Select the files you wish to commit to the Design Repository and click Commit and Push (or Commit for a target SVN repository). Once added, the Projects panel will reflect the fully synchronized state that exists between the files in the repository and the local working copy.

Commit the newly created Managed Project to the target Design Repository.Commit the newly created Managed Project to the target Design Repository.

In addition, an entry for the project will appear on the Projects page of the NEXUS Server's browser-based interface.

The newly-created Managed Project, evident on the Projects page of the NEXUS Server's browser interface.The newly-created Managed Project, evident on the Projects page of the NEXUS Server's browser interface.

The newly-created Managed Project, evident on the Projects page of the NEXUS Server's browser interface.The newly-created Managed Project, evident on the Projects page of the NEXUS Server's browser interface.

The project will initially be shared for Read/Write access with the designer who created it, and all Administrators for the Altium NEXUS Server. In addition, it will be shared for Read-only access publically, meaning that all users of the NEXUS Server can view the project. For more information on configuring project access permissions, see Sharing a Managed Project.

Through the NEXUS Server's Browser Interface

A Managed Project can be created directly through the Altium NEXUS Server's browser interface:

  1. Sign in to the interface and access the Projects page. Any previously created projects will be listed here.
  2. Click the  button at the top-right of the page. The Add Project pop-up window will appear.
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 NEXUS Server's browser interface - then this button will appear as . Click to access and choose the required process. The corresponding workflow for the chosen process will then be invoked.
  1. The window will initially present in simplified view. Enter the desired name for the project, a description (if required), and, if available, choose from any Managed Project Templates that exist in the NEXUS Server.
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: \ . / ? % * : | " < >.
  1. To access more controls - putting the window in advanced view - click on the Show additional fields control. The following fields will present:
    1. Server Folder - use this field to specify where the folder for the project - within the NEXUS Server's folder structure - is to be created. By default, this will be Projects\<ProjectName>. The default path for new projects - within the NEXUS Server's folder structure - is specified on the Admin - Settings - Projects page of the NEXUS Server's browser interface.
    2. Project Type - use this field to specify the type of project, from a list of all project types supported by Altium NEXUS. If you have selected a managed project template to use, this field will not be presented.
    3. Repository - this field will list all Design Repositories managed through the Altium NEXUS Server'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.
    4. Repository Folder - 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. If the Versioned Storage (Git-based) repository is chosen, this field will not be presented.

Defining a new Managed Project directly through the NEXUS Server's browser interface.Defining a new Managed Project directly through the NEXUS Server's browser interface.

Defining a new Managed Project directly through the NEXUS Server's browser interface.Defining a new Managed Project directly through the NEXUS Server's browser interface.

After defining the new project as required, click  - the new project will be created. You will initially be taken to the detailed view for the project - more on this later. Click the Projects entry in the navigation tree to come back to the summary-level listing of managed projects, where you will now see an entry for your newly-created project has been added to the list.

Additional Managed Project, created through the browser interface. Click the Projects entry in the nav tree to switch back from the detailed project view, to the summary-level view.Additional Managed Project, created through the browser interface. Click the Projects entry in the nav tree to switch back from the detailed project view, to the summary-level view.

Additional Managed Project, created through the browser interface. Click the Projects entry in the nav tree to switch back from the detailed project view, to the summary-level view.Additional Managed Project, created through the browser interface. Click the Projects entry in the nav tree to switch back from the detailed project view, to the summary-level view.

The project will initially be shared for Read/Write access with the designer who created it, and all Administrators for the Altium NEXUS Server. In addition, it will be shared for Read-only access publically, meaning that all users of the NEXUS Server can view the project. For more information on configuring project access permissions, see Sharing a Managed Project.

Conversion of an Existing Non-Managed Project

You can also create a Managed Project from an existing non-managed one, by converting the latter to the former. To do this, open the existing non-managed project as normal in Altium NEXUS, then right-click on its entry in the Projects panel, and use the Convert to Managed Project command from the context menu.

If at least one process definition for the Project Creations process theme is active - on the Project Creations tab of the Processes page of the NEXUS Server's browser interface - the Convert to Managed Project command will not be available. Rather it will be a sub-menu, presenting those active process definitions from which to choose. The corresponding workflow for the chosen process will then be invoked.

If the project is currently under Version Control in a local Design Repository, it can not be converted directly. A message will alert you to this, with the option to essentially convert the project to a Regular project first - ignoring SVN revisions and changes log - and then converting that Regular project to a Managed one.

The Convert to Managed Project command opens the Convert to Managed Project dialog, which operates in two modes - Simple and Advanced. Click the button at the bottom-left to switch between these two modes accordingly.

  • Simple Mode - requires you to determine the project's name, and a description. By default, the name will be that of the original project.
  • Advanced Mode - provides the ability to specify:
    • The target Design Repository, managed through the Altium NEXUS Server that you are currently signed into. Choose from all managed repositories shared with you, and that are defined through the NEXUS Server's Version Control service (on the VCS page (Admin - VCS) of the NEXUS Server's browser interface). By default, the Versioned Storage (Git-based) repository will be selected. Note that if you are converting a VCS-type project, and that project already exists in an SVN design repository provided by the Server, then that same repository will be used - you will not be able to choose a different one.
    • The repository path and directory therein are shown, the latter of which can be modified as required (by default a folder of the same name as the project will be created within the repository). If the Versioned Storage (Git-based) repository is chosen, this field will not be editable.
    • The path to the local working copy of the project is also reflected. You also have the ability to define a Server Folder, in which data for the project will be released when using Altium NEXUS's Project Releaser. By default, this will be Projects\<ProjectName>.

Convert an existing project to a Managed Project.Convert an existing project to a Managed Project.

The conversion process involves the following steps:

  1. With the properties for the Managed Project defined as required in the Convert to Managed Project dialog, click OK.
  2. The Add to Version Control dialog will subsequently open with all pertinent files selected for addition. Check all is as required and click Commit And Push (or Commit for an SVN repository).
  3. The project and files will be committed to the target Design Repository, with the Projects panel reflecting the fully synchronized state that exists between the files in the repository and the local working copy.

The newly-converted Managed Project will subsequently be available from the Projects page of the NEXUS Server's browser interface.

The converted project is added to the list of centrally-managed projects.The converted project is added to the list of centrally-managed projects.

The converted project is added to the list of centrally-managed projects.The converted project is added to the list of centrally-managed projects.

The project will initially be shared for Read/Write access with the designer who converted it, and all Administrators for the Altium NEXUS Server. In addition, it will be shared for Read-only access publically, meaning that all users of the NEXUS Server can view the project. For more information on configuring project access permissions, see Sharing a Managed Project.

Browsing Managed Projects

As mentioned already, Managed Projects are available to browse from the Projects page of the NEXUS Server's browser interface.

The Projects page of the NEXUS Server's browser interface - command central for managing your managed projects.The Projects page of the NEXUS Server's browser interface - command central for managing your managed projects.

The Projects page of the NEXUS Server's browser interface - command central for managing your managed projects.The Projects page of the NEXUS Server's browser interface - command central for managing your managed projects.

Each project is listed in terms of the following information:

  • Name - the name of the project, along with its description (if defined).
  • Author - the user who created the project.
  • Last modified - the date on which the project was last modified.
The list of managed projects is automatically sorted by Last modified date, with the most recently modified project appearing first in the list. The list can be sorted by any of these data columns - click once within a column header to sort in ascending order, click again to sort in descending order.

For each project, the following controls are provided (and detailed in the linked sections that follow):

 Open - open the project, via its detailed view.

 Edit - edit the project, in terms of its Name and/or Description.

 Share - access controls with which to configure project access permissions.

 Remove - remove the project.

Detailed Project View

Clicking the Open control () associated with a managed project - or clicking on its name - will give you access to a detailed view of the Project.

Accessing the detailed view for a managed project.Accessing the detailed view for a managed project.

Accessing the detailed view for a managed project.Accessing the detailed view for a managed project.

This view of a project can also be accessed within Altium NEXUS, through the Explorer panel. It is the default view, available once the project has been released to the NEXUS Server. If you are viewing your project-related Items in the Classic View, you can switch to this detailed view by clicking the  button at the top-right of the panel, and choosing Project View from the associated context menu.

The following tabs are available within the view:

  • Stream - detailing recent activity for the project.

Server parameters are only currently available when using a process workflow to create a new managed project with initialisation in a connected PLM instance. The relevant part numbers for the project are automatically created in the PLM instance, and then propagated back to the NEXUS Server as Server-level parameters of the NEXUS Managed Project.

These parameters will be available to use as special strings - access from the Properties panel with a placed text string selected in the design workspace. Server parameters defined for the project can also be viewed on the Server Parameters tab of the Project Options dialog (Project » Project Options).
  • Releases - presents every release of the project, with the latest release at the top of the list. Each entry on the left shows a snapshot of the date/time of release, along with what packages are included in the release. Use the Search field to quickly find a specific release (very useful if you have released the project many times).

As you click on a release entry on the left, the following sub-tabs on the right populate with information for that release:

The currently selected release can be downloaded by clicking the  control, to the far right of the tab. The Download Configuration pop-up will appear, with which to specify what data you wish to include in the download (e.g. source, fabrication and any assembly packages).

Configure the packages to be included in a download of the currently selected release of the managed project.Configure the packages to be included in a download of the currently selected release of the managed project.

Configure the packages to be included in a download of the currently selected release of the managed project.Configure the packages to be included in a download of the currently selected release of the managed project.

Once you have configured the download as required - using the available check boxes - click the  button. A master zip file will be downloaded to your browser's default downloads folder (named according to the format: SRC-<ProjectName>-<ReleaseRevision>(<IncludedPackages>).zip, for example SRC-Bluetooth_Sentinel-A.2(fab,src,pcba).zip. This contains individual zip files of the packages selected for download.

You can also initiate a Web Review for the currently selected release of the project - Web Review on-demand as it were. To do so, click the  control, to the far right of the tab. A new browser tab will open, presenting the Web Review instance.

Web Review 'on-demand' - available for every release of every managed project.Web Review 'on-demand' - available for every release of every managed project.

  • Working Files - the source design files, which can be downloaded in a single Zip file.
  • Activities - a listing of activities associated to the project. A designer can start a dedicated activity for a managed project, using predefined Project Activity process workflows that have been defined for the company. Click on an entry for an activity to view a diagram of its underlying process workflow (on the Diagram tab below the list), showing what needs to happen for the activity to be completed, and where the activity is at along that flow, in terms of who now has a task to perform to move the activity along. Tabs are also available for seeing the data attached to the activity (Data tab), and also a history of actions taken along the activity's process workflow (History tab). Controls are available to switch the list between Active and Closed activities, as well as to search for a specific activity of interest.
For a NEXUS Server administrator, the ability to terminate an active process is available - just click the  control.

A number of additional controls are also available for the presented project:

  • VCS Location - the URL to the project inside its parent design repository. For a project stored in an SVN-based design repository, click this link to open that design repository, in which the project resides, in your external SVN client browser.
  • - click this button to start a new activity for the project. A menu of possible activities will be presented from which to choose.
Three predefined process definitions for Project Activities are activated for use out-of-the-box (Ad Hoc Review, Handoff Review, and Milestone Review). These can be found on the Project Activities tab of the Processes page of the NEXUS Server's browser interface. Use these, modify them, or create your own as required, to suit the needs of project-related activities within your company. In addition, three more sample process definitions are available relating to publishing of content to a PLM - Publish to PLM (latest), Publish to PLM (User selects), and Project Releaser with Publish. These cannot be activated and used as is. Each of these is therefore more like a 'template' - edit to suit your company's PLM, name, and save as a new process definition, which you can then activate and use, along with all other definitions in the Project Activities process theme.
  •  - click this button to open the project within Altium NEXUS (by opening the X2.exe file). If Altium NEXUS is already running, the project will be opened in that instance.
  •  - click this button to access the Edit Project window. From here, you can change the project's Name and/or Description. All other fields are non-editable, providing information only.
  •  - click this button to access the Manage Permissions window, with all the controls necessary to share the project with other users. See Sharing a Managed Project for more information.
  •  - click this button to follow the project. You will receive applicable notifications related to the project (e.g. updated, released, permission changes) on the project's Stream tab, as well as the main Home and Stream pages of the browser interface. The creator of the project will automatically be set to watch that project.
  •  - click this button to stop following the project. No further notifications relating to that particular project will be received on the project's Stream tab, nor the main Home and Stream pages of the browser interface.
  •  - click this button to access the Clone Project window, providing the controls to make an identical copy of the project. See Cloning a Managed Project for more information.
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 NEXUS Server's browser interface - then this button will appear as . Click to access and choose the required process.
  •  - click this button to remove the project from the repository, rendering it no longer managed. If you have checked out the project locally, you will still have this local working copy.

Sharing a Managed Project

Once a project is managed, 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. Remember that a managed project - newly created or converted - is shared, by default, with the following:

  • The designer who created (converted) the project - full (Read/Write) access permissions.
  • The Administrators role - full (Read/Write) access permissions.
  • Publicly - denoted by the presence of the Public entity - with Read-only access permissions.

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

From within the NEXUS Server's Browser Interface

To configure access for a project from the NEXUS Server's browser interface, from the Projects page of the interface click on the project's associated Share control ().

Also available by clicking the  button, from the detailed Project view.

The Manage Permissions window will appear, with all the controls necessary to share the project with other users.

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

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

Things to be aware of:

  • In terms of permissions, a user/role has Read/Write access when the Can Write option is enabled. If this option is disabled, they have Read access only.
  • To remove an existing user/role from having shared access to a project, click the associated Remove control ().
  • All users of the NEXUS Server will by default be able to see the project. If you want to lock access down to a specific set of users and/or roles, you must remove the Public entity.
  • If you remove the Public entity, it can be added back again using the Add Public control. Be aware that doing so will, by default, grant Read/Write access of the project to all NEXUS Server users.

From within Altium NEXUS

Access for a project can be configured directly from within Altium NEXUS by using the Project Permissions command. This command can be accessed for the active project, or a focused project:

  • Active project - with a source document for the project open as the active document, choose the Project » Project Permissions command, from the main menus.
  • Focused project - access is made from the Projects panel by right-clicking on the entry for the required project and choosing the Project Permissions command, from the context menu.

The Permissions For - <ProjectName> dialog will open in which you can configure sharing as required.

Configure access to your Managed Project directly from within Altium NEXUS.Configure access to your Managed Project directly from within Altium NEXUS.

Opening a Managed Project

To work on a managed project, you check it out as a local working copy. This can be performed in two ways:

  • Directly from within Altium NEXUS - use the File » Open Managed Project command. The Open Managed Project dialog will appear, from where you can choose which managed project to open. Only those Managed Projects that have been shared with you (you have permission to access) will be listed, and from across all managed Design Repositories shared with you.

Choose which managed project to open, from within Altium NEXUS, from those currently shared with you.Choose which managed project to open, from within Altium NEXUS, from those currently shared with you.

You have the option to open the project to the default checkout path, or a custom path of your choosing. The default checkout path is taken from the Document Path field, on the System - Default Locations page of the Preferences dialog.
  • From the Projects page of the NEXUS Server's browser interface - click the Open control () associated with the project. From the detailed view for the project that is presented, click the  button.
After clicking the  button, a dialog will appear asking for confirmation to open X2.exe - Altium NEXUS's underlying executable. Click the Open X2.exe button to open the project in the running instance of Altium NEXUS (or to launch the last used instance of Altium NEXUS).

Access the control to open a managed project from its detailed view within the NEXUS Server's browser interface.Access the control to open a managed project from its detailed view within the NEXUS Server's browser interface.

Access the control to open a managed project from its detailed view within the NEXUS Server's browser interface.Access the control to open a managed project from its detailed view within the NEXUS Server's browser interface.

Editing a Managed Project

To edit the properties of a Managed Project at a later stage, click its associated Edit control ().

Also available by clicking the  button, from the detailed Project view.

The Edit Project window will appear. From here, you can change the project's Name and/or Description. All other fields are non-editable, providing information only.

You can edit the Name and Description for a Managed Project at any stage.You can edit the Name and Description for a Managed Project at any stage.

You can edit the Name and Description for a Managed Project at any stage.You can edit the Name and Description for a Managed Project at any stage.

Cloning a Managed Project

To clone an existing managed project, access its detailed Project view, then click the  button. The Clone Project window will appear.

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 NEXUS Server's browser interface - then this button will appear as . Click to access and choose the required process. The defined workflow for that process will be invoked.

You can clone a managed project - creating an identical copy of it, along with its working files.You can clone a managed project - creating an identical copy of it, along with its working files.

You can clone a managed project - creating an identical copy of it, along with its working files.You can clone a managed project - creating an identical copy of it, along with its working files.

Use the window to set the following for the clone project:

  • Name
  • Description
  • Server Folder
  • Repository Folder (where applicable)

By default, the original project name will be used, simply adding the suffix ' - Copy'.

The cloned project will be made in the same design repository as the original - you cannot change this as part of the cloning process.

After setting the fields as required, click the  button - the original project will be cloned, and the clone opened within the interface at the Stream tab of its detailed Project view.

Removing a Managed Project

To remove a Managed Project, click its associated Remove control ().

Also available by clicking the  button, from the detailed Project view.

 

Content