Versions Compared

Old Version 25

changes.mady.by.user Tolga Tunca (Unlicensed)

Saved on

compared with

New Version Current

changes.mady.by.user Derya Özdemir

Saved on

Key

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

The asset navigator lets you search for and manage assets in JIRA. Create, Edit, Clone Delete assets, and printing single or multiple QR + labels are supported. Asset navigator is available on the "Assets and Inventory" 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 write but it is very powerful to query assets.
Users need "Browse Assets"
Panel
panelIconIdatlassian-info
panelIcon:info:
panelIconText:info:
bgColor#F4F5F7

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:

Table of Contents
minLevel1
maxLevel6
outlinefalse
styledefault
typelist
printabletrue

Access Asset Navigator

  1. Navigate to the Assets menu.

  2. 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

It is for asset navigation and management. Detail view works for multiple asset types. And printing

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

+ labels are supported. 

codes and labels for easy asset identification.

It has navigation links to

list

related Asset

Scheme

Type Schemes (for example, Default Asset Types) or Asset Type (for example, Laptop) assets, and each asset has

asset type

Asset Type management direct links.

Image Removed

Please click on image to enlarge

Asset Navigator - List view mode

List view works for single asset type. It

Image Added

You can directly manage assets with Asset Navigator:

image-20240425-171344.pngImage Added

  • 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.

image-20240425-145036.pngImage Added

The list view supports Excel style column and row freeze for

a

better navigation

. 

Image Removed

Asset Navigator -

. This facilitates quick scanning and sorting of large asset datasets.

Image Added

3. Advanced view mode

Advanced mode lets you write "

For complex searches, Asset Navigator offers Lucene Query Language

" LQL searches for advanced filtering with OR statements.Image Removed

(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.
Apache Lucene Language Reference: https://lucene.apache.org/core/2_9_4/queryparsersyntax.html

Image Added

Example queries

Range (field name is 'Warranty Expiration Date')

warranty\ expiration\ date: [0d TO 1d]

Range OR

warranty\ expiration\ date: [0d TO 1d] OR warranty\ expiration\ date: [36d TO 37d]

Range and Exact OR

warranty\ expiration\ date: [0d TO 1d] OR warranty\ expiration\ date: 37d

Exact OR

warranty\ expiration\ date: 0d OR warranty\ expiration\ date: 37d

Field name has no space (field name is 'ends')

ends: 0d OR ends: 37d
ends: [0d TO 1d] OR ends: [36d TO 37d]

Search with Asset Navigator

Asset

navigator has multiple options to search for assets.

Image Removed

Fields for filtering:

  • Asset Type: Select Asset Types or asset type schemes (group of asset types) for filtering
    • Asset Name: Write asset name for filtering

    Navigator provides multiple search fields to find the assets you need.

    Image Added

    • 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

    use Any Field option

    , use the Any field option.

    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, to search for "text" or "test" you can use the search

    te?t

    Multiple character wildcard searches looks 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

    When we search:

    Search keywordResultte*Both 3 assetsadd asterisk at the endtest*Both 3 assetsteNothingtest
    • Alpha sever test
    • Server alpha test
    server test
    • Alpha sever test
    • Server alpha test
    "server test"
    • Alpha sever test
    Query between double quotestester
    • App tester beta
    teste*
    • App tester beta
    tes?
    • Alpha sever test
    • Server alpha test
    Only one character matches for question mark, so "tester" does not return.

    Search keyword

    keyword: te → nothing returns

    Please refer to Lucene's official document for wildcard searches.

    Exact term search

    When you surround text search terms with double quotes (i.ie "pandas and monkeys"), only exact matching results will be displayed.

    Search keywordMatching attribute value"pandas and monkeys"

    pandas and monkeys

    pandas and MONKEYS

    Exactly must be the same. But not case sensitive pandas and monkeys

    pandas

    monkeys

    pandas monkeys

    monkeys pandas

    any tokenized word will match'and monkeys'

    pandas and monkeys

    my and monkeys

    Single quote matches only portion.

    Example asset name searching:

    Image Removed

    Asset Navigator - Attribute filter options

    Asset navigator lets you filter assets by any type of attribute.

    Image Removed

    Keyboard Shortcuts 

    List Navigation

    text searches 

    Please see Wildcard search for more details.

    Examples

    Asset name search

    Image Added

    Not includes search

    You can make a "Not" search on system fields and attributes. 

    Image AddedImage Added

    Is empty search

    Is empty search brings assets that have no value for the selected system field or attribute.

    Image AddedImage Added

    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.

    Image Added

    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.

    Image RemovedImage Removed
    Image Added
    toc
    Image Added