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)

	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	$statistics = null

array	$arr_filter = null

int	$datasets

Private Member Functions
	orderParticipants (array $participants)

Detailed Description

Deprecated:: 11; Result/EvaluationData will be refined.

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

Constructor & Destructor Documentation

◆ __construct()

ilTestEvaluationData::__construct ( protected array $participants )

Parameters

array<ilTestEvaluationUserData> $participants

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

50 {

51 }

Member Function Documentation

◆ __sleep()

ilTestEvaluationData::__sleep ( )

Definition at line 40 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 63 of file class.ilTestEvaluationData.php.

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

Referenced by ilTestEvaluationFactory\addQuestionsToParticipantPasses().

Here is the caller graph for this function:

◆ getDatasets()

ilTestEvaluationData::getDatasets ( )

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

                                 : int
    {
        return $this->datasets;
    }

References $datasets.

◆ getParticipant()

ilTestEvaluationData::getParticipant ( int $active_id )

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

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

Referenced by ILIAS\Test\Statistics\Statistics\__construct(), ilTestEvaluationFactory\addMarksToParticipants(), and ilTestEvaluationFactory\addQuestionsToParticipantPasses().

Here is the caller graph for this function:

◆ getParticipantIds()

ilTestEvaluationData::getParticipantIds ( )

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

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

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

Here is the caller graph for this function:

◆ getParticipants()

ilTestEvaluationData::getParticipants ( )

Returns: array<ilTestEvaluationUserData>

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

                                     : 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 $this->orderParticipants($filtered_participants);
        }
 
        return $this->orderParticipants($this->participants);
    }

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

Referenced by ILIAS\Test\Statistics\Statistics\__construct().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getQuestionTitle()

ilTestEvaluationData::getQuestionTitle ( ?int $question_id )

Definition at line 76 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 71 of file class.ilTestEvaluationData.php.

                                       : array
    {
        return $this->question_titles;
    }

References $question_titles.

◆ getStatistics()

ilTestEvaluationData::getStatistics ( )

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

                                   : Statistics
    {
        if ($this->statistics === null) {
            $this->statistics = new Statistics($this);
        }
        return $this->statistics;
    }

References $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;
    }

◆ orderParticipants()

ilTestEvaluationData::orderParticipants ( array $participants )

private

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

                                                           : array
    {
        uasort($participants, static fn($a, $b) => $a->getName() <=> $b->getName());
        return $participants;
    }

References Vendor\Package\$a, and Vendor\Package\$b.

Referenced by getParticipants().

Here is the caller graph for this function:

◆ 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 53 of file class.ilTestEvaluationData.php.

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

References $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.

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

References $arr_filter.

Field Documentation

◆ $arr_filter

array ilTestEvaluationData::$arr_filter = null

protected

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

Referenced by setFilterArray().

◆ $datasets

int ilTestEvaluationData::$datasets

protected

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

Referenced by getDatasets(), and setDatasets().

◆ $question_titles

array ilTestEvaluationData::$question_titles = []

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

Referenced by getQuestionTitles().

◆ $statistics

Statistics ilTestEvaluationData::$statistics = null

protected

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

Referenced by getStatistics().

◆ FILTER_BY_ACTIVE_ID

const ilTestEvaluationData::FILTER_BY_ACTIVE_ID = 'active_id'

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

Referenced by ILIAS\Test\ExportImport\ResultsExportExcel\withFilterByActiveId().

◆ FILTER_BY_COURSE

const ilTestEvaluationData::FILTER_BY_COURSE = 'course'

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

◆ FILTER_BY_GROUP

const ilTestEvaluationData::FILTER_BY_GROUP = 'group'

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

◆ FILTER_BY_NAME

const ilTestEvaluationData::FILTER_BY_NAME = 'name'

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

◆ FILTER_BY_NONE

const ilTestEvaluationData::FILTER_BY_NONE = ''

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

Referenced by ILIAS\Test\ExportImport\ResultsExportExcel\getCompleteData().

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

components/ILIAS/Test/classes/Evaluation/class.ilTestEvaluationData.php

Public Member Functions

Data Fields

Protected Attributes

Private Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ __sleep()

◆ addParticipant()

◆ addQuestionTitle()

◆ getDatasets()

◆ getParticipant()

◆ getParticipantIds()

◆ getParticipants()

◆ getQuestionTitle()

◆ getQuestionTitles()

◆ getStatistics()

◆ getTotalFinishedParticipants()

◆ orderParticipants()

◆ 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