Inheritance diagram for ilObjTestAccess:

Collaboration diagram for ilObjTestAccess:

Public Member Functions
	canBeDelivered (ilWACPath $ilWACPath)

	_checkAccess (string $cmd, string $permission, int $ref_id, int $obj_id, int $user_id=null)
	Checks wether a user may invoke a command or not (this method is called by ilAccessHandler::checkAccess) More...

Public Member Functions inherited from ilObjectAccess
	_checkAccess (string $cmd, string $permission, int $ref_id, int $obj_id, ?int $user_id=null)
	Checks whether a user may invoke a command or not (this method is called by ilAccessHandler::checkAccess) More...

	canBeDelivered (ilWACPath $ilWACPath)

Static Public Member Functions
static	_isPassed ($user_id, $a_obj_id)
	Returns TRUE if the user with the user id $user_id passed the test with the object id $a_obj_id. More...

static	isFailed ($user_id, $a_obj_id)
	Returns TRUE if the user with the user id $user_id failed the test with the object id $a_obj_id. More...

static	getConditionOperators ()
	Get possible conditions operators. More...

static	checkCondition (int $a_trigger_obj_id, string $a_operator, string $a_value, int $a_usr_id)
	check condition More...

static	_getCommands ()

static	_lookupCreationComplete ($a_obj_id)
	checks wether all necessary parts of the test are given More...

static	_getTestIDFromObjectID ($object_id)
	Returns the ILIAS test id for a given object id. More...

static	_lookupObjIdForTestId ($a_test_id)
	Lookup object id for test id. More...

static	_getRandomTestsForQuestionPool ($qpl_id)
	Get all tests using a question pool for random selection. More...

static	_lookupOnlineTestAccess ($a_test_id, $a_user_id)
	Checks if a user is allowd to run an online exam. More...

static	_getParticipantData ($active_id)
	Retrieves a participant name from active id. More...

static	_getParticipantId ($active_id)
	Get user id for active id. More...

static	_getPassedUsers ($a_obj_id)
	Returns an array containing the users who passed the test. More...

static	_checkGoto (string $target)
	check whether goto script will succeed More...

static	_isOffline (int $obj_id)
	returns the objects's OFFline status More...

static	visibleUserResultExists ($test_obj_id, $user_id)

Static Public Member Functions inherited from ilObjectAccess
static	_getCommands ()
	get commands More...

static	_checkGoto (string $target)
	check whether goto script will succeed More...

static	_isOffline (int $obj_id)
	Type-specific implementation of general status, has to be overwritten if object type does not support centralized offline handling. More...

static	_preloadData (array $obj_ids, array $ref_ids)
	Preload data. More...

Static Protected Member Functions
static	updateTestResultCache ($a_user_id, $a_obj_id)

Private Member Functions
	findMatch (string $path, array $array)

Private Attributes
ilDBInterface	$db

ilObjUser	$user

ilLanguage	$lng

ilRbacSystem	$rbac_system

ilAccessHandler	$access

Static Private Attributes
static	$hasFinishedCache = []

Detailed Description

Class ilObjTestAccess.

This class contains methods that check object specific conditions for accessing test objects.

Author: Helmut Schottmueller helmu.nosp@m.t.sc.nosp@m.hottm.nosp@m.uell.nosp@m.er@ma.nosp@m.c.co.nosp@m.m; Alex Killing alex..nosp@m.kill.nosp@m.ing@g.nosp@m.mx.d.nosp@m.e

Version: $Id$

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

Member Function Documentation

◆ _checkAccess()

ilObjTestAccess::_checkAccess	(	string	$cmd,
		string	$permission,
		int	$ref_id,
		int	$obj_id,
		int	$user_id = `null`
	)

Checks wether a user may invoke a command or not (this method is called by ilAccessHandler::checkAccess)

Please do not check any preconditions handled by ilConditionHandler here.

Definition at line 88 of file class.ilObjTestAccess.php.

References _lookupCreationComplete(), ILIAS\Repository\access(), ilAccessInfo\IL_NO_OBJECT_ACCESS, ILIAS\Repository\lng(), and ILIAS\Repository\user().

                                                                                                                 : bool
     {
         if (is_null($user_id)) {
             $user_id = $this->user->getId();
         }
 
         $is_admin = $this->rbac_system->checkAccessOfUser($user_id, 'write', $ref_id);
 
 
         switch ($permission) {
             case "visible":
             case "read":
                 if (!ilObjTestAccess::_lookupCreationComplete($obj_id) &&
                     !$is_admin) {
                     $this->access->addInfoItem(ilAccessInfo::IL_NO_OBJECT_ACCESS, $this->lng->txt("tst_warning_test_not_complete"));
                     return false;
                 }
                 break;
         }
 
         switch ($cmd) {
             case "eval_a":
             case "eval_stat":
                 if (!ilObjTestAccess::_lookupCreationComplete($obj_id)) {
                     $this->access->addInfoItem(ilAccessInfo::IL_NO_OBJECT_ACCESS, $this->lng->txt("tst_warning_test_not_complete"));
                     return false;
                 }
                 break;
         }
 
         return true;
     }

Here is the call graph for this function:

◆ _checkGoto()

static ilObjTestAccess::_checkGoto ( string $target )

static

check whether goto script will succeed

Definition at line 734 of file class.ilObjTestAccess.php.

References $DIC.

                                                      : bool
     {
         global $DIC;
         $ilAccess = $DIC['ilAccess'];
 
         $t_arr = explode("_", $target);
 
         if ($t_arr[0] != "tst" || ((int) $t_arr[1]) <= 0) {
             return false;
         }
 
         if ($ilAccess->checkAccess("read", "", (int) $t_arr[1]) ||
             $ilAccess->checkAccess("visible", "", (int) $t_arr[1])) {
             return true;
         }
         return false;
     }

◆ _getCommands()

static ilObjTestAccess::_getCommands ( )

static

Definition at line 360 of file class.ilObjTestAccess.php.

References $DIC.

Referenced by ilObjTestListGUI\init().

                                          : array
     {
         global $DIC;
         $DIC->language()->loadLanguageModule('assessment');
 
         $commands = [
             ["permission" => "write", "cmd" => "questionsTabGateway", "lang_var" => "tst_edit_questions"],
             ["permission" => "write", "cmd" => "ilObjTestSettingsMainGUI::showForm", "lang_var" => "settings"],
             ["permission" => "read", "cmd" => "ilTestScreenGUI::testScreen", "lang_var" => "tst_run", "default" => true],
             ["permission" => "tst_statistics", "cmd" => "outEvaluation", "lang_var" => "tst_statistical_evaluation"],
             ["permission" => "read", "cmd" => "userResultsGateway", "lang_var" => "tst_user_results"],
             ["permission" => "write", "cmd" => "testResultsGateway", "lang_var" => "results"],
             ["permission" => "eval_a", "cmd" => "testResultsGateway", "lang_var" => "results"]
         ];
 
         return $commands;
     }

Here is the caller graph for this function:

◆ _getParticipantData()

static ilObjTestAccess::_getParticipantData ( $active_id )

static

Retrieves a participant name from active id.

Parameters

integer $active_id Active ID of the participant

Returns: string The output name of the user public

Definition at line 582 of file class.ilObjTestAccess.php.

References $DIC, $ilDB, ilObjTest\_lookupAnonymity(), ilObjUser\_lookupName(), ANONYMOUS_USER_ID, and ilLanguage\txt().

Referenced by assQuestion\_setReachedPoints(), ilTestParticipantList\buildParticipantsFullname(), ilTestResultsToXML\exportActiveIDs(), ilTestParticipantData\getFormatedFullnameByActiveId(), ilTestParticipantData\getOptionArray(), and ilObjTest\logManualFeedback().

                                                           : string
     {
         global $DIC;
         $lng = $DIC['lng'];
         $ilDB = $DIC['ilDB'];
 
         $result_active = $ilDB->queryF(
             'SELECT * FROM tst_active WHERE active_id = %s',
             ['integer'],
             [$active_id]
         );
         $row_active = $ilDB->fetchAssoc($result_active);
         $importname = $row_active['importname'];
 
         if ($importname !== null
             && $importname !== '') {
             return $importname . ' (' . $lng->txt('imported') . ')';
         }
 
         if ($row_active['user_fi'] === ANONYMOUS_USER_ID) {
             return '';
         }
 
         $uname = ilObjUser::_lookupName($row_active['user_fi']);
 
         $result_test = $ilDB->queryF(
             "SELECT obj_fi FROM tst_tests WHERE test_id = %s",
             ["integer"],
             [$row_active['test_fi']]
         );
         $row_test = $ilDB->fetchAssoc($result_test);
         $obj_id = $row_test["obj_fi"];
 
         if (ilObjTest::_lookupAnonymity($obj_id)) {
             return $lng->txt("anonymous");
         }
 
         if ($uname['firstname'] . $uname['lastname'] === '') {
             return $lng->txt('deleted_user');
         }
 
         return trim($uname['lastname'] . ', ' . $uname['firstname']);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _getParticipantId()

static ilObjTestAccess::_getParticipantId ( $active_id )

static

Get user id for active id.

Parameters

int	active ID of the participant

Returns: int user id

Definition at line 632 of file class.ilObjTestAccess.php.

References $DIC, and $ilDB.

Referenced by assFileUpload\handleSubmission(), ilTestScoringByQuestionsGUI\saveManScoringByQuestion(), ilTestScoringGUI\saveManScoringParticipantScreen(), and ilTestPassFinishTasks\updateLearningProgressAfterPassFinishedIsWritten().

                                                         : int
     {
         global $DIC;
         $lng = $DIC['lng'];
         $ilDB = $DIC['ilDB'];
 
         $result = $ilDB->queryF(
             "SELECT user_fi FROM tst_active WHERE active_id = %s",
             ["integer"],
             [$active_id]
         );
         $row = $ilDB->fetchAssoc($result);
         return $row["user_fi"];
     }

Here is the caller graph for this function:

◆ _getPassedUsers()

static ilObjTestAccess::_getPassedUsers ( $a_obj_id )

static

Returns an array containing the users who passed the test.

Returns: array An array containing the users who passed the test. Format of the values of the resulting array: [ "user_id" => user ID, "max_points" => maximum available points in the test "reached_points" => maximum reached points of the user "mark_short" => short text of the passed mark "mark_official" => official text of the passed mark ] public

Definition at line 662 of file class.ilObjTestAccess.php.

References $data, $DIC, and $ilDB.

Referenced by ilLPStatusTestPassed\_getStatusInfo().

                                                      : array
     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
 
         $passed_users = [];
         // Maybe SELECT DISTINCT(tst_active.user_fi)... ?
         $userresult = $ilDB->queryF(
             "
                         SELECT tst_active.active_id, COUNT(tst_sequence.active_fi) sequences, tst_active.last_finished_pass,
                                 CASE WHEN
                                         (tst_tests.nr_of_tries - 1) = tst_active.last_finished_pass
                                 THEN '1'
                                 ELSE '0'
                                 END is_last_pass
                         FROM tst_tests
                         INNER JOIN tst_active
                         ON tst_active.test_fi = tst_tests.test_id
                         LEFT JOIN tst_sequence
                         ON tst_sequence.active_fi = tst_active.active_id
                         WHERE tst_tests.obj_fi = %s
                         GROUP BY tst_active.active_id
                         ",
             ['integer'],
             [$a_obj_id]
         );
         $all_participants = [];
         $notAttempted = [];
         $lastPassUsers = [];
         while ($row = $ilDB->fetchAssoc($userresult)) {
             if ($row['sequences'] == 0) {
                 $notAttempted[$row['active_id']] = $row['active_id'];
             }
             if ($row['is_last_pass']) {
                 $lastPassUsers[$row['active_id']] = $row['active_id'];
             }
 
             $all_participants[$row['active_id']] = $row['active_id'];
         }
 
         $result = $ilDB->query("SELECT tst_result_cache.*, tst_active.user_fi FROM tst_result_cache, tst_active WHERE tst_active.active_id = tst_result_cache.active_fi AND " . $ilDB->in('active_fi', $all_participants, false, 'integer'));
         $found_all = ($result->numRows() == count($all_participants)) ? true : false;
         if (!$found_all) {
             $test = new ilObjTest($a_obj_id, false);
             // if the result cache entries do not exist, create them
             $found_participants = [];
             while ($data = $ilDB->fetchAssoc($result)) {
                 array_push($found_participants, $data['active_fi']);
             }
             foreach ($all_participants as $active_id) {
                 if (!in_array($active_id, $found_participants)) {
                     $test->updateTestResultCache($active_id);
                 }
             }
             $result = $ilDB->query("SELECT tst_result_cache.*, tst_active.user_fi FROM tst_result_cache, tst_active WHERE tst_active.active_id = tst_result_cache.active_fi AND " . $ilDB->in('active_fi', $all_participants, false, 'integer'));
         }
         while ($data = $ilDB->fetchAssoc($result)) {
             if (isset($notAttempted[$data['active_fi']])) {
                 $data['failed'] = 0;
                 $data['passed'] = 0;
                 $data['not_attempted'] = 1;
             }
 
             $data['user_id'] = $data['user_fi'];
             array_push($passed_users, $data);
         }
         return $passed_users;
     }

Here is the caller graph for this function:

◆ _getRandomTestsForQuestionPool()

static ilObjTestAccess::_getRandomTestsForQuestionPool ( $qpl_id )

static

Get all tests using a question pool for random selection.

Parameters

int	question pool id

Returns: array list if test obj ids public

Definition at line 500 of file class.ilObjTestAccess.php.

References $DIC, and $ilDB.

Referenced by ilObjMediaObjectAccess\checkAccessTestQuestion().

                                                                   : array
     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
 
         $query = "
                         SELECT DISTINCT t.obj_fi
                         FROM tst_tests t
                         INNER JOIN tst_rnd_quest_set_qpls r
                         ON t.test_id = r.test_fi
                         WHERE r.pool_fi = %s
                 ";
 
         $result = $ilDB->queryF($query, ['integer'], [$qpl_id]);
 
         $tests = [];
         while ($row = $ilDB->fetchAssoc($result)) {
             $tests[] = $row['obj_fi'];
         }
 
         return $tests;
     }

Here is the caller graph for this function:

◆ _getTestIDFromObjectID()

static ilObjTestAccess::_getTestIDFromObjectID ( $object_id )

static

Returns the ILIAS test id for a given object id.

Parameters

integer $object_id The object id

Returns: mixed The ILIAS test id or FALSE if the query was not successful public

Definition at line 455 of file class.ilObjTestAccess.php.

References $DIC, and $ilDB.

Referenced by ilLPStatusTestFinished\getParticipants(), and ilSoapTestAdministration\getTestAccess().

     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
         $test_id = false;
         $result = $ilDB->queryF(
             "SELECT test_id FROM tst_tests WHERE obj_fi = %s",
             ['integer'],
             [$object_id]
         );
         if ($result->numRows()) {
             $row = $ilDB->fetchAssoc($result);
             $test_id = $row["test_id"];
         }
         return $test_id;
     }

Here is the caller graph for this function:

◆ _isOffline()

static ilObjTestAccess::_isOffline ( int $obj_id )

static

returns the objects's OFFline status

Used in ListGUI and Learning Progress

Definition at line 757 of file class.ilObjTestAccess.php.

References ilObject\lookupOfflineStatus().

Referenced by ilLOEditorStatus\checkTestOnline().

                                                   : bool
     {
         return ilObject::lookupOfflineStatus($obj_id);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _isPassed()

static ilObjTestAccess::_isPassed	(	$user_id,
		$a_obj_id
	)

static

Returns TRUE if the user with the user id $user_id passed the test with the object id $a_obj_id.

Parameters

int	$user_id	The user id
int	$a_obj_id	The object id

Returns: boolean TRUE if the user passed the test, FALSE otherwise

Definition at line 128 of file class.ilObjTestAccess.php.

References $DIC, $ilDB, and $res.

Referenced by checkCondition(), ilLPStatusTestPassed\determineStatus(), and ilObjTest\isExecutable().

                                                          : bool
     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
 
         $test = new ilObjTest($a_obj_id, false);
 
         $result = $ilDB->queryF(
             "SELECT tst_result_cache.* FROM tst_result_cache, tst_active, tst_tests WHERE tst_active.test_fi = tst_tests.test_id AND tst_active.user_fi = %s AND tst_tests.obj_fi = %s AND tst_result_cache.active_fi = tst_active.active_id",
             ['integer','integer'],
             [$user_id, $a_obj_id]
         );
         if (!$result->numRows()) {
             $result = $ilDB->queryF(
                 "SELECT tst_active.active_id FROM tst_active, tst_tests WHERE tst_active.test_fi = tst_tests.test_id AND tst_active.user_fi = %s AND tst_tests.obj_fi = %s",
                 ['integer','integer'],
                 [$user_id, $a_obj_id]
             );
             $row = $ilDB->fetchAssoc($result);
             if ($row !== null && $row['active_id'] > 0) {
                 $test->updateTestResultCache($row['active_id']);
             } else {
                 return false;
             }
         }
         $result = $ilDB->queryF(
             "SELECT tst_result_cache.* FROM tst_result_cache, tst_active, tst_tests WHERE tst_active.test_fi = tst_tests.test_id AND tst_active.user_fi = %s AND tst_tests.obj_fi = %s AND tst_result_cache.active_fi = tst_active.active_id",
             ['integer','integer'],
             [$user_id, $a_obj_id]
         );
         if (!$result->numRows()) {
             $result = $ilDB->queryF(
                 "SELECT tst_pass_result.*, tst_tests.pass_scoring, tst_tests.test_id FROM tst_pass_result, tst_active, tst_tests WHERE tst_active.test_fi = tst_tests.test_id AND tst_active.user_fi = %s AND tst_tests.obj_fi = %s AND tst_pass_result.active_fi = tst_active.active_id ORDER BY tst_pass_result.pass",
                 ['integer','integer'],
                 [$user_id, $a_obj_id]
             );
 
             if (!$result->numRows()) {
                 return false;
             }
 
             $points = [];
             while ($row = $ilDB->fetchAssoc($result)) {
                 array_push($points, $row);
             }
             $reached = 0;
             $max = 0;
             if ($points[0]["pass_scoring"] == 0) {
                 $reached = $points[count($points) - 1]["points"];
                 $max = $points[count($points) - 1]["maxpoints"];
                 if (!$max) {
                     $active_id = $points[count($points) - 1]["active_fi"];
                     $pass = $points[count($points) - 1]["pass"];
                     if (strlen($active_id) && strlen($pass)) {
                         $res = $test->updateTestPassResults($active_id, $pass, false, null, $a_obj_id);
                         $max = $res['maxpoints'];
                         $reached = $res['points'];
                     }
                 }
             } else {
                 foreach ($points as $row) {
                     if ($row["points"] > $reached) {
                         $reached = $row["points"];
                         $max = $row["maxpoints"];
                         if (!$max) {
                             $active_id = $row["active_fi"];
                             $pass = $row["pass"];
                             if (strlen($active_id) && strlen($pass)) {
                                 $res = $test->updateTestPassResults($active_id, $pass, false, null, $a_obj_id);
                                 $max = $res['maxpoints'];
                                 $reached = $res['points'];
                             }
                         }
                     }
                 }
             }
             $percentage = (!$max) ? 0 : ($reached / $max) * 100.0;
             return $test->getMarkSchema()->getMatchingMark($percentage)->getPassed() === 1;
         } else {
             $row = $ilDB->fetchAssoc($result);
             return ($row['passed']) ? true : false;
         }
     }

Here is the caller graph for this function:

◆ _lookupCreationComplete()

static ilObjTestAccess::_lookupCreationComplete ( $a_obj_id )

static

checks wether all necessary parts of the test are given

Definition at line 385 of file class.ilObjTestAccess.php.

References $DIC, and $ilDB.

Referenced by _checkAccess().

                                                              : bool
     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
 
         $result = $ilDB->queryF(
             "SELECT complete FROM tst_tests WHERE obj_fi=%s",
             ['integer'],
             [$a_obj_id]
         );
         if ($result->numRows() == 1) {
             $row = $ilDB->fetchAssoc($result);
         }
 
         return isset($row['complete']) && $row['complete'];
     }

Here is the caller graph for this function:

◆ _lookupObjIdForTestId()

static ilObjTestAccess::_lookupObjIdForTestId ( $a_test_id )

static

Lookup object id for test id.

Parameters

int test id

Returns: int object id

Definition at line 478 of file class.ilObjTestAccess.php.

References $DIC, and $ilDB.

                                                             : int
     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
 
         $result = $ilDB->queryF(
             "SELECT obj_fi FROM tst_tests WHERE test_id = %s",
             ['integer'],
             [$a_test_id]
         );
 
         $row = $ilDB->fetchAssoc($result);
         return $row["obj_fi"];
     }

◆ _lookupOnlineTestAccess()

static ilObjTestAccess::_lookupOnlineTestAccess	(	$a_test_id,
		$a_user_id
	)

static

Checks if a user is allowd to run an online exam.

Returns: mixed true if the user is allowed to run the online exam or if the test isn't an online exam, an alert message if the test is an online exam and the user is not allowed to run it public

Definition at line 530 of file class.ilObjTestAccess.php.

References $_SERVER, $DIC, $ilDB, ilLanguage\loadLanguageModule(), and ilLanguage\txt().

Referenced by ilObjTestGUI\buildPageViewToolbar(), ilTestPlayerAbstractGUI\checkReadAccess(), ilTestScreenGUI\getLauncher(), and ilObjTestListGUI\getProperties().

     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
         $lng = $DIC['lng'];
 
         $result = $ilDB->queryF(
             "SELECT tst_tests.* FROM tst_tests WHERE tst_tests.obj_fi = %s",
             ['integer'],
             [$a_test_id]
         );
         if ($result->numRows()) {
             $row = $ilDB->fetchAssoc($result);
             if ($row["fixed_participants"]) {
                 $result = $ilDB->queryF(
                     "SELECT * FROM tst_invited_user WHERE test_fi = %s AND user_fi = %s",
                     ['integer','integer'],
                     [$row["test_id"], $a_user_id]
                 );
                 if ($result->numRows()) {
                     $row = $ilDB->fetchAssoc($result);
                     if ($row['clientip'] !== null && trim($row['clientip']) != "") {
                         $row['clientip'] = preg_replace("/[^0-9.?*,:]+/", "", $row['clientip']);
                         $row['clientip'] = str_replace(".", "\\.", $row['clientip']);
                         $row['clientip'] = str_replace(["?","*",","], ["[0-9]","[0-9]*","|"], $row['clientip']);
                         if (!preg_match("/^" . $row['clientip'] . "$/", $_SERVER["REMOTE_ADDR"])) {
                             $lng->loadLanguageModule('assessment');
                             return $lng->txt("user_wrong_clientip");
                         } else {
                             return true;
                         }
                     } else {
                         return true;
                     }
                 } else {
                     return $lng->txt("tst_user_not_invited");
                 }
             } else {
                 return true;
             }
         } else {
             return true;
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ canBeDelivered()

ilObjTestAccess::canBeDelivered ( ilWACPath $ilWACPath )

Implements ilWACCheckingClass.

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

References ILIAS\Repository\access(), findMatch(), ilWACPath\getPath(), and ILIAS\Repository\user().

                                                         : bool
     {
         $readable = new Readable($this->access);
 
         $can_it = $this->findMatch($ilWACPath->getPath(), [
             new AccessFileUploadAnswer($this->user, $this->db, $readable),
             new AccessQuestionImage($readable),
             new AccessFileUploadPreview($this->db, $this->access),
         ]);
 
 
         return !$can_it->isOk() || $can_it->value();
     }

Here is the call graph for this function:

◆ checkCondition()

static ilObjTestAccess::checkCondition	(	int	$a_trigger_obj_id,
		string	$a_operator,
		string	$a_value,
		int	$a_usr_id
	)

static

check condition

this method is called by ilConditionHandler

Implements ilConditionHandling.

Definition at line 338 of file class.ilObjTestAccess.php.

References _isPassed(), isFailed(), ilConditionHandler\OPERATOR_FAILED, ilConditionHandler\OPERATOR_FINISHED, ilConditionHandler\OPERATOR_NOT_FINISHED, and ilConditionHandler\OPERATOR_PASSED.

Referenced by ilCourseStart\isFullfilled(), ilContainerStartObjects\isFullfilled(), ILIAS\Containter\Content\ObjectiveRenderer\renderObjective(), and ILIAS\Containter\Content\ObjectiveRenderer\renderObjectives().

                                                                                                                     : bool
     {
         switch ($a_operator) {
             case ilConditionHandler::OPERATOR_PASSED:
                 return ilObjTestAccess::_isPassed($a_usr_id, $a_trigger_obj_id);
                 break;
 
             case ilConditionHandler::OPERATOR_FAILED:
                 return ilObjTestAccess::isFailed($a_usr_id, $a_trigger_obj_id);
 
             case ilConditionHandler::OPERATOR_FINISHED:
                 return ilObjTestAccess::hasFinished($a_usr_id, $a_trigger_obj_id);
 
             case ilConditionHandler::OPERATOR_NOT_FINISHED:
                 return !ilObjTestAccess::hasFinished($a_usr_id, $a_trigger_obj_id);
 
             default:
                 return true;
         }
         return true;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ findMatch()

ilObjTestAccess::findMatch	(	string	$path,
		array	$array
	)

private

Definition at line 74 of file class.ilObjTestAccess.php.

References ILIAS\Data\Result\except(), and ILIAS\Modules\Test\SimpleAccess\isPermitted().

Referenced by canBeDelivered().

                                                           : Result
     {
         return array_reduce($array, fn(Result $result, SimpleAccess $access) => $result->except(
             fn() => $access->isPermitted($path)
         ), new Error('Not a known path.'));
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getConditionOperators()

static ilObjTestAccess::getConditionOperators ( )

static

Get possible conditions operators.

Implements ilConditionHandling.

Definition at line 322 of file class.ilObjTestAccess.php.

References ilConditionHandler\OPERATOR_FAILED, ilConditionHandler\OPERATOR_FINISHED, ilConditionHandler\OPERATOR_NOT_FINISHED, and ilConditionHandler\OPERATOR_PASSED.

                                                   : array
     {
         return [
             ilConditionHandler::OPERATOR_PASSED,
             ilConditionHandler::OPERATOR_FAILED,
             ilConditionHandler::OPERATOR_FINISHED,
             ilConditionHandler::OPERATOR_NOT_FINISHED
         ];
     }

◆ isFailed()

static ilObjTestAccess::isFailed	(	$user_id,
		$a_obj_id
	)

static

Returns TRUE if the user with the user id $user_id failed the test with the object id $a_obj_id.

Parameters

int	$user_id	The user id
int	$a_obj_id	The object id

Returns: boolean TRUE if the user failed the test, FALSE otherwise

Definition at line 219 of file class.ilObjTestAccess.php.

References $DIC, $ilDB, and $res.

Referenced by checkCondition().

                                                         : bool
     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
 
         $ret = self::updateTestResultCache($user_id, $a_obj_id);
 
         if (!$ret) {
             return false;
         }
 
         $test = new ilObjTest($a_obj_id, false);
 
         $result = $ilDB->queryF(
             "SELECT tst_result_cache.* FROM tst_result_cache, tst_active, tst_tests WHERE tst_active.test_fi = tst_tests.test_id AND tst_active.user_fi = %s AND tst_tests.obj_fi = %s AND tst_result_cache.active_fi = tst_active.active_id",
             ['integer','integer'],
             [$user_id, $a_obj_id]
         );
 
         if (!$result->numRows()) {
             $result = $ilDB->queryF(
                 "SELECT tst_pass_result.*, tst_tests.pass_scoring FROM tst_pass_result, tst_active, tst_tests WHERE tst_active.test_fi = tst_tests.test_id AND tst_active.user_fi = %s AND tst_tests.obj_fi = %s AND tst_pass_result.active_fi = tst_active.active_id ORDER BY tst_pass_result.pass",
                 ['integer','integer'],
                 [$user_id, $a_obj_id]
             );
 
             while ($row = $ilDB->fetchAssoc($result)) {
                 array_push($points, $row);
             }
             $reached = 0;
             $max = 0;
             if ($points[0]["pass_scoring"] == 0) {
                 $reached = $points[count($points) - 1]["points"];
                 $max = $points[count($points) - 1]["maxpoints"];
                 if (!$max) {
                     $active_id = $points[count($points) - 1]["active_fi"];
                     $pass = $points[count($points) - 1]["pass"];
                     if (strlen($active_id) && strlen($pass)) {
                         $res = $test->updateTestPassResults($active_id, $pass, false, null, $a_obj_id);
                         $max = $res['maxpoints'];
                         $reached = $res['points'];
                     }
                 }
             } else {
                 foreach ($points as $row) {
                     if ($row["points"] > $reached) {
                         $reached = $row["points"];
                         $max = $row["maxpoints"];
                         if (!$max) {
                             $active_id = $row["active_fi"];
                             $pass = $row["pass"];
                             if (strlen($active_id) && strlen($pass)) {
                                 $res = $test->updateTestPassResults($active_id, $pass, false, null, $a_obj_id);
                                 $max = $res['maxpoints'];
                                 $reached = $res['points'];
                             }
                         }
                     }
                 }
             }
             $percentage = (!$max) ? 0 : ($reached / $max) * 100.0;
             return $test->getMarkSchema()->getMatchingMark($percentage)->getPassed() === 0;
         } else {
             $row = $ilDB->fetchAssoc($result);
             return ($row['failed']) ? true : false;
         }
     }

Here is the caller graph for this function:

◆ updateTestResultCache()

static ilObjTestAccess::updateTestResultCache	(	$a_user_id,
		$a_obj_id
	)

staticprotected

Definition at line 287 of file class.ilObjTestAccess.php.

References $DIC, and $ilDB.

                                                                           : bool
     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
 
         $result = $ilDB->queryF(
             "SELECT tst_result_cache.* FROM tst_result_cache, tst_active, tst_tests " .
                 "WHERE tst_active.test_fi = tst_tests.test_id AND tst_active.user_fi = %s " .
                 "AND tst_tests.obj_fi = %s AND tst_result_cache.active_fi = tst_active.active_id",
             ['integer','integer'],
             [$a_user_id, $a_obj_id]
         );
         if (!$result->numRows()) {
             $result = $ilDB->queryF(
                 "SELECT tst_active.active_id FROM tst_active, tst_tests WHERE tst_active.test_fi = tst_tests.test_id AND tst_active.user_fi = %s AND tst_tests.obj_fi = %s",
                 ['integer','integer'],
                 [$a_user_id, $a_obj_id]
             );
             $row = $ilDB->fetchAssoc($result);
             if ($row !== null && $row['active_id'] > 0) {
                 $test = new ilObjTest($a_obj_id, false);
                 $test->updateTestResultCache($row['active_id']);
                 return true;
             } else {
                 return false;
             }
         } else {
             return true;
         }
     }

◆ visibleUserResultExists()

static ilObjTestAccess::visibleUserResultExists	(	$test_obj_id,
		$user_id
	)

static

Definition at line 763 of file class.ilObjTestAccess.php.

References $DIC, $ilDB, and ilObjectFactory\getInstanceByObjId().

Referenced by ilLOUtils\getTestResultLinkForUser(), and ilObjTestListGUI\handleUserResultsCommand().

                                                                           : bool
     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
         $ilUser = $DIC['ilUser'];
 
         $test_obj = ilObjectFactory::getInstanceByObjId($test_obj_id, false);
 
         if (!($test_obj instanceof ilObjTest)) {
             return false;
         }
 
         $test_session_factory = new ilTestSessionFactory($test_obj, $ilDB, $ilUser);
         $test_session = $test_session_factory->getSessionByUserId($user_id);
 
         return $test_obj->canShowTestResults($test_session);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

◆ $access

ilAccessHandler ilObjTestAccess::$access

private

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

◆ $db

ilDBInterface ilObjTestAccess::$db

private

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

◆ $hasFinishedCache

ilObjTestAccess::$hasFinishedCache = []

staticprivate

Definition at line 407 of file class.ilObjTestAccess.php.

◆ $lng

ilLanguage ilObjTestAccess::$lng

private

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

◆ $rbac_system

ilRbacSystem ilObjTestAccess::$rbac_system

private

Definition at line 46 of file class.ilObjTestAccess.php.

◆ $user

ilObjUser ilObjTestAccess::$user

private

Definition at line 44 of file class.ilObjTestAccess.php.

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

Modules/Test/classes/class.ilObjTestAccess.php

Public Member Functions

Static Public Member Functions

Static Protected Member Functions

Private Member Functions

Private Attributes

Static Private Attributes

Detailed Description

Member Function Documentation

◆ _checkAccess()

◆ _checkGoto()

◆ _getCommands()

◆ _getParticipantData()

◆ _getParticipantId()

◆ _getPassedUsers()

◆ _getRandomTestsForQuestionPool()

◆ _getTestIDFromObjectID()

◆ _isOffline()

◆ _isPassed()

◆ _lookupCreationComplete()

◆ _lookupObjIdForTestId()

◆ _lookupOnlineTestAccess()

◆ canBeDelivered()

◆ checkCondition()

◆ findMatch()

◆ getConditionOperators()

◆ isFailed()

◆ updateTestResultCache()

◆ visibleUserResultExists()

Field Documentation

◆ $access

◆ $db

◆ $hasFinishedCache

◆ $lng

◆ $rbac_system

◆ $user