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 ()
	fixSvgToPng (string $imageFilenameContainingString)
	fixUnavailableSkinImageSources (string $html)
	loadFromDb (int $question_id)
	createNewQuestion (bool $a_create_page=true)
	Creates a new question without an owner when a new question is created This assures that an ID is given to the question if a file upload or something else occurs. More...
	saveQuestionDataToDb (?int $original_id=null)
	duplicate (bool $for_test=true, string $title='', string $author='', int $owner=-1, $test_obj_id=null)
	copyObject (int $target_parent_id, string $title='')
	createNewOriginalFromThisDuplicate (int $target_parent_id, string $target_question_title='')
	saveToDb (?int $original_id=null)
	deleteSuggestedSolutions ()
	getSuggestedSolution (int $subquestion_index=0)
	resolveInternalLink (string $internal_link)
	resolveSuggestedSolutionLinks ()
	getInternalLinkHref (string $target)
	syncWithOriginal ()
	getPoints ()
	setPoints (float $points)
	getSolutionMaxPass (int $active_id)
	isWriteable ()
	calculateReachedPointsFromPreviewSession (ilAssQuestionPreviewSession $preview_session)
	isPreviewSolutionCorrect (ilAssQuestionPreviewSession $preview_session)
	adjustReachedPointsByScoringOptions (float $points, int $active_id)
	Adjust the given reached points by checks for all special scoring options in the test container. More...
	buildHashedImageFilename (string $plain_image_filename, bool $unique=false)
	getQuestion ()
	getQuestionForHTMLOutput ()
	setQuestion (string $question="")
	getQuestionTypeID ()
	cleanupMediaObjectUsage ()
	getInstances ()
	getActiveUserData (int $active_id)
	Returns the user id and the test id for a given active id. More...
	hasSpecificFeedback ()
	getNrOfTries ()
	setNrOfTries (int $a_nr_of_tries)
	setExportImagePath (string $path)
	formatSAQuestion ($a_q)
	setPreventRteUsage (bool $prevent_rte_usage)
	getPreventRteUsage ()
	migrateContentForLearningModule (ilAssSelfAssessmentMigrator $migrator)
	setSelfAssessmentEditingMode (bool $selfassessmenteditingmode)
	getSelfAssessmentEditingMode ()
	setDefaultNrOfTries (int $defaultnroftries)
	getDefaultNrOfTries ()
	syncSkillAssignments (int $srcParentId, int $srcQuestionId, int $trgParentId, int $trgQuestionId)
	isAnswered (int $active_id, int $pass)
	getAdditionalContentEditingMode ()
	setAdditionalContentEditingMode (?string $additionalContentEditingMode)
	isAdditionalContentEditingModePageObject ()
	isValidAdditionalContentEditingMode (string $additionalContentEditingMode)
	getValidAdditionalContentEditingModes ()
	getHtmlUserSolutionPurifier ()
	getHtmlQuestionContentPurifier ()
	setLastChange (int $lastChange)
	getLastChange ()
	removeIntermediateSolution (int $active_id, int $pass)
	removeCurrentSolution (int $active_id, int $pass, bool $authorized=true)
	saveCurrentSolution (int $active_id, int $pass, $value1, $value2, bool $authorized=true, $tstamp=0)
	updateCurrentSolution (int $solutionId, $value1, $value2, bool $authorized=true)
	updateCurrentSolutionsAuthorization (int $activeId, int $pass, bool $authorized, bool $keepTime=false)
	setStep ($step)
	getStep ()
	toJSON ()
	intermediateSolutionExists (int $active_id, int $pass)
	authorizedSolutionExists (int $active_id, ?int $pass)
	authorizedOrIntermediateSolutionExists (int $active_id, int $pass)
	lookupForExistingSolutions (int $activeId, int $pass)
	Lookup if an authorized or intermediate solution exists. More...
	isAddableAnswerOptionValue (int $qIndex, string $answerOptionValue)
	addAnswerOptionValue (int $qIndex, string $answerOptionValue, float $points)
	removeAllExistingSolutions ()
	removeExistingSolutions (int $activeId, int $pass)
	resetUsersAnswer (int $activeId, int $pass)
	removeResultRecord (int $activeId, int $pass)
	fetchValuePairsFromIndexedValues (array $indexedValues)
	fetchIndexedValuesFromValuePairs (array $value_pairs)
	updateTimestamp ()
	getTestPresentationConfig ()
	hasWritableOriginalInQuestionPool ()
	answerToParticipantInteraction (AdditionalInformationGenerator $additional_info, int $test_ref_id, int $active_id, int $pass, string $source_ip, TestParticipantInteractionTypes $interaction_type)
	toQuestionAdministrationInteraction (AdditionalInformationGenerator $additional_info, int $test_ref_id, TestQuestionAdministrationInteractionTypes $interaction_type)
	getSolutionForTextOutput (int $active_id, int $pass)
	getCorrectSolutionForTextOutput (int $active_id, int $pass)
	getVariablesAsTextArray (int $active_id, int $pass)
	validateSolutionSubmit ()
	toLog (AdditionalInformationGenerator $additional_info)
	answerToParticipantInteraction (AdditionalInformationGenerator $additional_info, int $test_id, int $active_id, int $pass, string $source_ip, TestParticipantInteractionTypes $interaction_type)
	toQuestionAdministrationInteraction (AdditionalInformationGenerator $additional_info, int $test_id, TestQuestionAdministrationInteractionTypes $interaction_type)

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.

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

References $DIC, and $ilDB.

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

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.

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

References $DIC, and $ilDB.

Referenced by ilObjTest\getTextAnswer().

Here is the caller graph for this function:

_getSuggestedSolutionOutput()

static assQuestion::_getSuggestedSolutionOutput ( int  $question_id )

static

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

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

_questionExistsInTest()

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

static

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

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

References $DIC, and $ilDB.

addAnswerOptionValue()

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

Reimplemented in assClozeTest, and assTextSubset.

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

@final @access public

Parameters

integer	$points
integer	$active_id
integer	$pass

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

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

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

Here is the call graph for this function:

afterSyncWithOriginal()

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

protected

Reimplemented in assMatchingQuestion, and assSingleChoice.

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

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

answerToLog()

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

protected

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

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

answerToParticipantInteraction()

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

Implements ILIAS\TestQuestionPool\Questions\Question.

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

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

Referenced by ilTestPlayerAbstractGUI\save().

Here is the caller graph for this function:

authorizedOrIntermediateSolutionExists()

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

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

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

authorizedSolutionExists()

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

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

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

buildHashedImageFilename()

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

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

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

buildQuestionDataQuery()

assQuestion::buildQuestionDataQuery ( )

protected

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

                                               : string
    {
        return "
                        SELECT          qpl_questions.*,
                                                {$this->getAdditionalTableName()}.*
                        FROM            qpl_questions
                        LEFT JOIN       {$this->getAdditionalTableName()}
                        ON                      {$this->getAdditionalTableName()}.question_fi = qpl_questions.question_id
                        WHERE                   qpl_questions.question_id = %s
                ";
    }

Referenced by assKprimChoice\loadFromDb().

Here is the caller graph for this function:

buildTestPresentationConfig()

assQuestion::buildTestPresentationConfig ( )

protected

Reimplemented in assFileUpload, assMultipleChoice, assOrderingHorizontal, and assOrderingQuestion.

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

                                                    : ilTestQuestionConfig
    {
        return new ilTestQuestionConfig();
    }

calculateReachedPoints()

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

abstract

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

calculateReachedPointsFromPreviewSession()

assQuestion::calculateReachedPointsFromPreviewSession

(

ilAssQuestionPreviewSession

$preview_session

)

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

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

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

References ilAssQuestionPreviewSession\getParticipantsSolution().

Here is the call graph for this function:

calculateResultsFromSolution()

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

final

Calculates the question results from a previously saved question solution.

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

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

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

Here is the call graph for this function:

cleanupMediaObjectUsage()

assQuestion::cleanupMediaObjectUsage

(

)

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

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

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

Here is the call graph for this function:

clonePageOfQuestion()

assQuestion::clonePageOfQuestion

(

int

$a_q_id

)

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

     : self {
        return $target;
    }

cloneSuggestedSolutionFiles()

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

protected

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

     : void {
        $filepath_target = $this->getSuggestedSolutionPath();
        $filepath_original = str_replace("/$target_question_id/solution", "/$source_question_id/solution", $filepath_target);
        ilFileUtils::delDir($filepath_original);
        foreach ($this->suggested_solutions as $solution) {
            if (!$solution->isOfTypeFile()
                || $solution->getFilename() === '') {
                continue;
            }
 
            if (!file_exists($filepath_original)) {
                ilFileUtils::makeDirParents($filepath_original);
            }
 
            if (!is_file($filepath_original . $solution->getFilename())
                || copy($filepath_target . $solution->getFilename(), $filepath_target . $solution->getFilename())) {
                $this->log->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()}");
            }
        }
    }

cloneSuggestedSolutions()

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

protected

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

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

cloneXHTMLMediaObjectsOfQuestion()

assQuestion::cloneXHTMLMediaObjectsOfQuestion

(

int

$source_question_id

)

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

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

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

Here is the call graph for this function:

convertISO8601FormatH_i_s_ExtendedToSeconds()

static assQuestion::convertISO8601FormatH_i_s_ExtendedToSeconds ( string  $time )

static

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

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

References ILIAS\Repository\int().

Here is the call graph for this function:

copyObject()

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

final

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

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

copySuggestedSolutions()

assQuestion::copySuggestedSolutions ( int  $target_question_id )

protected

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

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

createNewOriginalFromThisDuplicate()

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

final

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

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

createNewQuestion()

assQuestion::createNewQuestion

(

bool

$a_create_page = true

)

Creates a new question without an owner when a new question is created This assures that an ID is given to the question if a file upload or something else occurs.

Returns

integer ID of the new question

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

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

References ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

createPageObject()

assQuestion::createPageObject

(

)

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

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

References ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

delete()

assQuestion::delete

(

int

$question_id

)

Reimplemented in assLongMenu.

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

                                            : void
    {
        if ($question_id < 1) {
            return;
        }
 
        $result = $this->db->queryF(
            "SELECT obj_fi FROM qpl_questions WHERE question_id = %s",
            ['integer'],
            [$question_id]
        );
        if ($this->db->numRows($result) !== 1) {
            return;
        }
 
        $row = $this->db->fetchAssoc($result);
        $obj_id = $row["obj_fi"];
 
        try {
            $this->deletePageOfQuestion($question_id);
        } catch (Exception $e) {
            $this->log->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}"
            );
        }
    }

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

Here is the call graph for this function:

deleteAdditionalTableData()

assQuestion::deleteAdditionalTableData

(

int

$question_id

)

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

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

deleteAnswers()

assQuestion::deleteAnswers

(

int

$question_id

)

Reimplemented in assFormulaQuestion.

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

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

deleteComments()

assQuestion::deleteComments ( )

protected

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

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

References ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

deleteDummySolutionRecord()

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

protected

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

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

deletePageOfQuestion()

assQuestion::deletePageOfQuestion ( int  $question_id )

protected

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

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

References ilPageObject\_exists().

Here is the call graph for this function:

deleteSolutionRecordByValues()

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

protected

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

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

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

Here is the call graph for this function:

deleteSuggestedSolutions()

assQuestion::deleteSuggestedSolutions

(

)

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

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

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

Here is the call graph for this function:

deleteTaxonomyAssignments()

assQuestion::deleteTaxonomyAssignments ( )

private

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

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

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

Here is the call graph for this function:

duplicate()

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

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

     : int {
        if ($this->id <= 0) {
            // The question has not been saved. It cannot be duplicated
            return -1;
        }
 
        $clone = clone $this;
        $clone->id = -1;
 
        if ((int) $test_obj_id > 0) {
            $clone->setObjId($test_obj_id);
        }
 
        if ($title) {
            $clone->setTitle($title);
        }
        if ($author) {
            $clone->setAuthor($author);
        }
        if ($owner) {
            $clone->setOwner($owner);
        }
        if ($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;
    }

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.

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

duplicateIntermediateSolutionAuthorized()

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

protected

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

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

duplicateSkillAssignments()

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

protected

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

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

duplicateSuggestedSolutionFiles()

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

protected

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

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

                                                                                        : void
    {
        foreach ($this->suggested_solutions as $solution) {
            if (!$solution->isOfTypeFile()
                || $solution->getFilename() === '') {
                continue;
            }
 
            $filepath = $this->getSuggestedSolutionPath();
            $filepath_original = str_replace(
                "/{$this->obj_id}/{$this->id}/solution",
                "/{$parent_id}/{$question_id}/solution",
                $filepath
            );
            if (!file_exists($filepath)) {
                ilFileUtils::makeDirParents($filepath);
            }
            if (!is_file($filepath_original . $solution->getFilename())
                || !copy($filepath_original . $solution->getFilename(), $filepath . $solution->getFilename())) {
                $this->log->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()}");
            }
        }
    }

References ilFileUtils\makeDirParents().

Here is the call graph for this function:

ensureNonNegativePoints()

assQuestion::ensureNonNegativePoints ( float  $points )

protected

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

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

Referenced by assNumeric\calculateReachedPointsFromPreviewSession().

Here is the caller graph for this function:

explodeKeyValues()

static assQuestion::explodeKeyValues ( string  $keyValues )

static

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

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

References KEY_VALUES_IMPLOSION_SEPARATOR.

extendedTrim()

static assQuestion::extendedTrim ( string  $value )

static

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

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

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

Parameters

string

$value

The string to trim.

Returns

string The trimmed string.

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

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

Referenced by assTextSubsetGUI\writeAnswerSpecificPostData().

Here is the caller graph for this function:

fetchIndexedValuesFromValuePairs()

assQuestion::fetchIndexedValuesFromValuePairs

(

array

$value_pairs

)

Reimplemented in assMatchingQuestion.

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

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

fetchValuePairsFromIndexedValues()

assQuestion::fetchValuePairsFromIndexedValues

(

array

$indexedValues

)

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

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

fixSvgToPng()

assQuestion::fixSvgToPng

(

string

$imageFilenameContainingString

)

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

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

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

Here is the call graph for this function:

forceExistingIntermediateSolution()

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

protected

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

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

formatSAQuestion()

assQuestion::formatSAQuestion

(

$a_q

)

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

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

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.

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

getActiveUserData()

assQuestion::getActiveUserData

(

int

$active_id

)

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

Parameters

integer

$active_id

Active id for a test/user

Returns

array Result array containing the user_id and test_id

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

                                                     : string
    {
        return $this->additionalContentEditingMode;
    }

getAdditionalTableName()

assQuestion::getAdditionalTableName ( )

abstract

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

getAdjustedReachedPoints()

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

final

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

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

getAnswerTableName()

assQuestion::getAnswerTableName ( )

abstract

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

getAuthor()

assQuestion::getAuthor

(

)

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

                               : string
    {
        return $this->author;
    }

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

Here is the caller graph for this function:

getAuthorForHTMLOutput()

assQuestion::getAuthorForHTMLOutput

(

)

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

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

References ILIAS\Repository\refinery().

Here is the call graph for this function:

getComment()

assQuestion::getComment

(

)

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

                                : string
    {
        return $this->comment;
    }

References $comment.

getCorrectSolutionForTextOutput()

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

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

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

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

getCurrentSolutionResultSet()

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

protected

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

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

References ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

getCurrentUser()

assQuestion::getCurrentUser

(

)

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

                                    : ilObjUser
    {
        return $this->current_user;
    }

References $current_user.

getDefaultNrOfTries()

assQuestion::getDefaultNrOfTries

(

)

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

                                         : int
    {
        return $this->defaultnroftries;
    }

getDescriptionForHTMLOutput()

assQuestion::getDescriptionForHTMLOutput

(

)

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

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

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

Here is the call graph for this function:

getExternalId()

assQuestion::getExternalId

(

)

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

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

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

Here is the call graph for this function:

getFeedbackClassNameByQuestionType()

static assQuestion::getFeedbackClassNameByQuestionType ( string  $questionType )

static

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

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

Referenced by assQuestionGUI\_getQuestionGUI().

Here is the caller graph for this function:

getHtmlQuestionContentPurifier()

assQuestion::getHtmlQuestionContentPurifier

(

)

Returns

ilHtmlPurifierInterface|ilAssHtmlUserSolutionPurifier

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

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

References ilHtmlPurifierFactory\getInstanceByType().

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

Here is the call graph for this function:

Here is the caller graph for this function:

getHtmlUserSolutionPurifier()

assQuestion::getHtmlUserSolutionPurifier

(

)

Returns

ilHtmlPurifierInterface|ilAssHtmlUserSolutionPurifier

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

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

References ilHtmlPurifierFactory\getInstanceByType().

Here is the call graph for this function:

getId()

assQuestion::getId

(

)

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

                           : int
    {
        return $this->id;
    }

References $id.

Referenced by ilQuestionCumulatedStatisticsTableGUI\__construct(), ilQuestionUsagesTableGUI\__construct(), assLongMenu\buildFolderName(), assClozeTest\cloneQuestionTypeSpecificProperties(), assLongMenu\getCorrectAnswersAsJson(), assTextQuestion\loadFromDb(), ilAssNestedOrderingElementsInputGUI\prepareReprintable(), ilAssOrderingQuestionAuthoringFormGUI\renewOrderingElementInput(), assErrorText\saveAdditionalQuestionDataToDb(), assFileUpload\saveAdditionalQuestionDataToDb(), assImagemapQuestion\saveAdditionalQuestionDataToDb(), assKprimChoice\saveAdditionalQuestionDataToDb(), assLongMenu\saveAdditionalQuestionDataToDb(), assMatchingQuestion\saveAdditionalQuestionDataToDb(), assErrorText\saveAnswerSpecificDataToDb(), assImagemapQuestion\saveAnswerSpecificDataToDb(), assKprimChoice\saveAnswerSpecificDataToDb(), assLongMenu\saveAnswerSpecificDataToDb(), assMatchingQuestion\saveAnswerSpecificDataToDb(), ilAssQuestionSkillAssignmentsGUI\syncOriginalCmd(), and ilLOTestQuestionAdapter\updateQuestionResult().

Here is the caller graph for this function:

getImagePath()

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

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

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

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

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

References $id.

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

Here is the caller graph for this function:

getImagePathWeb()

assQuestion::getImagePathWeb

(

)

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

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

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

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

References CLIENT_WEB_DIR, and ilFileUtils\removeTrailingPathSeparators().

Referenced by assKprimChoice\loadAnswerData().

Here is the call graph for this function:

Here is the caller graph for this function:

getInstances()

assQuestion::getInstances

(

)

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

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

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

Here is the call graph for this function:

getInternalLinkHref()

assQuestion::getInternalLinkHref

(

string

$target

)

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

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

getLastChange()

assQuestion::getLastChange

(

)

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

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

getLifecycle()

assQuestion::getLifecycle

(

)

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

                                  : ilAssQuestionLifecycle
    {
        return $this->lifecycle;
    }

References $lifecycle.

getMaximumPoints()

assQuestion::getMaximumPoints

(

)

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

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

                                      : float
    {
        return $this->points;
    }

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.

                                         : int
    {
        return self::MINIMUM_THUMB_SIZE;
    }

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

Here is the caller graph for this function:

getNotesDataService()

assQuestion::getNotesDataService ( )

protected

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

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

References $service.

getNotesManager()

assQuestion::getNotesManager ( )

protected

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

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

References $service.

getNotesRepo()

assQuestion::getNotesRepo ( )

protected

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

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

References $service.

getNrOfTries()

assQuestion::getNrOfTries

(

)

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

                                  : int
    {
        return $this->nr_of_tries;
    }

getNumExistingSolutionRecords()

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

staticprotected

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

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

References $DIC, $ilDB, and $res.

Referenced by isAnswered().

Here is the caller graph for this function:

getObjId()

assQuestion::getObjId

(

)

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

                              : int
    {
        return $this->obj_id;
    }

Referenced by ilAssQuestionSkillAssignmentsGUI\syncOriginalCmd().

Here is the caller graph for this function:

getOriginalId()

assQuestion::getOriginalId

(

)

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

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

Referenced by ilAssQuestionSkillAssignmentsGUI\syncOriginalCmd().

Here is the caller graph for this function:

getOwner()

assQuestion::getOwner

(

)

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

                              : int
    {
        return $this->owner;
    }

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.

                               : float
    {
        return $this->points;
    }

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

Here is the caller graph for this function:

getPreventRteUsage()

assQuestion::getPreventRteUsage

(

)

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

                                        : bool
    {
        return $this->prevent_rte_usage;
    }

getProcessLocker()

assQuestion::getProcessLocker

(

)

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

                                      : ilAssQuestionProcessLocker
    {
        return $this->processLocker;
    }

References $processLocker.

getQuestion()

assQuestion::getQuestion

(

)

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

                                 : string
    {
        return $this->question;
    }

Referenced by assOrderingQuestion\isComplete().

Here is the caller graph for this function:

getQuestionAction()

assQuestion::getQuestionAction ( )

protected

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

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

getQuestionForHTMLOutput()

assQuestion::getQuestionForHTMLOutput

(

)

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

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

getQuestionType()

assQuestion::getQuestionType ( )

abstract

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

getQuestionTypeID()

assQuestion::getQuestionTypeID

(

)

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

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

getReachedPoints()

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

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

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

References ILIAS\Survey\Mode\getId().

Referenced by ilLOTestQuestionAdapter\updateQuestionResult().

Here is the call graph for this function:

Here is the caller graph for this function:

getRTETextWithMediaObjects()

assQuestion::getRTETextWithMediaObjects ( )

protected

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

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

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

References ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

getSelfAssessmentEditingMode()

assQuestion::getSelfAssessmentEditingMode

(

)

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

                                                  : bool
    {
        return $this->selfassessmenteditingmode;
    }

Referenced by ilAssQuestionAuthoringFormGUI\addGenericAssessmentQuestionCommandButtons().

Here is the caller graph for this function:

getSelfAssessmentFormatter()

assQuestion::getSelfAssessmentFormatter ( )

protected

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

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

getShuffle()

assQuestion::getShuffle

(

)

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

                                : bool
    {
        return $this->shuffle;
    }

getShuffler()

assQuestion::getShuffler

(

)

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

                                 : Transformation
    {
        return $this->shuffler;
    }

References $shuffler.

getSolutionForTextOutput()

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

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

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

getSolutionMaxPass()

assQuestion::getSolutionMaxPass

(

int

$active_id

)

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

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

References ILIAS\Survey\Mode\getId().

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

Here is the call graph for this function:

Here is the caller graph for this function:

getSolutionRecordById()

assQuestion::getSolutionRecordById ( int  $solutionId )

protected

Returns

array tst_solutions.*

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

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

getSolutionValues()

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

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

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

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

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

Here is the caller graph for this function:

getStep()

assQuestion::getStep

(

)

Returns

int|null

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

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

getSuggestedSolution()

assQuestion::getSuggestedSolution

(

int

$subquestion_index = 0

)

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

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

getSuggestedSolutionOutput()

assQuestion::getSuggestedSolutionOutput

(

)

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

                                                : string
    {
        $output = [];
        foreach ($this->suggested_solutions as $solution) {
            switch ($solution->getType()) {
                case SuggestedSolution::TYPE_LM:
                case SuggestedSolution::TYPE_LM_CHAPTER:
                case SuggestedSolution::TYPE_LM_PAGE:
                case SuggestedSolution::TYPE_GLOSARY_TERM:
                    $output[] = '<a href="'
                        . $this->getInternalLinkHref($solution->getInternalLink())
                        . '">'
                        . $this->lng->txt("solution_hint")
                        . '</a>';
                    break;
 
                case SuggestedSolution::TYPE_FILE:
                    $possible_texts = array_values(
                        array_filter(
                            [
                                ilLegacyFormElementsUtil::prepareFormOutput($solution->getTitle()),
                                ilLegacyFormElementsUtil::prepareFormOutput($solution->getFilename()),
                                $this->lng->txt('tst_show_solution_suggested')
                            ]
                        )
                    );
 
                    ilWACSignedPath::setTokenMaxLifetimeInSeconds(60);
                    $path_to_solution = $this->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);
    }

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

Here is the call graph for this function:

getSuggestedSolutionPath()

assQuestion::getSuggestedSolutionPath

(

)

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

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

References CLIENT_WEB_DIR.

getSuggestedSolutionPathWeb()

assQuestion::getSuggestedSolutionPathWeb

(

)

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

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

References CLIENT_WEB_DIR, and ilFileUtils\removeTrailingPathSeparators().

Here is the call graph for this function:

getSuggestedSolutions()

assQuestion::getSuggestedSolutions

(

)

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

                                           : array
    {
        return $this->suggested_solutions;
    }

getSuggestedSolutionsRepo()

assQuestion::getSuggestedSolutionsRepo ( )

protected

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

                                                  : SuggestedSolutionsDatabaseRepository
    {
        return $this->suggestedsolution_repo;
    }

getTestId()

assQuestion::getTestId

(

)

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

                               : int
    {
        return $this->test_id;
    }

getTestOutputSolutions()

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

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

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

getTestPresentationConfig()

assQuestion::getTestPresentationConfig

(

)

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

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

Referenced by ilTestPlayerAbstractGUI\initTestQuestionConfig().

Here is the caller graph for this function:

getThumbSize()

assQuestion::getThumbSize

(

)

Reimplemented in assKprimChoice, and assMatchingQuestion.

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

                                  : int
    {
        return $this->thumb_size;
    }

getTitle()

assQuestion::getTitle

(

)

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

                              : string
    {
        return $this->title;
    }

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

Here is the caller graph for this function:

getTitleFilenameCompliant()

assQuestion::getTitleFilenameCompliant

(

)

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

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

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

Here is the call graph for this function:

getTitleForHTMLOutput()

assQuestion::getTitleForHTMLOutput

(

)

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

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

References ILIAS\Repository\refinery().

Here is the call graph for this function:

getTotalAnswers()

assQuestion::getTotalAnswers

(

)

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

Reimplemented in assFileUpload.

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

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

getValidAdditionalContentEditingModes()

assQuestion::getValidAdditionalContentEditingModes

(

)

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

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

getVariablesAsTextArray()

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

Reimplemented in assFormulaQuestion.

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

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

References instantiateQuestion().

Here is the call graph for this function:

implodeKeyValues()

static assQuestion::implodeKeyValues ( array  $keyValues )

static

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

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

References KEY_VALUES_IMPLOSION_SEPARATOR.

Referenced by assImagemapQuestionGUI\buildSelectionParameter().

Here is the caller graph for this function:

instantiateQuestion()

static assQuestion::instantiateQuestion ( int  $question_id )

static

Parameters

int

$question_id

Returns

assQuestion

Exceptions

InvalidArgumentException

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

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

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

intermediateSolutionExists()

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

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

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

isAddableAnswerOptionValue()

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

Reimplemented in assClozeTest, and assTextSubset.

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

                                                                                      : bool
    {
        return false;
    }

isAdditionalContentEditingModePageObject()

assQuestion::isAdditionalContentEditingModePageObject

(

)

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

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

References ADDITIONAL_CONTENT_EDITING_MODE_IPE.

isAnswered()

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

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

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

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

Here is the call graph for this function:

isComplete()

assQuestion::isComplete ( )

abstract

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

isDummySolutionRecord()

assQuestion::isDummySolutionRecord ( array  $solutionRecord )

protected

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

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

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

References $force_pass_results_update_enabled.

isNonEmptyItemListPostSubmission()

assQuestion::isNonEmptyItemListPostSubmission ( string  $post_submission_field_name )

protected

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

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

isPreviewSolutionCorrect()

assQuestion::isPreviewSolutionCorrect

(

ilAssQuestionPreviewSession

$preview_session

)

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

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

isValidAdditionalContentEditingMode()

assQuestion::isValidAdditionalContentEditingMode

(

string

$additionalContentEditingMode

)

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

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

isWriteable()

assQuestion::isWriteable

(

)

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

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

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

Here is the call graph for this function:

lmMigrateQuestionTypeGenericContent()

assQuestion::lmMigrateQuestionTypeGenericContent ( ilAssSelfAssessmentMigrator  $migrator )

protected

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

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

References ilAssSelfAssessmentMigrator\migrateToLmContent().

Here is the call graph for this function:

lmMigrateQuestionTypeSpecificContent()

assQuestion::lmMigrateQuestionTypeSpecificContent ( ilAssSelfAssessmentMigrator  $migrator )

protected

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

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

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

loadFromDb()

assQuestion::loadFromDb

(

int

$question_id

)

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

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

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

References $data.

loadSuggestedSolutions()

assQuestion::loadSuggestedSolutions ( )

protected

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

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

References ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

lookupForExistingSolutions()

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

Lookup if an authorized or intermediate solution exists.

Returns

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

Reimplemented in assFormulaQuestion, and assLongMenu.

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

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

References ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

lookupMaxStep()

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

protected

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

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

References ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

lookupParentObjId()

static assQuestion::lookupParentObjId ( int  $question_id )

static

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

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

References $DIC, $ilDB, and $res.

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

Here is the caller graph for this function:

migrateContentForLearningModule()

assQuestion::migrateContentForLearningModule

(

ilAssSelfAssessmentMigrator

$migrator

)

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

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

References ILIAS\Survey\Mode\getId().

Referenced by ilAssSelfAssessmentQuestionFormatter\prepareQuestionForLearningModule().

Here is the call graph for this function:

Here is the caller graph for this function:

onCopy()

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

protected

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

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

onDuplicate()

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

protected

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

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

persistPreviewState()

assQuestion::persistPreviewState ( ilAssQuestionPreviewSession  $preview_session )

final

persists the preview state for current user and question

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

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

persistWorkingState()

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

final

persists the working state for current testactive and testpass

Returns

bool if saving happened

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

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

References ilObjTest\_getPass().

Referenced by ilTestPlayerAbstractGUI\save().

Here is the call graph for this function:

Here is the caller graph for this function:

purifyAndPrepareTextAreaOutput()

assQuestion::purifyAndPrepareTextAreaOutput ( string  $content )

protected

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

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

References ilLegacyFormElementsUtil\prepareTextareaOutput().

Here is the call graph for this function:

removeAllExistingSolutions()

assQuestion::removeAllExistingSolutions

(

)

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

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

References ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

removeAllImageFiles()

assQuestion::removeAllImageFiles ( string  $image_target_path )

protected

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

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

removeCurrentSolution()

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

Returns

int Affected rows

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

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

References ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

removeExistingSolutions()

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

Reimplemented in assFormulaQuestion.

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

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

References ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

removeIntermediateSolution()

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

Reimplemented in assFileUpload.

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

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

removeResultRecord()

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

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

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

References ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

removeSolutionRecordById()

assQuestion::removeSolutionRecordById ( int  $solutionId )

protected

Reimplemented in assFileUpload.

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

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

resetOriginalId()

static assQuestion::resetOriginalId ( int  $questionId )

static

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

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

References $DIC, and $ilDB.

Referenced by ilTestRandomQuestionSetPoolDeriver\updateTestQuestionStage().

Here is the caller graph for this function:

resetUsersAnswer()

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

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

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

resolveInternalLink()

assQuestion::resolveInternalLink

(

string

$internal_link

)

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

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

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

Here is the call graph for this function:

resolveSuggestedSolutionLinks()

assQuestion::resolveSuggestedSolutionLinks

(

)

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

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

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

Here is the call graph for this function:

saveCurrentSolution()

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

Reimplemented in assFormulaQuestion.

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

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

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

Here is the call graph for this function:

saveOriginalId()

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

static

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

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

References $DIC, and $ilDB.

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

Here is the caller graph for this function:

savePreviewData()

assQuestion::savePreviewData ( ilAssQuestionPreviewSession  $preview_session )

protected

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

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

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

References ilAssQuestionPreviewSession\setParticipantsSolution().

Here is the call graph for this function:

saveQuestionDataToDb()

assQuestion::saveQuestionDataToDb

(

?int

$original_id = null

)

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

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

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

saveToDb()

assQuestion::saveToDb

(

?int

$original_id = null

)

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

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

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

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

Here is the call graph for this function:

saveWorkingData()

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

abstract

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

setAdditionalContentEditingMode()

assQuestion::setAdditionalContentEditingMode

(

?string

$additionalContentEditingMode

)

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

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

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

Here is the caller graph for this function:

setAuthor()

assQuestion::setAuthor

(

string

$author = ""

)

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

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

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

Here is the caller graph for this function:

setComment()

assQuestion::setComment

(

string

$comment = ""

)

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

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

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

setDefaultNrOfTries()

assQuestion::setDefaultNrOfTries

(

int

$defaultnroftries

)

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

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

setExportImagePath()

assQuestion::setExportImagePath

(

string

$path

)

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

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

References $path.

setExternalId()

assQuestion::setExternalId

(

?string

$external_id

)

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

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

setForcePassResultUpdateEnabled()

static assQuestion::setForcePassResultUpdateEnabled ( bool  $force_pass_results_update_enabled )

static

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

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

References $force_pass_results_update_enabled.

setId()

assQuestion::setId

(

int

$id = -1

)

Reimplemented in assFormulaQuestion.

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

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

References $id.

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

Here is the caller graph for this function:

setLastChange()

assQuestion::setLastChange

(

int

$lastChange

)

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

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

Referenced by assKprimChoice\loadFromDb().

Here is the caller graph for this function:

setLifecycle()

assQuestion::setLifecycle

(

ilAssQuestionLifecycle

$lifecycle

)

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

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

References $lifecycle.

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

Here is the caller graph for this function:

setNrOfTries()

assQuestion::setNrOfTries

(

int

$a_nr_of_tries

)

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

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

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

Here is the caller graph for this function:

setObjId()

assQuestion::setObjId

(

int

$obj_id = 0

)

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

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

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

Here is the caller graph for this function:

setOriginalId()

assQuestion::setOriginalId

(

?int

$original_id

)

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

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

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

Here is the caller graph for this function:

setOwner()

assQuestion::setOwner

(

int

$owner = -1

)

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

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

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

Here is the caller graph for this function:

setPoints()

assQuestion::setPoints

(

float

$points

)

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

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

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

Here is the caller graph for this function:

setPreventRteUsage()

assQuestion::setPreventRteUsage

(

bool

$prevent_rte_usage

)

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

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

setProcessLocker()

assQuestion::setProcessLocker

(

ilAssQuestionProcessLocker

$processLocker

)

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

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

References $processLocker.

setQuestion()

assQuestion::setQuestion

(

string

$question = ""

)

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

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

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

Here is the caller graph for this function:

setSelfAssessmentEditingMode()

assQuestion::setSelfAssessmentEditingMode

(

bool

$selfassessmenteditingmode

)

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

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

setShuffle()

assQuestion::setShuffle

(

?bool

$shuffle = true

)

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

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

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

Here is the caller graph for this function:

setShuffler()

assQuestion::setShuffler

(

Transformation

$shuffler

)

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

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

References $shuffler.

setStep()

assQuestion::setStep

(

$step

)

Parameters

int | null

$step

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

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

setTestId()

assQuestion::setTestId

(

int

$id = -1

)

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

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

References $id.

setThumbSize()

assQuestion::setThumbSize

(

int

$a_size

)

Reimplemented in assKprimChoice.

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

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

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

Here is the caller graph for this function:

setTitle()

assQuestion::setTitle

(

string

$title = ""

)

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

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

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

Here is the caller graph for this function:

solutionValuesToLog()

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

abstractprotected

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

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

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

solutionValuesToText()

assQuestion::solutionValuesToText ( array  $solution_values )

abstractprotected

MUST convert the given solution values into text.

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

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

syncSkillAssignments()

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

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

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

Referenced by ilAssQuestionSkillAssignmentsGUI\syncOriginalCmd().

Here is the caller graph for this function:

syncWithOriginal()

assQuestion::syncWithOriginal

(

)

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

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

References ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

toJSON()

assQuestion::toJSON

(

)

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

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

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

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.

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

toXML()

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

final

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.

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

updateCurrentSolution()

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

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

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

References ILIAS\Repository\int().

Here is the call graph for this function:

updateCurrentSolutionsAuthorization()

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

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

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

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

Here is the call graph for this function:

updateTimestamp()

assQuestion::updateTimestamp

(

)

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

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

References ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

validateSolutionSubmit()

assQuestion::validateSolutionSubmit

(

)

Implements ILIAS\TestQuestionPool\Questions\Question.

Reimplemented in assFormulaQuestion, assMultipleChoice, assNumeric, and assOrderingQuestion.

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

                                            : bool
    {
        return true;
    }

Field Documentation

$additionalContentEditingMode

string assQuestion::$additionalContentEditingMode = ''

private

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

$author

string assQuestion::$author

protected

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

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

$comment

string assQuestion::$comment

protected

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

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

$current_user

ilObjUser assQuestion::$current_user

protected

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

$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.

$external_id

string assQuestion::$external_id = null

protected

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

$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 isForcePassResultUpdateEnabled(), and 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.

$ilias

ILIAS assQuestion::$ilias

protected

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

$imageSourceFixReplaceMap

assQuestion::$imageSourceFixReplaceMap

staticprotected

Initial value:

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

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

$lastChange

int assQuestion::$lastChange = null

protected

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

$lifecycle

ilAssQuestionLifecycle assQuestion::$lifecycle

protected

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

$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.

$obj_id

int assQuestion::$obj_id = 0

protected

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

$original_id

int assQuestion::$original_id = null

protected

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

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

$owner

int assQuestion::$owner

protected

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

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

$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 assTextSubset\addAnswer(), assTextQuestion\calculateReachedPointsForSolution(), assNumeric\calculateReachedPointsFromPreviewSession(), assLongMenu\checkQuestionCustomPart(), assLongMenu\getMaximumPoints(), assTextQuestion\getMaximumPoints(), assTextSubset\getMaximumPoints(), assTextQuestion\getMinimumPoints(), assLongMenu\getPointsForGap(), and assLongMenu\saveAnswerSpecificDataToDb().

$prevent_rte_usage

bool assQuestion::$prevent_rte_usage = false

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

$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 assOrderingHorizontal\__construct(), assMatchingQuestion\__construct(), assImagemapQuestion\__construct(), assKprimChoice\__construct(), assClozeTest\__construct(), assFormulaQuestion\__construct(), assTextQuestion\__construct(), assSingleChoice\__construct(), assMultipleChoice\__construct(), assOrderingQuestion\__construct(), and assErrorText\__construct().

$question_files

QuestionFiles assQuestion::$question_files

protected

Definition at line 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 assTextSubset\isAnswerCorrect(), and assTextQuestion\isKeywordMatching().

$selfassessmenteditingmode

bool assQuestion::$selfassessmenteditingmode = false

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

$shuffle

bool assQuestion::$shuffle = true

protected

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

Referenced by assMultipleChoice\loadFromDb(), assSingleChoice\loadFromDb(), 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.

$suggested_solutions

array assQuestion::$suggested_solutions

protected

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

$suggestedsolution_repo

SuggestedSolutionsDatabaseRepository assQuestion::$suggestedsolution_repo

protected

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

$test_id

int assQuestion::$test_id

protected

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

$test_question_config

ilTestQuestionConfig assQuestion::$test_question_config = null

private

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

$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.

$title

string assQuestion::$title

protected

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

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

$tpl

ilGlobalPageTemplate assQuestion::$tpl

protected

Definition at line 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(), ilObjTestGUI\buildInputEditingType(), ilObjQuestionPoolGUI\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 ilObjTestGUI\buildInputEditingType(), ilObjQuestionPoolGUI\buildInputEditingType(), ilPCQuestionGUI\edit(), assQuestionImport\fetchAdditionalContentEditingModeInformation(), ilPCQuestionGUI\insert(), and assLongMenuGUI\populateQuestionSpecificFormPart().

DEFAULT_THUMB_SIZE

const assQuestion::DEFAULT_THUMB_SIZE = 150

private

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