(v1) Area Admin

Say you plan work with Jira, and your work issues can be located across a vast geographical area, like a region, a county, or even different city suburbs. 

You do not want to manually spend time locating what area each of your issues are in, because lets face it, unecssesary manual activity is to be avoided if possible. 

In Mapit you can define your own areas on a map, and use them to add information when creating issues and help users see if an issue is inside or outside the defined area.

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.

Permissions 

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

Defining areas in Mapit

Note: Mapit areas use components as a tag for the different areas, if you do not already 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.  

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.

Loading the project causes the buttons to become active.

• Create a rectangular area
  • Press the  button and then click and drag to draw a rectangle to define the area of interest to you.
  • 
  • In the popup, select the appropriate component and then press the Next button
• Create a polygon area:
  • Press the  button and then use the mouse to determine the next points of the area you are interested in. 

  • By selecting the starting point again - you will close the area and finish drawing.

  • 
  • In the popup, select the appropriate component and then press the Next button
• Editing an existing area
  • Press the button, make changes to the area then press the Save changes button
  •  
  • 

  • In the received dialog box, choose whether you want

    • Update all issues (See point Update area on all issues in the Administrating areas section)
    • Only save the areas

• Delete existing areas
  • Press the button and click on the area you want to delete then press the Save changes button
  • 
  • 

  • In the received dialog box, choose whether you want

    • Update all issues (See point Update area on all issues in the Administrating areas section)
    • Only save the areas

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.