Guide
View Qorekit as a role
Check a role before you give it to people: see the menu, lists and buttons it allows, in a read-only preview that the audit log records.
This is part of Qorekit 0.3, out now as a beta: download 0.3.0-beta.1. As with any beta, keep a backup of anything you cannot afford to lose.
Qorekit 0.3 lets an administrator see Qorekit through the eyes of a role. You can check what a new Sales role shows before anyone gets it, without making a test account or asking a colleague for screenshots.
This post shows how to start the preview, what you see during it and how it ends.
Why preview a role
A role is a set of permissions. For each entity, it says which records its holders may see, add, change, delete and export. It can also open parts of the administration.
On paper, a role is a table of choices. In practice, people experience it as a menu, lists and buttons. A preview shows the second, so you catch a missing entity or an extra delete button before it reaches anyone.
Starting the preview
- Open Administration › Roles.
- Open the role you want to check, such as Sales.
- Choose View as this role.
Qorekit now shows itself as someone with only that role would see it:
- the menu, with only the entities the role may see;
- the lists, with only the records the role may see;
- the records themselves;
- the buttons the role allows, such as adding or exporting.
An entity that the role may not see at all is missing from the menu, just as it would be for a real person with that role.
Nothing can be changed
The preview is read only. Nothing can be changed while it lasts, not even what the role would allow. You see the buttons the role allows, and none of them changes anything.
This keeps the preview safe. You can click through every list without worrying about leaving test records behind.
A strip at the top of every page reminds you that you are viewing as a role.
Their own records are yours
Many roles give access to own records only, the records the person created. A salesperson might see their own deals but all companies.
During the preview, their own records are yours. If the role may see only its own deals, you see the deals you created. If you have created few records yourself, a list may look empty because you own none of them.
Ending the preview
Choose End the preview in the strip at the top of the page. Qorekit brings you back to the role, ready for you to change what you saw.
A typical round goes like this:
- View as Sales and notice that Activities are missing from the menu.
- End the preview and give the role See: own on Activities.
- View as Sales again to confirm.
Who can do it, and the record it leaves
Only administrators can view as a role. The audit log keeps when it happened, along with the other changes in the administration.
Checking a person instead of a role
A preview shows one role on its own. People often have several roles, and get the widest access of them together. To see what a particular person’s roles add up to, open their details in Administration › Users. The post what can this user do? explains that view.
The two work well together. Use the user’s details to find which role gives too much or too little. Then view as that role to see the effect.
Read more
The roles and permissions page of the documentation covers viewing as a role and every permission a role can hold. Viewing as a role arrives with Qorekit 0.3.0.