Skip to main content
Skip table of contents

Use an Elements Connect field in search



Elements Connect fields and searches

Jira offers two search modes:

  • Basic search, where users use a straightforward user interface to add conditions on fields - limited options, but can be used by any user
  • Advanced search, where you can build a more advanced query using the Jira Query Language (JQL) - more powerful than the basic search but offers more opportunities

If you are not familiar with Issue search, you should have a look at the official documentation.

Let's see how we can search on Elements Connect fields based on their type.

If you're a Jira admin, you might want to know how to configure an Elements Connect field search query & display



JQL terminology

Before diving into the subject, we want to clarify the terminology used in this page.

A condition in a JQL search can be broken down into three elements:

<operand 1> <operator> <operand 2> 

  • operand 1 - left operator of the JQL search - an Elements Connect field
  • operator - the operator to apply in the search
  • operand 2 - the right part of the JQL condition (optional in some cases)



Live Text & Live User

Basic search

To search on a Live text or a Live user field in basic mode, you'll have to select the expected options with an autocomplete field:





You can select as many options as you'd like, Jira will return all issues where the Connect field is equal to at least one of the option selected.

Regarding multi values Connect fields, they'll match the search if they contains at least one of the option selected in the search bar.

Advanced search

Live text fields behave in a similar way to Select lists or Checkboxes Jira fields.

Operators

Operators available by default on Live Text fields:

Operator

Operand 2

Comment

=A valid Elements Connect field valueElements Connect field value is strictly equals to "Operand 2"
!= A valid Elements Connect field value

Elements Connect field value is

  • not empty
  • different from "Operand 2"
inA list of valid Elements Connect field valuesElements Connect field value is equal to one of the values listed in "Operand 2"
not inA list of valid Elements Connect field values

Elements Connect field value is

  • not empty
  • is not equal to any of the values listed in "Operand 2"
is empty<none>

Elements Connect field:

  • is currently empty
  • previously had a value
is not empty<none>

Elements Connect field is set


Operators deactivated by default on Live text field (discover how they can be activated):

Operator

Operand 2

Comment

~A string value (free text)

Elements Connect field display contains the value of "Operand 2" (search is not case sensitive):

i.e.: if the field display is "Hello world" it will match "hello", "world"

!~A string value (free text)

Elements Connect field:

  • is not empty
  • its display does not contain the value of "Operand 2"

When searching on an Elements Connect field, a list of options is prompted to the user, formatted like this: <TEMPLATE> [<KEY>].

They shall not be used when the ~ or !~ are used




Snapshot Text

You can search on Snapshot text fields the same way you do it on Standard Jira text fields.

Available operators are:

  • ~ and !~
  • is empty and is not empty

If you'd like to learn more, please read the official Atlassian documentation.

HTML tags used in the rendering of the field are ignored in the search



Snapshot Date & Datetime

You can search on Snapshot Date and Date time fields the same way you do it on Standard Jira date and date time fields (like Created or Updated)

If you'd like to learn more, please read the official Atlassian documentation.


JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.