assFileUpload Class Reference

Class for file upload questions. More...

Inheritance diagram for assFileUpload:

Collaboration diagram for assFileUpload:

Public Member Functions
	isComplete ()
	Returns true, if the question is complete for use. More...
	saveToDb (?int $original_id=null)
	Saves a assFileUpload object to a database. More...
	saveAdditionalQuestionDataToDb ()
	Saves a record to the question types additional data table. More...
	loadFromDb (int $question_id)
	getMaximumPoints ()
	calculateReachedPoints (int $active_id, ?int $pass=null, bool $authorized_solution=true)
	checkUpload ()
	Check file upload. More...
	getFileUploadPath ($test_id, $active_id, $question_id=null)
	Returns the filesystem path for file uploads. More...
	getFileUploadPathWeb ($test_id, $active_id, $question_id=null)
	Returns the file upload path for web accessible files of a question. More...
	getUploadedFiles (int $active_id, ?int $pass=null, bool $authorized=true)
	getPreviewFileUploads (ilAssQuestionPreviewSession $previewSession)
	getUploadedFilesForWeb ($active_id, $pass)
	Returns the web accessible uploaded files for an active user in a given pass. More...
	getMaxFilesizeAsString ()
	determineMaxFilesize ()
	saveWorkingData (int $active_id, ?int $pass=null, bool $authorized=true)
	getUserSolutionPreferingIntermediate (int $active_id, ?int $pass=null)
	removeIntermediateSolution (int $active_id, int $pass)
	getQuestionType ()
	getAdditionalTableName ()
	getAnswerTableName ()
	deleteAnswers ($question_id)
	getRTETextWithMediaObjects ()
	Collects all text in the question which could contain media objects which were created with the Rich Text Editor. More...
	getBestSolution ($active_id, $pass)
	getMaxSize ()
	setMaxSize (?int $value)
	getAllowedExtensionsArray ()
	getAllowedExtensions ()
	setAllowedExtensions (string $a_value)
	hasFileUploads (int $test_id)
	deliverFileUploadZIPFile (int $ref_id, int $test_id, string $test_title)
	isCompletionBySubmissionEnabled ()
	setCompletionBySubmission (bool $bool)
	buildTestPresentationConfig ()
	toLog (AdditionalInformationGenerator $additional_info)
	MUST return an array of the question settings that can be stored in the log. More...
	solutionValuesToText (array $solution_values)
	MUST convert the given solution values into text. More...
	getCorrectSolutionForTextOutput (int $active_id, int $pass)
Public Member Functions inherited from assQuestion
	getQuestionType ()
	isComplete ()
	saveWorkingData (int $active_id, ?int $pass=null, bool $authorized=true)
	calculateReachedPoints (int $active_id, ?int $pass=null, bool $authorized_solution=true)
	getAdditionalTableName ()
	getAnswerTableName ()
	toLog (AdditionalInformationGenerator $additional_info)
	MUST return an array of the question settings that can be stored in the log. More...
	getCurrentUser ()
	getShuffler ()
	setShuffler (Transformation $shuffler)
	setProcessLocker (ilAssQuestionProcessLocker $processLocker)
	getProcessLocker ()
	fromXML (string $importdirectory, int $user_id, ilQTIItem $item, int $questionpool_id, ?int $tst_id, ?ilObject &$tst_object, int &$question_counter, array $import_mapping)
	toXML (bool $a_include_header=true, bool $a_include_binary=true, bool $a_shuffle=false, bool $test_output=false, bool $force_image_references=false)
	Returns a QTI xml representation of the question. More...
	setTitle (string $title="")
	setId (int $id=-1)
	setTestId (int $id=-1)
	setComment (string $comment="")
	setShuffle (?bool $shuffle=true)
	setAuthor (string $author="")
	setOwner (int $owner=-1)
	getTitle ()
	getTitleForHTMLOutput ()
	getTitleFilenameCompliant ()
	getId ()
	getShuffle ()
	getTestId ()
	getComment ()
	getDescriptionForHTMLOutput ()
	getThumbSize ()
	setThumbSize (int $a_size)
	getMinimumThumbSize ()
	getMaximumThumbSize ()
	getAuthor ()
	getAuthorForHTMLOutput ()
	getOwner ()
	getObjId ()
	setObjId (int $obj_id=0)
	getLifecycle ()
	setLifecycle (ilAssQuestionLifecycle $lifecycle)
	setExternalId (?string $external_id)
	getExternalId ()
	getSuggestedSolutionOutput ()
	getSuggestedSolutions ()
	getReachedPoints (int $active_id, int $pass)
	getMaximumPoints ()
	getAdjustedReachedPoints (int $active_id, int $pass, bool $authorized_solution=true)
	calculateResultsFromSolution (int $active_id, int $pass)
	Calculates the question results from a previously saved question solution. More...
	persistWorkingState (int $active_id, $pass, bool $authorized=true)
	persists the working state for current testactive and testpass More...
	persistPreviewState (ilAssQuestionPreviewSession $preview_session)
	persists the preview state for current user and question More...
	validateSolutionSubmit ()
	getSuggestedSolutionPath ()
	getImagePath ($question_id=null, $object_id=null)
	Returns the image path for web accessable images of a question. More...
	getSuggestedSolutionPathWeb ()
	getImagePathWeb ()
	Returns the web image path for web accessable images of a question. More...
	getTestOutputSolutions (int $activeId, int $pass)
	getUserSolutionPreferingIntermediate (int $active_id, ?int $pass=null)
	getSolutionValues (int $active_id, ?int $pass=null, bool $authorized=true)
	Loads solutions of a given user from the database an returns it. More...
	deleteAnswers (int $question_id)
	deleteAdditionalTableData (int $question_id)
	delete (int $question_id)
	getTotalAnswers ()
	cloneXHTMLMediaObjectsOfQuestion (int $source_question_id)
	createPageObject ()
	clonePageOfQuestion (int $a_q_id)
	getPageOfQuestion ()
	setOriginalId (?int $original_id)
	getOriginalId ()
	fixSvgToPng (string $imageFilenameContainingString)
	fixUnavailableSkinImageSources (string $html)
	loadFromDb (int $question_id)
	createNewQuestion (bool $a_create_page=true)
	Creates a new question without an owner when a new question is created This assures that an ID is given to the question if a file upload or something else occurs. More...
	saveQuestionDataToDb (?int $original_id=null)
	duplicate (bool $for_test=true, string $title='', string $author='', int $owner=-1, $test_obj_id=null)
	copyObject (int $target_parent_id, string $title='')
	createNewOriginalFromThisDuplicate (int $target_parent_id, string $target_question_title='')
	saveToDb (?int $original_id=null)
	deleteSuggestedSolutions ()
	getSuggestedSolution (int $subquestion_index=0)
	resolveInternalLink (string $internal_link)
	resolveSuggestedSolutionLinks ()
	getInternalLinkHref (string $target)
	syncWithOriginal ()
	getPoints ()
	setPoints (float $points)
	getSolutionMaxPass (int $active_id)
	isWriteable ()
	calculateReachedPointsFromPreviewSession (ilAssQuestionPreviewSession $preview_session)
	isPreviewSolutionCorrect (ilAssQuestionPreviewSession $preview_session)
	adjustReachedPointsByScoringOptions (float $points, int $active_id)
	Adjust the given reached points by checks for all special scoring options in the test container. More...
	buildHashedImageFilename (string $plain_image_filename, bool $unique=false)
	getQuestion ()
	getQuestionForHTMLOutput ()
	setQuestion (string $question="")
	getQuestionTypeID ()
	cleanupMediaObjectUsage ()
	getInstances ()
	getActiveUserData (int $active_id)
	Returns the user id and the test id for a given active id. More...
	hasSpecificFeedback ()
	getNrOfTries ()
	setNrOfTries (int $a_nr_of_tries)
	setExportImagePath (string $path)
	formatSAQuestion ($a_q)
	setPreventRteUsage (bool $prevent_rte_usage)
	getPreventRteUsage ()
	migrateContentForLearningModule (ilAssSelfAssessmentMigrator $migrator)
	setSelfAssessmentEditingMode (bool $selfassessmenteditingmode)
	getSelfAssessmentEditingMode ()
	setDefaultNrOfTries (int $defaultnroftries)
	getDefaultNrOfTries ()
	syncSkillAssignments (int $srcParentId, int $srcQuestionId, int $trgParentId, int $trgQuestionId)
	isAnswered (int $active_id, int $pass)
	getAdditionalContentEditingMode ()
	setAdditionalContentEditingMode (?string $additionalContentEditingMode)
	isAdditionalContentEditingModePageObject ()
	isValidAdditionalContentEditingMode (string $additionalContentEditingMode)
	getValidAdditionalContentEditingModes ()
	getHtmlUserSolutionPurifier ()
	getHtmlQuestionContentPurifier ()
	setLastChange (int $lastChange)
	getLastChange ()
	removeIntermediateSolution (int $active_id, int $pass)
	removeCurrentSolution (int $active_id, int $pass, bool $authorized=true)
	saveCurrentSolution (int $active_id, int $pass, $value1, $value2, bool $authorized=true, $tstamp=0)
	updateCurrentSolution (int $solutionId, $value1, $value2, bool $authorized=true)
	updateCurrentSolutionsAuthorization (int $activeId, int $pass, bool $authorized, bool $keepTime=false)
	setStep ($step)
	getStep ()
	toJSON ()
	intermediateSolutionExists (int $active_id, int $pass)
	authorizedSolutionExists (int $active_id, ?int $pass)
	authorizedOrIntermediateSolutionExists (int $active_id, int $pass)
	lookupForExistingSolutions (int $activeId, int $pass)
	Lookup if an authorized or intermediate solution exists. More...
	isAddableAnswerOptionValue (int $qIndex, string $answerOptionValue)
	addAnswerOptionValue (int $qIndex, string $answerOptionValue, float $points)
	removeAllExistingSolutions ()
	removeExistingSolutions (int $activeId, int $pass)
	resetUsersAnswer (int $activeId, int $pass)
	removeResultRecord (int $activeId, int $pass)
	fetchValuePairsFromIndexedValues (array $indexedValues)
	fetchIndexedValuesFromValuePairs (array $value_pairs)
	updateTimestamp ()
	getTestPresentationConfig ()
	hasWritableOriginalInQuestionPool ()
	answerToParticipantInteraction (AdditionalInformationGenerator $additional_info, int $test_ref_id, int $active_id, int $pass, string $source_ip, TestParticipantInteractionTypes $interaction_type)
	toQuestionAdministrationInteraction (AdditionalInformationGenerator $additional_info, int $test_ref_id, TestQuestionAdministrationInteractionTypes $interaction_type)
	getSolutionForTextOutput (int $active_id, int $pass)
	getCorrectSolutionForTextOutput (int $active_id, int $pass)
	getVariablesAsTextArray (int $active_id, int $pass)
	validateSolutionSubmit ()
	toLog (AdditionalInformationGenerator $additional_info)
	answerToParticipantInteraction (AdditionalInformationGenerator $additional_info, int $test_id, int $active_id, int $pass, string $source_ip, TestParticipantInteractionTypes $interaction_type)
	toQuestionAdministrationInteraction (AdditionalInformationGenerator $additional_info, int $test_id, TestQuestionAdministrationInteractionTypes $interaction_type)
	saveAdditionalQuestionDataToDb ()
	Saves a record to the question types additional data table. More...
Public Member Functions inherited from ilObjFileHandlingQuestionType
	hasFileUploads (int $test_id)
	deliverFileUploadZIPFile (int $ref_id, int $test_id, string $test_title)
	getFileUploadPath (int $test_id, int $active_id, ?int $question_id=null)

Data Fields
const	REUSE_FILES_TBL_POSTVAR = 'reusefiles'
const	DELETE_FILES_TBL_POSTVAR = 'deletefiles'
Data Fields inherited from assQuestion
const	ADDITIONAL_CONTENT_EDITING_MODE_RTE = 'default'
const	ADDITIONAL_CONTENT_EDITING_MODE_IPE = 'pageobject'
const	TRIM_PATTERN = '/^[\p{C}\p{Z}]+|[\p{C}\p{Z}]+$/u'
ilAssQuestionFeedback	$feedbackOBJ
bool	$prevent_rte_usage = false
bool	$selfassessmenteditingmode = false
int	$defaultnroftries = 0
string	$questionActionCmd = 'handleQuestionAction'
const	KEY_VALUES_IMPLOSION_SEPARATOR = ':'

Protected Member Functions
	calculateReachedPointsForSolution (?array $user_solution)
	getPreviewFileUploadPath ($userId)
	Returns the filesystem path for file uploads. More...
	getPreviewFileUploadPathWeb (int $user_id)
	deletePreviewFileUploads ($userId, $userSolution, $files)
	getMaxFilesizeInBytes ()
	resolveRIDStoDelete ()
	removeSolutionRecordById (int $solution_id)
	savePreviewData (ilAssQuestionPreviewSession $previewSession)
	isFileDeletionAction ()
	isFileDeletionSubmitAvailable ()
	isFileReuseSubmitAvailable ()
	isFileReuseHandlingRequired ()
	isFileUploadAvailable ()
	solutionValuesToLog (AdditionalInformationGenerator $additional_info, array $solution_values)
	MUST convert the given solution values into an array or a string that can be stored in the log. More...
Protected Member Functions inherited from assQuestion
	solutionValuesToLog (AdditionalInformationGenerator $additional_info, array $solution_values)
	MUST convert the given solution values into an array or a string that can be stored in the log. More...
	solutionValuesToText (array $solution_values)
	MUST convert the given solution values into text. More...
	getQuestionAction ()
	isNonEmptyItemListPostSubmission (string $post_submission_field_name)
	savePreviewData (ilAssQuestionPreviewSession $preview_session)
	deletePageOfQuestion (int $question_id)
	cloneQuestionTypeSpecificProperties (self $target)
	removeAllImageFiles (string $image_target_path)
	onDuplicate (int $original_parent_id, int $original_question_id, int $duplicate_parent_id, int $duplicate_question_id)
	afterSyncWithOriginal (int $original_question_id, int $clone_question_id, int $original_parent_id, int $clone_parent_id)
	onCopy (int $sourceParentId, int $sourceQuestionId, int $targetParentId, int $targetQuestionId)
	duplicateComments (int $parent_source_id, int $source_id, int $parent_target_id, int $target_id)
	deleteComments ()
	getNotesManager ()
	getNotesDataService ()
	getNotesRepo ()
	cloneSuggestedSolutions (int $source_question_id, int $target_question_id)
	duplicateSuggestedSolutionFiles (int $parent_id, int $question_id)
	Duplicates the files of a suggested solution if the question is duplicated. More...
	cloneSuggestedSolutionFiles (int $source_question_id, int $target_question_id)
	copySuggestedSolutions (int $target_question_id)
	ensureNonNegativePoints (float $points)
	purifyAndPrepareTextAreaOutput (string $content)
	getRTETextWithMediaObjects ()
	getSelfAssessmentFormatter ()
	lmMigrateQuestionTypeGenericContent (ilAssSelfAssessmentMigrator $migrator)
	lmMigrateQuestionTypeSpecificContent (ilAssSelfAssessmentMigrator $migrator)
	duplicateSkillAssignments (int $srcParentId, int $srcQuestionId, int $trgParentId, int $trgQuestionId)
	buildQuestionDataQuery ()
	getCurrentSolutionResultSet (int $active_id, int $pass, bool $authorized=true)
	removeSolutionRecordById (int $solutionId)
	getSolutionRecordById (int $solutionId)
	deleteDummySolutionRecord (int $activeId, int $passIndex)
	isDummySolutionRecord (array $solutionRecord)
	deleteSolutionRecordByValues (int $activeId, int $passIndex, bool $authorized, array $matchValues)
	duplicateIntermediateSolutionAuthorized (int $activeId, int $passIndex)
	forceExistingIntermediateSolution (int $activeId, int $passIndex, bool $considerDummyRecordCreation)
	lookupMaxStep (int $active_id, int $pass)
	buildTestPresentationConfig ()
	getSuggestedSolutionsRepo ()
	loadSuggestedSolutions ()
	answerToLog (AdditionalInformationGenerator $additional_info, int $active_id, int $pass)

Protected Attributes
const	HAS_SPECIFIC_FEEDBACK = false
int	$maxsize = null
string	$allowedextensions = ''
	$completion_by_submission = false
Protected Attributes inherited from assQuestion
const	HAS_SPECIFIC_FEEDBACK = true
GeneralQuestionPropertiesRepository	$questionrepository
RequestDataCollector	$questionpool_request
QuestionFiles	$question_files
ilAssQuestionProcessLocker	$processLocker
ilTestQuestionConfig	$testQuestionConfig
SuggestedSolutionsDatabaseRepository	$suggestedsolution_repo
ILIAS	$ilias
ilGlobalPageTemplate	$tpl
ilLanguage	$lng
ilDBInterface	$db
ilObjUser	$current_user
SkillUsageService	$skillUsageService
HTTPServices	$http
Refinery	$refinery
Transformation	$shuffler
LoggingServices	$log
Container	$dic
ilAssQuestionLifecycle	$lifecycle
ilAssQuestionPage	$page
TestResultRepository	$test_result_repository
int	$id
string	$title
string	$comment
int	$owner
string	$author
int	$thumb_size
string	$question
float	$points = 0.0
bool	$shuffle = true
int	$test_id
int	$obj_id = 0
int	$original_id = null
int	$lastChange = null
string	$external_id = null
int	$step = null
array	$suggested_solutions

Private Attributes
ParticipantRepository	$participant_repository
ILIAS ResourceStorage Services	$irss
ILIAS FileDelivery Services	$file_delivery
ILIAS FileUpload FileUpload	$file_upload
string	$current_cmd

Additional Inherited Members
Static Public Member Functions inherited from assQuestion
static	setForcePassResultUpdateEnabled (bool $force_pass_results_update_enabled)
static	isForcePassResultUpdateEnabled ()
static	_getSuggestedSolutionOutput (int $question_id)
static	_getReachedPoints (int $active_id, int $question_id, int $pass)
static	isFileAvailable (string $file)
static	saveOriginalId (int $questionId, int $originalId)
static	resetOriginalId (int $questionId)
static	instantiateQuestion (int $question_id)
static	_getSolutionMaxPass (int $question_id, int $active_id)
	Returns the maximum pass a users question solution. More...
static	getFeedbackClassNameByQuestionType (string $questionType)
static	_questionExistsInTest (int $question_id, int $test_id)
static	lookupParentObjId (int $question_id)
static	implodeKeyValues (array $keyValues)
static	explodeKeyValues (string $keyValues)
static	convertISO8601FormatH_i_s_ExtendedToSeconds (string $time)
static	extendedTrim (string $value)
	Trim non-printable characters from the beginning and end of a string. More...
Static Protected Member Functions inherited from assQuestion
static	getNumExistingSolutionRecords (int $activeId, int $pass, int $questionId)
Static Protected Attributes inherited from assQuestion
static	$force_pass_results_update_enabled = false
static	$imageSourceFixReplaceMap

Detailed Description

Class for file upload questions.

Author

Helmut Schottmüller helmu.nosp@m.t.sc.nosp@m.hottm.nosp@m.uell.nosp@m.er@ma.nosp@m.c.co.nosp@m.m

Björn Heyser bheys.nosp@m.er@d.nosp@m.ataba.nosp@m.y.de

Maximilian Becker mbeck.nosp@m.er@d.nosp@m.ataba.nosp@m.y.de

Version

$Id$

Definition at line 38 of file class.assFileUpload.php.

Member Function Documentation

buildTestPresentationConfig()

assFileUpload::buildTestPresentationConfig

(

)

Reimplemented from assQuestion.

Definition at line 869 of file class.assFileUpload.php.

                                                 : ilTestQuestionConfig
    {
        return parent::buildTestPresentationConfig()
            ->setFormChangeDetectionEnabled(false);
    }

References ilTestQuestionConfig\setFormChangeDetectionEnabled().

Here is the call graph for this function:

calculateReachedPoints()

assFileUpload::calculateReachedPoints	(	int	$active_id,
		?int	$pass = null,
		bool	$authorized_solution = true
	)

Reimplemented from assQuestion.

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

     : float {
        if (!$this->isCompletionBySubmissionEnabled()) {
            return 0.0;
        }
 
        if ($pass === null) {
            $pass = $this->getSolutionMaxPass($active_id);
        }
 
        $result = $this->getCurrentSolutionResultSet($active_id, $pass, $authorized_solution);
 
        while ($data = $this->db->fetchAssoc($result)) {
            if ($this->isDummySolutionRecord($data)) {
                continue;
            }
 
            return $this->getPoints();
        }
 
        return 0.0;
    }

calculateReachedPointsForSolution()

assFileUpload::calculateReachedPointsForSolution ( ?array  $user_solution )

protected

Definition at line 211 of file class.assFileUpload.php.

                                                                               : float
    {
        if ($this->isCompletionBySubmissionEnabled()
            && is_array($user_solution)
            && $user_solution !== []) {
            return $this->getPoints();
        }
 
        return 0.0;
    }

checkUpload()

assFileUpload::checkUpload

(

)

Check file upload.

Returns

boolean Input ok, true/false

Definition at line 227 of file class.assFileUpload.php.

                                 : bool
    {
        $this->lng->loadLanguageModule('form');
 
        foreach (
            $this->file_upload->getResults() as $upload_result
        ) { // only one supported at the moment, but we check all
            if (!$upload_result->isOK()) {
                $this->tpl->setOnScreenMessage('failure', $upload_result->getStatus()->getMessage(), true);
                return false;
            }
 
            // check file size
            $size_bytes = $upload_result->getSize();
            if ($size_bytes > $this->getMaxFilesizeInBytes()) {
                $this->tpl->setOnScreenMessage('failure', $this->lng->txt('form_msg_file_size_exceeds'), true);
                return false;
            }
 
            // check suffixes
            if (count($this->getAllowedExtensionsArray())) {
                $filename_arr = pathinfo($upload_result->getName());
                $suffix = $filename_arr['extension'] ?? '';
                $mimetype = $upload_result->getMimeType();
                if ($suffix === '') {
                    $this->tpl->setOnScreenMessage('failure', $this->lng->txt('form_msg_file_missing_file_ext'), true);
                    return false;
                }
 
                if (!in_array(strtolower($suffix), $this->getAllowedExtensionsArray(), true)) {
                    $this->tpl->setOnScreenMessage('failure', $this->lng->txt('form_msg_file_wrong_file_type'), true);
                    return false;
                }
            }
            // virus handling already done in upload-service
        }
        return true;
    }

References ILIAS\Repository\lng().

Here is the call graph for this function:

deleteAnswers()

assFileUpload::deleteAnswers

(

$question_id

)

Parameters

integer

$question_id

The question id which should be deleted in the answers table

Definition at line 774 of file class.assFileUpload.php.

                                               : void
    {
    }

deletePreviewFileUploads()

assFileUpload::deletePreviewFileUploads (   $userId,   $userSolution,   $files  )

protected

Definition at line 453 of file class.assFileUpload.php.

    {
        foreach ($files as $name) {
            if (isset($userSolution[$name])) {
                unset($userSolution[$name]);
                @unlink($this->getPreviewFileUploadPath($userId) . $name);
            }
        }
 
        return $userSolution;
    }

deliverFileUploadZIPFile()

assFileUpload::deliverFileUploadZIPFile	(	int	$ref_id,
		int	$test_id,
		string	$test_title
	)

Implements ilObjFileHandlingQuestionType.

Definition at line 843 of file class.assFileUpload.php.

                                                                                           : void
    {
        $exporter = new ilAssFileUploadUploadsExporter(
            $this->db,
            $this->lng,
            $ref_id,
            $test_id
        );
 
        $exporter->setTestTitle($test_title);
        $exporter->setQuestion($this);
 
        $exporter->buildAndDownload();
    }

References ILIAS\Repository\lng().

Here is the call graph for this function:

determineMaxFilesize()

assFileUpload::determineMaxFilesize

(

)

Definition at line 489 of file class.assFileUpload.php.

                                          : int
    {
        $upload_max_filesize = ini_get('upload_max_filesize');
        $post_max_size = ini_get('post_max_size');
 
        //convert from short-string representation to "real" bytes
        $multiplier_a = [ "K" => 1024, "M" => 1024 * 1024, "G" => 1024 * 1024 * 1024 ];
        $umf_parts = preg_split(
            "/(\d+)([K|G|M])/",
            $upload_max_filesize,
            -1,
            PREG_SPLIT_DELIM_CAPTURE | PREG_SPLIT_NO_EMPTY
        );
        $pms_parts = preg_split(
            "/(\d+)([K|G|M])/",
            $post_max_size,
            -1,
            PREG_SPLIT_DELIM_CAPTURE | PREG_SPLIT_NO_EMPTY
        );
 
        if (count($umf_parts) === 2) {
            $upload_max_filesize = $umf_parts[0] * $multiplier_a[$umf_parts[1]];
        }
 
        if (count($pms_parts) === 2) {
            $post_max_size = $pms_parts[0] * $multiplier_a[$pms_parts[1]];
        }
 
        // use the smaller one as limit
        $max_filesize = min($upload_max_filesize, $post_max_size);
 
        if (!$max_filesize) {
            $max_filesize = max($upload_max_filesize, $post_max_size);
            return $max_filesize;
        }
 
        return $max_filesize;
    }

References PREG_SPLIT_DELIM_CAPTURE.

getAdditionalTableName()

assFileUpload::getAdditionalTableName

(

)

Reimplemented from assQuestion.

Definition at line 761 of file class.assFileUpload.php.

                                            : string
    {
        return 'qpl_qst_fileupload';
    }

Referenced by loadFromDb(), and saveAdditionalQuestionDataToDb().

Here is the caller graph for this function:

getAllowedExtensions()

assFileUpload::getAllowedExtensions

(

)

Definition at line 812 of file class.assFileUpload.php.

                                          : string
    {
        return $this->allowedextensions;
    }

Referenced by saveAdditionalQuestionDataToDb().

Here is the caller graph for this function:

getAllowedExtensionsArray()

assFileUpload::getAllowedExtensionsArray

(

)

Definition at line 803 of file class.assFileUpload.php.

                                               : array
    {
        if ($this->allowedextensions === '') {
            return [];
        }
 
        return array_filter(array_map('trim', explode(',', $this->allowedextensions)));
    }

getAnswerTableName()

assFileUpload::getAnswerTableName

(

)

Reimplemented from assQuestion.

Definition at line 766 of file class.assFileUpload.php.

                                        : string
    {
        return '';
    }

getBestSolution()

assFileUpload::getBestSolution	(		$active_id,
			$pass
	)

Definition at line 787 of file class.assFileUpload.php.

                                                      : array
    {
        $user_solution = [];
        return $user_solution;
    }

getCorrectSolutionForTextOutput()

assFileUpload::getCorrectSolutionForTextOutput	(	int	$active_id,
		int	$pass
	)

Reimplemented from assQuestion.

Definition at line 949 of file class.assFileUpload.php.

                                                                              : string
    {
        return '';
    }

getFileUploadPath()

assFileUpload::getFileUploadPath	(		$test_id,
			$active_id,
			$question_id = null
	)

Returns the filesystem path for file uploads.

Definition at line 269 of file class.assFileUpload.php.

                                                                                : string
    {
        if (is_null($question_id)) {
            $question_id = $this->getId();
        }
        return CLIENT_WEB_DIR . "/assessment/tst_{$test_id}/{$active_id}/{$question_id}/files/";
    }

References CLIENT_WEB_DIR, and ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

getFileUploadPathWeb()

assFileUpload::getFileUploadPathWeb	(		$test_id,
			$active_id,
			$question_id = null
	)

Returns the file upload path for web accessible files of a question.

@access public

Definition at line 290 of file class.assFileUpload.php.

    {
        if (is_null($question_id)) {
            $question_id = $this->getId();
        }
        $webdir = ilFileUtils::removeTrailingPathSeparators(CLIENT_WEB_DIR)
            . "/assessment/tst_{$test_id}/{$active_id}/{$question_id}/files/";
        return str_replace(
            ilFileUtils::removeTrailingPathSeparators(ILIAS_ABSOLUTE_PATH),
            ilFileUtils::removeTrailingPathSeparators(ILIAS_HTTP_PATH),
            $webdir
        );
    }

References CLIENT_WEB_DIR, ILIAS\Survey\Mode\getId(), and ilFileUtils\removeTrailingPathSeparators().

Here is the call graph for this function:

getMaxFilesizeAsString()

assFileUpload::getMaxFilesizeAsString

(

)

Definition at line 465 of file class.assFileUpload.php.

                                            : string
    {
        $size = $this->getMaxFilesizeInBytes();
        if ($size < 1024) {
            return sprintf('%d Bytes', $size);
        }
 
        if ($size < 1024 * 1024) {
            return  sprintf('%.1f KB', $size / 1024);
        }
 
        return sprintf('%.1f MB', $size / 1024 / 1024);
    }

getMaxFilesizeInBytes()

assFileUpload::getMaxFilesizeInBytes ( )

protected

Definition at line 479 of file class.assFileUpload.php.

                                              : int
    {
        if ($this->getMaxSize() > 0) {
            return $this->getMaxSize();
        }
 
        return $this->determineMaxFilesize();
    }

getMaximumPoints()

assFileUpload::getMaximumPoints

(

)

Reimplemented from assQuestion.

Definition at line 180 of file class.assFileUpload.php.

                                      : float
    {
        return $this->getPoints();
    }

References assQuestion\getPoints().

Referenced by isComplete().

Here is the call graph for this function:

Here is the caller graph for this function:

getMaxSize()

assFileUpload::getMaxSize

(

)

Definition at line 793 of file class.assFileUpload.php.

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

Referenced by saveAdditionalQuestionDataToDb().

Here is the caller graph for this function:

getPreviewFileUploadPath()

assFileUpload::getPreviewFileUploadPath (   $userId )

protected

Returns the filesystem path for file uploads.

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

                                                        : string
    {
        return CLIENT_WEB_DIR . "/assessment/qst_preview/{$userId}/{$this->getId()}/fileuploads/";
    }

References CLIENT_WEB_DIR.

getPreviewFileUploadPathWeb()

assFileUpload::getPreviewFileUploadPathWeb ( int  $user_id )

protected

Definition at line 304 of file class.assFileUpload.php.

                                                                : string
    {
        $webdir = ilFileUtils::removeTrailingPathSeparators(CLIENT_WEB_DIR)
            . "/assessment/qst_preview/{$user_id}/{$this->getId()}/fileuploads/";
        return str_replace(
            ilFileUtils::removeTrailingPathSeparators(ILIAS_ABSOLUTE_PATH),
            ilFileUtils::removeTrailingPathSeparators(ILIAS_HTTP_PATH),
            $webdir
        );
    }

References CLIENT_WEB_DIR, and ilFileUtils\removeTrailingPathSeparators().

Here is the call graph for this function:

getPreviewFileUploads()

assFileUpload::getPreviewFileUploads

(

ilAssQuestionPreviewSession

$previewSession

)

Definition at line 341 of file class.assFileUpload.php.

                                                                                      : array
    {
        if ($previewSession->getParticipantsSolution() === false || $previewSession->getParticipantsSolution() === null) {
            return [];
        }
 
        return $previewSession->getParticipantsSolution();
    }

References ilAssQuestionPreviewSession\getParticipantsSolution().

Here is the call graph for this function:

getQuestionType()

assFileUpload::getQuestionType

(

)

Reimplemented from assQuestion.

Definition at line 756 of file class.assFileUpload.php.

                                     : string
    {
        return 'assFileUpload';
    }

getRTETextWithMediaObjects()

assFileUpload::getRTETextWithMediaObjects

(

)

Collects all text in the question which could contain media objects which were created with the Rich Text Editor.

Reimplemented from assQuestion.

Definition at line 782 of file class.assFileUpload.php.

                                                : string
    {
        return parent::getRTETextWithMediaObjects();
    }

getUploadedFiles()

assFileUpload::getUploadedFiles	(	int	$active_id,
		?int	$pass = null,
		bool	$authorized = true
	)

Definition at line 315 of file class.assFileUpload.php.

     : array {
        if (is_null($pass)) {
            $pass = $this->getSolutionMaxPass($active_id);
        }
        // fau: testNav - check existing value1 because the intermediate solution will have a dummy entry
        $result = $this->db->queryF(
            'SELECT * FROM tst_solutions WHERE active_fi = %s '
            . 'AND question_fi = %s AND pass = %s AND authorized = %s '
            . 'AND value1 IS NOT NULL ORDER BY tstamp',
            ['integer', 'integer', 'integer', 'integer'],
            [$active_id, $this->getId(), $pass, (int) $authorized]
        );
        // fau.
        $found = [];
 
        while ($data = $this->db->fetchAssoc($result)) {
            array_push($found, $data);
        }
 
        return $found;
    }

getUploadedFilesForWeb()

assFileUpload::getUploadedFilesForWeb	(		$active_id,
			$pass
	)

Returns the web accessible uploaded files for an active user in a given pass.

Returns

array Results

Definition at line 355 of file class.assFileUpload.php.

                                                             : array
    {
        $found = $this->getUploadedFiles($active_id, $pass);
        $result = $this->db->queryF(
            'SELECT test_fi FROM tst_active WHERE active_id = %s',
            ['integer'],
            [$active_id]
        );
        if ($result->numRows() == 1) {
            $row = $this->db->fetchAssoc($result);
            $test_id = $row['test_fi'];
            $path = $this->getFileUploadPathWeb($test_id, $active_id);
            foreach ($found as $idx => $data) {
                // depending on whether the files are already stored in the IRSS or not, the files are compiled differently here.
                // this can be removed with ILIAs 10 and switched exclusively to the IRSS variant.
                // We recommend then to revise the whole handling of files
 
                if ($data['value2'] === 'rid') {
                    $rid = $this->irss->manage()->find($data['value1']);
                    if ($rid === null) {
                        continue;
                    }
                    $revision = $this->irss->manage()->getCurrentRevision($rid);
                    $stream = $this->irss->consume()->stream($rid)->getStream();
                    $url = $this->file_delivery->buildTokenURL(
                        $stream,
                        $revision->getTitle(),
                        Disposition::ATTACHMENT,
                        $this->current_user->getId(),
                        1
                    );
 
                    $path = (string) $url;
                    $found[$idx]['webpath'] = $path;
                    $found[$idx]['value2'] = $revision->getTitle();
                } else {
                    $found[$idx]['webpath'] = $path;
                }
            }
        }
        return $found;
    }

References $data, $path, and $url.

getUserSolutionPreferingIntermediate()

assFileUpload::getUserSolutionPreferingIntermediate	(	int	$active_id,
		?int	$pass = null
	)

Reimplemented from assQuestion.

Definition at line 663 of file class.assFileUpload.php.

     : array {
        $solution = $this->getSolutionValues($active_id, $pass, false);
 
        if (!count($solution)) {
            $solution = $this->getSolutionValues($active_id, $pass, true);
        } else {
            $cleaned = [];
            foreach ($solution as $row) {
                if (!empty($row['value1'])) {
                    $cleaned[] = $row;
                }
            }
            $solution = $cleaned;
        }
 
        return $solution;
    }

hasFileUploads()

assFileUpload::hasFileUploads

(

int

$test_id

)

Implements ilObjFileHandlingQuestionType.

Definition at line 822 of file class.assFileUpload.php.

                                                : bool
    {
        $query = '
                SELECT tst_solutions.solution_id
                FROM tst_solutions, tst_active, qpl_questions
                WHERE tst_solutions.active_fi = tst_active.active_id
                AND tst_solutions.question_fi = qpl_questions.question_id
                AND tst_solutions.question_fi = %s AND tst_active.test_fi = %s
                AND tst_solutions.value1 is not null';
        $result = $this->db->queryF(
            $query,
            ['integer', 'integer'],
            [$this->getId(), $test_id]
        );
        if ($result->numRows() > 0) {
            return true;
        }
 
        return false;
    }

References ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

isComplete()

assFileUpload::isComplete

(

)

Returns true, if the question is complete for use.

Returns

boolean True, if the question is complete for use, otherwise false

Reimplemented from assQuestion.

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

                                : bool
    {
        if (
            strlen($this->title)
            && ($this->author)
            && ($this->question)
            && ($this->getMaximumPoints() >= 0)
            && is_numeric($this->getMaximumPoints())) {
            return true;
        }
        return false;
    }

References getMaximumPoints().

Here is the call graph for this function:

isCompletionBySubmissionEnabled()

assFileUpload::isCompletionBySubmissionEnabled

(

)

Definition at line 858 of file class.assFileUpload.php.

                                                     : bool
    {
        return $this->completion_by_submission;
    }

Referenced by saveAdditionalQuestionDataToDb().

Here is the caller graph for this function:

isFileDeletionAction()

assFileUpload::isFileDeletionAction ( )

protected

Definition at line 875 of file class.assFileUpload.php.

                                             : bool
    {
        return $this->getQuestionAction() == assFileUploadGUI::DELETE_FILES_ACTION;
    }

References assFileUploadGUI\DELETE_FILES_ACTION.

isFileDeletionSubmitAvailable()

assFileUpload::isFileDeletionSubmitAvailable ( )

protected

Definition at line 880 of file class.assFileUpload.php.

                                                      : bool
    {
        return $this->isNonEmptyItemListPostSubmission(self::DELETE_FILES_TBL_POSTVAR);
    }

isFileReuseHandlingRequired()

assFileUpload::isFileReuseHandlingRequired ( )

protected

Definition at line 890 of file class.assFileUpload.php.

                                                    : bool
    {
        if (!$this->getTestPresentationConfig()->isPreviousPassSolutionReuseAllowed()) {
            return false;
        }
 
        if (!$this->isFileReuseSubmitAvailable()) {
            return false;
        }
 
        return true;
    }

isFileReuseSubmitAvailable()

assFileUpload::isFileReuseSubmitAvailable ( )

protected

Definition at line 885 of file class.assFileUpload.php.

                                                   : bool
    {
        return $this->isNonEmptyItemListPostSubmission(self::REUSE_FILES_TBL_POSTVAR);
    }

isFileUploadAvailable()

assFileUpload::isFileUploadAvailable ( )

protected

Exceptions

IllegalStateException

Definition at line 906 of file class.assFileUpload.php.

                                              : bool
    {
        if (!$this->file_upload->hasBeenProcessed()) {
            $this->file_upload->process();
        }
        return $this->file_upload->hasUploads();
    }

loadFromDb()

assFileUpload::loadFromDb

(

int

$question_id

)

Reimplemented from assQuestion.

Definition at line 138 of file class.assFileUpload.php.

                                                : void
    {
 
        $result = $this->db->queryF(
            'SELECT qpl_questions.*, ' . $this->getAdditionalTableName()
            . '.* FROM qpl_questions LEFT JOIN ' . $this->getAdditionalTableName()
            . ' ON ' . $this->getAdditionalTableName()
            . '.question_fi = qpl_questions.question_id WHERE qpl_questions.question_id = %s',
            ['integer'],
            [$question_id]
        );
        if ($result->numRows() == 1) {
            $data = $this->db->fetchAssoc($result);
            $this->setId($question_id);
            $this->setTitle((string) $data['title']);
            $this->setComment((string) $data['description']);
            $this->setNrOfTries($data['nr_of_tries']);
            $this->setOriginalId($data['original_id']);
            $this->setObjId($data['obj_fi']);
            $this->setAuthor($data['author']);
            $this->setOwner($data['owner']);
            $this->setPoints($data['points']);
 
            $this->setQuestion(ilRTE::_replaceMediaObjectImageSrc((string) $data['question_text'], 1));
            $this->setMaxSize(($data['maxsize'] ?? null) ? (int) $data['maxsize'] : null);
            $this->setAllowedExtensions($data['allowedextensions'] ?? '');
            $this->setCompletionBySubmission($data['compl_by_submission'] == 1 ? true : false);
 
            try {
                $this->setLifecycle(ilAssQuestionLifecycle::getInstance($data['lifecycle']));
            } catch (ilTestQuestionPoolInvalidArgumentException $e) {
                $this->setLifecycle(ilAssQuestionLifecycle::getDraftInstance());
            }
 
            try {
                $this->setAdditionalContentEditingMode($data['add_cont_edit_mode']);
            } catch (ilTestQuestionPoolException $e) {
            }
        }
        parent::loadFromDb($question_id);
    }

References $data, Vendor\Package\$e, ilRTE\_replaceMediaObjectImageSrc(), getAdditionalTableName(), ilAssQuestionLifecycle\getDraftInstance(), ilAssQuestionLifecycle\getInstance(), assQuestion\setAdditionalContentEditingMode(), setAllowedExtensions(), assQuestion\setAuthor(), assQuestion\setComment(), setCompletionBySubmission(), assQuestion\setId(), assQuestion\setLifecycle(), setMaxSize(), assQuestion\setNrOfTries(), assQuestion\setObjId(), assQuestion\setOriginalId(), assQuestion\setOwner(), assQuestion\setPoints(), assQuestion\setQuestion(), and assQuestion\setTitle().

Here is the call graph for this function:

removeIntermediateSolution()

assFileUpload::removeIntermediateSolution	(	int	$active_id,
		int	$pass
	)

Reimplemented from assQuestion.

Definition at line 684 of file class.assFileUpload.php.

                                                                         : void
    {
        parent::removeIntermediateSolution($active_id, $pass);
 
        $test_id = $this->participant_repository->lookupTestIdByActiveId($active_id);
        if ($test_id !== -1) {
            // TODO: This can be removed with ILIAS 10
            $this->deleteUnusedFiles([], $test_id, $active_id, $pass);
        }
    }

removeSolutionRecordById()

assFileUpload::removeSolutionRecordById ( int  $solution_id )

protected

Reimplemented from assQuestion.

Definition at line 658 of file class.assFileUpload.php.

                                                                 : int
    {
        return parent::removeSolutionRecordById($solution_id);
    }

resolveRIDStoDelete()

assFileUpload::resolveRIDStoDelete ( )

protected

Definition at line 637 of file class.assFileUpload.php.

                                            : array
    {
        $rids_to_delete = [];
        if ($this->isFileDeletionAction() && $this->isFileDeletionSubmitAvailable()) {
            $delete_files = $this->questionpool_request->intArray(self::DELETE_FILES_TBL_POSTVAR);
 
            $res = $this->db->query(
                "SELECT value1 FROM tst_solutions WHERE value2 = 'rid' AND " . $this->db->in(
                    'solution_id',
                    $delete_files,
                    false,
                    'integer'
                )
            );
            while ($d = $this->db->fetchAssoc($res)) {
                $rids_to_delete[] = $d['value1'];
            }
        }
        return $rids_to_delete;
    }

References Vendor\Package\$d, and $res.

saveAdditionalQuestionDataToDb()

assFileUpload::saveAdditionalQuestionDataToDb

(

)

Saves a record to the question types additional data table.

Returns

mixed

Implements ilObjQuestionScoringAdjustable.

Definition at line 118 of file class.assFileUpload.php.

    {
        $this->db->manipulateF(
            'DELETE FROM ' . $this->getAdditionalTableName() . ' WHERE question_fi = %s',
            ['integer'],
            [$this->getId()]
        );
        $this->db->manipulateF(
            'INSERT INTO ' . $this->getAdditionalTableName(
            ) . ' (question_fi, maxsize, allowedextensions, compl_by_submission) VALUES (%s, %s, %s, %s)',
            ['integer', 'float', 'text', 'integer' ],
            [
                $this->getId(),
                $this->getMaxSize(),
                (strlen($this->getAllowedExtensions())) ? $this->getAllowedExtensions() : null,
                (int) $this->isCompletionBySubmissionEnabled()
            ]
        );
    }

References getAdditionalTableName(), getAllowedExtensions(), assQuestion\getId(), getMaxSize(), and isCompletionBySubmissionEnabled().

Referenced by saveToDb().

Here is the call graph for this function:

Here is the caller graph for this function:

savePreviewData()

assFileUpload::savePreviewData ( ilAssQuestionPreviewSession  $previewSession )

protected

Reimplemented from assQuestion.

Definition at line 696 of file class.assFileUpload.php.

                                                                                   : void
    {
        $userSolution = $previewSession->getParticipantsSolution();
 
        if (!is_array($userSolution)) {
            $userSolution = [];
        }
 
        // hey: prevPassSolutions - readability spree - get a chance to understand the code
        if ($this->isFileDeletionAction()) {
            // hey.
            // hey: prevPassSolutions - readability spree - get a chance to understand the code
            if ($this->isFileDeletionSubmitAvailable()) {
                // hey.
                $delete_files = $this->questionpool_request->strArray(self::DELETE_FILES_TBL_POSTVAR);
 
                $userSolution = $this->deletePreviewFileUploads($previewSession->getUserId(), $userSolution, $delete_files);
            } else {
                $this->tpl->setOnScreenMessage('info', $this->lng->txt('no_checkbox'), true);
            }
        } else {
            // hey: prevPassSolutions - readability spree - get a chance to understand the code
            try {
                $fileUploadAvailable = $this->current_cmd !== 'instantResponse'
                    && $this->isFileUploadAvailable();
            } catch (IllegalStateException $e) {
                $this->tpl->setOnScreenMessage('failure', $e->getMessage(), true);
                return;
            }
            if ($fileUploadAvailable) {
                // hey.
                if ($this->checkUpload()) {
                    if (!@file_exists($this->getPreviewFileUploadPath($previewSession->getUserId()))) {
                        ilFileUtils::makeDirParents($this->getPreviewFileUploadPath($previewSession->getUserId()));
                    }
 
                    $version = time();
                    $filename_arr = pathinfo($_FILES['upload']['name']);
                    $extension = $filename_arr['extension'];
                    $newfile = 'file_' . md5($_FILES['upload']['name']) . '_' . $version . '.' . $extension;
                    ilFileUtils::moveUploadedFile(
                        $_FILES['upload']['tmp_name'],
                        $_FILES['upload']['name'],
                        $this->getPreviewFileUploadPath($previewSession->getUserId()) . $newfile
                    );
 
                    $userSolution[$newfile] = [
                        'solution_id' => $newfile,
                        'value1' => $newfile,
                        'value2' => $_FILES['upload']['name'],
                        'tstamp' => $version,
                        'webpath' => $this->getPreviewFileUploadPathWeb($previewSession->getUserId())
                    ];
                }
            }
        }
 
        $previewSession->setParticipantsSolution($userSolution);
    }

References Vendor\Package\$e, $version, ilAssQuestionPreviewSession\getParticipantsSolution(), ilAssQuestionPreviewSession\getUserId(), ILIAS\Repository\lng(), ilFileUtils\makeDirParents(), ilFileUtils\moveUploadedFile(), and ilAssQuestionPreviewSession\setParticipantsSolution().

Here is the call graph for this function:

saveToDb()

assFileUpload::saveToDb

(

?int

$original_id = null

)

Saves a assFileUpload object to a database.

Reimplemented from assQuestion.

Definition at line 111 of file class.assFileUpload.php.

                                                      : void
    {
        $this->saveQuestionDataToDb($original_id);
        $this->saveAdditionalQuestionDataToDb();
        parent::saveToDb();
    }

References assQuestion\$original_id, saveAdditionalQuestionDataToDb(), and assQuestion\saveQuestionDataToDb().

Here is the call graph for this function:

saveWorkingData()

assFileUpload::saveWorkingData	(	int	$active_id,
		?int	$pass = null,
		bool	$authorized = true
	)

Reimplemented from assQuestion.

Definition at line 528 of file class.assFileUpload.php.

     : bool {
        if ($pass === null || $pass < 0) {
            $pass = \ilObjTest::_getPass($active_id);
        }
 
        $test_id = $this->participant_repository->lookupTestIdByActiveId($active_id);
 
        try {
            $upload_handling_required = $this->current_cmd !== 'submitSolution'
                && $this->current_cmd !== 'showInstantResponse'
                && !$this->isFileDeletionAction()
                && $this->isFileUploadAvailable()
                && $this->checkUpload();
        } catch (IllegalStateException $e) {
            $this->tpl->setOnScreenMessage('failure', $e->getMessage(), true);
            return false;
        }
 
        $rid = null;
 
        if ($upload_handling_required) {
            // upload new file to storage
            $upload_results = $this->file_upload->getResults();
            $upload_result = end($upload_results); // only one supported at the moment
            $rid = $this->irss->manage()->upload(
                $upload_result,
                new assFileUploadStakeholder()
            );
        }
 
        // RIDS to delete
        // Unfortunately, at the moment it is not possible to delete the files from the IRSS, because the process takes
        // place within the ProcessLocker and the IRSS tables cannot be used. we have to remove them after the lock.
        // therefore we store the rids to delete in an array for later deletion.
        $rids_to_delete = $this->resolveRIDStoDelete();
 
        $this->getProcessLocker()->executeUserSolutionUpdateLockOperation(
            function () use ($upload_handling_required, $active_id, $pass, $authorized, $rid) {
                if ($authorized === false) {
                    $this->forceExistingIntermediateSolution($active_id, $pass, true);
                }
 
                if ($this->isFileDeletionAction()) {
                    if ($this->isFileDeletionSubmitAvailable()) {
                        $delete_files = $this->questionpool_request->intArray(self::DELETE_FILES_TBL_POSTVAR);
 
                        foreach ($delete_files as $solution_id) {
                            $this->removeSolutionRecordById($solution_id);
                        }
                    } else {
                        $this->tpl->setOnScreenMessage('info', $this->lng->txt('no_checkbox'), true);
                    }
                } else {
                    if ($this->isFileReuseHandlingRequired()) {
                        $reuse_files = $this->questionpool_request->intArray(self::REUSE_FILES_TBL_POSTVAR);
 
                        foreach ($reuse_files as $solutionId) {
                            $solution = $this->getSolutionRecordById($solutionId);
 
                            $this->saveCurrentSolution(
                                $active_id,
                                $pass,
                                $solution['value1'],
                                $solution['value2'],
                                false,
                                $solution['tstamp']
                            );
                        }
                    }
 
                    if ($upload_handling_required && $rid !== null) {
                        $revision = $this->irss->manage()->getCurrentRevision($rid);
                        $this->saveCurrentSolution(
                            $active_id,
                            $pass,
                            $rid->serialize(),
                            'rid',
                            false,
                            time()
                        );
                    }
                }
 
                if ($authorized === true && $this->intermediateSolutionExists($active_id, $pass)) {
                    // remove the dummy record of the intermediate solution
                    $this->deleteDummySolutionRecord($active_id, $pass);
 
                    // delete the authorized solution and make the intermediate solution authorized (keeping timestamps)
                    $this->removeCurrentSolution($active_id, $pass, true);
                    $this->updateCurrentSolutionsAuthorization($active_id, $pass, true, true);
                }
 
            }
        );
 
        $this->deleteUnusedFiles(
            $rids_to_delete,
            $test_id,
            $active_id,
            $pass
        );
 
        return true;
    }

References ilObjTest\_getPass().

Here is the call graph for this function:

setAllowedExtensions()

assFileUpload::setAllowedExtensions

(

string

$a_value

)

Definition at line 817 of file class.assFileUpload.php.

                                                         : void
    {
        $this->allowedextensions = strtolower(trim($a_value));
    }

Referenced by loadFromDb().

Here is the caller graph for this function:

setCompletionBySubmission()

assFileUpload::setCompletionBySubmission

(

bool

$bool

)

Definition at line 863 of file class.assFileUpload.php.

                                                         : assFileUpload
    {
        $this->completion_by_submission = (bool) $bool;
        return $this;
    }

Referenced by loadFromDb().

Here is the caller graph for this function:

setMaxSize()

assFileUpload::setMaxSize

(

?int

$value

)

Definition at line 798 of file class.assFileUpload.php.

                                           : void
    {
        $this->maxsize = $value;
    }

Referenced by loadFromDb().

Here is the caller graph for this function:

solutionValuesToLog()

assFileUpload::solutionValuesToLog ( AdditionalInformationGenerator  $additional_info, array  $solution_values  )

protected

MUST convert the given solution values into an array or a string that can be stored in the log.

Language variables must be generated through the corresponding functions in the AdditionalInformationGenerator. If an array is returned it will be rendered into a line per array entry in the format "key: value". If the key exists as a language variable, it will be translated.

Reimplemented from assQuestion.

Definition at line 931 of file class.assFileUpload.php.

     : array {
        return array_map(
            static fn(array $v): string => "{$v['value1']} - {$v['value2']}",
            $solution_values
        );
    }

solutionValuesToText()

assFileUpload::solutionValuesToText

(

array

$solution_values

)

MUST convert the given solution values into text.

If the text has multiple lines each line MUST be placed as an entry in an array.

Reimplemented from assQuestion.

Definition at line 941 of file class.assFileUpload.php.

                                                                : array
    {
        return array_map(
            static fn(array $v): string => "{$v['value1']} - {$v['value2']}",
            $solution_values
        );
    }

toLog()

assFileUpload::toLog

(

AdditionalInformationGenerator

$additional_info

)

MUST return an array of the question settings that can be stored in the log.

Language variables must be generated through the corresponding functions in the AdditionalInformationGenerator. If an array is returned it will be rendered into a line per array entry in the format "key: value". If the key exists as a language variable, it will be translated.

Reimplemented from assQuestion.

Definition at line 914 of file class.assFileUpload.php.

                                                                          : array
    {
        return [
            AdditionalInformationGenerator::KEY_QUESTION_TYPE => (string) $this->getQuestionType(),
            AdditionalInformationGenerator::KEY_QUESTION_TITLE => $this->getTitleForHTMLOutput(),
            AdditionalInformationGenerator::KEY_QUESTION_TEXT => $this->formatSAQuestion($this->getQuestion()),
            AdditionalInformationGenerator::KEY_QUESTION_REACHABLE_POINTS => $this->getPoints(),
            AdditionalInformationGenerator::KEY_QUESTION_UPLOAD_MAXSIZE => $this->getMaxFilesizeAsString(),
            AdditionalInformationGenerator::KEY_QUESTION_UPLOAD_ALLOWED_EXTENSIONS => $this->getAllowedExtensionsArray(),
            AdditionalInformationGenerator::KEY_QUESTION_UPLOAD_COMPLETION_BY_SUBMISSION => $additional_info->getEnabledDisabledTagForBool($this->isCompletionBySubmissionEnabled()),
            AdditionalInformationGenerator::KEY_FEEDBACK => [
                AdditionalInformationGenerator::KEY_QUESTION_FEEDBACK_ON_INCOMPLETE => $this->formatSAQuestion($this->feedbackOBJ->getGenericFeedbackTestPresentation($this->getId(), false)),
                AdditionalInformationGenerator::KEY_QUESTION_FEEDBACK_ON_COMPLETE => $this->formatSAQuestion($this->feedbackOBJ->getGenericFeedbackTestPresentation($this->getId(), true))
            ]
        ];
    }

References ILIAS\Test\Logging\AdditionalInformationGenerator\getEnabledDisabledTagForBool().

Here is the call graph for this function:

Field Documentation

$allowedextensions

string assFileUpload::$allowedextensions = ''

protected

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

$completion_by_submission

assFileUpload::$completion_by_submission = false

protected

Definition at line 57 of file class.assFileUpload.php.

$current_cmd

string assFileUpload::$current_cmd

private

Definition at line 54 of file class.assFileUpload.php.

$file_delivery

ILIAS FileDelivery Services assFileUpload::$file_delivery

private

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

$file_upload

ILIAS FileUpload FileUpload assFileUpload::$file_upload

private

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

$irss

ILIAS ResourceStorage Services assFileUpload::$irss

private

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

$maxsize

int assFileUpload::$maxsize = null

protected

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

$participant_repository

ParticipantRepository assFileUpload::$participant_repository

private

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

DELETE_FILES_TBL_POSTVAR

const assFileUpload::DELETE_FILES_TBL_POSTVAR = 'deletefiles'

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

Referenced by assFileUploadGUI\getPreview(), and assFileUploadGUI\getTestPresentationFileTablePostVar().

HAS_SPECIFIC_FEEDBACK

const assFileUpload::HAS_SPECIFIC_FEEDBACK = false

protected

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

REUSE_FILES_TBL_POSTVAR

const assFileUpload::REUSE_FILES_TBL_POSTVAR = 'reusefiles'

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

Referenced by assFileUploadGUI\getTestPresentationFileTablePostVar().

---

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

• components/ILIAS/TestQuestionPool/classes/class.assFileUpload.php