Collaboration diagram for ilTestEvaluationData:

Public Member Functions
	__sleep ()

	__construct (protected array $participants)

	setDatasets (int $datasets)

	getDatasets ()

	addQuestionTitle (int $question_id, string $question_title)

	getQuestionTitles ()

	getQuestionTitle (?int $question_id)

	calculateStatistics ()

	getTotalFinishedParticipants ()

	getParticipants ()

	resetFilter ()

	setFilter (string $by, string $text)

	setFilterArray (array $arr_filter)

	addParticipant (int $active_id, ilTestEvaluationUserData $participant)

	getParticipant (int $active_id)

	participantExists ($active_id)

	removeParticipant ($active_id)

	getStatistics ()

	getParticipantIds ()

Data Fields
const	FILTER_BY_NONE = ''

const	FILTER_BY_NAME = 'name'

const	FILTER_BY_GROUP = 'group'

const	FILTER_BY_COURSE = 'course'

const	FILTER_BY_ACTIVE_ID = 'active_id'

array	$question_titles = []

Protected Attributes
	$statistics

array	$arr_filter = null

int	$datasets

Detailed Description

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

Constructor & Destructor Documentation

◆ __construct()

ilTestEvaluationData::__construct ( protected array $participants )

Parameters

array<ilTestEvaluationUserData> $participants

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

45 {

46 }

Member Function Documentation

◆ __sleep()

ilTestEvaluationData::__sleep ( )

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

                              : array
     {
         return ['question_titles', 'participants', 'statistics', 'arr_filter', 'datasets', 'test'];
     }

◆ addParticipant()

ilTestEvaluationData::addParticipant	(	int	$active_id,
		ilTestEvaluationUserData	$participant
	)

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

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

◆ addQuestionTitle()

ilTestEvaluationData::addQuestionTitle	(	int	$question_id,
		string	$question_title
	)

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

Referenced by ilTestEvaluationFactory\addQuestionsToParticipantPasses().

                                                                               : void
     {
         $this->question_titles[$question_id] = $question_title;
     }

Here is the caller graph for this function:

◆ calculateStatistics()

ilTestEvaluationData::calculateStatistics ( )

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

                                          : void
     {
         $this->statistics = new ilTestStatistics($this);
     }

◆ getDatasets()

ilTestEvaluationData::getDatasets ( )

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

References $datasets.

                                  : int
     {
         return $this->datasets;
     }

◆ getParticipant()

ilTestEvaluationData::getParticipant ( int $active_id )

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

Referenced by ilTestEvaluationFactory\addMarksToParticipants(), and ilTestEvaluationFactory\addQuestionsToParticipantPasses().

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

Here is the caller graph for this function:

◆ getParticipantIds()

ilTestEvaluationData::getParticipantIds ( )

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

Referenced by ilTestEvaluationFactory\addMarksToParticipants(), and ilTestEvaluationFactory\addQuestionsToParticipantPasses().

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

Here is the caller graph for this function:

◆ getParticipants()

ilTestEvaluationData::getParticipants ( )

Returns: array<ilTestEvaluationUserData>

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

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

                                      : array
     {
         if (is_array($this->arr_filter) && count($this->arr_filter) > 0) {
             $filtered_participants = [];
             $courseids = [];
             $groupids = [];
 
             if (array_key_exists(self::FILTER_BY_GROUP, $this->arr_filter)) {
                 $ids = ilObject::_getIdsForTitle($this->arr_filter[self::FILTER_BY_GROUP], 'grp', true);
                 $groupids = array_merge($groupids, $ids);
             }
             if (array_key_exists(self::FILTER_BY_COURSE, $this->arr_filter)) {
                 $ids = ilObject::_getIdsForTitle($this->arr_filter[self::FILTER_BY_COURSE], 'crs', true);
                 $courseids = array_merge($courseids, $ids);
             }
             foreach ($this->participants as $active_id => $participant) {
                 $remove = false;
                 if (array_key_exists(self::FILTER_BY_NAME, $this->arr_filter)) {
                     if (!(strpos(strtolower($participant->getName()), strtolower((string) $this->arr_filter[self::FILTER_BY_NAME])) !== false)) {
                         $remove = true;
                     }
                 }
                 if (!$remove) {
                     if (array_key_exists(self::FILTER_BY_GROUP, $this->arr_filter)) {
                         $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(self::FILTER_BY_COURSE, $this->arr_filter)) {
                         $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(self::FILTER_BY_ACTIVE_ID, $this->arr_filter)) {
                         if ($active_id != $this->arr_filter[self::FILTER_BY_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 ( ?int $question_id )

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

                                                        : string
     {
         if (array_key_exists($question_id, $this->question_titles)) {
             return $this->question_titles[$question_id];
         }
 
         return '';
     }

◆ getQuestionTitles()

ilTestEvaluationData::getQuestionTitles ( )

Returns: array<string>

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

References $question_titles.

                                        : array
     {
         return $this->question_titles;
     }

◆ getStatistics()

ilTestEvaluationData::getStatistics ( )

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

References $statistics.

                                    : object
     {
         return $this->statistics;
     }

◆ getTotalFinishedParticipants()

ilTestEvaluationData::getTotalFinishedParticipants ( )

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

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

◆ participantExists()

ilTestEvaluationData::participantExists ( $active_id )

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

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

◆ removeParticipant()

ilTestEvaluationData::removeParticipant ( $active_id )

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

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

◆ resetFilter()

ilTestEvaluationData::resetFilter ( )

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

                                  : void
     {
         $this->arr_filter = [];
     }

◆ setDatasets()

ilTestEvaluationData::setDatasets ( int $datasets )

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

References $datasets.

                                               : void
     {
         $this->datasets = $datasets;
     }

◆ setFilter()

ilTestEvaluationData::setFilter	(	string	$by,
		string	$text
	)

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

                                                        : void
     {
         if (in_array(
             $by,
             [self::FILTER_BY_ACTIVE_ID, self::FILTER_BY_NAME, self::FILTER_BY_COURSE, self::FILTER_BY_GROUP],
             true
         )) {
             $this->arr_filter = [$by => $text];
         }
     }

◆ setFilterArray()

ilTestEvaluationData::setFilterArray ( array $arr_filter )

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

References $arr_filter.

                                                      : void
     {
         $this->arr_filter = $arr_filter;
     }

Field Documentation

◆ $arr_filter

array ilTestEvaluationData::$arr_filter = null

protected

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

Referenced by setFilterArray().

◆ $datasets

int ilTestEvaluationData::$datasets

protected

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

Referenced by getDatasets(), and setDatasets().

◆ $question_titles

array ilTestEvaluationData::$question_titles = []

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

Referenced by getQuestionTitles().

◆ $statistics

ilTestEvaluationData::$statistics

protected

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

Referenced by getStatistics().

◆ FILTER_BY_ACTIVE_ID

const ilTestEvaluationData::FILTER_BY_ACTIVE_ID = 'active_id'

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

Referenced by ilObjTest\sendAdvancedNotification().

◆ FILTER_BY_COURSE

const ilTestEvaluationData::FILTER_BY_COURSE = 'course'

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

◆ FILTER_BY_GROUP

const ilTestEvaluationData::FILTER_BY_GROUP = 'group'

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

◆ FILTER_BY_NAME

const ilTestEvaluationData::FILTER_BY_NAME = 'name'

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

◆ FILTER_BY_NONE

const ilTestEvaluationData::FILTER_BY_NONE = ''

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

Referenced by ilTestExport\buildExportResultFile(), ilTestEvaluationGUI\exportAggregatedResults(), and ilTestEvaluationGUI\exportEvaluation().

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

Modules/Test/classes/Evaluation/class.ilTestEvaluationData.php

Public Member Functions

Data Fields

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ __sleep()

◆ addParticipant()

◆ addQuestionTitle()

◆ calculateStatistics()

◆ getDatasets()

◆ getParticipant()

◆ getParticipantIds()

◆ getParticipants()

◆ getQuestionTitle()

◆ getQuestionTitles()

◆ getStatistics()

◆ getTotalFinishedParticipants()

◆ participantExists()

◆ removeParticipant()

◆ resetFilter()

◆ setDatasets()

◆ setFilter()

◆ setFilterArray()

Field Documentation

◆ $arr_filter

◆ $datasets

◆ $question_titles

◆ $statistics

◆ FILTER_BY_ACTIVE_ID

◆ FILTER_BY_COURSE

◆ FILTER_BY_GROUP

◆ FILTER_BY_NAME

◆ FILTER_BY_NONE