Managing Environment Configurations in Altium On-Prem Enterprise Server

An organization can centrally control the environment its designers operate in through the definition and management of Environment Configurations. These are used to constrain each designer's Altium Designer working environment to only use company-ratified design elements, including schematic templates, output job configuration files, BOM templates, layer stacks, project templates, Draftsman templates and design preferences.

Environment configurations are created and managed from within the Team Configuration Center through its browser interface, allowing an administrator to craft one or more environment configurations, depending on the needs of the organization.

Accessing the Team Configuration Center

The interface to the Team Configuration Center is accessed through the Workspace's browser interface. Once signed in navigate to the Admin - Configurations page using the nav tree on the left. Note that this page is only accessible when you are signed in to the Workspace with administrative rights (are a member of the Administrators group).

Define and manage Environment Configurations through the Team Configuration Center, part of the Workspace's browser interface.
Define and manage Environment Configurations through the Team Configuration Center, part of the Workspace's browser interface.

Creating an Environment Configuration

To create a new environment configuration, click the  button, located at the top-right of the page (or the Add a Configuration link on the page when no configuration exists yet). The Configuration details page will display, presenting a shell configuration ready to be defined.

Javascript ID: Configurations_AddConfig_AES7_0

Adding a new configuration.

The resulting shell configuration, ready to be defined.

Although the environment configuration is created, it is not yet saved. To ensure the configuration is 'saved', click the  button at the top-right of the page. The configuration does not have to be defined prior to saving, except for a name, allowing you to create placeholder configurations, then come back later to define them. Configuration data is stored in the Workspace's database.

Any number of environment configurations may be created and defined, in accordance with the needs of your organization.

Click on the Configurations entry in the breadcrumbs area to return to the summary page, listing currently saved (not necessarily defined) configurations. Click on the  icon, or the configuration name, to access the Configuration details page again to continue defining, or make changes to, the configuration.

Use the breadcrumbs to switch back to the summary page for currently defined configurations. Click a configuration's name, or the associated folder icon, to switch back to the Configuration details view.
Use the breadcrumbs to switch back to the summary page for currently defined configurations. Click a configuration's name, or the associated folder icon, to switch back to the Configuration details view.

Defining an Environment Configuration

Definition of an environment configuration essentially consists of the following:

  • Name - a meaningful name, perhaps reflective of the people whose working environment it is to govern.
  • Description - a meaningful description.
  • Groups - specification of target groups to which the environment configuration applies. These are the same groups that are defined and used by the Workspace to control access permissions.
  • Configuration Data - the elemental constraints of the configuration. The revisions of supported data items that can be validly used by a user targeted by the configuration.
Be sure to click the  button to save configuration data and nominated target groups to the configuration.

Groups

To specify a group for assignment to the configuration click within the Roles field and start typing its name, to pop-up a list of matching groups. Select the required group from this list. Multiple groups can be chosen for assignment. To remove a group, click the delete cross to the far right of its name.

Any number of environment configurations can be defined, with each used by any number of defined groups. Groups ensure that each user gets the Altium Designer setup they are entitled to, especially if using a shared work computer.
Groups are defined through the Workspace's browser User Management interface and are essentially specific groupings of users. You may be familiar with this interface as part of the set-up and management of user access to your Workspace. For more information on definition of users and groups, see Managing Users & Groups.

Data Item Access

To be able to use the revision of a data item specified through an environment configuration, the member users within an assigned group need to be able to 'see' that Item Revision. Unless specifically shared, an Item Revision is only visible to the person who created it - its Owner - and any member of the Administrators group. This enables you to control which data Items of an environment configuration are available, when that configuration is used by various different groups. The configuration service will flag any data items that cannot be seen by one or more assigned groups with the entry Invisible for Groups: <GroupName> appearing in the description field for the data item.

The configuration service will alert you to any data items that are not visible to an assigned group. In this case, users in the Engineers group can see the defined data items because those Item Revisions have been shared with that group. The Item Revisions have not been shared with the Managers group.
The configuration service will alert you to any data items that are not visible to an assigned group. In this case, users in the Engineers group can see the defined data items because those Item Revisions have been shared with that group. The Item Revisions have not been shared with the Managers group.

For more information on controlling access to Items in an Enterprise Server Workspace and folder-, Item- and Item Revision-level sharing, see Controlling Access to Workspace Content.

Configuration Data

Before you can define configuration data for the environment configuration, first ensure that relevant data Items have been created, released/committed/uploaded to and exist in, the Workspace. For more information, click a link below:

The process for specifying which configuration data Items - sourced from the organization's Workspace - are to be used by users of the environment configuration, is the same for each of the supported data elements. In each case, you specify the required data Item revision through use of the Explorer window, accessed by clicking the  button, to the right of the respective section.

Within the Explorer window, use the left-hand region, which reflects the folder tree in the Workspace, to browse to and select the folder containing the required Item. Once selected, the top-right region will populate with a listing of Items (and revisions thereof) in that folder. Select the required revision (enable its associated checkbox) and click OK. Multiple revisions can be selected for addition en-masse (with the exception of preferences).

Selecting the top-level entry for an Item will add the latest revision of that Item.

Example of browsing for revisions of Output Job Items, to be used by the environment configuration.
Example of browsing for revisions of Output Job Items, to be used by the environment configuration.

Any number of Schematic Template, Output Job, BOM Template, Layer Stack, Project Template, Draftsman Document Template and Draftsman Sheet Template Item Revisions may be specified for an environment configuration. However, only a single Altium Designer Preferences Item Revision may be specified. The same data Items can also be used across different environment configurations.

With certain data item types, additional features are provided when defining a configuration:

  • When you have assigned a revision of an Altium Designer Preferences Item to the configuration, an additional region is added, that allows you to browse what is included in that revision (what will be controlled, at least initially). Simply click the Show details info control to access this, and click on a folder to expand further.

  • For BOM Templates, Layer Stacks, Project Templates, Draftsman Document Templates, and Draftsman Sheet Templates, you have the choice of how, if at all, those data items are controlled. Choose from the following:

    • Do Not Control - select this setting to leave the use of this area uncontrolled. The user will be able to use local, file-based templates.
    • All Available Revisions - select this setting to instantly add all available revisions of all released Items of the respective type, to the configuration.
    • Specific Revisions - select this setting to only use specific revisions of released Items of the respective type, for the configuration. Click the  button to access the Explorer window, with which to browse and add those required revisions.

  • For Outputjob documents, you have the option to mark them as required - by enabling the Req'd option associated with a chosen Item Revision. Simply put, if an OutJob defined as part of an environment configuration is marked as required, then release will not be possible until that OutJob is present and enabled for inclusion in the relevant data set being generated as part of project release.

Once the configuration is defined as required, click the  button.

Example defined environment configuration.
Example defined environment configuration.

To remove the currently chosen Altium Designer Preferences Item Revision, click the associated Remove link, or control (). To remove an Item Revision of any other data item type, click the associated Remove control ().
If an environment configuration applicable to a user has not been fully defined - i.e. not all data configuration items have been specified/added - those undefined elements of the environment will remain manually definable by the user. This is true also for those applicable elements that are set to Do Not Control.

Removing an Environment Configuration

To remove an environment configuration, deleting it from the Team Configuration Center (and from the Workspace's database), click the Remove control () at the far right of the entry for that environment configuration, on the summary Configurations page. In the subsequent confirmation window click the  button.

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