Build.pm

- NAME
- EXTENDS
- DESCRIPTION
- METHODS
- SEE ALSO
- AUTHOR

# 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>