Versions Compared

Old Version 14

changes.mady.by.user Dominik M.

Saved on

compared with

New Version Current

changes.mady.by.user Łukasz Modzelewski

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Upgrading from versions older than 1.2.0

...

(info) Before being able to do the below steps, one you needs to install version 1.3.x of the add-on, then please access Vacation Manager Configuration , by following access steps 1 and 2 from the below image:Image Removed(available in add-ons section).

Image Added


For the rest of the steps presented below (1 - 5), please uncloak needed one (note that they were put in an order that you should follow accordingly and do not omit any of it):

  1. Migrate field "Details" to "Description"

    Expand
    titledetails
    1. In Vacation Manager configuration panel scroll down to the section named Other  and click Migrate (Migrate descriptions) button
    2. On the next screen you can choose if you want to overwrite data in description field if it is not empty

    3. Click Migrate to complete migration process

    Note: Migration process will modify description fields only in issues in Vacation Manager project.


  2. Add field "Description" to "VACMAN Field Configuration".

    Expand
    titledetails
    1. Click Issues in JIRA administration section
    2. Go to Field configurations
    3. Find field configuration used by Vacation Manager (by default it is VACMAN Field Configuration) and Configure it
    4. Search for Description field and click on its Screens operation
    5. Check Create/Edit/View screens used by Vacation Manager (by default: VACMAN Screen Create, VACMAN Screen Edit, VACMAN Screen View)
    6. Click Update to save changes

    Remove fields "Details" and "Supervisor" from "VACMAN Field Configuration".

    Expand
    titledetails
    1. Search for Details field on VACMAN Field Configuration and click on its Screens operation
    2. Uncheck Create/Edit screens used by Vacation Manager (by default: VACMAN Screen Create, VACMAN Screen Edit). You can also uncheck View screen if you made migrations from 1st step.
    3. Click Update to save changes
    4. Search for Supervisor field on VACMAN Field Configuration and click on its Screens operation
    5. Uncheck Create/Edit/View screens used by Vacation Manager (by default: VACMAN Screen Create, VACMAN Screen Edit) + view
    6. Click Update to save changes
    7. For supervisor field, set is as "Optional"

    Note: from version 1.3.0 Vacation Manager uses Description field instead of custom field Details to store additional data from user.


  3. Add new custom field "Supervisor" of type "Team User Picker (Vacation Manager)"  to "VACMAN Field Configuration". 

    Expand
    titledetails
    1. Click Issues in JIRA administration section
    2. Go to Custom fields
    3. Click Add Custom Field
    4. Select Advanced tab and choose Team User Picker (Vacation Manager)
    5. Click Next, enter name Supervisor (you can add some description for a reference) and accept using Create button
    6. On next screen check Create/Edit/View screens used by Vacation Manager (by default: VACMAN Screen Create, VACMAN Screen Edit, VACMAN Screen View)
    7. Click Update to save changes
    8. Navigate back to Field Configurations, click Configure and make this new supervisor field a required one.
    (warning) Please do not delete the old "Supervisor" custom field yet.
    1. (for Vacation Manager project)
    2. Make supervisor field created in step "e" a required field
    3. Switch old supervisor field to optional (we will remove this field later)
      Image Added


  4. Update configuration with created "Supervisor" field.

    Expand
    titledetails
    1. In Vacation Manager configuration click Edit fields

    2. Select newly created Supervisor field (usually newly created Supervisor field has higher ID number)
    3. Select YES in Migrate data option
    4. Click Save button to save configuration and move data in Vacation Documents from old to new Supervisor field


  5. Delete or Remove fields "Details" and "Supervisor".

    Expand
    titledetails

    If you have successfully migrated data you can delete fields Supervisor and Details

    1. Now you can delete old Supervisor and Details fields (as those are no longer used). Navigate to Custom fields and delete Supervisor and Details fields (those without any screens assigned).
    2. Some cosmetics: Navigate to Issues → Screens → find VACMAN Screen Create and click on configure - to change the order of the fields (by default fields are ordered by ID's), move Supervisor field up to its default place, just above Security Level below Security Level 
    3. Do the same actions for View and Edit screens

    If for some reasons you would like to keep fields Supervisor and Details, you can remove them from Vacation Manager screens without deleting those fields.

    1. Search for Details field on VACMAN Field Configuration and click on its Screens operation
    2. Uncheck Create/Edit screens used by Vacation Manager (by default: VACMAN Screen Create, VACMAN Screen Edit). You can also uncheck View screen if you made migrations from 1st step.
    3. Click Update to save changes
    4. Search for Supervisor field on VACMAN Field Configuration and click on its Screens operation
    5. Uncheck Create/Edit/View screens used by Vacation Manager (by default: VACMAN Screen Create, VACMAN Screen Edit) + view
    6. Click Update to save changes

    Note: from version 1.3.0 Vacation Manager uses Description field instead of custom field Details to store additional data from user.


After completing these steps, Vacation Manager for JIRA will be fully upgraded and ready to use with new features.

...