Zurück 8. Bereiche und Arbeitsgruppen -- Nach Oben Inhaltsverzeichnis -- Weiter 10. Systemkonfiguration
9. User Roles
User Roles are the mechanism used to control a user’s access to the transactions and data stored in the DrawMGT system.
In order to view, enter and update data a user must have the appropriate roles. A user role gives a user the permission to run transactions, e.g. commands initiated by the system menus and screen buttons, on system data, e.g. data stored in folders (Bereiche) and groups (Gruppe). In other words, user roles define permissions, linking users, transactions and system data.
Users typically have multiple user roles, which reflect their actual responsibilities on a project. For example, a user may have view roles for some folders and groups, where they merely need access to documents for information purposes, and new/update roles, for areas of the project where they produce documents.
In a large project with many users and folders, the number of user roles can get quite large and their management can be a challenge. In many projects, it is critical to ensure that certain documents are protected and are available only to a restricted set of users. DrawMGT provides a convenient reporting mechanism that lets you verify who has access to transactions and system data based on the project area, e.g. folders and groups.
User Role Levels
User roles can be assigned at the system, folder or group level. If a role is assigned at the:
system level – then permissions granted for all system data, including all folders and groups
folder level – then permissions are granted for all data in the folder, including all the groups belonging to the folder
group level – then permissions are granted for all data in the group
In all cases, permissions are granted based on the folder/group of the user roles and the folder/group of the data, taking into account user roles at the system and folder level. The algorithm for determining if permission is granted to access data is:
- Determine the role required for the transaction about to be performed
Check if the user has the system-level access for the role
if yes, grant permission
if no, continue with the next check
Check if the user has the folder-level access for the role for the folder associated with the data
if yes, grant permission
if no, continue with the next check
Check if the user has the group-level access for the roles for the folder and group associated with the data
if yes, grant permission
if no, continue with the next check
- Deny permission
User Role Classes
User role types are divided into classes. The user roles for each class are listed and defined in the following sections.
Administration Roles
Site Administrator – grants permissions for performing all system transactions
The Site Administrator user role is assigned to the users that manage the system users and user roles. The following transactions are unique to the Site Administrator role:
User create/update
User role update
User role list
User set password – for other users. Note that users are able to reset their own passwords
Document/Revision Management and Viewing Roles
Document Creator/Updater – Includes the Document View user role permissions, plus:
- Creating, updating and deleting documents/revisions
- Performing revision workflow steps, via the revision detail screen and the document basket
Document Viewer – Typically granted to users that need only read-only access to documents and revisions. Permissions for:
- Searching for documents/revisions and creating document/revision lists
- Viewing detail screens for documents and revisions
- Downloading source and publish files
- Listing submittals, and viewing the list of recent submittals
- Viewing submittal detail screens
- Downloading submittal ZIP files
Document Restricted Viewer – Typically assigned to users that are only allowed to view documents and revisions that have been issued (e.g. where the workflow is completed). The permissions are the same as for the Document View role, with the following difference:
- Downloading publish files only – a restricted viewer does not see that source files exist
- Access is restricted to revisions where the workflow is complete, and depending on the system configuration, superseded revisions. The default is that are unable to view superseded revisions.
Note that placing a revision in a submittal automatically makes it accessible to users with the Document Restricted Viewer user role, once the submittal has been transmitted.
Warning: For security reasons, the Document Restricted Viewer role takes precedence over the other document/revision user roles. This means that if a Document Restricted Viewer role is assigned to a user with the Document Creator/Updater or the Site Administrator user role, then that user will no longer have permissions to create and update documents and revisions.
Document/Revision Workflow Roles
The document/revision workflow roles are all associated with performing workflow steps for revisions. The workflow for a revision is a sequence of workflow steps, which must be completed in order. The sequence of workflow steps is:
Draft – The draft workflow step only records who drafted the drawing, or typed-in the document. There is no status, plan or complete date recorded for the draft workflow step.
Design and/or Receive
Check
Approval – Multiple approval workflow steps can be completed in parallel. Approval workflow steps are typically used for cross-interface approvals.
Release – Release workflow steps can overrule open and rejected approval workflow steps
Submit
All the workflow steps, with the exception of the submit workflow step, are performed in the revision detail screen. A workflow step role includes the ability to complete and also to update the step, provided that no subsequent workflow steps have been completed.
The roles differ only in the workflow step that can be performed:
Document Drafter – Permission to perform the drafter workflow step
Document Creator (Designer) – Perform the design workflow step
Document Receiver – Perform the design workflow step
Document Checker – Perform the check workflow step
Document Approver – Perform the approve workflow step. This applies to all workflow steps.
Document Releaser – Perform the release workflow step. The user completing the release workflow
Document Submitter – Perform the submit workflow step, e.g. transmit a submittal. Unlike other workflow steps, the submit workflow step is not performed from the revision detail screen. Submittals are transmitted from the submittal detail screen. See section X: Managing Submittals for a complete description of how to create and transmit submittals.
To complete a workflow step, following data must be entered:
Plan Date – Optional. The plan date if for informational purposes only. Only users with the Document Creator/Updater role user can change the plan date.
Complete Date – Required, if the step does not have status Not Required.
Who (the person responsible for the step) – Required. This field is normally pre-assigned and cannot be changed, unless the user also has the Document Creator/Updater role.
Status – Required for design, check, approve and release workflow steps. The following status values are allowed:
Open – The workflow step has not been completed
Not Required – The workflow step is not required. Only applies to approve workflow steps.
Approved – The revision is approved, and other subsequent workflow steps can be performed.
Approved with Comments – The revision is approved, a comment associated with the approval has been entered and other subsequent workflow steps can be performed.
Rejected with Comments – The revision is rejected, a comment associated with the rejection has been entered and other subsequent workflow steps cannot be performed.
Comment – Required when the status is Approved with Comments or Rejected with Comments.
Task Management and Viewing Roles
Task Creator/Updater – Includes the Task View user role permissions, plus:
- Creating and updating tasks and task notes
- Uploading task note attachment files
Task Viewer – Typically assigned to users who only need read-only access to tasks. Permissions for:
- Searching for tasks and creating task lists, all types of task are included
- Viewing task detail screens, including the task notes, all types of task notes are included
- Downloading task note attachment files
Task Restricted Viewer – Typically assigned to users who only need read-only access to a restricted set of task types and task note types. The permissions are the same as for the Document View role, with the following difference:
- Searching for tasks and creating task lists – restricted to limited set of task types
- Viewing task detail screens, including the task notes – restricted to limited set of task types and task note types, defined in the system configuration:
Warning: For security reasons, the Task Restricted Viewer role takes precedence over the other task user roles. This means that if a Task Restricted Viewer role is assigned to a user with the Task Creator/Updater role, then that user will no longer have the permissions to create and update tasks.
Security Exception tasks can be used to make it possible for users to view revisions that their user roles do not normally allow them to view. See section X: Security Exception Tasks.
Task Subscriber Roles
Task Subscriber user roles, do not actually define permissions to access and update data, but rather define the default list of users added to a task when it is first created. The list of Task Subscriber user roles is based on the list of task types, with an addition of a Task Subscriber All role. The list of task types depends on the system configuration and is typically different for each project.
Task Subscriber All
Task Subscriber Task Type X
Task Subscriber Task Type Y
…
See section X: Task Management for description of how task subscription works and the conditions under which emails are sent to task subscribers.
Submittal Management Role
Submittal/Transmittal Creator/Updater – Permissions for:
- Creating and updating submittals
- Listing submittals, and viewing the list of recent submittals
- Viewing submittal detail screens
- Downloading submittal ZIP files
Note that the Submittal/Transmittal Creator/Updater user role does not allow a user to transmit a submittal. The permission is granted with the Document Submitter user role, described above.
Submittal Recipient Roles
Submittal Recipient user roles, do not actually define permissions to access and update data, but rather define the recipients for submittals. There are three types of submittal recipients:
Submittal Primary Recipient (‘To’ recipient)
Submittal Copy Recipient (‘CC’ recipient)
Submittal Blind Copy Recipient (‘BCC’ recipient)
See section X: Managing Submittals for a complete description of how to create and transmit submittals.
User Management
Image: User list including a normal user, test user, disabled user, user with disabled login
Image: User detail screen
Add the following points:
Test User – Intended for testing document and task access permissions. Defines a test user with the following properties:
- Allowed to login, provided the user and login is enabled (see below)
- Not included in user menus
- Not sent any system generated emails
- Displayed in yellow in user lists and user detail screens
* User enabled (Benutzer freigegeben) – The user is enabled, meaning that the user appears in all user menus and system generated emails will be sent to the user. Users should be disabled when they are no longer associated with the project. Disabled users are:
- Not allowed to login
- Not included in user menus
- Not sent any system generated emails
- Displayed in dark gray in user lists and user detail screens
Login enabled (Login freigegeben) – The user’s login is enabled. Provided the user is enabled (see above), and a login name and password have been assign, the user will be able to log into the system. Users with a disabled login are:
- Not allowed to login
- Displayed in light gray in user lists and user detail screens
User enabled (Benutzer freigegeben) – The user is enabled, meaning that the user appears in all user menus and system generated emails will be sent to the user. Users should be disabled when they are no longer associated with the project. Disabled users are:
- Not allowed to login
- Not included in user menus
- Not sent any system generated emails
- Displayed in dark gray in user lists and user detail screens
Login enabled (Login freigegeben) – The user’s login is enabled. Provided the user is enabled (see above), and a login name and password have been assign, the user will be able to log into the system. Users with a disabled login are:
- Not allowed to login
- Displayed in light gray in user lists and user detail screens
User Role Management
Creating User Role Reports
Users with the Site Administrator user role can create user role reports, which are tables of user roles. An example is show below:
Image: Example: part of user role list
The user role report lists users, by folder, group and company in the vertically and user roles horizontally. In the main part of the table an ‘X’ is displayed if the role has been assigned for the given user and role. If you place your mouse over the ‘X’, floating text appears, indicating the user, company and user role.
Image: Example: small part of user role list – showing hover text
It is also possible to expand and collapse each folder’s section.
Image: Example: small part of user role list – expand/collapse check boxes
As the number of user roles can be overwhelming, it is possible to display subsets of the user roles based on selections from the following categories:
Folders
Companies
Users
The user role search screen allows you to make a selection of one, multiple or all items in each category.
Image: Example: user role search screen
Downloading User Role Metadata
To be completed
Updating User Roles
To be competed – or reference to existing documentation