Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Section
Column

The JIRA Suite Utilities plugin provides three additional custom fields:

  • Location Text
  • Location Select
  • Directions (since version 1.4.10)
  • Free Text Searcher

For information on custom fields in JIRA, see the JIRA documentation.

Info

As of June 22, 2016, Google Maps API no longer supports keyless access (any requet that doesn't include an API key). Please create a valid API Key and configure under Administration → Tab: Add-ons, Section JIRA Suite Utilities / Configuration.  (Since Version 1.4.12 or 1.5.2)

Column
width400px
Panel

On this page:

Table of Contents
maxLevel2
minLevel2

Location Text Custom Field

...

Description

...

Panel
bgColor#f5f5f5
titleColor#ffffff
borderWidth0
titleBGColor#000000
titleJSU for Jira Server/Data Center

This is the documentation for JSU for Jira Server/Data Center. If you are using JSU on Jira Cloud, see our JSU Cloud documentation.

Description

The Location Text custom field allows you to specify the address in free-form text when creating/editing an issue. The location will be shown as an inline Google Map in the issue.

Configuration

Configuring the Location Text custom field is

...

the same as configuring any other

...

Jira custom field. For information on how to configure a custom field in

...

Jira, see

...

Example

...

A user specifies 'Sydney, Australia' in a Location Text field when creating an issue:
Image Removed
The issue, showing the Google Map:
Image Removed
(Click thumbnails to view the full-size images)

Location Select Custom Field

...

Description

...

The 'Location Select' custom field allows users to choose a preconfigured address when creating/editing an issue. The location will be shown as an inline Google Map in the issue.

...

Configuration

...

You must configure the Location Select field options when creating the custom field. For example:
Image Removed
For information on how to configure a custom field in JIRA, see the JIRA documentation.

...

Example

...

Jira's Adding a Custom Field article.

Include Page
Google Maps API Key
Google Maps API Key


Example

A user specifies 'Sydney, Australia'

...

in a Location

...

Text field when creating an issue: 

...

Image Added
The issue, showing the Google Map:

...

Directions Custom Field

...

Description

...

The 'Directions' custom field allows users to specify an origin and destination location as text when creating/editing an issue. The directions will be shown as an inline Google Map Directions in the issue. To separate origin and destination, the separator => has to be used.

The directions from origin to destination are made in driving mode. For instance only origin and destination may be set by user input.

...

Configuration

...

Configuring the Directions custom field is no different to configuring any other JIRA custom field. For information on how to configure a custom field in JIRA, see the JIRA documentation.

...

Example

...

A user specifies 'Locarno => Lugano' in a Directions field when creating an issue, and once saved and when the issue is in view mode, Google Map Directions will be shown:

Image Removed (Click thumbnails to view the full-size images)

Free Text Searcher

...

Description

...

The Free Text Searcher allows additional search fields to be added to the standard JIRA search.

...

Configuration

...

When creating a custom field, you must specify the 'Search Template' to be 'Free Text Searcher':
Image Removed
For information on how to create a custom field in JIRA, see the JIRA documentation.

...

Example

...

A user searches for issues. The custom field will appear as a search field:
Image Removed
(Click thumbnails to view the full-size images)

 

...