ilObjTestAccess Class Reference

Class ilObjTestAccess. More...

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...
	showCertificateFor (int $user_id, int $obj_id)
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	_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	_preloadData ($obj_ids, $ref_ids)
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 ilCertificateObjectsForUserPreloader	$certificate_preloader = null
static array	$settings_result_summaries_by_obj_id = []
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 43 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 93 of file class.ilObjTestAccess.php.

References $user_id, _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_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 682 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 364 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" => "ILIAS\Test\Settings\MainSettings\SettingsMainGUI::showForm", "lang_var" => "settings"],
            ["permission" => "read", "cmd" => "ILIAS\Test\Presentation\TestScreenGUI::testScreen", "lang_var" => "tst_run", "default" => true]
        ];

        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 531 of file class.ilObjTestAccess.php.

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

Referenced by ilTestParticipantList\buildParticipantsFullname(), ilTestResultsToXML\exportActiveIDs(), ilTestParticipantData\getFormatedFullnameByActiveId(), and ilTestParticipantData\getOptionArray().

                                                          : 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 581 of file class.ilObjTestAccess.php.

References $DIC, and $ilDB.

Referenced by ILIAS\Test\Scoring\Manual\TestScoringByQuestionGUI\saveManScoringByQuestion(), ILIAS\Test\Scoring\Manual\TestScoringByParticipantGUI\saveManScoringParticipantScreen(), and ilTestPassFinishTasks\updateLearningProgressAfterPassFinishedIsWritten().

                                                        : int
    {
        global $DIC;
        $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 610 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 ilMobStakeholder\checkAccessTestQuestion(), and 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 705 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 132 of file class.ilObjTestAccess.php.

References $DIC, $ilDB, $res, $user_id, and null.

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"];
    }

_preloadData()

static ilObjTestAccess::_preloadData (   $obj_ids,   $ref_ids  )

static

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

References $DIC, and ILIAS\Survey\Mode\getId().

                                                           : void
    {
        global $DIC;
        if ((new ilCertificateActiveValidator())->validate()) {
            self::$certificate_preloader = new ilCertificateObjectsForUserPreloader(new ilUserCertificateRepository());
            self::$certificate_preloader->preLoad($DIC['ilUser']->getId(), $obj_ids);
            self::$settings_result_summaries_by_obj_id = (new ScoreSettingsDatabaseRepository($DIC['ilDB']))
                ->getSettingsResultSummaryByObjIds($obj_ids);
        }
    }

Here is the call graph for this function:

canBeDelivered()

ilObjTestAccess::canBeDelivered

(

ilWACPath

$ilWACPath

)

Implements ilWACCheckingClass.

Definition at line 65 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 342 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 79 of file class.ilObjTestAccess.php.

References ILIAS\Data\Result\except(), and ILIAS\Test\Access\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 326 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 223 of file class.ilObjTestAccess.php.

References $DIC, $ilDB, $res, $user_id, and null.

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:

showCertificateFor()

ilObjTestAccess::showCertificateFor	(	int	$user_id,
		int	$obj_id
	)

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

References null.

                                                                 : bool
    {
        if (self::$certificate_preloader === null
            || !self::$certificate_preloader->isPreloaded($user_id, $obj_id)
            || !isset(self::$settings_result_summaries_by_obj_id[$obj_id])
            || self::$settings_result_summaries_by_obj_id[$obj_id]->getScoreReporting()
                === ScoreReportingTypes::SCORE_REPORTING_DISABLED) {
            return false;
        }

        $score_reporting = self::$settings_result_summaries_by_obj_id[$obj_id]->getScoreReporting();
        if ($score_reporting === ScoreReportingTypes::SCORE_REPORTING_IMMIDIATLY) {
            return true;
        }

        if ($score_reporting === ScoreReportingTypes::SCORE_REPORTING_DATE
            && self::$settings_result_summaries_by_obj_id->getReportingDate() < new \DateTimeImmutable('now', new DateTimeZone('UTC'))) {
            return true;
        }

        return false;
    }

updateTestResultCache()

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

staticprotected

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

References $DIC, $ilDB, and null.

                                                                          : 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 711 of file class.ilObjTestAccess.php.

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

Referenced by ilLOUtils\getTestResultLinkForUser().

                                                                          : 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 49 of file class.ilObjTestAccess.php.

$certificate_preloader

ilCertificateObjectsForUserPreloader ilObjTestAccess::$certificate_preloader = null

staticprivate

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

$db

ilDBInterface ilObjTestAccess::$db

private

Definition at line 45 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 47 of file class.ilObjTestAccess.php.

$rbac_system

ilRbacSystem ilObjTestAccess::$rbac_system

private

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

$settings_result_summaries_by_obj_id

array ilObjTestAccess::$settings_result_summaries_by_obj_id = []

staticprivate

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

$user

ilObjUser ilObjTestAccess::$user

private

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

---

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

• components/ILIAS/Test/classes/class.ilObjTestAccess.php