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.

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

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

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.

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

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

Here is the caller graph for this function:

◆ getActiveIdsFilter()

ilTestParticipantData::getActiveIdsFilter ( )

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

References $active_ids_filter.

Referenced by getConditionalExpression().

                                         : array
     {
         return $this->active_ids_filter;
     }

Here is the caller graph for this function:

◆ getAnonymousActiveIds()

ilTestParticipantData::getAnonymousActiveIds ( )

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

References ANONYMOUS_USER_ID.

Referenced by ilObjTest\removeTestResults().

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

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.

References $anonymousIdsFilter.

Referenced by getConditionalExpression().

                                            : array
     {
         return $this->anonymousIdsFilter;
     }

Here is the caller graph for this function:

◆ getConditionalExpression()

ilTestParticipantData::getConditionalExpression ( )

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

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

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

Here is the call graph for this function:

◆ getFileSystemCompliantFullnameByActiveId()

ilTestParticipantData::getFileSystemCompliantFullnameByActiveId ( $activeId )

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

References ilFileUtils\getASCIIFilename().

Referenced by ilAssFileUploadUploadsExporter\collectUploadedFiles().

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

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.

References ilObjTestAccess\_getParticipantData().

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

Here is the call graph for this function:

◆ getOptionArray()

ilTestParticipantData::getOptionArray ( )

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

References ilObjTestAccess\_getParticipantData().

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

Here is the call graph for this function:

◆ getParticipantAccessFilter()

ilTestParticipantData::getParticipantAccessFilter ( )

Returns: callable

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

References $participantAccessFilter.

Referenced by load().

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

Here is the caller graph for this function:

◆ getScoredParticipantsFilterExpression()

ilTestParticipantData::getScoredParticipantsFilterExpression ( )

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

References isScoredParticipantsFilterEnabled().

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

Here is the call graph for this function:

◆ getUserDataByActiveId()

ilTestParticipantData::getUserDataByActiveId ( int $active_Id )

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

Referenced by ilTestArchiver\createUserResultsForArchive().

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

Here is the caller graph for this function:

◆ getUserIdByActiveId()

ilTestParticipantData::getUserIdByActiveId ( $activeId )

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

Referenced by ilObjTest\removeTestResults().

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

Here is the caller graph for this function:

◆ getUserIds()

ilTestParticipantData::getUserIds ( )

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

Referenced by ilObjTest\removeTestResults().

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

Here is the caller graph for this function:

◆ getUserIdsFilter()

ilTestParticipantData::getUserIdsFilter ( )

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

References $userIdsFilter.

Referenced by getConditionalExpression().

                                       : array
     {
         return $this->userIdsFilter;
     }

Here is the caller graph for this function:

◆ isScoredParticipantsFilterEnabled()

ilTestParticipantData::isScoredParticipantsFilterEnabled ( )

Returns: bool

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

References $scoredParticipantsFilterEnabled.

Referenced by getScoredParticipantsFilterExpression().

                                                        : bool
     {
         return $this->scoredParticipantsFilterEnabled;
     }

Here is the caller graph for this function:

◆ load()

ilTestParticipantData::load ( $testId )

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

References $res, ANONYMOUS_USER_ID, and getParticipantAccessFilter().

Referenced by ilTestArchiver\createUserResultsForArchive().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setActiveIdsFilter()

ilTestParticipantData::setActiveIdsFilter ( array $active_ids_filter )

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

References $active_ids_filter.

Referenced by ilTestArchiver\createUserResultsForArchive().

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

Here is the caller graph for this function:

◆ setAnonymousIdsFilter()

ilTestParticipantData::setAnonymousIdsFilter ( $anonymousIdsFilter )

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

References $anonymousIdsFilter.

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

◆ setParticipantAccessFilter()

ilTestParticipantData::setParticipantAccessFilter ( Closure $participantAccessFilter )

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

References $participantAccessFilter.

Referenced by ilTestArchiver\createUserResultsForArchive().

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

Here is the caller graph for this function:

◆ setScoredParticipantsFilterEnabled()

ilTestParticipantData::setScoredParticipantsFilterEnabled ( $scoredParticipantsFilterEnabled )

Parameters

bool $scoredParticipantsFilterEnabled

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

References $scoredParticipantsFilterEnabled.

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

◆ setUserIdsFilter()

ilTestParticipantData::setUserIdsFilter ( $userIdsFilter )

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

References $userIdsFilter.

                                                     : void
     {
         $this->userIdsFilter = $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