Bugzilla:BzAPI:Search: Difference between revisions

Bugzilla:BzAPI:Search (view source)

Revision as of 16:41, 16 November 2009

198 bytes removed , 16 November 2009

no edit summary

Gerv

Account confirmers, Anti-spam team, Confirmed users, Bureaucrats and Sysops emeriti

4,925

edits

@@ Line 1: / Line 1: @@
 This page defines the URL parameter interface for searching for bugs using the HTTP API (/bug GET). At the moment, the search API call does also support the field names from the web interface, to make it easy to port URLs and other code across. But if supporting this becomes difficult, it might go away.
-==Single Value, Multiplicable==
-For the following fields, specify any number of individual discrete values as separate URL parameters with identical keys.
-Fields: '''classification, component, op_sys, platform, priority, product, resolution, severity, status, target_milestone, version'''
-E.g. component=XML&severity=critical&severity=blocker
 ==Text Fields==
@@ Line 46: / Line 38: @@
 E.g. changed_after=2008-08-08&changed_before=2009-09-09&changed_field=priority&changed_field_to=P1
+==Single Value, Multiplicable==
+For any other single-valued field, including custom fields and (where it makes sense) the field names given below for use with Boolean Charts, you can specify any number of individual discrete values as separate URL parameters with identical keys. Multiple values will be ORed together.
+E.g. component=XML&severity=critical&severity=blocker
 ==Boolean Charts==
-The Bugzilla "boolean charts" mechanism is the way to construct more complex queries, or to search on other fields which do not have their own dedicated parameters (e.g. time tracking fields, attachment fields, flags, history, groups and related bugs). Boolean chart parameters are passed through unchanged, apart from translating any [[Bugzilla:REST_API:Objects|new field names]] and [[Bugzilla:REST_API:Search#types|new type names]] into the ones Bugzilla understands natively.
+The Bugzilla "boolean charts" mechanism is the way to construct more complex queries, or to search on other fields which do not have their own dedicated parameters (e.g. time tracking fields, attachment fields, flags, history, groups and related bugs).
 The parameters for each triple are '''fieldA-B-C''', '''typeA-B-C''' and '''valueA-B-C''', where A, B and C are integers beginning at 0.