5.7.59. Bugzilla::Search

5.7.59.1. NAME

Bugzilla::Search - Provides methods to run queries against bugs.

5.7.59.2. SYNOPSIS

use Bugzilla::Search;

my $search = new Bugzilla::Search({'fields' => \@fields,
                                   'params' => \%search_criteria,
                                   'sharer' => $sharer_id,
                                   'user'   => $user_obj,
                                   'allow_unlimited' => 1});

my $data = $search->data;
my ($data, $extra_data) = $search->data;

5.7.59.3. DESCRIPTION

Search.pm represents a search object. It's the single way to collect data about bugs in a secure way. The list of bugs matching criteria defined by the caller are filtered based on the user privileges.

5.7.59.4. METHODS

new

Description

Create a Bugzilla::Search object.

Params

fields

An arrayref representing the bug attributes for which data is desired. Legal attributes are listed in the fielddefs DB table. At least one field must be defined, typically the 'bug_id' field.

params

A hashref representing search criteria. Each key => value pair represents a search criteria, where the key is the search field and the value is the value for this field. At least one search criteria must be defined if the 'search_allow_no_criteria' parameter is turned off, else an error is thrown.

sharer

When a saved search is shared by a user, this is their user ID.

user

A Bugzilla::User object representing the user to whom the data is addressed. All security checks are done based on this user object, so it's not safe to share results of the query with other users as not all users have the same privileges or have the same role for all bugs in the list. If this parameter is not defined, then the currently logged in user is taken into account. If no user is logged in, then only public bugs will be returned.

allow_unlimited

If set to a true value, the number of bugs retrieved by the query is not limited.

Returns

data

Description

Returns bugs matching search criteria passed to new().

Params

None

Returns

In scalar context, this method returns a reference to a list of bugs. Each item of the list represents a bug, which is itself a reference to a list where each item represents a bug attribute, in the same order as specified in the fields parameter of new().

In list context, this methods also returns a reference to a list containing references to hashes. For each hash, two keys are defined: sql contains the SQL query which has been executed, and time contains the time spent to execute the SQL query, in seconds. There can be either a single hash, or two hashes if two SQL queries have been executed sequentially to get all the required data.

5.7.59.5. Methods in need of POD

invalid_order_columns

COLUMN_JOINS

split_order_term

SqlifyDate

REPORT_COLUMNS

pronoun

COLUMNS

order

search_description

IsValidQueryType

build_subselect

do_search_function

boolean_charts_to_custom_search


This documentation undoubtedly has bugs; if you find some, please file them here.