Altium Designer Documentation

Share For

Created: November 11, 2021 | Updated: November 11, 2021
Now reading version 21. For the latest, read: Share For for version 22
Applies to Altium Designer version: 21

Variations of the Share For dialog
Variations of the Share For dialog

Summary

The Share For dialog allows you to edit a folder, item, and item revision's share settings. Existing users and roles may be added, edited, and removed.

New users and roles may be added using the Search for Users dialog and Search for Role dialog respectively.
Access permissions for a project can be configured using the Share dialog.

Choose a drop-down below to access information about the multiple iterations of the Share For dialog.

The Sharing Access to a Folder iteration of the Share For dialog
The Sharing Access to a Folder iteration of the Share For dialog

Summary

A Workspace supports the ability to 'share' Workspace folders – facilitating connection to and access of Workspace content of a particular nature. By sharing folders, design content in a Workspace can be easily partitioned and shared with others.

A folder in a Workspace can be shared on a number of different levels, in effect defining both the level of visibility of that folder and the level of security for access to it. This can range from being strictly private access by specified individuals or roles, to levels for allowing anyone in the same organization to view or change content respectively.

Access

The Folder iteration of the Share For dialog is accessed by clicking the Share link on the bottom left of the Folder Properties dialog.

Options/Controls

  • Sharing With Specific Users And Roles – displays the users with access to the folder, as well as whether they can edit and their status. Use the Can Edit checkbox to enable/disable a user's ability to make changes to the folder. In terms of permissions, a user/role has Read/Write access when the Can Edit option is enabled. If this option is disabled, they have Read access only.

Additional Controls

  • Add – use the drop-down to access the following:
    • Add User – click to open the Search For Users dialog, which enables you to search for and select an existing user.
    • Add Role – click to open the Search For Role dialog, which enables you to search for and select an existing role.
    • Add Anyone – click to share with anyone.

      Adding anyone indicates that there are virtually no permission restrictions on this folder.
  • Remove – click to remove selected roles or users.
  • Permissions can be modified by – use the drop-down to configure permissions to access a particular entity. The following levels of control are supported:
    • Owner – only the owner of the folder can change the permissions. Editors cannot change access permissions.
    • Collaborators – editors have full control to manage access permissions for the folder.
  • Apply to Children – enable this option to apply the same users, roles and permissions to any child folders. This option is enabled by default.

The Sharing Access for an Item iteration of the Share For dialog
The Sharing Access for an Item iteration of the Share For dialog

Summary

Sharing a folder within a Workspace is one thing, but sharing the data within that folder is another altogether. For example, a folder may be in use by two teams, with content from one team not intended for general consumption, while the other team's data is public-facing. Certain data – more specifically the Items and revisions thereof – is therefore required to be hidden, while still allowing applicable users to see the remaining content. In support of this, a Workspace supports the ability to 'share' Items within Workspace folders, offering a finer level of sharing when it comes to the actual data in a Workspace.

Access

The Item iteration of the Share For dialog is accessed by clicking the Share Item link in the Item Properties dialog.

Options/Controls

  • Sharing With Specific Users And Roles – displays the users with access to the item, as well as whether they can edit and their status. Use the Can Edit checkbox to enable/disable a user's ability to make changes to the item. In terms of permissions, a user/role has Read/Write access when the Can Edit option is enabled. If this option is disabled, they have Read access only.

Additional Controls

  • Add – use the drop-down to access the following:
    • Add User – click to open the Search For Users dialog, which enables you to search for and select an existing user.
    • Add Role – click to open the Search For Role dialog, which enables you to search for and select an existing role.
    • Add Anyone – click to share with anyone.

      Adding anyone indicates that there are virtually no permission restrictions on this item.
  • Remove – click to remove selected roles.
  • Permissions can be modified by – use the drop-down to configure permissions to access a particular entity. The following levels of control are supported:
    • Owner – only the owner of the folder can change the permissions. Editors cannot change access permissions.
    • Collaborators – editors have full control to manage access permissions for the folder.
  • Apply to Children – enable this option to apply the same users, roles and permissions to any children. This option is enabled by default.

The Sharing Access for an Item Revision iteration of the Share For dialog
The Sharing Access for an Item Revision iteration of the Share For dialog

Summary

As with folders and Items, an Item Revision in a Workspace can also be shared with permitted users/roles. Item Revision-level sharing is only truly configurable through the Explorer panel. It is not fully supported using the Workspace's browser interface. The difference is that through the Explorer panel, you can specifically share individual revisions, whereas the browser interface simply supports Item-level sharing, and if an Item is shared, all of its revisions are shared too.

Access

The Item Revision iteration of the Share For dialog is accessed by expanding the Advanced drop-down from the Item Properties dialog, then select Share Revision.

Options/Controls

  • Sharing With Specific Users And Roles – displays the users with access to the project, as well as whether they can edit and their status. Use the Can Edit checkbox to enable/disable a user's ability to make changes to the project. In terms of permissions, a user/role has Read/Write access when the Can Edit option is enabled. If this option is disabled, they have Read access only.

Additional Controls

  • Add – use the drop-down to access the following:
    • Add User – click to open the Search For Users dialog, which enables you to search for and select an existing user.
    • Add Role – click to open the Search For Role dialog, which enables you to search for and select an existing role.
    • Add Anyone – click to share with anyone.

      Adding anyone indicates that there are virtually no permission restrictions on this project.
  • Remove – click to remove selected roles or users.
  • Permissions can be modified by – use the drop-down to configure permissions to access a particular entity. The following levels of control are supported:
    • Owner – only the owner of the folder can change the permissions. Editors cannot change access permissions.
    • Collaborators – editors have full control to manage access permissions for the folder.
Found an issue with this document? Highlight the area, then use Ctrl+Enter to report it.

Contact Us

Contact our corporate or local offices directly.

We're sorry to hear the article wasn't helpful to you.
Could you take a moment to tell us why?
200 characters remaining
You are reporting an issue with the following selected text
and/or image within the active document: