NAME

Bugzilla::Testopia::Webservice::Build


EXTENDS

Bugzilla::Webservice


DESCRIPTION

Provides methods for automated scripts to manipulate Testopia Builds


METHODS

check_build($name, $product)
 Description: Looks up and returns a build by name.
 Params:      $name - String: name of the build.
              $product - Integer/String/Object
                         Integer: product_id of the product in the Database
                         String: Product name
                         Object: Blessed Bugzilla::Product object
 Returns:     Hash: Matching Build object hash or error if not found.
create($values)
 Description: Creates a new build object and stores it in the database
 Params:      $values - Hash: A reference to a hash with keys and values  
              matching the fields of the build to be created. 
  +-------------+----------------+-----------+------------------------------------+
  | Field       | Type           | Null      | Description                        |
  +-------------+----------------+-----------+------------------------------------+
  | product     | Integer/String | Required  | ID or Name of product              |
  | name        | String         | Required  |                                    |
  | milestone   | String         | Optional  | Defaults to product's default MS   |
  | description | String         | Optional  |                                    |
  | isactive    | Boolean        | Optional  | Defaults to True (1)               |
  +-------------+----------------+-----------+------------------------------------+
 Returns:     The newly created object hash.
get($id)
 Description: Used to load an existing build from the database.
 Params:      $id - An integer representing the ID in the database
 Returns:     A blessed Bugzilla::Testopia::Build object hash

lookup_id_by_name DEPRECATED - CONSIDERED HARMFUL Use Build::check_build instead
lookup_name_by_id DEPRECATED Use Build::get instead
update($id, $values)
 Description: Updates the fields of the selected build or builds.

 Params:      $id - Integer: A single build ID.

              $values - Hash of keys matching Build fields and the new values 
              to set each field to.
                        +-------------+----------------+
                        | Field       | Type           |
                        +-------------+----------------+
                        | name        | String         |
                        | milestone   | String         |
                        | description | String         |
                        | isactive    | Boolean        |
                        +-------------+----------------+

 Returns:     Hash: The updated Build object hash.


SEE ALSO

the Bugzilla::Testopia::Build manpage the Bugzilla::Webservice manpage


AUTHOR

Greg Hendricks <ghendricks@novell.com>