Initial Setup [1.2.x]

After plugin is installed you have to start initialization process. You have to be logged in administrator account first and enter in "Add-ons" view.

There are two ways to do it. Either by clicking Configuration button in Manage add-ons view (note: button is localized below Vacation Manager plugin name).

Or by clicking Initialize Vacation Manager link in sidebar.

Now you should see first step view to define Vacation Manager project

There are several fields to fill:

  • Name - required field describing Vacation Manager project name

  • Key - a project key - that prefixes each issue in the project

  • Description - field describing Vacation Manager project

  • Lead - a required field defines Vacation Manager project lead, choosen user should have granted project management permissions.

After clicking on next button, group define view should appear

In this step you can define which groups of users will meet individual roles with specific permissions in Vacation Manager. In short, there are three groups:

  • Users - they can make vacation requests, and manage thier own,

  • Supervisors - they can approve users requests,

  • HR - they can manage and grant vacations for users. We do not recommend to use common jira groups like jira-users, jira-administators etc. to set as groups above.

Here you can read more about groups and permissions .

Click next, and you should see view to configure first vacation type.

In the third step you need to define a first Vacation Type.

There are several fields describing Vacation Type:

  • Name - Vacation Kind name

  • Description - Description of Vacation Kind

  • Type - there are two kinds of Vacation Types recurring and one time

    • One-time - choosing this you will have three another field to fill:

      • Has End Date - check Yes if you want to Vacation Type has specified end date, check NO if you do not want to

      • Has Suggested Days - checking Yes shows field where you can specify suggested days number granted

      • Suggested Days - specify days number granted to this Vacation Type (it can be changed later in Vacation Definition configuration)

    • Recurring - choosing this you will have fill these field:

      • Recurring period - how often Vacation has to start new period

      • Period start date - specifies when Vacation Type starts his first period

      • Next periods - shows how period will look like

      • Carryover Days - defines if unused days will be rewritten to next period

      • Suggested Days - specify default days number granted to this Vacation Type every period(it can be changed)

You can read more about Vacation Types in Vacation Type section.

Click next. Last view is summary, you can check there if parameters are correct.

Click create to create Vacation Manager configuration.


Next Vacation Manager core elements - Navigation Bar Menu [1.2.x]

Feel free to tell us what topic should be covered: vacationmanager@psc-software.atlassian.net