Important Update Effective February 1, 2024!
Due to recent changes in Jira and Confluence, we've made the tough decision to discontinue the OpenID Connect (OIDC)/OAuth app and no longer provide new versions for the newest Jira/Confluence releases as of January 31, 2024.
This is due to some necessary components no longer shipping with Jira/Confluence, which would require some extensive rewrites of the OIDC App.
Admin Walkthrough
1. Launch the Out-Of-Office User Administration
From the main menu select Jira Settings / Apps. Then click on User Administration in the Out-Of-Office Assistant section.
2. Type a name or select a project
All relevant users will be displayed. In the Actions column, you can add rules on behalf of users ().
Or, if there are already rules defined, edit, delete or just list them ().
The forms you will see are the same as for the user.
3. Reassignments Analytics
When an issue of a user is reassigned by the Out-Of-Office Assistant, you get a lozenge message in the Analytics column.
If you click on it, you see which issue, when and to whom it was reassigned.
It will also show errors when reassigns didn't work, e g. if the assignee is also out of office and has no coverer.
5. Add out of office tags to mentions:
Every user can choose if and how such a tag will be added, when he or she is mentioned. As admin you can choose the default that is used for new rules.
You have three options:
- Don't add an ooo tag to mentions in comments
- Add an ooo tag to mentions when out of office
- Add it already days before out of office
And some options for before the time tag:
6. Enabling the Rest API
6.1 Rest API documentation
The complete description of the Rest API for the Out of Office Assistant you find on the Swagger website: Out of Office Assistant Rest API | resolution-cloud | SwaggerHub.
6.2 Authorization by User
Out of Office Assistant Rest API Tokens
Rest API Tokens made for the Out of Office Assistant only affect reading, creating, updating and deleting OoO rules. They can't be used for anything else in your Jira Cloud instance.
There are two options how to handle Rest API tokens. Either you can ...
A) Enable all users for creating their own Rest API tokens, by checking "Allow users to create there own Rest API tokens", the users will only be able to create tokens for their own rules, or
B) ... by creating them for them:
6.3 Authorization by Admin
To create tokens you can go to the Out-Of-Office User Administration tab "Rest API Tokens". There you find a list with all created tokens.
Hit "Create New Token" button. Select a user and a scope.
A token is always issued for one specific user. As scopes you can choose between "READ / WRITE & DELETE" and "ADMIN". "READ / WRITE & DELETE" enables read, write and delete actions the rules of one specific user. "ADMIN" allows to do the same, but for all users of the instance.
Hit "Create Token".
Now you can either copy the token and send it to the user in some secure way, or send the user a link where he can obtain his token.
I he follows the link he gets to his out of office rule list, with a button get the token.
6.4 Accessing the Rest API
On our Swagger page you can learn about all features and try them ...
Out of Office Assistant Rest API | resolution-cloud | SwaggerHub
7. Further reading: User Guide
Everything else is identical to how the normal user sees it.
1. Launch the Out-Of-Office User Administration
From the main menu select Jira Settings / Apps. Then click on User Administration in the Out-Of-Office Assistant section.
2. Type a name or select a project
All relevant users will be displayed. In the Actions column, you can add rules on behalf of users ().
Or, if there are already rules defined, edit, delete or just list them ().
The forms you will see are the same as for the user.
3. Reassignments Analytics
When an issue of a user is reassigned by the Out-Of-Office Assistant, you get a lozenge message in the Analytics column.
If you click on it, you see which issue, when and to whom it was reassigned.
It will also show errors when reassigns didn't work, e g. if the assignee is also out of office and has no coverer.
5. Add out of office tags to mentions:
Every user can choose if and how such a tag will be added, when he or she is mentioned. As admin you can choose the default that is used for new rules.
You have three options:
- Don't add an ooo tag to mentions in comments
- Add an ooo tag to mentions when out of office
- Add it already days before out of office
And some options for before the time tag:
6. Enabling the Rest API
6.1 Rest API documentation
The complete description of the Rest API for the Out of Office Assistant you find on the Swagger website: Out of Office Assistant Rest API | resolution-cloud | SwaggerHub.
6.2 Authorization by User
Out of Office Assistant Rest API Tokens
Rest API Tokens made for the Out of Office Assistant only affect reading, creating, updating and deleting OoO rules. They can't be used for anything else in your Jira Cloud instance.
There are two options how to handle Rest API tokens. Either you can ...
A) Enable all users for creating their own Rest API tokens, by checking "Allow users to create there own Rest API tokens", the users will only be able to create tokens for their own rules, or
B) ... by creating them for them:
6.3 Authorization by Admin
To create tokens you can go to the Out-Of-Office User Administration tab "Rest API Tokens". There you find a list with all created tokens.
Hit "Create New Token" button. Select a user and a scope.
A token is always issued for one specific user. As scopes you can choose between "READ / WRITE & DELETE" and "ADMIN". "READ / WRITE & DELETE" enables read, write and delete actions the rules of one specific user. "ADMIN" allows to do the same, but for all users of the instance.
Hit "Create Token".
Now you can either copy the token and send it to the user in some secure way, or send the user a link where he can obtain his token.
I he follows the link he gets to his out of office rule list, with a button get the token.
6.4 Accessing the Rest API
On our Swagger page you can learn about all features and try them ...
Out of Office Assistant Rest API | resolution-cloud | SwaggerHub
7. Further reading: User Guide
Everything else is identical to how the normal user sees it.