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, array $solutionhints=[])

	toXML (bool $a_include_header=true, bool $a_include_binary=true, bool $a_shuffle=false, bool $test_output=false, bool $force_image_references=false)
	Returns a QTI xml representation of the question. More...

	setTitle (string $title="")

	setId (int $id=-1)

	setTestId (int $id=-1)

	setComment (string $comment="")

	setShuffle (?bool $shuffle=true)

	setAuthor (string $author="")

	setOwner (int $owner=-1)

	getTitle ()

	getTitleForHTMLOutput ()

	getTitleFilenameCompliant ()

	getId ()

	getShuffle ()

	getTestId ()

	getComment ()

	getDescriptionForHTMLOutput ()

	getThumbSize ()

	setThumbSize (int $a_size)

	getMinimumThumbSize ()

	getMaximumThumbSize ()

	getAuthor ()

	getAuthorForHTMLOutput ()

	getOwner ()

	getObjId ()

	setObjId (int $obj_id=0)

	getLifecycle ()

	setLifecycle (ilAssQuestionLifecycle $lifecycle)

	setExternalId (?string $external_id)

	getExternalId ()

	getSuggestedSolutionOutput ()

	getSuggestedSolutions ()

	getReachedPoints (int $active_id, int $pass)

	getMaximumPoints ()

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

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

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

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

	validateSolutionSubmit ()

	getSuggestedSolutionPath ()

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

	getSuggestedSolutionPathWeb ()

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

	getTestOutputSolutions (int $activeId, int $pass)

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

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

	deleteAnswers (int $question_id)

	deleteAdditionalTableData (int $question_id)

	delete (int $question_id)

	getTotalAnswers ()

	cloneXHTMLMediaObjectsOfQuestion (int $source_question_id)

	createPageObject ()

	clonePageOfQuestion (int $a_q_id)

	getPageOfQuestion ()

	setOriginalId (?int $original_id)

	getOriginalId ()

static	fixSvgToPng (string $imageFilenameContainingString)

	fixUnavailableSkinImageSources (string $html)

	loadFromDb (int $question_id)

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

	saveQuestionDataToDb (?int $original_id=null)

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

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

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

	saveToDb (?int $original_id=null)

	deleteSuggestedSolutions ()

	getSuggestedSolution (int $subquestion_index=0)

	resolveInternalLink (string $internal_link)

	resolveSuggestedSolutionLinks ()

	getInternalLinkHref (string $target)

	syncWithOriginal ()

	getPoints ()

	setPoints (float $points)

	getSolutionMaxPass (int $active_id)

	isWriteable ()

	deductHintPointsFromReachedPoints (ilAssQuestionPreviewSession $preview_session, $reached_points)

	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 ()

	cloneHints (int $source_question_id, int $target_question_id)

	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)

	ensureHintPageObjectExists ($pageObjectId)

	isAnswered (int $active_id, int $pass)

	getAdditionalContentEditingMode ()

	setAdditionalContentEditingMode (?string $additionalContentEditingMode)

	isAdditionalContentEditingModePageObject ()

	isValidAdditionalContentEditingMode (string $additionalContentEditingMode)

	getValidAdditionalContentEditingModes ()

	getHtmlUserSolutionPurifier ()

	getHtmlQuestionContentPurifier ()

	setLastChange (int $lastChange)

	getLastChange ()

	removeIntermediateSolution (int $active_id, int $pass)

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

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

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

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

	setStep ($step)

	getStep ()

	toJSON ()

	intermediateSolutionExists (int $active_id, int $pass)

	authorizedSolutionExists (int $active_id, ?int $pass)

	authorizedOrIntermediateSolutionExists (int $active_id, int $pass)

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

	isAddableAnswerOptionValue (int $qIndex, string $answerOptionValue)

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

	removeAllExistingSolutions ()

	removeExistingSolutions (int $activeId, int $pass)

	resetUsersAnswer (int $activeId, int $pass)

	removeResultRecord (int $activeId, int $pass)

	fetchValuePairsFromIndexedValues (array $indexedValues)

	fetchIndexedValuesFromValuePairs (array $value_pairs)

	updateTimestamp ()

	getTestPresentationConfig ()

	hasWritableOriginalInQuestionPool ()

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

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

	getSolutionForTextOutput (int $active_id, int $pass)

	getCorrectSolutionForTextOutput (int $active_id, int $pass)

	getVariablesAsTextArray (int $active_id, int $pass)

Static Public Member Functions
static	setForcePassResultUpdateEnabled (bool $force_pass_results_update_enabled)

static	isForcePassResultUpdateEnabled ()

static	_getSuggestedSolutionOutput (int $question_id)

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

static	isFileAvailable (string $file)

static	saveOriginalId (int $questionId, int $originalId)

static	resetOriginalId (int $questionId)

static	instantiateQuestion (int $question_id)

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

static	getFeedbackClassNameByQuestionType (string $questionType)

static	_questionExistsInTest (int $question_id, int $test_id)

static	lookupParentObjId (int $question_id)

static	implodeKeyValues (array $keyValues)

static	explodeKeyValues (string $keyValues)

static	convertISO8601FormatH_i_s_ExtendedToSeconds (string $time)

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

Data Fields
const	ADDITIONAL_CONTENT_EDITING_MODE_RTE = 'default'

const	ADDITIONAL_CONTENT_EDITING_MODE_IPE = 'pageobject'

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

ilAssQuestionFeedback	$feedbackOBJ

bool	$prevent_rte_usage = false

bool	$selfassessmenteditingmode = false

int	$defaultnroftries = 0

string	$questionActionCmd = 'handleQuestionAction'

const	KEY_VALUES_IMPLOSION_SEPARATOR = ':'

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

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

	getQuestionAction ()

	isNonEmptyItemListPostSubmission (string $post_submission_field_name)

	savePreviewData (ilAssQuestionPreviewSession $preview_session)

	deletePageOfQuestion (int $question_id)

	cloneQuestionTypeSpecificProperties (self $target)

	removeAllImageFiles (string $image_target_path)

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

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

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

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

	deleteComments ()

	getNotesManager ()

	getNotesDataService ()

	getNotesRepo ()

	cloneSuggestedSolutions (int $source_question_id, int $target_question_id)

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

	cloneSuggestedSolutionFiles (int $source_question_id, int $target_question_id)

	copySuggestedSolutions (int $target_question_id)

	ensureNonNegativePoints (float $points)

	purifyAndPrepareTextAreaOutput (string $content)

	getRTETextWithMediaObjects ()

	getSelfAssessmentFormatter ()

	lmMigrateQuestionTypeGenericContent (ilAssSelfAssessmentMigrator $migrator)

	lmMigrateQuestionTypeSpecificContent (ilAssSelfAssessmentMigrator $migrator)

	duplicateQuestionHints (int $original_question_id, int $duplicate_question_id)

	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

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
	importHint (int $question_id, array $hint_array)

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

Member Function Documentation

◆ _getReachedPoints()

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

static

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

References $DIC, $ilDB, and $points.

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

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

Here is the caller graph for this function:

◆ _getSolutionMaxPass()

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

static

Returns the maximum pass a users question solution.

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

References $DIC, and $ilDB.

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

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

Here is the caller graph for this function:

◆ _getSuggestedSolutionOutput()

static assQuestion::_getSuggestedSolutionOutput ( int $question_id )

static

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

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

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

Here is the caller graph for this function:

◆ _questionExistsInTest()

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

static

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

References $DIC, and $ilDB.

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

◆ addAnswerOptionValue()

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

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

                                                                                                : void
     {
     }

◆ adjustReachedPointsByScoringOptions()

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

final

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

public

Parameters

integer	$points
integer	$active_id
integer	$pass

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

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

Referenced by calculateResultsFromSolution(), and getAdjustedReachedPoints().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ afterSyncWithOriginal()

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

protected

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

Referenced by syncWithOriginal().

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

Here is the caller graph for this function:

◆ answerToLog()

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

protected

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

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

Referenced by answerToParticipantInteraction().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ answerToParticipantInteraction()

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

Implements ILIAS\TestQuestionPool\Questions\Question.

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

References answerToLog().

Referenced by ilTestPlayerAbstractGUI\save().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ authorizedOrIntermediateSolutionExists()

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

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

References lookupForExistingSolutions().

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

Here is the call graph for this function:

◆ authorizedSolutionExists()

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

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

References lookupForExistingSolutions().

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

Here is the call graph for this function:

◆ buildHashedImageFilename()

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

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

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

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ buildQuestionDataQuery()

assQuestion::buildQuestionDataQuery ( )

protected

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

Referenced by assKprimChoice\loadFromDb().

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

Here is the caller graph for this function:

◆ buildTestPresentationConfig()

assQuestion::buildTestPresentationConfig ( )

protected

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

Referenced by getTestPresentationConfig().

                                                     : ilTestQuestionConfig
     {
         return new ilTestQuestionConfig();
     }

Here is the caller graph for this function:

◆ calculateReachedPoints()

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

abstract

Referenced by calculateResultsFromSolution(), and getAdjustedReachedPoints().

Here is the caller graph for this function:

◆ calculateReachedPointsFromPreviewSession()

assQuestion::calculateReachedPointsFromPreviewSession ( ilAssQuestionPreviewSession $preview_session )

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

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

Referenced by isPreviewSolutionCorrect().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ calculateResultsFromSolution()

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

final

Calculates the question results from a previously saved question solution.

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

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

Referenced by persistWorkingState().

                                                                                  : void
     {
         // determine reached points for submitted solution
         $reached_points = $this->calculateReachedPoints($active_id, $pass);
         $questionHintTracking = new ilAssQuestionHintTracking($this->getId(), $active_id, $pass);
         $requests_statistic_data = $questionHintTracking->getRequestStatisticDataByQuestionAndTestpass();
         $reached_points = $reached_points - $requests_statistic_data->getRequestsPoints();
 
         // 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, $requests_statistic_data, $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()],
                         'hint_count' => ['integer', $requests_statistic_data->getRequestsCount()],
                         'hint_points' => ['float', $requests_statistic_data->getRequestsPoints()],
                         'answered' => ['integer', true]
                     ];
 
                     if ($this->getStep() !== null) {
                         $fieldData['step'] = ['integer', $this->getStep()];
                     }
 
                     $this->db->insert('tst_test_result', $fieldData);
                 }
             }
         );
 
         // update test pass results
         $test = new ilObjTest(
             $this->getObjId(),
             false
         );
         $test->updateTestPassResults($active_id, $pass, $this->getProcessLocker());
         ilCourseObjectiveResult::_updateObjectiveResult($this->current_user->getId(), $active_id, $this->getId());
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ cleanupMediaObjectUsage()

assQuestion::cleanupMediaObjectUsage ( )

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

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

Referenced by saveToDb().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ cloneHints()

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

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

Referenced by syncWithOriginal().

      : void {
         // delete hints of the original
         $this->db->manipulateF(
             "DELETE FROM qpl_hints WHERE qht_question_fi = %s",
             ['integer'],
             [$target_question_id]
         );
 
         // get hints of the actual question
         $result = $this->db->queryF(
             "SELECT * FROM qpl_hints WHERE qht_question_fi = %s",
             ['integer'],
             [$source_question_id]
         );
 
         // save hints to the original
         if ($this->db->numRows($result) < 1) {
             return;
         }
 
         while ($row = $this->db->fetchAssoc($result)) {
             $next_id = $this->db->nextId('qpl_hints');
             $this->db->insert(
                 'qpl_hints',
                 [
                     'qht_hint_id' => ['integer', $next_id],
                     'qht_question_fi' => ['integer', $target_question_id],
                     'qht_hint_index' => ['integer', $row["qht_hint_index"]],
                     'qht_hint_points' => ['float', $row["qht_hint_points"]],
                     'qht_hint_text' => ['text', $row["qht_hint_text"]],
                 ]
             );
         }
     }

Here is the caller graph for this function:

◆ clonePageOfQuestion()

assQuestion::clonePageOfQuestion ( int $a_q_id )

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

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

      : self {
         return $target;
     }

Here is the caller graph for this function:

◆ cloneSuggestedSolutionFiles()

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

protected

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

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

Referenced by cloneSuggestedSolutions(), and onDuplicate().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ cloneSuggestedSolutions()

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

protected

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

References cloneSuggestedSolutionFiles(), and getSuggestedSolutionsRepo().

Referenced by syncWithOriginal().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ cloneXHTMLMediaObjectsOfQuestion()

assQuestion::cloneXHTMLMediaObjectsOfQuestion ( int $source_question_id )

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

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

Referenced by syncWithOriginal().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ convertISO8601FormatH_i_s_ExtendedToSeconds()

static assQuestion::convertISO8601FormatH_i_s_ExtendedToSeconds ( string $time )

static

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

References ILIAS\Repository\int().

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

Here is the call graph for this function:

◆ copyObject()

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

final

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

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

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

Here is the call graph for this function:

◆ copySuggestedSolutions()

assQuestion::copySuggestedSolutions ( int $target_question_id )

protected

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

References getSuggestedSolutions(), and getSuggestedSolutionsRepo().

Referenced by onCopy(), and onDuplicate().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ createNewOriginalFromThisDuplicate()

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

final

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

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

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

Here is the call graph for this function:

◆ createNewQuestion()

assQuestion::createNewQuestion ( bool $a_create_page = true )

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

Returns: integer ID of the new question

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

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

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

Here is the call graph for this function:

◆ createPageObject()

assQuestion::createPageObject ( )

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

References getId(), and getObjId().

Referenced by createNewQuestion(), and saveQuestionDataToDb().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ deductHintPointsFromReachedPoints()

assQuestion::deductHintPointsFromReachedPoints	(	ilAssQuestionPreviewSession	$preview_session,
			$reached_points
	)

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

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

                                                                                                                     : ?float
     {
         $hint_tracking = new ilAssQuestionPreviewHintTracking($this->db, $preview_session);
         $requests_statistic_data = $hint_tracking->getRequestStatisticData();
         return $reached_points - $requests_statistic_data->getRequestsPoints();
     }

Here is the caller graph for this function:

◆ delete()

assQuestion::delete ( int $question_id )

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

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

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

Here is the call graph for this function:

◆ deleteAdditionalTableData()

assQuestion::deleteAdditionalTableData ( int $question_id )

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

References getAdditionalTableName().

Referenced by delete().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ deleteAnswers()

assQuestion::deleteAnswers ( int $question_id )

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

References getAnswerTableName().

Referenced by delete().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ deleteComments()

assQuestion::deleteComments ( )

protected

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

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

Referenced by delete().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ deleteDummySolutionRecord()

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

protected

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

References getSolutionValues(), and removeSolutionRecordById().

Referenced by assFileUpload\saveWorkingData().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ deletePageOfQuestion()

assQuestion::deletePageOfQuestion ( int $question_id )

protected

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

References ilPageObject\_exists().

Referenced by delete().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ deleteSolutionRecordByValues()

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

protected

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

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

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

Here is the call graph for this function:

◆ deleteSuggestedSolutions()

assQuestion::deleteSuggestedSolutions ( )

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

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

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

Here is the call graph for this function:

◆ deleteTaxonomyAssignments()

assQuestion::deleteTaxonomyAssignments ( )

private

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

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

Referenced by delete().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ duplicate()

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

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

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

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

Here is the call graph for this function:

◆ duplicateComments()

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

protected

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

References getNotesDataService(), and getNotesManager().

Referenced by onCopy(), and onDuplicate().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ duplicateIntermediateSolutionAuthorized()

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

protected

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

References getSolutionValues(), and saveCurrentSolution().

Referenced by forceExistingIntermediateSolution().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ duplicateQuestionHints()

assQuestion::duplicateQuestionHints	(	int	$original_question_id,
		int	$duplicate_question_id
	)

protected

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

References ilAssQuestionHintList\duplicateListForQuestion(), ensureHintPageObjectExists(), getId(), and isAdditionalContentEditingModePageObject().

Referenced by onCopy(), and onDuplicate().

                                                                                                     : void
     {
         $hintIds = ilAssQuestionHintList::duplicateListForQuestion($original_question_id, $duplicate_question_id);
 
         if ($this->isAdditionalContentEditingModePageObject()) {
             foreach ($hintIds as $originalHintId => $duplicateHintId) {
                 $this->ensureHintPageObjectExists($originalHintId);
                 $originalPageObject = new ilAssHintPage($originalHintId);
                 $originalXML = $originalPageObject->getXMLContent();
 
                 $duplicatePageObject = new ilAssHintPage();
                 $duplicatePageObject->setId($duplicateHintId);
                 $duplicatePageObject->setParentId($this->getId());
                 $duplicatePageObject->setXMLContent($originalXML);
                 $duplicatePageObject->createFromXML();
             }
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ duplicateSkillAssignments()

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

protected

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

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

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

Here is the caller graph for this function:

◆ duplicateSuggestedSolutionFiles()

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

protected

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

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

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

Referenced by onCopy().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ensureHintPageObjectExists()

assQuestion::ensureHintPageObjectExists ( $pageObjectId )

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

References ilPageObject\_exists(), and getId().

Referenced by duplicateQuestionHints().

                                                              : void
     {
         if (!ilAssHintPage::_exists('qht', $pageObjectId)) {
             $pageObject = new ilAssHintPage();
             $pageObject->setParentId($this->getId());
             $pageObject->setId($pageObjectId);
             $pageObject->createFromXML();
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ensureNonNegativePoints()

assQuestion::ensureNonNegativePoints ( float $points )

protected

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

References $points.

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

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

Here is the caller graph for this function:

◆ explodeKeyValues()

static assQuestion::explodeKeyValues ( string $keyValues )

static

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

References KEY_VALUES_IMPLOSION_SEPARATOR.

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

◆ extendedTrim()

static assQuestion::extendedTrim ( string $value )

static

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

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

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

Parameters

string $value The string to trim.

Returns: string The trimmed string.

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

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

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

Here is the caller graph for this function:

◆ fetchIndexedValuesFromValuePairs()

assQuestion::fetchIndexedValuesFromValuePairs ( array $value_pairs )

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

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

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

Here is the caller graph for this function:

◆ fetchValuePairsFromIndexedValues()

assQuestion::fetchValuePairsFromIndexedValues ( array $indexedValues )

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

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

◆ fixSvgToPng()

static assQuestion::fixSvgToPng ( string $imageFilenameContainingString )

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

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

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

Here is the call graph for this function:

◆ forceExistingIntermediateSolution()

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

protected

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

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

Referenced by assFileUpload\saveWorkingData().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ formatSAQuestion()

assQuestion::formatSAQuestion ( $a_q )

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

References getSelfAssessmentFormatter().

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fromXML()

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

final

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

References getQuestionType(), and importHint().

      : 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
         );
 
         foreach ($solutionhints as $hint) {
             $this->importHint($import->getQuestionId(), $hint);
         }
 
         return $new_import_mapping;
     }

Here is the call graph for this function:

◆ getActiveUserData()

assQuestion::getActiveUserData ( int $active_id )

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

Parameters

integer $active_id Active id for a test/user

Returns: array Result array containing the user_id and test_id

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

References $additionalContentEditingMode.

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

                                                      : string
     {
         return $this->additionalContentEditingMode;
     }

Here is the caller graph for this function:

◆ getAdditionalTableName()

assQuestion::getAdditionalTableName ( )

abstract

Referenced by deleteAdditionalTableData().

Here is the caller graph for this function:

◆ getAdjustedReachedPoints()

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

final

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

References adjustReachedPointsByScoringOptions(), calculateReachedPoints(), and getId().

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

Here is the call graph for this function:

◆ getAnswerTableName()

assQuestion::getAnswerTableName ( )

abstract

Referenced by deleteAnswers().

Here is the caller graph for this function:

◆ getAuthor()

assQuestion::getAuthor ( )

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

References $author.

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

                                : string
     {
         return $this->author;
     }

Here is the caller graph for this function:

◆ getAuthorForHTMLOutput()

assQuestion::getAuthorForHTMLOutput ( )

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

References ILIAS\Repository\refinery().

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

Here is the call graph for this function:

◆ getComment()

assQuestion::getComment ( )

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

References $comment.

Referenced by saveQuestionDataToDb().

                                 : string
     {
         return $this->comment;
     }

Here is the caller graph for this function:

◆ getCorrectSolutionForTextOutput()

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

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

References getSolutionValues(), and solutionValuesToText().

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

Here is the call graph for this function:

◆ getCurrentSolutionResultSet()

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

protected

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

References getId(), and getStep().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getCurrentUser()

assQuestion::getCurrentUser ( )

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

References $current_user.

Referenced by isWriteable().

                                     : ilObjUser
     {
         return $this->current_user;
     }

Here is the caller graph for this function:

◆ getDefaultNrOfTries()

assQuestion::getDefaultNrOfTries ( )

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

References $defaultnroftries.

Referenced by createNewQuestion().

                                          : int
     {
         return $this->defaultnroftries;
     }

Here is the caller graph for this function:

◆ getDescriptionForHTMLOutput()

assQuestion::getDescriptionForHTMLOutput ( )

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

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

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

Here is the call graph for this function:

◆ getExternalId()

assQuestion::getExternalId ( )

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

References $external_id, getId(), and IL_INST_ID.

Referenced by createNewQuestion(), and saveQuestionDataToDb().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getFeedbackClassNameByQuestionType()

static assQuestion::getFeedbackClassNameByQuestionType ( string $questionType )

static

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

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

Referenced by assQuestionGUI\_getQuestionGUI().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getHtmlQuestionContentPurifier()

assQuestion::getHtmlQuestionContentPurifier ( )

Returns: ilHtmlPurifierInterface|ilAssHtmlUserSolutionPurifier

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

References ilHtmlPurifierFactory\getInstanceByType().

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getHtmlUserSolutionPurifier()

assQuestion::getHtmlUserSolutionPurifier ( )

Returns: ilHtmlPurifierInterface|ilAssHtmlUserSolutionPurifier

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

References ilHtmlPurifierFactory\getInstanceByType().

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getId()

assQuestion::getId ( )

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

References $id.

                            : int
     {
         return $this->id;
     }

Here is the caller graph for this function:

◆ getImagePath()

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

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

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

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

References $id, and $obj_id.

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

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

Here is the caller graph for this function:

◆ getImagePathWeb()

assQuestion::getImagePathWeb ( )

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

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

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

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

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getInstances()

assQuestion::getInstances ( )

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

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

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

Here is the call graph for this function:

◆ getInternalLinkHref()

assQuestion::getInternalLinkHref ( string $target )

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

Referenced by getSuggestedSolutionOutput().

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

Here is the caller graph for this function:

◆ getLastChange()

assQuestion::getLastChange ( )

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

References $lastChange.

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

◆ getLifecycle()

assQuestion::getLifecycle ( )

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

References $lifecycle.

Referenced by saveToDb().

                                   : ilAssQuestionLifecycle
     {
         return $this->lifecycle;
     }

Here is the caller graph for this function:

◆ getMaximumPoints()

assQuestion::getMaximumPoints ( )

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

References $points.

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

                                       : float
     {
         return $this->points;
     }

Here is the caller graph for this function:

◆ getMaximumThumbSize()

assQuestion::getMaximumThumbSize ( )

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

                                          : int
     {
         return self::MAXIMUM_THUMB_SIZE;
     }

◆ getMinimumThumbSize()

assQuestion::getMinimumThumbSize ( )

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

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

                                          : int
     {
         return self::MINIMUM_THUMB_SIZE;
     }

Here is the caller graph for this function:

◆ getNotesDataService()

assQuestion::getNotesDataService ( )

protected

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

References $service.

Referenced by duplicateComments().

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

Here is the caller graph for this function:

◆ getNotesManager()

assQuestion::getNotesManager ( )

protected

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

References $service.

Referenced by deleteComments(), and duplicateComments().

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

Here is the caller graph for this function:

◆ getNotesRepo()

assQuestion::getNotesRepo ( )

protected

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

References $service.

Referenced by deleteComments().

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

Here is the caller graph for this function:

◆ getNrOfTries()

assQuestion::getNrOfTries ( )

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

References $nr_of_tries.

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

                                   : int
     {
         return $this->nr_of_tries;
     }

Here is the caller graph for this function:

◆ getNumExistingSolutionRecords()

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

staticprotected

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

References $DIC, $ilDB, and $res.

Referenced by isAnswered().

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

Here is the caller graph for this function:

◆ getObjId()

assQuestion::getObjId ( )

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

References $obj_id.

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

                               : int
     {
         return $this->obj_id;
     }

Here is the caller graph for this function:

◆ getOriginalId()

assQuestion::getOriginalId ( )

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

References $original_id.

Referenced by syncWithOriginal().

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

Here is the caller graph for this function:

◆ getOwner()

assQuestion::getOwner ( )

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

References $owner.

Referenced by saveQuestionDataToDb(), and saveToDb().

                               : int
     {
         return $this->owner;
     }

Here is the caller graph for this function:

◆ getPageOfQuestion()

assQuestion::getPageOfQuestion ( )

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

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

◆ getPoints()

assQuestion::getPoints ( )

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

References $points.

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

                                : float
     {
         return $this->points;
     }

Here is the caller graph for this function:

◆ getPreventRteUsage()

assQuestion::getPreventRteUsage ( )

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

References $prevent_rte_usage.

                                         : bool
     {
         return $this->prevent_rte_usage;
     }

◆ getProcessLocker()

assQuestion::getProcessLocker ( )

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

References $processLocker.

                                       : ilAssQuestionProcessLocker
     {
         return $this->processLocker;
     }

Here is the caller graph for this function:

◆ getQuestion()

assQuestion::getQuestion ( )

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

References $question.

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

                                  : string
     {
         return $this->question;
     }

Here is the caller graph for this function:

◆ getQuestionAction()

assQuestion::getQuestionAction ( )

protected

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

Referenced by assFileUpload\isFileDeletionAction().

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

Here is the caller graph for this function:

◆ getQuestionForHTMLOutput()

assQuestion::getQuestionForHTMLOutput ( )

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

References purifyAndPrepareTextAreaOutput().

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

Here is the call graph for this function:

◆ getQuestionType()

assQuestion::getQuestionType ( )

abstract

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

Here is the caller graph for this function:

◆ getQuestionTypeID()

assQuestion::getQuestionTypeID ( )

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

References getQuestionType().

Referenced by createNewQuestion(), and saveQuestionDataToDb().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getReachedPoints()

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

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

References getId().

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getRTETextWithMediaObjects()

assQuestion::getRTETextWithMediaObjects ( )

protected

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

References getId(), ilAssQuestionHintList\getListByQuestionId(), and getQuestion().

Referenced by cleanupMediaObjectUsage().

                                                    : string
     {
         // must be called in parent classes. add additional RTE text in the parent
         // classes and call this method to add the standard RTE text
         $collected = $this->getQuestion();
         $collected .= $this->feedbackOBJ->getGenericFeedbackContent($this->getId(), false);
         $collected .= $this->feedbackOBJ->getGenericFeedbackContent($this->getId(), true);
         $collected .= $this->feedbackOBJ->getAllSpecificAnswerFeedbackContents($this->getId());
 
         $questionHintList = ilAssQuestionHintList::getListByQuestionId($this->getId());
         foreach ($questionHintList as $questionHint) {
             /* @var $questionHint ilAssQuestionHint */
             $collected .= $questionHint->getText();
         }
 
         return $collected;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSelfAssessmentEditingMode()

assQuestion::getSelfAssessmentEditingMode ( )

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

References $selfassessmenteditingmode.

Referenced by ilAssQuestionAuthoringFormGUI\addGenericAssessmentQuestionCommandButtons().

                                                   : bool
     {
         return $this->selfassessmenteditingmode;
     }

Here is the caller graph for this function:

◆ getSelfAssessmentFormatter()

assQuestion::getSelfAssessmentFormatter ( )

protected

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

Referenced by formatSAQuestion().

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

Here is the caller graph for this function:

◆ getShuffle()

assQuestion::getShuffle ( )

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

References $shuffle.

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

                                 : bool
     {
         return $this->shuffle;
     }

Here is the caller graph for this function:

◆ getShuffler()

assQuestion::getShuffler ( )

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

References $shuffler.

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

                                  : Transformation
     {
         return $this->shuffler;
     }

Here is the caller graph for this function:

◆ getSolutionForTextOutput()

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

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

References getSolutionValues(), and solutionValuesToText().

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

Here is the call graph for this function:

◆ getSolutionMaxPass()

assQuestion::getSolutionMaxPass ( int $active_id )

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

References getId().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSolutionRecordById()

assQuestion::getSolutionRecordById ( int $solutionId )

protected

Returns: array tst_solutions.*

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

Referenced by assFileUpload\saveWorkingData().

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

Here is the caller graph for this function:

◆ getSolutionValues()

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

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

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

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

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getStep()

assQuestion::getStep ( )

Returns: int|null

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

References $step.

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

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

Here is the caller graph for this function:

◆ getSuggestedSolution()

assQuestion::getSuggestedSolution ( int $subquestion_index = 0 )

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

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

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

Here is the call graph for this function:

◆ getSuggestedSolutionPath()

assQuestion::getSuggestedSolutionPath ( )

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

References CLIENT_WEB_DIR.

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

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

Here is the caller graph for this function:

◆ getSuggestedSolutionPathWeb()

assQuestion::getSuggestedSolutionPathWeb ( )

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

References CLIENT_WEB_DIR, and ilFileUtils\removeTrailingPathSeparators().

Referenced by getSuggestedSolutionOutput().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSuggestedSolutions()

assQuestion::getSuggestedSolutions ( )

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

References $suggested_solutions.

Referenced by copySuggestedSolutions().

                                            : array
     {
         return $this->suggested_solutions;
     }

Here is the caller graph for this function:

◆ getSuggestedSolutionsRepo()

assQuestion::getSuggestedSolutionsRepo ( )

protected

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

References $suggestedsolution_repo.

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

                                                   : SuggestedSolutionsDatabaseRepository
     {
         return $this->suggestedsolution_repo;
     }

Here is the caller graph for this function:

◆ getTestId()

assQuestion::getTestId ( )

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

References $test_id.

Referenced by resetUsersAnswer().

                                : int
     {
         return $this->test_id;
     }

Here is the caller graph for this function:

◆ getTestOutputSolutions()

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

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

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

Referenced by assOrderingQuestion\getSolutionOrderingElementListForTestOutput().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getTestPresentationConfig()

assQuestion::getTestPresentationConfig ( )

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

References $test_question_config, and buildTestPresentationConfig().

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getThumbSize()

assQuestion::getThumbSize ( )

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

References $thumb_size.

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

                                   : int
     {
         return $this->thumb_size;
     }

Here is the caller graph for this function:

◆ getTitle()

assQuestion::getTitle ( )

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

References $title.

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

                               : string
     {
         return $this->title;
     }

Here is the caller graph for this function:

◆ getTitleFilenameCompliant()

assQuestion::getTitleFilenameCompliant ( )

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

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

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

Here is the call graph for this function:

◆ getTitleForHTMLOutput()

assQuestion::getTitleForHTMLOutput ( )

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

References ILIAS\Repository\refinery().

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getTotalAnswers()

assQuestion::getTotalAnswers ( )

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

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

◆ getUserSolutionPreferingIntermediate()

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

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

References getSolutionValues().

Referenced by getTestOutputSolutions().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getValidAdditionalContentEditingModes()

assQuestion::getValidAdditionalContentEditingModes ( )

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

Referenced by isValidAdditionalContentEditingMode(), and setAdditionalContentEditingMode().

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

Here is the caller graph for this function:

◆ getVariablesAsTextArray()

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

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

      : array {
         return [];
     }

◆ hasSpecificFeedback()

assQuestion::hasSpecificFeedback ( )

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

                                          : bool
     {
         return static::HAS_SPECIFIC_FEEDBACK;
     }

◆ hasWritableOriginalInQuestionPool()

assQuestion::hasWritableOriginalInQuestionPool ( )

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

References instantiateQuestion().

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

Here is the call graph for this function:

◆ implodeKeyValues()

static assQuestion::implodeKeyValues ( array $keyValues )

static

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

References KEY_VALUES_IMPLOSION_SEPARATOR.

Referenced by assImagemapQuestionGUI\buildSelectionParameter().

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

Here is the caller graph for this function:

◆ importHint()

assQuestion::importHint	(	int	$question_id,
		array	$hint_array
	)

private

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

References getAdditionalContentEditingMode().

Referenced by fromXML().

                                                                     : void
     {
         $hint = new ilAssQuestionHint();
         $hint->setQuestionId($question_id);
         $hint->setIndex($hint_array['index'] ?? '');
         $hint->setPoints($hint_array['points'] ?? '');
         if ($this->getAdditionalContentEditingMode() === self::ADDITIONAL_CONTENT_EDITING_MODE_IPE) {
             $hint->save();
             $hint_page = (new ilAssHintPage());
             $hint_page->setParentId($question_id);
             $hint_page->setId($hint->getId());
             $hint_page->setXMLContent($hint_array['txt']);
             $hint_page->createFromXML();
             return;
         }
 
         $hint->setText($hint_array['txt'] ?? '');
         $hint->save();
     }

Here is the call graph for this function:

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

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

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ intermediateSolutionExists()

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

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

References lookupForExistingSolutions().

Referenced by assFileUpload\saveWorkingData().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isAddableAnswerOptionValue()

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

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

                                                                                       : bool
     {
         return false;
     }

◆ isAdditionalContentEditingModePageObject()

assQuestion::isAdditionalContentEditingModePageObject ( )

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

References ADDITIONAL_CONTENT_EDITING_MODE_IPE, and getAdditionalContentEditingMode().

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isAnswered()

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

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

References getId(), and getNumExistingSolutionRecords().

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

Here is the call graph for this function:

◆ isComplete()

assQuestion::isComplete ( )

abstract

Referenced by saveQuestionDataToDb(), and saveToDb().

Here is the caller graph for this function:

◆ isDummySolutionRecord()

assQuestion::isDummySolutionRecord ( array $solutionRecord )

protected

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

Referenced by assFileUpload\calculateReachedPoints().

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

Here is the caller graph for this function:

◆ isFileAvailable()

static assQuestion::isFileAvailable ( string $file )

static

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

                                                            : bool
     {
         return self::$force_pass_results_update_enabled;
     }

◆ isNonEmptyItemListPostSubmission()

assQuestion::isNonEmptyItemListPostSubmission ( string $post_submission_field_name )

protected

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

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

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

Here is the caller graph for this function:

◆ isPreviewSolutionCorrect()

assQuestion::isPreviewSolutionCorrect ( ilAssQuestionPreviewSession $preview_session )

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

References calculateReachedPointsFromPreviewSession(), and getMaximumPoints().

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

Here is the call graph for this function:

◆ isValidAdditionalContentEditingMode()

assQuestion::isValidAdditionalContentEditingMode ( string $additionalContentEditingMode )

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

References getValidAdditionalContentEditingModes().

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

Here is the call graph for this function:

◆ isWriteable()

assQuestion::isWriteable ( )

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

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

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

Here is the call graph for this function:

◆ lmMigrateQuestionTypeGenericContent()

assQuestion::lmMigrateQuestionTypeGenericContent ( ilAssSelfAssessmentMigrator $migrator )

protected

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

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

Referenced by migrateContentForLearningModule().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ lmMigrateQuestionTypeSpecificContent()

assQuestion::lmMigrateQuestionTypeSpecificContent ( ilAssSelfAssessmentMigrator $migrator )

protected

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

Referenced by migrateContentForLearningModule().

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

Here is the caller graph for this function:

◆ loadFromDb()

assQuestion::loadFromDb ( int $question_id )

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

References $data, and loadSuggestedSolutions().

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

Here is the call graph for this function:

◆ loadSuggestedSolutions()

assQuestion::loadSuggestedSolutions ( )

protected

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

References getId(), and getSuggestedSolutionsRepo().

Referenced by loadFromDb().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ lookupForExistingSolutions()

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

Lookup if an authorized or intermediate solution exists.

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

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

References getId(), and getStep().

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ lookupMaxStep()

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

protected

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

References getId().

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ lookupParentObjId()

static assQuestion::lookupParentObjId ( int $question_id )

static

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

References $DIC, $ilDB, and $res.

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

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

Here is the caller graph for this function:

◆ migrateContentForLearningModule()

assQuestion::migrateContentForLearningModule ( ilAssSelfAssessmentMigrator $migrator )

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

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

Referenced by ilAssSelfAssessmentQuestionFormatter\prepareQuestionForLearningModule().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ onCopy()

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

protected

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

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

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

Here is the call graph for this function:

◆ onDuplicate()

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

protected

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

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

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

Here is the call graph for this function:

◆ persistPreviewState()

assQuestion::persistPreviewState ( ilAssQuestionPreviewSession $preview_session )

final

persists the preview state for current user and question

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

References savePreviewData(), and validateSolutionSubmit().

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

Here is the call graph for this function:

◆ persistWorkingState()

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

final

persists the working state for current testactive and testpass

Returns: bool if saving happened

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

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

Referenced by ilTestPlayerAbstractGUI\save().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ purifyAndPrepareTextAreaOutput()

assQuestion::purifyAndPrepareTextAreaOutput ( string $content )

protected

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

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

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ removeAllExistingSolutions()

assQuestion::removeAllExistingSolutions ( )

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

References getId().

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

Here is the call graph for this function:

◆ removeAllImageFiles()

assQuestion::removeAllImageFiles ( string $image_target_path )

protected

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

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

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

Here is the caller graph for this function:

◆ removeCurrentSolution()

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

Returns: int Affected rows

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

References getId(), and getStep().

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ removeExistingSolutions()

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

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

References getId(), and getStep().

Referenced by resetUsersAnswer().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ removeIntermediateSolution()

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

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

References getProcessLocker(), and removeCurrentSolution().

Referenced by persistWorkingState().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ removeResultRecord()

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

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

References getId(), and getStep().

Referenced by resetUsersAnswer().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ removeSolutionRecordById()

assQuestion::removeSolutionRecordById ( int $solutionId )

protected

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

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

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

Here is the caller graph for this function:

◆ resetOriginalId()

static assQuestion::resetOriginalId ( int $questionId )

static

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

References $DIC, and $ilDB.

Referenced by ilTestRandomQuestionSetPoolDeriver\updateTestQuestionStage().

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

Here is the caller graph for this function:

◆ resetUsersAnswer()

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

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

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

                                                               : void
     {
         $this->removeExistingSolutions($activeId, $pass);
         $this->removeResultRecord($activeId, $pass);
 
         $test = new ilObjTest(
             $this->test_id,
             false
         );
         $test->updateTestPassResults(
             $activeId,
             $pass,
             $this->getProcessLocker(),
             $this->getTestId()
         );
     }

Here is the call graph for this function:

◆ resolveInternalLink()

assQuestion::resolveInternalLink ( string $internal_link )

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

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

Referenced by resolveSuggestedSolutionLinks().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ resolveSuggestedSolutionLinks()

assQuestion::resolveSuggestedSolutionLinks ( )

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

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

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

Here is the call graph for this function:

◆ saveCurrentSolution()

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

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

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ saveOriginalId()

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

static

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

References $DIC, and $ilDB.

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

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

Here is the caller graph for this function:

◆ savePreviewData()

assQuestion::savePreviewData ( ilAssQuestionPreviewSession $preview_session )

protected

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

References ilAssQuestionPreviewSession\setParticipantsSolution().

Referenced by persistPreviewState().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ saveQuestionDataToDb()

assQuestion::saveQuestionDataToDb ( ?int $original_id = null )

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

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

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ saveToDb()

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

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

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

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ saveWorkingData()

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

abstract

Referenced by persistWorkingState().

Here is the caller graph for this function:

◆ setAdditionalContentEditingMode()

assQuestion::setAdditionalContentEditingMode ( ?string $additionalContentEditingMode )

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

References $additionalContentEditingMode, and getValidAdditionalContentEditingModes().

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setAuthor()

assQuestion::setAuthor ( string $author = "" )

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

References $author.

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

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

Here is the caller graph for this function:

◆ setComment()

assQuestion::setComment ( string $comment = "" )

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

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

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setDefaultNrOfTries()

assQuestion::setDefaultNrOfTries ( int $defaultnroftries )

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

References $defaultnroftries.

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

◆ setExportImagePath()

assQuestion::setExportImagePath ( string $path )

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

References $path.

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

◆ setExternalId()

assQuestion::setExternalId ( ?string $external_id )

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

References $external_id.

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

◆ setForcePassResultUpdateEnabled()

static assQuestion::setForcePassResultUpdateEnabled ( bool $force_pass_results_update_enabled )

static

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

References $force_pass_results_update_enabled.

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

◆ setId()

assQuestion::setId ( int $id = -1 )

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

References $id.

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

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

Here is the caller graph for this function:

◆ setLastChange()

assQuestion::setLastChange ( int $lastChange )

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

References $lastChange.

Referenced by assKprimChoice\loadFromDb().

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

Here is the caller graph for this function:

◆ setLifecycle()

assQuestion::setLifecycle ( ilAssQuestionLifecycle $lifecycle )

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

References $lifecycle.

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

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

Here is the caller graph for this function:

◆ setNrOfTries()

assQuestion::setNrOfTries ( int $a_nr_of_tries )

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

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

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

Here is the caller graph for this function:

◆ setObjId()

assQuestion::setObjId ( int $obj_id = 0 )

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

References $obj_id.

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

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

Here is the caller graph for this function:

◆ setOriginalId()

assQuestion::setOriginalId ( ?int $original_id )

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

References $original_id.

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

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

Here is the caller graph for this function:

◆ setOwner()

assQuestion::setOwner ( int $owner = -1 )

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

References $owner.

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

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

Here is the caller graph for this function:

◆ setPoints()

assQuestion::setPoints ( float $points )

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

References $points.

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

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

Here is the caller graph for this function:

◆ setPreventRteUsage()

assQuestion::setPreventRteUsage ( bool $prevent_rte_usage )

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

References $prevent_rte_usage.

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

◆ setProcessLocker()

assQuestion::setProcessLocker ( ilAssQuestionProcessLocker $processLocker )

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

References $processLocker.

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

◆ setQuestion()

assQuestion::setQuestion ( string $question = "" )

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

References $question.

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

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

Here is the caller graph for this function:

◆ setSelfAssessmentEditingMode()

assQuestion::setSelfAssessmentEditingMode ( bool $selfassessmenteditingmode )

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

References $selfassessmenteditingmode.

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

◆ setShuffle()

assQuestion::setShuffle ( ?bool $shuffle = true )

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

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

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

Here is the caller graph for this function:

◆ setShuffler()

assQuestion::setShuffler ( Transformation $shuffler )

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

References $shuffler.

Referenced by assMatchingQuestion\toJSON().

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

Here is the caller graph for this function:

◆ setStep()

assQuestion::setStep ( $step )

Parameters

int | null $step

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

References $step.

Referenced by assFileUpload\getUploadedFilesForWeb().

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

Here is the caller graph for this function:

◆ setTestId()

assQuestion::setTestId ( int $id = -1 )

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

References $id.

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

◆ setThumbSize()

assQuestion::setThumbSize ( int $a_size )

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

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

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

Here is the caller graph for this function:

◆ setTitle()

assQuestion::setTitle ( string $title = "" )

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

References $title.

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

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

Here is the caller graph for this function:

◆ solutionValuesToLog()

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

abstractprotected

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

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

Referenced by answerToLog().

Here is the caller graph for this function:

◆ solutionValuesToText()

assQuestion::solutionValuesToText ( array $solution_values )

abstractprotected

MUST convert the given solution values into text.

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

Referenced by getCorrectSolutionForTextOutput(), and getSolutionForTextOutput().

Here is the caller graph for this function:

◆ syncSkillAssignments()

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

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

References duplicateSkillAssignments().

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

Here is the call graph for this function:

◆ syncWithOriginal()

assQuestion::syncWithOriginal ( )

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

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

                                       : 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(), $original_parent_id, $this->getObjId());
         $this->cloneHints($this->id, $this->original_id);
     }

Here is the call graph for this function:

◆ toJSON()

assQuestion::toJSON ( )

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

                             : string
     {
         return json_encode([]);
     }

◆ toLog()

assQuestion::toLog ( AdditionalInformationGenerator $additional_info )

abstract

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

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

Implements ILIAS\TestQuestionPool\Questions\Question.

Referenced by toQuestionAdministrationInteraction().

Here is the caller graph for this function:

◆ toQuestionAdministrationInteraction()

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

Implements ILIAS\TestQuestionPool\Questions\Question.

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

References toLog().

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

Here is the call graph for this function:

◆ toXML()

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

final

Returns a QTI xml representation of the question.

Returns: string The QTI xml representation of the question

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

References getQuestionType().

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

Here is the call graph for this function:

◆ updateCurrentSolution()

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

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

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

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ updateCurrentSolutionsAuthorization()

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

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

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

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ updateTimestamp()

assQuestion::updateTimestamp ( )

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

References getId().

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

Here is the call graph for this function:

◆ validateSolutionSubmit()

assQuestion::validateSolutionSubmit ( )

Implements ILIAS\TestQuestionPool\Questions\Question.

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

Referenced by persistPreviewState(), and persistWorkingState().

                                             : bool
     {
         return true;
     }

Here is the caller graph for this function:

Field Documentation

◆ $additionalContentEditingMode

string assQuestion::$additionalContentEditingMode = ''

private

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

Referenced by getAdditionalContentEditingMode(), and setAdditionalContentEditingMode().

◆ $author

string assQuestion::$author

protected

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

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

◆ $comment

string assQuestion::$comment

protected

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

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

◆ $current_user

ilObjUser assQuestion::$current_user

protected

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

Referenced by getCurrentUser().

◆ $db

ilDBInterface assQuestion::$db

protected

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

◆ $defaultnroftries

int assQuestion::$defaultnroftries = 0

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

Referenced by getDefaultNrOfTries(), and setDefaultNrOfTries().

◆ $dic

Container assQuestion::$dic

protected

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

◆ $export_image_path

string assQuestion::$export_image_path

private

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

Referenced by getImagePathWeb().

◆ $external_id

string assQuestion::$external_id = null

protected

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

Referenced by getExternalId(), and setExternalId().

◆ $feedbackOBJ

ilAssQuestionFeedback assQuestion::$feedbackOBJ

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

◆ $force_pass_results_update_enabled

assQuestion::$force_pass_results_update_enabled = false

staticprotected

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

Referenced by setForcePassResultUpdateEnabled().

◆ $http

HTTPServices assQuestion::$http

protected

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

◆ $id

int assQuestion::$id

protected

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

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

◆ $ilias

ILIAS assQuestion::$ilias

protected

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

◆ $imageSourceFixReplaceMap

assQuestion::$imageSourceFixReplaceMap

staticprotected

Initial value:

= [

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

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

◆ $lastChange

int assQuestion::$lastChange = null

protected

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

Referenced by getLastChange(), and setLastChange().

◆ $lifecycle

ilAssQuestionLifecycle assQuestion::$lifecycle

protected

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

Referenced by getLifecycle(), and setLifecycle().

◆ $lng

ilLanguage assQuestion::$lng

protected

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

◆ $log

LoggingServices assQuestion::$log

protected

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

◆ $nr_of_tries

int assQuestion::$nr_of_tries

private

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

Referenced by getNrOfTries().

◆ $obj_id

int assQuestion::$obj_id = 0

protected

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

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

◆ $original_id

int assQuestion::$original_id = null

protected

◆ $owner

int assQuestion::$owner

protected

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

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

◆ $page

ilAssQuestionPage assQuestion::$page

protected

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

◆ $points

float assQuestion::$points = 0.0

protected

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

◆ $prevent_rte_usage

bool assQuestion::$prevent_rte_usage = false

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

Referenced by getPreventRteUsage(), and setPreventRteUsage().

◆ $processLocker

ilAssQuestionProcessLocker assQuestion::$processLocker

protected

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

Referenced by getProcessLocker(), and setProcessLocker().

◆ $question

string assQuestion::$question

protected

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

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

◆ $question_files

QuestionFiles assQuestion::$question_files

protected

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

◆ $questionActionCmd

string assQuestion::$questionActionCmd = 'handleQuestionAction'

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

◆ $questionpool_request

RequestDataCollector assQuestion::$questionpool_request

protected

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

◆ $questionrepository

GeneralQuestionPropertiesRepository assQuestion::$questionrepository

protected

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

◆ $refinery

Refinery assQuestion::$refinery

protected

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

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

◆ $selfassessmenteditingmode

bool assQuestion::$selfassessmenteditingmode = false

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

Referenced by getSelfAssessmentEditingMode(), and setSelfAssessmentEditingMode().

◆ $shuffle

bool assQuestion::$shuffle = true

protected

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

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

◆ $shuffler

Transformation assQuestion::$shuffler

protected

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

Referenced by getShuffler(), and setShuffler().

◆ $skillUsageService

SkillUsageService assQuestion::$skillUsageService

protected

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

◆ $step

int assQuestion::$step = null

protected

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

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

◆ $suggested_solutions

array assQuestion::$suggested_solutions

protected

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

Referenced by getSuggestedSolutions().

◆ $suggestedsolution_repo

SuggestedSolutionsDatabaseRepository assQuestion::$suggestedsolution_repo

protected

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

Referenced by getSuggestedSolutionsRepo().

◆ $test_id

int assQuestion::$test_id

protected

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

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

◆ $test_question_config

ilTestQuestionConfig assQuestion::$test_question_config = null

private

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

Referenced by getTestPresentationConfig().

◆ $testQuestionConfig

ilTestQuestionConfig assQuestion::$testQuestionConfig

protected

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

◆ $thumb_size

int assQuestion::$thumb_size

protected

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

Referenced by getThumbSize().

◆ $title

string assQuestion::$title

protected

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

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

◆ $tpl

ilGlobalPageTemplate assQuestion::$tpl

protected

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

◆ ADDITIONAL_CONTENT_EDITING_MODE_IPE

const assQuestion::ADDITIONAL_CONTENT_EDITING_MODE_IPE = 'pageobject'

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

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

◆ ADDITIONAL_CONTENT_EDITING_MODE_RTE

const assQuestion::ADDITIONAL_CONTENT_EDITING_MODE_RTE = 'default'

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

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

◆ DEFAULT_THUMB_SIZE

const assQuestion::DEFAULT_THUMB_SIZE = 150

private

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

◆ HAS_SPECIFIC_FEEDBACK

const assQuestion::HAS_SPECIFIC_FEEDBACK = true

protected

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

◆ KEY_VALUES_IMPLOSION_SEPARATOR

const assQuestion::KEY_VALUES_IMPLOSION_SEPARATOR = ':'

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

Referenced by explodeKeyValues(), and implodeKeyValues().

◆ MAXIMUM_THUMB_SIZE

const assQuestion::MAXIMUM_THUMB_SIZE = 8192

private

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

◆ MINIMUM_THUMB_SIZE

const assQuestion::MINIMUM_THUMB_SIZE = 20

private

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

◆ TRIM_PATTERN

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

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

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

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

Public Member Functions

Static Public Member Functions

Data Fields

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Static Protected Attributes

Private Member Functions

Private Attributes

Detailed Description

Member Function Documentation

◆ _getReachedPoints()

◆ _getSolutionMaxPass()

◆ _getSuggestedSolutionOutput()

◆ _questionExistsInTest()

◆ addAnswerOptionValue()

◆ adjustReachedPointsByScoringOptions()

◆ afterSyncWithOriginal()

◆ answerToLog()

◆ answerToParticipantInteraction()

◆ authorizedOrIntermediateSolutionExists()

◆ authorizedSolutionExists()

◆ buildHashedImageFilename()

◆ buildQuestionDataQuery()

◆ buildTestPresentationConfig()

◆ calculateReachedPoints()

◆ calculateReachedPointsFromPreviewSession()

◆ calculateResultsFromSolution()

◆ cleanupMediaObjectUsage()

◆ cloneHints()

◆ clonePageOfQuestion()

◆ cloneQuestionTypeSpecificProperties()

◆ cloneSuggestedSolutionFiles()

◆ cloneSuggestedSolutions()

◆ cloneXHTMLMediaObjectsOfQuestion()

◆ convertISO8601FormatH_i_s_ExtendedToSeconds()

◆ copyObject()

◆ copySuggestedSolutions()

◆ createNewOriginalFromThisDuplicate()

◆ createNewQuestion()

◆ createPageObject()

◆ deductHintPointsFromReachedPoints()

◆ delete()

◆ deleteAdditionalTableData()

◆ deleteAnswers()

◆ deleteComments()

◆ deleteDummySolutionRecord()

◆ deletePageOfQuestion()

◆ deleteSolutionRecordByValues()

◆ deleteSuggestedSolutions()

◆ deleteTaxonomyAssignments()

◆ duplicate()

◆ duplicateComments()

◆ duplicateIntermediateSolutionAuthorized()

◆ duplicateQuestionHints()

◆ duplicateSkillAssignments()

◆ duplicateSuggestedSolutionFiles()

◆ ensureHintPageObjectExists()

◆ ensureNonNegativePoints()

◆ explodeKeyValues()

◆ extendedTrim()

◆ fetchIndexedValuesFromValuePairs()

◆ fetchValuePairsFromIndexedValues()

◆ fixSvgToPng()

◆ fixUnavailableSkinImageSources()

◆ forceExistingIntermediateSolution()

◆ formatSAQuestion()

◆ fromXML()

◆ getActiveUserData()

◆ getAdditionalContentEditingMode()

◆ getAdditionalTableName()

◆ getAdjustedReachedPoints()

◆ getAnswerTableName()

◆ getAuthor()

◆ getAuthorForHTMLOutput()

◆ getComment()

◆ getCorrectSolutionForTextOutput()

◆ getCurrentSolutionResultSet()

◆ getCurrentUser()

◆ getDefaultNrOfTries()