Organizing Your Workspace

Now reading version 23. For the latest, read: Organizing Your Workspace for version 25

Maintain order within a Workspace by creating a tree of folders for the various Items stored in the Workspace. A number of folder types are available. Use these folders to categorize the Workspace content. Right-click in the Server Folders region of the Explorer panel to add folders and define a storage structure of folders and sub-folders that suits your organization.

The right-click menu includes commands for defining a folder hierarchy. Note that the options change depending on where you click.
The right-click menu includes commands for defining a folder hierarchy. Note that the options change depending on where you click.

Workspace Folder Types

When creating the folder to store Workspace content, you can specify the folder type. This has no bearing on the folder's content – saving a Workspace item will always result in an item of a corresponding type. It simply provides a visual 'clue' as to what is stored in a folder and can be beneficial when browsing a Workspace for particular content. To nominate a folder's use as a container for particular content, set its Folder Type accordingly when defining the folder properties in the Edit Folder dialog.

Specifying the folder type – its intended use – gives a visual indication of the content of that folder when browsing the Workspace.
Specifying the folder type – its intended use – gives a visual indication of the content of that folder when browsing the Workspace.

You have full control over the folder type and it can be changed at any time by right-clicking on a folder then selecting Properties to open the Edit Folder dialog.

For more information on the different folder types available for use in a Workspace, click here.

Workspace Folder Properties

When you add or edit a folder, the folder properties dialog will appear. The content of the dialog is the same whether a top-level or sub-folder is being added.

Four variations of the Folder Properties dialog: Edit Folder, Add Folder, Edit Folder (with Components Folder Type), and Add Folder (with Components Folder Type)
Four variations of the Folder Properties dialog: Edit FolderAdd Folder, Edit Folder (with Components Folder Type), and Add Folder (with Components Folder Type)

The dialog presents the following folder-related properties:

  • Folder Name – enter a meaningful name for the folder, perhaps an umbrella term that reflects the relationship of the Items that will be stored within it. The name can be a maximum of 160 characters.
  • Folder Type – this is already set to the folder type selected on adding the folder, either through a menu entry or through the Choose Folder Type dialog. If you need to change the type, click the arrow at the far right of the field then choose the required type from the drop-down list.
  • Description – enter any description for the folder, perhaps describing the content it is to hold. This field has a maximum of 255 characters.
  • Item Naming Scheme – this field provides a set of default naming schemes that can be used to quickly define the unique ID for any item subsequently created within the folder. Using a default naming scheme, the software will automatically assign the next available unique ID based on that scheme, having scanned the entire Workspace and identifiers of existing items. Several default example schemes are available, utilizing the short-form code for either the folder type or the content type. You can create your own scheme for a folder by typing it within the field, ensuring that the variable portion is enclosed in curly braces (e.g., SYMBOL-001-{J000}).

    The Item Naming Scheme employed for the folder can be changed at any time. The modified scheme will then be applied to any subsequent newly created content within that folder.

  • Share – click this link to access the Share For dialog in which you can specify the visibility of the folder in terms of who can 'see' and access it.

    For information about setting permissions for Workspace content, see Controlling Access to Workspace Content.
  • Add (only available in the Add iterations of this dialog) - click to add the defined added or edited folder to the Explorer panel.
  • Component Template - use the drop-down to select the desired template for the component. This option is only available in the Add Folder and the Edit Folder (with Components Folder Type) variations of the dialog.

    When a folder has a component template attached, the model and parametric data, as well as defined Lifecycle Definition, Revision Naming, and Component Naming, will be brought in from that template to the Component Editor in the Single Component Editing mode when this mode is accessed from that component folder. If that folder has no component template attached, then a default component with default settings will be presented in the Component Editor. 
  • Configure Parameters Visibility on Add - enable to configure the component's parameter's visibility after adding. This option is only available in the Add Folder and the Edit Folder (with Components Folder Type) variations of the dialog.
When releasing source domain models or component definitions to create models and components in the Workspace, an Item Naming Scheme is set as part of the release preparation and options. This is especially the case when items are being created automatically 'on-the-fly' rather than releasing to existing items that have been manually created directly within the target Workspace.

Moving Folders and Items

One or more Workspace folders, or Items within a folder, can be quickly moved using the drag and drop technique:

  • Folders – select the folder(s) to be moved (using standard Ctrl+Click, or Shift+Click techniques), then click, drag, and drop the selected folder(s) at the required place in the structure, as indicated by a horizontal indicator.
  • Items – select the Item(s) to be moved (using standard Ctrl+Click, Shift+Click, or Ctrl+A techniques), then click, drag, and drop the selected Item(s) onto a different folder in the structure.
Folders and Items can also be moved using the corresponding command available from the right-click menu (the command will reflect whether one or multiple folders/Items are being moved). Launching a command will give access to a dialog in which to select the target folder under which the folder(s) should be moved, or the Item(s) should be placed into, respectively.

Ability to Copy-Paste Workspace Folder Structure

Adding greater flexibility to the management of your Workspace content, the Explorer panel provides the ability to copy and paste a folder (and its descendant structure). This essentially allows you to quickly clone areas of your Workspace folder structure, which can prove a real time-saver when readying your Workspace for a deluge of component data, for example, where the structure is similar to a parent folder and sub-folders for the various domain models.

To use this feature:

  1. Select a folder in your existing folder structure, whose structure you wish to copy.
  2. Right-click and choose the Operations » Copy Folder Structure command from the context menu.
  3. Select the folder under which you want the cloned folder structure to be pasted.
  4. Right-click and choose the Operations » Paste Folder Structure command from the context menu.

Once pasted, you can make adjustments to the cloned folder structure as required.

  • You can only copy a single selected folder (and its descendant structure). The commands will be unavailable if multiple folders are selected.
  • Note that on paste, only the folder structure is pasted – Items within the copied folder structure are not copied.
Remember that when pasting, two folders cannot have the same name in the same area of the folder structure. Trying to do so will result in a Duplicate Folder HRID error. And while the parent folder will not be pasted, its descendant structure will be, and at the top level of the folder structure. So if you are trying to quickly create a set of cloned folders under the same parent area of the 'tree', what you can do is paste the folder structure to another temporary area of the main Workspace folder structure. Then rename the top-level folder, make any other adjustments, then drag and drop back to where you really want the folder to be.

Soft Deletion

Your Workspace provides you with flexible functionality for removing content from that Workspace directly from within Altium Designer, from the Explorer panel. This allows you to quickly delete:

  • Folders of content
  • One or more specific items
  • Projects

To delete a folder or project, right-click on that folder's entry in the panel and choose the Delete Folder command from the context menu. To delete a specific item, right-click on that Item's entry in the panel and choose the Delete Item command from the context menu. The Delete Items dialog will appear, in which to confirm the deletion. The action is actually a 'soft delete', whereby the folder/Item will be moved into the Trash area of the Workspace. The Trash is essentially a recycle bin into which any Item within your Workspace can be moved (through a soft delete action). It is isolated from the rest of the Workspace.

  • You will know if a Delete-based command within Altium Designer's Explorer panel is of the soft delete variety, as the subsequent confirmation dialog will confirm that the deleted item(s) will be moved to the Trash.
  • With the soft-delete facility, you are able to delete an item that is currently being used. For a Component Item, you can also opt to delete the component's child items (e.g., symbol, footprint model(s), simulation model, datasheet). Note that these can only be deleted if they are not being used elsewhere (by one or more other components). When deleting a project, the project repository will be moved to the Trash and also all Releases and Packages (Manufacturing Packages).
  • A folder (non-project) or item can be soft deleted, provided a user has editing rights for this folder/item. 
  • For a project, only the owner or an administrator can soft delete or restore. For more information on soft deletion of a project from within the Workspace's browser interface, see Deleting a Project (Altium 365 Workspace, Enterprise Server Workspace).
  • When deleting a Workspace folder (non-project), bear in mind that all sub-folders and items contained within the folder hierarchy will also be soft deleted.
Multiple Items can be deleted in a single action. Select all required Items using standard multi-select controls (Shift+Click, Ctrl+Click), then right-click and choose the Delete Items command from the context menu.

Example soft deletion of a Workspace project.
Example soft deletion of a Workspace project.

Example soft deletion of a Component Item, along with its associated Symbol and Footprint Items. All Items will be moved to the Workspace's Trash area.
Example soft deletion of a Component Item, along with its associated Symbol and Footprint Items. All Items will be moved to the Workspace's Trash area.

To proceed with the deletion, click the button. The item will be removed and a Deletion Summary dialog will confirm the successful deletion. If there was an issue with deletion, this will be flagged to you.

All items deleted in this manner can be found on the Trash page of the Workspace's browser interface. Note that you can only view items that you have personally soft deleted. Administrators will be able to see the full content of the Trash page – so all items that have been soft deleted.

Things to consider in relation to a soft-deleted item:

  • The item will not be available from Altium Designer or from within the browser interface.
  • Anywhere the item was being used will reflect that the item has been deleted.

    Example of a soft deleted component being flagged as such elsewhere in the software.
    Example of a soft deleted component being flagged as such elsewhere in the software.

  • An item can be restored from the Trash page, provided you have editing rights.
  • An item can be permanently deleted from the Trash page, provided you have Delete items operation permission. To learn more about managing operation permissions, refer to the Setting Global Operation Permissions for a Workspace page.
  • Permanent deletion is only possible provided it is not being used by a parent item (on a managed schematic sheet, or within a design).
Note that if you have soft deleted an item – moving it to the Trash – you can create a new item with that same name again. If you were to subsequently restore the original item, and the original name is taken, an integer suffix will be used, to keep its name unique within the Workspace.
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