5.7.35. Bugzilla::Flag

5.7.35.1. NAME

Bugzilla::Flag - A module to deal with Bugzilla flag values.

5.7.35.2. SYNOPSIS

Flag.pm provides an interface to flags as stored in Bugzilla. See below for more information.

5.7.35.3. NOTES

  • *
Import relevant functions from that script.
  • *
Use of private functions / variables outside this module may lead to unexpected results after an upgrade. Please avoid using private functions in other files/modules. Private functions are functions whose names start with _ or a re specifically noted as being private.

METHODS

  • id
Returns the ID of the flag.
  • name
Returns the name of the flagtype the flag belongs to.
  • bug_id
Returns the ID of the bug this flag belongs to.
  • attach_id
Returns the ID of the attachment this flag belongs to, if any.
  • status
Returns the status ‘+’, ‘-‘, ‘?’ of the flag.
  • creation_date
Returns the timestamp when the flag was created.
  • modification_date
Returns the timestamp when the flag was last modified.
  • type
Returns the type of the flag, as a Bugzilla::FlagType object.
  • setter
Returns the user who set the flag, as a Bugzilla::User object.
  • requestee
Returns the user who has been requested to set the flag, as a Bugzilla::User object.
  • attachment
Returns the attachment object the flag belongs to if the flag is an attachment flag, else undefined.
  • match($criteria)
Queries the database for flags matching the given criteria (specified as a hash of field names and their matching values) and returns an array of matching records.
  • count($criteria)
Queries the database for flags matching the given criteria (specified as a hash of field names and their matching values) and returns an array of matching records.
  • create($flag, $timestamp)
Creates a flag record in the database.
  • extract_flags_from_cgi($bug, $hr_vars, $skip, $args)

Checks whether or not there are new flags to create and returns an array of hashes. This array is then passed to Flag::create().

$args is a hash contaning either a bug and optionally an attachment object or a product_id and component_id

  • multi_extract_flags_from_cgi($bug, $hr_vars)
Checks whether or not there are new flags to create and returns an array of hashes. This array is then passed to Flag::create(). This differs from the previous sub-routine as it is called for changing multiple bugs
  • notify($flag, $old_flag, $object, $timestamp)
Sends an email notification about a flag being created, fulfilled or deleted.

5.7.35.4. Methods in need of POD

  • update_activity
  • setter_id
  • bug
  • requestee_id
  • DB_COLUMNS
  • set_flag
  • type_id
  • snapshot
  • update_flags
  • update
## REDHAT EXTENSION START 406121
  • sqlify_criteria($criteria, $tables)
Converts a hash of criteria into a list of SQL criteria. $criteria is a reference to the criteria (field => value), $tables is a reference to an array of tables being accessed by the query.

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