Bugzilla:BzAPI:Search: Difference between revisions

Jump to navigation Jump to search
no edit summary
No edit summary
No edit summary
Line 29: Line 29:
==Bug ID==
==Bug ID==


'''id'''=<comma-separated list>, id_type either '''include''' or '''exclude'''. Note that this field does not support aliases.
Specify '''id'''=<comma-separated list>, and an '''id_type'' of either ''include'' or ''exclude''. Note that this field does not support aliases.


E.g. id=3,4,5,6&id_type=include
E.g. id=3,4,5,6&id_type=include
Line 49: Line 49:
==Boolean Charts==
==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). See Bugzilla's documentation for details of how they work. At the moment, boolean chart parameters are passed through unchanged, apart from translating any [[Bugzilla:REST_API:Objects|new field names]] and 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). 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 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.  
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.  
Line 61: Line 61:
0-0-0 && 1-0-0 && (2-0-0 && 2-1-0) && (3-0-0 && (3-1-0 || 3-1-1 || 3-1-2))
0-0-0 && 1-0-0 && (2-0-0 && 2-1-0) && (3-0-0 && (3-1-0 || 3-1-1 || 3-1-2))


Every field on the bug object (except ref, token and work_time, which is Submit Only) can be used with the boolean charts. You may search all attachment fields (except encoding) by specifying a field of "attachment.<fieldname>".  
Every field on the bug object (except ref, token and work_time, which is Submit Only) can be used with the boolean charts.  


A Note on Plurality: some fields on the Bug object whose values are arrays are linguistically plural but search only applies to a single instance. The field names for search in these cases are in the singular. This applies to: comments, attachments, flags, and groups.
A Note on Plurality: some fields on the Bug object whose values are arrays are linguistically plural, but search only applies to a single instance. The field names for search in these cases are in the singular. This applies to: comments, attachments, flags, and groups.


Additional field values you can use are:
You may search all attachment fields (except encoding) by specifying a field of "attachment.<fieldname>". Additional field values you can use are:


{| border="1"
{| border="1"
Line 87: Line 87:
|}
|}


<a name="types"></a>
Type values you can use are:
Type values you can use are:


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

edits

Navigation menu