Loading

Help documentation

Back to previous page

Mingle search

Introduction

Mingle lets you perform a comprehensive free-text search on project artifacts, including cards, pages and murmurs.

The following fields are included when searching for...

  • Cards: type, name, number, description, tags, comments/murmurs, created by (user) and modified by (user). (Starting with Mingle 12.2, you can also choose to index text, numeric and user card properties. Please contact our support team for more information about how to do this.)
  • Pages: name, content, created by (user) and modified by (user).
  • Murmurs: content and author (user).

How to search

  1. To search in Mingle, type your term in the Search field at the top-right of the screen.
    2. Mingle search field
  2. When your cursor has focus on the search text field hit the enter button or click on the magnifying glass to initiate your search. Mingle will return any cards, pages or murmurs that match your search keyword on the Search results page.
  3. By default the search results show all cards, pages and murmurs that match the search terms. You can narrow your results to cards only, pages only or murmurs only by clicking on the respective facet.
    4. Search results page

Navigating directly to a card

If you know the number of the card you want to view, you can navigate directly to it by typing the card number prefixed with a # symbol into the Search field.

Typing #123 will bring up the card view for card number 123.

Advanced search options

Mingle search is built on top of Apache Lucene so you can now use familiar query syntax to fine tune your search results.

Apache Lucene offers a range of term modifiers and operators to affect your search results. Mingle search supports a subset of the modifiers and operators provided by Lucene. Notably Mingle has overridden the behavior of searching for fields so this search feature is not supported unless you are searching for card type.

Advanced search syntax examples:

  • Single character wildcard search (?): The query "te?t" returns "test" and "text". The query "boo?" returns "book" and "boot".
  • Multiple characters wildcard search (*): The query "te*t" returns words that begin with "te" and end with "t". The query "boo*" returns "boom" and "boomerang".
  • Search by card type: To search within a certain card type, precede the search term with "type:" followed by the name of the card type. (N.B. There should be no space after the colon and before the card type.) 
    type:story integration
    Enclose multi-word card names and search terms in quotes. 
    type:"epic story" "integration parameter"
  • Boolean operators: The default conjunction operator is AND. Boolean operators must be ALL CAPS. Supported operators are AND, "+", OR, NOT and "-". The AND operator matches documents where both terms exist. 
    "3rd party" AND service
    The "+" operator requires that the term after the "+" symbol must exist. 
    +authenticate user
    The OR operator matches documents where either search term exists. 
    authenticate OR login
    Search results will exclude documents where terms are preceded by the NOT or "-" operators 
    content NOT cms
    content -cms
  • Grouping: You can use parentheses to group clauses and form sub queries. 
    (authenticate OR login) AND "cms"

Also see...