Roles
Roles are used to define the default parameters for each user assigned to that role, such as the default user views and permissions, the activities they are permitted to record, and more. Some of these parameters can be adjusted on a per-user basis; it's not necessary nor recommended to create new roles for small individual changes.
Accessing the setup page
Like many of the different PTS utilities, setup is found in the left-hand side bar.
Hover over the sidebar with the mouse cursor and the side bar will expand. Select Setup to reveal a drop-down list of the various setup pages you have permission to access.
To choose a setup page click on its name in the list to be taken to the setup page.
PTS 5 is the most user configurable version of our Prescription Tracking System to date. As a result parts of this Wiki assumes that the reader has permission to access the elements of the system in question. If you don't see specific items and utilities where they are supposed to be you may not have permission to access them.
Adding new roles
PTS is shipped with a number of popular roles pre-configured, such as Pharmacist, Porter, Ward Staff and more. If you need to create a new role access the actions menu by clicking on the actions menu icon at the top right of the page, then from the actions menu click the New Role button.
To speed up the Role creation process you can create the role based upon an existing role. Select the closest Role to the one to be created by selecting it from the list; you can make changes to it next.
Click OK when you're done. The process then continues in the role popup.
Editing existing roles
To edit an existing role, select the role you wish to amend by clicking on its entry in the list to load the role popup (note clicking the tickbox has another dedicated function).
Role popup
The role popup appears after adding a new role, or clicking on a role in the list to edit it.
Enter the following information and click the Save button to finish creating or editing the role. Some fields may be optional.
Role details tab
- Description
This is a free format field that is used to describe the Role.
Activities tab
Here it is possible to limit which roles are permitted to perform certain dispensing activities. Activities in red are disabled, activities in green are enabled, and activities in amber are inferred to be enabled. This is because they have not been specifically added to any other role, and are therefore by default considered to be available to any and all roles. Once an activity permission is added to at least one role, it is considered to be unavailable to other roles (n.b. it shows up in red) unless also specifically added to them.
If this process is hard to follow consider making your changes to activity permissions in the Activities setup page, where the flow is reversed and arguably makes more sense.
You can hover over the activity to read a explanation of its current status within the current role.
To add a new activity to the list of permitted activities, click on the Plus button, and then select the activity from the list. This will add the activity in green. Click the Save button to save your changes.
Note permissions tab
Every note added to PTS will be listed here next to a dropdown where you can set the access that this role has to it.
- Hidden
Users of this role will not see this note anywhere, even when viewing a prescription that contains it. This is useful for hiding potentially sensitive note types. - View
The note will be visible when recorded, but the user will not be able to record the note themselves. - Create
User will be able to see and record this note themselves, assuming the user has permission to create notes in general i.e. CREATENOTES = Yes. This setting will not override CREATENOTES = No.
Type permissions tab
Every prescription type added to PTS will be listed here next to a dropdown where you can set the access that this role has to it.
- Hidden
Users of this role will not see prescriptions of this type anywhere, even when viewing a home page view that contains one. - View
The prescription type will be visible to the user, but the user will not be able to book in a prescription of this type themselves. - Create
User will be able to see and book in prescriptions of this type, assuming the user has permission to book in in general i.e. BOOKIN = Yes. This granular control has proved useful in allowing ward users to book in prescriptions of specific types only, such as an Order for Controlled Drugs. This setting will not override BOOKIN = No.
User views tab
You can add or remove user views from individual roles here.
User views are created and configured by system administrators in the user views setup page.
Permissions tab
This section allows the default general permissions for users of this role to be configured.
Applying changes to existing users
Upon saving changes to a role PTS will ask if you want to apply those changes to all existing users who are assigned that role. Choose Yes or No from the dialog box. This can save a lot of time when you make broad changes to user view configurations, for example.
You can also perform this task at any time via the Actions menu.
Be advised that this process can take some time to complete if there are a large number of affected users. Please be patient and avoid closing down PTS until you see the confirmation message.
There are two types of action that can be performed from the roles setup page: actions for selected roles and actions for the logged on user.
The actions menu can be accessed using the actions menu button at the top right of the screen 
. If roles are selected the menu slides out automatically.
User Actions
New Role
Start adding a new role as discussed above.
Edit Active Directory Group Mapping
When Active Directory integration is enabled it works by mapping Active Directory "groups" to PTS user roles.
When someone accesses PTS in their web browser the system will try to log them in automatically based on their Active Directory user account. Active Directory groups are mapped to PTS user roles using the role mappings defined here.
- Priority
As users can be assigned to multiple AD groups, you can assign a mapping priority to determine which role they will be given if they match two groups. A lower number (e.g. "1") is a higher priority. - AD Group (Principle Name)
Free type the name of the group as it appears in Active Directory. - PTS Role
Select the PTS Role that the AD group should relate to. - Wards / Dispensaries available
If and when a PTS user account is being created or amended based on Active Directory, you can specify how users of this group/role should have wards or dispensaries assigned. See the Users setup guide for more. - Default Ward / Dispensary
Set which of the assigned wards or dispensaries will be the user's default. See the Users setup guide for more.
See the Active Directory page for technical setup and for details on the logic that is applied when an Active Directory user is logged in.
Actions for selected roles
Reset selected roles
Allows you to reset the user views and permissions of a role based on another existing role.
Re-apply selected roles to users
Choose this option to manually re-apply the role's user views and permissions to specific users. This is a good way of rolling back any manual changes to the user's views and permissions and reverting them to the current role defaults.