This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V. More...

Collaboration diagram for ilExAssignmentTeam:

Public Member Functions
	__construct (?int $a_id=null)

	getId ()

	createTeam (int $a_assignment_id, int $a_user_id)

	getMembers ()

	getMembersOfAllTeams ()
	Get members for all teams of assignment. More...

	addTeamMember (int $a_user_id, ?int $a_exc_ref_id=null)

	removeTeamMember (int $a_user_id, ?int $a_exc_ref_id=null)

	writeLog (int $a_action, ?string $a_details=null)

	getLog ()

	sendNotification (int $a_exc_ref_id, int $a_user_id, string $a_action)
	Send notification about team status. More...

	createRandomTeams (int $a_exercise_id, int $a_assignment_id, int $a_number_teams, int $a_min_participants)
	Create random teams for assignment type "team upload" following specific rules. More...

Static Public Member Functions
static	getInstanceByUserId (int $a_assignment_id, int $a_user_id, bool $a_create_on_demand=false)

static	getInstancesFromMap (int $a_assignment_id)

static	getTeamId (int $a_assignment_id, int $a_user_id, bool $a_create_on_demand=false)

static	getAssignmentTeamMap (int $a_ass_id)

static	writeTeamLog (int $a_team_id, int $a_action, ?string $a_details=null)
	Add entry to team log. More...

static	getAdoptableTeamAssignments (int $a_exercise_id, ?int $a_exclude_ass_id=null, ?int $a_user_id=null)

static	adoptTeams (int $a_source_ass_id, int $a_target_ass_id, ?int $a_user_id=null, ?int $a_exc_ref_id=null)

static	getAdoptableGroups (int $a_exc_ref_id)

static	getGroupMembersMap (int $a_exc_ref_id)

Data Fields
const	TEAM_LOG_CREATE_TEAM = 1

const	TEAM_LOG_ADD_MEMBER = 2

const	TEAM_LOG_REMOVE_MEMBER = 3

const	TEAM_LOG_ADD_FILE = 4

const	TEAM_LOG_REMOVE_FILE = 5

Protected Member Functions
	read (int $a_id)

	cleanLog ()
	Remove obsolete log entries. More...

Protected Attributes
ILIAS Exercise Team TeamManager	$team_manager

ILIAS Exercise Team TeamDBRepository	$repo

ilDBInterface	$db

ilObjUser	$user

int	$id = null

int	$assignment_id

array	$members = array()

Private Member Functions
	setId (?int $a_id)

Detailed Description

This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V.

ILIAS is licensed with the GPL-3.0, see https://www.gnu.org/licenses/gpl-3.0.en.html You should have received a copy of said license along with the source code, too.

If this is not the case or you just want to try ILIAS, you'll find us at: https://www.ilias.de https://github.com/ILIAS-eLearning Exercise assignment team

Author: Jörg Lützenkirchen luetz.nosp@m.enki.nosp@m.rchen.nosp@m.@lei.nosp@m.fos.c.nosp@m.om; Alexander Killing killi.nosp@m.ng@l.nosp@m.eifos.nosp@m..de

Definition at line 25 of file class.ilExAssignmentTeam.php.

Constructor & Destructor Documentation

◆ __construct()

ilExAssignmentTeam::__construct ( ?int $a_id = null )

Definition at line 41 of file class.ilExAssignmentTeam.php.

    {
        global $DIC;
        $this->db = $DIC->database();
        $this->user = $DIC->user();
        $this->repo = $DIC->exercise()->internal()->repo()->team();
        $this->team_manager = $DIC->exercise()->internal()->domain()->team();
        if ($a_id) {
            $this->read($a_id);
        }
    }

References $DIC, read(), and ILIAS\Repository\user().

Here is the call graph for this function:

Member Function Documentation

◆ addTeamMember()

ilExAssignmentTeam::addTeamMember	(	int	$a_user_id,
		?int	$a_exc_ref_id = `null`
	)

Exceptions

ilExcUnknownAssignmentTypeException

Definition at line 187 of file class.ilExAssignmentTeam.php.

     : bool {
        $ilDB = $this->db;
 
        if (!$this->id) {
            return false;
        }
 
        // must not be in any team already
        if (!in_array($a_user_id, $this->getMembersOfAllTeams())) {
 
            // get team status...
            $status = $this->team_manager->getStatusForTeam($this->id);
 
            $this->repo->addUser(
                $this->id,
                $this->assignment_id,
                $a_user_id
            );
 
            // ...set status for new team member
            $mem_stat = new ilExAssignmentMemberStatus(
                $this->assignment_id,
                $a_user_id
            );
            $mem_stat->setStatus($status);
            $mem_stat->update();
 
 
            if ($a_exc_ref_id) {
                $this->sendNotification($a_exc_ref_id, $a_user_id, "add");
            }
 
            $this->writeLog(
                self::TEAM_LOG_ADD_MEMBER,
                ilObjUser::_lookupFullname($a_user_id)
            );
 
            $this->read($this->id);
 
            return true;
        }
 
        return false;
    }

◆ adoptTeams()

static ilExAssignmentTeam::adoptTeams	(	int	$a_source_ass_id,
		int	$a_target_ass_id,
		?int	$a_user_id = `null`,
		?int	$a_exc_ref_id = `null`
	)

static

Exceptions

ilExcUnknownAssignmentTypeException

Definition at line 439 of file class.ilExAssignmentTeam.php.

     : void {
        $teams = array();
 
        $old_team = null;
        foreach (self::getAssignmentTeamMap($a_source_ass_id) as $user_id => $team_id) {
            $teams[$team_id][] = $user_id;
 
            if ($a_user_id && $user_id == $a_user_id) {
                $old_team = $team_id;
            }
        }
 
        if ($a_user_id) {
            // no existing team (in source) or user already in team (in current)
            if (!$old_team ||
                self::getInstanceByUserId($a_target_ass_id, $a_user_id)->getId()) {
                return;
            }
        }
 
        $current_map = self::getAssignmentTeamMap($a_target_ass_id);
 
        foreach ($teams as $team_id => $user_ids) {
            if (!$old_team || $team_id == $old_team) {
                // only not assigned users
                $missing = array();
                foreach ($user_ids as $user_id) {
                    if (!array_key_exists($user_id, $current_map)) {
                        $missing[] = $user_id;
                    }
                }
 
                if ($missing !== []) {
                    // create new team
                    $first = array_shift($missing);
                    $new_team = self::getInstanceByUserId($a_target_ass_id, $first, true);
 
                    // give new team starting time of original user
                    if ($a_user_id > 0 && $old_team > 0) {
                        $idl = ilExcIndividualDeadline::getInstance($a_target_ass_id, $a_user_id);
                        if ($idl->getStartingTimestamp()) {
                            $idl_team = ilExcIndividualDeadline::getInstance($a_target_ass_id, $new_team->getId(), true);
                            $idl_team->setStartingTimestamp($idl->getStartingTimestamp());
                            $idl_team->save();
                        }
                    }
 
                    if ($a_exc_ref_id) {
                        // getTeamId() does NOT send notification
                        $new_team->sendNotification($a_exc_ref_id, $first, "add");
                    }
 
                    foreach ($missing as $user_id) {
                        $new_team->addTeamMember($user_id, $a_exc_ref_id);
                    }
                }
            }
        }
    }

References $user_id.

Referenced by ilExSubmissionTeamGUI\createAdoptedTeamObject(), and ilExAssignmentEditorGUI\generateTeams().

Here is the caller graph for this function:

◆ cleanLog()

ilExAssignmentTeam::cleanLog ( )

protected

Remove obsolete log entries.

As there is no proper team deletion event, we are doing it this way

Definition at line 334 of file class.ilExAssignmentTeam.php.

                                 : void
    {
        $ilDB = $this->db;
 
        // #18179
 
        // see also #31565
        $obsolete_teams = [];
        $set = $ilDB->query("SELECT DISTINCT l.team_id as id FROM il_exc_team_log as l LEFT JOIN il_exc_team as t ON (l.team_id = t.id) WHERE t.id IS NULL;");
        while ($row = $ilDB->fetchAssoc($set)) {
            $obsolete_teams[] = $row["id"];
        }
 
        if (count($obsolete_teams) > 0) {
            $q = "DELETE FROM il_exc_team_log" .
                " WHERE " . $ilDB->in("team_id", $obsolete_teams, false, "integer");
            $ilDB->manipulate($q);
        }
    }

References $ilDB, and $q.

◆ createRandomTeams()

ilExAssignmentTeam::createRandomTeams	(	int	$a_exercise_id,
		int	$a_assignment_id,
		int	$a_number_teams,
		int	$a_min_participants
	)

Create random teams for assignment type "team upload" following specific rules.

example:

total exercise members : 9 members
total number of teams to create (defined via form): 4 groups
number of users per team --> 9 / 4 = 2 users
users to spread over groups --> 9 % 4 = 1 user
final teams: 3 teams of 2 users and 1 team of 3 users.
Exceptions

ilExcUnknownAssignmentTypeException

Exception

Definition at line 557 of file class.ilExAssignmentTeam.php.

     : void {
        //just in case...
        if (count(self::getAssignmentTeamMap($a_assignment_id))) {
            return;
        }
        $exercise = new ilObjExercise($a_exercise_id, false);
        $obj_exc_members = new ilExerciseMembers($exercise);
        $members = $obj_exc_members->getMembers();
        $total_exc_members = count($members);
        $number_of_teams = $a_number_teams;
        if (!$number_of_teams) {
            if ($a_min_participants) {
                $number_of_teams = round($total_exc_members / $a_min_participants);
            } else {
                $number_of_teams = random_int(1, $total_exc_members);
            }
        }
        $members_per_team = round($total_exc_members / $number_of_teams);
        shuffle($members);
        for ($i = 0;$i < $number_of_teams;$i++) {
            $members_counter = 0;
            while (!empty($members) && $members_counter < $members_per_team) {
                $member_id = array_pop($members);
                if ($members_counter == 0) {
                    $team_id = $this->createTeam($a_assignment_id, $member_id);
                    $this->setId($team_id);
                    $this->assignment_id = $a_assignment_id;
                } else {
                    $this->addTeamMember($member_id);
                }
                $members_counter++;
            }
        }
        //get the new teams, remove duplicates.
        $teams = array_unique(array_values(self::getAssignmentTeamMap($a_assignment_id)));
        shuffle($teams);
        while (!empty($members)) {
            $member_id = array_pop($members);
            $team_id = array_pop($teams);
            $this->setId($team_id);
            $this->addTeamMember($member_id);
        }
    }

◆ createTeam()

ilExAssignmentTeam::createTeam	(	int	$a_assignment_id,
		int	$a_user_id
	)

Definition at line 146 of file class.ilExAssignmentTeam.php.

     : int {
 
        $id = $this->team_manager->create(
            $a_assignment_id,
            $a_user_id
        );
 
        self::writeTeamLog($id, self::TEAM_LOG_CREATE_TEAM);
        self::writeTeamLog(
            $id,
            self::TEAM_LOG_ADD_MEMBER,
            ilObjUser::_lookupFullname($a_user_id)
        );
        return $id;
    }

◆ getAdoptableGroups()

static ilExAssignmentTeam::getAdoptableGroups ( int $a_exc_ref_id )

static

Parameters

int $a_exc_ref_id

Returns: int[] group obj ids

Definition at line 512 of file class.ilExAssignmentTeam.php.

                                                                : array
    {
        global $DIC;
 
        $tree = $DIC->repositoryTree();
 
        $res = array();
 
        $parent_ref_id = $tree->getParentId($a_exc_ref_id);
        if ($parent_ref_id) {
            foreach ($tree->getChildsByType($parent_ref_id, "grp") as $group) {
                $res[] = $group["obj_id"];
            }
        }
 
        return $res;
    }

References $DIC, and $res.

Referenced by ilExerciseManagementGUI\membersObject().

Here is the caller graph for this function:

◆ getAdoptableTeamAssignments()

static ilExAssignmentTeam::getAdoptableTeamAssignments	(	int	$a_exercise_id,
		?int	$a_exclude_ass_id = `null`,
		?int	$a_user_id = `null`
	)

static

Definition at line 385 of file class.ilExAssignmentTeam.php.

     : array {
        $res = array();
 
        $data = ilExAssignment::getAssignmentDataOfExercise($a_exercise_id);
        foreach ($data as $row) {
            if ($a_exclude_ass_id && $row["id"] == $a_exclude_ass_id) {
                continue;
            }
 
            if ($row["type"] == ilExAssignment::TYPE_UPLOAD_TEAM) {
                $map = self::getAssignmentTeamMap($row["id"]);
 
                if ($a_user_id && !array_key_exists($a_user_id, $map)) {
                    continue;
                }
 
                if ($map !== []) {
                    $user_team = null;
                    if ($a_user_id) {
                        $user_team_id = $map[$a_user_id];
                        $user_team = array();
                        foreach ($map as $user_id => $team_id) {
                            if ($user_id != $a_user_id &&
                                $user_team_id == $team_id) {
                                $user_team[] = $user_id;
                            }
                        }
                    }
 
                    if (!$a_user_id ||
                        count($user_team)) {
                        $res[$row["id"]] = array(
                            "title" => $row["title"],
                            "teams" => count(array_flip($map)),
                        );
 
                        if ($a_user_id) {
                            $res[$row["id"]]["user_team"] = $user_team;
                        }
                    }
                }
            }
        }
 
        return ilArrayUtil::sortArray($res, "title", "asc", false, true);
    }

Referenced by ilExSubmissionTeamGUI\createTeamObject(), and ilExSubmissionTeamGUI\getAdoptForm().

Here is the caller graph for this function:

◆ getAssignmentTeamMap()

static ilExAssignmentTeam::getAssignmentTeamMap ( int $a_ass_id )

static

Definition at line 267 of file class.ilExAssignmentTeam.php.

                                                              : array
    {
        global $DIC;
 
        $repo = $DIC->exercise()->internal()->repo()->team();
        return $repo->getUserTeamMap($a_ass_id);
    }

References $DIC.

Referenced by ilExerciseManagementGUI\createTeamsFromGroupsObject(), ilExAssignmentEditorGUI\generateTeams(), ilExSubmissionTeamGUI\getAdoptForm(), ilAssignmentsPerParticipantTableGUI\parseData(), and ilParticipantsPerAssignmentTableGUI\parseData().

Here is the caller graph for this function:

◆ getGroupMembersMap()

static ilExAssignmentTeam::getGroupMembersMap ( int $a_exc_ref_id )

static

Definition at line 530 of file class.ilExAssignmentTeam.php.

                                                                : array
    {
        $res = array();
 
        foreach (self::getAdoptableGroups($a_exc_ref_id) as $grp_obj_id) {
            $members_obj = new ilGroupParticipants($grp_obj_id);
 
            $res[$grp_obj_id] = array(
                "title" => ilObject::_lookupTitle($grp_obj_id)
                ,"members" => $members_obj->getMembers()
            );
        }
 
        return ilArrayUtil::sortArray($res, "title", "asc", false, true);
    }

References $res, ilObject\_lookupTitle(), and ilArrayUtil\sortArray().

Referenced by ilExerciseManagementGUI\createTeamsFromGroupsObject(), and ilExerciseManagementGUI\initGroupForm().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getId()

ilExAssignmentTeam::getId ( )

Definition at line 81 of file class.ilExAssignmentTeam.php.

                           : ?int
    {
        return $this->id;
    }

References $id.

◆ getInstanceByUserId()

static ilExAssignmentTeam::getInstanceByUserId	(	int	$a_assignment_id,
		int	$a_user_id,
		bool	$a_create_on_demand = `false`
	)

static

Definition at line 53 of file class.ilExAssignmentTeam.php.

     : self {
        $id = self::getTeamId($a_assignment_id, $a_user_id, $a_create_on_demand);
        return new self($id);
    }

Referenced by ilExSubmission\__construct(), ilExerciseManagementGUI\createTeamsFromGroupsObject(), ilExerciseManagementGUI\createTeamsObject(), ilExerciseManagementGUI\dissolveTeamsObject(), and ilExcRepoObjAssignmentInfo\getInfo().

Here is the caller graph for this function:

◆ getInstancesFromMap()

static ilExAssignmentTeam::getInstancesFromMap ( int $a_assignment_id )

static

Definition at line 62 of file class.ilExAssignmentTeam.php.

                                                                    : array
    {
        $teams = array();
        foreach (self::getAssignmentTeamMap($a_assignment_id) as $user_id => $team_id) {
            $teams[$team_id][] = $user_id;
        }
 
        $res = array();
        foreach ($teams as $team_id => $members) {
            $team = new self();
            $team->id = $team_id;
            $team->assignment_id = $a_assignment_id;
            $team->members = $members;
            $res[$team_id] = $team;
        }
 
        return $res;
    }

References $res, and $user_id.

Referenced by ilExerciseManagementGUI\initIndividualDeadlineForm(), and ilParticipantsPerAssignmentTableGUI\parseData().

Here is the caller graph for this function:

◆ getLog()

ilExAssignmentTeam::getLog ( )

Definition at line 311 of file class.ilExAssignmentTeam.php.

                            : array
    {
        $ilDB = $this->db;
 
        $this->cleanLog();
 
        $res = array();
 
        $sql = "SELECT * FROM il_exc_team_log" .
            " WHERE team_id = " . $ilDB->quote($this->id, "integer") .
            " ORDER BY tstamp DESC";
        $set = $ilDB->query($sql);
        while ($row = $ilDB->fetchAssoc($set)) {
            $res[] = $row;
        }
        return $res;
    }

References $ilDB, and $res.

◆ getMembers()

ilExAssignmentTeam::getMembers ( )

Definition at line 166 of file class.ilExAssignmentTeam.php.

                                : array
    {
        return $this->members;
    }

◆ getMembersOfAllTeams()

ilExAssignmentTeam::getMembersOfAllTeams ( )

Get members for all teams of assignment.

Returns: int[] user ids

Definition at line 175 of file class.ilExAssignmentTeam.php.

                                          : array
    {
        return iterator_to_array(
            $this->repo->getAllMemberIdsOfAssignment($this->assignment_id)
        );
    }

◆ getTeamId()

static ilExAssignmentTeam::getTeamId	(	int	$a_assignment_id,
		int	$a_user_id,
		bool	$a_create_on_demand = `false`
	)

static

Definition at line 105 of file class.ilExAssignmentTeam.php.

     : ?int {
        global $DIC;
 
        $ilDB = $DIC->database();
        $repo = $DIC->exercise()->internal()->repo()->team();
        $manager = $DIC->exercise()->internal()->domain()->team();
 
        $id = $repo->getTeamForMember($a_assignment_id, $a_user_id);
 
        if (!$id && $a_create_on_demand) {
 
            $id = $manager->create(
                $a_assignment_id,
                $a_user_id
            );
 
            // get starting timestamp (relative deadlines) from individual deadline
            $idl = ilExcIndividualDeadline::getInstance($a_assignment_id, $a_user_id);
 
            // set starting timestamp for created team
            if ($idl->getStartingTimestamp() > 0) {
                $idl_team = ilExcIndividualDeadline::getInstance($a_assignment_id, $id, true);
                $idl_team->setStartingTimestamp($idl->getStartingTimestamp());
                $idl_team->save();
            }
 
            self::writeTeamLog($id, self::TEAM_LOG_CREATE_TEAM);
            self::writeTeamLog(
                $id,
                self::TEAM_LOG_ADD_MEMBER,
                ilObjUser::_lookupFullname($a_user_id)
            );
        }
 
        return $id;
    }

References $id, ilObjUser\_lookupFullname(), and ilExcIndividualDeadline\getInstance().

Referenced by ilExAssignment\canParticipantReceiveFeedback(), ilExSubmissionTeamGUI\createAdoptedTeamObject(), ilExSubmissionTeamGUI\createSingleMemberTeamObject(), ilExSubmissionTeamGUI\createTeamObject(), and ilExAssignment\getPersonalDeadline().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ read()

ilExAssignmentTeam::read ( int $a_id )

protected

Definition at line 91 of file class.ilExAssignmentTeam.php.

                                      : void
    {
        $ilDB = $this->db;
 
        // #18094
        $this->members = [];
        $this->setId($a_id);
        foreach ($this->repo->getMembers($a_id) as $member) {
            $this->assignment_id = $member->getAssignmentId();
            $this->members[] = $member->getUserId();
        }
    }

References $ilDB.

Referenced by __construct().

Here is the caller graph for this function:

◆ removeTeamMember()

ilExAssignmentTeam::removeTeamMember	(	int	$a_user_id,
		?int	$a_exc_ref_id = `null`
	)

Exceptions

ilExcUnknownAssignmentTypeException

Definition at line 238 of file class.ilExAssignmentTeam.php.

     : void {
        $ilDB = $this->db;
 
        if (!$this->id) {
            return;
        }
 
        $this->repo->removeUser(
            $this->id,
            $this->assignment_id,
            $a_user_id
        );
 
        if ($a_exc_ref_id) {
            $this->sendNotification($a_exc_ref_id, $a_user_id, "rmv");
        }
 
        $this->writeLog(
            self::TEAM_LOG_REMOVE_MEMBER,
            ilObjUser::_lookupFullname($a_user_id)
        );
 
        $this->read($this->id);
    }

Referenced by ilExSubmission\deleteUser().

Here is the caller graph for this function:

◆ sendNotification()

ilExAssignmentTeam::sendNotification	(	int	$a_exc_ref_id,
		int	$a_user_id,
		string	$a_action
	)

Send notification about team status.

Exceptions

ilExcUnknownAssignmentTypeException

Definition at line 358 of file class.ilExAssignmentTeam.php.

     : void {
        $ilUser = $this->user;
 
        // no need to notify current user
        if (!$a_exc_ref_id ||
            $ilUser->getId() == $a_user_id) {
            return;
        }
        $ass = new ilExAssignment($this->assignment_id);
 
        $ntf = new ilSystemNotification();
        $ntf->setLangModules(array("exc"));
        $ntf->setRefId($a_exc_ref_id);
        $ntf->setChangedByUserId($ilUser->getId());
        $ntf->setSubjectLangId('exc_team_notification_subject_' . $a_action);
        $ntf->setIntroductionLangId('exc_team_notification_body_' . $a_action);
        $ntf->addAdditionalInfo("exc_assignment", $ass->getTitle());
        $ntf->setGotoLangId('exc_team_notification_link');
        $ntf->setReasonLangId('exc_team_notification_reason');
        $ntf->sendMailAndReturnRecipients(array($a_user_id));
    }

◆ setId()

ilExAssignmentTeam::setId ( ?int $a_id )

private

Definition at line 86 of file class.ilExAssignmentTeam.php.

                                      : void
    {
        $this->id = $a_id;
    }

◆ writeLog()

ilExAssignmentTeam::writeLog	(	int	$a_action,
		?string	$a_details = `null`
	)

Definition at line 275 of file class.ilExAssignmentTeam.php.

     : void {
        if ($this->id) {
            self::writeTeamLog($this->id, $a_action, $a_details);
        }
    }

◆ writeTeamLog()

static ilExAssignmentTeam::writeTeamLog	(	int	$a_team_id,
		int	$a_action,
		?string	$a_details = `null`
	)

static

Add entry to team log.

Definition at line 287 of file class.ilExAssignmentTeam.php.

     : void {
        global $DIC;
 
        $ilDB = $DIC->database();
        $ilUser = $DIC->user();
        $id = $ilDB->nextId('il_exc_team_log');
 
        $fields = array(
            "log_id" => array("integer", $id),
            "team_id" => array("integer", $a_team_id),
            "user_id" => array("integer", $ilUser->getId()),
            "action" => array("integer", $a_action),
            "details" => array("text", $a_details),
            "tstamp" => array("integer", time())
        );
 
        $ilDB->insert("il_exc_team_log", $fields);
    }