The Asset Navigator lets you search for and manage assets in JIRA. Create, Edit, Link, Clone, Delete assets, printing single or multiple QR + labels, Check-in or Check-out, and bulk operations are supported. Asset Navigator is available on the "Assets" top menu "Asset Navigator" link.
Asset Navigator Display Modes
It has 3 modes:
- Detail view: Assets for multiple asset types are displayed, show one asset's all attributes and additionally shows attachments and linked issues
- List view: Assets for single asset type are displayed in table list view (like excel). List all attributes of the asset type but attachments and linked issues are not displayed on the list - asset needs to be displayed separately.
- Advanced Search: Search with Lucene queries. It is not easy to write but it is very powerful to query assets.
| Panel | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
This page is about Assets & Inventory Plugin for Jira DC. Using Cloud? Click here. |
Asset Navigator is a powerful tool within Jira that helps you easily search for, manage, and track your assets. You can create, edit, link, clone, delete assets, print single or multiple QR labels, check in or check out, and perform bulk operations.
This guide will walk you through everything you need to know to leverage Asset Navigator effectively.
On this page:
|
|---|
Access Asset Navigator
Navigate to the Assets menu.
Click on Asset Navigator.
Users need Browse Assets asset permission to see assets on the Asset Navigator. For more information on permissions, refer to this documentation.
Asset Navigator
display modes
There are three modes:
1. Detail view mode
This provides a comprehensive overview of an asset, including attributes, attachments, and linked issues. It allows for navigation to related assets and editing directly within the view. It works for multiple Asset Types. Additionally, you can print single or multiple QR
codes and labels for easy asset identification.
It has navigation links to
related Asset Type Schemes (for example, Default Asset Types) or Asset Type (for example, Laptop) assets, and each asset has
Asset Type management direct links.
Please click on image to enlarge
Asset Navigator - List view mode
List view works for single asset type. It
You can directly manage assets with Asset Navigator:
Create: Click the Create Asset button on the top of the page to create an asset. You can change Asset Type to define different types of assets.
Edit: Click the Edit button to update the currently listed asset.
Link: Establish a connection between two assets by clicking Link. Refer to Linking assets for further details.
Clone: Create a copy of an asset using the Clone button. Attachments and issue links won't be copied.
Delete: Permanently remove an asset using Delete.
Graphical View: Click the Graphical View button to see the relations of the asset.
Assign to me: Click the Assign to me button to assign the asset to yourself. This will set the Status to In use and Assignee to the current user.
Assign to a user: Click the Assign to a user button to assign the asset to a user. This will set the Status to In use and Assignee to the selected user.
Check-in: Click the Check-in button to check in the asset. This will set the Status to In stock, Substatus to Available, and the Assignee field will be cleared.
Change History: View the history of changes made to an asset.
Edit Asset Type: Click the Edit Type button to go to the Asset Type configuration page.
Import Assets from CSV: Click the Import Assets from CSV button to go to Import Assets from CSV page. The asset type will default to the selected asset's type.
Export: Refer to the guide on exporting assets for more information.
2. List view mode
This view displays a table listing assets of a single type. It includes all asset attributes but excludes attachments and linked issues (accessible by clicking on the asset).
To access it, navigate to the top menu, and click the list icon > Switch to asset type explorer list view.
The list view supports Excel style column and row freeze for better navigation.
This facilitates quick scanning and sorting of large asset datasets.
3. Advanced view mode
For complex searches, Asset Navigator offers Lucene Query Language
(LQL) functionality. While LQL requires some technical understanding, it grants powerful filtering capabilities using OR statements. OR, AND, and TO must be upper case.
| Tip |
|---|
Refer to the Apache Lucene documentation (Apache Lucene Query Syntax: http://apache.org ) for detailed information on LQL syntax. |
Example queries | |
|---|---|
Range (field name is 'Warranty Expiration Date') |
|
Range OR |
|
Range and Exact OR |
|
Exact OR |
|
Field name has no space (field name is 'ends') |
|
Search with Asset Navigator
Asset Navigator
provides multiple
search fields to find the assets you need.
Fields for filtering:
Asset Type:
Filter by specific Asset Types or
entire Asset Type Schemes.
Asset Name:
Enter a partial or full asset name for
quick searches.
Any field: Write a text for filtering for any field including attachment names.
More fields: Add system fields or attributes for filtering.
| Tip |
|---|
For quick and easy searching |
Search for Wildcard Text Searches
Text fields allow for wildcard searches.
The single character wildcard search looks for terms that match that with the single character replaced. For example, |
te?t
Multiple character wildcard searches look for 0 or more characters. For example, to search for test, tests or tester, you can use the search:
tes*
You can also use the wildcard searches in the middle of a term.
te*t
Example
We have two assets and their names are
- Server alpha test
- Alpha server test
- App tester beta
- ab-x1
When we search:
- Alpha sever test
- Server alpha test
- Alpha sever test
- Server alpha test
- Alpha sever test
- App tester beta
- App tester beta
- Alpha sever test
- Server alpha test
- ab-x1
Please refer to Lucene's official document for wildcard searches
Escaping Special Characters for text search
Lucene supports escaping special characters that are part of the query syntax. The current list special characters are
* ? \
To escape these character use the \ before the character. For example to search for Ab*Cd\xZ use the query: ab\\cd\*xz
Exact term search
When you surround text search terms with double quotes (i.ie "pandas and monkeys"), only exact matching results will be displayed.
pandas and monkeys
pandas and MONKEYS
pandas
monkeys
pandas monkeys
monkeys pandas
Example asset name searching:
use the Any field option. |
Search for wildcard text searches
Please see Wildcard search for more details.
Examples
Asset name search
Not includes search
You can make a "Not" search on system fields and attributes.
Is empty search
Is empty search
brings assets that have no value for the selected system field or attribute.
If you combine Not includes and Is empty, it makes Not Empty search.
System Fields or Attribute filter options
Asset
Navigator lets you filter assets by
System Filters or any type of attribute.
Keyboard
shortcuts
List
navigation
Previous asset | Alt + j or Option + j |
Next asset | Alt + k or Option + k |
Previous page | Alt + g or Option + g |
Next page | Alt + h or Option + h |
Create and Edit asset
Open asset create page | Alt + a or Option + a |
Open asset edit page | Alt + u or Option + u |
Submit form | Alt + s or Option + s |
Cancel create/edit | Esc |
Attachments
Multiple files can be uploaded to an asset. Image attachments are displayed in the image gallery.
