Why should I display OKR data in Confluence?
Widgets added to your Confluence pages will allow you to share OKR status with coworkers with whom you work within Confluence and create OKR reports on Confluence pages.
How can I display my OKR data on a Confluence page?
...
| Panel | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
This page is about OKR for Jira Cloud. Using Data Center? Click here. |
Prerequisites
You need to have a Confluence instance.
You must have permission to manage settings in your Confluence.
OKR for Jira and OKR for Confluence should be installed in your Jira instance.
...
Installation
Step 1: Download the app
...
Go to our marketplace page <add link>
Visit the OKR for Confluence marketplace page and click Get it now
...
.
Wait
...
for the app
...
installation notification.
...
Step 2: Establish a connection with your Jira instance
...
In Confluence, go to Settings
...
> OKR for Jira connection (Atlassian Marketplace section)
...
Check if the right Jira instance is prefilled on the page (the instance where you have the OKR app installed). Click on the “Link” button.
...
.
Verify the correct Jira instance and click Link.
A new tab with your Jira instance will open.
...
Approve the connection in your Jira instance.
...
A new tab with your Confluence will open. It will inform you if the connection is established correctly.
...
You can now close the tabs opened in
...
Steps 3
...
and 4.
Using
...
macros on Confluence
Macro 1: OKR Live View
This macro enables you to showcase your live OKR for Jira data on a Confluence page, making it easy to share with your colleagues and create action lists, plans, etc.
Adding the macro:
Open any Confluence page on the instance on which you’ve created the connection.
There are
...
two ways to add the OKR widget to your page:
...
Click the
...
+
...
icon in the top page menu and then
...
search for the OKR
...
live view macro.
Type in “/okr” on your Confluence page
...
and the widget should be suggested as an item to add.
...
...
After choosing the
...
OKR live view macro, a setup dialog will appear.
...
Customize the view in any way you like. Set up the columns' width order, choose which columns should be visible, and how the view should be filtered and sorted. It works in
...
the same way you’re used to in our Jira app
...
, and it will be editable after you save the macro in the edit mode.
Click Insert to add the macro to your page.
Your widget will look like this after saving the Confluence page:
The view setup will not be directly editable, but you
...
can go back to the edit mode
...
by clicking
...
the pencil icon. You can also
...
select the widget’s width in one of the
...
three options available below the widget
...
5. Your widget will look like this after saving the Confluence page
...
.
The OKR data displayed on the widget is synchronized with your data in the OKR for Jira app.
Macro 2: OKR Report
This macro enables you to display frozen OKR for Jira data from the current date and time only. The displayed data will not be updated after adding the macro to the page.
Adding the macro:
Open any Confluence page on the instance on which you’ve created the connection.
There are two ways to add the OKR widget to your page:
Click the + icon in the top page menu and then search for the OKR report macro.
Type in “/okr” on your Confluence page and the widget should be suggested as an item to add.
After choosing the OKR report macro, a setup dialog will appear.
Select a period from which you’d like to display the data. This period will not be editable after saving the widget, but the data will be filterable, so ensure that you can search for the right OKRs before saving the configuration.
You can also view the date and time for when your report is created. Currently, we only allow the generation of reports using current data.Customize the view in any way you like. Set up the columns' width order, choose which columns should be visible, and how the view should be filtered and sorted. It works in the same way you’re used to in our Jira app, and it will be editable after you save the macro in the edit mode.
Click Insert to add the macro to your page.
Your widget will look like this:
The view setup will not be directly editable, but you can go back to the edit mode by clicking the pencil icon. You can also select the widget’s width in one of the three options available below the widget.
We hope this documentation helps you effectively utilize our OKR for Confluence app to keep your team aligned and informed! For more information, please refer to our documentation or contact our support team.