ILIAS\Modules\Test\AccessFileUploadAnswer Class Reference

Inheritance diagram for ILIAS\Modules\Test\AccessFileUploadAnswer:

Collaboration diagram for ILIAS\Modules\Test\AccessFileUploadAnswer:

Public Member Functions
	__construct (Container $container, Readable $readable, $object_id_of_test_id=[ilObjTest::class, '_getObjectIDFromTestID'], $references_of=[ilObject::class, '_getAllReferences'], $session=[ilSession::class, 'get'], callable $checkResultsAccess=null, Incident $incident=null)
	isPermitted (string $path)

Private Member Functions
	isAnonymous ()
	accessCodeOk (string $file, int $test_id)
	userDidUpload (int $test_id, string $file, string $code=null)
	activeIdOfFile (string $file, int $test)
	roleBasedCheck (int $test_id, array $references, string $file)
	canAccessResults (int $test_id, array $references, string $file)
	pathAndTestId (string $path)

Private Attributes
	$container
	$readable
	$object_id_of_test_id
	$references_of
	$session
	$checkResultsAccess
	$incident

Detailed Description

Definition at line 34 of file AccessFileUploadAnswer.php.

Constructor & Destructor Documentation

__construct()

ILIAS\Modules\Test\AccessFileUploadAnswer::__construct	(	Container	$container,
		Readable	$readable,
			$object_id_of_test_id = [ilObjTest::class,
		'_getObjectIDFromTestID']	,
			$references_of = [ilObject::class,
		'_getAllReferences']	,
			$session = [ilSession::class,
		'get']	,
		callable	$checkResultsAccess = null,
		Incident	$incident = null
	)

Parameters

Container	$container
Readable	$readable
	callable(int)	int $object_id_of_test_id
	callable(int)	int[] $references_of
	callable(string)	mixed $session
	callable(int,int,int)	bool $checkResultsAccess
Incident	$incident

Definition at line 60 of file AccessFileUploadAnswer.php.

References ILIAS\Modules\Test\AccessFileUploadAnswer\$checkResultsAccess, ILIAS\Modules\Test\AccessFileUploadAnswer\$container, ILIAS\Modules\Test\AccessFileUploadAnswer\$incident, ILIAS\Modules\Test\AccessFileUploadAnswer\$object_id_of_test_id, ILIAS\Modules\Test\AccessFileUploadAnswer\$readable, ILIAS\Modules\Test\AccessFileUploadAnswer\$references_of, and ILIAS\Modules\Test\AccessFileUploadAnswer\$session.

      {
        $this->container = $container;
        $this->readable = $readable;
        $this->incident = $incident ?? new Incident();
        $this->object_id_of_test_id = Closure::fromCallable($object_id_of_test_id);
        $this->references_of = Closure::fromCallable($references_of);
        $this->session = Closure::fromCallable($session);
        $this->checkResultsAccess = $checkResultsAccess ?? static function (int $reference, int $test_id, int $active_id): bool {
            $access = new ilTestAccess($reference, $test_id);
            return $access->checkResultsAccessForActiveId($active_id);
        };
    }

Member Function Documentation

accessCodeOk()

ILIAS\Modules\Test\AccessFileUploadAnswer::accessCodeOk ( string  $file, int  $test_id  )

private

Definition at line 107 of file AccessFileUploadAnswer.php.

References ILIAS\Modules\Test\AccessFileUploadAnswer\$session, ilTestSession\ACCESS_CODE_SESSION_INDEX, and ILIAS\Modules\Test\AccessFileUploadAnswer\userDidUpload().

Referenced by ILIAS\Modules\Test\AccessFileUploadAnswer\roleBasedCheck().

                                                              : bool
    {
        $code = ($this->session)(ilTestSession::ACCESS_CODE_SESSION_INDEX)[$test_id] ?? false;

        return $code && $this->userDidUpload($test_id, $file, $code);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

activeIdOfFile()

ILIAS\Modules\Test\AccessFileUploadAnswer::activeIdOfFile ( string  $file, int  $test  )

private

Definition at line 133 of file AccessFileUploadAnswer.php.

References $result.

Referenced by ILIAS\Modules\Test\AccessFileUploadAnswer\canAccessResults().

                                                             : ?int
    {
        $is_upload_question = 'EXISTS (SELECT 1 FROM qpl_qst_type INNER JOIN qpl_questions ON question_type_id = question_type_fi WHERE type_tag = %s AND tst_solutions.question_fi = qpl_questions.question_id)';
        $is_in_test = 'EXISTS (SELECT 1 FROM tst_active WHERE test_fi = %s AND active_id = active_fi)';

        $result = $this->container->database()->queryF(
            "SELECT active_fi, value1 FROM tst_solutions WHERE $is_upload_question AND $is_in_test",
            ['text', 'integer'],
            ['assFileUpload', $test]
        );

        while (($row = $this->container->database()->fetchAssoc($result))) {
            if ($row['value1'] === $file) {
                return (int) $row['active_fi'];
            }
        }

        return null;
    }

Here is the caller graph for this function:

canAccessResults()

ILIAS\Modules\Test\AccessFileUploadAnswer::canAccessResults ( int  $test_id, array  $references, string  $file  )

private

Parameters

int	$test_id
	string[]	$references
string	$file

Returns

bool

Definition at line 172 of file AccessFileUploadAnswer.php.

References ILIAS\Modules\Test\AccessFileUploadAnswer\activeIdOfFile().

Referenced by ILIAS\Modules\Test\AccessFileUploadAnswer\roleBasedCheck().

                                                                                     : bool
    {
        $active_id = $this->activeIdOfFile($file, $test_id);
        if (!$active_id) {
            return false;
        }

        return $this->incident->any(function (int $reference) use ($test_id, $active_id): bool {
            return ($this->checkResultsAccess)($reference, $test_id, $active_id);
        }, $references);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

isAnonymous()

ILIAS\Modules\Test\AccessFileUploadAnswer::isAnonymous ( )

private

Definition at line 102 of file AccessFileUploadAnswer.php.

Referenced by ILIAS\Modules\Test\AccessFileUploadAnswer\roleBasedCheck().

                                   : bool
    {
        return $this->container->user()->isAnonymous() || !$this->container->user()->getId();
    }

Here is the caller graph for this function:

isPermitted()

ILIAS\Modules\Test\AccessFileUploadAnswer::isPermitted

(

string

$path

)

Returns

Result<bool>

Implements ILIAS\Modules\Test\SimpleAccess.

Definition at line 81 of file AccessFileUploadAnswer.php.

References ILIAS\Modules\Test\AccessFileUploadAnswer\pathAndTestId(), and ILIAS\Modules\Test\AccessFileUploadAnswer\roleBasedCheck().

                                             : Result
    {
        $path_and_test = $this->pathAndTestId($path);

        if (!$path_and_test) {
            return new Error('Not a file upload path of test answers.');
        }
        if (!$path_and_test['test']) {
            return new Ok(false);
        }

        $object_id = (int) ($this->object_id_of_test_id)($path_and_test['test']);
        if (!$object_id) {
            return new Ok(false);
        }

        $references = array_map('intval', ($this->references_of)($object_id));

        return new Ok($this->readable->references($references) && $this->roleBasedCheck($path_and_test['test'], $references, $path_and_test['path']));
    }

Here is the call graph for this function:

pathAndTestId()

ILIAS\Modules\Test\AccessFileUploadAnswer::pathAndTestId ( string  $path )

private

Parameters

string

$path

Returns

null|array{test: int, path: string}

Definition at line 189 of file AccessFileUploadAnswer.php.

References $results.

Referenced by ILIAS\Modules\Test\AccessFileUploadAnswer\isPermitted().

                                                 : ?array
    {
        $results = [];
        if (!preg_match(':/assessment/tst_(\d+)/.*/([^/]+)$:', $path, $results)) {
            return null;
        }

        return [
            'test' => (int) $results[1],
            'path' => $results[2],
        ];
    }

Here is the caller graph for this function:

roleBasedCheck()

ILIAS\Modules\Test\AccessFileUploadAnswer::roleBasedCheck ( int  $test_id, array  $references, string  $file  )

private

Parameters

int	$test_id
	string[]	$references
string	$file

Returns

bool

Definition at line 160 of file AccessFileUploadAnswer.php.

References ILIAS\Modules\Test\AccessFileUploadAnswer\accessCodeOk(), ILIAS\Modules\Test\AccessFileUploadAnswer\canAccessResults(), ILIAS\Modules\Test\AccessFileUploadAnswer\isAnonymous(), and ILIAS\Modules\Test\AccessFileUploadAnswer\userDidUpload().

Referenced by ILIAS\Modules\Test\AccessFileUploadAnswer\isPermitted().

                                                                                   : bool
    {
        return $this->isAnonymous() ? $this->accessCodeOk($file, $test_id) : $this->canAccessResults($test_id, $references, $file) || $this->userDidUpload($test_id, $file);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

userDidUpload()

ILIAS\Modules\Test\AccessFileUploadAnswer::userDidUpload ( int  $test_id, string  $file, string  $code = null  )

private

Definition at line 114 of file AccessFileUploadAnswer.php.

References $result.

Referenced by ILIAS\Modules\Test\AccessFileUploadAnswer\accessCodeOk(), and ILIAS\Modules\Test\AccessFileUploadAnswer\roleBasedCheck().

                                                                                    : bool
    {
        $where = [
            'active_id = active_fi',
            'user_fi = %s',
            'value1 = %s',
            'anonymous_id ' . (null === $code ? 'IS' : '=') . ' %s',
            'test_fi = %s',
        ];

        $result = $this->container->database()->queryF(
            'SELECT 1 FROM tst_solutions WHERE EXISTS (SELECT 1 FROM tst_active WHERE ' . implode(' AND ', $where) . ')',
            ['integer', 'text', 'text', 'integer'],
            [$this->container->user()->getId(), $file, $code, $test_id]
        );

        return (bool) $this->container->database()->numRows($result);
    }

Here is the caller graph for this function:

Field Documentation

$checkResultsAccess

ILIAS\Modules\Test\AccessFileUploadAnswer::$checkResultsAccess

private

Definition at line 47 of file AccessFileUploadAnswer.php.

Referenced by ILIAS\Modules\Test\AccessFileUploadAnswer\__construct().

$container

ILIAS\Modules\Test\AccessFileUploadAnswer::$container

private

Definition at line 37 of file AccessFileUploadAnswer.php.

Referenced by ILIAS\Modules\Test\AccessFileUploadAnswer\__construct().

$incident

ILIAS\Modules\Test\AccessFileUploadAnswer::$incident

private

Definition at line 49 of file AccessFileUploadAnswer.php.

Referenced by ILIAS\Modules\Test\AccessFileUploadAnswer\__construct().

$object_id_of_test_id

ILIAS\Modules\Test\AccessFileUploadAnswer::$object_id_of_test_id

private

Definition at line 41 of file AccessFileUploadAnswer.php.

Referenced by ILIAS\Modules\Test\AccessFileUploadAnswer\__construct().

$readable

ILIAS\Modules\Test\AccessFileUploadAnswer::$readable

private

Definition at line 39 of file AccessFileUploadAnswer.php.

Referenced by ILIAS\Modules\Test\AccessFileUploadAnswer\__construct().

$references_of

ILIAS\Modules\Test\AccessFileUploadAnswer::$references_of

private

Definition at line 43 of file AccessFileUploadAnswer.php.

Referenced by ILIAS\Modules\Test\AccessFileUploadAnswer\__construct().

$session

ILIAS\Modules\Test\AccessFileUploadAnswer::$session

private

Definition at line 45 of file AccessFileUploadAnswer.php.

Referenced by ILIAS\Modules\Test\AccessFileUploadAnswer\__construct(), and ILIAS\Modules\Test\AccessFileUploadAnswer\accessCodeOk().

---

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

• Modules/Test/classes/AccessFileUploadAnswer.php