There are two types of visibility settings you can leverage. One is a project-based setting that will allow or not allow the app on projects you specify, and the other one is the View OKRs permission that will manage the access of users/user groups to the app and can also be configured globally or per project.
Choosing how to leverage the two visibility settings depends on your preferred Jira management approach. For large companies with thousands of projects, we recommend using both.
To have access to the plugin, a user must be looking at a project that is not excluded from the project setting (or is included) and the user must also have the View OKRs permission.
If the app is enabled for a specific project, but the user doesn't have the View OKRs permission, they won't see the app. Likewise, if the app is not enabled for a specific project, but the user has the View OKRs permission, they won't see the app.
Project-based setting
When configuring the app, you'll see a row called 'Projects'.
You can use the option to either include or exclude the app only in or from specific projects. To allow the app for all projects, choose 'exclude from' and leave the project selection blank.
Global View OKRs user permission
Installing the Quantive Results Jira Server app automatically creates a new Jira permission called View OKRs.
As a result, all users who are granted this permission have access to OKRs from Quantive Results linked to a given issue in Jira.
You can check the permissions of your Jira account by:
Navigating to Jira Settings > System > Global permissions.
View the View OKRs section
Pro-tip:
You can find more information about global permissions and how to manage them here.
By default, in the Jira Server app, you don't have any Jira groups granted with View OKRs permission. To grant the Jira group this permission, just follow these steps:
Go to Grant permission
Select View OKRs from the Grant drop-down menu
From the Group drop-down menu, choose who you want to have access to your linked OKRs.
Pro-tip:
Read more about Jira groups here.
In addition, please note that by granting a group of users a global View OKRs permission, they have access to all OKRs in all the available Jira projects in their accounts.
View OKRs user permission on a project level
You can also grant View OKRs permission on a project level. By doing so, the users granted this permission have access only to the linked OKRs in the selected Jira project.
To do so:
Select the Projects drop-down menu
Choose Jira project
Go to Project Settings
Choose Permissions
Pick Edit permissions from the Action drop-down menu
Scroll down to View OKRs permissions
Click Edit
Choose which group you want to grant permissions to.
Notice that on the project level you can grant View OKRs permission not only to a group of users but also to a project role and to users with specific application access.
Also, it's worth mentioning that if you granted global View OKRs permission to a group of users, you don't have to grant the same group with project-level View OKRs permission because the group already has access to all linked OKRs across the JIRA instance.
Here is the entire process of creating a new group with users and granting the group global View OKRs permission: