5.7.139. Bugzilla::Extension::AgileTools::Team

5.7.139.1. NAME

Bugzilla::Extension::AgileTools::Team - Bugzilla Object class presenting a team

5.7.139.2. SYNOPSIS

use Bugzilla::Extension::AgileTools::Team

my $team = new Bugzilla::Extension::AgileTools::Team(1);

my $team_id = $team->id;
my $name = $team->name;
my $group = $team->group;
my $group_id = $team->group_id;
my $process_id = $team->process_id;

my @members = @{$team->memebers};
$team->add_member("john.doe@example.com");
$team->add_member($user_id);
my $member = Bugzilla::User->check("john.doe@example.com");
$team->remove_member($member);
$team->remove_member($user_id);

my $user = new Bugzilla::User(1);
my @teams = @{$user->agile_teams};

5.7.139.3. DESCRIPTION

Object inherited from Bugzilla::Object.

5.7.139.4. FIELDS

5.7.139.5. METHODS

Accessors

For all FIELDS there is $object->fieldname method

Additionally there are accessors for

  • group - Get the Bugzilla::Group object matching team->group_id
  • backlogs - Arrayref of Backlog objects linked to this team

Mutators

For all mutable FIELDS there is $object->set_fieldname($value) method

For managing team members

members

Returns array ref of Bugzilla::User objects containing all team members.

add_member

Adds a new member to the team.

add_member($user)
  • $user User object, name or id

remove_member

Removes a member from the team.

remove_member($user)
  • $user User object, name or id

roles

Returns hash ref where keys are user IDs and values are array refs of Role objects for all team members.

by_roles

Returns hash ref where keys are Role names and values are array refs of User objects for all team members. Will only include backup roles if requested.

by_roles($backups)

For user permissions

user_can_edit

Returns boolean true if user is allowed to edit the team.

user_can_edit($user)
  • $user (optional) Bugzilla::User object. Current logged in user is used if not given.

For items

unprioritized_items

Returns array ref of Bugzilla::Bug objects which are in teams responsibilities, but are not in any pool.

pools

Returns Array ref of Pool objects containing teams backlog and sprint pools.

current_sprint

Returns the curent Sprint of the team or undef if there is no current sprint

For managing group access

view_groups

Returns array ref of Bugzilla::Group objects containing all view groups.

add_view_group

Adds a new view_group to the team.

add_view_group($group)
  • $group Group object, name or id

remove_view_group

Removes a view group from the team.

remove_view_group($user)
  • $group Group object, name or id

edit_groups

Returns array ref of Bugzilla::Group objects containing all edit groups.

add_edit_group

Adds a new edit_group to the team.

add_edit_group($group)
  • $group Group object, name or id

remove_edit_group

Removes a edit group from the team.

remove_edit_group($user)
  • $group Group object, name or id

user_can_view

Returns boolean true if user is allowed to view the team.

user_can_view($user)
  • $user (optional) Bugzilla::User object. Current logged in user is used if not given.

5.7.139.7. NOTES

None of the methods check if user is allowed to modify the teams. This should be done by higher level controller methods using this as only a interface to the stored data.

5.7.139.8. SEE ALSO

Bugzilla::Object

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