Collaboration diagram for ilTestEvaluationData:

Public Member Functions
	__sleep ()

	__construct (ilObjTest $test=null)
	Constructor. More...

	getAccessFilteredParticipantList ()

	setAccessFilteredParticipantList ($accessFilteredParticipantList)

	generateOverview ()

	getTest ()

	setTest ($test)

	setDatasets ($datasets)

	getDatasets ()

	addQuestionTitle ($question_id, $question_title)

	getQuestionTitles ()

	getQuestionTitle ($question_id)

	calculateStatistics ()

	getTotalFinishedParticipants ()

	getParticipants ()

	resetFilter ()

	setFilter ($by, $text)

	setFilterArray ($arrFilter)

	addParticipant ($active_id, $participant)

	getParticipant ($active_id)

	participantExists ($active_id)

	removeParticipant ($active_id)

	getStatistics ()

	getParticipantIds ()

Data Fields
	$questionTitles

	$participants

	$statistics

	$arrFilter

	$datasets

Protected Member Functions
	checkParticipantAccess ($activeId)

	loadRows ()

Protected Attributes
	$accessFilteredParticipantList

Private Attributes
	$test

Detailed Description

Definition at line 29 of file class.ilTestEvaluationData.php.

Constructor & Destructor Documentation

◆ __construct()

ilTestEvaluationData::__construct ( ilObjTest $test = null )

Constructor.

@access public

Definition at line 87 of file class.ilTestEvaluationData.php.

    {
        $this->participants = array();
        $this->questionTitles = array();
        if ($test !== null) {
            $this->test = $test;
 
            if ($this->getTest()->getAccessFilteredParticipantList()) {
                $this->setAccessFilteredParticipantList(
                    $this->getTest()->getAccessFilteredParticipantList()
                );
            }
 
            $this->generateOverview();
        }
    }

References $test, generateOverview(), getAccessFilteredParticipantList(), getTest(), and setAccessFilteredParticipantList().

Here is the call graph for this function:

Member Function Documentation

◆ __sleep()

ilTestEvaluationData::__sleep ( )

Definition at line 77 of file class.ilTestEvaluationData.php.

    {
        return array('questionTitles', 'participants', 'statistics', 'arrFilter', 'datasets', 'test');
    }

◆ addParticipant()

ilTestEvaluationData::addParticipant	(	$active_id,
		$participant
	)

Definition at line 378 of file class.ilTestEvaluationData.php.

    {
        $this->participants[$active_id] = $participant;
    }

Referenced by generateOverview().

Here is the caller graph for this function:

◆ addQuestionTitle()

ilTestEvaluationData::addQuestionTitle	(	$question_id,
		$question_title
	)

Definition at line 249 of file class.ilTestEvaluationData.php.

    {
        $this->questionTitles[$question_id] = $question_title;
    }

◆ calculateStatistics()

ilTestEvaluationData::calculateStatistics ( )

Definition at line 268 of file class.ilTestEvaluationData.php.

    {
        include_once "./Modules/Test/classes/class.ilTestStatistics.php";
        $this->statistics = new ilTestStatistics($this);
    }

◆ checkParticipantAccess()

ilTestEvaluationData::checkParticipantAccess ( $activeId )

protected

Definition at line 117 of file class.ilTestEvaluationData.php.

                                                        : bool
    {
        if ($this->getAccessFilteredParticipantList() === null) {
            return true;
        }
 
        return $this->getAccessFilteredParticipantList()->isActiveIdInList($activeId);
    }

References getAccessFilteredParticipantList().

Referenced by loadRows().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ generateOverview()

ilTestEvaluationData::generateOverview ( )

Definition at line 170 of file class.ilTestEvaluationData.php.

    {
        include_once "./Modules/Test/classes/class.ilTestEvaluationPassData.php";
        include_once "./Modules/Test/classes/class.ilTestEvaluationUserData.php";
 
        $this->participants = array();
 
        $pass = null;
        $checked = array();
        $thissets = 0;
 
        foreach ($this->loadRows() as $row) {
            $thissets++;
 
            $remove = false;
 
            if (!$this->participantExists($row["active_fi"])) {
                $this->addParticipant($row["active_fi"], new ilTestEvaluationUserData($this->getTest()->getPassScoring()));
 
                $this->getParticipant($row["active_fi"])->setName(
                    $this->getTest()->buildName($row["usr_id"], $row["firstname"], $row["lastname"], $row["title"])
                );
 
                $this->getParticipant($row["active_fi"])->setLogin($row["login"]);
 
                $this->getParticipant($row["active_fi"])->setUserID($row["usr_id"]);
 
                $this->getParticipant($row["active_fi"])->setSubmitted($row['submitted']);
 
                $this->getParticipant($row["active_fi"])->setLastFinishedPass($row['last_finished_pass']);
            }
 
            if (!is_object($this->getParticipant($row["active_fi"])->getPass($row["pass"]))) {
                $pass = new ilTestEvaluationPassData();
                $pass->setPass($row["pass"]);
                $this->getParticipant($row["active_fi"])->addPass($row["pass"], $pass);
            }
 
            $this->getParticipant($row["active_fi"])->getPass($row["pass"])->setReachedPoints((float) $row["points"]);
            $this->getParticipant($row["active_fi"])->getPass($row["pass"])->setObligationsAnswered($row["obligations_answered"]);
 
            if ($row["questioncount"] == 0) {
                $data = ilObjTest::_getQuestionCountAndPointsForPassOfParticipant($row['active_fi'], $row['pass']);
                $this->getParticipant($row["active_fi"])->getPass($row["pass"])->setMaxPoints($data['points']);
                $this->getParticipant($row["active_fi"])->getPass($row["pass"])->setQuestionCount($data['count']);
            } else {
                $this->getParticipant($row["active_fi"])->getPass($row["pass"])->setMaxPoints($row["maxpoints"]);
                $this->getParticipant($row["active_fi"])->getPass($row["pass"])->setQuestionCount($row["questioncount"]);
            }
 
            $this->getParticipant($row["active_fi"])->getPass($row["pass"])->setNrOfAnsweredQuestions($row["answeredquestions"]);
            $this->getParticipant($row["active_fi"])->getPass($row["pass"])->setWorkingTime($row["workingtime"]);
            $this->getParticipant($row["active_fi"])->getPass($row["pass"])->setExamId((string) $row["exam_id"]);
 
            $this->getParticipant($row['active_fi'])->getPass($row['pass'])->setRequestedHintsCount($row['hint_count']);
            $this->getParticipant($row['active_fi'])->getPass($row['pass'])->setDeductedHintPoints($row['hint_points']);
        }
    }

References $data, ilObjTest\_getQuestionCountAndPointsForPassOfParticipant(), addParticipant(), getParticipant(), getTest(), loadRows(), and participantExists().

Referenced by __construct().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getAccessFilteredParticipantList()

ilTestEvaluationData::getAccessFilteredParticipantList ( )

Definition at line 104 of file class.ilTestEvaluationData.php.

                                                      : ?ilTestParticipantList
    {
        return $this->accessFilteredParticipantList;
    }

References $accessFilteredParticipantList.

Referenced by __construct(), and checkParticipantAccess().

Here is the caller graph for this function:

◆ getDatasets()

ilTestEvaluationData::getDatasets ( )

Definition at line 244 of file class.ilTestEvaluationData.php.

                                 : int
    {
        return $this->datasets;
    }

References $datasets.

◆ getParticipant()

ilTestEvaluationData::getParticipant ( $active_id )

Parameters

integer $active_id

Returns: ilTestEvaluationUserData

Definition at line 387 of file class.ilTestEvaluationData.php.

                                              : ilTestEvaluationUserData
    {
        return $this->participants[$active_id];
    }

Referenced by generateOverview().

Here is the caller graph for this function:

◆ getParticipantIds()

ilTestEvaluationData::getParticipantIds ( )

Definition at line 407 of file class.ilTestEvaluationData.php.

                                       : array
    {
        return array_keys($this->participants);
    }

◆ getParticipants()

ilTestEvaluationData::getParticipants ( )

Definition at line 289 of file class.ilTestEvaluationData.php.

                                     : array
    {
        if (is_array($this->arrFilter) && count($this->arrFilter) > 0) {
            $filtered_participants = [];
            $courseids = [];
            $groupids = [];
 
            if (array_key_exists('group', $this->arrFilter)) {
                $ids = ilObject::_getIdsForTitle($this->arrFilter['group'], 'grp', true);
                $groupids = array_merge($groupids, $ids);
            }
            if (array_key_exists('course', $this->arrFilter)) {
                $ids = ilObject::_getIdsForTitle($this->arrFilter['course'], 'crs', true);
                $courseids = array_merge($courseids, $ids);
            }
            foreach ($this->participants as $active_id => $participant) {
                $remove = false;
                if (array_key_exists('name', $this->arrFilter)) {
                    if (!(strpos(strtolower($participant->getName()), strtolower((string) $this->arrFilter['name'])) !== false)) {
                        $remove = true;
                    }
                }
                if (!$remove) {
                    if (array_key_exists('group', $this->arrFilter)) {
                        $groups = ilParticipants::_getMembershipByType($participant->getUserID(), ["grp"]);
                        $foundfilter = false;
                        if (count(array_intersect($groupids, $groups))) {
                            $foundfilter = true;
                        }
                        if (!$foundfilter) {
                            $remove = true;
                        }
                    }
                }
                if (!$remove) {
                    if (array_key_exists('course', $this->arrFilter)) {
                        $courses = ilParticipants::_getMembershipByType($participant->getUserID(), ["crs"]);
                        $foundfilter = false;
                        if (count(array_intersect($courseids, $courses))) {
                            $foundfilter = true;
                        }
                        if (!$foundfilter) {
                            $remove = true;
                        }
                    }
                }
                if (!$remove) {
                    if (array_key_exists('active_id', $this->arrFilter)) {
                        if ($active_id != $this->arrFilter['active_id']) {
                            $remove = true;
                        }
                    }
                }
                if (!$remove) {
                    $filtered_participants[$active_id] = $participant;
                }
            }
            return $filtered_participants;
        } else {
            return $this->participants;
        }
    }

References $participants, ilObject\_getIdsForTitle(), and ilParticipants\_getMembershipByType().

Here is the call graph for this function:

◆ getQuestionTitle()

ilTestEvaluationData::getQuestionTitle ( $question_id )

Definition at line 259 of file class.ilTestEvaluationData.php.

    {
        if (array_key_exists($question_id, $this->questionTitles)) {
            return $this->questionTitles[$question_id];
        } else {
            return "";
        }
    }

◆ getQuestionTitles()

ilTestEvaluationData::getQuestionTitles ( )

Definition at line 254 of file class.ilTestEvaluationData.php.

                                       : array
    {
        return $this->questionTitles;
    }

References $questionTitles.

◆ getStatistics()

ilTestEvaluationData::getStatistics ( )

Definition at line 402 of file class.ilTestEvaluationData.php.

                                   : object
    {
        return $this->statistics;
    }

References $statistics.

◆ getTest()

ilTestEvaluationData::getTest ( )

Definition at line 229 of file class.ilTestEvaluationData.php.

                             : ilObjTest
    {
        return $this->test;
    }

References $test.

Referenced by __construct(), generateOverview(), and loadRows().

Here is the caller graph for this function:

◆ getTotalFinishedParticipants()

ilTestEvaluationData::getTotalFinishedParticipants ( )

Definition at line 274 of file class.ilTestEvaluationData.php.

                                                  : int
    {
        $finishedParticipants = 0;
 
        foreach ($this->participants as $active_id => $participant) {
            if (!$participant->isSubmitted()) {
                continue;
            }
 
            $finishedParticipants++;
        }
 
        return $finishedParticipants;
    }

◆ loadRows()

ilTestEvaluationData::loadRows ( )

protected

Definition at line 126 of file class.ilTestEvaluationData.php.

                                 : array
    {
        global $DIC; /* @var ILIAS\DI\Container $DIC */
 
        $query = "
                        SELECT                  usr_data.usr_id,
                                                        usr_data.firstname,
                                                        usr_data.lastname,
                                                        usr_data.title,
                                                        usr_data.login,
                                                        tst_pass_result.*,
                                                        tst_active.submitted,
                                                        tst_active.last_finished_pass
                        FROM                    tst_pass_result, tst_active
                        LEFT JOIN               usr_data
                        ON                              tst_active.user_fi = usr_data.usr_id
                        WHERE                   tst_active.active_id = tst_pass_result.active_fi
                        AND                             tst_active.test_fi = %s
                        ORDER BY                usr_data.lastname,
                                                        usr_data.firstname,
                                                        tst_pass_result.active_fi,
                                                        tst_pass_result.pass,
                                                        tst_pass_result.tstamp
                ";
 
        $result = $DIC->database()->queryF(
            $query,
            array('integer'),
            array($this->getTest()->getTestId())
        );
 
        $rows = array();
 
        while ($row = $DIC->database()->fetchAssoc($result)) {
            if (!$this->checkParticipantAccess($row['active_fi'])) {
                continue;
            }
 
            $rows[] = $row;
        }
 
        return $rows;
    }

References $DIC, $query, $rows, checkParticipantAccess(), and getTest().

Referenced by generateOverview().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ participantExists()

ilTestEvaluationData::participantExists ( $active_id )

Definition at line 392 of file class.ilTestEvaluationData.php.

                                                 : bool
    {
        return array_key_exists($active_id, $this->participants);
    }

Referenced by generateOverview().

Here is the caller graph for this function:

◆ removeParticipant()

ilTestEvaluationData::removeParticipant ( $active_id )

Definition at line 397 of file class.ilTestEvaluationData.php.

    {
        unset($this->participants[$active_id]);
    }

◆ resetFilter()

ilTestEvaluationData::resetFilter ( )

Definition at line 352 of file class.ilTestEvaluationData.php.

    {
        $this->arrFilter = array();
    }

◆ setAccessFilteredParticipantList()

ilTestEvaluationData::setAccessFilteredParticipantList ( $accessFilteredParticipantList )

Parameters

ilTestParticipantList $accessFilteredParticipantList

Definition at line 112 of file class.ilTestEvaluationData.php.

    {
        $this->accessFilteredParticipantList = $accessFilteredParticipantList;
    }

References $accessFilteredParticipantList.

Referenced by __construct().

Here is the caller graph for this function:

◆ setDatasets()

ilTestEvaluationData::setDatasets ( $datasets )

Definition at line 239 of file class.ilTestEvaluationData.php.

    {
        $this->datasets = $datasets;
    }

References $datasets.

◆ setFilter()

ilTestEvaluationData::setFilter	(	$by,
		$text
	)

Definition at line 363 of file class.ilTestEvaluationData.php.

    {
        $this->arrFilter = array($by => $text);
    }

◆ setFilterArray()

ilTestEvaluationData::setFilterArray ( $arrFilter )

Definition at line 373 of file class.ilTestEvaluationData.php.

    {
        $this->arrFilter = $arrFilter;
    }

References $arrFilter.

◆ setTest()

ilTestEvaluationData::setTest ( $test )

Definition at line 234 of file class.ilTestEvaluationData.php.

    {
        $this->test = &$test;
    }

References $test.

Field Documentation

◆ $accessFilteredParticipantList

ilTestEvaluationData::$accessFilteredParticipantList

protected

Definition at line 75 of file class.ilTestEvaluationData.php.

Referenced by getAccessFilteredParticipantList(), and setAccessFilteredParticipantList().

◆ $arrFilter

ilTestEvaluationData::$arrFilter

Definition at line 64 of file class.ilTestEvaluationData.php.

Referenced by setFilterArray().

◆ $datasets

ilTestEvaluationData::$datasets

Definition at line 70 of file class.ilTestEvaluationData.php.

Referenced by getDatasets(), and setDatasets().

◆ $participants

ilTestEvaluationData::$participants

Definition at line 50 of file class.ilTestEvaluationData.php.

Referenced by getParticipants().

◆ $questionTitles

ilTestEvaluationData::$questionTitles

Definition at line 36 of file class.ilTestEvaluationData.php.

Referenced by getQuestionTitles().

◆ $statistics

ilTestEvaluationData::$statistics

Definition at line 57 of file class.ilTestEvaluationData.php.

Referenced by getStatistics().

◆ $test

ilTestEvaluationData::$test

private

Definition at line 43 of file class.ilTestEvaluationData.php.

Referenced by __construct(), getTest(), and setTest().

The documentation for this class was generated from the following file:

Modules/Test/classes/class.ilTestEvaluationData.php

Public Member Functions

Data Fields

Protected Member Functions

Protected Attributes

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ __sleep()

◆ addParticipant()

◆ addQuestionTitle()

◆ calculateStatistics()

◆ checkParticipantAccess()

◆ generateOverview()

◆ getAccessFilteredParticipantList()

◆ getDatasets()

◆ getParticipant()

◆ getParticipantIds()

◆ getParticipants()

◆ getQuestionTitle()

◆ getQuestionTitles()

◆ getStatistics()

◆ getTest()

◆ getTotalFinishedParticipants()

◆ loadRows()

◆ participantExists()

◆ removeParticipant()

◆ resetFilter()

◆ setAccessFilteredParticipantList()

◆ setDatasets()

◆ setFilter()

◆ setFilterArray()

◆ setTest()

Field Documentation

◆ $accessFilteredParticipantList

◆ $arrFilter

◆ $datasets

◆ $participants

◆ $questionTitles

◆ $statistics

◆ $test