In 3decision, a privilege is a permission given to a user that allows him to do a specific action. For example, a user granted the privilege ‘create structure’ will be able to upload a new structure in the application. You will be able to handle privileges on structures, projects and user groups. It is possible to grant privileges to a user, a user group or all users of a project.
There is a different set of privileges associated to structures, projects and user groups.
List of Privileges
| Privilege Name | Description | API Only |
|---|---|---|
| delete structure | If you have this privilege on a structure, you will be able to delete it permanently from 3decision. | |
| access structure | This privilege allows a user to search for and view the structure in 3decision. | |
| manage users access to structure | With this privilege you will be able to add/remove other users or group of users from the structure. It also allows management of other user privileges related to this structure. In combination with the privilege ‘share structure in projects’, it allows the granting of default privileges to all members of a project on any structure added to the project. You will be able to grant/remove only privileges you already own. |
|
| manage structure parameters | A user with this privilege is able to add/update/remove structure parameters to the structure. For now, this is only possible using 3decision API. | X |
| manage structure files | This privilege allows you to add/update/remove structure associated files. Another privilege is requiered if you want to manage project files. | |
| manage structure relations | With this privilege, you will be able to use 3decision API to add/update/remove relations to the structure. | X |
| manage structure annotations | This privilege allows you to add/update/remove annotations to the structure using 3decision API. | X |
| share structure in projects | A user with this privilege will be able to share the structure through projects. He will be able to add it to projects he created or manages, but will not be able to add new users to the structure itself or manage structure privileges. |
The privileges that allow creation of new structures are a 3decision core functionality and can be granted and revoked by administrators only.
Every 3decision user has the same privilege set on public (RCSB PDB) or Community structures:
By default, the user who uploaded the structure in 3decision is considered as its owner. Therefore, he has all privileges on it.
He will be able to add specific users or groups and share it through projects.
It is possible to grant privileges on a structure to a user or a predefined user group.
You can also grant privileges to all members of a project.
A user can have the same privilege granted in different ways. For example, he may have been authorized to ‘manage structure files’:
If this user loses one of these grants (he is removed from the group, his personnal grant is revoked or the project-wide privilege is unset) he will still be able to manage structure files as long as at least one of them is still active.
List of Privileges
| Privilege Name | Description |
|---|---|
| delete project | If you have this privilege on a project, you will be able to delete it permanently from 3decision. |
| access project | This privilege allows a user to search for and view the project content in 3decision. |
| add and delete structures to the project | With this privilege you will be able to add/remove structures to the project. You can share public structures and private structures you are granted with the ‘share structure in projects’ privilege. |
| manage users in project | This privilege allows to add/remove other users or group of users from the project. It also allows management of other user privileges related to this project. You will be able to grant/remove only privileges you already own. |
| update project information | This privilege allows yoy to update project name or description. |
| manage project reference | With this privilege, you will be able to set/update/delete project reference. |
| manage project files | This privilege allows you to add and remove files to the project. |
| manage default privileges on project | A user with this privilege will be able to add or remove default privileges granted to all users and groups in the project. You will be able to grant/remove only privileges you already own. |
The privileges that allow creation of new projects are a 3decision core functionality and can be granted and revoked by administrators only.
The Public project contains public RCSB structures. Every 3decision user is a member of this project by default with an ‘access project’ privilege only.
The Community project allows users to share structures with every 3decision users. By default, all users can access this project, add and delete structures to it.
The creator of a project is considered as its owner and has full privileges on it. He will be able to add other users or group and grant them as he wishes.
The Personal project of a user is similar to every private project he owns except that it cannot be deleted.
When a user adds a structure to a project, if he has the privilege ‘manage users access to structure’ on the structure, he will be asked if he wants to grant all users of the project with specific privileges. All project users have at least an ‘access structure’ privilege on structures that are part of the project.
It's possible to manage project-wide structure privilege in the project panel.
It is possible to grant privileges on a project to a user or a predefined user group.
It's also possible to define a set of default privileges wich will be inherited by every project member.
A user can have the same privilege granted in different ways. For example, he may have been authorized to ‘manage project files’:
If this user loses one of these grants (he is removed from the group, his personnal grant is revoked or the default project privilege is unset) he will still be able to manage project files as long as at least one of them is still active.
List of Privileges
| Privilege Name | Description |
|---|---|
| manage user group | If you have this privilege on a project, you will be able to delete it permanently and update its name. |
| access group | This privilege allows a user to access and use this group for structures and projects sharing. |
| manage users in group | With this privilege you will be able to add/remove users from the group. It also allows management of other user privileges related to this group. You will be able to grant/remove only privileges you already own. |
The privileges that allow creation of new user groups are a 3decision core functionality and can be granted and revoked by administrators only.
A user group is a dynamic list of users who will share the common projects, structures and privileges. Once a group created, you will be able add it to projects and structures (as you can do for an individual user) and grant it privileges.
By default, every 3decision user can create user groups.
You will be considered as the owner of the groups you create and then have full privileges on it. So, you will be able to add new users to it and grant them privileges.
When you are added to a user group, you inherit all access and privileges of the group. As the group privileges evolve, your own privileges will evolve accordingly.
When you are removed from a group, you will lose all the inherited privileges except the ones you have been individualy granted or inherit from another source (other group or project).