Collaboration diagram for ilTestParticipantData:

Public Member Functions
	__construct (ilDBInterface $db, ilLanguage $lng)

	getParticipantAccessFilter ()

	setParticipantAccessFilter (Closure $participantAccessFilter)

	isScoredParticipantsFilterEnabled ()

	setScoredParticipantsFilterEnabled ($scoredParticipantsFilterEnabled)

	load ($testId)

	getScoredParticipantsFilterExpression ()

	getConditionalExpression ()

	setActiveIdsFilter (array $active_ids_filter)

	getActiveIdsFilter ()

	setUserIdsFilter ($userIdsFilter)

	getUserIdsFilter ()

	setAnonymousIdsFilter ($anonymousIdsFilter)

	getAnonymousIdsFilter ()

	getActiveIds ()

	getUserIds ()

	getAnonymousIds ()

	getUserIdByActiveId ($activeId)

	getActiveIdByUserId ($userId)

	getFormatedFullnameByActiveId ($activeId)

	getFileSystemCompliantFullnameByActiveId ($activeId)

	getOptionArray ()

	getAnonymousActiveIds ()

	getUserDataByActiveId (int $active_Id)

Protected Attributes
	$db

	$lng

	$participantAccessFilter

bool	$scoredParticipantsFilterEnabled

Private Attributes
array	$active_ids_filter

array	$userIdsFilter

array	$anonymousIdsFilter

array	$byActiveId

array	$byUserId

array	$byAnonymousId

Detailed Description

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

Constructor & Destructor Documentation

◆ __construct()

ilTestParticipantData::__construct	(	ilDBInterface	$db,
		ilLanguage	$lng
	)

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

    {
        $this->db = $db;
        $this->lng = $lng;
 
        $this->active_ids_filter = [];
        $this->userIdsFilter = [];
        $this->anonymousIdsFilter = [];
 
        $this->byActiveId = [];
        $this->byUserId = [];
        $this->byAnonymousId = [];
 
        $this->scoredParticipantsFilterEnabled = false;
    }

References $db, $lng, and ILIAS\Repository\lng().

Here is the call graph for this function:

Member Function Documentation

◆ getActiveIdByUserId()

ilTestParticipantData::getActiveIdByUserId ( $userId )

Definition at line 235 of file class.ilTestParticipantData.php.

    {
        return $this->byUserId[$userId]['active_id'] ?? null;
    }

◆ getActiveIds()

ilTestParticipantData::getActiveIds ( )

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

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

Referenced by ilAssFileUploadUploadsExporter\collectUploadedFiles(), and ilObjTest\removeTestResults().

Here is the caller graph for this function:

◆ getActiveIdsFilter()

ilTestParticipantData::getActiveIdsFilter ( )

Definition at line 190 of file class.ilTestParticipantData.php.

                                        : array
    {
        return $this->active_ids_filter;
    }

References $active_ids_filter.

Referenced by getConditionalExpression().

Here is the caller graph for this function:

◆ getAnonymousActiveIds()

ilTestParticipantData::getAnonymousActiveIds ( )

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

                                           : array
    {
        $anonymousActiveIds = [];
 
        foreach ($this->byActiveId as $activeId => $active) {
            if ($active['user_id'] == ANONYMOUS_USER_ID) {
                $anonymousActiveIds[] = $activeId;
            }
        }
 
        return $anonymousActiveIds;
    }

References ANONYMOUS_USER_ID.

Referenced by ilObjTest\removeTestResults().

Here is the caller graph for this function:

◆ getAnonymousIds()

ilTestParticipantData::getAnonymousIds ( )

Definition at line 225 of file class.ilTestParticipantData.php.

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

◆ getAnonymousIdsFilter()

ilTestParticipantData::getAnonymousIdsFilter ( )

Definition at line 210 of file class.ilTestParticipantData.php.

                                           : array
    {
        return $this->anonymousIdsFilter;
    }

References $anonymousIdsFilter.

Referenced by getConditionalExpression().

Here is the caller graph for this function:

◆ getConditionalExpression()

ilTestParticipantData::getConditionalExpression ( )

Definition at line 162 of file class.ilTestParticipantData.php.

                                              : string
    {
        $conditions = [];
 
        if (count($this->getActiveIdsFilter())) {
            $conditions[] = $this->db->in('active_id', $this->getActiveIdsFilter(), false, 'integer');
        }
 
        if (count($this->getUserIdsFilter())) {
            $conditions[] = $this->db->in('user_fi', $this->getUserIdsFilter(), false, 'integer');
        }
 
        if (count($this->getAnonymousIdsFilter())) {
            $conditions[] = $this->db->in('anonymous_id', $this->getAnonymousIdsFilter(), false, 'integer');
        }
 
        if (count($conditions)) {
            return '(' . implode(' OR ', $conditions) . ')';
        }
 
        return '1 = 1';
    }

References getActiveIdsFilter(), getAnonymousIdsFilter(), and getUserIdsFilter().

Here is the call graph for this function:

◆ getFileSystemCompliantFullnameByActiveId()

ilTestParticipantData::getFileSystemCompliantFullnameByActiveId ( $activeId )

Definition at line 245 of file class.ilTestParticipantData.php.

                                                                       : string
    {
        $fullname = str_replace(' ', '', $this->byActiveId[$activeId]['lastname']);
        $fullname .= '_' . str_replace(' ', '', $this->byActiveId[$activeId]['firstname']);
        $fullname .= '_' . $this->byActiveId[$activeId]['login'];
 
        return ilFileUtils::getASCIIFilename($fullname);
    }

References ilFileUtils\getASCIIFilename().

Referenced by ilAssFileUploadUploadsExporter\collectUploadedFiles().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getFormatedFullnameByActiveId()

ilTestParticipantData::getFormatedFullnameByActiveId ( $activeId )

Definition at line 240 of file class.ilTestParticipantData.php.

                                                            : string
    {
        return ilObjTestAccess::_getParticipantData($activeId);
    }

References ilObjTestAccess\_getParticipantData().

Here is the call graph for this function:

◆ getOptionArray()

ilTestParticipantData::getOptionArray ( )

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

                                    : array
    {
        $options = [];
 
        foreach ($this->byActiveId as $activeId => $usrData) {
            $options[$activeId] = ilObjTestAccess::_getParticipantData($activeId);
        }
 
        asort($options);
 
        return $options;
    }

References ilObjTestAccess\_getParticipantData().

Here is the call graph for this function:

◆ getParticipantAccessFilter()

ilTestParticipantData::getParticipantAccessFilter ( )

Returns: callable

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

                                                : ?Closure
    {
        return $this->participantAccessFilter;
    }

References $participantAccessFilter.

Referenced by load().

Here is the caller graph for this function:

◆ getScoredParticipantsFilterExpression()

ilTestParticipantData::getScoredParticipantsFilterExpression ( )

Definition at line 153 of file class.ilTestParticipantData.php.

                                                           : string
    {
        if ($this->isScoredParticipantsFilterEnabled()) {
            return "ta.last_finished_pass = ta.last_started_pass";
        }
 
        return '1 = 1';
    }

References isScoredParticipantsFilterEnabled().

Here is the call graph for this function:

◆ getUserDataByActiveId()

ilTestParticipantData::getUserDataByActiveId ( int $active_Id )

Definition at line 280 of file class.ilTestParticipantData.php.

                                                         : array
    {
        if (isset($this->byActiveId[$active_Id])) {
            return $this->byActiveId[$active_Id];
        }
 
        return null;
    }

◆ getUserIdByActiveId()

ilTestParticipantData::getUserIdByActiveId ( $activeId )

Definition at line 230 of file class.ilTestParticipantData.php.

    {
        return $this->byActiveId[$activeId]['user_id'];
    }

Referenced by ilObjTest\removeTestResults().

Here is the caller graph for this function:

◆ getUserIds()

ilTestParticipantData::getUserIds ( )

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

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

Referenced by ilObjTest\removeTestResults().

Here is the caller graph for this function:

◆ getUserIdsFilter()

ilTestParticipantData::getUserIdsFilter ( )

Definition at line 200 of file class.ilTestParticipantData.php.

                                      : array
    {
        return $this->userIdsFilter;
    }

References $userIdsFilter.

Referenced by getConditionalExpression().

Here is the caller graph for this function:

◆ isScoredParticipantsFilterEnabled()

ilTestParticipantData::isScoredParticipantsFilterEnabled ( )

Returns: bool

Definition at line 90 of file class.ilTestParticipantData.php.

                                                       : bool
    {
        return $this->scoredParticipantsFilterEnabled;
    }

References $scoredParticipantsFilterEnabled.

Referenced by getScoredParticipantsFilterExpression().

Here is the caller graph for this function:

◆ load()

ilTestParticipantData::load ( $testId )

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

                                 : void
    {
        $this->byActiveId = [];
        $this->byUserId = [];
 
        $query = "
                        SELECT          ta.active_id,
                                                ta.user_fi user_id,
                                                ta.anonymous_id,
                                                ud.firstname,
                                                ud.lastname,
                                                ud.login,
                                                ud.matriculation
                        FROM            tst_active ta
                        LEFT JOIN       usr_data ud
                        ON                      ud.usr_id = ta.user_fi
                        WHERE           test_fi = %s
                        AND                     {$this->getConditionalExpression()}
                        AND             {$this->getScoredParticipantsFilterExpression()}
                ";
 
        $res = $this->db->queryF($query, ['integer'], [$testId]);
 
        $rows = [];
        $accessFilteredUsrIds = [];
 
        while ($row = $this->db->fetchAssoc($res)) {
            $accessFilteredUsrIds[] = $row['user_id'];
            $rows[] = $row;
        }
 
        if (is_callable($this->getParticipantAccessFilter(), true)) {
            $accessFilteredUsrIds = call_user_func_array($this->getParticipantAccessFilter(), [$accessFilteredUsrIds]);
        }
 
        foreach ($rows as $row) {
            if (!in_array($row['user_id'], $accessFilteredUsrIds)) {
                continue;
            }
 
            $this->byActiveId[ $row['active_id'] ] = $row;
 
            if ($row['user_id'] == ANONYMOUS_USER_ID) {
                $this->byAnonymousId[ $row['anonymous_id'] ] = $row;
            } else {
                $this->byUserId[ $row['user_id'] ] = $row;
            }
        }
    }

References $res, ANONYMOUS_USER_ID, and getParticipantAccessFilter().

Here is the call graph for this function:

◆ setActiveIdsFilter()

ilTestParticipantData::setActiveIdsFilter ( array $active_ids_filter )

Definition at line 185 of file class.ilTestParticipantData.php.

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

References $active_ids_filter.

◆ setAnonymousIdsFilter()

ilTestParticipantData::setAnonymousIdsFilter ( $anonymousIdsFilter )

Definition at line 205 of file class.ilTestParticipantData.php.

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

References $anonymousIdsFilter.

◆ setParticipantAccessFilter()

ilTestParticipantData::setParticipantAccessFilter ( Closure $participantAccessFilter )

Definition at line 82 of file class.ilTestParticipantData.php.

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

References $participantAccessFilter.

◆ setScoredParticipantsFilterEnabled()

ilTestParticipantData::setScoredParticipantsFilterEnabled ( $scoredParticipantsFilterEnabled )

Parameters

bool $scoredParticipantsFilterEnabled

Definition at line 98 of file class.ilTestParticipantData.php.

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

References $scoredParticipantsFilterEnabled.

◆ setUserIdsFilter()

ilTestParticipantData::setUserIdsFilter ( $userIdsFilter )

Definition at line 195 of file class.ilTestParticipantData.php.

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

References $userIdsFilter.

Field Documentation

◆ $active_ids_filter

array ilTestParticipantData::$active_ids_filter

private

Definition at line 39 of file class.ilTestParticipantData.php.

Referenced by getActiveIdsFilter(), and setActiveIdsFilter().

◆ $anonymousIdsFilter

array ilTestParticipantData::$anonymousIdsFilter

private

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

Referenced by getAnonymousIdsFilter(), and setAnonymousIdsFilter().

◆ $byActiveId

array ilTestParticipantData::$byActiveId

private

Definition at line 45 of file class.ilTestParticipantData.php.

◆ $byAnonymousId

array ilTestParticipantData::$byAnonymousId

private

Definition at line 49 of file class.ilTestParticipantData.php.

◆ $byUserId

array ilTestParticipantData::$byUserId

private

Definition at line 47 of file class.ilTestParticipantData.php.

◆ $db

ilTestParticipantData::$db

protected

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

Referenced by __construct().

◆ $lng

ilTestParticipantData::$lng

protected

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

Referenced by __construct().

◆ $participantAccessFilter

ilTestParticipantData::$participantAccessFilter

protected

Definition at line 54 of file class.ilTestParticipantData.php.

Referenced by getParticipantAccessFilter(), and setParticipantAccessFilter().

◆ $scoredParticipantsFilterEnabled

bool ilTestParticipantData::$scoredParticipantsFilterEnabled

protected

Definition at line 56 of file class.ilTestParticipantData.php.

Referenced by isScoredParticipantsFilterEnabled(), and setScoredParticipantsFilterEnabled().

◆ $userIdsFilter

array ilTestParticipantData::$userIdsFilter

private

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

Referenced by getUserIdsFilter(), and setUserIdsFilter().

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

components/ILIAS/Test/classes/class.ilTestParticipantData.php

Public Member Functions

Protected Attributes

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ getActiveIdByUserId()

◆ getActiveIds()

◆ getActiveIdsFilter()

◆ getAnonymousActiveIds()

◆ getAnonymousIds()

◆ getAnonymousIdsFilter()

◆ getConditionalExpression()

◆ getFileSystemCompliantFullnameByActiveId()

◆ getFormatedFullnameByActiveId()

◆ getOptionArray()

◆ getParticipantAccessFilter()

◆ getScoredParticipantsFilterExpression()

◆ getUserDataByActiveId()

◆ getUserIdByActiveId()

◆ getUserIds()

◆ getUserIdsFilter()

◆ isScoredParticipantsFilterEnabled()

◆ load()

◆ setActiveIdsFilter()

◆ setAnonymousIdsFilter()

◆ setParticipantAccessFilter()

◆ setScoredParticipantsFilterEnabled()

◆ setUserIdsFilter()

Field Documentation

◆ $active_ids_filter

◆ $anonymousIdsFilter

◆ $byActiveId

◆ $byAnonymousId

◆ $byUserId

◆ $db

◆ $lng

◆ $participantAccessFilter

◆ $scoredParticipantsFilterEnabled

◆ $userIdsFilter