<<

# Bugzilla::Field::ChoiceInterface

- NAME
- DESCRIPTION
- METHODS
  - Accessors
- Methods in need of POD

# NAME

Bugzilla::Field::ChoiceInterface - Makes an object act like a Bugzilla::Field::Choice.

# DESCRIPTION

This is an "interface", in the Java sense (sometimes called a "Role" or a "Mixin" in other languages). Bugzilla::Field::Choice is the primary implementor of this interface, but other classes also implement it if they want to "act like" Bugzilla::Field::Choice.

# METHODS

## Accessors

These are in addition to the standard Bugzilla::Object accessors.

`sortkey`

  The key that determines the sort order of this item.

`field`

  The Bugzilla::Field object that this field value belongs to.

`is_active`

  Whether or not this value should appear as an option on bugs that do not already have it set as the current value.

`is_static`

  `0` if this field value can be renamed or deleted, `1` otherwise.

`is_default`

  `1` if this is the default value for this field, `0` otherwise.

`bug_count`

  An integer count of the number of bugs that have this value set.

`controls_visibility_of_fields`

  Returns an arrayref of Bugzilla::Field objects, representing any fields whose visibility are controlled by this field value.

`controlled_values`

  Tells you which values in other fields appear (become visible) when this value is set in its field.

  Returns a hashref of arrayrefs. The hash keys are the names of fields, and the values are arrays of objects that implement `Bugzilla::Field::ChoiceInterface`, representing values that this value controls the visibility of, for that field.

`visibility_value`

  Returns an object that implements `Bugzilla::Field::ChoiceInterface`, which represents the value that needs to be set in order for this value to appear in the UI.

`is_visible_on_bug`

  Returns `1` if, according to the settings of `is_active` and `visibility_value`, this value should be displayed as an option when viewing a bug. Returns `0` otherwise.

  Takes a single argument, a Bugzilla::Bug object or a hash with similar fields to a Bugzilla::Bug object.

`is_set_on_bug`

  Returns `1` if this value is the current value set for its field on the passed-in Bugzilla::Bug object (or a hash that looks like a Bugzilla::Bug). For multi-valued fields, we return `1` if any of the currently selected values are this value.

  Returns `0` otherwise.

# Methods in need of POD

FIELD_NAME
controlled_values_array

<<