Versions Compared

Key

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

...

(plus) add a screenshot of the navigator

Access

Any user can access and use the Asset Navigator.

The Navigator is accessible through a ‘Assets’ tab in the top navigation. After opening the tab select ‘Search for assets’.

...

First steps

The first time you open the Navigator, you’ll see several options to kick off your acquaintance with the feature:

...

(info) Users can see added projects in the Navigator as long as they have browsing permissions for the particular project.

Sidebar

Once a project is added it will appear in the sidebar.

...

⭐ Assets can also be uploaded via CSV. The import is supported via Jira’s default tool, ‘External Import System’, which is quickly accessible via a (…) menu in Assets Navigator.

...

Sub-level: Asset Filters

Asset filters allow the grouping of assets based on a JQL query against custom field values or searchable issue properties and then display such groups in the Sidebar.

The following use case provides a clear and practical explanation of the benefits of this feature.

Use case

Pre-condition: a CMDB asset template is in use.

Requirement: provide users quick access to a list of monitors that are currently under maintenance. Users should be able to get a list of assets filtered by status.

Resolution: Create an asset filter for the Application issue type. The filter link is accessible directly in the Assets Sidebar, displayed as a sub-folder of the Application listing.

Creating a filter

To create a filter, hover over the issue type and click on the revealed three dots icon:

...

Select ‘Create filter’ to open the configuration dialogue:

...

Filter Configuration

Name. This is the title displayed in the Assets Sidebar.

JQL. A JQL query.

In our example, we will filter our Applications by status; hence, the JQL query is status = 'In Maintenance'

By default, this query already automatically includes the context condition project = X and type = Y
In this use case, project = CMDB and type = Monitor.Thus, it is not necessary to include in the filter JQL.

Result

A tab with the title ‘In Maintenance’ appeared in the sidebar. The tab is positioned as a sub-level of the ‘Monitor’ issue level.

By clicking on the ‘In Maintenance’ tab, users can view all ‘Monitors’ issues that are currently under maintenance:

...

Assets List

The list of assets occupies the largest part of the Navigator page. This is the most interactive part of the Navigator, where users search, filter and edit the issues/assets.

...

Assets Navigator provides an option to quickly search through your selected levels quickly. Users can find a search bar in the top navigation panel. The search bar can be used for text search by text or by JQL queries.

By default, the search bar is set to text search. To switch to JQL, simply click on the ABC button.

...