Managing datasets

If you want to see and manage your datasets, or create new ones, click on the GeoData button in Jira’s top bar. Then choose the Datasets option from the dropdown menu. This will take you to the datasets page.

Managing, creating, configuring, and deleting datasets are tasks that can only be performed by Jira administrators.

Creating a new dataset

Once you are on the datasets page, you should be able to see the Create new dataset button in the top right corner. Click it to create a new dataset.

Clicking the button will take you to the Create new dataset page, which will present you with a form allowing you to set up your dataset. Some fields are common regardless of selected Data source, others are dependent on the type of data source you choose. The following sections explain the purpose of each field.

Name *

This field is for the display Name of your dataset.

Search user

This selection box enables you to select a Jira user whose permissions will be utilized for search queries performed by the dataset. This functionality is particularly useful in scenarios where you may want specific users, who do not have access permissions to certain projects or issues, to still be able to view locations and lists of issues on the Board screen. By selecting a user with appropriate permissions in this dropdown, the dataset’s issues will be accessible on the Board screen for any user authorized to view the Board.

Please note that this field is optional. If left unchanged, the search will be conducted using the permissions of the user who is currently viewing it.

Data source *

In the Data source field, you can choose to use either Issue, Route or Assets objects as the source of data for the dataset.

Issue data source

The following fields are present when you choose Issues as your data source.

JQL query string

In this field, you can enter a Jira Query Language (JQL) string to retrieve specific issues. By doing so, the datasets will be automatically updated whenever a new issue that satisfies the JQL criteria is created. This field also contains a hidden part that prevents adding issues of type Route to this dataset.

Location field *

In this field, you need to select the GeoData location custom field whose value will be used on the Map board. If you have multiple custom fields in your Jira installation, make sure you choose the correct one based on the name you selected during the set-up of the GeoData for Jira app.

Route data source

Currently, for Route dataset there is only one required setting.

JQL query string

This field lets you customize search parameters by which the route issues will be selected for this dataset. This field also contains a hidden part which makes sure to only select issues of type Route.

Asset data source

The following fields are present when you choose Asset as your data source.

AQL query string

Similar to JQL query string, this field is used to query objects from an Assets database based on the provided Assets query.

Latitude attribute *

In this field, you need to provide an Asset attribute field name which represents the latitude of the object.

Longitude attribute *

In this field, you need to provide an Asset attribute field name which represents the longitude of the object.

Address display name attribute

This field is intended for human-readable address of an asset.

Filters

In the Filters section, you can select the criteria by which the users will be able to filter the data in a given dataset.

Marker type

For a better representation of your issues, you may choose a different marker type. To learn more about markers, please check the markers page.

Card layout

The card layout option lets you customize the information displayed in pop-up cards on the map board.

Fields marked with * are required and must be filled in order to successfully create the dataset.

Once you are satisfied with the set-up of your new dataset, press the Save button.

After you’ve saved your new dataset, you can see it listed on the left side of the datasets page.

Clicking the name of your dataset will display information about it.

Editing and deleting datasets

If you wish to delete your dataset, choose it from the Datasets panel. Once you see the information about the selected dataset, click the Delete button in the upper right corner and confirm your request in the dialog that appears.

If you want to edit the dataset, click on the Edit button in the upper right corner.

You have created a new dataset, great job! Now continue and see your dataset on the map!