After successfully adding the GeoData app to Jira, there are a few essential setup steps that need to be completed to enable the full functionality of our product. We kindly ask you to carefully follow each step on this page to ensure the full functionality of the app’s features.
| Anchor | ||||
|---|---|---|---|---|
|
...
Custom Field Configuration
The first thing you need to do before you start using GeoData app is to create a GeoData Location custom field.
...
On this page, you may adjust the context in which the Custom field will be active. For example, you can choose to show the field only for specific projects or issue types.
| Anchor | ||||
|---|---|---|---|---|
|
...
Location
On the Custom fields administration screen, you have the option to specify a default location that will be automatically populated whenever you create a new issue. This setting can be useful if you know that the majority of issues will be using a specific location. The address selection process is the same as in the rest of the app, more details can be found here.
| Anchor | ||||
|---|---|---|---|---|
|
...
Custom Field Configuration
Configuring the Route custom field with GeoData is a straightforward process, ensuring a simple setup for users.
Upon the installation of the GeoData application, the Route custom field is automatically created. To start using this field, the only essential configuration is to associate it with the appropriate screens in your desired projects. This can be easily accomplished from the Custom fields page as shown in the following images.
Firstly, navigate to the Custom fields page in Jira administration.
Next, locate the Custom fields button in the left panel.
Locate the Route custom field and from the dots menu choose Screens.
For the Route custom field, there are only two necessary options — Create Issue Screen and Edit/View Issue Screen.
Please make sure, if you have multiple projects, to choose shown screens for the right project(s).
| Anchor | ||||
|---|---|---|---|---|
|
...
Issue Type Configuration
Before you can start using Route planner, it is essential to add Route issue type to an existing project. As the Route issue type is automatically created when installing the GeoData plugin, the only settings you need to change is inside the project settings. Navigate to the desired project and select Project settings from the left panel.
Then navigate to Issue types and from the Actions selector navigate to Edit issue types.
On the Modify issue type scheme page, locate the Route issue type in the Available issue types panel and drag it over to Issue Types for Current Scheme panel.
Click Save and you should be ready to start using the GeoData Route planner.
| Anchor | ||||
|---|---|---|---|---|
|
...
Administration — Nominatim Server
Another configuration step you need to complete is to select a Nominatim server. This can only be done by a Jira administrator and is necessary to enable the geocoding and reverse geocoding features of the app.
...
Notice: Prior to utilizing this open-source alternative, we strongly recommend that you thoroughly read and adhere to their Usage policy.
| Anchor | ||||
|---|---|---|---|---|
|
...
Administration — Map Layers
This screen allows you to configure a list of tile servers for use on the GeoData map board. If no tile servers are set up, the map board will only display a low-resolution placeholder map image.
...
This is the name that will be displayed in the Layer selection widget on the map board.
| Anchor | ||||
|---|---|---|---|---|
|
...
You can see all added layers in table, where you have options to Edit and Delete individual layers. The Delete button is only available for layers which are not active.
| Anchor | ||||
|---|---|---|---|---|
|
...
Administration — Permissions
On this screen, you can manage which Jira groups are allowed to view the map board. This setting can only be changed by a Jira administrator.
