assQuestion Class Reference

Inheritance diagram for assQuestion:

Collaboration diagram for assQuestion:

Public Member Functions
	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)
	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)
	updateOriginalId (?int $original_id=null)
	duplicate (bool $set_original_id=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)
	toNormalized (Transformations $transformations, array $context=[])
	fromNormalized (array $normalized, Transformations $transformations)
	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)

Static Public Member Functions
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...

Data Fields
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
	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)

Static Protected Member Functions
static	getNumExistingSolutionRecords (int $activeId, int $pass, int $questionId)

Protected Attributes
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

Static Protected Attributes
static	$force_pass_results_update_enabled = false
static	$imageSourceFixReplaceMap

Private Member Functions
	deleteTaxonomyAssignments ()

Private Attributes
const	DEFAULT_THUMB_SIZE = 150
const	MINIMUM_THUMB_SIZE = 20
const	MAXIMUM_THUMB_SIZE = 8192
ilTestQuestionConfig	$test_question_config = null
int	$nr_of_tries
string	$export_image_path
string	$additionalContentEditingMode = ''

Detailed Description

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

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

Member Function Documentation

_getReachedPoints()

static assQuestion::_getReachedPoints ( int  $active_id, int  $question_id, int  $pass  )

static

Definition at line 517 of file class.assQuestion.php.

                                                                                         : float
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $points = 0.0;
 
        $result = $ilDB->queryF(
            "SELECT * FROM tst_test_result WHERE active_fi = %s AND question_fi = %s AND pass = %s",
            ['integer','integer','integer'],
            [$active_id, $question_id, $pass]
        );
        if ($result->numRows() == 1) {
            $row = $ilDB->fetchAssoc($result);
            $points = (float) $row["points"];
        }
        return $points;
    }

References $DIC, and $ilDB.

_getSolutionMaxPass()

static assQuestion::_getSolutionMaxPass ( int  $question_id, int  $active_id  )

static

Returns the maximum pass a users question solution.

Definition at line 1791 of file class.assQuestion.php.

                                                                                : ?int
    {
        // the following code was the old solution which added the non answered
        // questions of a pass from the answered questions of the previous pass
        // with the above solution, only the answered questions of the last pass are counted
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $result = $ilDB->queryF(
            "SELECT MAX(pass) maxpass FROM tst_test_result WHERE active_fi = %s AND question_fi = %s",
            ['integer','integer'],
            [$active_id, $question_id]
        );
        if ($result->numRows() === 1) {
            $row = $ilDB->fetchAssoc($result);
            return $row["maxpass"];
        }
 
        return null;
    }

References $DIC, and $ilDB.

Referenced by ilObjTest\getTextAnswer().

Here is the caller graph for this function:

_getSuggestedSolutionOutput()

static assQuestion::_getSuggestedSolutionOutput ( int  $question_id )

static

Definition at line 460 of file class.assQuestion.php.

                                                                        : string
    {
        $question = self::instantiateQuestion($question_id);
        if (!is_object($question)) {
            return "";
        }
        return $question->getSuggestedSolutionOutput();
    }

_questionExistsInTest()

static assQuestion::_questionExistsInTest ( int  $question_id, int  $test_id  )

static

Definition at line 2129 of file class.assQuestion.php.

                                                                                : bool
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        if ($question_id < 1) {
            return false;
        }
 
        $result = $ilDB->queryF(
            "SELECT question_fi FROM tst_test_question WHERE question_fi = %s AND test_fi = %s",
            ['integer', 'integer'],
            [$question_id, $test_id]
        );
        return $ilDB->numRows($result) == 1;
    }

References $DIC, and $ilDB.

addAnswerOptionValue()

assQuestion::addAnswerOptionValue	(	int	$qIndex,
		string	$answerOptionValue,
		float	$points
	)

Reimplemented in assClozeTest, and assTextSubset.

Definition at line 2755 of file class.assQuestion.php.

                                                                                               : void
    {
    }

adjustReachedPointsByScoringOptions()

assQuestion::adjustReachedPointsByScoringOptions ( float  $points, int  $active_id  )

final

Adjust the given reached points by checks for all special scoring options in the test container.

@final @access public

Parameters

integer	$points
integer	$active_id
integer	$pass

Definition at line 1846 of file class.assQuestion.php.

                                                                                            : float
    {
        $count_system = ilObjTest::_getCountSystem($active_id);
        if ($count_system == 1) {
            if (abs($this->getMaximumPoints() - $points) > 0.0000000001) {
                $points = 0;
            }
        }
        $score_cutting = ilObjTest::_getScoreCutting($active_id);
        if ($score_cutting == 0) {
            if ($points < 0) {
                $points = 0;
            }
        }
        return $points;
    }

References ilObjTest\_getCountSystem(), and ilObjTest\_getScoreCutting().

Here is the call graph for this function:

afterSyncWithOriginal()

assQuestion::afterSyncWithOriginal ( int  $original_question_id, int  $clone_question_id, int  $original_parent_id, int  $clone_parent_id  )

protected

Reimplemented in assMatchingQuestion, and assSingleChoice.

Definition at line 1434 of file class.assQuestion.php.

     : void {
        $this->feedbackOBJ->cloneFeedback($original_question_id, $clone_question_id);
    }

answerToLog()

assQuestion::answerToLog ( AdditionalInformationGenerator  $additional_info, int  $active_id, int  $pass  )

protected

Definition at line 2927 of file class.assQuestion.php.

     : array {
        return [
            AdditionalInformationGenerator::KEY_PASS => $pass,
            AdditionalInformationGenerator::KEY_REACHED_POINTS => $this->getReachedPoints($active_id, $pass),
            AdditionalInformationGenerator::KEY_PAX_ANSWER => $this->solutionValuesToLog(
                $additional_info,
                $this->getSolutionValues($active_id, $pass)
            )
        ];
    }

answerToParticipantInteraction()

assQuestion::answerToParticipantInteraction	(	AdditionalInformationGenerator	$additional_info,
		int	$test_ref_id,
		int	$active_id,
		int	$pass,
		string	$source_ip,
		TestParticipantInteractionTypes	$interaction_type
	)

Implements ILIAS\TestQuestionPool\Questions\Question.

Definition at line 2893 of file class.assQuestion.php.

     : TestParticipantInteraction {
        return new TestParticipantInteraction(
            $test_ref_id,
            $this->id,
            $this->current_user->getId(),
            $source_ip,
            $interaction_type,
            time(),
            $this->answerToLog($additional_info, $active_id, $pass)
        );
    }

Referenced by ilTestPlayerAbstractGUI\save().

Here is the caller graph for this function:

authorizedOrIntermediateSolutionExists()

assQuestion::authorizedOrIntermediateSolutionExists	(	int	$active_id,
		int	$pass
	)

Definition at line 2689 of file class.assQuestion.php.

                                                                                     : bool
    {
        $solutionAvailability = $this->lookupForExistingSolutions($active_id, $pass);
        return $solutionAvailability['authorized'] || $solutionAvailability['intermediate'];
    }

authorizedSolutionExists()

assQuestion::authorizedSolutionExists	(	int	$active_id,
		?int	$pass
	)

Definition at line 2680 of file class.assQuestion.php.

                                                                        : bool
    {
        if ($pass === null) {
            return false;
        }
        $solutionAvailability = $this->lookupForExistingSolutions($active_id, $pass);
        return (bool) $solutionAvailability['authorized'];
    }

buildHashedImageFilename()

assQuestion::buildHashedImageFilename	(	string	$plain_image_filename,
		bool	$unique = false
	)

Definition at line 1862 of file class.assQuestion.php.

                                                                                                : string
    {
        $extension = "";
 
        if (preg_match("/.*\.(png|jpg|gif|jpeg)$/i", $plain_image_filename, $matches)) {
            $extension = "." . $matches[1];
        }
 
        if ($unique) {
            $plain_image_filename = uniqid($plain_image_filename . microtime(true), true);
        }
 
        return md5($plain_image_filename) . $extension;
    }

buildQuestionDataQuery()

assQuestion::buildQuestionDataQuery ( )

protected

Definition at line 2350 of file class.assQuestion.php.

                                               : string
    {
        return "
                        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
                ";
    }

Referenced by assKprimChoice\loadFromDb().

Here is the caller graph for this function:

buildTestPresentationConfig()

assQuestion::buildTestPresentationConfig ( )

protected

Reimplemented in assFileUpload, assMultipleChoice, assOrderingHorizontal, and assOrderingQuestion.

Definition at line 2852 of file class.assQuestion.php.

                                                    : ilTestQuestionConfig
    {
        return new ilTestQuestionConfig();
    }

calculateReachedPoints()

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

abstract

Reimplemented in assClozeTest, assErrorText, assFileUpload, assFormulaQuestion, assImagemapQuestion, assKprimChoice, assLongMenu, assMatchingQuestion, assMultipleChoice, assNumeric, assOrderingHorizontal, assOrderingQuestion, assSingleChoice, assTextQuestion, and assTextSubset.

calculateReachedPointsFromPreviewSession()

assQuestion::calculateReachedPointsFromPreviewSession

(

ilAssQuestionPreviewSession

$preview_session

)

Reimplemented in assClozeTest, assErrorText, assImagemapQuestion, assOrderingQuestion, assSingleChoice, assFormulaQuestion, and assNumeric.

Definition at line 1817 of file class.assQuestion.php.

    {
        $reached_points = $this->calculateReachedPointsForSolution($preview_session->getParticipantsSolution());
        return $this->ensureNonNegativePoints($reached_points);
    }

References ilAssQuestionPreviewSession\getParticipantsSolution().

Here is the call graph for this function:

calculateResultsFromSolution()

assQuestion::calculateResultsFromSolution ( int  $active_id, int  $pass  )

final

Calculates the question results from a previously saved question solution.

Definition at line 559 of file class.assQuestion.php.

                                                                                 : void
    {
        // determine reached points for submitted solution
        $reached_points = $this->calculateReachedPoints($active_id, $pass);
 
        // adjust reached points regarding to tests scoring options
        $reached_points = $this->adjustReachedPointsByScoringOptions($reached_points, $active_id);
 
        if (is_null($reached_points)) {
            $reached_points = 0.0;
        }
 
        // fau: testNav - check for existing authorized solution to know if a result record should be written
        $existing_solutions = $this->lookupForExistingSolutions($active_id, $pass);
 
        $this->getProcessLocker()->executeUserQuestionResultUpdateOperation(
            function () use ($active_id, $pass, $reached_points, $existing_solutions) {
                $query = "
                    DELETE FROM         tst_test_result
 
                    WHERE                       active_fi = %s
                    AND                         question_fi = %s
                    AND                         pass = %s
                ";
 
                $types = ['integer', 'integer', 'integer'];
                $values = [$active_id, $this->getId(), $pass];
 
                if ($this->getStep() !== null) {
                    $query .= "
                    AND                         step = %s
                ";
 
                    $types[] = 'integer';
                    $values[] = $this->getStep();
                }
                $this->db->manipulateF($query, $types, $values);
 
                if ($existing_solutions['authorized']) {
                    $next_id = $this->db->nextId("tst_test_result");
                    $fieldData = [
                        'test_result_id' => ['integer', $next_id],
                        'active_fi' => ['integer', $active_id],
                        'question_fi' => ['integer', $this->getId()],
                        'pass' => ['integer', $pass],
                        'points' => ['float', $reached_points],
                        'tstamp' => ['integer', time()],
                        'answered' => ['integer', true]
                    ];
 
                    if ($this->getStep() !== null) {
                        $fieldData['step'] = ['integer', $this->getStep()];
                    }
 
                    $this->db->insert('tst_test_result', $fieldData);
                }
            }
        );
 
        $this->test_result_repository->updateTestAttemptResult($active_id, $pass, $this->getProcessLocker());
        ilCourseObjectiveResult::_updateObjectiveResult($this->current_user->getId(), $active_id, $this->getId());
    }

References ilCourseObjectiveResult\_updateObjectiveResult(), and ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

cleanupMediaObjectUsage()

assQuestion::cleanupMediaObjectUsage

(

)

Definition at line 1999 of file class.assQuestion.php.

                                             : void
    {
        $combinedtext = $this->getRTETextWithMediaObjects();
        ilRTE::_cleanupMediaObjectUsage($combinedtext, "qpl:html", $this->getId());
    }

References ilRTE\_cleanupMediaObjectUsage(), and ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

clonePageOfQuestion()

assQuestion::clonePageOfQuestion

(

int

$a_q_id

)

Definition at line 1025 of file class.assQuestion.php.

                                                    : void
    {
        if ($a_q_id > 0) {
            $page = new ilAssQuestionPage($a_q_id);
            $page->buildDom();
            ilPCPlugged::handleCopiedPluggedContent($page, $page->getDomDoc());
            $xml = str_replace("il__qst_" . $a_q_id, "il__qst_" . $this->id, $page->getXMLFromDom());
            $this->page->setXMLContent($xml);
            $this->page->updateFromXML();
        }
    }

References $page.

cloneQuestionTypeSpecificProperties()

assQuestion::cloneQuestionTypeSpecificProperties ( self  $target )

protected

Definition at line 1348 of file class.assQuestion.php.

     : self {
        return $target;
    }

cloneSuggestedSolutionFiles()

assQuestion::cloneSuggestedSolutionFiles ( int  $source_question_id, int  $target_question_id  )

protected

Definition at line 1572 of file class.assQuestion.php.

     : void {
        $filepath_target = $this->getSuggestedSolutionPath();
        $filepath_original = str_replace("/$target_question_id/solution", "/$source_question_id/solution", $filepath_target);
        ilFileUtils::delDir($filepath_original);
        foreach ($this->suggested_solutions as $solution) {
            if (!$solution->isOfTypeFile()
                || $solution->getFilename() === '') {
                continue;
            }
 
            if (!file_exists($filepath_original)) {
                ilFileUtils::makeDirParents($filepath_original);
            }
 
            if (!is_file($filepath_original . $solution->getFilename())
                || copy($filepath_target . $solution->getFilename(), $filepath_target . $solution->getFilename())) {
                $this->log->forComponent('qpl')->error('File for suggested solutions could not be cloned:');
                $this->log->forComponent('qpl')->error("Question-Id: {$this->id}; Question-Title: {$this->title}; File: {$filepath_original}{$solution->getFilename()}");
            }
        }
    }

cloneSuggestedSolutions()

assQuestion::cloneSuggestedSolutions ( int  $source_question_id, int  $target_question_id  )

protected

Definition at line 1536 of file class.assQuestion.php.

     : void {
        $this->getSuggestedSolutionsRepo()->clone($source_question_id, $target_question_id);
        $this->cloneSuggestedSolutionFiles($source_question_id, $target_question_id);
    }

cloneXHTMLMediaObjectsOfQuestion()

assQuestion::cloneXHTMLMediaObjectsOfQuestion

(

int

$source_question_id

)

Definition at line 1005 of file class.assQuestion.php.

                                                                             : void
    {
        $mobs = ilObjMediaObject::_getMobsOfObject("qpl:html", $source_question_id);
        foreach ($mobs as $mob) {
            ilObjMediaObject::_saveUsage($mob, "qpl:html", $this->getId());
        }
    }

References ilObjMediaObject\_getMobsOfObject(), ilObjMediaObject\_saveUsage(), and ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

convertISO8601FormatH_i_s_ExtendedToSeconds()

static assQuestion::convertISO8601FormatH_i_s_ExtendedToSeconds ( string  $time )

static

Definition at line 2656 of file class.assQuestion.php.

                                                                                    : int
    {
        $sec = 0;
        $time_array = explode(':', $time);
        if (count($time_array) == 3) {
            $sec += (int) $time_array[0] * 3600;
            $sec += (int) $time_array[1] * 60;
            $sec += (int) $time_array[2];
        }
        return $sec;
    }

References ILIAS\Repository\int().

Here is the call graph for this function:

copyObject()

assQuestion::copyObject ( int  $target_parent_id, string  $title = ''  )

final

Definition at line 1291 of file class.assQuestion.php.

     : int {
        if ($this->getId() <= 0) {
            throw new RuntimeException('The question has not been saved. It cannot be duplicated');
        }
        // duplicate the question in database
        $clone = clone $this;
        $clone->id = -1;
        $source_parent_id = $this->getObjId();
        $clone->setObjId($target_parent_id);
        if ($title) {
            $clone->setTitle($title);
        }
        $clone->saveToDb();
        $clone->clonePageOfQuestion($this->id);
        $clone->cloneXHTMLMediaObjectsOfQuestion($this->id);
        $clone = $this->cloneQuestionTypeSpecificProperties($clone);
 
        $clone->onCopy($source_parent_id, $this->id, $clone->getObjId(), $clone->getId());
 
        return $clone->id;
    }

copySuggestedSolutions()

assQuestion::copySuggestedSolutions ( int  $target_question_id )

protected

Definition at line 1597 of file class.assQuestion.php.

                                                                      : void
    {
        $update = [];
        foreach ($this->getSuggestedSolutions() as $index => $solution) {
            $solution = $solution->withQuestionId($target_question_id);
            $update[] = $solution;
        }
        $this->getSuggestedSolutionsRepo()->update($update);
    }

createNewOriginalFromThisDuplicate()

assQuestion::createNewOriginalFromThisDuplicate ( int  $target_parent_id, string  $target_question_title = ''  )

final

Definition at line 1316 of file class.assQuestion.php.

     : int {
        if ($this->getId() <= 0) {
            throw new RuntimeException('The question has not been saved. It cannot be duplicated');
        }
 
        $source_question_id = $this->id;
        $source_parent_id = $this->getObjId();
 
        // duplicate the question in database
        $clone = clone $this;
        $clone->id = -1;
 
        $clone->setObjId($target_parent_id);
 
        if ($target_question_title) {
            $clone->setTitle($target_question_title);
        }
 
        $clone->saveToDb();
        $clone->clonePageOfQuestion($source_question_id);
        $clone->cloneXHTMLMediaObjectsOfQuestion($source_question_id);
 
        $clone = $this->cloneQuestionTypeSpecificProperties($clone);
 
        $clone->onCopy($source_parent_id, $source_question_id, $clone->getObjId(), $clone->getId());
 
        return $clone->id;
    }

createNewQuestion()

assQuestion::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.

Returns

integer ID of the new question

Definition at line 1133 of file class.assQuestion.php.

                                                                 : int
    {
        $complete = '0';
        $obj_id = $this->getObjId();
        if ($obj_id <= 0
            && $this->questionpool_request->hasRefId()) {
            $obj_id = $this->questionpool_request->getRefId();
        }
 
        if ($obj_id <= 0) {
            $obj_id = $this->questionpool_request->int('sel_qpl');
        }
 
        if ($obj_id <= 0) {
            return $this->getId();
        }
 
        $tstamp = time();
        if ($a_create_page) {
            $tstamp = 0;
        }
 
        $next_id = $this->db->nextId('qpl_questions');
        $this->db->insert("qpl_questions", [
            "question_id" => ["integer", $next_id],
            "question_type_fi" => ["integer", $this->getQuestionTypeID()],
            "obj_fi" => ["integer", $obj_id],
            "title" => ["text", ''],
            "description" => ["text", ''],
            "author" => ["text", $this->getAuthor()],
            "owner" => ["integer", $this->current_user->getId()],
            "question_text" => ["clob", ''],
            "points" => ["float", "0.0"],
            "nr_of_tries" => ["integer", $this->getDefaultNrOfTries()], // #10771
            "complete" => ["text", $complete],
            "created" => ["integer", time()],
            "original_id" => ["integer", null],
            "tstamp" => ["integer", $tstamp],
            "external_id" => ["text", $this->getExternalId()],
            'add_cont_edit_mode' => ['text', $this->getAdditionalContentEditingMode()]
        ]);
        $this->setId($next_id);
 
        if ($a_create_page) {
            // create page object of question
            $this->createPageObject();
        }
 
        return $this->getId();
    }

References ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

createPageObject()

assQuestion::createPageObject

(

)

Definition at line 1013 of file class.assQuestion.php.

                                      : void
    {
        $qpl_id = $this->getObjId();
        $this->page = new ilAssQuestionPage(0);
        $this->page->setId($this->getId());
        $this->page->setParentId($qpl_id);
        $this->page->setXMLContent("<PageObject><PageContent>" .
            "<Question QRef=\"il__qst_" . $this->getId() . "\"/>" .
            "</PageContent></PageObject>");
        $this->page->create(false);
    }

References ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

delete()

assQuestion::delete

(

int

$question_id

)

Reimplemented in assLongMenu.

Definition at line 841 of file class.assQuestion.php.

                                            : void
    {
        if ($question_id < 1) {
            return;
        }
 
        $result = $this->db->queryF(
            "SELECT obj_fi FROM qpl_questions WHERE question_id = %s",
            ['integer'],
            [$question_id]
        );
        if ($this->db->numRows($result) !== 1) {
            return;
        }
 
        $row = $this->db->fetchAssoc($result);
        $obj_id = $row["obj_fi"];
 
        try {
            $this->deletePageOfQuestion($question_id);
        } catch (Exception $e) {
            $this->log->forComponent('qpl')->error("EXCEPTION: Could not delete page of question $question_id: $e");
            return;
        }
 
        $affectedRows = $this->db->manipulateF(
            "DELETE FROM qpl_questions WHERE question_id = %s",
            ['integer'],
            [$question_id]
        );
        if ($affectedRows == 0) {
            return;
        }
 
        try {
            $this->deleteAdditionalTableData($question_id);
            $this->deleteAnswers($question_id);
            $this->feedbackOBJ->deleteGenericFeedbacks($question_id, $this->isAdditionalContentEditingModePageObject());
            $this->feedbackOBJ->deleteSpecificAnswerFeedbacks($question_id, $this->isAdditionalContentEditingModePageObject());
        } catch (Exception $e) {
            $this->log->forComponent('qpl')->error("EXCEPTION: Could not delete additional table data of question {$question_id}: {$e}");
        }
 
        try {
            // delete the question in the tst_test_question table (list of test questions)
            $affectedRows = $this->db->manipulateF(
                "DELETE FROM tst_test_question WHERE question_fi = %s",
                ['integer'],
                [$question_id]
            );
        } catch (Exception $e) {
            $this->log->forComponent('qpl')->error("EXCEPTION: Could not delete delete question {$question_id} from a test: {$e}");
        }
 
        try {
            $this->getSuggestedSolutionsRepo()->deleteForQuestion($question_id);
        } catch (Exception $e) {
            $this->log->forComponent('qpl')->error("EXCEPTION: Could not delete suggested solutions of question {$question_id}: {$e}");
        }
 
        $directory = CLIENT_WEB_DIR . "/assessment/" . $obj_id . "/$question_id";
        try {
            if (is_dir($directory)) {
                ilFileUtils::delDir($directory);
            }
        } catch (Exception $e) {
            $this->log->forComponent('qpl')->error("EXCEPTION: Could not delete question file directory {$directory} of question {$question_id}: {$e}");
        }
 
        try {
            $mobs = ilObjMediaObject::_getMobsOfObject("qpl:html", $question_id);
            // remaining usages are not in text anymore -> delete them
            // and media objects (note: delete method of ilObjMediaObject
            // checks whether object is used in another context; if yes,
            // the object is not deleted!)
            foreach ($mobs as $mob) {
                ilObjMediaObject::_removeUsage($mob, "qpl:html", $question_id);
                if (ilObjMediaObject::_exists($mob)) {
                    $mob_obj = new ilObjMediaObject($mob);
                    $mob_obj->delete();
                }
            }
        } catch (Exception $e) {
            $this->log->forComponent('qpl')->error("EXCEPTION: Error deleting the media objects of question {$question_id}: {$e}");
        }
        $assignmentList = new ilAssQuestionSkillAssignmentList($this->db);
        $assignmentList->setParentObjId($obj_id);
        $assignmentList->setQuestionIdFilter($question_id);
        $assignmentList->loadFromDb();
        foreach ($assignmentList->getAssignmentsByQuestionId($question_id) as $assignment) {
            /* @var ilAssQuestionSkillAssignment $assignment */
            $assignment->deleteFromDb();
 
            // remove skill usage
            if (!$assignment->isSkillUsed()) {
                $this->skillUsageService->removeUsage(
                    $assignment->getParentObjId(),
                    $assignment->getSkillBaseId(),
                    $assignment->getSkillTrefId()
                );
            }
        }
 
        $this->deleteTaxonomyAssignments();
        $this->deleteComments();
 
        try {
            ilObjQuestionPool::_updateQuestionCount($this->getObjId());
        } catch (Exception $e) {
            $this->log->forComponent('qpl')->error(
                "EXCEPTION: Error updating the question pool question count of"
                . " question pool {$this->getObjId()} when deleting question {$question_id}: {$e}"
            );
        }
    }

References Vendor\Package\$e, ilObjMediaObject\_exists(), ilObjMediaObject\_getMobsOfObject(), ilObjMediaObject\_removeUsage(), ilObjQuestionPool\_updateQuestionCount(), CLIENT_WEB_DIR, and ilFileUtils\delDir().

Here is the call graph for this function:

deleteAdditionalTableData()

assQuestion::deleteAdditionalTableData

(

int

$question_id

)

Definition at line 820 of file class.assQuestion.php.

                                                               : void
    {
        $table_name = $this->getAdditionalTableName();
 
        if (strlen($table_name)) {
            $this->db->manipulateF(
                "DELETE FROM $table_name WHERE question_fi = %s",
                [ilDBConstants::T_INTEGER],
                [$question_id]
            );
        }
    }

References ilDBConstants\T_INTEGER.

deleteAnswers()

assQuestion::deleteAnswers

(

int

$question_id

)

Reimplemented in assFormulaQuestion.

Definition at line 801 of file class.assQuestion.php.

                                                   : void
    {
        $answer_table_name = $this->getAnswerTableName();
 
        if (!is_array($answer_table_name)) {
            $answer_table_name = [$answer_table_name];
        }
 
        foreach ($answer_table_name as $table) {
            if (strlen($table)) {
                $this->db->manipulateF(
                    "DELETE FROM $table WHERE question_fi = %s",
                    ['integer'],
                    [$question_id]
                );
            }
        }
    }

deleteComments()

assQuestion::deleteComments ( )

protected

Definition at line 1486 of file class.assQuestion.php.

                                       : void
    {
        $repo = $this->getNotesRepo();
        $manager = $this->getNotesManager();
        $source_id = $this->getId();
        $notes = $manager->getNotesForRepositoryObjIds([$this->getObjId()], Note::PUBLIC);
        $notes = array_filter(
            $notes,
            fn($n) => $n->getContext()->getSubObjId() === $source_id
        );
        foreach ($notes as $note) {
            $repo->deleteNote($note->getId());
        }
    }

References ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

deleteDummySolutionRecord()

assQuestion::deleteDummySolutionRecord ( int  $activeId, int  $passIndex  )

protected

Definition at line 2560 of file class.assQuestion.php.

                                                                               : void
    {
        foreach ($this->getSolutionValues($activeId, $passIndex, false) as $solutionRec) {
            if ($solutionRec['value1'] == '' && $solutionRec['value2'] == '') {
                $this->removeSolutionRecordById($solutionRec['solution_id']);
            }
        }
    }

deletePageOfQuestion()

assQuestion::deletePageOfQuestion ( int  $question_id )

protected

Definition at line 833 of file class.assQuestion.php.

                                                             : void
    {
        if (ilAssQuestionPage::_exists('qpl', $question_id, "", true)) {
            $page = new ilAssQuestionPage($question_id);
            $page->delete();
        }
    }

References $page, and ilPageObject\_exists().

Here is the call graph for this function:

deleteSolutionRecordByValues()

assQuestion::deleteSolutionRecordByValues ( int  $activeId, int  $passIndex, bool  $authorized, array  $matchValues  )

protected

Definition at line 2574 of file class.assQuestion.php.

                                                                                                                        : void
    {
        $types = ["integer", "integer", "integer", "integer"];
        $values = [$activeId, $this->getId(), $passIndex, (int) $authorized];
        $valuesCondition = [];
 
        foreach ($matchValues as $valueField => $value) {
            switch ($valueField) {
                case 'value1':
                case 'value2':
                    $valuesCondition[] = "{$valueField} = %s";
                    $types[] = 'text';
                    $values[] = $value;
                    break;
 
                default:
                    throw new ilTestQuestionPoolException('invalid value field given: ' . $valueField);
            }
        }
 
        $valuesCondition = implode(' AND ', $valuesCondition);
 
        $query = "
                        DELETE FROM tst_solutions
                        WHERE active_fi = %s
                        AND question_fi = %s
                        AND pass = %s
                        AND authorized = %s
                        AND $valuesCondition
                ";
 
        if ($this->getStep() !== null) {
            $query .= " AND step = %s ";
            $types[] = 'integer';
            $values[] = $this->getStep();
        }
 
        $this->db->manipulateF($query, $types, $values);
    }

References ILIAS\Survey\Mode\getId(), and ILIAS\Repository\int().

Here is the call graph for this function:

deleteSuggestedSolutions()

assQuestion::deleteSuggestedSolutions

(

)

Definition at line 1519 of file class.assQuestion.php.

                                              : void
    {
        $this->getSuggestedSolutionsRepo()->deleteForQuestion($this->getId());
        ilInternalLink::_deleteAllLinksOfSource("qst", $this->getId());
        ilFileUtils::delDir($this->getSuggestedSolutionPath());
        $this->suggested_solutions = [];
    }

References ilInternalLink\_deleteAllLinksOfSource(), ilFileUtils\delDir(), and ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

deleteTaxonomyAssignments()

assQuestion::deleteTaxonomyAssignments ( )

private

Definition at line 957 of file class.assQuestion.php.

                                                : void
    {
        $taxIds = ilObjTaxonomy::getUsageOfObject($this->getObjId());
 
        foreach ($taxIds as $taxId) {
            $taxNodeAssignment = new ilTaxNodeAssignment('qpl', $this->getObjId(), 'quest', $taxId);
            $taxNodeAssignment->deleteAssignmentsOfItem($this->getId());
        }
    }

References ILIAS\Survey\Mode\getId(), and ilObjTaxonomy\getUsageOfObject().

Here is the call graph for this function:

duplicate()

assQuestion::duplicate	(	bool	$set_original_id = true,
		string	$title = '',
		string	$author = '',
		int	$owner = -1,
			$test_obj_id = null
	)

Definition at line 1247 of file class.assQuestion.php.

     : int {
        if ($this->id <= 0) {
            // The question has not been saved. It cannot be duplicated
            return -1;
        }
 
        $clone = clone $this;
        $clone->id = -1;
 
        if ((int) $test_obj_id > 0) {
            $clone->setObjId($test_obj_id);
        }
 
        if ($title) {
            $clone->setTitle($title);
        }
        if ($author) {
            $clone->setAuthor($author);
        }
        if ($owner) {
            $clone->setOwner($owner);
        }
        if ($set_original_id) {
            $clone->saveToDb($this->id);
        } else {
            $clone->saveToDb();
        }
 
        $clone->clonePageOfQuestion($this->getId());
        $clone->cloneXHTMLMediaObjectsOfQuestion($this->getId());
 
        $clone = $this->cloneQuestionTypeSpecificProperties($clone);
 
        $clone->onDuplicate($this->getObjId(), $this->getId(), $clone->getObjId(), $clone->getId());
 
        return $clone->id;
    }

duplicateComments()

assQuestion::duplicateComments ( int  $parent_source_id, int  $source_id, int  $parent_target_id, int  $target_id  )

protected

Definition at line 1452 of file class.assQuestion.php.

     : void {
        $manager = $this->getNotesManager();
        $data_service = $this->getNotesDataService();
        $notes = $manager->getNotesForRepositoryObjIds([$parent_source_id], Note::PUBLIC);
        $notes = array_filter(
            $notes,
            fn($n) => $n->getContext()->getSubObjId() === $source_id
        );
 
        foreach ($notes as $note) {
            $new_context = $data_service->context(
                $parent_target_id,
                $target_id,
                $note->getContext()->getType()
            );
            $new_note = $data_service->note(
                -1,
                $new_context,
                $note->getText(),
                $note->getAuthor(),
                $note->getType(),
                $note->getCreationDate(),
                $note->getUpdateDate(),
                $note->getRecipient()
            );
            $manager->createNote($new_note, [], true);
        }
    }

duplicateIntermediateSolutionAuthorized()

assQuestion::duplicateIntermediateSolutionAuthorized ( int  $activeId, int  $passIndex  )

protected

Definition at line 2614 of file class.assQuestion.php.

                                                                                             : void
    {
        foreach ($this->getSolutionValues($activeId, $passIndex, false) as $rec) {
            $this->saveCurrentSolution($activeId, $passIndex, $rec['value1'], $rec['value2'], true, $rec['tstamp']);
        }
    }

duplicateSkillAssignments()

assQuestion::duplicateSkillAssignments ( int  $srcParentId, int  $srcQuestionId, int  $trgParentId, int  $trgQuestionId  )

protected

Definition at line 2222 of file class.assQuestion.php.

                                                                                                                            : void
    {
        $assignmentList = new ilAssQuestionSkillAssignmentList($this->db);
        $assignmentList->setParentObjId($srcParentId);
        $assignmentList->setQuestionIdFilter($srcQuestionId);
        $assignmentList->loadFromDb();
 
        foreach ($assignmentList->getAssignmentsByQuestionId($srcQuestionId) as $assignment) {
            $assignment->setParentObjId($trgParentId);
            $assignment->setQuestionId($trgQuestionId);
            $assignment->saveToDb();
 
            // add skill usage
            $this->skillUsageService->addUsage(
                $trgParentId,
                $assignment->getSkillBaseId(),
                $assignment->getSkillTrefId()
            );
        }
    }

duplicateSuggestedSolutionFiles()

assQuestion::duplicateSuggestedSolutionFiles ( int  $parent_id, int  $question_id  )

protected

Duplicates the files of a suggested solution if the question is duplicated.

Definition at line 1547 of file class.assQuestion.php.

                                                                                        : void
    {
        foreach ($this->suggested_solutions as $solution) {
            if (!$solution->isOfTypeFile()
                || $solution->getFilename() === '') {
                continue;
            }
 
            $filepath = $this->getSuggestedSolutionPath();
            $filepath_original = str_replace(
                "/{$this->obj_id}/{$this->id}/solution",
                "/{$parent_id}/{$question_id}/solution",
                $filepath
            );
            if (!file_exists($filepath)) {
                ilFileUtils::makeDirParents($filepath);
            }
            if (!is_file($filepath_original . $solution->getFilename())
                || !copy($filepath_original . $solution->getFilename(), $filepath . $solution->getFilename())) {
                $this->log->forComponent('qpl')->error('File for suggested solutions could not be duplicated:');
                $this->log->forComponent('qpl')->error("Question-Id: {$this->id}; Question-Title: {$this->title}; File: {$filepath_original}{$solution->getFilename()}");
            }
        }
    }

References ILIAS\UI\examples\Symbol\Glyph\Copy\copy(), and ilFileUtils\makeDirParents().

Here is the call graph for this function:

ensureNonNegativePoints()

assQuestion::ensureNonNegativePoints ( float  $points )

protected

Definition at line 1823 of file class.assQuestion.php.

                                                             : float
    {
        return $points > 0.0 ? $points : 0.0;
    }

Referenced by assNumeric\calculateReachedPointsFromPreviewSession().

Here is the caller graph for this function:

explodeKeyValues()

static assQuestion::explodeKeyValues ( string  $keyValues )

static

Definition at line 2555 of file class.assQuestion.php.

                                                              : array
    {
        return explode(assQuestion::KEY_VALUES_IMPLOSION_SEPARATOR, $keyValues);
    }

References KEY_VALUES_IMPLOSION_SEPARATOR.

extendedTrim()

static assQuestion::extendedTrim ( string  $value )

static

Trim non-printable characters from the beginning and end of a string.

Note: The PHP trim() function is not fully Unicode-compatible and may not handle non-printable characters effectively. As a result, it may not trim certain Unicode characters, such as control characters, zero width characters or ideographic space as expected.

This method provides a workaround for trimming non-printable characters until PHP 8.4, where the mb_trim() function is introduced. Users are encouraged to migrate to mb_trim() for proper Unicode and non-printable character handling.

Parameters

string

$value

The string to trim.

Returns

string The trimmed string.

Definition at line 2881 of file class.assQuestion.php.

                                                      : string
    {
        return preg_replace(self::TRIM_PATTERN, '', $value);
    }

Referenced by assTextSubsetGUI\writeAnswerSpecificPostData().

Here is the caller graph for this function:

fetchIndexedValuesFromValuePairs()

assQuestion::fetchIndexedValuesFromValuePairs

(

array

$value_pairs

)

Reimplemented in assMatchingQuestion.

Definition at line 2823 of file class.assQuestion.php.

                                                                        : array
    {
        $indexed_values = [];
 
        foreach ($value_pairs as $valuePair) {
            $indexed_values[$valuePair['value1']] = $valuePair['value2'];
        }
 
        return $indexed_values;
    }

fetchValuePairsFromIndexedValues()

assQuestion::fetchValuePairsFromIndexedValues

(

array

$indexedValues

)

Definition at line 2812 of file class.assQuestion.php.

                                                                          : array
    {
        $valuePairs = [];
 
        foreach ($indexedValues as $value1 => $value2) {
            $valuePairs[] = ['value1' => $value1, 'value2' => $value2];
        }
 
        return $valuePairs;
    }

fixSvgToPng()

assQuestion::fixSvgToPng

(

string

$imageFilenameContainingString

)

Definition at line 1062 of file class.assQuestion.php.

                                                                      : string
    {
        $needles = array_keys(self::$imageSourceFixReplaceMap);
        $replacements = array_values(self::$imageSourceFixReplaceMap);
        return str_replace($needles, $replacements, $imageFilenameContainingString);
    }

fixUnavailableSkinImageSources()

assQuestion::fixUnavailableSkinImageSources

(

string

$html

)

Definition at line 1069 of file class.assQuestion.php.

                                                                : string
    {
        $matches = null;
        if (preg_match_all('/src="(.*?)"/m', $html, $matches)) {
            $sources = $matches[1];
 
            $needleReplacementMap = [];
 
            foreach ($sources as $src) {
                $file = ilFileUtils::removeTrailingPathSeparators(ILIAS_ABSOLUTE_PATH) . DIRECTORY_SEPARATOR . $src;
 
                if (file_exists($file)) {
                    continue;
                }
 
                $levels = explode(DIRECTORY_SEPARATOR, $src);
                if (count($levels) < 5 || $levels[0] !== 'Customizing' || $levels[2] !== 'skin') {
                    continue;
                }
 
                $component = '';
 
                if ($levels[4] === 'components/ILIAS' || $levels[4] === 'components/ILIAS') {
                    $component = $levels[4] . DIRECTORY_SEPARATOR . $levels[5];
                }
 
                $needleReplacementMap[$src] = ilUtil::getImagePath(basename($src), $component);
            }
 
            if (count($needleReplacementMap)) {
                $html = str_replace(array_keys($needleReplacementMap), array_values($needleReplacementMap), $html);
            }
        }
 
        return $html;
    }

References ilUtil\getImagePath(), and ilFileUtils\removeTrailingPathSeparators().

Here is the call graph for this function:

forceExistingIntermediateSolution()

assQuestion::forceExistingIntermediateSolution ( int  $activeId, int  $passIndex, bool  $considerDummyRecordCreation  )

protected

Definition at line 2621 of file class.assQuestion.php.

                                                                                                                          : void
    {
        $intermediateSolution = $this->getSolutionValues($activeId, $passIndex, false);
 
        if (!count($intermediateSolution)) {
            $this->updateCurrentSolutionsAuthorization($activeId, $passIndex, false, true);
 
            // create a backup as authorized solution again (keeping timestamps)
            $this->duplicateIntermediateSolutionAuthorized($activeId, $passIndex);
 
            if ($considerDummyRecordCreation) {
                // create an additional dummy record to indicate the existence of an intermediate solution
                // even if all entries are deleted from the intermediate solution later
                $this->saveCurrentSolution($activeId, $passIndex, null, null, false);
            }
        }
    }

formatSAQuestion()

assQuestion::formatSAQuestion

(

$a_q

)

Definition at line 2146 of file class.assQuestion.php.

                                          : string
    {
        return $this->getSelfAssessmentFormatter()->format($a_q);
    }

fromNormalized()

assQuestion::fromNormalized	(	array	$normalized,
		Transformations	$transformations
	)

Parameters

array<array-key,mixed>

$normalized

Reimplemented in assClozeTest, assErrorText, assFileUpload, assFormulaQuestion, assImagemapQuestion, assKprimChoice, assLongMenu, assMatchingQuestion, assMultipleChoice, assNumeric, assOrderingHorizontal, assOrderingQuestion, assSingleChoice, assTextQuestion, and assTextSubset.

Definition at line 2999 of file class.assQuestion.php.

     : static
    {
        $clone = clone $this;
        $clone->id = $transformations->denormalize($normalized['id'], Id::class)->getId();
        $clone->obj_id = $transformations->denormalize($normalized['parent_id'], Id::class)->getId();
        $clone->original_id = $transformations->nullableInt($normalized['original_id']);
        $clone->external_id = $transformations->nullableString($normalized['external_id']);
        $clone->owner = $transformations->int($normalized['owner']);
        $clone->title = $transformations->string($normalized['title']);
        $clone->comment = $transformations->string($normalized['description']);
        $clone->question = $transformations->string($normalized['question_text']);
        $clone->points = $transformations->float($normalized['available_points']);
        $clone->nr_of_tries = $transformations->int($normalized['nr_of_tries']);
        $clone->lifecycle = $transformations->denormalize($normalized['lifecycle'], $clone->lifecycle);
        $clone->author = $transformations->string($normalized['author']);
        $clone->lastChange = $transformations->nullableInt($normalized['updated_timestamp']);
        $clone->additionalContentEditingMode = $transformations->string($normalized['additional_content_editing_mode']);
        $clone->thumb_size = $transformations->int($normalized['thumb_size']);
        $clone->shuffle = $transformations->bool($normalized['shuffle']);
 
        $clone->suggested_solutions = array_map(
            static fn(array $suggested_solution): SuggestedSolution => $transformations->denormalize(
                $suggested_solution,
                SuggestedSolution::class
            ),
            $normalized['suggested_solutions']
        );
 
        return $clone;
    }

References ILIAS\TestQuestionPool\ExportImport\Foundation\Normalize\Transformations\bool(), ILIAS\TestQuestionPool\ExportImport\Foundation\Normalize\Transformations\denormalize(), ILIAS\TestQuestionPool\ExportImport\Foundation\Normalize\Transformations\float(), ILIAS\TestQuestionPool\ExportImport\Foundation\Normalize\Transformations\int(), ILIAS\TestQuestionPool\ExportImport\Foundation\Normalize\Transformations\nullableInt(), ILIAS\TestQuestionPool\ExportImport\Foundation\Normalize\Transformations\nullableString(), and ILIAS\TestQuestionPool\ExportImport\Foundation\Normalize\Transformations\string().

Here is the call graph for this function:

fromXML()

assQuestion::fromXML ( string  $importdirectory, int  $user_id, ilQTIItem  $item, int  $questionpool_id, ?int  $tst_id, ?ilObject &  $tst_object, int &  $question_counter, array  $import_mapping  )

final

Deprecated:

12: Use ILIAS\TestQuestionPool\ExportImport\Import\QuestionsImporter instead

Definition at line 267 of file class.assQuestion.php.

     : array {
        $classname = $this->getQuestionType() . "Import";
        $import = new $classname($this);
        $new_import_mapping = $import->fromXML(
            $importdirectory,
            $user_id,
            $item,
            $questionpool_id,
            $tst_id,
            $tst_object,
            $question_counter,
            $import_mapping
        );
        return $new_import_mapping;
    }

getActiveUserData()

assQuestion::getActiveUserData

(

int

$active_id

)

Returns the user id and the test id for a given active id.

Parameters

integer

$active_id

Active id for a test/user

Returns

array Result array containing the user_id and test_id

Definition at line 2049 of file class.assQuestion.php.

                                                     : array
    {
        $result = $this->db->queryF(
            "SELECT * FROM tst_active WHERE active_id = %s",
            ['integer'],
            [$active_id]
        );
        if ($this->db->numRows($result)) {
            $row = $this->db->fetchAssoc($result);
            return ["user_id" => $row["user_fi"], "test_id" => $row["test_fi"]];
        }
 
        return [];
    }

getAdditionalContentEditingMode()

assQuestion::getAdditionalContentEditingMode

(

)

Definition at line 2298 of file class.assQuestion.php.

                                                     : string
    {
        return $this->additionalContentEditingMode;
    }

getAdditionalTableName()

assQuestion::getAdditionalTableName ( )

abstract

Reimplemented in assClozeTest, assErrorText, assFileUpload, assFormulaQuestion, assImagemapQuestion, assKprimChoice, assLongMenu, assMatchingQuestion, assMultipleChoice, assNumeric, assOrderingHorizontal, assOrderingQuestion, assSingleChoice, assTextQuestion, and assTextSubset.

getAdjustedReachedPoints()

assQuestion::getAdjustedReachedPoints ( int  $active_id, int  $pass, bool  $authorized_solution = true  )

final

Definition at line 546 of file class.assQuestion.php.

                                                                                                               : float
    {
        // determine reached points for submitted solution
        $reached_points = $this->calculateReachedPoints($active_id, $pass, $authorized_solution);
        // adjust reached points regarding to tests scoring options
        $reached_points = $this->adjustReachedPointsByScoringOptions($reached_points, $active_id);
 
        return $reached_points;
    }

getAnswerTableName()

assQuestion::getAnswerTableName ( )

abstract

Reimplemented in assClozeTest, assErrorText, assFileUpload, assFormulaQuestion, assImagemapQuestion, assKprimChoice, assLongMenu, assMatchingQuestion, assMultipleChoice, assNumeric, assOrderingHorizontal, assOrderingQuestion, assSingleChoice, assTextQuestion, and assTextSubset.

getAuthor()

assQuestion::getAuthor

(

)

Definition at line 409 of file class.assQuestion.php.

                               : string
    {
        return $this->author;
    }

Referenced by assClozeTest\isComplete(), and assOrderingQuestion\isComplete().

Here is the caller graph for this function:

getAuthorForHTMLOutput()

assQuestion::getAuthorForHTMLOutput

(

)

Definition at line 414 of file class.assQuestion.php.

                                            : string
    {
        return $this->refinery->string()->stripTags()->transform($this->author);
    }

References ILIAS\Repository\refinery().

Here is the call graph for this function:

getComment()

assQuestion::getComment

(

)

Definition at line 375 of file class.assQuestion.php.

                                : string
    {
        return $this->comment;
    }

References $comment.

getCorrectSolutionForTextOutput()

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

Reimplemented in assClozeTest, assErrorText, assFileUpload, assFormulaQuestion, assImagemapQuestion, assKprimChoice, assLongMenu, assMatchingQuestion, assMultipleChoice, assNumeric, assOrderingHorizontal, assOrderingQuestion, assSingleChoice, assTextQuestion, and assTextSubset.

Definition at line 2951 of file class.assQuestion.php.

     : array|string {
        return $this->solutionValuesToText(
            $this->getSolutionValues($active_id, $pass)
        );
    }

getCurrentSolutionResultSet()

assQuestion::getCurrentSolutionResultSet ( int  $active_id, int  $pass, bool  $authorized = true  )

protected

Definition at line 2372 of file class.assQuestion.php.

                                                                                                      : \ilDBStatement
    {
        if ($this->getStep() !== null) {
            $query = "
                                SELECT *
                                FROM tst_solutions
                                WHERE active_fi = %s
                                AND question_fi = %s
                                AND pass = %s
                                AND step = %s
                                AND authorized = %s
                        ";
 
            return $this->db->queryF(
                $query,
                ['integer', 'integer', 'integer', 'integer', 'integer'],
                [$active_id, $this->getId(), $pass, $this->getStep(), (int) $authorized]
            );
        }
 
        $query = "
            SELECT *
            FROM tst_solutions
            WHERE active_fi = %s
            AND question_fi = %s
            AND pass = %s
            AND authorized = %s
        ";
 
        return $this->db->queryF(
            $query,
            ['integer', 'integer', 'integer', 'integer'],
            [$active_id, $this->getId(), $pass, (int) $authorized]
        );
    }

References ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

getCurrentUser()

assQuestion::getCurrentUser

(

)

Definition at line 239 of file class.assQuestion.php.

                                    : ilObjUser
    {
        return $this->current_user;
    }

References $current_user.

getDefaultNrOfTries()

assQuestion::getDefaultNrOfTries

(

)

Definition at line 2202 of file class.assQuestion.php.

                                         : int
    {
        return $this->defaultnroftries;
    }

getDescriptionForHTMLOutput()

assQuestion::getDescriptionForHTMLOutput

(

)

Definition at line 380 of file class.assQuestion.php.

                                                 : string
    {
        return $this->refinery->encode()->htmlSpecialCharsAsEntities()->transform($this->comment);
    }

References ILIAS\UI\examples\Symbol\Glyph\Comment\comment(), and ILIAS\Repository\refinery().

Here is the call graph for this function:

getExternalId()

assQuestion::getExternalId

(

)

Definition at line 449 of file class.assQuestion.php.

                                   : string
    {
        if ($this->external_id === null || $this->external_id === '') {
            if ($this->getId() > 0) {
                return 'il_' . IL_INST_ID . '_qst_' . $this->getId();
            }
            return uniqid('', true);
        }
        return $this->external_id;
    }

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

Here is the call graph for this function:

getFeedbackClassNameByQuestionType()

static assQuestion::getFeedbackClassNameByQuestionType ( string  $questionType )

static

Definition at line 2069 of file class.assQuestion.php.

                                                                                   : string
    {
        return str_replace('ass', 'ilAss', $questionType) . 'Feedback';
    }

Referenced by assQuestionGUI\_getQuestionGUI().

Here is the caller graph for this function:

getHtmlQuestionContentPurifier()

assQuestion::getHtmlQuestionContentPurifier

(

)

Returns

ilHtmlPurifierInterface|ilAssHtmlUserSolutionPurifier

Definition at line 2345 of file class.assQuestion.php.

                                                    : ilHtmlPurifierInterface
    {
        return ilHtmlPurifierFactory::getInstanceByType('qpl_usersolution');
    }

References ilHtmlPurifierFactory\getInstanceByType().

Referenced by assKprimChoice\addAnswer(), assKprimChoice\setAnswers(), and assLongMenu\setLongMenuTextValue().

Here is the call graph for this function:

Here is the caller graph for this function:

getHtmlUserSolutionPurifier()

assQuestion::getHtmlUserSolutionPurifier

(

)

Returns

ilHtmlPurifierInterface|ilAssHtmlUserSolutionPurifier

Definition at line 2337 of file class.assQuestion.php.

                                                 : ilHtmlPurifierInterface
    {
        return ilHtmlPurifierFactory::getInstanceByType('qpl_usersolution');
    }

References ilHtmlPurifierFactory\getInstanceByType().

Here is the call graph for this function:

getId()

assQuestion::getId

(

)

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

                           : int
    {
        return $this->id;
    }

References $id.

Referenced by ilQuestionCumulatedStatisticsTableGUI\__construct(), ilQuestionUsagesTableGUI\__construct(), assLongMenu\buildFolderName(), assLongMenu\getCorrectAnswersAsJson(), ILIAS\TestQuestionPool\ExportImport\Export\getFeedback(), ILIAS\TestQuestionPool\ExportImport\Import\QuestionsImporter\importFeedback(), assTextQuestion\loadFromDb(), ILIAS\TestQuestionPool\ExportImport\Export\loadSpecificFeedback(), ilAssNestedOrderingElementsInputGUI\prepareReprintable(), ilAssOrderingQuestionAuthoringFormGUI\renewOrderingElementInput(), assErrorText\saveAdditionalQuestionDataToDb(), assFileUpload\saveAdditionalQuestionDataToDb(), assImagemapQuestion\saveAdditionalQuestionDataToDb(), assKprimChoice\saveAdditionalQuestionDataToDb(), assLongMenu\saveAdditionalQuestionDataToDb(), assMatchingQuestion\saveAdditionalQuestionDataToDb(), assErrorText\saveAnswerSpecificDataToDb(), assImagemapQuestion\saveAnswerSpecificDataToDb(), assKprimChoice\saveAnswerSpecificDataToDb(), assLongMenu\saveAnswerSpecificDataToDb(), assMatchingQuestion\saveAnswerSpecificDataToDb(), ilAssQuestionSkillAssignmentsGUI\syncOriginalCmd(), and ilLOTestQuestionAdapter\updateQuestionResult().

Here is the caller graph for this function:

getImagePath()

assQuestion::getImagePath	(		$question_id = null,
			$object_id = null
	)

Returns the image path for web accessable images of a question.

The image path is under the CLIENT_WEB_DIR in assessment/REFERENCE_ID_OF_QUESTION_POOL/ID_OF_QUESTION/images

Definition at line 681 of file class.assQuestion.php.

                                                                        : string
    {
        if ($question_id === null) {
            $question_id = $this->id;
        }
 
        if ($object_id === null) {
            $object_id = $this->obj_id;
        }
 
        return $this->question_files->buildImagePath($question_id, $object_id);
    }

References $id.

Referenced by assKprimChoice\loadAnswerData(), assMultipleChoice\loadFromDb(), and assSingleChoice\loadFromDb().

Here is the caller graph for this function:

getImagePathWeb()

assQuestion::getImagePathWeb

(

)

Returns the web image path for web accessable images of a question.

The image path is under the web accessable data dir in assessment/REFERENCE_ID_OF_QUESTION_POOL/ID_OF_QUESTION/images TODO: in use? refactor and ask for a supported path in all cases, not for THE dynamic highlander path ^^

Definition at line 710 of file class.assQuestion.php.

                                     : string
    {
        if (!$this->export_image_path) {
            $webdir = ilFileUtils::removeTrailingPathSeparators(CLIENT_WEB_DIR)
                . "/assessment/{$this->obj_id}/{$this->id}/images/";
            return str_replace(
                ilFileUtils::removeTrailingPathSeparators(ILIAS_ABSOLUTE_PATH . '/public'),
                ilFileUtils::removeTrailingPathSeparators(ILIAS_HTTP_PATH),
                $webdir
            );
        }
        return $this->export_image_path;
    }

References CLIENT_WEB_DIR, and ilFileUtils\removeTrailingPathSeparators().

Referenced by assKprimChoice\loadAnswerData().

Here is the call graph for this function:

Here is the caller graph for this function:

getInstances()

assQuestion::getInstances

(

)

Definition at line 2005 of file class.assQuestion.php.

                                  : array
    {
        $result = $this->db->queryF(
            "SELECT question_id FROM qpl_questions WHERE original_id = %s",
            ["integer"],
            [$this->getId()]
        );
        $instances = [];
        $ids = [];
        while ($row = $this->db->fetchAssoc($result)) {
            $ids[] = $row["question_id"];
        }
        foreach ($ids as $question_id) {
            // check non random tests
            $result = $this->db->queryF(
                "SELECT tst_tests.obj_fi FROM tst_tests, tst_test_question WHERE tst_test_question.question_fi = %s AND tst_test_question.test_fi = tst_tests.test_id",
                ["integer"],
                [$question_id]
            );
            while ($row = $this->db->fetchAssoc($result)) {
                $instances[$row['obj_fi']] = ilObject::_lookupTitle($row['obj_fi']);
            }
            // check random tests
            $result = $this->db->queryF(
                "SELECT tst_tests.obj_fi FROM tst_tests, tst_test_rnd_qst, tst_active WHERE tst_test_rnd_qst.active_fi = tst_active.active_id AND tst_test_rnd_qst.question_fi = %s AND tst_tests.test_id = tst_active.test_fi",
                ["integer"],
                [$question_id]
            );
            while ($row = $this->db->fetchAssoc($result)) {
                $instances[$row['obj_fi']] = ilObject::_lookupTitle($row['obj_fi']);
            }
        }
        foreach ($instances as $key => $value) {
            $instances[$key] = ["obj_id" => $key, "title" => $value, "author" => ilObjTest::_lookupAuthor($key), "refs" => ilObject::_getAllReferences($key)];
        }
        return $instances;
    }

References ilObject\_getAllReferences(), ilObjTest\_lookupAuthor(), ilObject\_lookupTitle(), and ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

getInternalLinkHref()

assQuestion::getInternalLinkHref

(

string

$target

)

Definition at line 1686 of file class.assQuestion.php.

                                                       : string
    {
        $linktypes = [
            "lm" => "LearningModule",
            "pg" => "PageObject",
            "st" => "StructureObject",
            "git" => "GlossaryItem",
            "mob" => "MediaObject"
        ];
        $href = "";
        if (preg_match("/il__(\w+)_(\d+)/", $target, $matches)) {
            $type = $matches[1];
            $target_id = $matches[2];
            switch ($linktypes[$matches[1]]) {
                case "MediaObject":
                    $href = "./ilias.php?baseClass=ilLMPresentationGUI&obj_type=" . $linktypes[$type]
                        . "&cmd=media&ref_id=" . $this->questionpool_request->getRefId()
                        . "&mob_id=" . $target_id;
                    break;
                case "StructureObject":
                case "GlossaryItem":
                case "PageObject":
                case "LearningModule":
                default:
                    $href = "./goto.php?target=" . $type . "_" . $target_id;
                    break;
            }
        }
        return $href;
    }

References ILIAS\Scripts\PHPStan\$target.

getLastChange()

assQuestion::getLastChange

(

)

Definition at line 2367 of file class.assQuestion.php.

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

getLifecycle()

assQuestion::getLifecycle

(

)

Definition at line 434 of file class.assQuestion.php.

                                  : ilAssQuestionLifecycle
    {
        return $this->lifecycle;
    }

References $lifecycle.

getMaximumPoints()

assQuestion::getMaximumPoints

(

)

Reimplemented in assClozeTest, assErrorText, assFileUpload, assFormulaQuestion, assImagemapQuestion, assLongMenu, assMatchingQuestion, assMultipleChoice, assNumeric, assOrderingHorizontal, assOrderingQuestion, assSingleChoice, assTextQuestion, and assTextSubset.

Definition at line 541 of file class.assQuestion.php.

                                      : float
    {
        return $this->points;
    }

getMaximumThumbSize()

assQuestion::getMaximumThumbSize

(

)

Definition at line 404 of file class.assQuestion.php.

                                         : int
    {
        return self::MAXIMUM_THUMB_SIZE;
    }

getMinimumThumbSize()

assQuestion::getMinimumThumbSize

(

)

Definition at line 399 of file class.assQuestion.php.

                                         : int
    {
        return self::MINIMUM_THUMB_SIZE;
    }

Referenced by assOrderingQuestion\loadFromDb(), assMultipleChoice\loadFromDb(), and assSingleChoice\loadFromDb().

Here is the caller graph for this function:

getNotesDataService()

assQuestion::getNotesDataService ( )

protected

Definition at line 1507 of file class.assQuestion.php.

                                            : NotesInternalDataService
    {
        $service = new NotesService($this->dic);
        return $service->internal()->data();
    }

References $service.

getNotesManager()

assQuestion::getNotesManager ( )

protected

Definition at line 1501 of file class.assQuestion.php.

                                        : NotesManager
    {
        $service = new NotesService($this->dic);
        return $service->internal()->domain()->notes();
    }

References $service.

getNotesRepo()

assQuestion::getNotesRepo ( )

protected

Definition at line 1513 of file class.assQuestion.php.

                                     : NotesRepo
    {
        $service = new NotesService($this->dic);
        return $service->internal()->repo()->note();
    }

References $service.

getNrOfTries()

assQuestion::getNrOfTries

(

)

Definition at line 2114 of file class.assQuestion.php.

                                  : int
    {
        return $this->nr_of_tries;
    }

getNumExistingSolutionRecords()

static assQuestion::getNumExistingSolutionRecords ( int  $activeId, int  $pass, int  $questionId  )

staticprotected

Definition at line 2272 of file class.assQuestion.php.

                                                                                                      : int
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $query = "
                        SELECT          count(active_fi) cnt
 
                        FROM            tst_solutions
 
                        WHERE           active_fi = %s
                        AND                     question_fi = %s
                        AND                     pass = %s
                ";
 
        $res = $ilDB->queryF(
            $query,
            ['integer','integer','integer'],
            [$activeId, $questionId, $pass]
        );
 
        $row = $ilDB->fetchAssoc($res);
 
        return (int) $row['cnt'];
    }

References $DIC, $ilDB, and $res.

Referenced by isAnswered().

Here is the caller graph for this function:

getObjId()

assQuestion::getObjId

(

)

Definition at line 424 of file class.assQuestion.php.

                              : int
    {
        return $this->obj_id;
    }

Referenced by ilAssQuestionSkillAssignmentsGUI\syncOriginalCmd().

Here is the caller graph for this function:

getOriginalId()

assQuestion::getOriginalId

(

)

Definition at line 1048 of file class.assQuestion.php.

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

Referenced by ilAssQuestionSkillAssignmentsGUI\syncOriginalCmd().

Here is the caller graph for this function:

getOwner()

assQuestion::getOwner

(

)

Definition at line 419 of file class.assQuestion.php.

                              : int
    {
        return $this->owner;
    }

getPageOfQuestion()

assQuestion::getPageOfQuestion

(

)

Definition at line 1037 of file class.assQuestion.php.

                                       : string
    {
        $page = new ilAssQuestionPage($this->id);
        return $page->getXMLContent();
    }

References $page.

getPoints()

assQuestion::getPoints

(

)

Definition at line 1773 of file class.assQuestion.php.

                               : float
    {
        return $this->points;
    }

Referenced by assNumeric\calculateReachedPointsFromPreviewSession(), assFileUpload\getMaximumPoints(), assNumeric\getMaximumPoints(), assOrderingHorizontal\getMaximumPoints(), assTextSubset\isAnswerCorrect(), and assLongMenu\isComplete().

Here is the caller graph for this function:

getPreventRteUsage()

assQuestion::getPreventRteUsage

(

)

Definition at line 2163 of file class.assQuestion.php.

                                        : bool
    {
        return $this->prevent_rte_usage;
    }

getProcessLocker()

assQuestion::getProcessLocker

(

)

Definition at line 259 of file class.assQuestion.php.

                                      : ilAssQuestionProcessLocker
    {
        return $this->processLocker;
    }

References $processLocker.

getQuestion()

assQuestion::getQuestion

(

)

Definition at line 1945 of file class.assQuestion.php.

                                 : string
    {
        return $this->question;
    }

Referenced by assOrderingQuestion\isComplete().

Here is the caller graph for this function:

getQuestionAction()

assQuestion::getQuestionAction ( )

protected

Definition at line 229 of file class.assQuestion.php.

                                          : string
    {
        return $this->questionpool_request->getCmdIndex($this->questionActionCmd) ?? '';
    }

getQuestionForHTMLOutput()

assQuestion::getQuestionForHTMLOutput

(

)

Definition at line 1950 of file class.assQuestion.php.

                                              : string
    {
        return $this->purifyAndPrepareTextAreaOutput($this->question);
    }

getQuestionType()

assQuestion::getQuestionType ( )

abstract

Reimplemented in assClozeTest, assErrorText, assFileUpload, assFormulaQuestion, assImagemapQuestion, assKprimChoice, assLongMenu, assMatchingQuestion, assMultipleChoice, assNumeric, assOrderingHorizontal, assOrderingQuestion, assSingleChoice, assTextQuestion, and assTextSubset.

getQuestionTypeID()

assQuestion::getQuestionTypeID

(

)

Definition at line 1974 of file class.assQuestion.php.

                                       : int
    {
        $result = $this->db->queryF(
            "SELECT question_type_id FROM qpl_qst_type WHERE type_tag = %s",
            ['text'],
            [$this->getQuestionType()]
        );
        if ($this->db->numRows($result) == 1) {
            $row = $this->db->fetchAssoc($result);
            return (int) $row["question_type_id"];
        }
        return 0;
    }

getReachedPoints()

assQuestion::getReachedPoints	(	int	$active_id,
		int	$pass
	)

Definition at line 536 of file class.assQuestion.php.

                                                               : float
    {
        return round(self::_getReachedPoints($active_id, $this->getId(), $pass), 2);
    }

References ILIAS\Survey\Mode\getId().

Referenced by ilLOTestQuestionAdapter\updateQuestionResult().

Here is the call graph for this function:

Here is the caller graph for this function:

getRTETextWithMediaObjects()

assQuestion::getRTETextWithMediaObjects ( )

protected

Reimplemented in assClozeTest, assFileUpload, assFormulaQuestion, assImagemapQuestion, assKprimChoice, assLongMenu, assMatchingQuestion, assMultipleChoice, assNumeric, assOrderingHorizontal, assOrderingQuestion, assSingleChoice, assTextQuestion, and assTextSubset.

Definition at line 1988 of file class.assQuestion.php.

                                                   : string
    {
        // must be called in parent classes. add additional RTE text in the parent
        // classes and call this method to add the standard RTE text
        $collected = $this->getQuestion();
        $collected .= $this->feedbackOBJ->getGenericFeedbackContent($this->getId(), false);
        $collected .= $this->feedbackOBJ->getGenericFeedbackContent($this->getId(), true);
        $collected .= $this->feedbackOBJ->getAllSpecificAnswerFeedbackContents($this->getId());
        return $collected;
    }

References ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

getSelfAssessmentEditingMode()

assQuestion::getSelfAssessmentEditingMode

(

)

Definition at line 2192 of file class.assQuestion.php.

                                                  : bool
    {
        return $this->selfassessmenteditingmode;
    }

Referenced by ilAssQuestionAuthoringFormGUI\addGenericAssessmentQuestionCommandButtons().

Here is the caller graph for this function:

getSelfAssessmentFormatter()

assQuestion::getSelfAssessmentFormatter ( )

protected

Definition at line 2151 of file class.assQuestion.php.

                                                   : \ilAssSelfAssessmentQuestionFormatter
    {
        return new \ilAssSelfAssessmentQuestionFormatter();
    }

getShuffle()

assQuestion::getShuffle

(

)

Definition at line 365 of file class.assQuestion.php.

                                : bool
    {
        return $this->shuffle;
    }

getShuffler()

assQuestion::getShuffler

(

)

Definition at line 244 of file class.assQuestion.php.

                                 : Transformation
    {
        return $this->shuffler;
    }

References $shuffler.

getSolutionForTextOutput()

assQuestion::getSolutionForTextOutput	(	int	$active_id,
		int	$pass
	)

Definition at line 2942 of file class.assQuestion.php.

     : array|string {
        return $this->solutionValuesToText(
            $this->getSolutionValues($active_id, $pass)
        );
    }

getSolutionMaxPass()

assQuestion::getSolutionMaxPass

(

int

$active_id

)

Definition at line 1783 of file class.assQuestion.php.

                                                      : ?int
    {
        return self::_getSolutionMaxPass($this->getId(), $active_id);
    }

References ILIAS\Survey\Mode\getId().

Referenced by assErrorText\calculateReachedPoints(), assLongMenu\calculateReachedPoints(), assNumeric\calculateReachedPoints(), assOrderingHorizontal\calculateReachedPoints(), assTextQuestion\calculateReachedPoints(), and assTextSubset\calculateReachedPoints().

Here is the call graph for this function:

Here is the caller graph for this function:

getSolutionRecordById()

assQuestion::getSolutionRecordById ( int  $solutionId )

protected

Returns

array tst_solutions.*

Definition at line 2421 of file class.assQuestion.php.

                                                             : array
    {
        $result = $this->db->queryF(
            "SELECT * FROM tst_solutions WHERE solution_id = %s",
            ['integer'],
            [$solutionId]
        );
 
        if ($this->db->numRows($result) > 0) {
            return $this->db->fetchAssoc($result);
        }
        return [];
    }

getSolutionValues()

assQuestion::getSolutionValues	(	int	$active_id,
		?int	$pass = null,
		bool	$authorized = true
	)

Loads solutions of a given user from the database an returns it.

Definition at line 749 of file class.assQuestion.php.

     : array {
        if ($pass === null && is_numeric($active_id)) {
            $pass = $this->getSolutionMaxPass((int) $active_id);
        }
 
        if ($this->getStep() !== null) {
            $query = "
                                SELECT *
                                FROM tst_solutions
                                WHERE active_fi = %s
                                AND question_fi = %s
                                AND pass = %s
                                AND step = %s
                                AND authorized = %s
                                ORDER BY solution_id";
 
            $result = $this->db->queryF(
                $query,
                ['integer', 'integer', 'integer', 'integer', 'integer'],
                [(int) $active_id, $this->getId(), $pass, $this->getStep(), (int) $authorized]
            );
        } else {
            $query = "
                                SELECT *
                                FROM tst_solutions
                                WHERE active_fi = %s
                                AND question_fi = %s
                                AND pass = %s
                                AND authorized = %s
                                ORDER BY solution_id
                        ";
 
            $result = $this->db->queryF(
                $query,
                ['integer', 'integer', 'integer', 'integer'],
                [(int) $active_id, $this->getId(), $pass, (int) $authorized]
            );
        }
 
        $values = [];
 
        while ($row = $this->db->fetchAssoc($result)) {
            $values[] = $row;
        }
 
        return $values;
    }

Referenced by ilTestCorrectionsGUI\getSolutions(), and ilTestCorrectionsGUI\getSolutionsByParticipantResults().

Here is the caller graph for this function:

getStep()

assQuestion::getStep

(

)

Returns

int|null

Definition at line 2651 of file class.assQuestion.php.

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

getSuggestedSolution()

assQuestion::getSuggestedSolution

(

int

$subquestion_index = 0

)

Definition at line 1528 of file class.assQuestion.php.

                                                                    : ?SuggestedSolution
    {
        if (array_key_exists($subquestion_index, $this->suggested_solutions)) {
            return $this->suggested_solutions[$subquestion_index];
        }
        return null;
    }

getSuggestedSolutionOutput()

assQuestion::getSuggestedSolutionOutput

(

)

Definition at line 469 of file class.assQuestion.php.

                                                : string
    {
        $output = [];
        foreach ($this->suggested_solutions as $solution) {
            switch ($solution->getType()) {
                case SuggestedSolution::TYPE_LM:
                case SuggestedSolution::TYPE_LM_CHAPTER:
                case SuggestedSolution::TYPE_LM_PAGE:
                case SuggestedSolution::TYPE_GLOSARY_TERM:
                    $output[] = '<a href="'
                        . $this->getInternalLinkHref($solution->getInternalLink())
                        . '">'
                        . $this->lng->txt("solution_hint")
                        . '</a>';
                    break;
 
                case SuggestedSolution::TYPE_FILE:
                    $possible_texts = array_values(
                        array_filter(
                            [
                                ilLegacyFormElementsUtil::prepareFormOutput($solution->getTitle()),
                                ilLegacyFormElementsUtil::prepareFormOutput($solution->getFilename()),
                                $this->lng->txt('tst_show_solution_suggested')
                            ]
                        )
                    );
 
                    ilWACSignedPath::setTokenMaxLifetimeInSeconds(60);
                    $path_to_solution = "{$this->getSuggestedSolutionPath()}{$solution->getFilename()}";
                    if (!file_exists($path_to_solution)) {
                        break;
                    }
                    $output[] = '<a href="'
                        . ilWACSignedPath::signFile($path_to_solution)
                        . '">'
                        . $possible_texts[0]
                        . '</a>';
                    break;
            }
        }
        return implode("<br />", $output);
    }

References ILIAS\Repository\lng(), ilLegacyFormElementsUtil\prepareFormOutput(), ilWACSignedPath\setTokenMaxLifetimeInSeconds(), and ilWACSignedPath\signFile().

Here is the call graph for this function:

getSuggestedSolutionPath()

assQuestion::getSuggestedSolutionPath

(

)

Definition at line 672 of file class.assQuestion.php.

                                              : string
    {
        return CLIENT_WEB_DIR . "/assessment/$this->obj_id/$this->id/solution/";
    }

References CLIENT_WEB_DIR.

getSuggestedSolutionPathWeb()

assQuestion::getSuggestedSolutionPathWeb

(

)

Definition at line 694 of file class.assQuestion.php.

                                                 : string
    {
        $webdir = ilFileUtils::removeTrailingPathSeparators(CLIENT_WEB_DIR)
            . "/assessment/{$this->obj_id}/{$this->id}/solution/";
        return str_replace(
            ilFileUtils::removeTrailingPathSeparators(ILIAS_ABSOLUTE_PATH . '/public'),
            ilFileUtils::removeTrailingPathSeparators(ILIAS_HTTP_PATH),
            $webdir
        );
    }

References CLIENT_WEB_DIR, and ilFileUtils\removeTrailingPathSeparators().

Here is the call graph for this function:

getSuggestedSolutions()

assQuestion::getSuggestedSolutions

(

)

Definition at line 512 of file class.assQuestion.php.

                                           : array
    {
        return $this->suggested_solutions;
    }

getSuggestedSolutionsRepo()

assQuestion::getSuggestedSolutionsRepo ( )

protected

Definition at line 2857 of file class.assQuestion.php.

                                                  : SuggestedSolutionsDatabaseRepository
    {
        return $this->suggestedsolution_repo;
    }

getTestId()

assQuestion::getTestId

(

)

Definition at line 370 of file class.assQuestion.php.

                               : int
    {
        return $this->test_id;
    }

getTestOutputSolutions()

assQuestion::getTestOutputSolutions	(	int	$activeId,
		int	$pass
	)

Definition at line 724 of file class.assQuestion.php.

                                                                    : array
    {
        if ($this->getTestPresentationConfig()->isSolutionInitiallyPrefilled()) {
            return $this->getSolutionValues($activeId, $pass, true);
        }
        return $this->getUserSolutionPreferingIntermediate($activeId, $pass);
    }

getTestPresentationConfig()

assQuestion::getTestPresentationConfig

(

)

Definition at line 2843 of file class.assQuestion.php.

                                               : ilTestQuestionConfig
    {
        if ($this->test_question_config === null) {
            $this->test_question_config = $this->buildTestPresentationConfig();
        }
 
        return $this->test_question_config;
    }

Referenced by ilTestPlayerAbstractGUI\initTestQuestionConfig().

Here is the caller graph for this function:

getThumbSize()

assQuestion::getThumbSize

(

)

Reimplemented in assKprimChoice, and assMatchingQuestion.

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

                                  : int
    {
        return $this->thumb_size;
    }

getTitle()

assQuestion::getTitle

(

)

Definition at line 345 of file class.assQuestion.php.

                              : string
    {
        return $this->title;
    }

Referenced by assClozeTest\isComplete(), and assOrderingQuestion\isComplete().

Here is the caller graph for this function:

getTitleFilenameCompliant()

assQuestion::getTitleFilenameCompliant

(

)

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

                                               : string
    {
        return ilFileUtils::getASCIIFilename($this->getTitle());
    }

References ilFileUtils\getASCIIFilename(), and ILIAS\GlobalScreen\Scope\Footer\Factory\getTitle().

Here is the call graph for this function:

getTitleForHTMLOutput()

assQuestion::getTitleForHTMLOutput

(

)

Definition at line 350 of file class.assQuestion.php.

                                           : string
    {
        return $this->refinery->encode()->htmlSpecialCharsAsEntities()->transform($this->title);
    }

References ILIAS\Repository\refinery().

Here is the call graph for this function:

getTotalAnswers()

assQuestion::getTotalAnswers

(

)

Definition at line 967 of file class.assQuestion.php.

                                     : int
    {
        // get all question references to the question id
        $result = $this->db->queryF(
            "SELECT question_id FROM qpl_questions WHERE original_id = %s OR question_id = %s",
            ['integer','integer'],
            [$this->id, $this->id]
        );
        if ($this->db->numRows($result) == 0) {
            return 0;
        }
        $found_id = [];
        while ($row = $this->db->fetchAssoc($result)) {
            $found_id[] = $row["question_id"];
        }
 
        $result = $this->db->query("SELECT * FROM tst_test_result WHERE " . $this->db->in('question_fi', $found_id, false, 'integer'));
 
        return $this->db->numRows($result);
    }

getUserSolutionPreferingIntermediate()

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

Reimplemented in assFileUpload.

Definition at line 733 of file class.assQuestion.php.

     : array {
        $solution = $this->getSolutionValues($active_id, $pass, false);
 
        if (!count($solution)) {
            $solution = $this->getSolutionValues($active_id, $pass, true);
        }
 
        return $solution;
    }

getValidAdditionalContentEditingModes()

assQuestion::getValidAdditionalContentEditingModes

(

)

Definition at line 2326 of file class.assQuestion.php.

                                                           : array
    {
        return [
            self::ADDITIONAL_CONTENT_EDITING_MODE_RTE,
            self::ADDITIONAL_CONTENT_EDITING_MODE_IPE
        ];
    }

getVariablesAsTextArray()

assQuestion::getVariablesAsTextArray	(	int	$active_id,
		int	$pass
	)

Reimplemented in assFormulaQuestion.

Definition at line 2960 of file class.assQuestion.php.

     : array {
        return [];
    }

hasSpecificFeedback()

assQuestion::hasSpecificFeedback

(

)

Definition at line 2064 of file class.assQuestion.php.

                                         : bool
    {
        return static::HAS_SPECIFIC_FEEDBACK;
    }

hasWritableOriginalInQuestionPool()

assQuestion::hasWritableOriginalInQuestionPool

(

)

Definition at line 2886 of file class.assQuestion.php.

                                                       : bool
    {
        return !is_null($this->original_id)
            && $this->questionrepository->questionExistsInPool($this->original_id)
            && assQuestion::instantiateQuestion($this->original_id)->isWriteable();
    }

References instantiateQuestion().

Here is the call graph for this function:

implodeKeyValues()

static assQuestion::implodeKeyValues ( array  $keyValues )

static

Definition at line 2550 of file class.assQuestion.php.

                                                             : string
    {
        return implode(assQuestion::KEY_VALUES_IMPLOSION_SEPARATOR, $keyValues);
    }

References KEY_VALUES_IMPLOSION_SEPARATOR.

Referenced by assImagemapQuestionGUI\buildSelectionParameter().

Here is the caller graph for this function:

instantiateQuestion()

static assQuestion::instantiateQuestion ( int  $question_id )

static

Parameters

int

$question_id

Returns

assQuestion

Exceptions

InvalidArgumentException

Definition at line 1752 of file class.assQuestion.php.

                                                                : assQuestion
    {
        global $DIC;
        $ilCtrl = $DIC['ilCtrl'];
        $ilDB = $DIC['ilDB'];
        $lng = $DIC['lng'];
        $questionrepository = QuestionPoolDIC::dic()['question.general_properties.repository'];
        $question_type = $questionrepository->getForQuestionId($question_id)?->getClassName() ?? '';
        if ($question_type === '') {
            throw new InvalidArgumentException('No question with ID ' . $question_id . ' exists');
        }
 
        $question = new $question_type();
        $question->loadFromDb($question_id);
 
        $feedbackObjectClassname = self::getFeedbackClassNameByQuestionType($question_type);
        $question->feedbackOBJ = new $feedbackObjectClassname($question, $ilCtrl, $ilDB, $lng);
 
        return $question;
    }

References $DIC, $ilDB, $lng, and ILIAS\TestQuestionPool\Questions\GeneralQuestionPropertiesRepository\getForQuestionId().

Referenced by ilObjTest\_instanciateQuestion(), ilTestFixedQuestionSetConfig\cloneQuestionSetRelatedData(), ilObjTestGUI\copyAndLinkQuestionsToPoolObject(), ilObjQuestionPool\deleteQuestion(), ilTestResultsToXML\exportTestResults(), ILIAS\TestQuestionPool\Skills\EditSkillsOfQuestionTable\getComponents(), ilAssLacQuestionProvider\getQuestion(), ilTestPlayerAbstractGUI\getQuestionInstance(), ILIAS\Test\ExportImport\Export\getQuestionQtiXml(), ilBulkEditQuestionsGUI\getQuestions(), ilTestRandomQuestionSetPoolDeriver\getQuestionsForPool(), ilTestSequence\getSequenceSummary(), ILIAS\Test\Questions\Presentation\QuestionsTableActions\handleCommand(), ilPCQuestion\handleCopiedContent(), hasWritableOriginalInQuestionPool(), ilObjTest\insertQuestion(), ilQuestionPageParser\processPagesToParse(), ilAssIncompleteQuestionPurger\purgeQuestionIds(), ilObjTest\removeQuestionWithResults(), ilTestRandomQuestionSetStagingPoolBuilder\removeStagedQuestions(), ilSoapTestAdministration\saveQuestion(), ilSoapTestAdministration\saveQuestionSolution(), ilTestRandomQuestionSetStagingPoolBuilder\stageQuestionsFromSourcePool(), ilTestRandomQuestionSetStagingPoolBuilder\stageQuestionsFromSourcePoolCheap(), and ilAssQuestionSkillAssignmentsGUI\syncOriginalCmd().

Here is the call graph for this function:

Here is the caller graph for this function:

intermediateSolutionExists()

assQuestion::intermediateSolutionExists	(	int	$active_id,
		int	$pass
	)

Definition at line 2674 of file class.assQuestion.php.

                                                                         : bool
    {
        $solutionAvailability = $this->lookupForExistingSolutions($active_id, $pass);
        return (bool) $solutionAvailability['intermediate'];
    }

isAddableAnswerOptionValue()

assQuestion::isAddableAnswerOptionValue	(	int	$qIndex,
		string	$answerOptionValue
	)

Reimplemented in assClozeTest, and assTextSubset.

Definition at line 2750 of file class.assQuestion.php.

                                                                                      : bool
    {
        return false;
    }

isAdditionalContentEditingModePageObject()

assQuestion::isAdditionalContentEditingModePageObject

(

)

Definition at line 2312 of file class.assQuestion.php.

                                                              : bool
    {
        return $this->getAdditionalContentEditingMode() == assQuestion::ADDITIONAL_CONTENT_EDITING_MODE_IPE;
    }

References ADDITIONAL_CONTENT_EDITING_MODE_IPE.

isAnswered()

assQuestion::isAnswered	(	int	$active_id,
		int	$pass
	)

Definition at line 2266 of file class.assQuestion.php.

                                                         : bool
    {
        $numExistingSolutionRecords = assQuestion::getNumExistingSolutionRecords($active_id, $pass, $this->getId());
        return $numExistingSolutionRecords > 0;
    }

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

Here is the call graph for this function:

isComplete()

assQuestion::isComplete ( )

abstract

Reimplemented in assClozeTest, assErrorText, assFileUpload, assFormulaQuestion, assImagemapQuestion, assKprimChoice, assLongMenu, assMatchingQuestion, assMultipleChoice, assNumeric, assOrderingHorizontal, assOrderingQuestion, assSingleChoice, assTextQuestion, and assTextSubset.

isDummySolutionRecord()

assQuestion::isDummySolutionRecord ( array  $solutionRecord )

protected

Definition at line 2569 of file class.assQuestion.php.

                                                                   : bool
    {
        return !strlen($solutionRecord['value1']) && !strlen($solutionRecord['value2']);
    }

isFileAvailable()

static assQuestion::isFileAvailable ( string  $file )

static

Definition at line 988 of file class.assQuestion.php.

                                                        : bool
    {
        if (!file_exists($file)) {
            return false;
        }
 
        if (!is_file($file)) {
            return false;
        }
 
        if (!is_readable($file)) {
            return false;
        }
 
        return true;
    }

isForcePassResultUpdateEnabled()

static assQuestion::isForcePassResultUpdateEnabled ( )

static

Definition at line 224 of file class.assQuestion.php.

                                                           : bool
    {
        return self::$force_pass_results_update_enabled;
    }

References $force_pass_results_update_enabled.

isNonEmptyItemListPostSubmission()

assQuestion::isNonEmptyItemListPostSubmission ( string  $post_submission_field_name )

protected

Definition at line 234 of file class.assQuestion.php.

                                                                                           : bool
    {
        return !empty($this->questionpool_request->strArray($post_submission_field_name));
    }

isPreviewSolutionCorrect()

assQuestion::isPreviewSolutionCorrect

(

ilAssQuestionPreviewSession

$preview_session

)

Definition at line 1828 of file class.assQuestion.php.

                                                                                          : bool
    {
        $reached_points = $this->calculateReachedPointsFromPreviewSession($preview_session);
 
        return !($reached_points < $this->getMaximumPoints());
    }

isValidAdditionalContentEditingMode()

assQuestion::isValidAdditionalContentEditingMode

(

string

$additionalContentEditingMode

)

Definition at line 2317 of file class.assQuestion.php.

                                                                                             : bool
    {
        if (in_array($additionalContentEditingMode, $this->getValidAdditionalContentEditingModes())) {
            return true;
        }
 
        return false;
    }

isWriteable()

assQuestion::isWriteable

(

)

Definition at line 1812 of file class.assQuestion.php.

                                 : bool
    {
        return ilObjQuestionPool::_isWriteable($this->getObjId(), $this->getCurrentUser()->getId());
    }

References ilObjQuestionPool\_isWriteable(), and ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

lmMigrateQuestionTypeGenericContent()

assQuestion::lmMigrateQuestionTypeGenericContent ( ilAssSelfAssessmentMigrator  $migrator )

protected

Definition at line 2177 of file class.assQuestion.php.

                                                                                                 : void
    {
        $this->setQuestion($migrator->migrateToLmContent($this->getQuestion()));
    }

References ilAssSelfAssessmentMigrator\migrateToLmContent().

Here is the call graph for this function:

lmMigrateQuestionTypeSpecificContent()

assQuestion::lmMigrateQuestionTypeSpecificContent ( ilAssSelfAssessmentMigrator  $migrator )

protected

Reimplemented in assClozeTest, assKprimChoice, assLongMenu, assMultipleChoice, and assSingleChoice.

Definition at line 2182 of file class.assQuestion.php.

                                                                                                  : void
    {
        // overwrite if any question type specific content except feedback needs to be migrated
    }

loadFromDb()

assQuestion::loadFromDb

(

int

$question_id

)

Reimplemented in assClozeTest, assFileUpload, assFormulaQuestion, assImagemapQuestion, assMultipleChoice, assNumeric, assSingleChoice, assTextQuestion, and assTextSubset.

Definition at line 1106 of file class.assQuestion.php.

                                                : void
    {
        $result = $this->db->queryF(
            'SELECT external_id FROM qpl_questions WHERE question_id = %s',
            ['integer'],
            [$question_id]
        );
        if ($this->db->numRows($result) === 1) {
            $data = $this->db->fetchAssoc($result);
            $this->external_id = $data['external_id'];
        }
 
        $suggested_solutions = $this->loadSuggestedSolutions();
        $this->suggested_solutions = [];
        if ($suggested_solutions) {
            foreach ($suggested_solutions as $solution) {
                $this->suggested_solutions[$solution->getSubquestionIndex()] = $solution;
            }
        }
    }

References $data.

loadSuggestedSolutions()

assQuestion::loadSuggestedSolutions ( )

protected

Definition at line 2862 of file class.assQuestion.php.

                                               : array
    {
        return $this->getSuggestedSolutionsRepo()->selectFor($this->getId());
    }

References ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

lookupForExistingSolutions()

assQuestion::lookupForExistingSolutions	(	int	$activeId,
		int	$pass
	)

Lookup if an authorized or intermediate solution exists.

Returns

array ['authorized' => bool, 'intermediate' => bool]

Reimplemented in assFormulaQuestion, and assLongMenu.

Definition at line 2714 of file class.assQuestion.php.

                                                                        : array
    {
        $return = [
            'authorized' => false,
            'intermediate' => false
        ];
 
        $query = "
                        SELECT authorized, COUNT(*) cnt
                        FROM tst_solutions
                        WHERE active_fi = %s
                        AND question_fi = %s
                        AND pass = %s
                ";
 
        if ($this->getStep() !== null) {
            $query .= " AND step = " . $this->db->quote((int) $this->getStep(), 'integer') . " ";
        }
 
        $query .= "
                        GROUP BY authorized
                ";
 
        $result = $this->db->queryF($query, ['integer', 'integer', 'integer'], [$activeId, $this->getId(), $pass]);
 
        while ($row = $this->db->fetchAssoc($result)) {
            if ($row['authorized']) {
                $return['authorized'] = $row['cnt'] > 0;
            } else {
                $return['intermediate'] = $row['cnt'] > 0;
            }
        }
        return $return;
    }

References ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

lookupMaxStep()

assQuestion::lookupMaxStep ( int  $active_id, int  $pass  )

protected

Definition at line 2696 of file class.assQuestion.php.

                                                               : int
    {
        $result = $this->db->queryF(
            "SELECT MAX(step) max_step FROM tst_solutions WHERE active_fi = %s AND pass = %s AND question_fi = %s",
            ["integer", "integer", "integer"],
            [$active_id, $pass, $this->getId()]
        );
 
        $row = $this->db->fetchAssoc($result);
 
        return (int) $row['max_step'];
    }

References ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

lookupParentObjId()

static assQuestion::lookupParentObjId ( int  $question_id )

static

Definition at line 2209 of file class.assQuestion.php.

                                                              : ?int
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $query = "SELECT obj_fi FROM qpl_questions WHERE question_id = %s";
 
        $res = $ilDB->queryF($query, ['integer'], [$question_id]);
        $row = $ilDB->fetchAssoc($res);
 
        return $row['obj_fi'] ?? null;
    }

References $DIC, $ilDB, and $res.

Referenced by ILIAS\Test\Questions\Presentation\QuestionsTableActions\checkQuestionParametersForCopyToPool(), ilAssQuestionSkillAssignmentsGUI\isSyncOriginalPossibleAndAllowed(), and ilAssQuestionSkillAssignmentsGUI\syncOriginalCmd().

Here is the caller graph for this function:

migrateContentForLearningModule()

assQuestion::migrateContentForLearningModule

(

ilAssSelfAssessmentMigrator

$migrator

)

Definition at line 2168 of file class.assQuestion.php.

                                                                                          : void
    {
        $this->lmMigrateQuestionTypeGenericContent($migrator);
        $this->lmMigrateQuestionTypeSpecificContent($migrator);
        $this->saveToDb();
 
        $this->feedbackOBJ->migrateContentForLearningModule($migrator, $this->getId());
    }

References ILIAS\Survey\Mode\getId().

Referenced by ilAssSelfAssessmentQuestionFormatter\prepareQuestionForLearningModule().

Here is the call graph for this function:

Here is the caller graph for this function:

onCopy()

assQuestion::onCopy ( int  $sourceParentId, int  $sourceQuestionId, int  $targetParentId, int  $targetQuestionId  )

protected

Definition at line 1443 of file class.assQuestion.php.

                                                                                                                     : void
    {
        $this->copySuggestedSolutions($targetQuestionId);
        $this->duplicateSuggestedSolutionFiles($sourceParentId, $sourceQuestionId);
        $this->feedbackOBJ->duplicateFeedback($sourceQuestionId, $targetQuestionId);
        $this->duplicateSkillAssignments($sourceParentId, $sourceQuestionId, $targetParentId, $targetQuestionId);
        $this->duplicateComments($sourceParentId, $sourceQuestionId, $targetParentId, $targetQuestionId);
    }

onDuplicate()

assQuestion::onDuplicate ( int  $original_parent_id, int  $original_question_id, int  $duplicate_parent_id, int  $duplicate_question_id  )

protected

Definition at line 1421 of file class.assQuestion.php.

     : void {
        $this->copySuggestedSolutions($duplicate_question_id);
        $this->cloneSuggestedSolutionFiles($original_parent_id, $original_question_id);
        $this->feedbackOBJ->duplicateFeedback($original_question_id, $duplicate_question_id);
        $this->duplicateSkillAssignments($original_parent_id, $original_question_id, $duplicate_parent_id, $duplicate_question_id);
        $this->duplicateComments($original_parent_id, $original_question_id, $duplicate_parent_id, $duplicate_question_id);
    }

persistPreviewState()

assQuestion::persistPreviewState ( ilAssQuestionPreviewSession  $preview_session )

final

persists the preview state for current user and question

Definition at line 656 of file class.assQuestion.php.

                                                                                           : bool
    {
        $this->savePreviewData($preview_session);
        return $this->validateSolutionSubmit();
    }

persistWorkingState()

assQuestion::persistWorkingState ( int  $active_id,   $pass, bool  $authorized = true  )

final

persists the working state for current testactive and testpass

Returns

bool if saving happened

Definition at line 626 of file class.assQuestion.php.

                                                                                             : bool
    {
        if (!$this instanceof QuestionPartiallySaveable && !$this->validateSolutionSubmit()) {
            return false;
        }
 
        $saveStatus = false;
 
        $this->getProcessLocker()->executePersistWorkingStateLockOperation(function () use ($active_id, $pass, $authorized, &$saveStatus) {
            if ($pass === null) {
                $pass = ilObjTest::_getPass($active_id);
            }
 
            $saveStatus = $this->saveWorkingData($active_id, $pass, $authorized);
 
            if ($authorized) {
                // fau: testNav - remove an intermediate solution if the authorized solution is saved
                //              the intermediate solution would set the displayed question status as "editing ..."
                $this->removeIntermediateSolution($active_id, $pass);
                // fau.
                $this->calculateResultsFromSolution($active_id, $pass);
            }
        });
 
        return $saveStatus;
    }

References ilObjTest\_getPass().

Referenced by ilTestPlayerAbstractGUI\save().

Here is the call graph for this function:

Here is the caller graph for this function:

purifyAndPrepareTextAreaOutput()

assQuestion::purifyAndPrepareTextAreaOutput ( string  $content )

protected

Definition at line 1955 of file class.assQuestion.php.

                                                                      : string
    {
        $purified_content = $this->getHtmlQuestionContentPurifier()->purify($content);
        if ($this->isAdditionalContentEditingModePageObject()
            || !(new ilSetting('advanced_editing'))->get('advanced_editing_javascript_editor') === 'tinymce') {
            $purified_content = nl2br($purified_content);
        }
        return ilLegacyFormElementsUtil::prepareTextareaOutput(
            $purified_content,
            true,
            true
        );
    }

References ILIAS\Questions\AnswerFormTypes\Cloze\Migration\getHtmlQuestionContentPurifier(), and ilLegacyFormElementsUtil\prepareTextareaOutput().

Here is the call graph for this function:

removeAllExistingSolutions()

assQuestion::removeAllExistingSolutions

(

)

Definition at line 2759 of file class.assQuestion.php.

                                                : void
    {
        $query = "DELETE FROM tst_solutions WHERE question_fi = %s";
        $this->db->manipulateF($query, ['integer'], [$this->getId()]);
    }

References ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

removeAllImageFiles()

assQuestion::removeAllImageFiles ( string  $image_target_path )

protected

Definition at line 1380 of file class.assQuestion.php.

                                                                     : void
    {
        $target = opendir($image_target_path);
        while ($target_file = readdir($target)) {
            if ($target_file === '.' || $target_file === '..') {
                continue;
            }
            copy(
                $image_target_path . DIRECTORY_SEPARATOR . $target_file,
                $image_target_path . DIRECTORY_SEPARATOR . $target_file
            );
        }
    }

References ILIAS\Scripts\PHPStan\$target, and ILIAS\UI\examples\Symbol\Glyph\Copy\copy().

Here is the call graph for this function:

removeCurrentSolution()

assQuestion::removeCurrentSolution	(	int	$active_id,
		int	$pass,
		bool	$authorized = true
	)

Returns

int Affected rows

Definition at line 2446 of file class.assQuestion.php.

                                                                                             : int
    {
        if ($this->getStep() !== null) {
            $query = '
                                DELETE FROM tst_solutions
                                WHERE active_fi = %s
                                AND question_fi = %s
                                AND pass = %s
                                AND step = %s
                                AND authorized = %s
                        ';
 
            return $this->db->manipulateF(
                $query,
                ['integer', 'integer', 'integer', 'integer', 'integer'],
                [$active_id, $this->getId(), $pass, $this->getStep(), (int) $authorized]
            );
        }
 
        $query = "
            DELETE FROM tst_solutions
            WHERE active_fi = %s
            AND question_fi = %s
            AND pass = %s
            AND authorized = %s
        ";
 
        return $this->db->manipulateF(
            $query,
            ['integer', 'integer', 'integer', 'integer'],
            [$active_id, $this->getId(), $pass, (int) $authorized]
        );
    }

References ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

removeExistingSolutions()

assQuestion::removeExistingSolutions	(	int	$activeId,
		int	$pass
	)

Reimplemented in assFormulaQuestion.

Definition at line 2765 of file class.assQuestion.php.

                                                                     : int
    {
        $query = "
                        DELETE FROM tst_solutions
                        WHERE active_fi = %s
                        AND question_fi = %s
                        AND pass = %s
                ";
 
        if ($this->getStep() !== null) {
            $query .= " AND step = " . $this->db->quote((int) $this->getStep(), 'integer') . " ";
        }
 
        return $this->db->manipulateF(
            $query,
            ['integer', 'integer', 'integer'],
            [$activeId, $this->getId(), $pass]
        );
    }

References ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

removeIntermediateSolution()

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

Reimplemented in assFileUpload.

Definition at line 2436 of file class.assQuestion.php.

                                                                         : void
    {
        $this->getProcessLocker()->executeUserSolutionUpdateLockOperation(function () use ($active_id, $pass) {
            $this->removeCurrentSolution($active_id, $pass, false);
        });
    }

removeResultRecord()

assQuestion::removeResultRecord	(	int	$activeId,
		int	$pass
	)

Definition at line 2792 of file class.assQuestion.php.

                                                                : int
    {
        $query = "
                        DELETE FROM tst_test_result
                        WHERE active_fi = %s
                        AND question_fi = %s
                        AND pass = %s
                ";
 
        if ($this->getStep() !== null) {
            $query .= " AND step = " . $this->db->quote((int) $this->getStep(), 'integer') . " ";
        }
 
        return $this->db->manipulateF(
            $query,
            ['integer', 'integer', 'integer'],
            [$activeId, $this->getId(), $pass]
        );
    }

References ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

removeSolutionRecordById()

assQuestion::removeSolutionRecordById ( int  $solutionId )

protected

Reimplemented in assFileUpload.

Definition at line 2408 of file class.assQuestion.php.

                                                                : int
    {
        return $this->db->manipulateF(
            "DELETE FROM tst_solutions WHERE solution_id = %s",
            ['integer'],
            [$solutionId]
        );
    }

resetOriginalId()

static assQuestion::resetOriginalId ( int  $questionId )

static

Definition at line 1407 of file class.assQuestion.php.

                                                           : void
    {
        global $DIC;
        $ilDB = $DIC->database();
 
        $query = "UPDATE qpl_questions SET tstamp = %s, original_id = NULL WHERE question_id = %s";
 
        $ilDB->manipulateF(
            $query,
            ['integer', 'text'],
            [time(), $questionId]
        );
    }

References $DIC, and $ilDB.

Referenced by ilTestRandomQuestionSetPoolDeriver\updateTestQuestionStage().

Here is the caller graph for this function:

resetUsersAnswer()

assQuestion::resetUsersAnswer	(	int	$activeId,
		int	$pass
	)

Definition at line 2785 of file class.assQuestion.php.

                                                              : void
    {
        $this->removeExistingSolutions($activeId, $pass);
        $this->removeResultRecord($activeId, $pass);
        $this->test_result_repository->updateTestAttemptResult($activeId, $pass, $this->getProcessLocker(), $this->getTestId());
    }

resolveInternalLink()

assQuestion::resolveInternalLink

(

string

$internal_link

)

Definition at line 1607 of file class.assQuestion.php.

                                                              : string
    {
        if (preg_match("/il_(\d+)_(\w+)_(\d+)/", $internal_link, $matches) === false) {
            return $internal_link;
        }
        switch ($matches[2]) {
            case "lm":
                $resolved_link = ilLMObject::_getIdForImportId($internal_link);
                break;
            case "pg":
                $resolved_link = ilInternalLink::_getIdForImportId("PageObject", $internal_link);
                break;
            case "st":
                $resolved_link = ilInternalLink::_getIdForImportId("StructureObject", $internal_link);
                break;
            case "git":
                $resolved_link = ilInternalLink::_getIdForImportId("GlossaryItem", $internal_link);
                break;
            case "mob":
                $resolved_link = ilInternalLink::_getIdForImportId("MediaObject", $internal_link);
                break;
        }
        if ($resolved_link === null) {
            return "il__{$matches[2]}_{$matches[3]}";
        }
        return $internal_link;
    }

References ilLMObject\_getIdForImportId(), and ilInternalLink\_getIdForImportId().

Here is the call graph for this function:

resolveSuggestedSolutionLinks()

assQuestion::resolveSuggestedSolutionLinks

(

)

Definition at line 1638 of file class.assQuestion.php.

                                                   : void
    {
        $resolvedlinks = 0;
        $result_pre = $this->db->queryF(
            "SELECT internal_link, suggested_solution_id FROM qpl_sol_sug WHERE question_fi = %s",
            ['integer'],
            [$this->getId()]
        );
        if ($this->db->numRows($result_pre) < 1) {
            return;
        }
 
        while ($row = $this->db->fetchAssoc($result_pre)) {
            $internal_link = $row["internal_link"];
            $resolved_link = $this->resolveInternalLink($internal_link);
            if ($internal_link === $resolved_link) {
                continue;
            }
            // internal link was resolved successfully
            $this->db->manipulateF(
                "UPDATE qpl_sol_sug SET internal_link = %s WHERE suggested_solution_id = %s",
                ['text','integer'],
                [$resolved_link, $row["suggested_solution_id"]]
            );
            $resolvedlinks++;
        }
        if ($resolvedlinks === 0) {
            return;
        }
 
        ilInternalLink::_deleteAllLinksOfSource("qst", $this->getId());
 
        $result_post = $this->db->queryF(
            "SELECT internal_link FROM qpl_sol_sug WHERE question_fi = %s",
            ['integer'],
            [$this->getId()]
        );
        if ($this->db->numRows($result_post) < 1) {
            return;
        }
 
        while ($row = $this->db->fetchAssoc($result_post)) {
            if (preg_match("/il_(\d*?)_(\w+)_(\d+)/", $row["internal_link"], $matches)) {
                ilInternalLink::_saveLink("qst", $this->getId(), $matches[2], $matches[3], $matches[1]);
            }
        }
    }

References ilInternalLink\_deleteAllLinksOfSource(), ilInternalLink\_saveLink(), and ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

saveCurrentSolution()

assQuestion::saveCurrentSolution	(	int	$active_id,
		int	$pass,
			$value1,
			$value2,
		bool	$authorized = true,
			$tstamp = 0
	)

Reimplemented in assFormulaQuestion.

Definition at line 2481 of file class.assQuestion.php.

                                                                                                                          : int
    {
        $next_id = $this->db->nextId("tst_solutions");
 
        $fieldData = [
            "solution_id" => ["integer", $next_id],
            "active_fi" => ["integer", $active_id],
            "question_fi" => ["integer", $this->getId()],
            "value1" => ["clob", $value1],
            "value2" => ["clob", $value2],
            "pass" => ["integer", $pass],
            "tstamp" => ["integer", ((int) $tstamp > 0) ? (int) $tstamp : time()],
            'authorized' => ['integer', (int) $authorized]
        ];
 
        if ($this->getStep() !== null) {
            $fieldData['step'] = ["integer", $this->getStep()];
        }
 
        return $this->db->insert("tst_solutions", $fieldData);
    }

References ILIAS\Survey\Mode\getId(), and ILIAS\Repository\int().

Here is the call graph for this function:

saveOriginalId()

static assQuestion::saveOriginalId ( int  $questionId, int  $originalId  )

static

Definition at line 1394 of file class.assQuestion.php.

                                                                           : void
    {
        global $DIC;
        $ilDB = $DIC->database();
        $query = "UPDATE qpl_questions SET tstamp = %s, original_id = %s WHERE question_id = %s";
 
        $ilDB->manipulateF(
            $query,
            ['integer','integer', 'text'],
            [time(), $originalId, $questionId]
        );
    }

References $DIC, and $ilDB.

Referenced by ilObjTestGUI\copyAndLinkQuestionsToPoolObject(), ilObjTestGUI\executeAfterQuestionCreationTasks(), and ilTestRandomQuestionSetPoolDeriver\updateTestQuestionStage().

Here is the caller graph for this function:

savePreviewData()

assQuestion::savePreviewData ( ilAssQuestionPreviewSession  $preview_session )

protected

Reimplemented in assLongMenu, assErrorText, assFileUpload, assFormulaQuestion, assImagemapQuestion, assMatchingQuestion, assNumeric, assOrderingQuestion, and assSingleChoice.

Definition at line 667 of file class.assQuestion.php.

                                                                                    : void
    {
        $preview_session->setParticipantsSolution($this->getSolutionSubmit());
    }

References ilAssQuestionPreviewSession\setParticipantsSolution().

Here is the call graph for this function:

saveQuestionDataToDb()

assQuestion::saveQuestionDataToDb

(

?int

$original_id = null

)

Definition at line 1184 of file class.assQuestion.php.

                                                                  : void
    {
        if ($this->getId() === -1) {
            $next_id = $this->db->nextId('qpl_questions');
            $this->db->insert("qpl_questions", [
                "question_id" => ["integer", $next_id],
                "question_type_fi" => ["integer", $this->getQuestionTypeID()],
                "obj_fi" => ["integer", $this->getObjId()],
                "title" => ["text", mb_substr($this->getTitle(), 0, 124)],
                "description" => ["text", mb_substr($this->getComment(), 0, 1000)],
                "author" => ["text", mb_substr($this->getAuthor(), 0, 512)],
                "owner" => ["integer", $this->getOwner()],
                "question_text" => ["clob", ilRTE::_replaceMediaObjectImageSrc($this->getQuestion(), 0)],
                "points" => ["float", $this->getMaximumPoints()],
                "nr_of_tries" => ["integer", $this->getNrOfTries()],
                "created" => ["integer", time()],
                "original_id" => ["integer", $original_id],
                "tstamp" => ["integer", time()],
                "external_id" => ["text", $this->getExternalId()],
                'add_cont_edit_mode' => ['text', $this->getAdditionalContentEditingMode()]
            ]);
            $this->setId($next_id);
            // create page object of question
            $this->createPageObject();
            return;
        }
 
        // Vorhandenen Datensatz aktualisieren
        $this->db->update("qpl_questions", [
            "obj_fi" => ["integer", $this->getObjId()],
            "title" => ["text", mb_substr($this->getTitle(), 0, 124)],
            "description" => ["text", mb_substr($this->getComment(), 0, 1000)],
            "author" => ["text", mb_substr($this->getAuthor(), 0, 512)],
            "question_text" => ["clob", ilRTE::_replaceMediaObjectImageSrc($this->getQuestion(), 0)],
            "points" => ["float", $this->getMaximumPoints()],
            "nr_of_tries" => ["integer", $this->getNrOfTries()],
            "tstamp" => ["integer", time()],
            'complete' => ['integer', $this->isComplete()],
            "external_id" => ["text", $this->getExternalId()]
        ], [
            "question_id" => ["integer", $this->getId()]
        ]);
    }

References ilRTE\_replaceMediaObjectImageSrc(), ILIAS\Survey\Mode\getId(), and ILIAS\GlobalScreen\Scope\Footer\Factory\getTitle().

Referenced by assErrorText\saveToDb(), assFileUpload\saveToDb(), assImagemapQuestion\saveToDb(), assKprimChoice\saveToDb(), assLongMenu\saveToDb(), assMatchingQuestion\saveToDb(), assMultipleChoice\saveToDb(), assNumeric\saveToDb(), assOrderingHorizontal\saveToDb(), assOrderingQuestion\saveToDb(), assSingleChoice\saveToDb(), assTextQuestion\saveToDb(), and assTextSubset\saveToDb().

Here is the call graph for this function:

Here is the caller graph for this function:

saveToDb()

assQuestion::saveToDb

(

?int

$original_id = null

)

Reimplemented in assClozeTest, assErrorText, assFileUpload, assFormulaQuestion, assImagemapQuestion, assKprimChoice, assLongMenu, assMatchingQuestion, assMultipleChoice, assNumeric, assOrderingHorizontal, assOrderingQuestion, assSingleChoice, assTextQuestion, and assTextSubset.

Definition at line 1354 of file class.assQuestion.php.

                                                      : void
    {
        // remove unused media objects from ILIAS
        $this->cleanupMediaObjectUsage();
 
        $complete = "0";
        if ($this->isComplete()) {
            $complete = "1";
        }
 
        $this->db->update(
            'qpl_questions',
            [
                'tstamp' => ['integer', time()],
                'owner' => ['integer', $this->getOwner()],
                'complete' => ['integer', $complete],
                'lifecycle' => ['text', $this->getLifecycle()->getIdentifier()],
            ],
            [
                'question_id' => ['integer', $this->getId()]
            ]
        );
 
        ilObjQuestionPool::_updateQuestionCount($this->getObjId());
    }

References ilObjQuestionPool\_updateQuestionCount(), and ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

saveWorkingData()

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

abstract

Reimplemented in assClozeTest, assErrorText, assFileUpload, assFormulaQuestion, assImagemapQuestion, assKprimChoice, assLongMenu, assMatchingQuestion, assMultipleChoice, assNumeric, assOrderingHorizontal, assOrderingQuestion, assSingleChoice, assTextQuestion, and assTextSubset.

setAdditionalContentEditingMode()

assQuestion::setAdditionalContentEditingMode

(

?string

$additionalContentEditingMode

)

Definition at line 2303 of file class.assQuestion.php.

                                                                                          : void
    {
        if (!in_array($additionalContentEditingMode, $this->getValidAdditionalContentEditingModes())) {
            throw new ilTestQuestionPoolException('invalid additional content editing mode given: ' . $additionalContentEditingMode);
        }
 
        $this->additionalContentEditingMode = $additionalContentEditingMode;
    }

Referenced by assErrorText\loadFromDb(), assLongMenu\loadFromDb(), assMatchingQuestion\loadFromDb(), assOrderingHorizontal\loadFromDb(), assOrderingQuestion\loadFromDb(), assKprimChoice\loadFromDb(), assFileUpload\loadFromDb(), assMultipleChoice\loadFromDb(), assNumeric\loadFromDb(), assSingleChoice\loadFromDb(), assTextQuestion\loadFromDb(), and assTextSubset\loadFromDb().

Here is the caller graph for this function:

setAuthor()

assQuestion::setAuthor

(

string

$author = ""

)

Definition at line 332 of file class.assQuestion.php.

                                                  : void
    {
        if ($author === '') {
            $author = $this->current_user->getFullname();
        }
        $this->author = $author;
    }

Referenced by assErrorText\loadFromDb(), assLongMenu\loadFromDb(), assMatchingQuestion\loadFromDb(), assOrderingHorizontal\loadFromDb(), assOrderingQuestion\loadFromDb(), assKprimChoice\loadFromDb(), assFileUpload\loadFromDb(), assMultipleChoice\loadFromDb(), assNumeric\loadFromDb(), assSingleChoice\loadFromDb(), assTextQuestion\loadFromDb(), and assTextSubset\loadFromDb().

Here is the caller graph for this function:

setComment()

assQuestion::setComment

(

string

$comment = ""

)

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

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

References $comment, and ILIAS\UI\examples\Symbol\Glyph\Comment\comment().

Referenced by assErrorText\loadFromDb(), assLongMenu\loadFromDb(), assMatchingQuestion\loadFromDb(), assOrderingHorizontal\loadFromDb(), assOrderingQuestion\loadFromDb(), assKprimChoice\loadFromDb(), assFileUpload\loadFromDb(), assMultipleChoice\loadFromDb(), assNumeric\loadFromDb(), assSingleChoice\loadFromDb(), assTextQuestion\loadFromDb(), and assTextSubset\loadFromDb().

Here is the call graph for this function:

Here is the caller graph for this function:

setDefaultNrOfTries()

assQuestion::setDefaultNrOfTries

(

int

$defaultnroftries

)

Definition at line 2197 of file class.assQuestion.php.

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

setExportImagePath()

assQuestion::setExportImagePath

(

string

$path

)

Definition at line 2124 of file class.assQuestion.php.

                                                    : void
    {
        $this->export_image_path = $path;
    }

setExternalId()

assQuestion::setExternalId

(

?string

$external_id

)

Definition at line 444 of file class.assQuestion.php.

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

setForcePassResultUpdateEnabled()

static assQuestion::setForcePassResultUpdateEnabled ( bool  $force_pass_results_update_enabled )

static

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

                                                                                                   : void
    {
        self::$force_pass_results_update_enabled = $force_pass_results_update_enabled;
    }

References $force_pass_results_update_enabled.

setId()

assQuestion::setId

(

int

$id = -1

)

Reimplemented in assFormulaQuestion.

Definition at line 312 of file class.assQuestion.php.

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

References $id.

Referenced by assErrorText\loadFromDb(), assLongMenu\loadFromDb(), assMatchingQuestion\loadFromDb(), assOrderingHorizontal\loadFromDb(), assOrderingQuestion\loadFromDb(), assKprimChoice\loadFromDb(), assFileUpload\loadFromDb(), assMultipleChoice\loadFromDb(), assNumeric\loadFromDb(), assSingleChoice\loadFromDb(), assTextQuestion\loadFromDb(), and assTextSubset\loadFromDb().

Here is the caller graph for this function:

setLastChange()

assQuestion::setLastChange

(

int

$lastChange

)

Definition at line 2362 of file class.assQuestion.php.

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

Referenced by assKprimChoice\loadFromDb().

Here is the caller graph for this function:

setLifecycle()

assQuestion::setLifecycle

(

ilAssQuestionLifecycle

$lifecycle

)

Definition at line 439 of file class.assQuestion.php.

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

References $lifecycle.

Referenced by assErrorText\loadFromDb(), assLongMenu\loadFromDb(), assMatchingQuestion\loadFromDb(), assOrderingHorizontal\loadFromDb(), assOrderingQuestion\loadFromDb(), assKprimChoice\loadFromDb(), assFileUpload\loadFromDb(), assMultipleChoice\loadFromDb(), assNumeric\loadFromDb(), assSingleChoice\loadFromDb(), assTextQuestion\loadFromDb(), and assTextSubset\loadFromDb().

Here is the caller graph for this function:

setNrOfTries()

assQuestion::setNrOfTries

(

int

$a_nr_of_tries

)

Definition at line 2119 of file class.assQuestion.php.

                                                    : void
    {
        $this->nr_of_tries = $a_nr_of_tries;
    }

Referenced by assErrorText\loadFromDb(), assLongMenu\loadFromDb(), assMatchingQuestion\loadFromDb(), assOrderingHorizontal\loadFromDb(), assOrderingQuestion\loadFromDb(), assKprimChoice\loadFromDb(), assFileUpload\loadFromDb(), assMultipleChoice\loadFromDb(), assNumeric\loadFromDb(), assSingleChoice\loadFromDb(), assTextQuestion\loadFromDb(), and assTextSubset\loadFromDb().

Here is the caller graph for this function:

setObjId()

assQuestion::setObjId

(

int

$obj_id = 0

)

Definition at line 429 of file class.assQuestion.php.

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

Referenced by assErrorText\loadFromDb(), assLongMenu\loadFromDb(), assMatchingQuestion\loadFromDb(), assOrderingHorizontal\loadFromDb(), assOrderingQuestion\loadFromDb(), assKprimChoice\loadFromDb(), assFileUpload\loadFromDb(), assMultipleChoice\loadFromDb(), assNumeric\loadFromDb(), assSingleChoice\loadFromDb(), assTextQuestion\loadFromDb(), and assTextSubset\loadFromDb().

Here is the caller graph for this function:

setOriginalId()

assQuestion::setOriginalId

(

?int

$original_id

)

Definition at line 1043 of file class.assQuestion.php.

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

Referenced by assErrorText\loadFromDb(), assLongMenu\loadFromDb(), assMatchingQuestion\loadFromDb(), assOrderingHorizontal\loadFromDb(), assOrderingQuestion\loadFromDb(), assKprimChoice\loadFromDb(), assFileUpload\loadFromDb(), assMultipleChoice\loadFromDb(), assNumeric\loadFromDb(), assSingleChoice\loadFromDb(), assTextQuestion\loadFromDb(), and assTextSubset\loadFromDb().

Here is the caller graph for this function:

setOwner()

assQuestion::setOwner

(

int

$owner = -1

)

Definition at line 340 of file class.assQuestion.php.

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

References ILIAS\UI\examples\Symbol\Glyph\Owner\owner().

Referenced by assErrorText\loadFromDb(), assLongMenu\loadFromDb(), assMatchingQuestion\loadFromDb(), assOrderingHorizontal\loadFromDb(), assOrderingQuestion\loadFromDb(), assKprimChoice\loadFromDb(), assFileUpload\loadFromDb(), assMultipleChoice\loadFromDb(), assNumeric\loadFromDb(), assSingleChoice\loadFromDb(), assTextQuestion\loadFromDb(), and assTextSubset\loadFromDb().

Here is the call graph for this function:

Here is the caller graph for this function:

setPoints()

assQuestion::setPoints

(

float

$points

)

Definition at line 1778 of file class.assQuestion.php.

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

Referenced by assErrorText\loadFromDb(), assLongMenu\loadFromDb(), assMatchingQuestion\loadFromDb(), assOrderingHorizontal\loadFromDb(), assOrderingQuestion\loadFromDb(), assKprimChoice\loadFromDb(), assFileUpload\loadFromDb(), assMultipleChoice\loadFromDb(), assNumeric\loadFromDb(), assSingleChoice\loadFromDb(), assTextQuestion\loadFromDb(), assTextSubset\loadFromDb(), and assLongMenu\saveAnswerSpecificDataToDb().

Here is the caller graph for this function:

setPreventRteUsage()

assQuestion::setPreventRteUsage

(

bool

$prevent_rte_usage

)

Definition at line 2158 of file class.assQuestion.php.

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

setProcessLocker()

assQuestion::setProcessLocker

(

ilAssQuestionProcessLocker

$processLocker

)

Definition at line 254 of file class.assQuestion.php.

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

References $processLocker.

setQuestion()

assQuestion::setQuestion

(

string

$question = ""

)

Definition at line 1969 of file class.assQuestion.php.

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

Referenced by assClozeTest\__construct(), assErrorText\loadFromDb(), assLongMenu\loadFromDb(), assMatchingQuestion\loadFromDb(), assOrderingHorizontal\loadFromDb(), assOrderingQuestion\loadFromDb(), assKprimChoice\loadFromDb(), assFileUpload\loadFromDb(), assMultipleChoice\loadFromDb(), assNumeric\loadFromDb(), assSingleChoice\loadFromDb(), assTextQuestion\loadFromDb(), and assTextSubset\loadFromDb().

Here is the caller graph for this function:

setSelfAssessmentEditingMode()

assQuestion::setSelfAssessmentEditingMode

(

bool

$selfassessmenteditingmode

)

Definition at line 2187 of file class.assQuestion.php.

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

setShuffle()

assQuestion::setShuffle

(

?bool

$shuffle = true

)

Definition at line 327 of file class.assQuestion.php.

                                                     : void
    {
        $this->shuffle = $shuffle ?? false;
    }

Referenced by ilAssQuestionSkillAssignmentsGUI\buildQuestionPage(), assMultipleChoice\loadFromDb(), assSingleChoice\loadFromDb(), and assTextQuestion\loadFromDb().

Here is the caller graph for this function:

setShuffler()

assQuestion::setShuffler

(

Transformation

$shuffler

)

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

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

References $shuffler.

setStep()

assQuestion::setStep

(

$step

)

Parameters

int | null

$step

Definition at line 2643 of file class.assQuestion.php.

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

setTestId()

assQuestion::setTestId

(

int

$id = -1

)

Definition at line 317 of file class.assQuestion.php.

                                           : void
    {
        $this->test_id = $id;
    }

References $id.

setThumbSize()

assQuestion::setThumbSize

(

int

$a_size

)

Reimplemented in assKprimChoice.

Definition at line 390 of file class.assQuestion.php.

                                             : void
    {
        if ($a_size >= self::MINIMUM_THUMB_SIZE) {
            $this->thumb_size = $a_size;
        } else {
            throw new ilException("Thumb size must be at least " . self::MINIMUM_THUMB_SIZE . "px");
        }
    }

Referenced by assOrderingQuestion\loadFromDb(), assMultipleChoice\loadFromDb(), and assSingleChoice\loadFromDb().

Here is the caller graph for this function:

setTitle()

assQuestion::setTitle

(

string

$title = ""

)

Definition at line 307 of file class.assQuestion.php.

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

Referenced by assErrorText\loadFromDb(), assLongMenu\loadFromDb(), assMatchingQuestion\loadFromDb(), assOrderingHorizontal\loadFromDb(), assOrderingQuestion\loadFromDb(), assKprimChoice\loadFromDb(), assFileUpload\loadFromDb(), assMultipleChoice\loadFromDb(), assNumeric\loadFromDb(), assSingleChoice\loadFromDb(), assTextQuestion\loadFromDb(), and assTextSubset\loadFromDb().

Here is the caller graph for this function:

solutionValuesToLog()

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

abstractprotected

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 in assClozeTest, assErrorText, assFileUpload, assFormulaQuestion, assImagemapQuestion, assKprimChoice, assLongMenu, assMatchingQuestion, assMultipleChoice, assNumeric, assOrderingHorizontal, assOrderingQuestion, assSingleChoice, assTextQuestion, and assTextSubset.

solutionValuesToText()

assQuestion::solutionValuesToText ( array  $solution_values )

abstractprotected

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 in assClozeTest, assErrorText, assFileUpload, assFormulaQuestion, assImagemapQuestion, assKprimChoice, assLongMenu, assMatchingQuestion, assMultipleChoice, assNumeric, assOrderingHorizontal, assOrderingQuestion, assSingleChoice, assTextQuestion, and assTextSubset.

syncSkillAssignments()

assQuestion::syncSkillAssignments	(	int	$srcParentId,
		int	$srcQuestionId,
		int	$trgParentId,
		int	$trgQuestionId
	)

Definition at line 2243 of file class.assQuestion.php.

                                                                                                                    : void
    {
        $assignmentList = new ilAssQuestionSkillAssignmentList($this->db);
        $assignmentList->setParentObjId($trgParentId);
        $assignmentList->setQuestionIdFilter($trgQuestionId);
        $assignmentList->loadFromDb();
 
        foreach ($assignmentList->getAssignmentsByQuestionId($trgQuestionId) as $assignment) {
            $assignment->deleteFromDb();
 
            // remove skill usage
            if (!$assignment->isSkillUsed()) {
                $this->skillUsageService->removeUsage(
                    $assignment->getParentObjId(),
                    $assignment->getSkillBaseId(),
                    $assignment->getSkillTrefId()
                );
            }
        }
 
        $this->duplicateSkillAssignments($srcParentId, $srcQuestionId, $trgParentId, $trgQuestionId);
    }

Referenced by ilAssQuestionSkillAssignmentsGUI\syncOriginalCmd().

Here is the caller graph for this function:

syncWithOriginal()

assQuestion::syncWithOriginal

(

)

Definition at line 1717 of file class.assQuestion.php.

                                      : void
    {
        if ($this->getOriginalId() === null) {
            return;
        }
 
        $original_parent_id = self::lookupParentObjId($this->getOriginalId());
 
        if ($original_parent_id === null) {
            return;
        }
 
        $this->cloneSuggestedSolutions($this->getId(), $this->getOriginalId());
        $original = clone $this;
        // Now we become the original
        $original->setId($this->getOriginalId());
        $original->setOriginalId(null);
        $original->setObjId($original_parent_id);
 
        $original->saveToDb();
 
        $original->deletePageOfQuestion($this->getOriginalId());
        $original->createPageObject();
        $original->clonePageOfQuestion($this->getId());
        $original = $this->cloneQuestionTypeSpecificProperties($original);
        $this->cloneXHTMLMediaObjectsOfQuestion($original->getId());
        $this->afterSyncWithOriginal($this->getOriginalId(), $this->getId(), $this->getObjId(), $original_parent_id);
        $this->afterSyncWithOriginal($this->getOriginalId(), $this->getId(), $original_parent_id, $this->getObjId());
    }

References ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

toJSON()

assQuestion::toJSON

(

)

Reimplemented in assClozeTest, assErrorText, assImagemapQuestion, assKprimChoice, assLongMenu, assMatchingQuestion, assMultipleChoice, assOrderingHorizontal, assOrderingQuestion, assSingleChoice, assTextQuestion, and assTextSubset.

Definition at line 2668 of file class.assQuestion.php.

                            : string
    {
        return json_encode([]);
    }

toLog()

assQuestion::toLog ( AdditionalInformationGenerator  $additional_info )

abstract

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.

Implements ILIAS\TestQuestionPool\Questions\Question.

Reimplemented in assClozeTest, assErrorText, assFileUpload, assFormulaQuestion, assImagemapQuestion, assKprimChoice, assLongMenu, assMatchingQuestion, assMultipleChoice, assNumeric, assOrderingHorizontal, assOrderingQuestion, assSingleChoice, assTextQuestion, and assTextSubset.

toNormalized()

assQuestion::toNormalized	(	Transformations	$transformations,
		array	$context = []
	)

Parameters

array<string,mixed>

$context

Returns

array<array-key, mixed>|float|bool|int|string|null

Reimplemented in assClozeTest, assErrorText, assFileUpload, assFormulaQuestion, assImagemapQuestion, assKprimChoice, assLongMenu, assMatchingQuestion, assMultipleChoice, assNumeric, assOrderingHorizontal, assOrderingQuestion, assSingleChoice, assTextQuestion, and assTextSubset.

Definition at line 2971 of file class.assQuestion.php.

     : array|float|bool|int|string|null
    {
        return [
            'id' => $transformations->normalize(new Id($this->id, 'question')),
            'parent_id' => $transformations->normalize(new Id($this->obj_id, 'object')),
            'original_id' => $this->original_id,
            'external_id' => $this->external_id,
            'type' => $this->getQuestionType(),
            'owner' => $this->owner,
            'title' => $this->title,
            'description' => $this->comment,
            'question_text' => $this->question,
            'available_points' => $this->points,
            'nr_of_tries' => $this->nr_of_tries,
            'lifecycle' => $transformations->normalize($this->lifecycle),
            'author' => $this->author,
            'updated_timestamp' => $this->lastChange,
            'additional_content_editing_mode' => $this->additionalContentEditingMode,
            'thumb_size' => $this->thumb_size,
            'shuffle' => $this->shuffle,
            'suggested_solutions' => $transformations->normalize($this->suggested_solutions),
        ];
    }

References $comment, and ILIAS\TestQuestionPool\ExportImport\Foundation\Normalize\Transformations\normalize().

Here is the call graph for this function:

toQuestionAdministrationInteraction()

assQuestion::toQuestionAdministrationInteraction	(	AdditionalInformationGenerator	$additional_info,
		int	$test_ref_id,
		TestQuestionAdministrationInteractionTypes	$interaction_type
	)

Implements ILIAS\TestQuestionPool\Questions\Question.

Definition at line 2912 of file class.assQuestion.php.

     : TestQuestionAdministrationInteraction {
        return new TestQuestionAdministrationInteraction(
            $test_ref_id,
            $this->id,
            $this->current_user->getId(),
            $interaction_type,
            time(),
            $this->toLog($additional_info)
        );
    }

toXML()

assQuestion::toXML ( bool  $a_include_header = true, bool  $a_include_binary = true, bool  $a_shuffle = false, bool  $test_output = false, bool  $force_image_references = false  )

final

Deprecated:

12: use question normalizing and serialization instead

Definition at line 295 of file class.assQuestion.php.

     : string {
        $classname = $this->getQuestionType() . "Export";
        $export = new $classname($this);
        return $export->toXML($a_include_header, $a_include_binary, $a_shuffle, $test_output, $force_image_references);
    }

updateCurrentSolution()

assQuestion::updateCurrentSolution	(	int	$solutionId,
			$value1,
			$value2,
		bool	$authorized = true
	)

Definition at line 2504 of file class.assQuestion.php.

                                                                                                     : int
    {
        $fieldData = [
            "value1" => ["clob", $value1],
            "value2" => ["clob", $value2],
            "tstamp" => ["integer", time()],
            'authorized' => ['integer', (int) $authorized]
        ];
 
        if ($this->getStep() !== null) {
            $fieldData['step'] = ["integer", $this->getStep()];
        }
 
        return $this->db->update("tst_solutions", $fieldData, [
            'solution_id' => ['integer', $solutionId]
        ]);
    }

References ILIAS\Repository\int().

Here is the call graph for this function:

updateCurrentSolutionsAuthorization()

assQuestion::updateCurrentSolutionsAuthorization	(	int	$activeId,
		int	$pass,
		bool	$authorized,
		bool	$keepTime = false
	)

Definition at line 2523 of file class.assQuestion.php.

                                                                                                                           : int
    {
        $fieldData = [
            'authorized' => ['integer', (int) $authorized]
        ];
 
        if (!$keepTime) {
            $fieldData['tstamp'] = ['integer', time()];
        }
 
        $whereData = [
            'question_fi' => ['integer', $this->getId()],
            'active_fi' => ['integer', $activeId],
            'pass' => ['integer', $pass]
        ];
 
        if ($this->getStep() !== null) {
            $whereData['step'] = ["integer", $this->getStep()];
        }
 
        return $this->db->update('tst_solutions', $fieldData, $whereData);
    }

References ILIAS\Survey\Mode\getId(), and ILIAS\Repository\int().

Here is the call graph for this function:

updateOriginalId()

assQuestion::updateOriginalId

(

?int

$original_id = null

)

Deprecated:

This is a momentary helper function to update the original id, when cloning a test. Do not use anywhere else. 2026-06-25, sk

Definition at line 1233 of file class.assQuestion.php.

                                                              : void
    {
        $this->original_id = $original_id;
        $this->db->update(
            'qpl_questions',
            [
                'original_id' => [ilDBConstants::T_INTEGER, $original_id],
            ],
            [
                'question_id' => [ilDBConstants::T_INTEGER, $this->getId()]
            ]
        );
    }

References ILIAS\Survey\Mode\getId(), and ilDBConstants\T_INTEGER.

Here is the call graph for this function:

updateTimestamp()

assQuestion::updateTimestamp

(

)

Definition at line 2834 of file class.assQuestion.php.

                                     : void
    {
        $this->db->manipulateF(
            "UPDATE qpl_questions SET tstamp = %s  WHERE question_id = %s",
            ['integer', 'integer'],
            [time(), $this->getId()]
        );
    }

References ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

validateSolutionSubmit()

assQuestion::validateSolutionSubmit

(

)

Implements ILIAS\TestQuestionPool\Questions\Question.

Reimplemented in assFormulaQuestion, assMultipleChoice, assNumeric, and assOrderingQuestion.

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

                                            : bool
    {
        return true;
    }

Field Documentation

$additionalContentEditingMode

string assQuestion::$additionalContentEditingMode = ''

private

Definition at line 109 of file class.assQuestion.php.

$author

string assQuestion::$author

protected

Definition at line 97 of file class.assQuestion.php.

Referenced by assOrderingHorizontal\__construct(), assMatchingQuestion\__construct(), assImagemapQuestion\__construct(), assKprimChoice\__construct(), assClozeTest\__construct(), assFormulaQuestion\__construct(), assTextQuestion\__construct(), assSingleChoice\__construct(), assMultipleChoice\__construct(), assOrderingQuestion\__construct(), and assErrorText\__construct().

$comment

string assQuestion::$comment

protected

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

Referenced by assOrderingHorizontal\__construct(), assMatchingQuestion\__construct(), assImagemapQuestion\__construct(), assKprimChoice\__construct(), assClozeTest\__construct(), assFormulaQuestion\__construct(), assTextQuestion\__construct(), assSingleChoice\__construct(), assMultipleChoice\__construct(), assOrderingQuestion\__construct(), and assErrorText\__construct().

$current_user

ilObjUser assQuestion::$current_user

protected

Definition at line 79 of file class.assQuestion.php.

Referenced by getCurrentUser().

$db

ilDBInterface assQuestion::$db

protected

Definition at line 78 of file class.assQuestion.php.

$defaultnroftries

int assQuestion::$defaultnroftries = 0

Definition at line 112 of file class.assQuestion.php.

$dic

Container assQuestion::$dic

protected

Definition at line 85 of file class.assQuestion.php.

$export_image_path

string assQuestion::$export_image_path

private

Definition at line 107 of file class.assQuestion.php.

$external_id

string assQuestion::$external_id = null

protected

Definition at line 108 of file class.assQuestion.php.

$feedbackOBJ

ilAssQuestionFeedback assQuestion::$feedbackOBJ

Definition at line 89 of file class.assQuestion.php.

$force_pass_results_update_enabled

assQuestion::$force_pass_results_update_enabled = false

staticprotected

Definition at line 66 of file class.assQuestion.php.

Referenced by isForcePassResultUpdateEnabled(), and setForcePassResultUpdateEnabled().

$http

HTTPServices assQuestion::$http

protected

Definition at line 81 of file class.assQuestion.php.

$id

int assQuestion::$id

protected

Definition at line 93 of file class.assQuestion.php.

$ilias

ILIAS assQuestion::$ilias

protected

Definition at line 75 of file class.assQuestion.php.

$imageSourceFixReplaceMap

assQuestion::$imageSourceFixReplaceMap

staticprotected

Initial value:

= [
        'ok.svg' => 'ok.png',
        'not_ok.svg' => 'not_ok.png',
        'object/checkbox_checked.svg' => 'checkbox_checked.png',
        'object/checkbox_unchecked.svg' => 'checkbox_unchecked.png',
        'object/radiobutton_checked.svg' => 'radiobutton_checked.png',
        'object/radiobutton_unchecked.svg' => 'radiobutton_unchecked.png'
    ]

Definition at line 1053 of file class.assQuestion.php.

$lastChange

int assQuestion::$lastChange = null

protected

Definition at line 106 of file class.assQuestion.php.

$lifecycle

ilAssQuestionLifecycle assQuestion::$lifecycle

protected

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

$lng

ilLanguage assQuestion::$lng

protected

Definition at line 77 of file class.assQuestion.php.

$log

LoggingServices assQuestion::$log

protected

Definition at line 84 of file class.assQuestion.php.

$nr_of_tries

int assQuestion::$nr_of_tries

private

Definition at line 105 of file class.assQuestion.php.

$obj_id

int assQuestion::$obj_id = 0

protected

Definition at line 103 of file class.assQuestion.php.

$original_id

int assQuestion::$original_id = null

protected

Definition at line 104 of file class.assQuestion.php.

Referenced by assErrorText\saveToDb(), assFileUpload\saveToDb(), assImagemapQuestion\saveToDb(), assKprimChoice\saveToDb(), assLongMenu\saveToDb(), assMatchingQuestion\saveToDb(), assMultipleChoice\saveToDb(), assNumeric\saveToDb(), assOrderingHorizontal\saveToDb(), assOrderingQuestion\saveToDb(), assSingleChoice\saveToDb(), assTextQuestion\saveToDb(), and assTextSubset\saveToDb().

$owner

int assQuestion::$owner

protected

Definition at line 96 of file class.assQuestion.php.

Referenced by assOrderingHorizontal\__construct(), assMatchingQuestion\__construct(), assImagemapQuestion\__construct(), assKprimChoice\__construct(), assClozeTest\__construct(), assFormulaQuestion\__construct(), assTextQuestion\__construct(), assSingleChoice\__construct(), assMultipleChoice\__construct(), assOrderingQuestion\__construct(), and assErrorText\__construct().

$page

ilAssQuestionPage assQuestion::$page

protected

Definition at line 90 of file class.assQuestion.php.

$points

float assQuestion::$points = 0.0

protected

Definition at line 100 of file class.assQuestion.php.

Referenced by assTextSubset\addAnswer(), assTextQuestion\calculateReachedPointsForSolution(), assNumeric\calculateReachedPointsFromPreviewSession(), assLongMenu\checkQuestionCustomPart(), assLongMenu\getMaximumPoints(), assTextQuestion\getMaximumPoints(), assTextSubset\getMaximumPoints(), assTextQuestion\getMinimumPoints(), assLongMenu\getPointsForGap(), and assLongMenu\saveAnswerSpecificDataToDb().

$prevent_rte_usage

bool assQuestion::$prevent_rte_usage = false

Definition at line 110 of file class.assQuestion.php.

$processLocker

ilAssQuestionProcessLocker assQuestion::$processLocker

protected

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

Referenced by getProcessLocker(), and setProcessLocker().

$question

string assQuestion::$question

protected

Definition at line 99 of file class.assQuestion.php.

Referenced by assOrderingHorizontal\__construct(), assMatchingQuestion\__construct(), assImagemapQuestion\__construct(), assKprimChoice\__construct(), assClozeTest\__construct(), assFormulaQuestion\__construct(), assTextQuestion\__construct(), assSingleChoice\__construct(), assMultipleChoice\__construct(), assOrderingQuestion\__construct(), and assErrorText\__construct().

$question_files

QuestionFiles assQuestion::$question_files

protected

Definition at line 70 of file class.assQuestion.php.

$questionActionCmd

string assQuestion::$questionActionCmd = 'handleQuestionAction'

Definition at line 113 of file class.assQuestion.php.

$questionpool_request

RequestDataCollector assQuestion::$questionpool_request

protected

Definition at line 69 of file class.assQuestion.php.

$questionrepository

GeneralQuestionPropertiesRepository assQuestion::$questionrepository

protected

Definition at line 68 of file class.assQuestion.php.

$refinery

Refinery assQuestion::$refinery

protected

Definition at line 82 of file class.assQuestion.php.

Referenced by assTextSubset\isAnswerCorrect(), and assTextQuestion\isKeywordMatching().

$selfassessmenteditingmode

bool assQuestion::$selfassessmenteditingmode = false

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

$shuffle

bool assQuestion::$shuffle = true

protected

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

Referenced by assMultipleChoice\loadFromDb(), assSingleChoice\loadFromDb(), and assMatchingQuestion\setShuffleMode().

$shuffler

Transformation assQuestion::$shuffler

protected

Definition at line 83 of file class.assQuestion.php.

Referenced by getShuffler(), and setShuffler().

$skillUsageService

SkillUsageService assQuestion::$skillUsageService

protected

Definition at line 80 of file class.assQuestion.php.

$step

int assQuestion::$step = null

protected

Definition at line 114 of file class.assQuestion.php.

$suggested_solutions

array assQuestion::$suggested_solutions

protected

Definition at line 119 of file class.assQuestion.php.

$suggestedsolution_repo

SuggestedSolutionsDatabaseRepository assQuestion::$suggestedsolution_repo

protected

Definition at line 73 of file class.assQuestion.php.

$test_id

int assQuestion::$test_id

protected

Definition at line 102 of file class.assQuestion.php.

$test_question_config

ilTestQuestionConfig assQuestion::$test_question_config = null

private

Definition at line 87 of file class.assQuestion.php.

$test_result_repository

TestResultRepository assQuestion::$test_result_repository

protected

Definition at line 91 of file class.assQuestion.php.

$testQuestionConfig

ilTestQuestionConfig assQuestion::$testQuestionConfig

protected

Definition at line 72 of file class.assQuestion.php.

$thumb_size

int assQuestion::$thumb_size

protected

Definition at line 98 of file class.assQuestion.php.

$title

string assQuestion::$title

protected

Definition at line 94 of file class.assQuestion.php.

Referenced by assOrderingHorizontal\__construct(), assMatchingQuestion\__construct(), assImagemapQuestion\__construct(), assKprimChoice\__construct(), assClozeTest\__construct(), assFormulaQuestion\__construct(), assTextQuestion\__construct(), assSingleChoice\__construct(), assMultipleChoice\__construct(), assOrderingQuestion\__construct(), and assErrorText\__construct().

$tpl

ilGlobalPageTemplate assQuestion::$tpl

protected

Definition at line 76 of file class.assQuestion.php.

ADDITIONAL_CONTENT_EDITING_MODE_IPE

const assQuestion::ADDITIONAL_CONTENT_EDITING_MODE_IPE = 'pageobject'

Definition at line 59 of file class.assQuestion.php.

Referenced by assQuestionGUI\addBasicQuestionFormProperties(), ilObjTestGUI\buildInputEditingType(), ilObjQuestionPoolGUI\buildInputEditingType(), ilPCQuestionGUI\insert(), isAdditionalContentEditingModePageObject(), assClozeTestGUI\populateQuestionSpecificFormPart(), and ilAssQuestionPage\retrieveLegacyPageElementContent().

ADDITIONAL_CONTENT_EDITING_MODE_RTE

const assQuestion::ADDITIONAL_CONTENT_EDITING_MODE_RTE = 'default'

Definition at line 58 of file class.assQuestion.php.

Referenced by ilObjTestGUI\buildInputEditingType(), ilObjQuestionPoolGUI\buildInputEditingType(), ilPCQuestionGUI\edit(), assQuestionImport\fetchAdditionalContentEditingModeInformation(), ilPCQuestionGUI\insert(), and assLongMenuGUI\populateQuestionSpecificFormPart().

DEFAULT_THUMB_SIZE

const assQuestion::DEFAULT_THUMB_SIZE = 150

private

Definition at line 61 of file class.assQuestion.php.

HAS_SPECIFIC_FEEDBACK

const assQuestion::HAS_SPECIFIC_FEEDBACK = true

protected

Definition at line 56 of file class.assQuestion.php.

KEY_VALUES_IMPLOSION_SEPARATOR

const assQuestion::KEY_VALUES_IMPLOSION_SEPARATOR = ':'

Definition at line 2548 of file class.assQuestion.php.

Referenced by explodeKeyValues(), and implodeKeyValues().

MAXIMUM_THUMB_SIZE

const assQuestion::MAXIMUM_THUMB_SIZE = 8192

private

Definition at line 63 of file class.assQuestion.php.

MINIMUM_THUMB_SIZE

const assQuestion::MINIMUM_THUMB_SIZE = 20

private

Definition at line 62 of file class.assQuestion.php.

TRIM_PATTERN

const assQuestion::TRIM_PATTERN = '/^[\p{C}\p{Z}]+|[\p{C}\p{Z}]+$/u'

Definition at line 64 of file class.assQuestion.php.

---

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

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