Getting started with Mapit for JIRA

This page gives you a quick tour of the necessary configuration to get started once you've installed the Mapit add-on. Please refer to the Mapit Administrator's Guide for the full documentation.
Please note that Mapit requires that your JIRA server instance and the JIRA user's browser is connected to the internet, so that the map services can be reached.

1. Set up custom fields

You need the following custom fields to store location information for issues:

1. A custom field of type Text Field (single line) to store latitude position
2. A custom field of type Text Field (single line) to store longitude position
3. A custom field of type Text Field (single line) to store address information

If you do not have appropriate fields set up already, you need to create them:

Next, associate the custom fields with the appropriate screens, so that your users can add latitude and longitude information to their issues. We recommend adding the fields to any screen used for creating, editing, or viewing an issue.

2. Associate custom fields with Mapit parameters

Go to the Mapit General configuration page, and use the select lists to set up which custom fields Mapit should use for geographic latitude position, longitude position, and address (optional).  

Decide whether users should be able to create issues from the map (we recommend enabling this setting - this makes geotagging new issues a lot easier).

3. Set a default map center

In the Map settings page, set a default map center position (latitude and longitude) for new users of the Mapit gadget. This could for instance be your company's headquarters - find the position using OpenStreetMap or other map sources. The format of the latitude and longitude coordinates must be in decimal degrees (DD), omitting the degree symbol, e.g. 68.12345 or 68,13456.

Don't worry if you can't decide on these settings now - you can always set them later.

4. Add the gadget to a dashboard

Mapit is a gadget, so it needs to be added to a dashboard before it can be used. Add the gadget to the system dashboard, a shared dashboard of your choice, or leave it to your users to add it themselves.