Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space MAPDOCWORK and version 2.1-server



In Mapit it is possible to define your own areas on a map. After they have been defined, these areas can be displayed in the Mapit for Jira gadget to help users see if an issue is inside or outside the defined area.

Components can also be added to an issue depending on what area it is situated in.



Enable area

To enable the ability to define areas in the map, go to Mapit General Configuration in the Jira Administrator Panel and enable the Area handling option.

 


Mapit area admin for JIRA

To draw and manage areas in the map, you need to add the gadget Mapit area admin for JIRA to a dashboard.


Access rights

Please note that to be able to define and manage areas, the user must have administrator rights for the given project.



Defining areas in Mapit

Note: Mapit areas use components as a tag for the different areas, if you do not allready have appropriate components defined, you should define some first. 

Opening the dashboard containing the  Mapit Area admin gadget, a map will be displayed. (the map has the start coodinators as defined in Map Settings) The map has a menu in the top right corner. 
Start by choosing a project to draw areas for. 
 

The first time you choose a project, you are asked to set a default area. If the default area has been defined you will not see this dialouge.  



Tip
titleNote

Note: Mapit areas use components as a tag for the different areas, if you do not allready have appropriate components defined, you should define some first. 


Load components, choose the appriate one and click "set default area". Once a default has been set, you can change it to a different component, but not remove the default area. 


After a project has been chosen, some new options will appear in the menu, and also, if  any areas have already been defined, these will show in the map. 

Image 1 above shows the options available before any areas have been defined, image 2 above shows options after at least one area have been defined.


Administrating areas

In the Mapit Area admin gadget menu, there are some options for administrating areas (some of these are only available after an area has been defined):

  • Set / change default area (always available when a project has been choosen)
    • Opens the dialouge to set default area.  The currently set default area is shown in brackets 

  • Copy area setup (only available aftear at least one area has been defined)
    • This option makes it possible to copy areas from this project to other Jira projects
    • Open the dialouge and select what projects you want to copy to. Note that only components with identical names will be copied. Also any existing areas in the project( s) copying to, will be overwritten. 
  • Update area on all issues(only available aftear at least one area has been defined)
    • This is used to update issues that are affected by newly created or changes to an existing area.  For instance; if you have expanded an area, any issues that now are within that area can be updated with the correct component. 
      If you check the box, all open issues (issue status not closed, done or rejected) within the selected project will be included.  Othervise only issues within areas that are changed or in the default area will be updated. 
      Depending on how many issues you have in your project, this update might take a while. Run this after you have done all your planned changes.  
  • Add mapping between component and custom fields (always available when a project has been choosen)
    • This is used to add or change a link (or mapping) between components and any select list custom fields that are defined for the project. 
    • Please note - this mapping is only available for custom fields of type "Select list" and the custom field must be defined in advance.