Assign Licenses [Admin]
After you purchase TaskRay licenses, you will need to assign them to the designated users to give those users access to the app.
Keep in mind, if you ever need to transfer licenses between users, you can follow the same process to do so.
- From Setup, navigate to:
- Lightning: Apps | Packaging | Installed Packages.
- Classic: Build | Installed Packages.
- Click on Manage Licenses next to TaskRay.
- Click Add Users.
- Select users.
- Click Add.
TaskRay Permission Sets [Admin]
TaskRay access is managed by permission sets. After installation, it is necessary to assign permission sets to the designated users to ensure that they have the necessary level of access to the app.
Out of the box, TaskRay provides a set of pre-configured permission sets that can be assigned to users. Below you will find information about the different permission sets.
Note: While the permission sets provided by TaskRay will apply in most cases, it is possible to configure custom permission sets if needed. For this purpose, you can create either a Permission Set Group (recommended) or a Custom Permission. You can read more about custom TaskRay permission sets in this article: How do I create a custom TaskRay permission set?
Important! Keep in mind, if you create a custom permission set, you will need to modify it with every new release of TaskRay to ensure that the users with the custom permission set continue to have access to all of the necessary functionality of the app.
Standard Access
The TaskRay - Standard Access permission set ensures that the users that have it assigned get full access to all TaskRay objects and functionality. With the Standard Access permission set, users will be able to read, create, edit, and delete TaskRay records (e.g. TaskRay Project, TaskRay Task, TaskRay Checklist Item). This permission set also ensures that any updates to the app (e.g. major releases with new features, bug fixes) become available to the users automatically.
Read-Only Access
It is also possible to assign certain users the TaskRay - Read Only Access permission set. This permission set allows to see everything in TaskRay, but not edit.
Users with this permission set will be able to read TaskRay records (e.g. TaskRay Project, TaskRay Task, TaskRay Checklist Item). This permission set does not provide create, edit, or delete access to any records. This permission set also ensures that any updates to the app become available to the users automatically (read only).
Project Manager Access
The TaskRay - Project Manager Access permission set grants elevated access in TaskRay to users who need to manage templates and make administrative changes to in-flight projects. This permission set grants additional access beyond what's provided in the Standard Access permission set, but does not grant all the administrative access provided by the TaskRay - Admin Access permission set.
Use this permission set to grant access to the Template Hub (which includes the Template Builder) and the Advanced Scheduler.
The Project Manager Access permission set contains the following custom permissions:
- TaskRay Advanced Scheduler: Allows users to use the Advanced Scheduler feature (in premium edition)
Admin Access
It is possible to designate certain TaskRay users with power user access using the TaskRay - Admin Access permission set. This permission set opens up access to certain configuration settings that are specific to TaskRay.
The Admin Access permission set contains the following custom permissions:
- Define Task Weighting: Ability to define the mode for task weighting.
- Enhanced Filtering Admin: Opens up access to manage enhanced filtering, including configurations of board and project filters, as well as sharing the filters with the applicable users. Applies to Enhanced filtering.
- Share Board Filters: Ability to access Sharing Settings on Project, Task, and Board Filters to managing filter sharing with Public Groups. Only applies to Classic filtering.
- Manage Project Schedule Settings: Allows access to change project schedule org-wide default setting.
- TaskRay Advanced Scheduler: Allows users to use the Advanced Scheduler feature (in premium edition)
This permission set also grants access to the Template Hub (which includes the Template Builder).
Supplemental Permissions
In the list of TaskRay permission sets, you might also notice one or multiple permission sets named TaskRay Supplemental Permissions <month> <year> (does not apply to new installs). These permissions only apply if you have configured a custom TaskRay permission set and are not using either of the TaskRay Standard permission sets. The supplemental permission sets are created to account for any new features and/or objects that get added with TaskRay releases. You can read more about these permission sets in this article: Why do I see "additive" TaskRay Permission Sets?
If you are using any of the standard permission sets to access TaskRay, you can ignore (and delete) the supplemental permission sets.
Assign Permission Sets [Admin]
Now that you know the difference between the TaskRay permission sets, the next step is to assign them to the users as needed.
- From Setup, navigate to:
- Lightning: Users | Permission Sets.
- Classic: Administer | Manage Users | Permission Sets.
- Click on a permission set name (e.g. TaskRay - Standard Access).
- Click Manage Assignments.
- Click Add Assignments.
- Select users.
Note: If you do not see all of the users from your org, you might need to change the View selection using the dropdown. - Click Assign.
- Click Done to confirm.
Grant Access to the TaskRay Salesforce App [Admin]
The designated TaskRay users need to have access to the TaskRay App (Tab). These instructions will vary depending on the Salesforce interface that you are using: Classic or Lightning.
Lightning
- From Setup, navigate to Apps | App Manager.
- Locate the TaskRay Lightning App. Click on the Show More arrow for it and select Edit.
- Click on the Assign to User Profiles tab.
- Assign to User Profiles. From the Available Profiles list, select the Profiles that need access to the app and move them to the Selected Profiles section using the Add arrow.
- Click Save.
Classic
- From Setup, navigate to Create | Apps.
- Under Apps, click Edit next to TaskRay.
- In the Assign to Profiles section, select the Visible checkbox for all applicable profiles.
- Click Save.