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.

public

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

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

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

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.

Referenced by generateOverview().

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

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.

References getAccessFilteredParticipantList().

Referenced by loadRows().

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

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.

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

Referenced by __construct().

     {
         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']);
         }
     }

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.

References $accessFilteredParticipantList.

Referenced by __construct(), and checkParticipantAccess().

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

Here is the caller graph for this function:

◆ getDatasets()

ilTestEvaluationData::getDatasets ( )

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

References $datasets.

                                  : int
     {
         return $this->datasets;
     }

◆ getParticipant()

ilTestEvaluationData::getParticipant ( $active_id )

Parameters

integer $active_id

Returns: ilTestEvaluationUserData

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

Referenced by generateOverview().

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

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.

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

                                      : 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;
         }
     }

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.

References $questionTitles.

                                        : array
     {
         return $this->questionTitles;
     }

◆ getStatistics()

ilTestEvaluationData::getStatistics ( )

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

References $statistics.

                                    : object
     {
         return $this->statistics;
     }

◆ getTest()

ilTestEvaluationData::getTest ( )

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

References $test.

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

                              : ilObjTest
     {
         return $this->test;
     }

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.

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

Referenced by generateOverview().

                                  : 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;
     }

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.

Referenced by generateOverview().

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

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.

References $accessFilteredParticipantList.

Referenced by __construct().

     {
         $this->accessFilteredParticipantList = $accessFilteredParticipantList;
     }

Here is the caller graph for this function:

◆ setDatasets()

ilTestEvaluationData::setDatasets ( $datasets )

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

References $datasets.

     {
         $this->datasets = $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.

References $arrFilter.

     {
         $this->arrFilter = $arrFilter;
     }

◆ setTest()

ilTestEvaluationData::setTest ( $test )

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

References $test.

     {
         $this->test = &$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