<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>2.5. Finding Bugs — Bugzilla 5.0.4 documentation</title>
<link rel="stylesheet" href="../_static/bugzilla.css" type="text/css" />
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: '../',
VERSION: '5.0.4',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<link rel="shortcut icon" href="../_static/favicon.ico"/>
<link rel="search" title="Search" href="../search.html" />
<link rel="next" title="2.6. Reports and Charts" href="reports-and-charts.html" />
<link rel="prev" title="2.4. Editing a Bug" href="editing.html" />
</head>
<body>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="reports-and-charts.html" title="2.6. Reports and Charts"
accesskey="N">next</a></li>
<li class="right" >
<a href="editing.html" title="2.4. Editing a Bug"
accesskey="P">previous</a> |</li>
<li class="nav-item nav-item-0"><a href="../index.html">Bugzilla 5.0.4 documentation</a> »</li>
<li class="nav-item nav-item-1"><a href="index.html" accesskey="U">2. User Guide</a> »</li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<div class="section" id="finding-bugs">
<span id="finding"></span><h1>2.5. Finding Bugs<a class="headerlink" href="#finding-bugs" title="Permalink to this headline">¶</a></h1>
<p>Bugzilla has a number of different search options.</p>
<div class="admonition note">
<p class="first admonition-title">Note</p>
<p class="last">Bugzilla queries are case-insensitive and accent-insensitive when
used with either MySQL or Oracle databases. When using Bugzilla with
PostgreSQL, however, some queries are case sensitive. This is due to
the way PostgreSQL handles case and accent sensitivity.</p>
</div>
<div class="section" id="quicksearch">
<span id="id1"></span><h2>2.5.1. Quicksearch<a class="headerlink" href="#quicksearch" title="Permalink to this headline">¶</a></h2>
<p>Quicksearch is a single-text-box query tool. You'll find it in
Bugzilla's header or footer.</p>
<p>Quicksearch uses
metacharacters to indicate what is to be searched. For example, typing</p>
<blockquote>
<div><code class="docutils literal"><span class="pre">foo|bar</span></code></div></blockquote>
<p>into Quicksearch would search for "foo" or "bar" in the
summary and status whiteboard of a bug; adding</p>
<blockquote>
<div><code class="docutils literal"><span class="pre">:BazProduct</span></code></div></blockquote>
<p>would search only in that product.</p>
<p>You can also use it to go directly to a bug by entering its number or its
alias.</p>
</div>
<div class="section" id="simple-search">
<h2>2.5.2. Simple Search<a class="headerlink" href="#simple-search" title="Permalink to this headline">¶</a></h2>
<p>Simple Search is good for finding one particular bug. It works like internet
search engines - just enter some keywords and off you go.</p>
</div>
<div class="section" id="advanced-search">
<h2>2.5.3. Advanced Search<a class="headerlink" href="#advanced-search" title="Permalink to this headline">¶</a></h2>
<p>The Advanced Search page is used to produce a list of all bugs fitting
exact criteria. <a class="reference external" href="http://landfill.bugzilla.org/bugzilla-tip/query.cgi?format=advanced">You can play with it on
Landfill</a>.</p>
<p>Advanced Search has controls for selecting different possible
values for all of the fields in a bug, as described above. For some
fields, multiple values can be selected. In those cases, Bugzilla
returns bugs where the content of the field matches any one of the selected
values. If none is selected, then the field can take any value.</p>
<p>After a search is run, you can save it as a Saved Search, which
will appear in the page footer. If you are in the group defined
by the "querysharegroup" parameter, you may share your queries
with other users; see <a class="reference internal" href="preferences.html#saved-searches"><span class="std std-ref">Saved Searches</span></a> for more details.</p>
</div>
<div class="section" id="custom-search">
<span id="id2"></span><h2>2.5.4. Custom Search<a class="headerlink" href="#custom-search" title="Permalink to this headline">¶</a></h2>
<p>Highly advanced querying is done using the <span class="guilabel">Custom Search</span> feature
of the <span class="guilabel">Advanced Search</span> page.</p>
<p>The search criteria here further restrict the set of results
returned by a query, over and above those defined in the fields at the top
of the page. It is thereby possible to search for bugs
based on elaborate combinations of criteria.</p>
<p>The simplest custom searches have only one term. These searches
permit the selected <em>field</em>
to be compared using a
selectable <em>operator</em> to a
specified <em>value.</em> Much of this could be reproduced using the standard
fields. However, you can then combine terms using "Match ANY" or "Match ALL",
using parentheses for combining and priority, in order to construct searches
of almost arbitrary complexity.</p>
<p>There are three fields in each row (known as a "term") of a custom search:</p>
<ul class="simple">
<li><em>Field:</em>
the name of the field being searched</li>
<li><em>Operator:</em>
the comparison operator</li>
<li><em>Value:</em>
the value to which the field is being compared</li>
</ul>
<p>The list of available <em>fields</em> contains all the fields defined for a bug,
including any custom fields, and then also some pseudofields like
<span class="guilabel">Assignee Real Name</span>, <span class="guilabel">Days Since Bug Changed</span>,
<span class="guilabel">Time Since Assignee Touched</span> and other things it may be useful to
search on.</p>
<p>There are a wide range of <em>operators</em> available, not all of which may make
sense for a particular field. There are various string-matching operations
(including regular expressions), numerical comparisons (which also work for
dates), and also the ability to search for change information—when a field
changed, what it changed from or to, and who did it. There are special
operators for <span class="guilabel">is empty</span> and <span class="guilabel">is not empty</span>, because
Bugzilla can't tell the difference between a value field left blank on
purpose and one left blank by accident.</p>
<p>You can have an arbitrary number of rows, and the dropdown box above them
defines how they relate—<span class="guilabel">Match ALL of the following separately</span>,
<span class="guilabel">Match ANY of the following separately</span>, or <span class="guilabel">Match ALL of
the following against the same field</span>. The difference between the first and
the third can be illustrated with a comment search. If you have a search:</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">Comment</span> <span class="n">contains</span> <span class="n">the</span> <span class="n">string</span> <span class="s2">"Fred"</span>
<span class="n">Comment</span> <span class="n">contains</span> <span class="n">the</span> <span class="n">string</span> <span class="s2">"Barney"</span>
</pre></div>
</div>
<p>then under the first regime (match separately) the search would return bugs
where "Fred" appeared in one comment and "Barney" in the same or any other
comment, whereas under the second (match against the same field), both strings
would need to occur in exactly the same comment.</p>
<div class="section" id="advanced-features">
<span id="id3"></span><h3>2.5.4.1. Advanced Features<a class="headerlink" href="#advanced-features" title="Permalink to this headline">¶</a></h3>
<p>If you click <span class="guilabel">Show Advanced Features</span>, then more capabilities appear.
You can negate any row with a checkbox (see below) and also group lines of the
search with parentheses to determine how different search terms relate. Within
each bracketed set, you get the choice of combining them using ALL (i.e. AND)
or ANY (i.e. OR).</p>
</div>
<div class="section" id="negation">
<h3>2.5.4.2. Negation<a class="headerlink" href="#negation" title="Permalink to this headline">¶</a></h3>
<p>At first glance, negation seems redundant. Rather than
searching for:</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">NOT</span> <span class="p">(</span> <span class="n">summary</span> <span class="n">contains</span> <span class="n">the</span> <span class="n">string</span> <span class="s2">"foo"</span> <span class="p">)</span>
</pre></div>
</div>
<p>one could search for:</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">summary</span> <span class="n">does</span> <span class="ow">not</span> <span class="n">contain</span> <span class="n">the</span> <span class="n">string</span> <span class="s2">"foo"</span>
</pre></div>
</div>
<p>However, the search:</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">CC</span> <span class="n">does</span> <span class="ow">not</span> <span class="n">contain</span> <span class="n">the</span> <span class="n">string</span> <span class="s2">"@mozilla.org"</span>
</pre></div>
</div>
<p>would find every bug where anyone on the CC list did not contain
"@mozilla.org" while:</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">NOT</span> <span class="p">(</span> <span class="n">CC</span> <span class="n">contains</span> <span class="n">the</span> <span class="n">string</span> <span class="s2">"@mozilla.org"</span> <span class="p">)</span>
</pre></div>
</div>
<p>would find every bug where there was nobody on the CC list who
did contain the string. Similarly, the use of negation also permits
complex expressions to be built using terms OR'd together and then
negated. Negation permits queries such as:</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">NOT</span> <span class="p">(</span> <span class="p">(</span> <span class="n">product</span> <span class="n">equals</span> <span class="s2">"Update"</span> <span class="p">)</span>
<span class="n">OR</span>
<span class="p">(</span> <span class="n">component</span> <span class="n">equals</span> <span class="s2">"Documentation"</span> <span class="p">)</span>
<span class="p">)</span>
</pre></div>
</div>
<p>to find bugs that are neither
in the <span class="guilabel">Update</span> product or in the <span class="guilabel">Documentation</span> component
or:</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">NOT</span> <span class="p">(</span> <span class="p">(</span> <span class="n">commenter</span> <span class="n">equals</span> <span class="s2">"%assignee%"</span> <span class="p">)</span>
<span class="n">OR</span>
<span class="p">(</span><span class="n">component</span> <span class="n">equals</span> <span class="s2">"Documentation"</span> <span class="p">)</span>
<span class="p">)</span>
</pre></div>
</div>
<p>to find non-documentation bugs on which the assignee has never commented.</p>
</div>
<div class="section" id="pronoun-substitution">
<span id="pronouns"></span><h3>2.5.4.3. Pronoun Substitution<a class="headerlink" href="#pronoun-substitution" title="Permalink to this headline">¶</a></h3>
<p>Sometimes, a query needs to compare a user-related field
(such as <span class="guilabel">Reporter</span>) with a role-specific user (such as the
user running the query or the user to whom each bug is assigned). For
example, you may want to find all bugs that are assigned to the person
who reported them.</p>
<p>When the <span class="guilabel">Custom Search</span> operator is either <span class="guilabel">equals</span> or
<span class="guilabel">notequals</span>, the value can be "%reporter%", "%assignee%",
"%qacontact%", or "%user%". These are known as "pronouns". The user pronoun
refers to the user who is executing the query or, in the case
of whining reports, the user who will be the recipient
of the report. The reporter, assignee, and qacontact
pronouns refer to the corresponding fields in the bug.</p>
<p>This feature also lets you search by a user's group memberships. If the
operator is either <span class="guilabel">equals</span>, <span class="guilabel">notequals</span> or
<span class="guilabel">anyexact</span>, you can search for
whether a user belongs (or not) to the specified group. The group name must be
entered using "%group.foo%" syntax, where "foo" is the group name.
So if you are looking for bugs reported by any user being in the
"editbugs" group, then you can use:</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">reporter</span> <span class="n">equals</span> <span class="s2">"</span><span class="si">%g</span><span class="s2">roup.editbugs%"</span>
</pre></div>
</div>
</div>
</div>
<div class="section" id="bug-lists">
<span id="list"></span><h2>2.5.5. Bug Lists<a class="headerlink" href="#bug-lists" title="Permalink to this headline">¶</a></h2>
<p>The result of a search is a list of matching bugs.</p>
<p>The format of the list is configurable. For example, it can be
sorted by clicking the column headings. Other useful features can be
accessed using the links at the bottom of the list:</p>
<dl class="docutils">
<dt>Long Format:</dt>
<dd>this gives you a large page with a non-editable summary of the fields
of each bug.</dd>
<dt>XML (icon):</dt>
<dd>get the buglist in an XML format.</dd>
<dt>CSV (icon):</dt>
<dd>get the buglist as comma-separated values, for import into e.g.
a spreadsheet.</dd>
<dt>Feed (icon):</dt>
<dd>get the buglist as an Atom feed. Copy this link into your
favorite feed reader. If you are using Firefox, you can also
save the list as a live bookmark by clicking the live bookmark
icon in the status bar. To limit the number of bugs in the feed,
add a limit=n parameter to the URL.</dd>
<dt>iCalendar (icon):</dt>
<dd>Get the buglist as an iCalendar file. Each bug is represented as a
to-do item in the imported calendar.</dd>
<dt>Change Columns:</dt>
<dd>change the bug attributes which appear in the list.</dd>
<dt>Change Several Bugs At Once:</dt>
<dd>If your account is sufficiently empowered, and more than one bug
appears in the bug list, this link is displayed and lets you easily make
the same change to all the bugs in the list - for example, changing
their assignee.</dd>
<dt>Send Mail to Bug Assignees:</dt>
<dd>If more than one bug appear in the bug list and there are at least
two distinct bug assignees, this links is displayed which lets you
easily send a mail to the assignees of all bugs on the list.</dd>
<dt>Edit Search:</dt>
<dd>If you didn't get exactly the results you were looking for, you can
return to the Query page through this link and make small revisions
to the query you just made so you get more accurate results.</dd>
<dt>Remember Search As:</dt>
<dd>You can give a search a name and remember it; a link will appear
in your page footer giving you quick access to run it again later.</dd>
</dl>
<hr class="docutils" />
<p>This documentation undoubtedly has bugs; if you find some, please file
them <a class="reference external" href="https://bugzilla.mozilla.org/enter_bug.cgi?product=Bugzilla&component=Documentation">here</a>.</p>
</div>
</div>
</div>
</div>
</div>
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
<div class="sphinxsidebarwrapper">
<p class="logo"><a href="../index.html">
<img class="logo" src="../_static/bugzilla.png" alt="Logo"/>
</a></p>
<h3><a href="../index.html">Table Of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#">2.5. Finding Bugs</a><ul>
<li><a class="reference internal" href="#quicksearch">2.5.1. Quicksearch</a></li>
<li><a class="reference internal" href="#simple-search">2.5.2. Simple Search</a></li>
<li><a class="reference internal" href="#advanced-search">2.5.3. Advanced Search</a></li>
<li><a class="reference internal" href="#custom-search">2.5.4. Custom Search</a><ul>
<li><a class="reference internal" href="#advanced-features">2.5.4.1. Advanced Features</a></li>
<li><a class="reference internal" href="#negation">2.5.4.2. Negation</a></li>
<li><a class="reference internal" href="#pronoun-substitution">2.5.4.3. Pronoun Substitution</a></li>
</ul>
</li>
<li><a class="reference internal" href="#bug-lists">2.5.5. Bug Lists</a></li>
</ul>
</li>
</ul>
<h4>Previous topic</h4>
<p class="topless"><a href="editing.html"
title="previous chapter">2.4. Editing a Bug</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="reports-and-charts.html"
title="next chapter">2.6. Reports and Charts</a></p>
<div id="searchbox" style="display: none" role="search">
<h3>Quick search</h3>
<form class="search" action="../search.html" method="get">
<div><input type="text" name="q" /></div>
<div><input type="submit" value="Go" /></div>
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="reports-and-charts.html" title="2.6. Reports and Charts"
>next</a></li>
<li class="right" >
<a href="editing.html" title="2.4. Editing a Bug"
>previous</a> |</li>
<li class="nav-item nav-item-0"><a href="../index.html">Bugzilla 5.0.4 documentation</a> »</li>
<li class="nav-item nav-item-1"><a href="index.html" >2. User Guide</a> »</li>
</ul>
</div>
<div class="footer" role="contentinfo">
Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.6.6.
</div>
</body>
</html>
