Introduction
When creating a new vacation request, all users can select an Approver (usually a team manager or team lead):
By default, the Teamployees plugin does NOT create any notifications about newly created vacations. All requests are displayed on the Approval List tab, where they can be “approved” or “declined” by the approver specified when creating the vacation request:
However, in the Event Notifications section of the settings, you can specify a project in which the Teamployees plugin will create special Jira issues when a vacation request requires approval.
Such an Jira issue will contain the name of the selected Approver as the Assignee, and the name of the User who created the vacation request will be indicated as the Reporter. Here is an example:
Changing the Jira issue status to "Event Approved" or "Event Declined" changes the vacation request status.
This way, the Teamployees plugin makes the vacation request approval process as native to Jira as possible. Assignee and Reporter will receive notifications about new issues, as well as changes in their status, in the usual way via email or in the Jira notification panel. In terms of functionality and capabilities, these are regular issue in a Jira project. You can even set up integration with Slack or Microsoft Teams.
Setting up Event Notifications
Here's how you can configure it so that vacation requests that require approval are created as Jira issues.
For the vacation request approval process, it is recommended to create a separate empty Jira project of the type Company-managed business. Please follow the guide below:
In the Projects menu in your Jira instance, click on the create new project button. Then, in the window that opens, in the Work management section, select the template called Blank project:
Name: Give the project a name of your choice, for example "Vacation Requests" or simply "Vacations". In our case, we will name the project "Teamployees (Vacations)" for clarity.
Project type: Click Show more to open additional settings. And in the Project type drop-down list, select the Company-managed type.
Finish by clicking the Create project button:
Additionally, you can make sure that the new project was created with the required type Company-managed business:
Go to the plugin settings section by the following path: Apps → Manage apps, and then in the left menu column go to the Teamployees Configuration section in the Event Notifications tab.
When you click on link a new window will open, then confirm the changes by clicking on the “Publish” button:
Since the newly created "new empty" Jira project does not have an issue to migrate, simply click the "Associate" button to continue:
It will take some time for the new workflow to publish, after which you will see a message indicating a successful migration:
You can now close the previous browser tab with Publish Workflows.
Go back to the Teamployees Configuration → Event Notifications tab and refresh the browser page. If all the previous steps were performed correctly, you should see a green message indicating that the configuration is complete:
When selecting a value in the "Project" field, please note that the "team-managed projects" type is not supported due to limited functionality, but you can choose any "company-managed project".
After connecting the project by clicking the "Confirm" button you will need to publish the changes made by the plugin in the workflow scheme for the correct implementation of the approval process using the provided “link”. Follow the provided link and publish changes to the workflow scheme:
To make all requests for a day off mandatory approval, choose the "Approver is required" option in the general settings of the Teamployees plugin.
