Bugzilla:BzAPI:Search

From MozillaWiki
Revision as of 00:32, 2 October 2009 by Gerv (talk | contribs) (Created page with 'This page defines the URL parameter interface for searching for bugs using the HTTP API (/bug GET). The following fields may be used in the given manner on the search interface…')
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

This page defines the URL parameter interface for searching for bugs using the HTTP API (/bug GET).

The following fields may be used in the given manner on the search interface:

Single Value, Multiplicable

Specify any number of individual discrete values as separate URL parameters with identical keys.

Fields: classification, component, op_sys, priority, product, resolution, version, target_milestone, severity, status, platform

E.g. component=XML&severity=critical&severity=blocker

Text Fields

Specify some text to search for in the following fields along with a $FIELDNAME_type parameter holding one of the given values, to define the type of search.

Fields: comment, summary, whiteboard, url'

Types: allwordssubstr, anywordssubstr, substring, casesubstring, allwords, anywords, regexp, notregexp

E.g. summary=Flash%20crash&summary_type=allwords

Person Fields=

Specify up to two strings, as email1 and email2, and then specify the fields in which to search for those strings (booleans - set to 1 if wanted), and the type of search to do (emailN_type).

Fields: emailN_assigned_to, emailN_qa_contact, emailN_reporter, emailN_cc, emailN_commenter

Types: substring, exact, notequals, regexp, notregexp

E.g. email1=fred@example.com&email1_type=exact&email1_assigned_to=1&email1_qa_contact=1

Other Fields

Bug ID

id=<comma-separated list>, id_type either include or exclude.

E.g. id=3,4,5,6&id_type=include

Deadline

Specify a range with deadline_from and deadline_to.

E.g. deadline_from=2008-08-08&deadline_to=2009-09-09

Keywords

Specify one or more keywords, comma-separated, and then a type of search as keywords_type:

Type: allwords anywords nowords

E.g. keywords=charming,interesting&keywords_type=anywords

Field Changes

You can also specify that a particular field has changed. changed_field is the name, and you can optionally specify a date range for the change with changed_field_from and/or changed_field_to, and also optionally set changed_field_value for the new value.

E.g. changed_field=priority&changed_field_from=2008-08-08&changed_field_to=2009-09-09&changed_field_value=P1

Boolean Charts

<sigh>