Collaboration diagram for ilTestPassesSelector:

Public Member Functions
	__construct (private ilDBInterface $db, private ilObjTest $test_obj)

	getActiveId ()

	setActiveId (?int $active_id)

	getLastFinishedPass ()

	setLastFinishedPass (?int $last_finished_pass)

	loadLastFinishedPass ()

	getExistingPasses ()

	hasExistingPasses ()

	getNumExistingPasses ()

	openPassExists ()

	getClosedPasses ()

	getReportablePasses ()

	hasReportablePasses ()

	getLastFinishedPassTimestamp ()

	hasTestPassedOnce (int $active_id)

Private Member Functions
	passesLoaded ()

	ensureLoadedPasses ()

	loadPasses ()

	getLazyLoadedPasses ()

	fetchReportablePasses (array $existing_passes)

	fetchClosedPasses (array $existing_passes)

	fetchLastPass (array $existing_passes)

	isReportablePass (int $last_pass, int $pass)

	checkLastFinishedPassInitialised ()

	isClosedPass (int $pass)

	isReportingDateReached ()

	isProcessingTimeReached (int $pass)

Private Attributes
int	$active_id = null

int	$last_finished_pass = null

array	$passes = null

array	$test_passed_once_cache = []

Detailed Description

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

Constructor & Destructor Documentation

◆ __construct()

ilTestPassesSelector::__construct	(	private ilDBInterface	$db,
		private ilObjTest	$test_obj
	)

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

37 {

38 }

Member Function Documentation

◆ checkLastFinishedPassInitialised()

ilTestPassesSelector::checkLastFinishedPassInitialised ( )

private

Definition at line 221 of file class.ilTestPassesSelector.php.

References getLastFinishedPass().

Referenced by isClosedPass().

     {
         if ($this->getLastFinishedPass() === null) {
             throw new ilTestException('invalid object state: last finished pass was not set!');
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ensureLoadedPasses()

ilTestPassesSelector::ensureLoadedPasses ( )

private

Definition at line 65 of file class.ilTestPassesSelector.php.

References loadPasses(), and passesLoaded().

Referenced by getLazyLoadedPasses().

     {
         if (!$this->passesLoaded()) {
             $this->loadPasses();
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fetchClosedPasses()

ilTestPassesSelector::fetchClosedPasses ( array $existing_passes )

private

Definition at line 168 of file class.ilTestPassesSelector.php.

References isClosedPass().

Referenced by getClosedPasses().

                                                               : array
     {
         $closed_passes = [];
 
         foreach ($existing_passes as $pass) {
             if ($this->isClosedPass($pass)) {
                 $closed_passes[] = $pass;
             }
         }
 
         return $closed_passes;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fetchLastPass()

ilTestPassesSelector::fetchLastPass ( array $existing_passes )

private

Definition at line 181 of file class.ilTestPassesSelector.php.

Referenced by fetchReportablePasses().

                                                           : ?int
     {
         $last_pass = null;
 
         foreach ($existing_passes as $pass) {
             if ($last_pass === null || $pass > $last_pass) {
                 $last_pass = $pass;
             }
         }
 
         return $last_pass;
     }

Here is the caller graph for this function:

◆ fetchReportablePasses()

ilTestPassesSelector::fetchReportablePasses ( array $existing_passes )

private

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

References fetchLastPass(), and isReportablePass().

Referenced by getReportablePasses().

                                                                   : array
     {
         $last_pass = $this->fetchLastPass($existing_passes);
 
         $reportable_passes = [];
 
         foreach ($existing_passes as $pass) {
             if ($this->isReportablePass($last_pass, $pass)) {
                 $reportable_passes[] = $pass;
             }
         }
 
         return $reportable_passes;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getActiveId()

ilTestPassesSelector::getActiveId ( )

Definition at line 40 of file class.ilTestPassesSelector.php.

References $active_id.

Referenced by isProcessingTimeReached(), isReportablePass(), loadLastFinishedPass(), and loadPasses().

                                  : ?int
     {
         return $this->active_id;
     }

Here is the caller graph for this function:

◆ getClosedPasses()

ilTestPassesSelector::getClosedPasses ( )

Definition at line 136 of file class.ilTestPassesSelector.php.

References fetchClosedPasses(), and getExistingPasses().

Referenced by openPassExists().

                                      : array
     {
         $existing_passes = $this->getExistingPasses();
         return $this->fetchClosedPasses($existing_passes);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getExistingPasses()

ilTestPassesSelector::getExistingPasses ( )

Definition at line 116 of file class.ilTestPassesSelector.php.

References getLazyLoadedPasses().

Referenced by getClosedPasses(), getNumExistingPasses(), getReportablePasses(), hasExistingPasses(), and openPassExists().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getLastFinishedPass()

ilTestPassesSelector::getLastFinishedPass ( )

Definition at line 50 of file class.ilTestPassesSelector.php.

References $last_finished_pass.

Referenced by checkLastFinishedPassInitialised(), getLastFinishedPassTimestamp(), isClosedPass(), and ilObjTest\isNextPassAllowed().

                                          : ?int
     {
         return $this->last_finished_pass;
     }

Here is the caller graph for this function:

◆ getLastFinishedPassTimestamp()

ilTestPassesSelector::getLastFinishedPassTimestamp ( )

Definition at line 264 of file class.ilTestPassesSelector.php.

References $last_finished_pass, getLastFinishedPass(), and getLazyLoadedPasses().

Referenced by ilObjTest\isNextPassAllowed().

                                                   : ?int
     {
         $last_finished_pass = $this->getLastFinishedPass();
         if ($last_finished_pass === null || $last_finished_pass === -1) {
             return null;
         }
 
         $passes = $this->getLazyLoadedPasses();
         if (!isset($passes[$last_finished_pass])) {
             return null;
         }
         return $passes[$last_finished_pass]['tstamp'];
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getLazyLoadedPasses()

ilTestPassesSelector::getLazyLoadedPasses ( )

private

Definition at line 95 of file class.ilTestPassesSelector.php.

References $passes, and ensureLoadedPasses().

Referenced by getExistingPasses(), and getLastFinishedPassTimestamp().

                                           : array
     {
         $this->ensureLoadedPasses();
         return $this->passes;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getNumExistingPasses()

ilTestPassesSelector::getNumExistingPasses ( )

Definition at line 126 of file class.ilTestPassesSelector.php.

References getExistingPasses().

                                           : int
     {
         return count($this->getExistingPasses());
     }

Here is the call graph for this function:

◆ getReportablePasses()

ilTestPassesSelector::getReportablePasses ( )

Definition at line 142 of file class.ilTestPassesSelector.php.

References fetchReportablePasses(), and getExistingPasses().

Referenced by hasReportablePasses().

                                          : array
     {
         $existing_passes = $this->getExistingPasses();
         return $this->fetchReportablePasses($existing_passes);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ hasExistingPasses()

ilTestPassesSelector::hasExistingPasses ( )

Definition at line 121 of file class.ilTestPassesSelector.php.

References getExistingPasses().

                                        : bool
     {
         return $this->getExistingPasses() !== [];
     }

Here is the call graph for this function:

◆ hasReportablePasses()

ilTestPassesSelector::hasReportablePasses ( )

Definition at line 148 of file class.ilTestPassesSelector.php.

References getReportablePasses().

                                          : bool
     {
         return (bool) count($this->getReportablePasses());
     }

Here is the call graph for this function:

◆ hasTestPassedOnce()

ilTestPassesSelector::hasTestPassedOnce ( int $active_id )

Definition at line 278 of file class.ilTestPassesSelector.php.

References $active_id, and $res.

Referenced by isReportablePass().

                                                      : bool
     {
         if (!isset($this->test_passed_once_cache[$active_id])) {
             $this->test_passed_once_cache[$active_id] = false;
 
             $res = $this->db->queryF(
                 'SELECT passed_once FROM tst_result_cache WHERE active_fi = %s',
                 ['integer'],
                 [$active_id]
             );
 
             while ($row = $this->db->fetchAssoc($res)) {
                 $this->test_passed_once_cache[$active_id] = (bool) $row['passed_once'];
             }
         }
 
         return $this->test_passed_once_cache[$active_id];
     }

Here is the caller graph for this function:

◆ isClosedPass()

ilTestPassesSelector::isClosedPass ( int $pass )

private

Definition at line 228 of file class.ilTestPassesSelector.php.

References checkLastFinishedPassInitialised(), getLastFinishedPass(), and isProcessingTimeReached().

Referenced by fetchClosedPasses(), and isReportablePass().

                                             : bool
     {
         $this->checkLastFinishedPassInitialised();
 
         if ($pass <= $this->getLastFinishedPass()) {
             return true;
         }
 
         if ($this->isProcessingTimeReached($pass)) {
             return true;
         }
 
         return false;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isProcessingTimeReached()

ilTestPassesSelector::isProcessingTimeReached ( int $pass )

private

Definition at line 249 of file class.ilTestPassesSelector.php.

References getActiveId().

Referenced by isClosedPass().

                                                        : bool
     {
         if (!$this->test_obj->getEnableProcessingTime()) {
             return false;
         }
 
         $startingTime = $this->test_obj->getStartingTimeOfUser($this->getActiveId(), $pass);
 
         if ($startingTime === false) {
             return false;
         }
 
         return $this->test_obj->isMaxProcessingTimeReached($startingTime, $this->getActiveId());
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isReportablePass()

ilTestPassesSelector::isReportablePass	(	int	$last_pass,
		int	$pass
	)

private

Definition at line 194 of file class.ilTestPassesSelector.php.

References getActiveId(), hasTestPassedOnce(), isClosedPass(), isReportingDateReached(), ilObjTestSettingsResultSummary\SCORE_REPORTING_AFTER_PASSED, ilObjTestSettingsResultSummary\SCORE_REPORTING_DATE, ilObjTestSettingsResultSummary\SCORE_REPORTING_FINISHED, and ilObjTestSettingsResultSummary\SCORE_REPORTING_IMMIDIATLY.

Referenced by fetchReportablePasses().

                                                                 : bool
     {
         switch ($this->test_obj->getScoreReporting()) {
             case ilObjTestSettingsResultSummary::SCORE_REPORTING_IMMIDIATLY:
                 return true;
 
             case ilObjTestSettingsResultSummary::SCORE_REPORTING_DATE:
                 return $this->isReportingDateReached();
 
             case ilObjTestSettingsResultSummary::SCORE_REPORTING_FINISHED:
                 if ($pass < $last_pass) {
                     return true;
                 }
 
                 return $this->isClosedPass($pass);
 
             case ilObjTestSettingsResultSummary::SCORE_REPORTING_AFTER_PASSED:
                 if (!$this->hasTestPassedOnce($this->getActiveId())) {
                     return false;
                 }
 
                 return $this->isClosedPass($pass);
         }
 
         return false;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isReportingDateReached()

ilTestPassesSelector::isReportingDateReached ( )

private

Definition at line 243 of file class.ilTestPassesSelector.php.

Referenced by isReportablePass().

                                              : bool
     {
         $reporting_date = $this->test_obj->getScoreSettings()->getResultSummarySettings()->getReportingDate();
         return $reporting_date <= new DateTimeImmutable('now', new DateTimeZone('UTC'));
     }

Here is the caller graph for this function:

◆ loadLastFinishedPass()

ilTestPassesSelector::loadLastFinishedPass ( )

Definition at line 101 of file class.ilTestPassesSelector.php.

References $res, getActiveId(), and setLastFinishedPass().

                                           : void
     {
         $query = 'SELECT last_finished_pass FROM tst_active WHERE active_id = %s';
 
         $res = $this->db->queryF(
             $query,
             ['integer'],
             [$this->getActiveId()]
         );
 
         while ($row = $this->db->fetchAssoc($res)) {
             $this->setLastFinishedPass($row['last_finished_pass']);
         }
     }

Here is the call graph for this function:

◆ loadPasses()

ilTestPassesSelector::loadPasses ( )

private

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

References $res, and getActiveId().

Referenced by ensureLoadedPasses().

                                  : void
     {
         $query = '
                         SELECT DISTINCT tst_pass_result.* FROM tst_pass_result
                         LEFT JOIN tst_test_result
                         ON tst_pass_result.pass = tst_test_result.pass
                         AND tst_pass_result.active_fi = tst_test_result.active_fi
                         WHERE tst_pass_result.active_fi = %s
                         ORDER BY tst_pass_result.pass
                 ';
 
         $res = $this->db->queryF(
             $query,
             ['integer'],
             [$this->getActiveId()]
         );
 
         $this->passes = [];
 
         while ($row = $this->db->fetchAssoc($res)) {
             $this->passes[$row['pass']] = $row;
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ openPassExists()

ilTestPassesSelector::openPassExists ( )

Definition at line 131 of file class.ilTestPassesSelector.php.

References getClosedPasses(), and getExistingPasses().

                                     : bool
     {
         return count($this->getExistingPasses()) > count($this->getClosedPasses());
     }

Here is the call graph for this function:

◆ passesLoaded()

ilTestPassesSelector::passesLoaded ( )

private

Definition at line 60 of file class.ilTestPassesSelector.php.

Referenced by ensureLoadedPasses().

                                    : bool
     {
         return is_array($this->passes);
     }

Here is the caller graph for this function:

◆ setActiveId()

ilTestPassesSelector::setActiveId ( ?int $active_id )

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

References $active_id.

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

◆ setLastFinishedPass()

ilTestPassesSelector::setLastFinishedPass ( ?int $last_finished_pass )

Definition at line 55 of file class.ilTestPassesSelector.php.

References $last_finished_pass.

Referenced by loadLastFinishedPass().

                                                                  : void
     {
         $this->last_finished_pass = $last_finished_pass === null ? -1 : $last_finished_pass;
     }

Here is the caller graph for this function:

Field Documentation

◆ $active_id

int ilTestPassesSelector::$active_id = null

private

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

Referenced by getActiveId(), hasTestPassedOnce(), and setActiveId().

◆ $last_finished_pass

int ilTestPassesSelector::$last_finished_pass = null

private

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

Referenced by getLastFinishedPass(), getLastFinishedPassTimestamp(), and setLastFinishedPass().

◆ $passes

array ilTestPassesSelector::$passes = null

private

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

Referenced by getLazyLoadedPasses().

◆ $test_passed_once_cache

array ilTestPassesSelector::$test_passed_once_cache = []

private

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

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

Modules/Test/classes/class.ilTestPassesSelector.php

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ checkLastFinishedPassInitialised()

◆ ensureLoadedPasses()

◆ fetchClosedPasses()

◆ fetchLastPass()

◆ fetchReportablePasses()

◆ getActiveId()

◆ getClosedPasses()

◆ getExistingPasses()

◆ getLastFinishedPass()

◆ getLastFinishedPassTimestamp()

◆ getLazyLoadedPasses()

◆ getNumExistingPasses()

◆ getReportablePasses()

◆ hasExistingPasses()

◆ hasReportablePasses()

◆ hasTestPassedOnce()

◆ isClosedPass()

◆ isProcessingTimeReached()

◆ isReportablePass()

◆ isReportingDateReached()

◆ loadLastFinishedPass()

◆ loadPasses()

◆ openPassExists()

◆ passesLoaded()

◆ setActiveId()

◆ setLastFinishedPass()

Field Documentation

◆ $active_id

◆ $last_finished_pass

◆ $passes

◆ $test_passed_once_cache