Assessment permissions
This topic explains how to control who can view, edit, and retake assessments. It defines the roles used in assessments, describes the permission settings in templates and how they flow to assessments, includes a matrix of the actions each role can perform, and provides steps to change permissions on the assessment page.
About assessment permissions
You can protect sensitive assessments by giving specific permissions to individuals. This includes choosing whether an assessment is private or public, and assigning people to collaborate on the assessment. These permissions determine who can view, edit, or retake the assessment, and thus prevent unauthorized access.
Assessment permissions are role-based and differ from global permissions related to Assessments.
Role definitions
- Owner
-
User in the Owner field in the Properties sidebar of an assessment. Typically, the owner of an assessment is the user who created or retook the assessment.
-
Assignee
-
User in the Assignees field in the Properties sidebar of an assessment.
-
Assessments administrator
-
User who has a global role with the Assessments > Administration global permission, for example, the Assessments Admin global role.
Permission settings in a template
The template used in an assessment defines who can view, start, and retake the assessment, based on the following settings.
Who can start this
The Who can start this template setting determines who can start an assessment on an asset. This setting is available only for templates associated with an asset type. Templates that aren't associated with an asset type don't have this restriction.
By default, the Who can start this setting is empty and no role restriction applies.
If you select one or more resource roles in the Who can start this setting, the following rules apply.
| User's global permission | User has a selected resource role? | User can start the assessment? |
|---|---|---|
| Manage all resources | Yes or no | Yes |
| Assessments > Conduct Assessments | Yes | Yes |
| Assessments > Conduct Assessments | No | No |
| Neither permission | Yes or no | No |
- A user is considered to have a resource role if they hold it on an asset of the template’s asset type, either directly or through inheritance from the asset’s domain or community.
- This restriction is always enforced against the latest published version of the template, not necessarily the version an existing assessment was originally started with.
- If you retake an assessment for the same asset, this setting isn't checked again, but if you retake it for a different asset, it is.
Who can view this
The Who can view this template setting determines who can view an assessment. You can select one of the following options:
- Everyone: Anyone with access to the Assessments product can see the assessment. That is, anyone who has a global role with the Product Rights > Assessmentsglobal permission can see the assessment.
- Only owner and assignees: This is selected by default. Only the owner and assignees of the assessment can see it.
The owner of an assessment or an Assessments administrator can always change the view permissions of the assessment at the assessment level.
Retake type
The Retake type template setting determines how a retake is handled when a user retakes an assessment based on this template. You can select one of the following options:
- Out-of-the-box retake: This is selected by default. Retaking the assessment immediately creates a duplicate assessment, as described in Retake an assessment. The Who can retake this setting (specified in the following row) determines who can start the retake.
- Custom workflow: Retaking the assessment starts a Collibra workflow that you select, instead of immediately creating a duplicate assessment. It's up to the configured workflow to call the retake operation, for example, after a manual approval step. Only the workflow itself, not individual users, can complete the retake; the Who can retake this setting doesn't apply. You can also start the retake from the Lifecycle tracker.
Who can retake this
The Who can retake this template setting determines who can retake an assessment. This setting applies only when Retake type (specified in the preceding row) is set to Out-of-the-box retake. You can select one of the following options:
- Everyone with view access: This is selected by default. It refers to the option selected in the Who can view this setting (specified in the preceding row).
- Owner and assignees: Only the owner and assignees of the assessment can retake it. Here, "owner" refers to the owner of the assessment, not the owner of the asset.
- Only the owner: Only the owner of the assessment can retake it. Here, "owner" refers to the owner of the assessment, not the owner of the asset.
How permissions flow from templates
By default, assessments inherit view and retake permissions from their template. The owner of an assessment or an Assessments administrator can change the view permissions of the assessment at the assessment level.
The following table describes where you can manage specific permissions for assessments and templates.
| Permission type | Manage in template | Manage in assessment |
|---|---|---|
| View |
|
|
| Start |
|
|
| Edit |
|
|
| Retake |
|
|
Role-based permissions matrix
The following table summarizes the actions that are available to each role.
| Action | Owner | Assignee | Assessments administrator |
|---|---|---|---|
| View an assessment. |
|
|
|
| Edit answers of a draft assessment. |
|
|
|
| Edit answers of a completed, submitted, or obsolete assessment. |
|
|
|
| Edit the name of a draft assessment. |
|
|
|
| Edit the name of a completed, submitted, or obsolete assessment. |
|
|
|
| Change view permissions of any assessment. |
|
|
|
| Change assignees of any assessment. |
|
|
|
| Change the owner of any assessment. |
|
|
|
| Retake any assessment. |
|
Depends on the template setting |
|
| Complete or submit any assessment. |
|
|
|
| Download any assessment as PDF. |
|
|
|
| Mark any assessment as obsolete. |
|
|
|
| Delete any assessment. |
|
|
|
Change permissions
You can change who can see or edit an assessment, directly on the assessment page.
Prerequisites
- You have a global role with the Assessments > Conduct assessments global permission.
- You either have the Assessments Admin global role or are the owner of the assessment.
Steps
- Open the Assessments landing page..
- Click the assessment whose permissions you want to change.
- In the Properties sidebar, click the current value in each of the following sections, select the required option, and then click
.
Section Option Result Permission to View Everyone Public. Everyone can see the assessment. Permission to View Only Owner and Assignees Private. Only the owner and selected assignees (in the Assignees field) can see the assessment.
Permission to Edit Owner Owner can:
- Edit the name and answers if the assessment status is Draft.
- Change the view permission and assignee of the assessment.
- Complete or submit the assessment.
- Mark the assessment as obsolete.
- Delete the assessment.
The owner of an assessment is the user who created or retook the assessment. Only an Assessments administrator can change the owner, regardless of the assessment status.
Permission to Edit Assignees Assignees can:
- Edit answers if the assessment status is Draft.
- Complete or submit the assessment.
Your changes to permissions are saved.
What happens next
- When the view or edit permissions of a submitted assessment are updated, the change is automatically recorded as a comment on the History tab of the linked review asset, showing the new permissions.
- If notifications are enabled in the template, an email is automatically sent to someone whenever they are set as the owner or assignee of a draft assessment.