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)
	Returns a QTI xml representation of the question. More...
	setTitle (string $title="")
	setId (int $id=-1)
	setTestId (int $id=-1)
	setComment (string $comment="")
	setShuffle (?bool $shuffle=true)
	setAuthor (string $author="")
	setOwner (int $owner=-1)
	getTitle ()
	getTitleForHTMLOutput ()
	getTitleFilenameCompliant ()
	getId ()
	getShuffle ()
	getTestId ()
	getComment ()
	getDescriptionForHTMLOutput ()
	getThumbSize ()
	setThumbSize (int $a_size)
	getMinimumThumbSize ()
	getMaximumThumbSize ()
	getAuthor ()
	getAuthorForHTMLOutput ()
	getOwner ()
	getObjId ()
	setObjId (int $obj_id=0)
	getLifecycle ()
	setLifecycle (ilAssQuestionLifecycle $lifecycle)
	setExternalId (?string $external_id)
	getExternalId ()
	getSuggestedSolutionOutput ()
	getSuggestedSolutions ()
	getReachedPoints (int $active_id, int $pass)
	getMaximumPoints ()
	getAdjustedReachedPoints (int $active_id, int $pass, bool $authorized_solution=true)
	calculateResultsFromSolution (int $active_id, int $pass)
	Calculates the question results from a previously saved question solution. More...
	persistWorkingState (int $active_id, $pass, bool $authorized=true)
	persists the working state for current testactive and testpass More...
	persistPreviewState (ilAssQuestionPreviewSession $preview_session)
	persists the preview state for current user and question More...
	validateSolutionSubmit ()
	getSuggestedSolutionPath ()
	getImagePath ($question_id=null, $object_id=null)
	Returns the image path for web accessable images of a question. More...
	getSuggestedSolutionPathWeb ()
	getImagePathWeb ()
	Returns the web image path for web accessable images of a question. More...
	getTestOutputSolutions (int $activeId, int $pass)
	getUserSolutionPreferingIntermediate (int $active_id, ?int $pass=null)
	getSolutionValues (int $active_id, ?int $pass=null, bool $authorized=true)
	Loads solutions of a given user from the database an returns it. More...
	deleteAnswers (int $question_id)
	deleteAdditionalTableData (int $question_id)
	delete (int $question_id)
	getTotalAnswers ()
	cloneXHTMLMediaObjectsOfQuestion (int $source_question_id)
	createPageObject ()
	clonePageOfQuestion (int $a_q_id)
	getPageOfQuestion ()
	setOriginalId (?int $original_id)
	getOriginalId ()
static	fixSvgToPng (string $imageFilenameContainingString)
	fixUnavailableSkinImageSources (string $html)
	loadFromDb (int $question_id)
	createNewQuestion (bool $a_create_page=true)
	Creates a new question without an owner when a new question is created This assures that an ID is given to the question if a file upload or something else occurs. More...
	saveQuestionDataToDb (?int $original_id=null)
	duplicate (bool $for_test=true, string $title='', string $author='', int $owner=-1, $test_obj_id=null)
	copyObject (int $target_parent_id, string $title='')
	createNewOriginalFromThisDuplicate (int $target_parent_id, string $target_question_title='')
	saveToDb (?int $original_id=null)
	deleteSuggestedSolutions ()
	getSuggestedSolution (int $subquestion_index=0)
	resolveInternalLink (string $internal_link)
	resolveSuggestedSolutionLinks ()
	getInternalLinkHref (string $target)
	syncWithOriginal ()
	getPoints ()
	setPoints (float $points)
	getSolutionMaxPass (int $active_id)
	isWriteable ()
	calculateReachedPointsFromPreviewSession (ilAssQuestionPreviewSession $preview_session)
	isPreviewSolutionCorrect (ilAssQuestionPreviewSession $preview_session)
	adjustReachedPointsByScoringOptions (float $points, int $active_id)
	Adjust the given reached points by checks for all special scoring options in the test container. More...
	buildHashedImageFilename (string $plain_image_filename, bool $unique=false)
	getQuestion ()
	getQuestionForHTMLOutput ()
	setQuestion (string $question="")
	getQuestionTypeID ()
	cleanupMediaObjectUsage ()
	getInstances ()
	getActiveUserData (int $active_id)
	Returns the user id and the test id for a given active id. More...
	hasSpecificFeedback ()
	getNrOfTries ()
	setNrOfTries (int $a_nr_of_tries)
	setExportImagePath (string $path)
	formatSAQuestion ($a_q)
	setPreventRteUsage (bool $prevent_rte_usage)
	getPreventRteUsage ()
	migrateContentForLearningModule (ilAssSelfAssessmentMigrator $migrator)
	setSelfAssessmentEditingMode (bool $selfassessmenteditingmode)
	getSelfAssessmentEditingMode ()
	setDefaultNrOfTries (int $defaultnroftries)
	getDefaultNrOfTries ()
	syncSkillAssignments (int $srcParentId, int $srcQuestionId, int $trgParentId, int $trgQuestionId)
	isAnswered (int $active_id, int $pass)
	getAdditionalContentEditingMode ()
	setAdditionalContentEditingMode (?string $additionalContentEditingMode)
	isAdditionalContentEditingModePageObject ()
	isValidAdditionalContentEditingMode (string $additionalContentEditingMode)
	getValidAdditionalContentEditingModes ()
	getHtmlUserSolutionPurifier ()
	getHtmlQuestionContentPurifier ()
	setLastChange (int $lastChange)
	getLastChange ()
	removeIntermediateSolution (int $active_id, int $pass)
	removeCurrentSolution (int $active_id, int $pass, bool $authorized=true)
	saveCurrentSolution (int $active_id, int $pass, $value1, $value2, bool $authorized=true, $tstamp=0)
	updateCurrentSolution (int $solutionId, $value1, $value2, bool $authorized=true)
	updateCurrentSolutionsAuthorization (int $activeId, int $pass, bool $authorized, bool $keepTime=false)
	setStep ($step)
	getStep ()
	toJSON ()
	intermediateSolutionExists (int $active_id, int $pass)
	authorizedSolutionExists (int $active_id, ?int $pass)
	authorizedOrIntermediateSolutionExists (int $active_id, int $pass)
	lookupForExistingSolutions (int $activeId, int $pass)
	Lookup if an authorized or intermediate solution exists. More...
	isAddableAnswerOptionValue (int $qIndex, string $answerOptionValue)
	addAnswerOptionValue (int $qIndex, string $answerOptionValue, float $points)
	removeAllExistingSolutions ()
	removeExistingSolutions (int $activeId, int $pass)
	resetUsersAnswer (int $activeId, int $pass)
	removeResultRecord (int $activeId, int $pass)
	fetchValuePairsFromIndexedValues (array $indexedValues)
	fetchIndexedValuesFromValuePairs (array $value_pairs)
	updateTimestamp ()
	getTestPresentationConfig ()
	hasWritableOriginalInQuestionPool ()
	answerToParticipantInteraction (AdditionalInformationGenerator $additional_info, int $test_ref_id, int $active_id, int $pass, string $source_ip, TestParticipantInteractionTypes $interaction_type)
	toQuestionAdministrationInteraction (AdditionalInformationGenerator $additional_info, int $test_ref_id, TestQuestionAdministrationInteractionTypes $interaction_type)
	getSolutionForTextOutput (int $active_id, int $pass)
	getCorrectSolutionForTextOutput (int $active_id, int $pass)
	getVariablesAsTextArray (int $active_id, int $pass)

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 52 of file class.assQuestion.php.

Member Function Documentation

_getReachedPoints()

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

static

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

References $DIC, $ilDB, and $points.

Referenced by ILIAS\Test\Scoring\Manual\TestScoringByParticipantGUI\buildManScoringParticipantForm(), and ILIAS\Test\Scoring\Manual\TestScoringByParticipantGUI\saveManScoringParticipantScreen().

                                                                                         : 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;
    }

Here is the caller graph for this function:

_getSolutionMaxPass()

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

static

Returns the maximum pass a users question solution.

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

References $DIC, $ilDB, and null.

Referenced by buildHashedImageFilename(), and ilObjTest\getTextAnswer().

                                                                                : ?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;
    }

Here is the caller graph for this function:

_getSuggestedSolutionOutput()

static assQuestion::_getSuggestedSolutionOutput ( int  $question_id )

static

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

Referenced by ILIAS\Test\Scoring\Manual\TestScoringByQuestionGUI\buildFeedbackModal(), and ilObjTest\getTestResult().

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

Here is the caller graph for this function:

_questionExistsInTest()

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

static

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

References $DIC, and $ilDB.

                                                                                : 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;
    }

addAnswerOptionValue()

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

Definition at line 2740 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.

public

Parameters

integer	$points
integer	$active_id
integer	$pass

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

References $points, ilObjTest\_getCountSystem(), ilObjTest\_getScoreCutting(), and getMaximumPoints().

Referenced by calculateResultsFromSolution(), and getAdjustedReachedPoints().

                                                                                            : 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;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

afterSyncWithOriginal()

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

protected

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

Referenced by syncWithOriginal().

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

Here is the caller graph for this function:

answerToLog()

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

protected

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

References getReachedPoints(), getSolutionValues(), and solutionValuesToLog().

Referenced by answerToParticipantInteraction().

     : 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)
            )
        ];
    }

Here is the call graph for this function:

Here is the caller graph for this function:

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 2879 of file class.assQuestion.php.

References answerToLog().

Referenced by ilTestPlayerAbstractGUI\save().

     : 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)
        );
    }

Here is the call graph for this function:

Here is the caller graph for this function:

authorizedOrIntermediateSolutionExists()

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

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

References lookupForExistingSolutions().

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

Here is the call graph for this function:

authorizedSolutionExists()

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

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

References lookupForExistingSolutions(), and null.

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

Here is the call graph for this function:

buildHashedImageFilename()

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

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

References $DIC, $ilDB, _getSolutionMaxPass(), ilObjTest\_getUserIdFromActiveId(), ilCourseObjectiveResult\_updateObjectiveResult(), and null.

Referenced by assKprimChoice\handleFileUpload(), assMatchingQuestion\rebuildThumbnails(), assOrderingQuestion\storeImageFile(), and assOrderingQuestion\updateImageFile().

                                                                                                : 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;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

buildQuestionDataQuery()

assQuestion::buildQuestionDataQuery ( )

protected

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

Referenced by assKprimChoice\loadFromDb().

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

Here is the caller graph for this function:

buildTestPresentationConfig()

assQuestion::buildTestPresentationConfig ( )

protected

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

Referenced by getTestPresentationConfig().

                                                    : ilTestQuestionConfig
    {
        return new ilTestQuestionConfig();
    }

Here is the caller graph for this function:

calculateReachedPoints()

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

abstract

Referenced by calculateResultsFromSolution(), and getAdjustedReachedPoints().

Here is the caller graph for this function:

calculateReachedPointsFromPreviewSession()

assQuestion::calculateReachedPointsFromPreviewSession

(

ilAssQuestionPreviewSession

$preview_session

)

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

References ensureNonNegativePoints(), and ilAssQuestionPreviewSession\getParticipantsSolution().

Referenced by isPreviewSolutionCorrect().

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

Here is the call graph for this function:

Here is the caller 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 556 of file class.assQuestion.php.

References ilCourseObjectiveResult\_updateObjectiveResult(), adjustReachedPointsByScoringOptions(), calculateReachedPoints(), getId(), getProcessLocker(), getStep(), lookupForExistingSolutions(), and null.

Referenced by persistWorkingState().

                                                                                 : 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());
    }

Here is the call graph for this function:

Here is the caller graph for this function:

cleanupMediaObjectUsage()

assQuestion::cleanupMediaObjectUsage

(

)

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

References ilRTE\_cleanupMediaObjectUsage(), getId(), and getRTETextWithMediaObjects().

Referenced by saveToDb().

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

Here is the call graph for this function:

Here is the caller graph for this function:

clonePageOfQuestion()

assQuestion::clonePageOfQuestion

(

int

$a_q_id

)

Definition at line 1028 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();
        }
    }

cloneQuestionTypeSpecificProperties()

assQuestion::cloneQuestionTypeSpecificProperties ( self  $target )

protected

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

Referenced by copyObject(), createNewOriginalFromThisDuplicate(), duplicate(), and syncWithOriginal().

     : self {
        return $target;
    }

Here is the caller graph for this function:

cloneSuggestedSolutionFiles()

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

protected

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

References ilFileUtils\delDir(), getSuggestedSolutionPath(), and ilFileUtils\makeDirParents().

Referenced by cloneSuggestedSolutions(), and onDuplicate().

     : 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->root()->error('File for suggested solutions could not be cloned:');
                $this->log->root()->error("Question-Id: {$this->id}; Question-Title: {$this->title}; File: {$filepath_original}{$solution->getFilename()}");
            }
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

cloneSuggestedSolutions()

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

protected

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

References cloneSuggestedSolutionFiles(), and getSuggestedSolutionsRepo().

Referenced by syncWithOriginal().

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

Here is the call graph for this function:

Here is the caller graph for this function:

cloneXHTMLMediaObjectsOfQuestion()

assQuestion::cloneXHTMLMediaObjectsOfQuestion

(

int

$source_question_id

)

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

References ilObjMediaObject\_getMobsOfObject(), ilObjMediaObject\_saveUsage(), and getId().

Referenced by syncWithOriginal().

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

Here is the call graph for this function:

Here is the caller graph for this function:

convertISO8601FormatH_i_s_ExtendedToSeconds()

static assQuestion::convertISO8601FormatH_i_s_ExtendedToSeconds ( string  $time )

static

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

References ILIAS\Repository\int().

                                                                                    : 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;
    }

Here is the call graph for this function:

copyObject()

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

final

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

References cloneQuestionTypeSpecificProperties(), getId(), and getObjId().

     : 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;
    }

Here is the call graph for this function:

copySuggestedSolutions()

assQuestion::copySuggestedSolutions ( int  $target_question_id )

protected

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

References getSuggestedSolutions(), and getSuggestedSolutionsRepo().

Referenced by onCopy(), and onDuplicate().

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

Here is the call graph for this function:

Here is the caller graph for this function:

createNewOriginalFromThisDuplicate()

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

final

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

References $id, cloneQuestionTypeSpecificProperties(), getId(), and getObjId().

     : 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;
    }

Here is the call graph for this function:

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 1136 of file class.assQuestion.php.

References createPageObject(), getAdditionalContentEditingMode(), getAuthor(), getDefaultNrOfTries(), getExternalId(), getId(), getObjId(), getQuestionTypeID(), null, and setId().

                                                                 : 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();
    }

Here is the call graph for this function:

createPageObject()

assQuestion::createPageObject

(

)

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

References getId(), and getObjId().

Referenced by createNewQuestion(), and saveQuestionDataToDb().

                                      : 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);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

delete()

assQuestion::delete

(

int

$question_id

)

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

References Vendor\Package\$e, ilObjMediaObject\_exists(), ilObjMediaObject\_getMobsOfObject(), ilObjMediaObject\_removeUsage(), ilObjQuestionPool\_updateQuestionCount(), CLIENT_WEB_DIR, ilFileUtils\delDir(), deleteAdditionalTableData(), deleteAnswers(), deleteComments(), deletePageOfQuestion(), deleteTaxonomyAssignments(), getObjId(), getSuggestedSolutionsRepo(), and isAdditionalContentEditingModePageObject().

                                            : 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->root()->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->root()->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->root()->error("EXCEPTION: Could not delete delete question {$question_id} from a test: {$e}");
        }

        try {
            $this->getSuggestedSolutionsRepo()->deleteForQuestion($question_id);
        } catch (Exception $e) {
            $this->log->root()->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->root()->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->root()->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->root()->error(
                "EXCEPTION: Error updating the question pool question count of"
                . " question pool {$this->getObjId()} when deleting question {$question_id}: {$e}"
            );
        }
    }

Here is the call graph for this function:

deleteAdditionalTableData()

assQuestion::deleteAdditionalTableData

(

int

$question_id

)

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

References getAdditionalTableName().

Referenced by delete().

                                                               : void
    {
        $additional_table_name = $this->getAdditionalTableName();

        if (!is_array($additional_table_name)) {
            $additional_table_name = [$additional_table_name];
        }

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

Here is the call graph for this function:

Here is the caller graph for this function:

deleteAnswers()

assQuestion::deleteAnswers

(

int

$question_id

)

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

References getAnswerTableName().

Referenced by delete().

                                                   : 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]
                );
            }
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

deleteComments()

assQuestion::deleteComments ( )

protected

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

References getId(), getNotesManager(), getNotesRepo(), and getObjId().

Referenced by delete().

                                       : 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());
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

deleteDummySolutionRecord()

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

protected

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

References getSolutionValues(), and removeSolutionRecordById().

Referenced by assFileUpload\saveWorkingData().

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

Here is the call graph for this function:

Here is the caller graph for this function:

deletePageOfQuestion()

assQuestion::deletePageOfQuestion ( int  $question_id )

protected

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

References ilPageObject\_exists().

Referenced by delete().

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

Here is the call graph for this function:

Here is the caller graph for this function:

deleteSolutionRecordByValues()

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

protected

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

References getId(), getStep(), ILIAS\Repository\int(), and null.

                                                                                                                        : 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);
    }

Here is the call graph for this function:

deleteSuggestedSolutions()

assQuestion::deleteSuggestedSolutions

(

)

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

References ilInternalLink\_deleteAllLinksOfSource(), ilFileUtils\delDir(), getId(), getSuggestedSolutionPath(), and getSuggestedSolutionsRepo().

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

Here is the call graph for this function:

deleteTaxonomyAssignments()

assQuestion::deleteTaxonomyAssignments ( )

private

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

References getId(), getObjId(), and ilObjTaxonomy\getUsageOfObject().

Referenced by delete().

                                                : void
    {
        $taxIds = ilObjTaxonomy::getUsageOfObject($this->getObjId());

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

Here is the call graph for this function:

Here is the caller graph for this function:

duplicate()

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

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

References cloneQuestionTypeSpecificProperties(), getId(), and getObjId().

     : 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 ($for_test) {
            $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;
    }

Here is the call graph for this function:

duplicateComments()

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

protected

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

References getNotesDataService(), and getNotesManager().

Referenced by onCopy(), and onDuplicate().

     : 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);
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

duplicateIntermediateSolutionAuthorized()

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

protected

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

References getSolutionValues(), and saveCurrentSolution().

Referenced by forceExistingIntermediateSolution().

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

Here is the call graph for this function:

Here is the caller graph for this function:

duplicateSkillAssignments()

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

protected

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

Referenced by onCopy(), onDuplicate(), and syncSkillAssignments().

                                                                                                                            : 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()
            );
        }
    }

Here is the caller graph for this function:

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 1531 of file class.assQuestion.php.

References getSuggestedSolutionPath(), and ilFileUtils\makeDirParents().

Referenced by onCopy().

                                                                                        : 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->root()->error('File for suggested solutions could not be duplicated:');
                $this->log->root()->error("Question-Id: {$this->id}; Question-Title: {$this->title}; File: {$filepath_original}{$solution->getFilename()}");
            }
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

ensureNonNegativePoints()

assQuestion::ensureNonNegativePoints ( float  $points )

protected

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

References $points.

Referenced by assNumeric\calculateReachedPointsFromPreviewSession(), assErrorText\calculateReachedPointsFromPreviewSession(), assSingleChoice\calculateReachedPointsFromPreviewSession(), assOrderingQuestion\calculateReachedPointsFromPreviewSession(), assFormulaQuestion\calculateReachedPointsFromPreviewSession(), assClozeTest\calculateReachedPointsFromPreviewSession(), and calculateReachedPointsFromPreviewSession().

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

Here is the caller graph for this function:

explodeKeyValues()

static assQuestion::explodeKeyValues ( string  $keyValues )

static

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

References KEY_VALUES_IMPLOSION_SEPARATOR.

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

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 2867 of file class.assQuestion.php.

Referenced by assTextSubset\getSolutionSubmit(), and assTextSubsetGUI\writeAnswerSpecificPostData().

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

Here is the caller graph for this function:

fetchIndexedValuesFromValuePairs()

assQuestion::fetchIndexedValuesFromValuePairs

(

array

$value_pairs

)

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

Referenced by assOrderingQuestion\calculateReachedPoints(), assOrderingQuestion\getOrderingElementListForSolutionOutput(), assOrderingQuestion\getSolutionOrderingElementListForTestOutput(), assOrderingQuestion\solutionValuesToLog(), and assOrderingQuestion\solutionValuesToText().

                                                                        : array
    {
        $indexed_values = [];

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

        return $indexed_values;
    }

Here is the caller graph for this function:

fetchValuePairsFromIndexedValues()

assQuestion::fetchValuePairsFromIndexedValues

(

array

$indexedValues

)

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

                                                                          : array
    {
        $valuePairs = [];

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

        return $valuePairs;
    }

fixSvgToPng()

static assQuestion::fixSvgToPng

(

string

$imageFilenameContainingString

)

Definition at line 1065 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 1072 of file class.assQuestion.php.

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

                                                                : 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;
    }

Here is the call graph for this function:

forceExistingIntermediateSolution()

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

protected

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

References duplicateIntermediateSolutionAuthorized(), getSolutionValues(), null, saveCurrentSolution(), and updateCurrentSolutionsAuthorization().

Referenced by assFileUpload\saveWorkingData().

                                                                                                                          : 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);
            }
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

formatSAQuestion()

assQuestion::formatSAQuestion

(

$a_q

)

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

References getSelfAssessmentFormatter().

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

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

Here is the call graph for this function:

Here is the caller 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

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

References getQuestionType().

     : 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;
    }

Here is the call graph for this function:

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 2033 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 2283 of file class.assQuestion.php.

References $additionalContentEditingMode.

Referenced by createNewQuestion(), isAdditionalContentEditingModePageObject(), assSingleChoice\saveAdditionalQuestionDataToDb(), assMultipleChoice\saveAnswerSpecificDataToDb(), and saveQuestionDataToDb().

                                                     : string
    {
        return $this->additionalContentEditingMode;
    }

Here is the caller graph for this function:

getAdditionalTableName()

assQuestion::getAdditionalTableName ( )

abstract

Referenced by deleteAdditionalTableData().

Here is the caller graph for this function:

getAdjustedReachedPoints()

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

final

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

References adjustReachedPointsByScoringOptions(), and calculateReachedPoints().

                                                                                                               : 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;
    }

Here is the call graph for this function:

getAnswerTableName()

assQuestion::getAnswerTableName ( )

abstract

Referenced by deleteAnswers().

Here is the caller graph for this function:

getAuthor()

assQuestion::getAuthor

(

)

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

References $author.

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

                               : string
    {
        return $this->author;
    }

Here is the caller graph for this function:

getAuthorForHTMLOutput()

assQuestion::getAuthorForHTMLOutput

(

)

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

References ILIAS\Repository\refinery().

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

Here is the call graph for this function:

getComment()

assQuestion::getComment

(

)

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

References $comment.

Referenced by saveQuestionDataToDb().

                                : string
    {
        return $this->comment;
    }

Here is the caller graph for this function:

getCorrectSolutionForTextOutput()

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

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

References getSolutionValues(), and solutionValuesToText().

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

Here is the call graph for this function:

getCurrentSolutionResultSet()

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

protected

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

References getId(), getStep(), and null.

Referenced by assOrderingHorizontal\calculateReachedPoints(), assNumeric\calculateReachedPoints(), assFileUpload\calculateReachedPoints(), assErrorText\calculateReachedPoints(), assSingleChoice\calculateReachedPoints(), assTextSubset\calculateReachedPoints(), assMultipleChoice\calculateReachedPoints(), assTextQuestion\calculateReachedPoints(), assKprimChoice\calculateReachedPoints(), assLongMenu\calculateReachedPoints(), assMatchingQuestion\calculateReachedPoints(), assClozeTest\fetchUserResult(), assNumeric\saveWorkingData(), and assSingleChoice\saveWorkingData().

                                                                                                      : \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]
        );
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getCurrentUser()

assQuestion::getCurrentUser

(

)

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

References $current_user.

Referenced by isWriteable().

                                    : ilObjUser
    {
        return $this->current_user;
    }

Here is the caller graph for this function:

getDefaultNrOfTries()

assQuestion::getDefaultNrOfTries

(

)

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

References $defaultnroftries.

Referenced by createNewQuestion().

                                         : int
    {
        return $this->defaultnroftries;
    }

Here is the caller graph for this function:

getDescriptionForHTMLOutput()

assQuestion::getDescriptionForHTMLOutput

(

)

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

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

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

Here is the call graph for this function:

getExternalId()

assQuestion::getExternalId

(

)

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

References $external_id, getId(), IL_INST_ID, and null.

Referenced by createNewQuestion(), and saveQuestionDataToDb().

                                   : 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;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getFeedbackClassNameByQuestionType()

static assQuestion::getFeedbackClassNameByQuestionType ( string  $questionType )

static

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

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

Referenced by assQuestionGUI\_getQuestionGUI().

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

Here is the call graph for this function:

Here is the caller graph for this function:

getHtmlQuestionContentPurifier()

assQuestion::getHtmlQuestionContentPurifier

(

)

Returns

ilHtmlPurifierInterface|ilAssHtmlUserSolutionPurifier

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

References ilHtmlPurifierFactory\getInstanceByType().

Referenced by assSingleChoice\addAnswer(), assKprimChoice\addAnswer(), assMultipleChoice\addAnswer(), assClozeTest\getClozeTextForHTMLOutput(), purifyAndPrepareTextAreaOutput(), assKprimChoice\setAnswers(), and assLongMenu\setLongMenuTextValue().

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

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 2322 of file class.assQuestion.php.

References ilHtmlPurifierFactory\getInstanceByType().

Referenced by assTextQuestion\getSolutionSubmit(), and assTextSubset\getSolutionSubmit().

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

Here is the call graph for this function:

Here is the caller graph for this function:

getId()

assQuestion::getId

(

)

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

References $id.

Referenced by ilQuestionUsagesTableGUI\__construct(), ilQuestionCumulatedStatisticsTableGUI\__construct(), assLongMenu\buildFolderName(), assOrderingQuestion\buildNestedOrderingElementInputGui(), assClozeTest\calculateCombinationResult(), calculateResultsFromSolution(), cleanupMediaObjectUsage(), assOrderingQuestion\cloneQuestionTypeSpecificProperties(), assSingleChoice\cloneQuestionTypeSpecificProperties(), assMultipleChoice\cloneQuestionTypeSpecificProperties(), assImagemapQuestion\cloneQuestionTypeSpecificProperties(), assMatchingQuestion\cloneQuestionTypeSpecificProperties(), assKprimChoice\cloneQuestionTypeSpecificProperties(), assFormulaQuestion\cloneQuestionTypeSpecificProperties(), assClozeTest\cloneQuestionTypeSpecificProperties(), cloneXHTMLMediaObjectsOfQuestion(), copyObject(), createNewOriginalFromThisDuplicate(), createNewQuestion(), createPageObject(), deleteComments(), deleteSolutionRecordByValues(), deleteSuggestedSolutions(), deleteTaxonomyAssignments(), duplicate(), assTextQuestion\duplicateAnswers(), assOrderingQuestion\fetchSolutionListFromFormSubmissionData(), assFormulaQuestion\getBestSolution(), assLongMenu\getCorrectAnswersAsJson(), getCurrentSolutionResultSet(), assErrorText\getErrorDataAsArrayForJS(), getExternalId(), assFileUpload\getFileUploadPath(), assFileUpload\getFileUploadPathWeb(), getInstances(), assTextQuestion\getLatestAutosaveContent(), assClozeTest\getMaximumPoints(), assOrderingQuestion\getOrderingElementList(), assErrorText\getParsedErrorTextForJS(), getReachedPoints(), assMultipleChoice\getRTETextWithMediaObjects(), assSingleChoice\getRTETextWithMediaObjects(), getRTETextWithMediaObjects(), getSolutionMaxPass(), assOrderingQuestion\getSolutionOrderingElementList(), getSolutionValues(), assFileUpload\getUploadedFiles(), assNumeric\getUserQuestionResult(), assOrderingHorizontal\getUserQuestionResult(), assTextSubset\getUserQuestionResult(), assErrorText\getUserQuestionResult(), assSingleChoice\getUserQuestionResult(), assMultipleChoice\getUserQuestionResult(), assOrderingQuestion\getUserQuestionResult(), assFormulaQuestion\getUserQuestionResult(), assMatchingQuestion\getUserQuestionResult(), assClozeTest\getUserQuestionResult(), assFormulaQuestion\getVariableSolutionValuesForPass(), assFileUpload\hasFileUploads(), isAnswered(), isWriteable(), assTextQuestion\loadFromDb(), loadSuggestedSolutions(), assLongMenu\lookupForExistingSolutions(), assFormulaQuestion\lookupForExistingSolutions(), lookupForExistingSolutions(), lookupMaxStep(), migrateContentForLearningModule(), ilAssNestedOrderingElementsInputGUI\prepareReprintable(), removeAllExistingSolutions(), removeCurrentSolution(), assFormulaQuestion\removeExistingSolutions(), removeExistingSolutions(), removeResultRecord(), ilAssOrderingQuestionAuthoringFormGUI\renewOrderingElementInput(), resolveSuggestedSolutionLinks(), assFileUpload\saveAdditionalQuestionDataToDb(), assErrorText\saveAdditionalQuestionDataToDb(), assImagemapQuestion\saveAdditionalQuestionDataToDb(), assMatchingQuestion\saveAdditionalQuestionDataToDb(), assOrderingHorizontal\saveAdditionalQuestionDataToDb(), assLongMenu\saveAdditionalQuestionDataToDb(), assClozeTest\saveAdditionalQuestionDataToDb(), assNumeric\saveAdditionalQuestionDataToDb(), assKprimChoice\saveAdditionalQuestionDataToDb(), assTextSubset\saveAdditionalQuestionDataToDb(), assSingleChoice\saveAdditionalQuestionDataToDb(), assMultipleChoice\saveAdditionalQuestionDataToDb(), assTextQuestion\saveAdditionalQuestionDataToDb(), assOrderingQuestion\saveAdditionalQuestionDataToDb(), assErrorText\saveAnswerSpecificDataToDb(), assMatchingQuestion\saveAnswerSpecificDataToDb(), assImagemapQuestion\saveAnswerSpecificDataToDb(), assClozeTest\saveAnswerSpecificDataToDb(), assLongMenu\saveAnswerSpecificDataToDb(), assNumeric\saveAnswerSpecificDataToDb(), assKprimChoice\saveAnswerSpecificDataToDb(), assTextSubset\saveAnswerSpecificDataToDb(), assMultipleChoice\saveAnswerSpecificDataToDb(), assClozeTest\saveClozeNumericGapRecordToDb(), assClozeTest\saveClozeSelectGapRecordToDb(), assClozeTest\saveClozeTextGapRecordToDb(), assFormulaQuestion\saveCurrentSolution(), saveCurrentSolution(), assSingleChoice\savePreviewData(), saveQuestionDataToDb(), assFormulaQuestion\saveToDb(), saveToDb(), assFormulaQuestion\saveWorkingData(), assFormulaQuestion\setId(), assOrderingQuestion\setOrderingElementList(), syncWithOriginal(), assOrderingHorizontal\toJSON(), assTextQuestion\toJSON(), assTextSubset\toJSON(), assMultipleChoice\toJSON(), assSingleChoice\toJSON(), assLongMenu\toJSON(), assKprimChoice\toJSON(), assErrorText\toJSON(), assOrderingQuestion\toJSON(), assMatchingQuestion\toJSON(), assClozeTest\toJSON(), updateCurrentSolutionsAuthorization(), ilLOTestQuestionAdapter\updateQuestionResult(), and updateTimestamp().

                           : int
    {
        return $this->id;
    }

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 678 of file class.assQuestion.php.

References $id, $obj_id, and null.

Referenced by assOrderingQuestion\buildOrderingImagesFormDataConverter(), assOrderingQuestion\cleanImagefiles(), assOrderingQuestion\cloneImages(), assMatchingQuestion\cloneImages(), assImagemapQuestion\copyImagemapFiles(), assMatchingQuestion\deleteImagefile(), assOrderingQuestion\dropImageFile(), assOrderingQuestion\ensureImagePathExists(), assKprimChoice\handleFileUpload(), assOrderingQuestion\isImageFileStored(), assKprimChoice\loadAnswerData(), assSingleChoice\loadFromDb(), assMultipleChoice\loadFromDb(), assOrderingQuestion\rebuildThumbnails(), assMatchingQuestion\rebuildThumbnails(), assSingleChoice\saveAdditionalQuestionDataToDb(), assMultipleChoice\saveAdditionalQuestionDataToDb(), assMultipleChoice\setImageFile(), assSingleChoice\setImageFile(), assMatchingQuestion\setImageFile(), assImagemapQuestion\setImageFilename(), assOrderingQuestion\storeImageFile(), and assOrderingQuestion\updateImageFile().

                                                                        : 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);
    }

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 707 of file class.assQuestion.php.

References $export_image_path, CLIENT_WEB_DIR, and ilFileUtils\removeTrailingPathSeparators().

Referenced by assOrderingQuestion\buildNestedOrderingElementInputGui(), assOrderingQuestion\buildNestedOrderingFormDataConverter(), assOrderingQuestion\buildOrderingImagesFormDataConverter(), assKprimChoice\loadAnswerData(), assMultipleChoice\toJSON(), assSingleChoice\toJSON(), assKprimChoice\toJSON(), and assOrderingQuestion\toJSON().

                                     : 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;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getInstances()

assQuestion::getInstances

(

)

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

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

                                  : 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;
    }

Here is the call graph for this function:

getInternalLinkHref()

assQuestion::getInternalLinkHref

(

string

$target

)

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

Referenced by getSuggestedSolutionOutput().

                                                       : 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;
    }

Here is the caller graph for this function:

getLastChange()

assQuestion::getLastChange

(

)

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

References $lastChange.

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

getLifecycle()

assQuestion::getLifecycle

(

)

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

References $lifecycle.

Referenced by saveToDb().

                                  : ilAssQuestionLifecycle
    {
        return $this->lifecycle;
    }

Here is the caller graph for this function:

getMaximumPoints()

assQuestion::getMaximumPoints

(

)

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

References $points.

Referenced by adjustReachedPointsByScoringOptions(), isPreviewSolutionCorrect(), and saveQuestionDataToDb().

                                      : float
    {
        return $this->points;
    }

Here is the caller graph for this function:

getMaximumThumbSize()

assQuestion::getMaximumThumbSize

(

)

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

                                         : int
    {
        return self::MAXIMUM_THUMB_SIZE;
    }

getMinimumThumbSize()

assQuestion::getMinimumThumbSize

(

)

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

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

                                         : int
    {
        return self::MINIMUM_THUMB_SIZE;
    }

Here is the caller graph for this function:

getNotesDataService()

assQuestion::getNotesDataService ( )

protected

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

References $service.

Referenced by duplicateComments().

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

Here is the caller graph for this function:

getNotesManager()

assQuestion::getNotesManager ( )

protected

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

References $service.

Referenced by deleteComments(), and duplicateComments().

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

Here is the caller graph for this function:

getNotesRepo()

assQuestion::getNotesRepo ( )

protected

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

References $service.

Referenced by deleteComments().

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

Here is the caller graph for this function:

getNrOfTries()

assQuestion::getNrOfTries

(

)

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

References $nr_of_tries.

Referenced by saveQuestionDataToDb(), assOrderingHorizontal\toJSON(), assTextQuestion\toJSON(), assTextSubset\toJSON(), assMultipleChoice\toJSON(), assSingleChoice\toJSON(), assLongMenu\toJSON(), assKprimChoice\toJSON(), assErrorText\toJSON(), assOrderingQuestion\toJSON(), assMatchingQuestion\toJSON(), and assClozeTest\toJSON().

                                  : int
    {
        return $this->nr_of_tries;
    }

Here is the caller graph for this function:

getNumExistingSolutionRecords()

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

staticprotected

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

References $DIC, $ilDB, and $res.

Referenced by isAnswered().

                                                                                                      : 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'];
    }

Here is the caller graph for this function:

getObjId()

assQuestion::getObjId

(

)

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

References $obj_id.

Referenced by assOrderingQuestion\cloneQuestionTypeSpecificProperties(), assSingleChoice\cloneQuestionTypeSpecificProperties(), assMultipleChoice\cloneQuestionTypeSpecificProperties(), assImagemapQuestion\cloneQuestionTypeSpecificProperties(), assMatchingQuestion\cloneQuestionTypeSpecificProperties(), assKprimChoice\cloneQuestionTypeSpecificProperties(), copyObject(), createNewOriginalFromThisDuplicate(), createNewQuestion(), createPageObject(), delete(), deleteComments(), deleteTaxonomyAssignments(), duplicate(), isWriteable(), saveQuestionDataToDb(), saveToDb(), and syncWithOriginal().

                              : int
    {
        return $this->obj_id;
    }

Here is the caller graph for this function:

getOriginalId()

assQuestion::getOriginalId

(

)

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

References $original_id.

Referenced by syncWithOriginal().

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

Here is the caller graph for this function:

getOwner()

assQuestion::getOwner

(

)

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

References $owner.

Referenced by saveQuestionDataToDb(), and saveToDb().

                              : int
    {
        return $this->owner;
    }

Here is the caller graph for this function:

getPageOfQuestion()

assQuestion::getPageOfQuestion

(

)

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

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

getPoints()

assQuestion::getPoints

(

)

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

References $points.

Referenced by assNumeric\calculateReachedPoints(), assFileUpload\calculateReachedPoints(), assFileUpload\calculateReachedPointsForSolution(), assOrderingHorizontal\calculateReachedPointsForSolution(), assKprimChoice\calculateReachedPointsForSolution(), assOrderingQuestion\calculateReachedPointsForSolution(), assNumeric\calculateReachedPointsFromPreviewSession(), assNumeric\getMaximumPoints(), assOrderingHorizontal\getMaximumPoints(), assFileUpload\getMaximumPoints(), assOrderingQuestion\getMaximumPoints(), assTextSubset\isAnswerCorrect(), assLongMenu\isComplete(), assNumeric\saveAnswerSpecificDataToDb(), assOrderingHorizontal\toJSON(), assOrderingQuestion\toJSON(), assNumeric\toLog(), assOrderingHorizontal\toLog(), assFileUpload\toLog(), and assOrderingQuestion\toLog().

                               : float
    {
        return $this->points;
    }

Here is the caller graph for this function:

getPreventRteUsage()

assQuestion::getPreventRteUsage

(

)

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

References $prevent_rte_usage.

                                        : bool
    {
        return $this->prevent_rte_usage;
    }

getProcessLocker()

assQuestion::getProcessLocker

(

)

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

References $processLocker.

Referenced by calculateResultsFromSolution(), persistWorkingState(), removeIntermediateSolution(), resetUsersAnswer(), assOrderingHorizontal\saveWorkingData(), assNumeric\saveWorkingData(), assErrorText\saveWorkingData(), assSingleChoice\saveWorkingData(), assTextSubset\saveWorkingData(), assKprimChoice\saveWorkingData(), assTextQuestion\saveWorkingData(), assMultipleChoice\saveWorkingData(), assFileUpload\saveWorkingData(), assLongMenu\saveWorkingData(), assOrderingQuestion\saveWorkingData(), assFormulaQuestion\saveWorkingData(), assMatchingQuestion\saveWorkingData(), and assClozeTest\saveWorkingData().

                                      : ilAssQuestionProcessLocker
    {
        return $this->processLocker;
    }

Here is the caller graph for this function:

getQuestion()

assQuestion::getQuestion

(

)

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

References $question.

Referenced by assFormulaQuestion\checkForDuplicateResults(), assFormulaQuestion\checkForDuplicateVariables(), assFormulaQuestion\getInitialVariableSolutionValues(), getRTETextWithMediaObjects(), assFormulaQuestion\hasRequiredVariableSolutionValues(), assOrderingQuestion\isComplete(), assFormulaQuestion\parseQuestionText(), saveQuestionDataToDb(), assFormulaQuestion\substituteVariables(), assOrderingHorizontal\toJSON(), assTextQuestion\toJSON(), assTextSubset\toJSON(), assMultipleChoice\toJSON(), assSingleChoice\toJSON(), assLongMenu\toJSON(), assKprimChoice\toJSON(), assErrorText\toJSON(), assOrderingQuestion\toJSON(), assMatchingQuestion\toJSON(), assClozeTest\toJSON(), assNumeric\toLog(), assOrderingHorizontal\toLog(), assTextSubset\toLog(), assLongMenu\toLog(), assTextQuestion\toLog(), assKprimChoice\toLog(), assMultipleChoice\toLog(), assSingleChoice\toLog(), assFileUpload\toLog(), assErrorText\toLog(), assOrderingQuestion\toLog(), assFormulaQuestion\toLog(), assMatchingQuestion\toLog(), and assClozeTest\toLog().

                                 : string
    {
        return $this->question;
    }

Here is the caller graph for this function:

getQuestionAction()

assQuestion::getQuestionAction ( )

protected

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

Referenced by assFileUpload\isFileDeletionAction().

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

Here is the caller graph for this function:

getQuestionForHTMLOutput()

assQuestion::getQuestionForHTMLOutput

(

)

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

References purifyAndPrepareTextAreaOutput().

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

Here is the call graph for this function:

getQuestionType()

assQuestion::getQuestionType ( )

abstract

Referenced by fromXML(), getQuestionTypeID(), and toXML().

Here is the caller graph for this function:

getQuestionTypeID()

assQuestion::getQuestionTypeID

(

)

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

References getQuestionType().

Referenced by createNewQuestion(), and saveQuestionDataToDb().

                                       : 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;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getReachedPoints()

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

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

References getId().

Referenced by answerToLog(), and ilLOTestQuestionAdapter\updateQuestionResult().

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

Here is the call graph for this function:

Here is the caller graph for this function:

getRTETextWithMediaObjects()

assQuestion::getRTETextWithMediaObjects ( )

protected

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

References getId(), and getQuestion().

Referenced by cleanupMediaObjectUsage().

                                                   : 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;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getSelfAssessmentEditingMode()

assQuestion::getSelfAssessmentEditingMode

(

)

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

References $selfassessmenteditingmode.

Referenced by ilAssQuestionAuthoringFormGUI\addGenericAssessmentQuestionCommandButtons().

                                                  : bool
    {
        return $this->selfassessmenteditingmode;
    }

Here is the caller graph for this function:

getSelfAssessmentFormatter()

assQuestion::getSelfAssessmentFormatter ( )

protected

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

Referenced by formatSAQuestion().

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

Here is the caller graph for this function:

getShuffle()

assQuestion::getShuffle

(

)

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

References $shuffle.

Referenced by assSingleChoice\saveAdditionalQuestionDataToDb(), assMultipleChoice\saveAdditionalQuestionDataToDb(), assTextQuestion\toJSON(), assMultipleChoice\toJSON(), assSingleChoice\toJSON(), assLongMenu\toJSON(), assErrorText\toJSON(), assClozeTest\toJSON(), assNumeric\toLog(), assLongMenu\toLog(), assKprimChoice\toLog(), assMultipleChoice\toLog(), assSingleChoice\toLog(), assErrorText\toLog(), assMatchingQuestion\toLog(), and assClozeTest\toLog().

                                : bool
    {
        return $this->shuffle;
    }

Here is the caller graph for this function:

getShuffler()

assQuestion::getShuffler

(

)

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

References $shuffler.

Referenced by assOrderingHorizontal\getRandomOrderingElements(), assOrderingQuestion\getShuffledOrderingElementList(), assOrderingQuestion\toJSON(), and assMatchingQuestion\toJSON().

                                 : Transformation
    {
        return $this->shuffler;
    }

Here is the caller graph for this function:

getSolutionForTextOutput()

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

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

References getSolutionValues(), and solutionValuesToText().

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

Here is the call graph for this function:

getSolutionMaxPass()

assQuestion::getSolutionMaxPass

(

int

$active_id

)

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

References getId().

Referenced by assOrderingHorizontal\calculateReachedPoints(), assNumeric\calculateReachedPoints(), assFileUpload\calculateReachedPoints(), assErrorText\calculateReachedPoints(), assSingleChoice\calculateReachedPoints(), assTextSubset\calculateReachedPoints(), assMultipleChoice\calculateReachedPoints(), assTextQuestion\calculateReachedPoints(), assKprimChoice\calculateReachedPoints(), assOrderingQuestion\calculateReachedPoints(), assLongMenu\calculateReachedPoints(), assMatchingQuestion\calculateReachedPoints(), assFormulaQuestion\calculateReachedPoints(), assClozeTest\fetchUserResult(), getSolutionValues(), and assFileUpload\getUploadedFiles().

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

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 2406 of file class.assQuestion.php.

Referenced by assFileUpload\saveWorkingData().

                                                             : 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 [];
    }

Here is the caller graph for this function:

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 746 of file class.assQuestion.php.

References getId(), getSolutionMaxPass(), getStep(), and null.

Referenced by answerToLog(), assOrderingQuestion\calculateReachedPoints(), assFormulaQuestion\calculateReachedPoints(), deleteDummySolutionRecord(), duplicateIntermediateSolutionAuthorized(), forceExistingIntermediateSolution(), assFormulaQuestion\getCorrectSolutionForTextOutput(), getCorrectSolutionForTextOutput(), assOrderingQuestion\getOrderingElementListForSolutionOutput(), getSolutionForTextOutput(), ilTestCorrectionsGUI\getSolutions(), ilTestCorrectionsGUI\getSolutionsByParticipantResults(), getTestOutputSolutions(), assFileUpload\getUploadedFilesForWeb(), assFileUpload\getUserSolutionPreferingIntermediate(), and getUserSolutionPreferingIntermediate().

     : 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;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getStep()

assQuestion::getStep

(

)

Returns

int|null

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

References $step.

Referenced by calculateResultsFromSolution(), deleteSolutionRecordByValues(), getCurrentSolutionResultSet(), getSolutionValues(), assFileUpload\getUploadedFilesForWeb(), assLongMenu\lookupForExistingSolutions(), assFormulaQuestion\lookupForExistingSolutions(), lookupForExistingSolutions(), removeCurrentSolution(), assFormulaQuestion\removeExistingSolutions(), removeExistingSolutions(), removeResultRecord(), saveCurrentSolution(), assFormulaQuestion\saveWorkingData(), updateCurrentSolution(), and updateCurrentSolutionsAuthorization().

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

Here is the caller graph for this function:

getSuggestedSolution()

assQuestion::getSuggestedSolution

(

int

$subquestion_index = 0

)

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

References null.

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

getSuggestedSolutionOutput()

assQuestion::getSuggestedSolutionOutput

(

)

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

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

                                                : 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->getSuggestedSolutionPathWeb() . $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);
    }

Here is the call graph for this function:

getSuggestedSolutionPath()

assQuestion::getSuggestedSolutionPath

(

)

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

References CLIENT_WEB_DIR.

Referenced by cloneSuggestedSolutionFiles(), deleteSuggestedSolutions(), and duplicateSuggestedSolutionFiles().

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

Here is the caller graph for this function:

getSuggestedSolutionPathWeb()

assQuestion::getSuggestedSolutionPathWeb

(

)

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

References CLIENT_WEB_DIR, and ilFileUtils\removeTrailingPathSeparators().

Referenced by getSuggestedSolutionOutput().

                                                 : 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
        );
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getSuggestedSolutions()

assQuestion::getSuggestedSolutions

(

)

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

References $suggested_solutions.

Referenced by copySuggestedSolutions().

                                           : array
    {
        return $this->suggested_solutions;
    }

Here is the caller graph for this function:

getSuggestedSolutionsRepo()

assQuestion::getSuggestedSolutionsRepo ( )

protected

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

References $suggestedsolution_repo.

Referenced by cloneSuggestedSolutions(), copySuggestedSolutions(), delete(), deleteSuggestedSolutions(), and loadSuggestedSolutions().

                                                  : SuggestedSolutionsDatabaseRepository
    {
        return $this->suggestedsolution_repo;
    }

Here is the caller graph for this function:

getTestId()

assQuestion::getTestId

(

)

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

References $test_id.

Referenced by resetUsersAnswer().

                               : int
    {
        return $this->test_id;
    }

Here is the caller graph for this function:

getTestOutputSolutions()

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

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

References getSolutionValues(), getTestPresentationConfig(), and getUserSolutionPreferingIntermediate().

Referenced by assOrderingQuestion\getSolutionOrderingElementListForTestOutput().

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

Here is the call graph for this function:

Here is the caller graph for this function:

getTestPresentationConfig()

assQuestion::getTestPresentationConfig

(

)

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

References $test_question_config, buildTestPresentationConfig(), and null.

Referenced by getTestOutputSolutions(), ilTestPlayerAbstractGUI\initTestQuestionConfig(), and assFileUpload\isFileReuseHandlingRequired().

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

        return $this->test_question_config;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getThumbSize()

assQuestion::getThumbSize

(

)

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

References $thumb_size.

Referenced by assOrderingQuestion\generateThumbForFile(), assSingleChoice\saveAdditionalQuestionDataToDb(), assMultipleChoice\saveAdditionalQuestionDataToDb(), assOrderingQuestion\saveAdditionalQuestionDataToDb(), assOrderingQuestion\setContentType(), assMultipleChoice\setImageFile(), assSingleChoice\setImageFile(), assOrderingQuestion\storeImageFile(), assMultipleChoice\toJSON(), assSingleChoice\toJSON(), and assOrderingQuestion\updateImageFile().

                                  : int
    {
        return $this->thumb_size;
    }

Here is the caller graph for this function:

getTitle()

assQuestion::getTitle

(

)

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

References $title.

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

                              : string
    {
        return $this->title;
    }

Here is the caller graph for this function:

getTitleFilenameCompliant()

assQuestion::getTitleFilenameCompliant

(

)

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

References ilFileUtils\getASCIIFilename(), and getTitle().

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

Here is the call graph for this function:

getTitleForHTMLOutput()

assQuestion::getTitleForHTMLOutput

(

)

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

References ILIAS\Repository\refinery().

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

getTotalAnswers()

assQuestion::getTotalAnswers

(

)

Definition at line 970 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
	)

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

References getSolutionValues().

Referenced by getTestOutputSolutions().

     : array {
        $solution = $this->getSolutionValues($active_id, $pass, false);

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

        return $solution;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getValidAdditionalContentEditingModes()

assQuestion::getValidAdditionalContentEditingModes

(

)

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

Referenced by isValidAdditionalContentEditingMode(), and setAdditionalContentEditingMode().

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

Here is the caller graph for this function:

getVariablesAsTextArray()

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

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

     : array {
        return [];
    }

hasSpecificFeedback()

assQuestion::hasSpecificFeedback

(

)

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

                                         : bool
    {
        return static::HAS_SPECIFIC_FEEDBACK;
    }

hasWritableOriginalInQuestionPool()

assQuestion::hasWritableOriginalInQuestionPool

(

)

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

References instantiateQuestion().

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

Here is the call graph for this function:

implodeKeyValues()

static assQuestion::implodeKeyValues ( array  $keyValues )

static

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

References KEY_VALUES_IMPLOSION_SEPARATOR.

Referenced by assImagemapQuestionGUI\buildSelectionParameter().

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

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 1736 of file class.assQuestion.php.

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

Referenced by ilObjTest\_instanciateQuestion(), ILIAS\Test\ExportImport\ResultsExportExcel\addUserContent(), ilTestFixedQuestionSetConfig\cloneQuestionSetRelatedData(), ilObjTestGUI\copyAndLinkQuestionsToPoolObject(), ilPCQuestion\copyPoolQuestionIntoPage(), ilObjQuestionPool\deleteQuestion(), ilTestResultsToXML\exportTestResults(), 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().

                                                                : 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;
    }

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 2659 of file class.assQuestion.php.

References lookupForExistingSolutions().

Referenced by assFileUpload\saveWorkingData().

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

Here is the call graph for this function:

Here is the caller graph for this function:

isAddableAnswerOptionValue()

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

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

                                                                                      : bool
    {
        return false;
    }

isAdditionalContentEditingModePageObject()

assQuestion::isAdditionalContentEditingModePageObject

(

)

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

References ADDITIONAL_CONTENT_EDITING_MODE_IPE, and getAdditionalContentEditingMode().

Referenced by delete(), assClozeTest\getClozeTextForHTMLOutput(), and purifyAndPrepareTextAreaOutput().

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

Here is the call graph for this function:

Here is the caller graph for this function:

isAnswered()

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

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

References getId(), and getNumExistingSolutionRecords().

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

Here is the call graph for this function:

isComplete()

assQuestion::isComplete ( )

abstract

Referenced by saveQuestionDataToDb(), and saveToDb().

Here is the caller graph for this function:

isDummySolutionRecord()

assQuestion::isDummySolutionRecord ( array  $solutionRecord )

protected

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

Referenced by assFileUpload\calculateReachedPoints().

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

Here is the caller graph for this function:

isFileAvailable()

static assQuestion::isFileAvailable ( string  $file )

static

Definition at line 991 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 222 of file class.assQuestion.php.

                                                           : bool
    {
        return self::$force_pass_results_update_enabled;
    }

isNonEmptyItemListPostSubmission()

assQuestion::isNonEmptyItemListPostSubmission ( string  $post_submission_field_name )

protected

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

Referenced by assFileUpload\isFileDeletionSubmitAvailable(), and assFileUpload\isFileReuseSubmitAvailable().

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

Here is the caller graph for this function:

isPreviewSolutionCorrect()

assQuestion::isPreviewSolutionCorrect

(

ilAssQuestionPreviewSession

$preview_session

)

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

References calculateReachedPointsFromPreviewSession(), and getMaximumPoints().

                                                                                          : bool
    {
        $reached_points = $this->calculateReachedPointsFromPreviewSession($preview_session);

        return !($reached_points < $this->getMaximumPoints());
    }

Here is the call graph for this function:

isValidAdditionalContentEditingMode()

assQuestion::isValidAdditionalContentEditingMode

(

string

$additionalContentEditingMode

)

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

References getValidAdditionalContentEditingModes().

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

        return false;
    }

Here is the call graph for this function:

isWriteable()

assQuestion::isWriteable

(

)

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

References ilObjQuestionPool\_isWriteable(), getCurrentUser(), getId(), and getObjId().

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

Here is the call graph for this function:

lmMigrateQuestionTypeGenericContent()

assQuestion::lmMigrateQuestionTypeGenericContent ( ilAssSelfAssessmentMigrator  $migrator )

protected

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

References ilAssSelfAssessmentMigrator\migrateToLmContent(), and setQuestion().

Referenced by migrateContentForLearningModule().

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

Here is the call graph for this function:

Here is the caller graph for this function:

lmMigrateQuestionTypeSpecificContent()

assQuestion::lmMigrateQuestionTypeSpecificContent ( ilAssSelfAssessmentMigrator  $migrator )

protected

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

Referenced by migrateContentForLearningModule().

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

Here is the caller graph for this function:

loadFromDb()

assQuestion::loadFromDb

(

int

$question_id

)

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

References $data, and loadSuggestedSolutions().

                                                : 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;
            }
        }
    }

Here is the call graph for this function:

loadSuggestedSolutions()

assQuestion::loadSuggestedSolutions ( )

protected

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

References getId(), and getSuggestedSolutionsRepo().

Referenced by loadFromDb().

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

Here is the call graph for this function:

Here is the caller 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]

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

References getId(), getStep(), and null.

Referenced by authorizedOrIntermediateSolutionExists(), authorizedSolutionExists(), calculateResultsFromSolution(), and intermediateSolutionExists().

                                                                        : 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;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

lookupMaxStep()

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

protected

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

References getId().

Referenced by assNumeric\getUserQuestionResult(), assOrderingHorizontal\getUserQuestionResult(), assTextSubset\getUserQuestionResult(), assSingleChoice\getUserQuestionResult(), assMultipleChoice\getUserQuestionResult(), assOrderingQuestion\getUserQuestionResult(), assFormulaQuestion\getUserQuestionResult(), assMatchingQuestion\getUserQuestionResult(), and assClozeTest\getUserQuestionResult().

                                                               : 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'];
    }

Here is the call graph for this function:

Here is the caller graph for this function:

lookupParentObjId()

static assQuestion::lookupParentObjId ( int  $question_id )

static

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

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

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

                                                              : ?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;
    }

Here is the caller graph for this function:

migrateContentForLearningModule()

assQuestion::migrateContentForLearningModule

(

ilAssSelfAssessmentMigrator

$migrator

)

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

References getId(), lmMigrateQuestionTypeGenericContent(), lmMigrateQuestionTypeSpecificContent(), and saveToDb().

Referenced by ilAssSelfAssessmentQuestionFormatter\prepareQuestionForLearningModule().

                                                                                          : void
    {
        $this->lmMigrateQuestionTypeGenericContent($migrator);
        $this->lmMigrateQuestionTypeSpecificContent($migrator);
        $this->saveToDb();

        $this->feedbackOBJ->migrateContentForLearningModule($migrator, $this->getId());
    }

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 1427 of file class.assQuestion.php.

References copySuggestedSolutions(), duplicateComments(), duplicateSkillAssignments(), and duplicateSuggestedSolutionFiles().

                                                                                                                     : 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);
    }

Here is the call graph for this function:

onDuplicate()

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

protected

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

References cloneSuggestedSolutionFiles(), copySuggestedSolutions(), duplicateComments(), and duplicateSkillAssignments().

     : 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);
    }

Here is the call graph for this function:

persistPreviewState()

assQuestion::persistPreviewState ( ilAssQuestionPreviewSession  $preview_session )

final

persists the preview state for current user and question

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

References savePreviewData(), and validateSolutionSubmit().

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

Here is the call graph for this function:

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 623 of file class.assQuestion.php.

References ilObjTest\_getPass(), calculateResultsFromSolution(), getProcessLocker(), null, removeIntermediateSolution(), saveWorkingData(), and validateSolutionSubmit().

Referenced by ilTestPlayerAbstractGUI\save().

                                                                                             : 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;
    }

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 1939 of file class.assQuestion.php.

References getHtmlQuestionContentPurifier(), isAdditionalContentEditingModePageObject(), and ilLegacyFormElementsUtil\prepareTextareaOutput().

Referenced by getQuestionForHTMLOutput(), and assFormulaQuestion\substituteVariables().

                                                                      : 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
        );
    }

Here is the call graph for this function:

Here is the caller graph for this function:

removeAllExistingSolutions()

assQuestion::removeAllExistingSolutions

(

)

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

References getId().

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

Here is the call graph for this function:

removeAllImageFiles()

assQuestion::removeAllImageFiles ( string  $image_target_path )

protected

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

Referenced by assOrderingQuestion\cloneImages(), assMatchingQuestion\cloneImages(), and assImagemapQuestion\copyImagemapFiles().

                                                                     : 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
            );
        }
    }

Here is the caller graph for this function:

removeCurrentSolution()

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

Returns

int Affected rows

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

References getId(), getStep(), and null.

Referenced by removeIntermediateSolution(), assOrderingHorizontal\saveWorkingData(), assErrorText\saveWorkingData(), assTextSubset\saveWorkingData(), assKprimChoice\saveWorkingData(), assTextQuestion\saveWorkingData(), assMultipleChoice\saveWorkingData(), assLongMenu\saveWorkingData(), assFileUpload\saveWorkingData(), assOrderingQuestion\saveWorkingData(), assMatchingQuestion\saveWorkingData(), and assClozeTest\saveWorkingData().

                                                                                             : 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]
        );
    }

Here is the call graph for this function:

Here is the caller graph for this function:

removeExistingSolutions()

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

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

References getId(), getStep(), and null.

Referenced by resetUsersAnswer().

                                                                     : 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]
        );
    }

Here is the call graph for this function:

Here is the caller graph for this function:

removeIntermediateSolution()

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

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

References getProcessLocker(), and removeCurrentSolution().

Referenced by persistWorkingState().

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

Here is the call graph for this function:

Here is the caller graph for this function:

removeResultRecord()

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

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

References getId(), getStep(), and null.

Referenced by resetUsersAnswer().

                                                                : 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]
        );
    }

Here is the call graph for this function:

Here is the caller graph for this function:

removeSolutionRecordById()

assQuestion::removeSolutionRecordById ( int  $solutionId )

protected

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

Referenced by deleteDummySolutionRecord(), assNumeric\saveWorkingData(), and assSingleChoice\saveWorkingData().

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

Here is the caller graph for this function:

resetOriginalId()

static assQuestion::resetOriginalId ( int  $questionId )

static

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

References $DIC, and $ilDB.

Referenced by ilTestRandomQuestionSetPoolDeriver\updateTestQuestionStage().

                                                           : 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]
        );
    }

Here is the caller graph for this function:

resetUsersAnswer()

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

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

References getProcessLocker(), getTestId(), removeExistingSolutions(), and removeResultRecord().

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

Here is the call graph for this function:

resolveInternalLink()

assQuestion::resolveInternalLink

(

string

$internal_link

)

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

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

Referenced by resolveSuggestedSolutionLinks().

                                                              : 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;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

resolveSuggestedSolutionLinks()

assQuestion::resolveSuggestedSolutionLinks

(

)

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

References ilInternalLink\_deleteAllLinksOfSource(), ilInternalLink\_saveLink(), getId(), and resolveInternalLink().

                                                   : 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]);
            }
        }
    }

Here is the call graph for this function:

saveCurrentSolution()

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

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

References getId(), getStep(), ILIAS\Repository\int(), and null.

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

                                                                                                                          : 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);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

saveOriginalId()

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

static

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

References $DIC, and $ilDB.

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

                                                                           : 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]
        );
    }

Here is the caller graph for this function:

savePreviewData()

assQuestion::savePreviewData ( ilAssQuestionPreviewSession  $preview_session )

protected

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

References ilAssQuestionPreviewSession\setParticipantsSolution().

Referenced by persistPreviewState().

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

Here is the call graph for this function:

Here is the caller graph for this function:

saveQuestionDataToDb()

assQuestion::saveQuestionDataToDb

(

?int

$original_id = null

)

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

References ilRTE\_replaceMediaObjectImageSrc(), createPageObject(), getAdditionalContentEditingMode(), getAuthor(), getComment(), getExternalId(), getId(), getMaximumPoints(), getNrOfTries(), getObjId(), getOwner(), getQuestion(), getQuestionTypeID(), getTitle(), isComplete(), and setId().

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

                                                                  : 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()]
        ]);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

saveToDb()

assQuestion::saveToDb

(

?int

$original_id = null

)

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

References ilObjQuestionPool\_updateQuestionCount(), cleanupMediaObjectUsage(), getId(), getLifecycle(), getObjId(), getOwner(), and isComplete().

Referenced by assOrderingQuestion\cloneQuestionTypeSpecificProperties(), and migrateContentForLearningModule().

                                                      : 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());
    }

Here is the call graph for this function:

Here is the caller graph for this function:

saveWorkingData()

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

abstract

Referenced by persistWorkingState().

Here is the caller graph for this function:

setAdditionalContentEditingMode()

assQuestion::setAdditionalContentEditingMode

(

?string

$additionalContentEditingMode

)

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

References $additionalContentEditingMode, and getValidAdditionalContentEditingModes().

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

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

        $this->additionalContentEditingMode = $additionalContentEditingMode;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

setAuthor()

assQuestion::setAuthor

(

string

$author = ""

)

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

References $author.

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

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

Here is the caller graph for this function:

setComment()

assQuestion::setComment

(

string

$comment = ""

)

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

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

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

setDefaultNrOfTries()

assQuestion::setDefaultNrOfTries

(

int

$defaultnroftries

)

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

References $defaultnroftries.

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

setExportImagePath()

assQuestion::setExportImagePath

(

string

$path

)

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

References $path.

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

setExternalId()

assQuestion::setExternalId

(

?string

$external_id

)

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

References $external_id.

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

setForcePassResultUpdateEnabled()

static assQuestion::setForcePassResultUpdateEnabled ( bool  $force_pass_results_update_enabled )

static

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

References $force_pass_results_update_enabled.

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

setId()

assQuestion::setId

(

int

$id = -1

)

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

References $id.

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

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

Here is the caller graph for this function:

setLastChange()

assQuestion::setLastChange

(

int

$lastChange

)

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

References $lastChange.

Referenced by assKprimChoice\loadFromDb().

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

Here is the caller graph for this function:

setLifecycle()

assQuestion::setLifecycle

(

ilAssQuestionLifecycle

$lifecycle

)

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

References $lifecycle.

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

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

Here is the caller graph for this function:

setNrOfTries()

assQuestion::setNrOfTries

(

int

$a_nr_of_tries

)

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

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

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

Here is the caller graph for this function:

setObjId()

assQuestion::setObjId

(

int

$obj_id = 0

)

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

References $obj_id.

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

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

Here is the caller graph for this function:

setOriginalId()

assQuestion::setOriginalId

(

?int

$original_id

)

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

References $original_id.

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

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

Here is the caller graph for this function:

setOwner()

assQuestion::setOwner

(

int

$owner = -1

)

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

References $owner.

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

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

Here is the caller graph for this function:

setPoints()

assQuestion::setPoints

(

float

$points

)

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

References $points.

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

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

Here is the caller graph for this function:

setPreventRteUsage()

assQuestion::setPreventRteUsage

(

bool

$prevent_rte_usage

)

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

References $prevent_rte_usage.

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

setProcessLocker()

assQuestion::setProcessLocker

(

ilAssQuestionProcessLocker

$processLocker

)

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

References $processLocker.

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

setQuestion()

assQuestion::setQuestion

(

string

$question = ""

)

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

References $question.

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

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

Here is the caller graph for this function:

setSelfAssessmentEditingMode()

assQuestion::setSelfAssessmentEditingMode

(

bool

$selfassessmenteditingmode

)

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

References $selfassessmenteditingmode.

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

setShuffle()

assQuestion::setShuffle

(

?bool

$shuffle = true

)

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

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

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

Here is the caller graph for this function:

setShuffler()

assQuestion::setShuffler

(

Transformation

$shuffler

)

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

References $shuffler.

Referenced by assMatchingQuestion\toJSON().

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

Here is the caller graph for this function:

setStep()

assQuestion::setStep

(

$step

)

Parameters

int | null

$step

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

References $step.

Referenced by assFileUpload\getUploadedFilesForWeb().

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

Here is the caller graph for this function:

setTestId()

assQuestion::setTestId

(

int

$id = -1

)

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

References $id.

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

setThumbSize()

assQuestion::setThumbSize

(

int

$a_size

)

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

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

                                             : 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");
        }
    }

Here is the caller graph for this function:

setTitle()

assQuestion::setTitle

(

string

$title = ""

)

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

References $title.

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

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

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.

Referenced by answerToLog().

Here is the caller graph for this function:

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.

Referenced by getCorrectSolutionForTextOutput(), and getSolutionForTextOutput().

Here is the caller graph for this function:

syncSkillAssignments()

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

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

References duplicateSkillAssignments().

                                                                                                                    : 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);
    }

Here is the call graph for this function:

syncWithOriginal()

assQuestion::syncWithOriginal

(

)

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

References afterSyncWithOriginal(), cloneQuestionTypeSpecificProperties(), cloneSuggestedSolutions(), cloneXHTMLMediaObjectsOfQuestion(), getId(), getObjId(), getOriginalId(), and null.

                                      : 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());
    }

Here is the call graph for this function:

toJSON()

assQuestion::toJSON

(

)

Definition at line 2653 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.

Referenced by toQuestionAdministrationInteraction().

Here is the caller 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 2898 of file class.assQuestion.php.

References toLog().

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

Here is the call graph for this function:

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

Returns a QTI xml representation of the question.

Returns

string The QTI xml representation of the question

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

References getQuestionType().

     : 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);
    }

Here is the call graph for this function:

updateCurrentSolution()

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

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

References getStep(), ILIAS\Repository\int(), and null.

Referenced by assNumeric\saveWorkingData(), and assSingleChoice\saveWorkingData().

                                                                                                     : 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]
        ]);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

updateCurrentSolutionsAuthorization()

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

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

References getId(), getStep(), ILIAS\Repository\int(), and null.

Referenced by forceExistingIntermediateSolution(), and assFileUpload\saveWorkingData().

                                                                                                                           : 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);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

updateTimestamp()

assQuestion::updateTimestamp

(

)

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

References getId().

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

Here is the call graph for this function:

validateSolutionSubmit()

assQuestion::validateSolutionSubmit

(

)

Implements ILIAS\TestQuestionPool\Questions\Question.

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

Referenced by persistPreviewState(), and persistWorkingState().

                                            : bool
    {
        return true;
    }

Here is the caller graph for this function:

Field Documentation

$additionalContentEditingMode

string assQuestion::$additionalContentEditingMode = ''

private

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

Referenced by getAdditionalContentEditingMode(), and setAdditionalContentEditingMode().

$author

string assQuestion::$author

protected

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

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

$comment

string assQuestion::$comment

protected

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

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

$current_user

ilObjUser assQuestion::$current_user

protected

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

Referenced by getCurrentUser().

$db

ilDBInterface assQuestion::$db

protected

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

$defaultnroftries

int assQuestion::$defaultnroftries = 0

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

Referenced by getDefaultNrOfTries(), and setDefaultNrOfTries().

$dic

Container assQuestion::$dic

protected

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

$export_image_path

string assQuestion::$export_image_path

private

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

Referenced by getImagePathWeb().

$external_id

string assQuestion::$external_id = null

protected

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

Referenced by getExternalId(), and setExternalId().

$feedbackOBJ

ilAssQuestionFeedback assQuestion::$feedbackOBJ

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

$force_pass_results_update_enabled

assQuestion::$force_pass_results_update_enabled = false

staticprotected

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

Referenced by setForcePassResultUpdateEnabled().

$http

HTTPServices assQuestion::$http

protected

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

$id

int assQuestion::$id

protected

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

Referenced by assFormulaQuestion\addResultUnits(), createNewOriginalFromThisDuplicate(), getId(), getImagePath(), setId(), assFormulaQuestion\setId(), setTestId(), assKprimChoice\solutionValuesToLog(), assMultipleChoice\solutionValuesToLog(), and assKprimChoice\solutionValuesToText().

$ilias

ILIAS assQuestion::$ilias

protected

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

$imageSourceFixReplaceMap

assQuestion::$imageSourceFixReplaceMap

staticprotected

Initial value:

= [
        'ok.svg' => 'ok.png'

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

$lastChange

int assQuestion::$lastChange = null

protected

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

Referenced by getLastChange(), and setLastChange().

$lifecycle

ilAssQuestionLifecycle assQuestion::$lifecycle

protected

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

Referenced by getLifecycle(), and setLifecycle().

$lng

ilLanguage assQuestion::$lng

protected

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

$log

LoggingServices assQuestion::$log

protected

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

$nr_of_tries

int assQuestion::$nr_of_tries

private

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

Referenced by getNrOfTries().

$obj_id

int assQuestion::$obj_id = 0

protected

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

Referenced by getImagePath(), getObjId(), and setObjId().

$original_id

int assQuestion::$original_id = null

protected

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

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

$owner

int assQuestion::$owner

protected

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

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

$page

ilAssQuestionPage assQuestion::$page

protected

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

$points

float assQuestion::$points = 0.0

protected

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

Referenced by _getReachedPoints(), assTextSubset\addAnswer(), assSingleChoice\addAnswer(), assMultipleChoice\addAnswer(), assTextQuestion\addAnswer(), assMatchingQuestion\addMatchingPair(), adjustReachedPointsByScoringOptions(), assClozeTest\calculateCombinationResult(), assOrderingHorizontal\calculateReachedPoints(), assNumeric\calculateReachedPoints(), assErrorText\calculateReachedPoints(), assSingleChoice\calculateReachedPoints(), assKprimChoice\calculateReachedPoints(), assMatchingQuestion\calculateReachedPoints(), assFormulaQuestion\calculateReachedPoints(), assTextQuestion\calculateReachedPointsForSolution(), assLongMenu\calculateReachedPointsForSolution(), assOrderingHorizontal\calculateReachedPointsForSolution(), assTextSubset\calculateReachedPointsForSolution(), assKprimChoice\calculateReachedPointsForSolution(), assMultipleChoice\calculateReachedPointsForSolution(), assMatchingQuestion\calculateReachedPointsForSolution(), assClozeTest\calculateReachedPointsForSolution(), assNumeric\calculateReachedPointsFromPreviewSession(), assSingleChoice\calculateReachedPointsFromPreviewSession(), assFormulaQuestion\calculateReachedPointsFromPreviewSession(), assLongMenu\checkQuestionCustomPart(), assMatchingQuestion\createMatchingPair(), ensureNonNegativePoints(), assClozeTest\getMaximumGapPoints(), assTextQuestion\getMaximumPoints(), assTextSubset\getMaximumPoints(), assLongMenu\getMaximumPoints(), assSingleChoice\getMaximumPoints(), getMaximumPoints(), assMatchingQuestion\getMaximumPoints(), assClozeTest\getMaximumPoints(), assFormulaQuestion\getMaximumPoints(), assTextQuestion\getMinimumPoints(), getPoints(), assLongMenu\getPointsForGap(), assErrorText\getPointsForSelectedPositions(), assNumeric\getUserQuestionResult(), assOrderingHorizontal\getUserQuestionResult(), assTextSubset\getUserQuestionResult(), assLongMenu\getUserQuestionResult(), assErrorText\getUserQuestionResult(), assSingleChoice\getUserQuestionResult(), assMultipleChoice\getUserQuestionResult(), assOrderingQuestion\getUserQuestionResult(), assFormulaQuestion\getUserQuestionResult(), assMatchingQuestion\getUserQuestionResult(), assClozeTest\getUserQuestionResult(), assMatchingQuestion\insertMatchingPair(), assLongMenu\saveAnswerSpecificDataToDb(), assErrorText\setErrorsFromParsedErrorText(), assClozeTest\setGapAnswerPoints(), and setPoints().

$prevent_rte_usage

bool assQuestion::$prevent_rte_usage = false

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

Referenced by getPreventRteUsage(), and setPreventRteUsage().

$processLocker

ilAssQuestionProcessLocker assQuestion::$processLocker

protected

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

Referenced by getProcessLocker(), and setProcessLocker().

$question

string assQuestion::$question

protected

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

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

$question_files

QuestionFiles assQuestion::$question_files

protected

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

$questionActionCmd

string assQuestion::$questionActionCmd = 'handleQuestionAction'

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

$questionpool_request

RequestDataCollector assQuestion::$questionpool_request

protected

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

$questionrepository

GeneralQuestionPropertiesRepository assQuestion::$questionrepository

protected

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

$refinery

Refinery assQuestion::$refinery

protected

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

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

$selfassessmenteditingmode

bool assQuestion::$selfassessmenteditingmode = false

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

Referenced by getSelfAssessmentEditingMode(), and setSelfAssessmentEditingMode().

$shuffle

bool assQuestion::$shuffle = true

protected

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

Referenced by getShuffle(), assSingleChoice\loadFromDb(), assMultipleChoice\loadFromDb(), assClozeTest\setGapShuffle(), assMatchingQuestion\setShuffle(), and assMatchingQuestion\setShuffleMode().

$shuffler

Transformation assQuestion::$shuffler

protected

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

Referenced by getShuffler(), and setShuffler().

$skillUsageService

SkillUsageService assQuestion::$skillUsageService

protected

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

$step

int assQuestion::$step = null

protected

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

Referenced by getStep(), assFileUpload\getUploadedFilesForWeb(), and setStep().

$suggested_solutions

array assQuestion::$suggested_solutions

protected

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

Referenced by getSuggestedSolutions().

$suggestedsolution_repo

SuggestedSolutionsDatabaseRepository assQuestion::$suggestedsolution_repo

protected

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

Referenced by getSuggestedSolutionsRepo().

$test_id

int assQuestion::$test_id

protected

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

Referenced by getTestId(), assFileUpload\getUploadedFilesForWeb(), assFileUpload\removeIntermediateSolution(), and assFileUpload\saveWorkingData().

$test_question_config

ilTestQuestionConfig assQuestion::$test_question_config = null

private

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

Referenced by getTestPresentationConfig().

$test_result_repository

TestResultRepository assQuestion::$test_result_repository

protected

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

$testQuestionConfig

ilTestQuestionConfig assQuestion::$testQuestionConfig

protected

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

$thumb_size

int assQuestion::$thumb_size

protected

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

Referenced by getThumbSize().

$title

string assQuestion::$title

protected

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

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

$tpl

ilGlobalPageTemplate assQuestion::$tpl

protected

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

ADDITIONAL_CONTENT_EDITING_MODE_IPE

const assQuestion::ADDITIONAL_CONTENT_EDITING_MODE_IPE = 'pageobject'

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

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

ADDITIONAL_CONTENT_EDITING_MODE_RTE

const assQuestion::ADDITIONAL_CONTENT_EDITING_MODE_RTE = 'default'

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

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

DEFAULT_THUMB_SIZE

const assQuestion::DEFAULT_THUMB_SIZE = 150

private

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

HAS_SPECIFIC_FEEDBACK

const assQuestion::HAS_SPECIFIC_FEEDBACK = true

protected

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

KEY_VALUES_IMPLOSION_SEPARATOR

const assQuestion::KEY_VALUES_IMPLOSION_SEPARATOR = ':'

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

Referenced by explodeKeyValues(), and implodeKeyValues().

MAXIMUM_THUMB_SIZE

const assQuestion::MAXIMUM_THUMB_SIZE = 8192

private

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

MINIMUM_THUMB_SIZE

const assQuestion::MINIMUM_THUMB_SIZE = 20

private

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

TRIM_PATTERN

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

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

---

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

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