Class for text questions. More...

Inheritance diagram for assTextQuestion:

Collaboration diagram for assTextQuestion:

Public Member Functions
	__construct (string $title="", string $comment="", string $author="", int $owner=-1, string $question="")
	assTextQuestion constructor More...

	getMatchcondition ()

	setMatchcondition (int $matchcondition)

	isComplete ()

	saveToDb (?int $original_id=null)

	loadFromDb (int $question_id)

	getMaxNumOfChars ()

	setMaxNumOfChars (int $maxchars=0)

	isWordCounterEnabled ()

	setWordCounterEnabled (bool $word_counter_enabled)

	getMaximumPoints ()
	Returns the maximum points, a learner can reach answering the question. More...

	getMinimumPoints ()

	isKeywordMatching ($answertext, $a_keyword)
	Checks if one of the keywords matches the answertext. More...

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

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

	saveAdditionalQuestionDataToDb ()
	Saves a record to the question types additional data table. More...

	getQuestionType ()

	getTextRating ()

	setTextRating ($a_text_rating)

	getAdditionalTableName ()
	Returns the name of the additional question data table in the database. More...

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

	toJSON ()
	Returns a JSON representation of the question. More...

	getAnswerCount ()

	addAnswer ( $answertext="", $points=0.0, $points_unchecked=0.0, $order=0, $answerimage="")
	Adds a possible answer for a multiple choice question. More...

	getAnswers ()

	getAnswer ($index=0)
	Returns an answer with a given index. More...

	deleteAnswer ($index=0)
	Deletes an answer with a given index. More...

	getAnswerTableName ()

	flushAnswers ()
	Deletes all answers. More...

	setAnswers ($answers)

	duplicateAnswers ($original_id)

	getKeywordRelation ()

	setKeywordRelation (?string $relation)
	This method implements a default behaviour. More...

	countLetters ($text)

	countWords ($text)

	getLatestAutosaveContent (int $active_id, int $pass)

	toLog (AdditionalInformationGenerator $additional_info)
	MUST return an array of the question settings that can be stored in the log. More...

	solutionValuesToText (array $solution_values)
	MUST convert the given solution values into text. More...

	getCorrectSolutionForTextOutput (int $active_id, int $pass)

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

	fromNormalized (array $normalized, Transformations $transformations)

Public Member Functions inherited from assQuestion
	getQuestionType ()

	isComplete ()

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

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

	getAdditionalTableName ()

	getAnswerTableName ()

	toLog (AdditionalInformationGenerator $additional_info)
	MUST return an array of the question settings that can be stored in the log. More...

	getCurrentUser ()

	getShuffler ()

	setShuffler (Transformation $shuffler)

	setProcessLocker (ilAssQuestionProcessLocker $processLocker)

	getProcessLocker ()

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

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

	setTitle (string $title="")

	setId (int $id=-1)

	setTestId (int $id=-1)

	setComment (string $comment="")

	setShuffle (?bool $shuffle=true)

	setAuthor (string $author="")

	setOwner (int $owner=-1)

	getTitle ()

	getTitleForHTMLOutput ()

	getTitleFilenameCompliant ()

	getId ()

	getShuffle ()

	getTestId ()

	getComment ()

	getDescriptionForHTMLOutput ()

	getThumbSize ()

	setThumbSize (int $a_size)

	getMinimumThumbSize ()

	getMaximumThumbSize ()

	getAuthor ()

	getAuthorForHTMLOutput ()

	getOwner ()

	getObjId ()

	setObjId (int $obj_id=0)

	getLifecycle ()

	setLifecycle (ilAssQuestionLifecycle $lifecycle)

	setExternalId (?string $external_id)

	getExternalId ()

	getSuggestedSolutionOutput ()

	getSuggestedSolutions ()

	getReachedPoints (int $active_id, int $pass)

	getMaximumPoints ()

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

	calculateResultsFromSolution (int $active_id, int $pass)
	Calculates the question results from a previously saved question solution. More...

	persistWorkingState (int $active_id, $pass, bool $authorized=true)
	persists the working state for current testactive and testpass More...

	persistPreviewState (ilAssQuestionPreviewSession $preview_session)
	persists the preview state for current user and question More...

	validateSolutionSubmit ()

	getSuggestedSolutionPath ()

	getImagePath ($question_id=null, $object_id=null)
	Returns the image path for web accessable images of a question. More...

	getSuggestedSolutionPathWeb ()

	getImagePathWeb ()
	Returns the web image path for web accessable images of a question. More...

	getTestOutputSolutions (int $activeId, int $pass)

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

	getSolutionValues (int $active_id, ?int $pass=null, bool $authorized=true)
	Loads solutions of a given user from the database an returns it. More...

	deleteAnswers (int $question_id)

	deleteAdditionalTableData (int $question_id)

	delete (int $question_id)

	getTotalAnswers ()

	cloneXHTMLMediaObjectsOfQuestion (int $source_question_id)

	createPageObject ()

	clonePageOfQuestion (int $a_q_id)

	getPageOfQuestion ()

	setOriginalId (?int $original_id)

	getOriginalId ()

	fixSvgToPng (string $imageFilenameContainingString)

	fixUnavailableSkinImageSources (string $html)

	loadFromDb (int $question_id)

	createNewQuestion (bool $a_create_page=true)
	Creates a new question without an owner when a new question is created This assures that an ID is given to the question if a file upload or something else occurs. More...

	saveQuestionDataToDb (?int $original_id=null)

	updateOriginalId (?int $original_id=null)

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

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

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

	saveToDb (?int $original_id=null)

	deleteSuggestedSolutions ()

	getSuggestedSolution (int $subquestion_index=0)

	resolveInternalLink (string $internal_link)

	resolveSuggestedSolutionLinks ()

	getInternalLinkHref (string $target)

	syncWithOriginal ()

	getPoints ()

	setPoints (float $points)

	getSolutionMaxPass (int $active_id)

	isWriteable ()

	calculateReachedPointsFromPreviewSession (ilAssQuestionPreviewSession $preview_session)

	isPreviewSolutionCorrect (ilAssQuestionPreviewSession $preview_session)

	adjustReachedPointsByScoringOptions (float $points, int $active_id)
	Adjust the given reached points by checks for all special scoring options in the test container. More...

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

	getQuestion ()

	getQuestionForHTMLOutput ()

	setQuestion (string $question="")

	getQuestionTypeID ()

	cleanupMediaObjectUsage ()

	getInstances ()

	getActiveUserData (int $active_id)
	Returns the user id and the test id for a given active id. More...

	hasSpecificFeedback ()

	getNrOfTries ()

	setNrOfTries (int $a_nr_of_tries)

	setExportImagePath (string $path)

	formatSAQuestion ($a_q)

	setPreventRteUsage (bool $prevent_rte_usage)

	getPreventRteUsage ()

	migrateContentForLearningModule (ilAssSelfAssessmentMigrator $migrator)

	setSelfAssessmentEditingMode (bool $selfassessmenteditingmode)

	getSelfAssessmentEditingMode ()

	setDefaultNrOfTries (int $defaultnroftries)

	getDefaultNrOfTries ()

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

	isAnswered (int $active_id, int $pass)

	getAdditionalContentEditingMode ()

	setAdditionalContentEditingMode (?string $additionalContentEditingMode)

	isAdditionalContentEditingModePageObject ()

	isValidAdditionalContentEditingMode (string $additionalContentEditingMode)

	getValidAdditionalContentEditingModes ()

	getHtmlUserSolutionPurifier ()

	getHtmlQuestionContentPurifier ()

	setLastChange (int $lastChange)

	getLastChange ()

	removeIntermediateSolution (int $active_id, int $pass)

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

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

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

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

	setStep ($step)

	getStep ()

	toJSON ()

	intermediateSolutionExists (int $active_id, int $pass)

	authorizedSolutionExists (int $active_id, ?int $pass)

	authorizedOrIntermediateSolutionExists (int $active_id, int $pass)

	lookupForExistingSolutions (int $activeId, int $pass)
	Lookup if an authorized or intermediate solution exists. More...

	isAddableAnswerOptionValue (int $qIndex, string $answerOptionValue)

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

	removeAllExistingSolutions ()

	removeExistingSolutions (int $activeId, int $pass)

	resetUsersAnswer (int $activeId, int $pass)

	removeResultRecord (int $activeId, int $pass)

	fetchValuePairsFromIndexedValues (array $indexedValues)

	fetchIndexedValuesFromValuePairs (array $value_pairs)

	updateTimestamp ()

	getTestPresentationConfig ()

	hasWritableOriginalInQuestionPool ()

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

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

	getSolutionForTextOutput (int $active_id, int $pass)

	getCorrectSolutionForTextOutput (int $active_id, int $pass)

	getVariablesAsTextArray (int $active_id, int $pass)

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

	fromNormalized (array $normalized, Transformations $transformations)

	validateSolutionSubmit ()

	toLog (AdditionalInformationGenerator $additional_info)

	answerToParticipantInteraction (AdditionalInformationGenerator $additional_info, int $test_id, int $active_id, int $pass, string $source_ip, TestParticipantInteractionTypes $interaction_type)

	toQuestionAdministrationInteraction (AdditionalInformationGenerator $additional_info, int $test_id, TestQuestionAdministrationInteractionTypes $interaction_type)

	saveAdditionalQuestionDataToDb ()
	Saves a record to the question types additional data table. More...

Public Member Functions inherited from ilObjAnswerScoringAdjustable
	saveAnswerSpecificDataToDb ()
	Saves the answer specific records into a question types answer table. More...

	toJSON ()

	toNormalized (Transformations $transformations, array $context=[])
	Convert the internal state of the implementing object into a language-neutral array structure. More...

	fromNormalized (array $normalized, Transformations $transformations)
	Restore the object from its normalized representation. More...

Static Public Member Functions
static	getValidScoringModes ()

static	getScoringModesWithPointsByQuestion ()

static	getScoringModesWithPointsByKeyword ()

Static Public Member Functions inherited from assQuestion
static	setForcePassResultUpdateEnabled (bool $force_pass_results_update_enabled)

static	isForcePassResultUpdateEnabled ()

static	_getSuggestedSolutionOutput (int $question_id)

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

static	isFileAvailable (string $file)

static	saveOriginalId (int $questionId, int $originalId)

static	resetOriginalId (int $questionId)

static	instantiateQuestion (int $question_id)

static	_getSolutionMaxPass (int $question_id, int $active_id)
	Returns the maximum pass a users question solution. More...

static	getFeedbackClassNameByQuestionType (string $questionType)

static	_questionExistsInTest (int $question_id, int $test_id)

static	lookupParentObjId (int $question_id)

static	implodeKeyValues (array $keyValues)

static	explodeKeyValues (string $keyValues)

static	convertISO8601FormatH_i_s_ExtendedToSeconds (string $time)

static	extendedTrim (string $value)
	Trim non-printable characters from the beginning and end of a string. More...

Data Fields
const	SCORING_MODE_KEYWORD_RELATION_NONE = 'non'

const	SCORING_MODE_KEYWORD_RELATION_ANY = 'any'

const	SCORING_MODE_KEYWORD_RELATION_ALL = 'all'

const	SCORING_MODE_KEYWORD_RELATION_ONE = 'one'

array	$keywords

array	$answers = []

Data Fields inherited from assQuestion
const	ADDITIONAL_CONTENT_EDITING_MODE_RTE = 'default'

const	ADDITIONAL_CONTENT_EDITING_MODE_IPE = 'pageobject'

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

ilAssQuestionFeedback	$feedbackOBJ

bool	$prevent_rte_usage = false

bool	$selfassessmenteditingmode = false

int	$defaultnroftries = 0

string	$questionActionCmd = 'handleQuestionAction'

const	KEY_VALUES_IMPLOSION_SEPARATOR = ':'

Protected Member Functions
	calculateReachedPointsForSolution (string $solution)

	getSolutionSubmit ()

	solutionValuesToLog (AdditionalInformationGenerator $additional_info, array $solution_values)
	MUST convert the given solution values into an array or a string that can be stored in the log. More...

Protected Member Functions inherited from assQuestion
	solutionValuesToLog (AdditionalInformationGenerator $additional_info, array $solution_values)
	MUST convert the given solution values into an array or a string that can be stored in the log. More...

	solutionValuesToText (array $solution_values)
	MUST convert the given solution values into text. More...

	getQuestionAction ()

	isNonEmptyItemListPostSubmission (string $post_submission_field_name)

	savePreviewData (ilAssQuestionPreviewSession $preview_session)

	deletePageOfQuestion (int $question_id)

	cloneQuestionTypeSpecificProperties (self $target)

	removeAllImageFiles (string $image_target_path)

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

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

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

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

	deleteComments ()

	getNotesManager ()

	getNotesDataService ()

	getNotesRepo ()

	cloneSuggestedSolutions (int $source_question_id, int $target_question_id)

	duplicateSuggestedSolutionFiles (int $parent_id, int $question_id)
	Duplicates the files of a suggested solution if the question is duplicated. More...

	cloneSuggestedSolutionFiles (int $source_question_id, int $target_question_id)

	copySuggestedSolutions (int $target_question_id)

	ensureNonNegativePoints (float $points)

	purifyAndPrepareTextAreaOutput (string $content)

	getRTETextWithMediaObjects ()

	getSelfAssessmentFormatter ()

	lmMigrateQuestionTypeGenericContent (ilAssSelfAssessmentMigrator $migrator)

	lmMigrateQuestionTypeSpecificContent (ilAssSelfAssessmentMigrator $migrator)

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

	buildQuestionDataQuery ()

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

	removeSolutionRecordById (int $solutionId)

	getSolutionRecordById (int $solutionId)

	deleteDummySolutionRecord (int $activeId, int $passIndex)

	isDummySolutionRecord (array $solutionRecord)

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

	duplicateIntermediateSolutionAuthorized (int $activeId, int $passIndex)

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

	lookupMaxStep (int $active_id, int $pass)

	buildTestPresentationConfig ()

	getSuggestedSolutionsRepo ()

	loadSuggestedSolutions ()

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

Protected Attributes
const	HAS_SPECIFIC_FEEDBACK = false

Protected Attributes inherited from assQuestion
const	HAS_SPECIFIC_FEEDBACK = true

GeneralQuestionPropertiesRepository	$questionrepository

RequestDataCollector	$questionpool_request

QuestionFiles	$question_files

ilAssQuestionProcessLocker	$processLocker

ilTestQuestionConfig	$testQuestionConfig

SuggestedSolutionsDatabaseRepository	$suggestedsolution_repo

ILIAS	$ilias

ilGlobalPageTemplate	$tpl

ilLanguage	$lng

ilDBInterface	$db

ilObjUser	$current_user

SkillUsageService	$skillUsageService

HTTPServices	$http

Refinery	$refinery

Transformation	$shuffler

LoggingServices	$log

Container	$dic

ilAssQuestionLifecycle	$lifecycle

ilAssQuestionPage	$page

TestResultRepository	$test_result_repository

int	$id

string	$title

string	$comment

int	$owner

string	$author

int	$thumb_size

string	$question

float	$points = 0.0

bool	$shuffle = true

int	$test_id

int	$obj_id = 0

int	$original_id = null

int	$lastChange = null

string	$external_id = null

int	$step = null

array	$suggested_solutions

Private Member Functions
	isValidTextRating ($textRating)

	getScoringModeLangVar (string $scoring_mode)

Private Attributes
int	$max_num_of_chars = 0

bool	$word_counter_enabled = false

string	$text_rating = assClozeGap::TEXTGAP_RATING_CASEINSENSITIVE

int	$matchcondition = 0

string	$keyword_relation = self::SCORING_MODE_KEYWORD_RELATION_NONE

Additional Inherited Members
Static Protected Member Functions inherited from assQuestion
static	getNumExistingSolutionRecords (int $activeId, int $pass, int $questionId)

Static Protected Attributes inherited from assQuestion
static	$force_pass_results_update_enabled = false

static	$imageSourceFixReplaceMap

Detailed Description

Class for text questions.

assTextQuestion is a class for text questions

Author: Helmut Schottmüller helmu.nosp@m.t.sc.nosp@m.hottm.nosp@m.uell.nosp@m.er@ma.nosp@m.c.co.nosp@m.m; Björn Heyser bheys.nosp@m.er@d.nosp@m.ataba.nosp@m.y.de; Maximilian Becker mbeck.nosp@m.er@d.nosp@m.ataba.nosp@m.y.de

Version: $Id$

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

Constructor & Destructor Documentation

◆ __construct()

assTextQuestion::__construct	(	string	$title = `""`,
		string	$comment = `""`,
		string	$author = `""`,
		int	$owner = `-1`,
		string	$question = `""`
	)

assTextQuestion constructor

The constructor takes possible arguments an creates an instance of the assTextQuestion object.

Parameters

string	$title	A title string to describe the question
string	$comment	A comment string to describe the question
string	$author	A string containing the name of the questions author
integer	$owner	A numerical ID to identify the owner/creator
string	$question	The question string of the text question

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

      {
        parent::__construct($title, $comment, $author, $owner, $question);
        $this->points = 1;
    }

References assQuestion\$author, assQuestion\$comment, assQuestion\$owner, assQuestion\$question, assQuestion\$title, and ILIAS\GlobalScreen\Provider\__construct().

Here is the call graph for this function:

Member Function Documentation

◆ addAnswer()

assTextQuestion::addAnswer	(	$answertext = `""`,
		$points = `0.0`,
		$points_unchecked = `0.0`,
		$order = `0`,
		$answerimage = `""`
	)

Adds a possible answer for a multiple choice question.

A ASS_AnswerBinaryStateImage object will be created and assigned to the array $this->answers.

Parameters

string	$answertext	The answer text
double	$points	The points for selecting the answer (even negative points can be used)
boolean	$state	Defines the answer as correct (TRUE) or incorrect (FALSE)
integer	$order	A possible display order of the answer
double	$points	The points for not selecting the answer (even negative points can be used) @access public

See also: $answers; ASS_AnswerBinaryStateImage

Definition at line 550 of file class.assTextQuestion.php.

     : void {
        $this->answers[] = new ASS_AnswerMultipleResponseImage($answertext, $points);
    }

Referenced by loadFromDb().

Here is the caller graph for this function:

◆ calculateReachedPoints()

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

Reimplemented from assQuestion.

Definition at line 364 of file class.assTextQuestion.php.

     : float {
        if ($pass === null) {
            $pass = $this->getSolutionMaxPass($active_id);
        }
 
        $result = $this->getCurrentSolutionResultSet($active_id, $pass, $authorized_solution);
 
        // Return min points when no answer was given.
        if ($this->db->numRows($result) === 0) {
            return $this->getMinimumPoints();
        }
 
        // Return points of points are already on the row.
        $row = $this->db->fetchAssoc($result);
        if ($row['points'] !== null) {
            return (float) $row["points"];
        }
 
        return $this->calculateReachedPointsForSolution($row['value1']);
    }

References assQuestion\getSolutionMaxPass().

Here is the call graph for this function:

◆ calculateReachedPointsForSolution()

assTextQuestion::calculateReachedPointsForSolution ( string $solution )

protected

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

                                                                          : float
    {
        $decoded_solution = html_entity_decode($solution);
        // Return min points when keyword relation is NON KEYWORDS
        if ($this->getKeywordRelation() === self::SCORING_MODE_KEYWORD_RELATION_NONE) {
            return $this->getMinimumPoints();
        }
 
        // Return min points if there are no answers present.
        $answers = $this->getAnswers();
 
        if ($answers === []) {
            return $this->getMinimumPoints();
        }
 
        switch ($this->getKeywordRelation()) {
            case 'any':
                $points = 0.0;
                foreach ($answers as $answer) {
                    $qst_answer = $answer->getAnswertext();
                    $user_answer = '  ' . $decoded_solution;
                    if ($this->isKeywordMatching($user_answer, $qst_answer)) {
                        $points += $answer->getPoints();
                    }
                }
                return $points;
 
            case 'all':
                foreach ($answers as $answer) {
                    $qst_answer = $answer->getAnswertext();
                    $user_answer = '  ' . $decoded_solution;
                    if (!$this->isKeywordMatching($user_answer, $qst_answer)) {
                        return 0.0;
                    }
                }
                return $this->getMaximumPoints();
 
            case 'one':
                foreach ($answers as $answer) {
                    $qst_answer = $answer->getAnswertext();
                    $user_answer = '  ' . $decoded_solution;
                    if ($this->isKeywordMatching($user_answer, $qst_answer)) {
                        return $this->getMaximumPoints();
                    }
                }
        }
 
        return 0.0;
    }

References $answers, assQuestion\$points, getAnswers(), getKeywordRelation(), getMaximumPoints(), getMinimumPoints(), and isKeywordMatching().

Here is the call graph for this function:

◆ countLetters()

assTextQuestion::countLetters ( $text )

Definition at line 722 of file class.assTextQuestion.php.

                                       : int
    {
        $text = strip_tags($text);
 
        $text = str_replace('&gt;', '>', $text);
        $text = str_replace('&lt;', '<', $text);
        $text = str_replace('&nbsp;', ' ', $text);
        $text = str_replace('&amp;', '&', $text);
 
        $text = str_replace("\r\n", "\n", $text);
        $text = str_replace("\n", "", $text);
 
        return ilStr::strLen($text);
    }

References $text, and ilStr\strLen().

Here is the call graph for this function:

◆ countWords()

assTextQuestion::countWords ( $text )

Definition at line 737 of file class.assTextQuestion.php.

                                     : int
    {
        if ($text === '') {
            return 0;
        }
        $text = str_replace('&nbsp;', ' ', $text);
 
        $text = preg_replace('/[.,:;!?\-_#\'"+*\\/=()&%§$]/m', '', $text);
 
        $text = preg_replace('/^\s*/m', '', $text);
        $text = preg_replace('/\s*$/m', '', $text);
        $text = preg_replace('/\s+/m', ' ', $text);
 
        return count(explode(' ', $text));
    }

References $text.

◆ deleteAnswer()

assTextQuestion::deleteAnswer ( $index = 0 )

Deletes an answer with a given index.

The index of the first answer is 0, the index of the second answer is 1 and so on.

Parameters

integer $index A nonnegative index of the n-th answer @access public

See also: $answers

Definition at line 601 of file class.assTextQuestion.php.

                                            : void
    {
        if ($index < 0) {
            return;
        }
        if (count($this->answers) < 1) {
            return;
        }
        if ($index >= count($this->answers)) {
            return;
        }
        $answer = $this->answers[$index];
        //if (strlen($answer->getImage())) {
        //    $this->deleteImage($answer->getImage());
        //}
        unset($this->answers[$index]);
        $this->answers = array_values($this->answers);
        for ($i = 0, $iMax = count($this->answers); $i < $iMax; $i++) {
            if ($this->answers[$i]->getOrder() > $index) {
                $this->answers[$i]->setOrder($i);
            }
        }
    }

References ILIAS\UI\Implementation\Component\Table\getOrder().

Here is the call graph for this function:

◆ duplicateAnswers()

assTextQuestion::duplicateAnswers ( $original_id )

Definition at line 665 of file class.assTextQuestion.php.

                                                  : void
    {
        $result = $this->db->queryF(
            "SELECT * FROM qpl_a_essay WHERE question_fi = %s",
            ['integer'],
            [$original_id]
        );
        if ($result->numRows()) {
            while ($row = $this->db->fetchAssoc($result)) {
                $next_id = $this->db->nextId('qpl_a_essay');
                $affectedRows = $this->db->manipulateF(
                    "INSERT INTO qpl_a_essay (answer_id, question_fi, answertext, points)
                                         VALUES (%s, %s, %s, %s)",
                    ['integer','integer','text','float'],
                    [$next_id, $this->getId(), $row["answertext"], $row["points"]]
                );
            }
        }
    }

References ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

◆ flushAnswers()

assTextQuestion::flushAnswers ( )

Deletes all answers.

@access public

See also: $answers

Definition at line 636 of file class.assTextQuestion.php.

                                  : void
    {
        $this->answers = [];
    }

Referenced by loadFromDb().

Here is the caller graph for this function:

◆ fromNormalized()

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

Parameters

array<array-key,mixed> $normalized

Reimplemented from assQuestion.

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

     : static
    {
        $clone = parent::fromNormalized($normalized, $transformations);
        $clone->word_counter_enabled = $transformations->bool($normalized['word_counter_enabled']);
        $clone->max_num_of_chars = $transformations->int($normalized['max_num_of_chars']);
        $clone->text_rating = $transformations->string($normalized['text_rating']);
        $clone->matchcondition = $transformations->int($normalized['matchcondition']);
        $clone->keyword_relation = $transformations->string($normalized['keyword_relation']);
        $clone->answers = array_map(
            static fn(array $answer): ASS_AnswerMultipleResponseImage => $transformations->denormalize(
                $answer,
                new ASS_AnswerMultipleResponseImage()
            ),
            $normalized['answers']
        );
 
        return $clone;
    }

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

Here is the call graph for this function:

◆ getAdditionalTableName()

assTextQuestion::getAdditionalTableName ( )

Returns the name of the additional question data table in the database.

Returns: string The additional table name @access public

Reimplemented from assQuestion.

Definition at line 502 of file class.assTextQuestion.php.

                                            : string
    {
        return "qpl_qst_essay";
    }

Referenced by loadFromDb().

Here is the caller graph for this function:

◆ getAnswer()

assTextQuestion::getAnswer ( $index = 0 )

Returns an answer with a given index.

The index of the first answer is 0, the index of the second answer is 1 and so on.

Parameters

integer $index A nonnegative index of the n-th answer

Returns: object ASS_AnswerBinaryStateImage-Object containing the answer @access public

See also: $answers

Definition at line 578 of file class.assTextQuestion.php.

                                         : ?ASS_AnswerMultipleResponseImage
    {
        if ($index < 0) {
            return null;
        }
        if (count($this->answers) < 1) {
            return null;
        }
        if ($index >= count($this->answers)) {
            return null;
        }
 
        return $this->answers[$index];
    }

◆ getAnswerCount()

assTextQuestion::getAnswerCount ( )

Definition at line 532 of file class.assTextQuestion.php.

                                    : int
    {
        return count($this->answers);
    }

◆ getAnswers()

assTextQuestion::getAnswers ( )

Returns: array<ASS_AnswerMultipleResponseImage>

Definition at line 564 of file class.assTextQuestion.php.

                                : array
    {
        return $this->answers;
    }

Referenced by calculateReachedPointsForSolution().

Here is the caller graph for this function:

◆ getAnswerTableName()

assTextQuestion::getAnswerTableName ( )

Reimplemented from assQuestion.

Definition at line 625 of file class.assTextQuestion.php.

                                        : string
    {
        return 'qpl_a_essay';
    }

◆ getCorrectSolutionForTextOutput()

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

Reimplemented from assQuestion.

Definition at line 849 of file class.assTextQuestion.php.

                                                                              : array|string
    {
        switch ($this->getKeywordRelation()) {
            case self::SCORING_MODE_KEYWORD_RELATION_NONE:
                return '';
            default:
                return array_map(
                    static fn(ASS_AnswerMultipleResponseImage $v): string => $v->getAnswertext(),
                    $this->getAnswers()
                );
        }
    }

References ASS_AnswerSimple\getAnswertext().

Here is the call graph for this function:

◆ getKeywordRelation()

assTextQuestion::getKeywordRelation ( )

Definition at line 685 of file class.assTextQuestion.php.

    {
        return $this->keyword_relation;
    }

Referenced by calculateReachedPointsForSolution(), getMaximumPoints(), and getMinimumPoints().

Here is the caller graph for this function:

◆ getLatestAutosaveContent()

assTextQuestion::getLatestAutosaveContent	(	int	$active_id,
		int	$pass
	)

Definition at line 753 of file class.assTextQuestion.php.

                                                                       : ?string
    {
        $question_fi = $this->getId();
 
        // Do we have an unauthorized result?
        $cntresult = $this->db->query(
            '
            SELECT count(solution_id) cnt
            FROM tst_solutions
            WHERE active_fi = ' . $this->db->quote($active_id, 'int') . '
            AND question_fi = ' . $this->db->quote($this->getId(), 'int') . '
            AND authorized = ' . $this->db->quote(0, 'int')
            . ' AND pass = ' . $this->db->quote($pass, 'int')
        );
        $row = $this->db->fetchAssoc($cntresult);
        if ($row['cnt'] > 0) {
            $tresult = $this->db->query(
                '
            SELECT value1
            FROM tst_solutions
            WHERE active_fi = ' . $this->db->quote($active_id, 'int') . '
            AND question_fi = ' . $this->db->quote($this->getId(), 'int') . '
            AND authorized = ' . $this->db->quote(0, 'int')
            . ' AND pass = ' . $this->db->quote($pass, 'int')
            );
            $trow = $this->db->fetchAssoc($tresult);
            return $trow['value1'];
        }
        return null;
    }

References ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

◆ getMatchcondition()

assTextQuestion::getMatchcondition ( )

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

                                       : int
    {
        return $this->matchcondition;
    }

References $matchcondition.

◆ getMaximumPoints()

assTextQuestion::getMaximumPoints ( )

Returns the maximum points, a learner can reach answering the question.

@access public

See also: $points

Reimplemented from assQuestion.

Definition at line 199 of file class.assTextQuestion.php.

                                      : float
    {
        if (in_array($this->getKeywordRelation(), self::getScoringModesWithPointsByQuestion())) {
            return parent::getPoints();
        }
 
        $points = 0;
 
        foreach ($this->answers as $answer) {
            if ($answer->getPoints() > 0) {
                $points = $points + $answer->getPoints();
            }
        }
 
        return $points;
    }

References assQuestion\$points, and getKeywordRelation().

Referenced by calculateReachedPointsForSolution(), and isComplete().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getMaxNumOfChars()

assTextQuestion::getMaxNumOfChars ( )

Definition at line 173 of file class.assTextQuestion.php.

                                      : int
    {
        return $this->max_num_of_chars;
    }

References $max_num_of_chars.

◆ getMinimumPoints()

assTextQuestion::getMinimumPoints ( )

Definition at line 216 of file class.assTextQuestion.php.

    {
        if (in_array($this->getKeywordRelation(), self::getScoringModesWithPointsByQuestion())) {
            return 0;
        }
 
        $points = 0;
 
        foreach ($this->answers as $answer) {
            if ($answer->getPoints() < 0) {
                $points = $points + $answer->getPoints();
            }
        }
 
        return $points;
    }

References assQuestion\$points, and getKeywordRelation().

Referenced by calculateReachedPointsForSolution().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getQuestionType()

assTextQuestion::getQuestionType ( )

Reimplemented from assQuestion.

Definition at line 468 of file class.assTextQuestion.php.

                                     : string
    {
        return "assTextQuestion";
    }

◆ getRTETextWithMediaObjects()

assTextQuestion::getRTETextWithMediaObjects ( )

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

Reimplemented from assQuestion.

Definition at line 511 of file class.assTextQuestion.php.

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

◆ getScoringModeLangVar()

assTextQuestion::getScoringModeLangVar ( string $scoring_mode )

private

Definition at line 811 of file class.assTextQuestion.php.

                                                                : string
    {
        switch ($scoring_mode) {
            case assTextQuestion::SCORING_MODE_KEYWORD_RELATION_NONE:
                return 'essay_scoring_mode_without_keywords';
            case assTextQuestion::SCORING_MODE_KEYWORD_RELATION_ANY:
                return 'essay_scoring_mode_keyword_relation_any';
            case assTextQuestion::SCORING_MODE_KEYWORD_RELATION_ALL:
                return 'essay_scoring_mode_keyword_relation_all';
            case assTextQuestion::SCORING_MODE_KEYWORD_RELATION_ONE:
                return 'essay_scoring_mode_keyword_relation_one';
            default:
                return '';
        }
    }

References SCORING_MODE_KEYWORD_RELATION_ALL, SCORING_MODE_KEYWORD_RELATION_ANY, SCORING_MODE_KEYWORD_RELATION_NONE, and SCORING_MODE_KEYWORD_RELATION_ONE.

◆ getScoringModesWithPointsByKeyword()

static assTextQuestion::getScoringModesWithPointsByKeyword ( )

static

Definition at line 715 of file class.assTextQuestion.php.

                                                               : array
    {
        return [
            self::SCORING_MODE_KEYWORD_RELATION_ANY
        ];
    }

Referenced by assTextQuestionGUI\getBestAnswer().

Here is the caller graph for this function:

◆ getScoringModesWithPointsByQuestion()

static assTextQuestion::getScoringModesWithPointsByQuestion ( )

static

Definition at line 706 of file class.assTextQuestion.php.

                                                                : array
    {
        return [
            self::SCORING_MODE_KEYWORD_RELATION_NONE,
            self::SCORING_MODE_KEYWORD_RELATION_ALL,
            self::SCORING_MODE_KEYWORD_RELATION_ONE
        ];
    }

◆ getSolutionSubmit()

assTextQuestion::getSolutionSubmit ( )

protected

Definition at line 412 of file class.assTextQuestion.php.

                                          : string
    {
        $text = $this->questionpool_request->string('TEXT', '');
 
        $text = (new ilRTESettings($this->lng, $this->current_user))->getRichTextEditor() === 'tinymce'
            ? ilUtil::stripSlashes($text, false)
            : htmlentities($text);
 
        return ilUtil::isHTML($text) ? $this->getHtmlUserSolutionPurifier()->purify($text) : $text;
    }

References $text, ilUtil\isHTML(), ILIAS\Repository\lng(), and ilUtil\stripSlashes().

Here is the call graph for this function:

◆ getTextRating()

assTextQuestion::getTextRating ( )

Definition at line 473 of file class.assTextQuestion.php.

                                   : string
    {
        return $this->text_rating;
    }

Referenced by isKeywordMatching().

Here is the caller graph for this function:

◆ getValidScoringModes()

static assTextQuestion::getValidScoringModes ( )

static

Definition at line 701 of file class.assTextQuestion.php.

                                                 : array
    {
        return array_merge(self::getScoringModesWithPointsByQuestion(), self::getScoringModesWithPointsByKeyword());
    }

◆ isComplete()

assTextQuestion::isComplete ( )

Reimplemented from assQuestion.

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

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

References getMaximumPoints().

Here is the call graph for this function:

◆ isKeywordMatching()

assTextQuestion::isKeywordMatching	(	$answertext,
		$a_keyword
	)

Checks if one of the keywords matches the answertext.

Parameters

string	$answertext	The answertext of the user
string	$a_keyword	The keyword which should be checked

Returns: boolean TRUE if the keyword matches, FALSE otherwise @access private

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

                                                              : bool
    {
        global $DIC;
        $refinery = $DIC->refinery();
        $result = false;
        $textrating = $this->getTextRating();
 
        switch ($textrating) {
            case assClozeGap::TEXTGAP_RATING_CASEINSENSITIVE:
                if (ilStr::strPos(ilStr::strToLower($answertext), ilStr::strToLower($a_keyword), 0) !== false) {
                    return true;
                }
                break;
            case assClozeGap::TEXTGAP_RATING_CASESENSITIVE:
                if (ilStr::strPos($answertext, $a_keyword) !== false) {
                    return true;
                }
                break;
        }
 
        // "<p>red</p>" would not match "red" even with distance of 5
        $answertext = strip_tags($answertext);
        $answerwords = [];
        if (preg_match_all("/([^\s.]+)/", $answertext, $matches)) {
            foreach ($matches[1] as $answerword) {
                array_push($answerwords, trim($answerword));
            }
        }
 
        // create correct transformation
        switch ($textrating) {
            case assClozeGap::TEXTGAP_RATING_LEVENSHTEIN1:
                $transformation = $refinery->string()->levenshtein()->standard($a_keyword, 1);
                break;
            case assClozeGap::TEXTGAP_RATING_LEVENSHTEIN2:
                $transformation = $refinery->string()->levenshtein()->standard($a_keyword, 2);
                break;
            case assClozeGap::TEXTGAP_RATING_LEVENSHTEIN3:
                $transformation = $refinery->string()->levenshtein()->standard($a_keyword, 3);
                break;
            case assClozeGap::TEXTGAP_RATING_LEVENSHTEIN4:
                $transformation = $refinery->string()->levenshtein()->standard($a_keyword, 4);
                break;
            case assClozeGap::TEXTGAP_RATING_LEVENSHTEIN5:
                $transformation = $refinery->string()->levenshtein()->standard($a_keyword, 5);
                break;
        }
 
        // run answers against Levenshtein methods
        foreach ($answerwords as $a_original) {
            if (isset($transformation) && $transformation->transform($a_original) >= 0) {
                return true;
            }
        }
        return $result;
    }

References $DIC, assQuestion\$refinery, getTextRating(), ilStr\strPos(), ilStr\strToLower(), assClozeGap\TEXTGAP_RATING_CASEINSENSITIVE, assClozeGap\TEXTGAP_RATING_CASESENSITIVE, assClozeGap\TEXTGAP_RATING_LEVENSHTEIN1, assClozeGap\TEXTGAP_RATING_LEVENSHTEIN2, assClozeGap\TEXTGAP_RATING_LEVENSHTEIN3, assClozeGap\TEXTGAP_RATING_LEVENSHTEIN4, and assClozeGap\TEXTGAP_RATING_LEVENSHTEIN5.

Referenced by calculateReachedPointsForSolution().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isValidTextRating()

assTextQuestion::isValidTextRating ( $textRating )

private

Definition at line 233 of file class.assTextQuestion.php.

                                                   : bool
    {
        switch ($textRating) {
            case assClozeGap::TEXTGAP_RATING_CASEINSENSITIVE:
            case assClozeGap::TEXTGAP_RATING_CASESENSITIVE:
            case assClozeGap::TEXTGAP_RATING_LEVENSHTEIN1:
            case assClozeGap::TEXTGAP_RATING_LEVENSHTEIN2:
            case assClozeGap::TEXTGAP_RATING_LEVENSHTEIN3:
            case assClozeGap::TEXTGAP_RATING_LEVENSHTEIN4:
            case assClozeGap::TEXTGAP_RATING_LEVENSHTEIN5:
                return true;
        }
 
        return false;
    }

References assClozeGap\TEXTGAP_RATING_CASEINSENSITIVE, assClozeGap\TEXTGAP_RATING_CASESENSITIVE, assClozeGap\TEXTGAP_RATING_LEVENSHTEIN1, assClozeGap\TEXTGAP_RATING_LEVENSHTEIN2, assClozeGap\TEXTGAP_RATING_LEVENSHTEIN3, assClozeGap\TEXTGAP_RATING_LEVENSHTEIN4, and assClozeGap\TEXTGAP_RATING_LEVENSHTEIN5.

Referenced by loadFromDb().

Here is the caller graph for this function:

◆ isWordCounterEnabled()

assTextQuestion::isWordCounterEnabled ( )

Definition at line 183 of file class.assTextQuestion.php.

                                          : bool
    {
        return $this->word_counter_enabled;
    }

References $word_counter_enabled.

◆ loadFromDb()

assTextQuestion::loadFromDb ( int $question_id )

Reimplemented from assQuestion.

Definition at line 121 of file class.assTextQuestion.php.

                                                : void
    {
        $result = $this->db->queryF(
            "SELECT qpl_questions.*, " . $this->getAdditionalTableName() . ".* FROM qpl_questions LEFT JOIN " . $this->getAdditionalTableName() . " ON " . $this->getAdditionalTableName() . ".question_fi = qpl_questions.question_id WHERE qpl_questions.question_id = %s",
            ["integer"],
            [$question_id]
        );
        if ($this->db->numRows($result) == 1) {
            $data = $this->db->fetchAssoc($result);
            $this->setId($question_id);
            $this->setObjId($data["obj_fi"]);
            $this->setTitle((string) $data["title"]);
            $this->setComment((string) $data["description"]);
            $this->setOriginalId($data["original_id"]);
            $this->setNrOfTries($data['nr_of_tries']);
            $this->setAuthor($data["author"]);
            $this->setPoints((float) $data["points"]);
            $this->setOwner($data["owner"]);
            $this->setQuestion(ilRTE::_replaceMediaObjectImageSrc((string) $data["question_text"], 1));
            $this->setShuffle(false);
            $this->setWordCounterEnabled((bool) $data['word_cnt_enabled']);
            $this->setMaxNumOfChars($data["maxnumofchars"] ?? 0);
            $this->setTextRating($this->isValidTextRating($data["textgap_rating"]) ? $data["textgap_rating"] : assClozeGap::TEXTGAP_RATING_CASEINSENSITIVE);
            $this->matchcondition = (isset($data['matchcondition'])) ? (int) $data['matchcondition'] : 0;
            $this->setKeywordRelation(($data['keyword_relation']));
 
            try {
                $this->setLifecycle(new ilAssQuestionLifecycle($data['lifecycle']));
            } catch (ilTestQuestionPoolInvalidArgumentException $e) {
                $this->setLifecycle(new ilAssQuestionLifecycle());
            }
 
            try {
                $this->setAdditionalContentEditingMode($data['add_cont_edit_mode']);
            } catch (ilTestQuestionPoolException $e) {
            }
        }
 
        $result = $this->db->queryF(
            'SELECT * FROM qpl_a_essay WHERE question_fi = %s',
            ['integer'],
            [$this->getId()]
        );
 
        $this->flushAnswers();
        while ($row = $this->db->fetchAssoc($result)) {
            $this->addAnswer($row['answertext'] ?? '', $row['points'] ?? 0.0);
        }
 
        parent::loadFromDb($question_id);
    }

References $data, Vendor\Package\$e, ilRTE\_replaceMediaObjectImageSrc(), addAnswer(), flushAnswers(), getAdditionalTableName(), assQuestion\getId(), isValidTextRating(), assQuestion\setAdditionalContentEditingMode(), assQuestion\setAuthor(), assQuestion\setComment(), assQuestion\setId(), setKeywordRelation(), assQuestion\setLifecycle(), setMaxNumOfChars(), assQuestion\setNrOfTries(), assQuestion\setObjId(), assQuestion\setOriginalId(), assQuestion\setOwner(), assQuestion\setPoints(), assQuestion\setQuestion(), assQuestion\setShuffle(), setTextRating(), assQuestion\setTitle(), setWordCounterEnabled(), and assClozeGap\TEXTGAP_RATING_CASEINSENSITIVE.

Here is the call graph for this function:

◆ saveAdditionalQuestionDataToDb()

assTextQuestion::saveAdditionalQuestionDataToDb ( )

Saves a record to the question types additional data table.

Returns: mixed

Implements ilObjQuestionScoringAdjustable.

Definition at line 423 of file class.assTextQuestion.php.

    {
        $this->db->manipulateF(
            "DELETE FROM " . $this->getAdditionalTableName() . " WHERE question_fi = %s",
            ['integer'],
            [$this->getId()]
        );
 
        $fields = [
            'question_fi' => ['integer', $this->getId()],
            'maxnumofchars' => ['integer', $this->getMaxNumOfChars()],
            'word_cnt_enabled' => ['integer', (int) $this->isWordCounterEnabled()],
            'keywords' => ['text', null],
            'textgap_rating' => ['text', $this->getTextRating()],
            'matchcondition' => ['integer', $this->getMatchcondition()],
            'keyword_relation' => ['text', $this->getKeywordRelation()]
        ];
 
        $this->db->insert($this->getAdditionalTableName(), $fields);
    }

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

Referenced by saveToDb().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ saveToDb()

assTextQuestion::saveToDb ( ?int $original_id = null )

Reimplemented from assQuestion.

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

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

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

Here is the call graph for this function:

◆ saveWorkingData()

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

Reimplemented from assQuestion.

Definition at line 389 of file class.assTextQuestion.php.

     : bool {
        if ($pass === null) {
            $pass = ilObjTest::_getPass($active_id);
        }
 
        $answer = $this->getSolutionSubmit();
        $this->getProcessLocker()->executeUserSolutionUpdateLockOperation(
            function () use ($answer, $active_id, $pass, $authorized) {
                $this->removeCurrentSolution($active_id, $pass, $authorized);
 
                if ($answer !== '') {
                    $this->saveCurrentSolution($active_id, $pass, $answer, null, $authorized);
                }
            }
        );
 
        return true;
    }

References ilObjTest\_getPass().

Here is the call graph for this function:

◆ setAnswers()

assTextQuestion::setAnswers ( $answers )

Definition at line 641 of file class.assTextQuestion.php.

                                        : void
    {
        if (isset($answers['answer'])) {
            $count = count($answers['answer']);
            $withPoints = true;
        } else {
            $count = count($answers);
            $withPoints = false;
        }
 
        $this->flushAnswers();
 
        for ($i = 0; $i < $count; $i++) {
            if ($withPoints) {
                $this->addAnswer(
                    $answers['answer'][$i],
                    $this->refinery->kindlyTo()->float()->transform($answers['points'][$i])
                );
            } else {
                $this->addAnswer($answers[$i], 0);
            }
        }
    }

References ILIAS\Repository\refinery().

Here is the call graph for this function:

◆ setKeywordRelation()

assTextQuestion::setKeywordRelation ( ?string $relation )

This method implements a default behaviour.

During the creation of a text question, the record which holds the keyword relation is not existing, so keyword_relation defaults to 'one'.

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

                                                         : void
    {
        if ($relation !== null) {
            $this->keyword_relation = $relation;
        }
    }

References $relation.

Referenced by loadFromDb().

Here is the caller graph for this function:

◆ setMatchcondition()

assTextQuestion::setMatchcondition ( int $matchcondition )

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

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

References $matchcondition.

◆ setMaxNumOfChars()

assTextQuestion::setMaxNumOfChars ( int $maxchars = 0 )

Definition at line 178 of file class.assTextQuestion.php.

                                                       : void
    {
        $this->max_num_of_chars = $maxchars;
    }

Referenced by loadFromDb().

Here is the caller graph for this function:

◆ setTextRating()

assTextQuestion::setTextRating ( $a_text_rating )

Definition at line 478 of file class.assTextQuestion.php.

                                                 : void
    {
        switch ($a_text_rating) {
            case assClozeGap::TEXTGAP_RATING_CASEINSENSITIVE:
            case assClozeGap::TEXTGAP_RATING_CASESENSITIVE:
            case assClozeGap::TEXTGAP_RATING_LEVENSHTEIN1:
            case assClozeGap::TEXTGAP_RATING_LEVENSHTEIN2:
            case assClozeGap::TEXTGAP_RATING_LEVENSHTEIN3:
            case assClozeGap::TEXTGAP_RATING_LEVENSHTEIN4:
            case assClozeGap::TEXTGAP_RATING_LEVENSHTEIN5:
                $this->text_rating = $a_text_rating;
                break;
            default:
                $this->text_rating = assClozeGap::TEXTGAP_RATING_CASEINSENSITIVE;
                break;
        }
    }

References assClozeGap\TEXTGAP_RATING_CASEINSENSITIVE, assClozeGap\TEXTGAP_RATING_CASESENSITIVE, assClozeGap\TEXTGAP_RATING_LEVENSHTEIN1, assClozeGap\TEXTGAP_RATING_LEVENSHTEIN2, assClozeGap\TEXTGAP_RATING_LEVENSHTEIN3, assClozeGap\TEXTGAP_RATING_LEVENSHTEIN4, and assClozeGap\TEXTGAP_RATING_LEVENSHTEIN5.

Referenced by loadFromDb().

Here is the caller graph for this function:

◆ setWordCounterEnabled()

assTextQuestion::setWordCounterEnabled ( bool $word_counter_enabled )

Definition at line 188 of file class.assTextQuestion.php.

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

References $word_counter_enabled.

Referenced by loadFromDb().

Here is the caller graph for this function:

◆ solutionValuesToLog()

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

protected

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

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

Reimplemented from assQuestion.

Definition at line 827 of file class.assTextQuestion.php.

     : string {
        if (!array_key_exists(0, $solution_values)
            || !array_key_exists('value1', $solution_values[0])) {
            return '';
        }
        return $this->refinery->string()->stripTags()->transform(
            html_entity_decode($solution_values[0]['value1'])
        );
    }

◆ solutionValuesToText()

assTextQuestion::solutionValuesToText ( array $solution_values )

MUST convert the given solution values into text.

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

Reimplemented from assQuestion.

Definition at line 840 of file class.assTextQuestion.php.

                                                                : string
    {
        if (!array_key_exists(0, $solution_values)
            || !array_key_exists('value1', $solution_values[0])) {
            return '';
        }
        return $solution_values[0]['value1'];
    }

◆ toJSON()

assTextQuestion::toJSON ( )

Returns a JSON representation of the question.

Reimplemented from assQuestion.

Definition at line 519 of file class.assTextQuestion.php.

                            : string
    {
        $result = [];
        $result['id'] = $this->getId();
        $result['type'] = (string) $this->getQuestionType();
        $result['title'] = $this->getTitleForHTMLOutput();
        $result['question'] = $this->formatSAQuestion($this->getQuestion());
        $result['nr_of_tries'] = $this->getNrOfTries();
        $result['shuffle'] = $this->getShuffle();
        $result['maxlength'] = $this->getMaxNumOfChars();
        return json_encode($result);
    }

References ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

◆ toLog()

assTextQuestion::toLog ( AdditionalInformationGenerator $additional_info )

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

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

Reimplemented from assQuestion.

Definition at line 784 of file class.assTextQuestion.php.

                                                                          : array
    {
        return [
            AdditionalInformationGenerator::KEY_QUESTION_TYPE => (string) $this->getQuestionType(),
            AdditionalInformationGenerator::KEY_QUESTION_TITLE => $this->getTitleForHTMLOutput(),
            AdditionalInformationGenerator::KEY_QUESTION_TEXT => $this->formatSAQuestion($this->getQuestion()),
            AdditionalInformationGenerator::KEY_QUESTION_REACHABLE_POINTS => $this->getMaximumPoints(),
            AdditionalInformationGenerator::KEY_QUESTION_TEXT_WORDCOUNT_ENABLED => $additional_info
            ->getEnabledDisabledTagForBool($this->isWordCounterEnabled()),
            AdditionalInformationGenerator::KEY_QUESTION_MAXCHARS => $this->getMaxNumOfChars(),
            AdditionalInformationGenerator::KEY_QUESTION_TEXT_SCORING_MODE => $additional_info->getTagForLangVar(
                $this->getScoringModeLangVar($this->getKeywordRelation())
            ),
            AdditionalInformationGenerator::KEY_QUESTION_CORRECT_ANSWER_OPTIONS => array_map(
                fn(ASS_AnswerMultipleResponseImage $answer) => [
                    AdditionalInformationGenerator::KEY_QUESTION_ANSWER_OPTION => $answer->getAnswertext(),
                    AdditionalInformationGenerator::KEY_QUESTION_REACHABLE_POINTS => $answer->getPoints() === 0.0 ? '' : $answer->getPoints()
                ],
                $this->getAnswers()
            ),
            AdditionalInformationGenerator::KEY_FEEDBACK => [
                AdditionalInformationGenerator::KEY_QUESTION_FEEDBACK_ON_INCOMPLETE => $this->formatSAQuestion($this->feedbackOBJ->getGenericFeedbackTestPresentation($this->getId(), false)),
                AdditionalInformationGenerator::KEY_QUESTION_FEEDBACK_ON_COMPLETE => $this->formatSAQuestion($this->feedbackOBJ->getGenericFeedbackTestPresentation($this->getId(), true))
            ]
        ];
    }

References ASS_AnswerSimple\getAnswertext(), ILIAS\Test\Logging\AdditionalInformationGenerator\getEnabledDisabledTagForBool(), ASS_AnswerSimple\getPoints(), and ILIAS\Test\Logging\AdditionalInformationGenerator\getTagForLangVar().

Here is the call graph for this function:

◆ toNormalized()

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

Parameters

array<string,mixed> $context

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

Reimplemented from assQuestion.

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

     : array|float|bool|int|string|null
    {
        return [
            ...$transformations->normalize(parent::toNormalized($transformations, $context)),
            'word_counter_enabled' => $this->word_counter_enabled,
            'max_num_of_chars' => $this->max_num_of_chars,
            'text_rating' => $this->text_rating,
            'matchcondition' => $this->matchcondition,
            'keyword_relation' => $this->keyword_relation,
            'answers' => $transformations->normalize($this->answers),
        ];
    }

References ILIAS\TestQuestionPool\ExportImport\Foundation\Normalize\Transformations\normalize().

Here is the call graph for this function:

Field Documentation

◆ $answers

array assTextQuestion::$answers = []

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

Referenced by calculateReachedPointsForSolution().

◆ $keyword_relation

string assTextQuestion::$keyword_relation = self::SCORING_MODE_KEYWORD_RELATION_NONE

private

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

◆ $keywords

array assTextQuestion::$keywords

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

◆ $matchcondition

int assTextQuestion::$matchcondition = 0

private

Definition at line 53 of file class.assTextQuestion.php.

Referenced by getMatchcondition(), and setMatchcondition().

◆ $max_num_of_chars

int assTextQuestion::$max_num_of_chars = 0

private

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

Referenced by getMaxNumOfChars().

◆ $text_rating

string assTextQuestion::$text_rating = assClozeGap::TEXTGAP_RATING_CASEINSENSITIVE

private

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

◆ $word_counter_enabled

bool assTextQuestion::$word_counter_enabled = false

private

Definition at line 51 of file class.assTextQuestion.php.

Referenced by isWordCounterEnabled(), and setWordCounterEnabled().

◆ HAS_SPECIFIC_FEEDBACK

const assTextQuestion::HAS_SPECIFIC_FEEDBACK = false

protected

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

◆ SCORING_MODE_KEYWORD_RELATION_ALL

const assTextQuestion::SCORING_MODE_KEYWORD_RELATION_ALL = 'all'

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

Referenced by assTextQuestionGUI\getBestAnswer(), getScoringModeLangVar(), assTextQuestionGUI\populateAnswerSpecificFormPart(), and assTextQuestionGUI\writeAnswerSpecificPostData().

◆ SCORING_MODE_KEYWORD_RELATION_ANY

const assTextQuestion::SCORING_MODE_KEYWORD_RELATION_ANY = 'any'

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

Referenced by assTextQuestionGUI\getBestAnswer(), getScoringModeLangVar(), assTextQuestionGUI\populateAnswerSpecificFormPart(), and assTextQuestionGUI\writeAnswerSpecificPostData().

◆ SCORING_MODE_KEYWORD_RELATION_NONE

const assTextQuestion::SCORING_MODE_KEYWORD_RELATION_NONE = 'non'

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

Referenced by getScoringModeLangVar(), assTextQuestionGUI\populateAnswerSpecificFormPart(), and assTextQuestionGUI\writeAnswerSpecificPostData().

◆ SCORING_MODE_KEYWORD_RELATION_ONE

const assTextQuestion::SCORING_MODE_KEYWORD_RELATION_ONE = 'one'

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

Referenced by assTextQuestionGUI\getBestAnswer(), getScoringModeLangVar(), assTextQuestionGUI\populateAnswerSpecificFormPart(), and assTextQuestionGUI\writeAnswerSpecificPostData().

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

components/ILIAS/TestQuestionPool/classes/class.assTextQuestion.php

Public Member Functions

Static Public Member Functions

Data Fields

Protected Member Functions

Protected Attributes

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ addAnswer()

◆ calculateReachedPoints()

◆ calculateReachedPointsForSolution()

◆ countLetters()

◆ countWords()

◆ deleteAnswer()

◆ duplicateAnswers()

◆ flushAnswers()

◆ fromNormalized()

◆ getAdditionalTableName()

◆ getAnswer()

◆ getAnswerCount()

◆ getAnswers()

◆ getAnswerTableName()

◆ getCorrectSolutionForTextOutput()

◆ getKeywordRelation()

◆ getLatestAutosaveContent()

◆ getMatchcondition()

◆ getMaximumPoints()

◆ getMaxNumOfChars()

◆ getMinimumPoints()

◆ getQuestionType()

◆ getRTETextWithMediaObjects()

◆ getScoringModeLangVar()

◆ getScoringModesWithPointsByKeyword()

◆ getScoringModesWithPointsByQuestion()

◆ getSolutionSubmit()

◆ getTextRating()

◆ getValidScoringModes()

◆ isComplete()

◆ isKeywordMatching()

◆ isValidTextRating()

◆ isWordCounterEnabled()

◆ loadFromDb()

◆ saveAdditionalQuestionDataToDb()

◆ saveToDb()

◆ saveWorkingData()

◆ setAnswers()

◆ setKeywordRelation()

◆ setMatchcondition()

◆ setMaxNumOfChars()

◆ setTextRating()

◆ setWordCounterEnabled()

◆ solutionValuesToLog()

◆ solutionValuesToText()

◆ toJSON()

◆ toLog()

◆ toNormalized()

Field Documentation

◆ $answers

◆ $keyword_relation

◆ $keywords

◆ $matchcondition

◆ $max_num_of_chars

◆ $text_rating

◆ $word_counter_enabled

◆ HAS_SPECIFIC_FEEDBACK

◆ SCORING_MODE_KEYWORD_RELATION_ALL

◆ SCORING_MODE_KEYWORD_RELATION_ANY

◆ SCORING_MODE_KEYWORD_RELATION_NONE

◆ SCORING_MODE_KEYWORD_RELATION_ONE