Abstract basic class which is to be extended by the concrete assessment question type classes. More...

Inheritance diagram for assQuestion:

Collaboration diagram for assQuestion:

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

	getShuffler ()

	setShuffler (Transformation $shuffler)

	setProcessLocker (ilAssQuestionProcessLocker $processLocker)

	getProcessLocker ()

	fromXML ($item, int $questionpool_id, ?int $tst_id, &$tst_object, int &$question_counter, array $import_mapping, array &$solutionhints=[])
	Receives parameters from a QTI parser and creates a valid ILIAS question object. More...

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

	isComplete ()
	Returns true, if a question is complete for use. More...

	questionTitleExists (int $questionpool_id, string $title)
	Returns TRUE if the question title exists in a question pool in the database. More...

	setTitle (string $title="")

	setId (int $id=-1)

	setTestId (int $id=-1)

	setComment (string $comment="")

	setOutputType (int $outputType=OUTPUT_HTML)

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

	getOutputType ()

	supportsJavascriptOutput ()

	supportsNonJsOutput ()

	requiresJsSwitch ()

	getAuthor ()

	getAuthorForHTMLOutput ()

	getOwner ()

	getObjId ()

	setObjId (int $obj_id=0)

	getLifecycle ()

	setLifecycle (ilAssQuestionLifecycle $lifecycle)

	setExternalId (?string $external_id)

	getExternalId ()

	getSuggestedSolutionOutput ()

	_getSuggestedSolution (int $question_id, int $subquestion_index=0)

	loadSuggestedSolution (int $question_id, int $subquestion_index=0)
	Returns a suggested solution for a given subquestion index. More...

	getSuggestedSolutions ()

	getReachedPoints (int $active_id, int $pass)

	getMaximumPoints ()

	getAdjustedReachedPoints (int $active_id, int $pass, bool $authorizedSolution=true)
	returns the reached points ... More...

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

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

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

	validateSolutionSubmit ()

	saveWorkingData (int $active_id, int $pass, bool $authorized=true)
	Saves the learners input of the question to the database. More...

	moveUploadedMediaFile (string $file, string $name)
	Move an uploaded media file to an public accessible temp dir to present it. More...

	getSuggestedSolutionPath ()

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

	buildImagePath ($questionId, $parentObjectId)

	getFlashPath ()
	Returns the image path for web accessable flash files 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, $pass=null)

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

	isInUse (int $question_id=0)
	Checks whether the question is in use or not in pools or tests. More...

	usageNumber (int $question_id=0)
	Returns the number of place the question is in use in pools or tests. More...

	isClone (int $question_id=0)
	Checks whether the question is a clone of another question or not. More...

	getAdditionalTableName ()

	getAnswerTableName ()

	deleteAnswers (int $question_id)

	deleteAdditionalTableData (int $question_id)

	delete (int $question_id)

	getTotalAnswers ()

	copyXHTMLMediaObjectsOfQuestion (int $a_q_id)

	syncXHTMLMediaObjectsOfQuestion ()

	createPageObject ()

	copyPageOfQuestion (int $a_q_id)

	getPageOfQuestion ()

	setOriginalId (?int $original_id)

	getOriginalId ()

	fixSvgToPng (string $imageFilenameContainingString)

	fixUnavailableSkinImageSources (string $html)

	loadFromDb (int $question_id)

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

	saveQuestionDataToDb (int $original_id=-1)

	saveToDb ()

	setNewOriginalId (int $newId)

	deleteSuggestedSolutions ()

	getSuggestedSolution (int $subquestion_index=0)
	Returns a suggested solution for a given subquestion index. More...

	getSuggestedSolutionTitle (int $subquestion_index=0)
	Returns the title of a suggested solution at a given subquestion_index. More...

	setSuggestedSolution (string $solution_id="", int $subquestion_index=0, bool $is_import=false)
	Sets a suggested solution for the question. More...

	updateSuggestedSolutions (int $original_id=-1, int $original_obj_id=-1)

	_resolveInternalLink (string $internal_link)

	_resolveIntLinks (int $question_id)

	syncWithOriginal ()

	_questionExists ($question_id)
	Returns true if the question already exists in the database. More...

	_questionExistsInPool (int $question_id)

	getPoints ()

	setPoints (float $points)

	getSolutionMaxPass (int $active_id)

	calculateReachedPoints ($active_id, $pass=null, $authorizedSolution=true, $returndetails=false)
	Returns the points, a learner has reached answering the question. More...

	deductHintPointsFromReachedPoints (ilAssQuestionPreviewSession $previewSession, $reachedPoints)

	calculateReachedPointsFromPreviewSession (ilAssQuestionPreviewSession $previewSession)

	isPreviewSolutionCorrect (ilAssQuestionPreviewSession $previewSession)

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

	isHTML ($a_text)
	Checks if a given string contains HTML or not. More...

	prepareTextareaOutput (string $txt_output, bool $prepare_for_latex_output=false, bool $omitNl2BrWhenTextArea=false)

	QTIMaterialToString (ilQTIMaterial $a_material)
	Reads an QTI material tag and creates a text or XHTML string. More...

	addQTIMaterial (ilXmlWriter $a_xml_writer, string $a_material, bool $close_material_tag=true, bool $add_mobs=true)

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

	getQuestion ()

	getQuestionForHTMLOutput ()

	setQuestion (string $question="")

	getQuestionType ()
	Returns the question type of the question. More...

	getQuestionTypeID ()

	syncHints ()

	cleanupMediaObjectUsage ()

	getInstances ()

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

	hasSpecificFeedback ()

	setExportDetailsXLS (ilAssExcelFormatHelper $worksheet, int $startrow, int $active_id, int $pass)

	__get ($value)
	Object getter. More...

	__set ($key, $value)
	Object setter. More...

	__isset ($key)
	Object issetter. More...

	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)

	isAutosaveable ()

	getAdditionalContentEditingMode ()

	setAdditionalContentEditingMode (?string $additionalContentEditingMode)

	isAdditionalContentEditingModePageObject ()

	isValidAdditionalContentEditingMode (string $additionalContentEditingMode)

	getValidAdditionalContentEditingModes ()

	getHtmlUserSolutionPurifier ()

	getHtmlQuestionContentPurifier ()

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

	duplicate (bool $for_test=true, string $title="", string $author="", string $owner="", $testObjId=null)

	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 $valuePairs)

	areObligationsToBeConsidered ()

	setObligationsToBeConsidered (bool $obligationsToBeConsidered)

	updateTimestamp ()

	getTestPresentationConfig ()

	savePartial ()

	isInActiveTest ()

Static Public Member Functions
static	setForcePassResultUpdateEnabled (bool $forcePassResultsUpdateEnabled)

static	isForcePassResultUpdateEnabled ()

static	isAllowedImageMimeType ($mimeType)

static	fetchMimeTypeIdentifier (string $contentType)

static	getAllowedFileExtensionsForMimeType (string $mimeType)

static	isAllowedImageFileExtension (string $mimeType, string $fileExtension)

static	getAllowedImageMaterialFileExtensions ()

static	_getMaximumPoints (int $question_id)
	Returns the maximum points, a learner can reach answering the question. More...

static	_getQuestionInfo (int $question_id)

static	_getSuggestedSolutionCount (int $question_id)

static	_getSuggestedSolutionOutput (int $question_id)

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

static	_updateTestResultCache (int $active_id, ilAssQuestionProcessLocker $processLocker=null)
	Move this to a proper place. More...

static	logAction (string $logtext, int $active_id, int $question_id)

static	getQuestionTypeFromDb (int $question_id)

static	_getTotalRightAnswers (int $a_q_id)

static	_getTitle (int $a_q_id)

static	_getQuestionText (int $a_q_id)

static	isFileAvailable (string $file)

static	_getQuestionType (int $question_id)

static	_getQuestionTitle (int $question_id)

static	saveOriginalId (int $questionId, int $originalId)

static	resetOriginalId (int $questionId)

static	_getInternalLinkHref (string $target="")

static	_getOriginalId (int $question_id)

static	originalQuestionExists (int $questionId)

static	_instanciateQuestion (int $question_id)

static	_instantiateQuestion (int $question_id)

static	instantiateQuestion (int $question_id)

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

static	_isWriteable (int $question_id, int $user_id)

static	_isUsedInRandomTest (int $question_id)

static	_isWorkedThrough (int $active_id, int $question_id, int $pass)
	Returns true if the question was worked through in the given pass Worked through means that the user entered at least one value. More...

static	_areAnswered (int $a_user_id, array $a_question_ids)
	Checks if an array of question ids is answered by a user or not. More...

static	_setReachedPoints (int $active_id, int $question_id, float $points, float $maxpoints, int $pass, bool $manualscoring, bool $obligationsEnabled)
	Sets the points, a learner has reached answering the question Additionally objective results are updated. More...

static	_needsManualScoring (int $question_id)

static	_includeClass (string $question_type, int $gui=0)

static	getFeedbackClassNameByQuestionType (string $questionType)

static	isCoreQuestionType (string $questionType)

static	includeCoreClass ($questionType, $withGuiClass)

static	_getQuestionTypeName ($type_tag)

static	_instanciateQuestionGUI (int $question_id)

static	instantiateQuestionGUI (int $a_question_id)

static	_questionExistsInTest (int $question_id, int $test_id)

static	lookupParentObjId (int $questionId)

static	lookupOriginalParentObjId (int $originalQuestionId)
	returns the parent object id for given original question id (should be a qpl id, but theoretically it can be a tst id, too) More...

static	isObligationPossible (int $questionId)

static	implodeKeyValues (array $keyValues)

static	explodeKeyValues (string $keyValues)

static	convertISO8601FormatH_i_s_ExtendedToSeconds (string $time)

static	missingResultRecordExists (int $activeId, int $pass, array $questionIds)

static	getQuestionsMissingResultRecord (int $activeId, int $pass, array $questionIds)

static	lookupResultRecordExist (int $activeId, int $questionId, int $pass)

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

Data Fields
const	IMG_MIME_TYPE_JPG = 'image/jpeg'

const	IMG_MIME_TYPE_PNG = 'image/png'

const	IMG_MIME_TYPE_GIF = 'image/gif'

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

const	ADDITIONAL_CONTENT_EDITING_MODE_RTE = 'default'

const	ADDITIONAL_CONTENT_EDITING_MODE_IPE = 'pageobject'

ilAssQuestionFeedback	$feedbackOBJ

bool	$prevent_rte_usage = false

bool	$selfassessmenteditingmode = false

int	$defaultnroftries = 0

string	$questionActionCmd = 'handleQuestionAction'

const	KEY_VALUES_IMPLOSION_SEPARATOR = ':'

Protected Member Functions
	getQuestionAction ()

	isNonEmptyItemListPostSubmission (string $postSubmissionFieldname)

	ensureCurrentTestPass (int $active_id, int $pass)

	lookupCurrentTestPass (int $active_id, int $pass)

	lookupTestId (int $active_id)
	Move to ilObjTest or similar More...

	log (int $active_id, string $langVar)

	savePreviewData (ilAssQuestionPreviewSession $previewSession)

	deletePageOfQuestion (int $question_id)

	onDuplicate (int $originalParentId, int $originalQuestionId, int $duplicateParentId, int $duplicateQuestionId)

	beforeSyncWithOriginal (int $origQuestionId, int $dupQuestionId, int $origParentObjId, int $dupParentObjId)

	afterSyncWithOriginal (int $origQuestionId, int $dupQuestionId, int $origParentObjId, int $dupParentObjId)

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

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

	syncSuggestedSolutionFiles (int $target_question_id, int $target_obj_id)

	copySuggestedSolutionFiles (int $source_questionpool_id, int $source_question_id)

	ensureNonNegativePoints ($points)

	purifyAndPrepareTextAreaOutput (string $content)

	getRTETextWithMediaObjects ()

	getSelfAssessmentFormatter ()

	lmMigrateQuestionTypeGenericContent (ilAssSelfAssessmentMigrator $migrator)

	lmMigrateQuestionTypeSpecificContent (ilAssSelfAssessmentMigrator $migrator)

	duplicateQuestionHints (int $originalQuestionId, int $duplicateQuestionId)

	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 ()
	build basic test question configuration instance More...

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

Protected Attributes
const	HAS_SPECIFIC_FEEDBACK = true

ILIAS HTTP Services	$http

ILIAS Refinery Factory	$refinery

ILIAS DI LoggingServices	$ilLog

int	$id

string	$title

string	$comment

string	$owner

string	$author

int	$thumb_size

string	$question
	The question text. More...

float	$points
	The maximum available points for the question. More...

bool	$shuffle
	Indicates whether the answers will be shuffled or not. More...

int	$test_id
	The database id of a test in which the question is contained. More...

int	$obj_id = 0
	Object id of the container object. More...

	$ilias

ilGlobalPageTemplate	$tpl

ilLanguage	$lng

ilDBInterface	$db

Container	$dic

int	$outputType = OUTPUT_JAVASCRIPT
	Contains the output type of a question. More...

array	$suggested_solutions

int	$original_id = null

	$page

string	$external_id = null

ilAssQuestionProcessLocker	$processLocker

	$step

	$lastChange

Transformation	$shuffler

ilTestQuestionConfig	$testQuestionConfig

ilAssQuestionLifecycle	$lifecycle

ilObjUser	$current_user

Static Protected Attributes
static	$allowedFileExtensionsByMimeType

static	$allowedCharsetsByMimeType

static	$allowedImageMaterialFileExtensionsByMimeType

static	$forcePassResultsUpdateEnabled = false

static	$imageSourceFixReplaceMap

Private Member Functions
	generateExternalId (int $question_id)

	deleteTaxonomyAssignments ()

Private Attributes
const	DEFAULT_THUMB_SIZE = 150

const	MINIMUM_THUMB_SIZE = 20

const	MAXIMUM_THUMB_SIZE = 8192

int	$nr_of_tries

string	$export_image_path
	(Web) Path to images More...

string	$additionalContentEditingMode = ''

bool	$obligationsToBeConsidered = false

ilTestQuestionConfig	$testQuestionConfigInstance = null

Detailed Description

Abstract basic class which is to be extended by the concrete assessment question type classes.

The assQuestion class defines and encapsulates basic/common methods and attributes as well as it provides abstract methods that are to be implemented by concrete question type classes.

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

Version: $Id$

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

Constructor & Destructor Documentation

◆ __construct()

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

assQuestion constructor

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

References $comment, $DIC, $ilDB, $ilLog, $lng, $title, $tpl, ILIAS\UI\examples\Symbol\Glyph\Comment\comment(), ilAssQuestionLifecycle\getDraftInstance(), ILIAS\FileDelivery\http(), ILIAS\Repository\lng(), ILIAS\Repository\refinery(), setAuthor(), setExternalId(), setOwner(), and setQuestion().

       {
         global $DIC;
         $this->dic = $DIC;
         $lng = $DIC['lng'];
         $tpl = $DIC['tpl'];
         $ilDB = $DIC['ilDB'];
         $ilLog = $DIC->logger();
 
         $this->current_user = $DIC['ilUser'];
         $this->lng = $lng;
         $this->tpl = $tpl;
         $this->db = $ilDB;
         $this->ilLog = $ilLog;
         $this->http = $DIC->http();
         $this->refinery = $DIC->refinery();
 
         $this->thumb_size = self::DEFAULT_THUMB_SIZE;
 
         $this->title = $title;
         $this->comment = $comment;
         $this->setAuthor($author);
         $this->setOwner($owner);
 
         $this->setQuestion($question);
 
         $this->id = -1;
         $this->test_id = -1;
         $this->suggested_solutions = [];
         $this->shuffle = 1;
         $this->nr_of_tries = 0;
         $this->setExternalId(null);
 
         $this->questionActionCmd = 'handleQuestionAction';
         $this->export_image_path = '';
         $this->shuffler = $DIC->refinery()->random()->dontShuffle();
         $this->lifecycle = ilAssQuestionLifecycle::getDraftInstance();
     }

Here is the call graph for this function:

Member Function Documentation

◆ __get()

assQuestion::__get ( $value )

Object getter.

Deprecated:: Simply do not use this.

ILIAS 9

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

     {
         throw new BadMethodCallException('assQuestion::__get is discouraged, used with: ' . $value);
     }

◆ __isset()

assQuestion::__isset ( $key )

Object issetter.

Deprecated:: Simply do not use this.

ILIAS 9

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

References ILIAS\LTI\ToolProvider\$key.

     {
         throw new BadMethodCallException('assQuestion::__isset is discouraged, used with: ' . $key);
     }

◆ __set()

assQuestion::__set	(	$key,
		$value
	)

Object setter.

Deprecated:: Simply do not use this.

ILIAS 9

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

References ILIAS\LTI\ToolProvider\$key.

     {
         throw new BadMethodCallException('assQuestion::__set is discouraged, used with: ' . $key);
     }

◆ _areAnswered()

static assQuestion::_areAnswered	(	int	$a_user_id,
		array	$a_question_ids
	)

static

Checks if an array of question ids is answered by a user or not.

Parameters

	int	user_id
array	$question_ids	user id array

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

References $DIC, $ilDB, and $res.

Referenced by ilCourseObjectiveResult\getStatus().

                                                                               : bool
     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
 
         $res = $ilDB->queryF(
             "SELECT DISTINCT(question_fi) FROM tst_test_result JOIN tst_active " .
             "ON (active_id = active_fi) " .
             "WHERE " . $ilDB->in('question_fi', $a_question_ids, false, 'integer') .
             " AND user_fi = %s",
             array('integer'),
             array($a_user_id)
         );
         return ($res->numRows() == count($a_question_ids)) ? true : false;
     }

Here is the caller graph for this function:

◆ _getInternalLinkHref()

static assQuestion::_getInternalLinkHref ( string $target = "" )

static

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

References $DIC, $target_id, and $type.

Referenced by getSuggestedSolutionOutput(), and assQuestionGUI\suggestedsolution().

                                                                     : string
     {
         global $DIC;
         $linktypes = array(
             "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=" . $DIC->testQuestionPool()->internal()->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:

◆ _getMaximumPoints()

static assQuestion::_getMaximumPoints ( int $question_id )

static

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

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

References $DIC, $ilDB, and $points.

Referenced by ilCourseObjectiveQuestion\_lookupMaximumPointsOfQuestion(), ilTestScoringGUI\buildManScoringParticipantForm(), assFileUpload\handleSubmission(), ilTestManScoringParticipantsBySelectedQuestionAndPassTableGUI\initFilter(), ilCourseObjectiveQuestionAssignmentTableGUI\parse(), ilTestScoringGUI\saveManScoringParticipantScreen(), and ilTestScoringByQuestionsGUI\showManScoringByQuestionParticipantsTable().

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

Here is the caller graph for this function:

◆ _getOriginalId()

static assQuestion::_getOriginalId ( int $question_id )

static

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

References $DIC, and $ilDB.

Referenced by ilTestFixedQuestionSetConfig\cloneQuestionSetRelatedData(), ilObjTestGUI\copyAndLinkToQuestionpoolObject(), assOrderingHorizontal\copyObject(), assNumeric\copyObject(), assFileUpload\copyObject(), assImagemapQuestion\copyObject(), assOrderingQuestion\copyObject(), assTextSubset\copyObject(), assTextQuestion\copyObject(), assFlashQuestion\copyObject(), assErrorText\copyObject(), assSingleChoice\copyObject(), assMultipleChoice\copyObject(), assMatchingQuestion\copyObject(), assLongMenu\copyObject(), assFormulaQuestion\copyObject(), assKprimChoice\copyObject(), assClozeTest\copyObject(), assOrderingHorizontal\duplicate(), assNumeric\duplicate(), assFileUpload\duplicate(), assOrderingQuestion\duplicate(), assImagemapQuestion\duplicate(), assTextSubset\duplicate(), assFlashQuestion\duplicate(), assTextQuestion\duplicate(), assErrorText\duplicate(), assSingleChoice\duplicate(), assMultipleChoice\duplicate(), assMatchingQuestion\duplicate(), assLongMenu\duplicate(), assFormulaQuestion\duplicate(), assKprimChoice\duplicate(), assClozeTest\duplicate(), and ilObjTest\logAction().

                                                            : int
     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
         $result = $ilDB->queryF(
             "SELECT * FROM qpl_questions WHERE question_id = %s",
             array('integer'),
             array($question_id)
         );
         if ($ilDB->numRows($result) > 0) {
             $row = $ilDB->fetchAssoc($result);
             if ($row["original_id"] > 0) {
                 return $row["original_id"];
             }
 
             return (int) $row["question_id"];
         }
 
         return -1;
     }

Here is the caller graph for this function:

◆ _getQuestionInfo()

static assQuestion::_getQuestionInfo ( int $question_id )

static

Returns: array Database row as associative array having qpl_questions.*, qpl_qst_type.type_tag

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

References $DIC, and $ilDB.

Referenced by ilObjMediaObject\getParentObjectIdForUsage(), ilTestManScoringParticipantsBySelectedQuestionAndPassTableGUI\initFilter(), and ilTestScoringByQuestionsGUI\showManScoringByQuestionParticipantsTable().

                                                              : array
     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
 
         $result = $ilDB->queryF(
             "SELECT qpl_questions.*, qpl_qst_type.type_tag FROM qpl_qst_type, qpl_questions WHERE qpl_questions.question_id = %s AND qpl_questions.question_type_fi = qpl_qst_type.question_type_id",
             array('integer'),
             array($question_id)
         );
 
         if ($ilDB->numRows($result)) {
             return $ilDB->fetchAssoc($result);
         }
         return [];
     }

Here is the caller graph for this function:

◆ _getQuestionText()

static assQuestion::_getQuestionText ( int $a_q_id )

static

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

References $DIC, and $ilDB.

Referenced by ilLMQuestionListTableGUI\fillRow().

                                                         : string
     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
 
         $result = $ilDB->queryF(
             "SELECT question_text FROM qpl_questions WHERE question_id = %s",
             array('integer'),
             array($a_q_id)
         );
 
         if ($result->numRows() == 1) {
             $row = $ilDB->fetchAssoc($result);
             return $row["question_text"] ?? '';
         }
 
         return "";
     }

Here is the caller graph for this function:

◆ _getQuestionTitle()

static assQuestion::_getQuestionTitle ( int $question_id )

static

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

References $data, $DIC, and $ilDB.

Referenced by ilObjAssessmentFolderGUI\exportLogObject(), ilAssessmentFolderLogTableGUI\fillRow(), and ilObjTest\logManualFeedback().

                                                               : string
     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
 
         if ($question_id < 1) {
             return "";
         }
 
         $result = $ilDB->queryF(
             "SELECT title FROM qpl_questions WHERE qpl_questions.question_id = %s",
             array('integer'),
             array($question_id)
         );
         if ($result->numRows() == 1) {
             $data = $ilDB->fetchAssoc($result);
             return $data["title"];
         }
 
         return "";
     }

Here is the caller graph for this function:

◆ _getQuestionType()

static assQuestion::_getQuestionType ( int $question_id )

static

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

References $data, $DIC, and $ilDB.

Referenced by _needsManualScoring(), ilPageObjectGUI\executeCommand(), instantiateQuestion(), instantiateQuestionGUI(), ilObjTest\isQuestionObligationPossible(), and ilPCQuestionGUI\setTabs().

                                                              : string
     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
 
         if ($question_id < 1) {
             return "";
         }
         $result = $ilDB->queryF(
             "SELECT type_tag FROM qpl_questions, qpl_qst_type WHERE qpl_questions.question_id = %s AND qpl_questions.question_type_fi = qpl_qst_type.question_type_id",
             array('integer'),
             array($question_id)
         );
         if ($result->numRows() == 1) {
             $data = $ilDB->fetchAssoc($result);
             return $data["type_tag"];
         }
 
         return "";
     }

Here is the caller graph for this function:

◆ _getQuestionTypeName()

static assQuestion::_getQuestionTypeName ( $type_tag )

static

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

References $DIC, and ilLanguage\txt().

Referenced by ilObjQuestionPoolGUI\addLocatorItems(), ilTestRandomQuestionSelectionTableGUI\build(), ilCopySelfAssQuestionTableGUI\fillRow(), ilTestQuestionsTableGUI\fillRow(), ilQuestionBrowserTableGUI\fillRow(), ilTestQuestionBrowserTableGUI\fillRow(), assQuestionGUI\outQuestionType(), ilObjTestGUI\removeQuestionsForm(), and ilObjQuestionPoolGUI\setTitleAndDescription().

                                                           : string
     {
         global $DIC;
         if (file_exists("./Modules/TestQuestionPool/classes/class." . $type_tag . ".php")) {
             $lng = $DIC['lng'];
             return $lng->txt($type_tag);
         }
         $component_factory = $DIC['component.factory'];
 
         foreach ($component_factory->getActivePluginsInSlot("qst") as $pl) {
             if ($pl->getQuestionType() === $type_tag) {
                 return $pl->getQuestionTypeTranslation();
             }
         }
         return "";
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _getReachedPoints()

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

static

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

References $DIC, $ilDB, and $points.

Referenced by ilTestScoringByQuestionsGUI\appendFormToModal(), ilTestScoringGUI\buildManScoringParticipantForm(), ilTestServiceGUI\getPassListOfAnswersWithScoring(), ilTestScoringGUI\saveManScoringParticipantScreen(), and ilTestScoringByQuestionsGUI\showManScoringByQuestionParticipantsTable().

                                                                                          : 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",
             array('integer','integer','integer'),
             array($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 2650 of file class.assQuestion.php.

References $DIC, and $ilDB.

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

                                                                                 : ?int
     {
         /*              include_once "./Modules/Test/classes/class.ilObjTest.php";
                 $pass = ilObjTest::_getPass($active_id);
                 return $pass;*/
 
         // 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",
             array('integer','integer'),
             array($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:

◆ _getSuggestedSolution()

assQuestion::_getSuggestedSolution	(	int	$question_id,
		int	$subquestion_index = `0`
	)

Deprecated:: Use loadSuggestedSolution instead ILIAS 9

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

References loadSuggestedSolution().

                                                                                        : array
     {
         return $this->loadSuggestedSolution($question_id, $subquestion_index);
     }

Here is the call graph for this function:

◆ _getSuggestedSolutionCount()

static assQuestion::_getSuggestedSolutionCount ( int $question_id )

static

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

References $DIC, and $ilDB.

                                                                        : int
     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
 
         $result = $ilDB->queryF(
             "SELECT suggested_solution_id FROM qpl_sol_sug WHERE question_fi = %s",
             array('integer'),
             array($question_id)
         );
         return $ilDB->numRows($result);
     }

◆ _getSuggestedSolutionOutput()

static assQuestion::_getSuggestedSolutionOutput ( int $question_id )

static

Returns: string HTML

Exceptions

ilWACException

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

Referenced by ilTestScoringByQuestionsGUI\getAnswerDetail(), 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:

◆ _getTitle()

static assQuestion::_getTitle ( int $a_q_id )

static

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

References $DIC, and $ilDB.

Referenced by ilLMMailNotification\send().

                                                  : string
     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
 
         $result = $ilDB->queryF(
             "SELECT title FROM qpl_questions WHERE question_id = %s",
             array('integer'),
             array($a_q_id)
         );
 
         if ($result->numRows() == 1) {
             $row = $ilDB->fetchAssoc($result);
             return $row["title"];
         }
         return "";
     }

Here is the caller graph for this function:

◆ _getTotalRightAnswers()

static assQuestion::_getTotalRightAnswers ( int $a_q_id )

static

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

References $DIC, $ilDB, and ILIAS\LTI\ToolProvider\$key.

Referenced by ilQuestionCumulatedStatisticsTableGUI\initData().

                                                              : int
     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
 
         $result = $ilDB->queryF(
             "SELECT question_id FROM qpl_questions WHERE original_id = %s OR question_id = %s",
             array('integer','integer'),
             array($a_q_id, $a_q_id)
         );
         if ($result->numRows() == 0) {
             return 0;
         }
 
         $found_id = [];
         while ($row = $ilDB->fetchAssoc($result)) {
             $found_id[] = $row["question_id"];
         }
 
         $result = $ilDB->query("SELECT * FROM tst_test_result WHERE " . $ilDB->in('question_fi', $found_id, false, 'integer'));
         $answers = [];
         while ($row = $ilDB->fetchAssoc($result)) {
             $reached = $row["points"];
             $max = self::_getMaximumPoints($row["question_fi"]);
             $answers[] = array("reached" => $reached, "max" => $max);
         }
         $max = 0.0;
         $reached = 0.0;
         foreach ($answers as $key => $value) {
             $max += $value["max"];
             $reached += $value["reached"];
         }
         if ($max > 0) {
             return $reached / $max;
         }
         return 0;
     }

Here is the caller graph for this function:

◆ _includeClass()

static assQuestion::_includeClass	(	string	$question_type,
		int	$gui = `0`
	)

static

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

Referenced by assQuestionGUI\_getQuestionGUI(), ilObjQuestionPool\createQuestion(), ilObjTest\createQuestionGUI(), ilQTIParser\handlerParseEndTag(), instantiateQuestion(), instantiateQuestionGUI(), and ilObjTest\isQuestionObligationPossible().

                                                                              : void
     {
         if (self::isCoreQuestionType($question_type)) {
             self::includeCoreClass($question_type, $gui);
         }
     }

Here is the caller graph for this function:

◆ _instanciateQuestion()

static assQuestion::_instanciateQuestion ( int $question_id )

static

Deprecated:: use assQuestion::instantiateQuestion() instead.

ILIAS 9

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

Referenced by ilFixMissingQuestionDuplicationMigration\step().

                                                                  : assQuestion
     {
         return self::_instantiateQuestion($question_id);
     }

Here is the caller graph for this function:

◆ _instanciateQuestionGUI()

static assQuestion::_instanciateQuestionGUI ( int $question_id )

static

Deprecated:: Use instantiateQuestionGUI (without legacy underscore & typos) instead.

ILIAS 9

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

                                                                     : assQuestionGUI
     {
         return self::instantiateQuestionGUI($question_id);
     }

◆ _instantiateQuestion()

static assQuestion::_instantiateQuestion ( int $question_id )

static

Deprecated:: use assQuestion::instantiateQuestion() instead.

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

Referenced by ilTestExport\exportToExcel(), ilAssLacQuestionProvider\getQuestion(), ilTestPlayerAbstractGUI\getQuestionInstance(), ilTestExport\getQuestionQtiXml(), ilTestRandomQuestionSetPoolDeriver\getQuestionsForPool(), ilPageObject\newQuestionCopies(), ilAssIncompleteQuestionPurger\purgeQuestionIds(), ilTestScoringByQuestionsGUI\showManScoringByQuestionParticipantsTable(), ilTestRandomQuestionSetStagingPoolBuilder\stageQuestionsFromSourcePoolCheap(), and ilAssQuestionSkillAssignmentsGUI\syncOriginalCmd().

                                                                  : assQuestion
     {
         return self::instantiateQuestion($question_id);
     }

Here is the caller graph for this function:

◆ _isUsedInRandomTest()

static assQuestion::_isUsedInRandomTest ( int $question_id )

static

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

References $DIC, $ilDB, and calculateReachedPoints().

Referenced by ilObjQuestionPool\getDeleteableQuestionDetails().

                                                                 : bool
     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
 
         $result = $ilDB->queryF(
             "SELECT test_random_question_id FROM tst_test_rnd_qst WHERE question_fi = %s",
             array('integer'),
             array($question_id)
         );
         return $ilDB->numRows($result) > 0;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _isWorkedThrough()

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

static

Returns true if the question was worked through in the given pass Worked through means that the user entered at least one value.

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

Referenced by ilObjTest\getAnsweredQuestionCount(), ilTestOutputGUI\handleQuestionPostponing(), and ilTestOutputGUI\showQuestionCmd().

                                                                                         : bool
     {
         return self::lookupResultRecordExist($active_id, $question_id, $pass);
     }

Here is the caller graph for this function:

◆ _isWriteable()

static assQuestion::_isWriteable	(	int	$question_id,
		int	$user_id
	)

static

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

References $DIC, $ilDB, ilObjQuestionPool\_isWriteable(), and ILIAS\Repository\int().

Referenced by ilAssQuestionFeedbackEditingGUI\isSyncAfterSaveRequired(), ilAssQuestionHintsGUI\performDeleteCmd(), assQuestionGUI\save(), assQuestionGUI\saveEdit(), ilAssQuestionHintGUI\saveFormCmd(), ilAssQuestionHintsGUI\saveListOrderCmd(), assQuestionGUI\saveReturn(), assFormulaQuestionGUI\saveReturnFQ(), and assQuestionGUI\suggestedsolution().

                                                                        : bool
     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
 
         if (($question_id < 1) || ($user_id < 1)) {
             return false;
         }
 
         $result = $ilDB->queryF(
             "SELECT obj_fi FROM qpl_questions WHERE question_id = %s",
             array('integer'),
             array($question_id)
         );
         if ($ilDB->numRows($result) == 1) {
             $row = $ilDB->fetchAssoc($result);
             $qpl_object_id = (int) $row["obj_fi"];
             return ilObjQuestionPool::_isWriteable($qpl_object_id, $user_id);
         }
 
         return false;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _needsManualScoring()

static assQuestion::_needsManualScoring ( int $question_id )

static

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

References ilObjAssessmentFolder\_getManualScoringTypes(), and _getQuestionType().

Referenced by ilTestExpressPageObjectGUI\insertQuestions(), ilTestQuestionBrowserTableGUI\insertQuestionsCmd(), and ilObjTestGUI\insertQuestionsObject().

                                                                 : bool
     {
         $scoring = ilObjAssessmentFolder::_getManualScoringTypes();
         $questiontype = assQuestion::_getQuestionType($question_id);
         if (in_array($questiontype, $scoring)) {
             return true;
         }
 
         return false;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _questionExists()

assQuestion::_questionExists ( $question_id )

Returns true if the question already exists in the database.

Parameters

integer $question_id The database id of the question

Returns: boolean True, if the question exists, otherwise False public

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

     {
         if ($question_id < 1) {
             return false;
         }
 
         $result = $this->db->queryF(
             "SELECT question_id FROM qpl_questions WHERE question_id = %s",
             array('integer'),
             array($question_id)
         );
         return $result->numRows() == 1;
     }

◆ _questionExistsInPool()

assQuestion::_questionExistsInPool ( int $question_id )

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

                                                            : bool
     {
         if ($question_id < 1) {
             return false;
         }
 
         $result = $this->db->queryF(
             "SELECT question_id FROM qpl_questions INNER JOIN object_data ON obj_fi = obj_id WHERE question_id = %s AND type = 'qpl'",
             array('integer'),
             array($question_id)
         );
         return $this->db->numRows($result) == 1;
     }

◆ _questionExistsInTest()

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

static

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

References $DIC, and $ilDB.

Referenced by assQuestionGUI\save(), assQuestionGUI\saveReturn(), and assFormulaQuestionGUI\saveReturnFQ().

                                                                                 : 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",
             array('integer', 'integer'),
             array($question_id, $test_id)
         );
         return $ilDB->numRows($result) == 1;
     }

Here is the caller graph for this function:

◆ _resolveInternalLink()

assQuestion::_resolveInternalLink ( string $internal_link )

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

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

Referenced by _resolveIntLinks(), and setSuggestedSolution().

                                                                : string
     {
         if (preg_match("/il_(\d+)_(\w+)_(\d+)/", $internal_link, $matches)) {
             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 (strcmp($resolved_link, "") == 0) {
                 $resolved_link = $internal_link;
             }
         } else {
             $resolved_link = $internal_link;
         }
         return $resolved_link;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _resolveIntLinks()

assQuestion::_resolveIntLinks ( int $question_id )

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

References ilInternalLink\_deleteAllLinksOfSource(), _resolveInternalLink(), and ilInternalLink\_saveLink().

Referenced by ilQuestionPageParser\processPagesToParse().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _setReachedPoints()

static assQuestion::_setReachedPoints	(	int	$active_id,
		int	$question_id,
		float	$points,
		float	$maxpoints,
		int	$pass,
		bool	$manualscoring,
		bool	$obligationsEnabled
	)

static

Sets the points, a learner has reached answering the question Additionally objective results are updated.

Parameters

integer	$user_id	The database ID of the learner
integer	$test_id	The database Id of the test containing the question
integer	$points	The points the user has reached answering the question

Returns: boolean true on success, otherwise false public

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

References $DIC, Vendor\Package\$e, $ilDB, $ilUser, $points, ilObjAssessmentFolder\_enabledAssessmentLogging(), ilObjAssessmentFolder\_getLogLanguage(), ilObjTestAccess\_getParticipantData(), _getSolutionMaxPass(), ilObjTest\_getUserIdFromActiveId(), ilCourseObjectiveResult\_updateObjectiveResult(), logAction(), and ilLanguage\txtlng().

Referenced by assFileUpload\handleSubmission(), ilTestScoring\recalculatePass(), ilTestScoringGUI\saveManScoringParticipantScreen(), and ilTestScoringByQuestionsGUI\showManScoringByQuestionParticipantsTable().

                                                                                                                                                                          : bool
     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
         $refinery = $DIC['refinery'];
 
         $float_trafo = $refinery->kindlyTo()->float();
         try {
             $points = $float_trafo->transform($points);
         } catch (ILIAS\Refinery\ConstraintViolationException $e) {
             return false;
         }
 
         if ($points <= $maxpoints) {
             if ($pass === null) {
                 $pass = assQuestion::_getSolutionMaxPass($question_id, $active_id);
             }
 
             $rowsnum = 0;
             $old_points = 0;
 
             if ($pass !== null) {
                 $result = $ilDB->queryF(
                     "SELECT points FROM tst_test_result WHERE active_fi = %s AND question_fi = %s AND pass = %s",
                     array('integer','integer','integer'),
                     array($active_id, $question_id, $pass)
                 );
                 $manual = ($manualscoring) ? 1 : 0;
                 $rowsnum = $result->numRows();
             }
             if ($rowsnum > 0) {
                 $row = $ilDB->fetchAssoc($result);
                 $old_points = $row["points"];
                 if ($old_points != $points) {
                     $affectedRows = $ilDB->manipulateF(
                         "UPDATE tst_test_result SET points = %s, manual = %s, tstamp = %s WHERE active_fi = %s AND question_fi = %s AND pass = %s",
                         array('float', 'integer', 'integer', 'integer', 'integer', 'integer'),
                         array($points, $manual, time(), $active_id, $question_id, $pass)
                     );
                 }
             } else {
                 $next_id = $ilDB->nextId('tst_test_result');
                 $affectedRows = $ilDB->manipulateF(
                     "INSERT INTO tst_test_result (test_result_id, active_fi, question_fi, points, pass, manual, tstamp) VALUES (%s, %s, %s, %s, %s, %s, %s)",
                     array('integer', 'integer','integer', 'float', 'integer', 'integer','integer'),
                     array($next_id, $active_id, $question_id, $points, $pass, $manual, time())
                 );
             }
 
             if (self::isForcePassResultUpdateEnabled() || $old_points != $points || $rowsnum == 0) {
                 assQuestion::_updateTestPassResults($active_id, $pass, $obligationsEnabled);
                 ilCourseObjectiveResult::_updateObjectiveResult(ilObjTest::_getUserIdFromActiveId($active_id), $question_id, $points);
                 if (ilObjAssessmentFolder::_enabledAssessmentLogging()) {
                     global $DIC;
                     $lng = $DIC['lng'];
                     $ilUser = $DIC['ilUser'];
                     $username = ilObjTestAccess::_getParticipantData($active_id);
                     assQuestion::logAction(sprintf(
                         $lng->txtlng(
                             "assessment",
                             "log_answer_changed_points",
                             ilObjAssessmentFolder::_getLogLanguage()
                         ),
                         $username,
                         $old_points,
                         $points,
                         $ilUser->getFullname() . " (" . $ilUser->getLogin() . ")"
                     ), $active_id, $question_id);
                 }
             }
 
             return true;
         }
 
         return false;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _updateTestResultCache()

static assQuestion::_updateTestResultCache	(	int	$active_id,
		ilAssQuestionProcessLocker	$processLocker = `null`
	)

static

Move this to a proper place.

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

References $data, $DIC, $ilDB, $query, $res, ilObjTest\_getQuestionCountAndPointsForPassOfParticipant(), ilObjTest\_getResultPass(), ilObjTest\_getWorkingTimeOfParticipantForPass(), ilObjTest\buildExamId(), and ILIAS\Repository\int().

Referenced by ilObjTestAccess\_getPassedUsers(), ilObjTestAccess\_isPassed(), ilObjTest\getResultsForActiveId(), ilTestScoring\recalculateSolution(), ilTestScoring\recalculateSolutions(), ilTestEvaluationGUI\redirectToPassDeletionContext(), ilTestScoring\updatePassAndTestResults(), and ilObjTestAccess\updateTestResultCache().

                                                                                                                    : void
     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
 
         $pass = ilObjTest::_getResultPass($active_id);
 
         if ($pass !== null) {
             $query = "
                 SELECT          tst_pass_result.*
                 FROM            tst_pass_result
                 WHERE           active_fi = %s
                 AND                     pass = %s
             ";
 
             $result = $ilDB->queryF(
                 $query,
                 array('integer','integer'),
                 array($active_id, $pass)
             );
 
             $test_pass_result_row = $ilDB->fetchAssoc($result);
 
             if (!is_array($test_pass_result_row)) {
                 $test_pass_result_row = [];
             }
             $max = (float) ($test_pass_result_row['maxpoints'] ?? 0);
             $reached = (float) ($test_pass_result_row['points'] ?? 0);
             $percentage = ($max <= 0.0 || $reached <= 0.0) ? 0 : ($reached / $max) * 100.0;
 
             $obligationsAnswered = (int) ($test_pass_result_row['obligations_answered'] ?? 1);
 
             $mark = ASS_MarkSchema::_getMatchingMarkFromActiveId($active_id, $percentage);
             $isPassed = isset($mark["passed"]) && $mark["passed"];
 
             $hint_count = $test_pass_result_row['hint_count'] ?? 0;
             $hint_points = $test_pass_result_row['hint_points'] ?? 0.0;
 
             $userTestResultUpdateCallback = function () use ($ilDB, $active_id, $pass, $max, $reached, $isPassed, $obligationsAnswered, $hint_count, $hint_points, $mark) {
                 $passedOnceBefore = 0;
                 $query = "SELECT passed_once FROM tst_result_cache WHERE active_fi = %s";
                 $res = $ilDB->queryF($query, array('integer'), array($active_id));
                 while ($passed_once_result_row = $ilDB->fetchAssoc($res)) {
                     $passedOnceBefore = (int) $passed_once_result_row['passed_once'];
                 }
 
                 $passedOnce = (int) ($isPassed || $passedOnceBefore);
 
                 $ilDB->manipulateF(
                     "DELETE FROM tst_result_cache WHERE active_fi = %s",
                     array('integer'),
                     array($active_id)
                 );
 
                 $ilDB->insert('tst_result_cache', array(
                     'active_fi' => array('integer', $active_id),
                     'pass' => array('integer', strlen($pass) ? $pass : 0),
                     'max_points' => array('float', strlen($max) ? $max : 0),
                     'reached_points' => array('float', strlen($reached) ? $reached : 0),
                     'mark_short' => array('text', strlen($mark["short_name"] ?? '') ? $mark["short_name"] : " "),
                     'mark_official' => array('text', strlen($mark["official_name"] ?? '') ? $mark["official_name"] : " "),
                     'passed_once' => array('integer', $passedOnce),
                     'passed' => array('integer', (int) $isPassed),
                     'failed' => array('integer', (int) !$isPassed),
                     'tstamp' => array('integer', time()),
                     'hint_count' => array('integer', $hint_count),
                     'hint_points' => array('float', $hint_points),
                     'obligations_answered' => array('integer', $obligationsAnswered)
                 ));
             };
 
             if (is_object($processLocker)) {
                 $processLocker->executeUserTestResultUpdateLockOperation($userTestResultUpdateCallback);
             } else {
                 $userTestResultUpdateCallback();
             }
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ addAnswerOptionValue()

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

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

                                                                                                : void
     {
     }

◆ addQTIMaterial()

assQuestion::addQTIMaterial	(	ilXmlWriter	$a_xml_writer,
		string	$a_material,
		bool	$close_material_tag = `true`,
		bool	$add_mobs = `true`
	)

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

References $mobs, ilObjMediaObject\_exists(), ilObjMediaObject\_getMobsOfObject(), ilRTE\_replaceMediaObjectImageSrc(), getId(), IL_INST_ID, isHTML(), ilXmlWriter\xmlElement(), ilXmlWriter\xmlEndTag(), and ilXmlWriter\xmlStartTag().

                                                                                                                                          : void
     {
         $a_xml_writer->xmlStartTag("material");
         $attrs = array(
             "texttype" => "text/plain"
         );
         if ($this->isHTML($a_material)) {
             $attrs["texttype"] = "text/xhtml";
         }
         $a_xml_writer->xmlElement("mattext", $attrs, ilRTE::_replaceMediaObjectImageSrc($a_material, 0));
         if ($add_mobs) {
             $mobs = ilObjMediaObject::_getMobsOfObject("qpl:html", $this->getId());
             foreach ($mobs as $mob) {
                 $moblabel = "il_" . IL_INST_ID . "_mob_" . $mob;
                 if (strpos($a_material, "mm_$mob") !== false) {
                     if (ilObjMediaObject::_exists($mob)) {
                         $mob_obj = new ilObjMediaObject($mob);
                         $imgattrs = array(
                             "label" => $moblabel,
                             "uri" => "objects/" . "il_" . IL_INST_ID . "_mob_" . $mob . "/" . $mob_obj->getTitle()
                         );
                     }
                     $a_xml_writer->xmlElement("matimage", $imgattrs, null);
                 }
             }
         }
         if ($close_material_tag) {
             $a_xml_writer->xmlEndTag("material");
         }
     }

Here is the call graph for this function:

◆ adjustReachedPointsByScoringOptions()

assQuestion::adjustReachedPointsByScoringOptions	(	$points,
		$active_id,
		$pass = `null`
	)

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 2766 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	$origQuestionId,
		int	$dupQuestionId,
		int	$origParentObjId,
		int	$dupParentObjId
	)

protected

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

Referenced by syncWithOriginal().

                                                                                                                                 : void
     {
         $this->feedbackOBJ->syncFeedback($origQuestionId, $dupQuestionId);
     }

Here is the caller graph for this function:

◆ areObligationsToBeConsidered()

assQuestion::areObligationsToBeConsidered ( )

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

References $obligationsToBeConsidered.

Referenced by resetUsersAnswer().

                                                   : bool
     {
         return $this->obligationsToBeConsidered;
     }

Here is the caller graph for this function:

◆ authorizedOrIntermediateSolutionExists()

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

Definition at line 3943 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 3934 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:

◆ beforeSyncWithOriginal()

assQuestion::beforeSyncWithOriginal	(	int	$origQuestionId,
		int	$dupQuestionId,
		int	$origParentObjId,
		int	$dupParentObjId
	)

protected

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

Referenced by syncWithOriginal().

                                                                                                                                  : void
     {
     }

Here is the caller graph for this function:

◆ buildHashedImageFilename()

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

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

Referenced by assKprimChoice\handleFileUpload(), 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 caller graph for this function:

◆ buildImagePath()

assQuestion::buildImagePath	(	$questionId,
		$parentObjectId
	)

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

References CLIENT_WEB_DIR.

Referenced by assKprimChoice\afterSyncWithOriginal(), assSingleChoice\afterSyncWithOriginal(), assMatchingQuestion\afterSyncWithOriginal(), and getImagePath().

                                                                 : string
     {
         return CLIENT_WEB_DIR . "/assessment/{$parentObjectId}/{$questionId}/images/";
     }

Here is the caller graph for this function:

◆ buildQuestionDataQuery()

assQuestion::buildQuestionDataQuery ( )

protected

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

build basic test question configuration instance

method can be overwritten to configure an instance use parent call for building when possible

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

Referenced by getTestPresentationConfig().

                                                     : ilTestQuestionConfig
     {
         return new ilTestQuestionConfig();
     }

Here is the caller graph for this function:

◆ calculateReachedPoints()

assQuestion::calculateReachedPoints	(	$active_id,
		$pass = `null`,
		$authorizedSolution = `true`,
		$returndetails = `false`
	)

abstract

Returns the points, a learner has reached answering the question.

The points are calculated from the given answers.

public

Parameters

integer	$active_id
integer	$pass
boolean	$returndetails	(deprecated !!)

Returns: integer/array $points/$details (array $details is deprecated !!)

Referenced by _isUsedInRandomTest(), assNumeric\calculateReachedPointsFromPreviewSession(), calculateResultsFromSolution(), getAdjustedReachedPoints(), and assNumeric\getExpressionTypes().

Here is the caller graph for this function:

◆ calculateReachedPointsFromPreviewSession()

assQuestion::calculateReachedPointsFromPreviewSession ( ilAssQuestionPreviewSession $previewSession )

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

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

Referenced by isPreviewSolutionCorrect().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ calculateResultsFromSolution()

assQuestion::calculateResultsFromSolution	(	int	$active_id,
		int	$pass,
		bool	$obligationsEnabled = `false`
	)

final

Calculates the question results from a previously saved question solution.

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

References $DIC, $ilDB, $ilUser, $query, ilObjAssessmentFolder\_enabledAssessmentLogging(), ilObjAssessmentFolder\_getLogLanguage(), ilCourseObjectiveResult\_updateObjectiveResult(), adjustReachedPointsByScoringOptions(), calculateReachedPoints(), getId(), getProcessLocker(), getStep(), isAnswered(), ilObjTest\isQuestionObligatory(), ILIAS\Repository\lng(), logAction(), and lookupForExistingSolutions().

Referenced by persistWorkingState().

                                                                                                                    : void
     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
         $ilUser = $DIC['ilUser'];
 
         // determine reached points for submitted solution
         $reached_points = $this->calculateReachedPoints($active_id, $pass);
         $questionHintTracking = new ilAssQuestionHintTracking($this->getId(), $active_id, $pass);
         $requestsStatisticData = $questionHintTracking->getRequestStatisticDataByQuestionAndTestpass();
         $reached_points = $reached_points - $requestsStatisticData->getRequestsPoints();
 
         // adjust reached points regarding to tests scoring options
         $reached_points = $this->adjustReachedPointsByScoringOptions($reached_points, $active_id, $pass);
 
         if ($obligationsEnabled && ilObjTest::isQuestionObligatory($this->getId())) {
             $isAnswered = $this->isAnswered($active_id, $pass);
         } else {
             $isAnswered = true;
         }
 
         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
         $existingSolutions = $this->lookupForExistingSolutions($active_id, $pass);
 
         $this->getProcessLocker()->executeUserQuestionResultUpdateOperation(function () use ($ilDB, $active_id, $pass, $reached_points, $requestsStatisticData, $isAnswered, $existingSolutions) {
             $query = "
                         DELETE FROM             tst_test_result
 
                         WHERE                   active_fi = %s
                         AND                             question_fi = %s
                         AND                             pass = %s
                 ";
 
             $types = array('integer', 'integer', 'integer');
             $values = array($active_id, $this->getId(), $pass);
 
             if ($this->getStep() !== null) {
                 $query .= "
                                 AND                             step = %s
                         ";
 
                 $types[] = 'integer';
                 $values[] = $this->getStep();
             }
             $ilDB->manipulateF($query, $types, $values);
 
             if ($existingSolutions['authorized']) {
                 $next_id = $ilDB->nextId("tst_test_result");
                 $fieldData = array(
                     'test_result_id' => array('integer', $next_id),
                     'active_fi' => array('integer', $active_id),
                     'question_fi' => array('integer', $this->getId()),
                     'pass' => array('integer', $pass),
                     'points' => array('float', $reached_points),
                     'tstamp' => array('integer', time()),
                     'hint_count' => array('integer', $requestsStatisticData->getRequestsCount()),
                     'hint_points' => array('float', $requestsStatisticData->getRequestsPoints()),
                     'answered' => array('integer', $isAnswered)
                 );
 
                 if ($this->getStep() !== null) {
                     $fieldData['step'] = array('integer', $this->getStep());
                 }
 
                 $ilDB->insert('tst_test_result', $fieldData);
             }
         });
 
         if (ilObjAssessmentFolder::_enabledAssessmentLogging()) {
             assQuestion::logAction(
                 sprintf(
                     $this->lng->txtlng(
                         "assessment",
                         "log_user_answered_question",
                         ilObjAssessmentFolder::_getLogLanguage()
                     ),
                     $reached_points
                 ),
                 $active_id,
                 $this->getId()
             );
         }
 
         // update test pass results
         self::_updateTestPassResults($active_id, $pass, $obligationsEnabled, $this->getProcessLocker());
         ilCourseObjectiveResult::_updateObjectiveResult($ilUser->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 3103 of file class.assQuestion.php.

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

Referenced by saveToDb(), and updateSuggestedSolutions().

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

◆ convertISO8601FormatH_i_s_ExtendedToSeconds()

static assQuestion::convertISO8601FormatH_i_s_ExtendedToSeconds ( string $time )

static

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

◆ copyPageOfQuestion()

assQuestion::copyPageOfQuestion ( int $a_q_id )

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

References $page, and $xml.

Referenced by syncWithOriginal().

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

Here is the caller graph for this function:

◆ copySuggestedSolutionFiles()

assQuestion::copySuggestedSolutionFiles	(	int	$source_questionpool_id,
		int	$source_question_id
	)

protected

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

References $filename, $index, getSuggestedSolutionPath(), and ilFileUtils\makeDirParents().

Referenced by onCopy().

                                                                                                        : void
     {
         foreach ($this->suggested_solutions as $index => $solution) {
             if (strcmp($solution["type"], "file") == 0) {
                 $filepath = $this->getSuggestedSolutionPath();
                 $filepath_original = str_replace("/$this->obj_id/$this->id/solution", "/$source_questionpool_id/$source_question_id/solution", $filepath);
                 if (!file_exists($filepath)) {
                     ilFileUtils::makeDirParents($filepath);
                 }
                 $filename = $solution["value"]["name"];
                 if (strlen($filename)) {
                     if (!copy($filepath_original . $filename, $filepath . $filename)) {
                         $this->ilLog->root()->error("File could not be copied!!!!");
                         $this->ilLog->root()->error("object: " . print_r($this, true));
                     }
                 }
             }
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ copyXHTMLMediaObjectsOfQuestion()

assQuestion::copyXHTMLMediaObjectsOfQuestion ( int $a_q_id )

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

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

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

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

References $current_user, $ilUser, ilObject\_lookupObjId(), createPageObject(), getAdditionalContentEditingMode(), getAuthor(), getDefaultNrOfTries(), getExternalId(), getId(), getObjId(), getQuestionTypeID(), and setId().

                                                                  : int
     {
         $ilUser = $this->current_user;
 
         $complete = "0";
         $obj_id = ($this->getObjId() <= 0) ? (ilObject::_lookupObjId((strlen($this->dic->testQuestionPool()->internal()->request()->getRefId())) ? $this->dic->testQuestionPool()->internal()->request()->getRefId() : $_POST["sel_qpl"])) : $this->getObjId();
         if ($obj_id > 0) {
             if ($a_create_page) {
                 $tstamp = 0;
             } else {
                 // question pool must not try to purge
                 $tstamp = time();
             }
 
             $next_id = $this->db->nextId('qpl_questions');
             $this->db->insert("qpl_questions", array(
                 "question_id" => array("integer", $next_id),
                 "question_type_fi" => array("integer", $this->getQuestionTypeID()),
                 "obj_fi" => array("integer", $obj_id),
                 "title" => array("text", null),
                 "description" => array("text", null),
                 "author" => array("text", $this->getAuthor()),
                 "owner" => array("integer", $ilUser->getId()),
                 "question_text" => array("clob", null),
                 "points" => array("float", "0.0"),
                 "nr_of_tries" => array("integer", $this->getDefaultNrOfTries()), // #10771
                 "complete" => array("text", $complete),
                 "created" => array("integer", time()),
                 "original_id" => array("integer", null),
                 "tstamp" => array("integer", $tstamp),
                 "external_id" => array("text", $this->getExternalId()),
                 'add_cont_edit_mode' => array('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 1774 of file class.assQuestion.php.

References getId(), and getObjId().

Referenced by createNewQuestion(), saveQuestionDataToDb(), and syncWithOriginal().

                                       : 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	$previewSession,
			$reachedPoints
	)

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

References $DIC, and ilAssQuestionPreviewHintTracking\getRequestStatisticData().

                                                                                                                   : ?float
     {
         global $DIC;
 
         $hintTracking = new ilAssQuestionPreviewHintTracking($DIC->database(), $previewSession);
         $requestsStatisticData = $hintTracking->getRequestStatisticData();
         $reachedPoints = $reachedPoints - $requestsStatisticData->getRequestsPoints();
 
         return $reachedPoints;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ delete()

assQuestion::delete ( int $question_id )

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

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

                                             : void
     {
         if ($question_id < 1) {
             return;
         }
 
         $result = $this->db->queryF(
             "SELECT obj_fi FROM qpl_questions WHERE question_id = %s",
             array('integer'),
             array($question_id)
         );
         if ($this->db->numRows($result) == 1) {
             $row = $this->db->fetchAssoc($result);
             $obj_id = $row["obj_fi"];
         } else {
             return; // nothing to do
         }
         try {
             $this->deletePageOfQuestion($question_id);
         } catch (Exception $e) {
             $this->ilLog->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",
             array('integer'),
             array($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->ilLog->root()->error("EXCEPTION: Could not delete additional table data of question $question_id: $e");
             return;
         }
 
         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",
                 array('integer'),
                 array($question_id)
             );
         } catch (Exception $e) {
             $this->ilLog->root()->error("EXCEPTION: Could not delete delete question $question_id from a test: $e");
             return;
         }
 
         try {
             // delete suggested solutions contained in the question
             $affectedRows = $this->db->manipulateF(
                 "DELETE FROM qpl_sol_sug WHERE question_fi = %s",
                 array('integer'),
                 array($question_id)
             );
         } catch (Exception $e) {
             $this->ilLog->root()->error("EXCEPTION: Could not delete suggested solutions of question $question_id: $e");
             return;
         }
 
         try {
             $directory = CLIENT_WEB_DIR . "/assessment/" . $obj_id . "/$question_id";
             if (preg_match("/\d+/", $obj_id) and preg_match("/\d+/", $question_id) and is_dir($directory)) {
                 ilFileUtils::delDir($directory);
             }
         } catch (Exception $e) {
             $this->ilLog->root()->error("EXCEPTION: Could not delete question file directory $directory of question $question_id: $e");
             return;
         }
 
         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->ilLog->root()->error("EXCEPTION: Error deleting the media objects of question $question_id: $e");
             return;
         }
         ilAssQuestionHintTracking::deleteRequestsByQuestionIds(array($question_id));
         ilAssQuestionHintList::deleteHintsByQuestionIds(array($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()) {
                 ilSkillUsage::setUsage(
                     $assignment->getParentObjId(),
                     $assignment->getSkillBaseId(),
                     $assignment->getSkillTrefId(),
                     false
                 );
             }
         }
 
         $this->deleteTaxonomyAssignments();
 
         try {
             ilObjQuestionPool::_updateQuestionCount($this->getObjId());
         } catch (Exception $e) {
             $this->ilLog->root()->error("EXCEPTION: Error updating the question pool question count of question pool " . $this->getObjId() . " when deleting question $question_id: $e");
             return;
         }
     }

Here is the call graph for this function:

◆ deleteAdditionalTableData()

assQuestion::deleteAdditionalTableData ( int $question_id )

Definition at line 1483 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 = array($additional_table_name);
         }
 
         foreach ($additional_table_name as $table) {
             if (strlen($table)) {
                 $this->db->manipulateF(
                     "DELETE FROM $table WHERE question_fi = %s",
                     array('integer'),
                     array($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 1464 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 = array($answer_table_name);
         }
 
         foreach ($answer_table_name as $table) {
             if (strlen($table)) {
                 $this->db->manipulateF(
                     "DELETE FROM $table WHERE question_fi = %s",
                     array('integer'),
                     array($question_id)
                 );
             }
         }
     }

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

References getSolutionValues(), and removeSolutionRecordById().

Referenced by assFileUpload\saveWorkingData(), and assImagemapQuestion\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 1502 of file class.assQuestion.php.

References $page, and ilPageObject\_exists().

Referenced by delete(), and syncWithOriginal().

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

References $query, getId(), and getStep().

Referenced by assImagemapQuestion\saveWorkingData().

                                                                                                                         : void
     {
         $types = array("integer", "integer", "integer", "integer");
         $values = array($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:

Here is the caller graph for this function:

◆ deleteSuggestedSolutions()

assQuestion::deleteSuggestedSolutions ( )

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

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

                                               : void
     {
         // delete the links in the qpl_sol_sug table
         $this->db->manipulateF(
             "DELETE FROM qpl_sol_sug WHERE question_fi = %s",
             array('integer'),
             array($this->getId())
         );
         ilInternalLink::_deleteAllLinksOfSource("qst", $this->getId());
         $this->suggested_solutions = [];
         ilFileUtils::delDir($this->getSuggestedSolutionPath());
     }

Here is the call graph for this function:

◆ deleteTaxonomyAssignments()

assQuestion::deleteTaxonomyAssignments ( )

private

Definition at line 1635 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 = `""`,
		string	$owner = `""`,
			$testObjId = `null`
	)

abstract

Referenced by toJSON().

Here is the caller graph for this function:

◆ duplicateIntermediateSolutionAuthorized()

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

protected

Definition at line 3862 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	$originalQuestionId,
		int	$duplicateQuestionId
	)

protected

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

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

Referenced by onCopy(), and onDuplicate().

                                                                                                 : void
     {
         $hintIds = ilAssQuestionHintList::duplicateListForQuestion($originalQuestionId, $duplicateQuestionId);
 
         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 3450 of file class.assQuestion.php.

References ilSkillUsage\setUsage().

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
             ilSkillUsage::setUsage(
                 $trgParentId,
                 $assignment->getSkillBaseId(),
                 $assignment->getSkillTrefId()
             );
         }
     }

Here is the call graph for this function:

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

References $filename, $index, getSuggestedSolutionPath(), and ilFileUtils\makeDirParents().

Referenced by onDuplicate().

                                                                                         : void
     {
         foreach ($this->suggested_solutions as $index => $solution) {
             if (!is_array($solution) ||
                 !array_key_exists("type", $solution) ||
                 strcmp($solution["type"], "file") !== 0) {
                 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);
             }
             $filename = $solution["value"]["name"];
             if (strlen($filename)) {
                 if (!copy($filepath_original . $filename, $filepath . $filename)) {
                     $this->ilLog->root()->error("File could not be duplicated!!!!");
                     $this->ilLog->root()->error("object: " . print_r($this, true));
                 }
             }
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ensureCurrentTestPass()

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

protected

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

References lookupCurrentTestPass().

Referenced by assFileUpload\saveWorkingData().

                                                                        : int
     {
         if (is_int($pass) && $pass >= 0) {
             return $pass;
         }
 
         return $this->lookupCurrentTestPass($active_id, $pass);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ensureHintPageObjectExists()

assQuestion::ensureHintPageObjectExists ( $pageObjectId )

Definition at line 3495 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 ( $points )

protected

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

References $points.

     {
         return $points > 0 ? $points : 0;
     }

Here is the caller graph for this function:

◆ explodeKeyValues()

static assQuestion::explodeKeyValues ( string $keyValues )

static

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

References KEY_VALUES_IMPLOSION_SEPARATOR.

Referenced by assImagemapQuestion\getReuseSolutionSelectionParameter().

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

Here is the caller graph for this function:

◆ 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 4254 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 $valuePairs )

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

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

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

Here is the caller graph for this function:

◆ fetchMimeTypeIdentifier()

static assQuestion::fetchMimeTypeIdentifier ( string $contentType )

static

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

Referenced by ilQtiMatImageSecurity\validateContent().

                                                                        : string
     {
         return current(explode(';', $contentType));
     }

Here is the caller graph for this function:

◆ fetchValuePairsFromIndexedValues()

assQuestion::fetchValuePairsFromIndexedValues ( array $indexedValues )

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

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

◆ fixSvgToPng()

assQuestion::fixSvgToPng ( string $imageFilenameContainingString )

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

Referenced by getSuggestedSolutionOutput().

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

Here is the caller graph for this function:

◆ fixUnavailableSkinImageSources()

assQuestion::fixUnavailableSkinImageSources ( string $html )

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

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

Referenced by getSuggestedSolutionOutput().

                                                                 : 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] === 'Modules' || $levels[4] === 'Services') {
                     $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:

Here is the caller graph for this function:

◆ forceExistingIntermediateSolution()

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

protected

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

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

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

                                                                                                                           : void
     {
         $intermediateSolution = $this->getSolutionValues($activeId, $passIndex, false);
 
         if (!count($intermediateSolution)) {
             // make the authorized solution intermediate (keeping timestamps)
             // this keeps the solution_ids in synch with eventually selected in $_POST['deletefiles']
             $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 3344 of file class.assQuestion.php.

References getSelfAssessmentFormatter().

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

                                           : 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	(		$item,
		int	$questionpool_id,
		?int	$tst_id,
		&	$tst_object,
		int &	$question_counter,
		array	$import_mapping,
		array &	$solutionhints = `[]`
	)

Receives parameters from a QTI parser and creates a valid ILIAS question object.

Parameters

object	$item	The QTI item object
integer	$questionpool_id	The id of the parent questionpool
integer	$tst_id	The id of the parent test if the question is part of a test
object	$tst_object	A reference to the parent test object
integer	$question_counter	A reference to a question counter to count the questions of an imported question pool
array	$import_mapping	An array containing references to included ILIAS objects

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

References getQuestionType().

                                                                                                                                                                : array
     {
         $classname = $this->getQuestionType() . "Import";
         $import = new $classname($this);
         $import_mapping = $import->fromXML($item, $questionpool_id, $tst_id, $tst_object, $question_counter, $import_mapping);
 
         foreach ($solutionhints as $hint) {
             $h = new ilAssQuestionHint();
             $h->setQuestionId($import->getQuestionId());
             $h->setIndex($hint['index'] ?? "");
             $h->setPoints($hint['points'] ?? "");
             $h->setText($hint['txt'] ?? "");
             $h->save();
         }
         return $import_mapping;
     }

Here is the call graph for this function:

◆ generateExternalId()

assQuestion::generateExternalId ( int $question_id )

private

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

References IL_INST_ID.

Referenced by getExternalId().

                                                          : string
     {
         if ($question_id > 0) {
             return 'il_' . IL_INST_ID . '_qst_' . $question_id;
         }
 
         return uniqid('', true);
     }

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

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

◆ getAdditionalContentEditingMode()

assQuestion::getAdditionalContentEditingMode ( )

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

References $additionalContentEditingMode.

Referenced by createNewQuestion(), isAdditionalContentEditingModePageObject(), assMultipleChoice\isForcedEmptySolution(), assSingleChoice\savePreviewData(), and saveQuestionDataToDb().

                                                      : string
     {
         return $this->additionalContentEditingMode;
     }

Here is the caller graph for this function:

◆ getAdditionalTableName()

assQuestion::getAdditionalTableName ( )

Returns: string|array Or Array?

See also: Deletion methods here

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

Referenced by deleteAdditionalTableData().

     {
         return "";
     }

Here is the caller graph for this function:

◆ getAdjustedReachedPoints()

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

final

returns the reached points ...

calculated by concrete question type class
adjusted by hint point deduction
adjusted by scoring options ... for given testactive and testpass

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

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

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

Here is the call graph for this function:

◆ getAllowedFileExtensionsForMimeType()

static assQuestion::getAllowedFileExtensionsForMimeType ( string $mimeType )

static

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

                                                                                 : array
     {
         foreach (self::$allowedFileExtensionsByMimeType as $allowedMimeType => $extensions) {
             $rexCharsets = implode('|', self::$allowedCharsetsByMimeType[$allowedMimeType]);
             $rexMimeType = preg_quote($allowedMimeType, '/');
 
             $rex = '/^' . $rexMimeType . '(;(\s)*charset=(' . $rexCharsets . '))*$/';
 
             if (!preg_match($rex, $mimeType)) {
                 continue;
             }
 
             return $extensions;
         }
 
         return [];
     }

◆ getAllowedImageMaterialFileExtensions()

static assQuestion::getAllowedImageMaterialFileExtensions ( )

static

Returns: array all allowed file extensions for image material

SlowArrayOperationsInLoopInspection

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

Referenced by ilImageWizardInputGUI\__construct().

                                                                   : array
     {
         $extensions = [];
 
         foreach (self::$allowedImageMaterialFileExtensionsByMimeType as $mimeType => $mimeExtensions) {
             $extensions = array_merge($extensions, $mimeExtensions);
         }
         return array_unique($extensions);
     }

Here is the caller graph for this function:

◆ getAnswerTableName()

assQuestion::getAnswerTableName ( )

Returns: string|array Or Array?

See also: Deletion methods here

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

Referenced by deleteAnswers().

     {
         return "";
     }

Here is the caller graph for this function:

◆ getAuthor()

assQuestion::getAuthor ( )

Definition at line 598 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 603 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 543 of file class.assQuestion.php.

References $comment.

Referenced by saveQuestionDataToDb().

                                 : string
     {
         return $this->comment;
     }

Here is the caller graph for this function:

◆ getCurrentSolutionResultSet()

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

protected

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

References $query, 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,
                 array('integer', 'integer', 'integer', 'integer', 'integer'),
                 array($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,
             array('integer', 'integer', 'integer', 'integer'),
             array($active_id, $this->getId(), $pass, (int) $authorized)
         );
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getDefaultNrOfTries()

assQuestion::getDefaultNrOfTries ( )

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

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

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

Here is the call graph for this function:

◆ getExternalId()

assQuestion::getExternalId ( )

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

References $external_id, generateExternalId(), and getId().

Referenced by createNewQuestion(), and saveQuestionDataToDb().

                                    : string
     {
         if ($this->external_id === null || $this->external_id === '') {
             return $this->generateExternalId($this->getId());
         }
 
         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 3191 of file class.assQuestion.php.

Referenced by assQuestionGUI\_getQuestionGUI(), and ilObjTest\createQuestionGUI().

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

Here is the caller graph for this function:

◆ getFlashPath()

assQuestion::getFlashPath ( )

Returns the image path for web accessable flash files of a question.

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

Deprecated:: Flash is obsolete

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

References CLIENT_WEB_DIR.

Referenced by assFlashQuestion\copyApplet(), assFlashQuestion\deleteApplet(), assFlashQuestion\duplicateApplet(), assFlashQuestion\moveAppletIfExists(), and assFlashQuestion\moveUploadedFile().

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

Here is the caller graph for this function:

◆ getHtmlQuestionContentPurifier()

assQuestion::getHtmlQuestionContentPurifier ( )

Returns: ilHtmlPurifierInterface|ilAssHtmlUserSolutionPurifier

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

References ilHtmlPurifierFactory\getInstanceByType().

Referenced by assKprimChoice\addAnswer(), assSingleChoice\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 3585 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 528 of file class.assQuestion.php.

References $id.

Referenced by ilQuestionCumulatedStatisticsTableGUI\__construct(), ilQuestionUsagesTableGUI\__construct(), ilAssQuestionHintsOrderingClipboard\__construct(), addQTIMaterial(), assLongMenu\buildFolderName(), assOrderingQuestion\buildNestedOrderingElementInputGui(), assClozeTest\calculateCombinationResult(), calculateResultsFromSolution(), cleanupMediaObjectUsage(), assOrderingHorizontal\copyObject(), assFileUpload\copyObject(), assImagemapQuestion\copyObject(), assOrderingQuestion\copyObject(), assTextSubset\copyObject(), assTextQuestion\copyObject(), assFlashQuestion\copyObject(), assErrorText\copyObject(), assSingleChoice\copyObject(), assMultipleChoice\copyObject(), assMatchingQuestion\copyObject(), assLongMenu\copyObject(), assFormulaQuestion\copyObject(), assKprimChoice\copyObject(), assClozeTest\copyObject(), copyXHTMLMediaObjectsOfQuestion(), assOrderingHorizontal\createNewOriginalFromThisDuplicate(), assNumeric\createNewOriginalFromThisDuplicate(), assFileUpload\createNewOriginalFromThisDuplicate(), assImagemapQuestion\createNewOriginalFromThisDuplicate(), assTextSubset\createNewOriginalFromThisDuplicate(), assOrderingQuestion\createNewOriginalFromThisDuplicate(), assTextQuestion\createNewOriginalFromThisDuplicate(), assFlashQuestion\createNewOriginalFromThisDuplicate(), assErrorText\createNewOriginalFromThisDuplicate(), assSingleChoice\createNewOriginalFromThisDuplicate(), assMultipleChoice\createNewOriginalFromThisDuplicate(), assMatchingQuestion\createNewOriginalFromThisDuplicate(), assLongMenu\createNewOriginalFromThisDuplicate(), assKprimChoice\createNewOriginalFromThisDuplicate(), assFormulaQuestion\createNewOriginalFromThisDuplicate(), assClozeTest\createNewOriginalFromThisDuplicate(), createNewQuestion(), createPageObject(), deleteSolutionRecordByValues(), deleteSuggestedSolutions(), deleteTaxonomyAssignments(), assOrderingHorizontal\duplicate(), assNumeric\duplicate(), assFileUpload\duplicate(), assOrderingQuestion\duplicate(), assImagemapQuestion\duplicate(), assTextSubset\duplicate(), assFlashQuestion\duplicate(), assTextQuestion\duplicate(), assErrorText\duplicate(), assSingleChoice\duplicate(), assMultipleChoice\duplicate(), assMatchingQuestion\duplicate(), assLongMenu\duplicate(), assFormulaQuestion\duplicate(), assKprimChoice\duplicate(), assClozeTest\duplicate(), assTextQuestion\duplicateAnswers(), duplicateQuestionHints(), ensureHintPageObjectExists(), assOrderingQuestion\fetchSolutionListFromFormSubmissionData(), assMatchingQuestion\fetchSubmittedMatchingsFromPost(), getAdjustedReachedPoints(), assErrorText\getAnswersFromRequest(), assLongMenu\getCorrectAnswersAsJson(), getCurrentSolutionResultSet(), assErrorText\getErrorDataAsArrayForJS(), assNumeric\getExpressionTypes(), assOrderingHorizontal\getExpressionTypes(), assTextSubset\getExpressionTypes(), assImagemapQuestion\getExpressionTypes(), assSingleChoice\getExpressionTypes(), assOrderingQuestion\getExpressionTypes(), assFormulaQuestion\getExpressionTypes(), assMultipleChoice\getExpressionTypes(), assMatchingQuestion\getExpressionTypes(), assClozeTest\getExpressionTypes(), getExternalId(), assFileUpload\getFileUploadPath(), assFileUpload\getFileUploadPathWeb(), getInstances(), assTextQuestion\getLatestAutosaveContent(), assClozeTest\getMaximumPoints(), assOrderingQuestion\getOrderingElementList(), assErrorText\getParsedErrorTextForJS(), getReachedPoints(), assImagemapQuestion\getRTETextWithMediaObjects(), assSingleChoice\getRTETextWithMediaObjects(), assMultipleChoice\getRTETextWithMediaObjects(), getRTETextWithMediaObjects(), getSolutionMaxPass(), assOrderingQuestion\getSolutionOrderingElementList(), assTextQuestion\getSolutionSubmit(), getSolutionValues(), assFileUpload\getUploadedFiles(), assErrorText\getUserQuestionResult(), assFileUpload\handleSubmission(), assFileUpload\hasFileUploads(), assKprimChoice\isAnswered(), assTextQuestion\isAnswered(), assFileUpload\isAnswered(), assSingleChoice\isAnswered(), assMultipleChoice\isAnswered(), assSingleChoice\isComplete(), assKprimChoice\isComplete(), assMultipleChoice\isForcedEmptySolution(), assNumeric\isValidSolutionSubmit(), assTextQuestion\loadFromDb(), loadFromDb(), log(), logAction(), assErrorText\logUserAction(), assLongMenu\lookupForExistingSolutions(), assFormulaQuestion\lookupForExistingSolutions(), lookupForExistingSolutions(), lookupMaxStep(), migrateContentForLearningModule(), ilAssNestedOrderingElementsInputGUI\prepareReprintable(), removeAllExistingSolutions(), removeCurrentSolution(), assFormulaQuestion\removeExistingSolutions(), removeExistingSolutions(), removeResultRecord(), ilAssOrderingQuestionAuthoringFormGUI\renewOrderingElementInput(), assFlashQuestion\saveAdditionalQuestionDataToDb(), assFileUpload\saveAdditionalQuestionDataToDb(), assErrorText\saveAdditionalQuestionDataToDb(), assImagemapQuestion\saveAdditionalQuestionDataToDb(), assMatchingQuestion\saveAdditionalQuestionDataToDb(), assLongMenu\saveAdditionalQuestionDataToDb(), assKprimChoice\saveAdditionalQuestionDataToDb(), assClozeTest\saveAdditionalQuestionDataToDb(), assOrderingHorizontal\saveAdditionalQuestionDataToDb(), assErrorText\saveAnswerSpecificDataToDb(), assImagemapQuestion\saveAnswerSpecificDataToDb(), assMatchingQuestion\saveAnswerSpecificDataToDb(), assLongMenu\saveAnswerSpecificDataToDb(), assClozeTest\saveAnswerSpecificDataToDb(), assKprimChoice\saveAnswerSpecificDataToDb(), assClozeTest\saveClozeNumericGapRecordToDb(), assClozeTest\saveClozeSelectGapRecordToDb(), assClozeTest\saveClozeTextGapRecordToDb(), saveCurrentSolution(), assNumeric\savePreviewData(), assSingleChoice\savePreviewData(), assOrderingQuestion\savePreviewData(), saveQuestionDataToDb(), assMultipleChoice\saveToDb(), assFormulaQuestion\saveToDb(), saveToDb(), assOrderingHorizontal\saveWorkingData(), assTextSubset\saveWorkingData(), assSingleChoice\saveWorkingData(), assTextQuestion\saveWorkingData(), assLongMenu\saveWorkingData(), assFileUpload\saveWorkingData(), assImagemapQuestion\saveWorkingData(), assFormulaQuestion\saveWorkingData(), assMatchingQuestion\saveWorkingData(), assClozeTest\saveWorkingData(), assFormulaQuestion\setId(), setNewOriginalId(), assOrderingQuestion\setOrderingElementList(), assTextQuestion\setReachedPoints(), syncHints(), syncWithOriginal(), syncXHTMLMediaObjectsOfQuestion(), assOrderingHorizontal\toJSON(), assTextSubset\toJSON(), assTextQuestion\toJSON(), assLongMenu\toJSON(), assErrorText\toJSON(), assImagemapQuestion\toJSON(), assKprimChoice\toJSON(), assOrderingQuestion\toJSON(), assSingleChoice\toJSON(), assMultipleChoice\toJSON(), assMatchingQuestion\toJSON(), assClozeTest\toJSON(), updateCurrentSolutionsAuthorization(), ilLOTestQuestionAdapter\updateQuestionResult(), updateSuggestedSolutions(), updateTimestamp(), and usageNumber().

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

References $id, $obj_id, and buildImagePath().

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

Here is the call graph for this function:

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 1288 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(), assImagemapQuestion\toJSON(), assKprimChoice\toJSON(), assOrderingQuestion\toJSON(), assSingleChoice\toJSON(), and assMultipleChoice\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),
                 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 3109 of file class.assQuestion.php.

References ILIAS\LTI\ToolProvider\$key, ilObject\_getAllReferences(), ilObjTest\_lookupAuthor(), ilObject\_lookupTitle(), and getId().

                                   : array
     {
         $result = $this->db->queryF(
             "SELECT question_id FROM qpl_questions WHERE original_id = %s",
             array("integer"),
             array($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",
                 array("integer"),
                 array($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",
                 array("integer"),
                 array($question_id)
             );
             while ($row = $this->db->fetchAssoc($result)) {
                 $instances[$row['obj_fi']] = ilObject::_lookupTitle($row['obj_fi']);
             }
         }
         foreach ($instances as $key => $value) {
             $instances[$key] = array("obj_id" => $key, "title" => $value, "author" => ilObjTest::_lookupAuthor($key), "refs" => ilObject::_getAllReferences($key));
         }
         return $instances;
     }

Here is the call graph for this function:

◆ getLastChange()

assQuestion::getLastChange ( )

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

References $lastChange.

     {
         return $this->lastChange;
     }

◆ getLifecycle()

assQuestion::getLifecycle ( )

Definition at line 623 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 812 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 572 of file class.assQuestion.php.

                                          : int
     {
         return self::MAXIMUM_THUMB_SIZE;
 
     }

◆ getMinimumThumbSize()

assQuestion::getMinimumThumbSize ( )

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

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

                                          : int
     {
         return self::MINIMUM_THUMB_SIZE;
     }

Here is the caller graph for this function:

◆ getNrOfTries()

assQuestion::getNrOfTries ( )

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

References $nr_of_tries.

Referenced by saveQuestionDataToDb(), assOrderingHorizontal\toJSON(), assTextSubset\toJSON(), assTextQuestion\toJSON(), assLongMenu\toJSON(), assErrorText\toJSON(), assImagemapQuestion\toJSON(), assKprimChoice\toJSON(), assOrderingQuestion\toJSON(), assSingleChoice\toJSON(), assMultipleChoice\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 3520 of file class.assQuestion.php.

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

Referenced by assKprimChoice\isAnswered(), assTextQuestion\isAnswered(), assFileUpload\isAnswered(), assSingleChoice\isAnswered(), and assMultipleChoice\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,
             array('integer','integer','integer'),
             array($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 613 of file class.assQuestion.php.

References $obj_id.

                               : int
     {
         return $this->obj_id;
     }

Here is the caller graph for this function:

◆ getOriginalId()

assQuestion::getOriginalId ( )

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

References $original_id.

Referenced by assSingleChoice\syncImages(), assMultipleChoice\syncImages(), assImagemapQuestion\syncWithOriginal(), assMultipleChoice\syncWithOriginal(), and syncWithOriginal().

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

Here is the caller graph for this function:

◆ getOutputType()

assQuestion::getOutputType ( )

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

References $outputType.

                                    : int
     {
         return $this->outputType;
     }

◆ getOwner()

assQuestion::getOwner ( )

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

References $page.

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

◆ getPoints()

assQuestion::getPoints ( )

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

References $points.

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

                                : float
     {
         if (strcmp($this->points, "") == 0) {
             return 0.0;
         }
 
         return $this->points;
     }

Here is the caller graph for this function:

◆ getPreventRteUsage()

assQuestion::getPreventRteUsage ( )

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

References $prevent_rte_usage.

                                         : bool
     {
         return $this->prevent_rte_usage;
     }

◆ getProcessLocker()

assQuestion::getProcessLocker ( )

Definition at line 395 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 2996 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(), assTextSubset\toJSON(), assTextQuestion\toJSON(), assLongMenu\toJSON(), assErrorText\toJSON(), assImagemapQuestion\toJSON(), assKprimChoice\toJSON(), assOrderingQuestion\toJSON(), assSingleChoice\toJSON(), assMultipleChoice\toJSON(), assMatchingQuestion\toJSON(), and assClozeTest\toJSON().

                                  : string
     {
         return $this->question;
     }

Here is the caller graph for this function:

◆ getQuestionAction()

assQuestion::getQuestionAction ( )

protected

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

Referenced by assFileUpload\isFileDeletionAction().

                                           : string
     {
         if (!isset($_POST['cmd']) || !isset($_POST['cmd'][$this->questionActionCmd])) {
             return '';
         }
 
         if (!is_array($_POST['cmd'][$this->questionActionCmd]) || !count($_POST['cmd'][$this->questionActionCmd])) {
             return '';
         }
 
         return key($_POST['cmd'][$this->questionActionCmd]);
     }

Here is the caller graph for this function:

◆ getQuestionForHTMLOutput()

assQuestion::getQuestionForHTMLOutput ( )

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

References purifyAndPrepareTextAreaOutput().

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

Here is the call graph for this function:

◆ getQuestionsMissingResultRecord()

static assQuestion::getQuestionsMissingResultRecord	(	int	$activeId,
		int	$pass,
		array	$questionIds
	)

static

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

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

Referenced by ilTestOutputGUI\handlePrimaryButton().

                                                                                                         : array
     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
 
         $IN_questionIds = $ilDB->in('question_fi', $questionIds, false, 'integer');
 
         $query = "
                         SELECT question_fi
                         FROM tst_test_result
                         WHERE active_fi = %s
                         AND pass = %s
                         AND $IN_questionIds
                 ";
 
         $res = $ilDB->queryF(
             $query,
             array('integer', 'integer'),
             array($activeId, $pass)
         );
 
         $questionsHavingResultRecord = [];
 
         while ($row = $ilDB->fetchAssoc($res)) {
             $questionsHavingResultRecord[] = $row['question_fi'];
         }
 
         $questionsMissingResultRecordt = array_diff(
             $questionIds,
             $questionsHavingResultRecord
         );
 
         return $questionsMissingResultRecordt;
     }

Here is the caller graph for this function:

◆ getQuestionType()

assQuestion::getQuestionType ( )

abstract

Returns the question type of the question.

Returns: string The question type of the question

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

Here is the caller graph for this function:

◆ getQuestionTypeFromDb()

static assQuestion::getQuestionTypeFromDb ( int $question_id )

static

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

References $data, $DIC, and $ilDB.

Referenced by assQuestionGUI\_getGUIClassNameForId(), and assQuestionGUI\_getQuestionGUI().

                                                                   : string
     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
 
         $result = $ilDB->queryF(
             "SELECT qpl_qst_type.type_tag FROM qpl_qst_type, qpl_questions WHERE qpl_questions.question_id = %s AND qpl_questions.question_type_fi = qpl_qst_type.question_type_id",
             array('integer'),
             array($question_id)
         );
         $data = $ilDB->fetchAssoc($result);
         return $data["type_tag"] ?? '';
     }

Here is the caller graph for this function:

◆ getQuestionTypeID()

assQuestion::getQuestionTypeID ( )

Definition at line 3032 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",
             array('text'),
             array($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 807 of file class.assQuestion.php.

References getId().

Referenced by 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 3080 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());
 
         foreach ($this->suggested_solutions as $solution_array) {
             if (is_string(['value'])) {
                 $collected .= $solution_array["value"];
             }
         }
         $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 3390 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 3349 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 533 of file class.assQuestion.php.

References $shuffle.

Referenced by assMultipleChoice\isForcedEmptySolution(), assSingleChoice\savePreviewData(), assTextQuestion\toJSON(), assLongMenu\toJSON(), assErrorText\toJSON(), assImagemapQuestion\toJSON(), assSingleChoice\toJSON(), assMultipleChoice\toJSON(), and assClozeTest\toJSON().

                                 : bool
     {
         return $this->shuffle;
     }

Here is the caller graph for this function:

◆ getShuffler()

assQuestion::getShuffler ( )

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

◆ getSolutionMaxPass()

assQuestion::getSolutionMaxPass ( int $active_id )

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

Referenced by assFileUpload\saveWorkingData().

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

Here is the caller graph for this function:

◆ getSolutionValues()

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

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

Parameters

int | string $active_id

Returns: array Assoc result from tst_solutions.*

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

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

                                                                                         : 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,
                 array('integer', 'integer', 'integer', 'integer', 'integer'),
                 array((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,
                 array('integer', 'integer', 'integer', 'integer'),
                 array((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 3903 of file class.assQuestion.php.

References $step.

Referenced by calculateResultsFromSolution(), deleteSolutionRecordByValues(), assFileUpload\deleteUploadedFiles(), getCurrentSolutionResultSet(), getSolutionValues(), 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 )

Returns a suggested solution for a given subquestion index.

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

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

◆ getSuggestedSolutionOutput()

assQuestion::getSuggestedSolutionOutput ( )

Returns: string HTML

Exceptions

ilWACException

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

References _getInternalLinkHref(), fixSvgToPng(), fixUnavailableSkinImageSources(), getSuggestedSolutionPathWeb(), ILIAS\Repository\lng(), ilLegacyFormElementsUtil\prepareFormOutput(), prepareTextareaOutput(), ilWACSignedPath\setTokenMaxLifetimeInSeconds(), and ilWACSignedPath\signFile().

                                                 : string
     {
         $output = [];
         foreach ($this->suggested_solutions as $solution) {
             switch ($solution["type"]) {
                 case "lm":
                 case "st":
                 case "pg":
                 case "git":
                     $output[] = '<a href="' . assQuestion::_getInternalLinkHref($solution["internal_link"]) . '">' . $this->lng->txt("solution_hint") . '</a>';
                     break;
                 case "file":
                     $possible_texts = array_values(array_filter(array(
                         ilLegacyFormElementsUtil::prepareFormOutput($solution['value']['filename']),
                         ilLegacyFormElementsUtil::prepareFormOutput($solution['value']['name']),
                         $this->lng->txt('tst_show_solution_suggested')
                     )));
                     ilWACSignedPath::setTokenMaxLifetimeInSeconds(60);
                     $output[] = '<a href="' . ilWACSignedPath::signFile($this->getSuggestedSolutionPathWeb() . $solution["value"]["name"]) . '">' . $possible_texts[0] . '</a>';
                     break;
                 case "text":
                     $solutionValue = $solution["value"];
                     $solutionValue = $this->fixSvgToPng($solutionValue);
                     $solutionValue = $this->fixUnavailableSkinImageSources($solutionValue);
                     $output[] = $this->prepareTextareaOutput($solutionValue, true);
                     break;
             }
         }
         return implode("<br />", $output);
     }

Here is the call graph for this function:

◆ getSuggestedSolutionPath()

assQuestion::getSuggestedSolutionPath ( )

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

References CLIENT_WEB_DIR.

Referenced by copySuggestedSolutionFiles(), deleteSuggestedSolutions(), duplicateSuggestedSolutionFiles(), and syncSuggestedSolutionFiles().

                                               : 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 1273 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),
             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 ( )

Returns: string[] HTML

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

References $suggested_solutions.

                                            : array
     {
         return $this->suggested_solutions;
     }

◆ getSuggestedSolutionTitle()

assQuestion::getSuggestedSolutionTitle ( int $subquestion_index = 0 )

Returns the title of a suggested solution at a given subquestion_index.

This can be usable for displaying suggested solutions

Parameters

integer $subquestion_index The index of a subquestion (i.e. a close test gap). Usually 0

Returns: string A string containing the type and title of the internal link

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

References $title.

                                                                          : string
     {
         if (array_key_exists($subquestion_index, $this->suggested_solutions)) {
             $title = $this->suggested_solutions[$subquestion_index]["internal_link"];
             // TO DO: resolve internal link an get link type and title
         } else {
             $title = "";
         }
         return $title;
     }

◆ getTestId()

assQuestion::getTestId ( )

Definition at line 538 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 1302 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 4201 of file class.assQuestion.php.

References $testQuestionConfigInstance, and buildTestPresentationConfig().

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getThumbSize()

assQuestion::getThumbSize ( )

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

References $thumb_size.

Referenced by assSingleChoice\generateThumbForFile(), assMultipleChoice\generateThumbForFile(), assOrderingQuestion\generateThumbForFile(), assSingleChoice\isComplete(), assMultipleChoice\isForcedEmptySolution(), assSingleChoice\rebuildThumbnails(), assMultipleChoice\rebuildThumbnails(), assSingleChoice\savePreviewData(), assOrderingQuestion\savePreviewData(), assOrderingQuestion\setContentType(), assSingleChoice\setImageFile(), assMultipleChoice\setImageFile(), assOrderingQuestion\storeImageFile(), assSingleChoice\toJSON(), assMultipleChoice\toJSON(), and assOrderingQuestion\updateImageFile().

                                   : int
     {
         return $this->thumb_size;
     }

Here is the caller graph for this function:

◆ getTitle()

assQuestion::getTitle ( )

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

References $title.

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

                               : string
     {
         return $this->title;
     }

Here is the caller graph for this function:

◆ getTitleFilenameCompliant()

assQuestion::getTitleFilenameCompliant ( )

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

References ILIAS\Repository\refinery().

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

                                            : string
     {
         return $this->refinery->string()->stripTags()->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 1645 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",
             array('integer','integer'),
             array($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,
			$pass = `null`
	)

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

Referenced by isValidAdditionalContentEditingMode(), and setAdditionalContentEditingMode().

                                                            : array
     {
         return array(
             self::ADDITIONAL_CONTENT_EDITING_MODE_RTE,
             self::ADDITIONAL_CONTENT_EDITING_MODE_IPE
         );
     }

Here is the caller graph for this function:

◆ hasSpecificFeedback()

assQuestion::hasSpecificFeedback ( )

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

                                          : bool
     {
         return static::HAS_SPECIFIC_FEEDBACK;
     }

◆ implodeKeyValues()

static assQuestion::implodeKeyValues ( array $keyValues )

static

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

◆ includeCoreClass()

static assQuestion::includeCoreClass	(	$questionType,
		$withGuiClass
	)

static

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

                                                                          : void
     {
         if ($withGuiClass) {
             // object class is included by gui classes constructor
         } else {
         }
 
         $feedbackClassName = self::getFeedbackClassNameByQuestionType($questionType);
     }

◆ instantiateQuestion()

static assQuestion::instantiateQuestion ( int $question_id )

static

Parameters

int $question_id

Returns: assQuestion

Exceptions

InvalidArgumentException

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

References $DIC, $ilDB, $question, _getQuestionType(), and _includeClass().

Referenced by ilObjTest\_instanciateQuestion(), ilTestFixedQuestionSetConfig\cloneQuestionSetRelatedData(), ilObjTestGUI\copyAndLinkQuestionsToPoolObject(), ilPCQuestion\copyPoolQuestionIntoPage(), ilObjQuestionPool\deleteQuestion(), ilTestEvaluationGUI\exportFileUploadsForAllParticipants(), ilTestExport\exportToExcel(), ilTestRandomQuestionSetStagingPoolBuilder\removeStagedQuestions(), ilSoapTestAdministration\saveQuestion(), ilSoapTestAdministration\saveQuestionSolution(), ilTestEvaluationGUI\singleResults(), and ilTestRandomQuestionSetStagingPoolBuilder\stageQuestionsFromSourcePool().

                                                                 : assQuestion
     {
         global $DIC;
         $ilCtrl = $DIC['ilCtrl'];
         $ilDB = $DIC['ilDB'];
         $lng = $DIC['lng'];
 
         $question_type = assQuestion::_getQuestionType($question_id);
         if ($question_type === '') {
             throw new InvalidArgumentException('No question with ID ' . $question_id . ' exists');
         }
 
         assQuestion::_includeClass($question_type);
         $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:

◆ instantiateQuestionGUI()

static assQuestion::instantiateQuestionGUI ( int $a_question_id )

static

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

References $DIC, $ilDB, $ilUser, ilObjAssessmentFolder\_enabledAssessmentLogging(), _getQuestionType(), and _includeClass().

Referenced by ilObjTestGUI\copyQuestionObject(), ilObjTestGUI\copyQuestionToPool(), ilObjQuestionPool\createQuestion(), ilQuestionPoolPrintViewTableGUI\fillRow(), ilTestCorrectionsGUI\getQuestion(), and ilAssQuestionPreviewGUI\initQuestion().

                                                                      : assQuestionGUI
     {
         //Shouldn't you live in assQuestionGUI, Mister?
 
         global $DIC;
         $ilCtrl = $DIC['ilCtrl'];
         $ilDB = $DIC['ilDB'];
         $lng = $DIC['lng'];
         $ilUser = $DIC['ilUser'];
 
         if (strcmp($a_question_id, "") != 0) {
             $question_type = assQuestion::_getQuestionType($a_question_id);
 
             assQuestion::_includeClass($question_type, 1);
 
             $question_type_gui = $question_type . 'GUI';
             $question_gui = new $question_type_gui();
             $question_gui->object->loadFromDb($a_question_id);
 
             $feedbackObjectClassname = self::getFeedbackClassNameByQuestionType($question_type);
             $question_gui->object->feedbackOBJ = new $feedbackObjectClassname($question_gui->object, $ilCtrl, $ilDB, $lng);
 
             $assSettings = new ilSetting('assessment');
             $processLockerFactory = new ilAssQuestionProcessLockerFactory($assSettings, $ilDB);
             $processLockerFactory->setQuestionId($question_gui->object->getId());
             $processLockerFactory->setUserId($ilUser->getId());
             $processLockerFactory->setAssessmentLogEnabled(ilObjAssessmentFolder::_enabledAssessmentLogging());
             $question_gui->object->setProcessLocker($processLockerFactory->getLocker());
         } else {
             global $DIC;
             $ilLog = $DIC['ilLog'];
             $ilLog->write('Instantiate question called without question id. (instantiateQuestionGUI@assQuestion)', $ilLog->WARNING);
             throw new InvalidArgumentException('Instantiate question called without question id. (instantiateQuestionGUI@assQuestion)');
         }
         return $question_gui;
     }

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

                                                                                       : bool
     {
         return false;
     }

◆ isAdditionalContentEditingModePageObject()

assQuestion::isAdditionalContentEditingModePageObject ( )

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

◆ isAllowedImageFileExtension()

static assQuestion::isAllowedImageFileExtension	(	string	$mimeType,
		string	$fileExtension
	)

static

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

Referenced by ilQtiMatImageSecurity\validateLabel().

                                                                                                : bool
     {
         return in_array(strtolower($fileExtension), self::getAllowedFileExtensionsForMimeType($mimeType), true);
     }

Here is the caller graph for this function:

◆ isAllowedImageMimeType()

static assQuestion::isAllowedImageMimeType ( $mimeType )

static

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

Referenced by ilQtiMatImageSecurity\validateContent().

                                                             : bool
     {
         return (bool) count(self::getAllowedFileExtensionsForMimeType($mimeType));
     }

Here is the caller graph for this function:

◆ isAnswered()

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

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

Referenced by calculateResultsFromSolution().

                                                          : bool
     {
         return true;
     }

Here is the caller graph for this function:

◆ isAutosaveable()

assQuestion::isAutosaveable ( )

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

                                     : bool
     {
         return true;
     }

◆ isClone()

assQuestion::isClone ( int $question_id = 0 )

Checks whether the question is a clone of another question or not.

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

References $id.

                                                  : bool
     {
         if ($question_id < 1) {
             $question_id = $this->id;
         }
         $result = $this->db->queryF(
             "SELECT COUNT(original_id) cnt FROM qpl_questions WHERE question_id = %s",
             array('integer'),
             array($question_id)
         );
         $row = $this->db->fetchAssoc($result);
         return ((int) $row["cnt"]) > 0;
     }

◆ isComplete()

assQuestion::isComplete ( )

Returns true, if a question is complete for use.

Returns: boolean True, if the question is complete for use, otherwise false

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

Referenced by saveQuestionDataToDb(), and saveToDb().

                                 : bool
     {
         return false;
     }

Here is the caller graph for this function:

◆ isCoreQuestionType()

static assQuestion::isCoreQuestionType ( string $questionType )

static

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

                                                                    : bool
     {
         return file_exists("Modules/TestQuestionPool/classes/class.{$questionType}GUI.php");
     }

◆ isDummySolutionRecord()

assQuestion::isDummySolutionRecord ( array $solutionRecord )

protected

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

Referenced by assMatchingQuestion\copyImages().

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

Here is the caller graph for this function:

◆ isForcePassResultUpdateEnabled()

static assQuestion::isForcePassResultUpdateEnabled ( )

static

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

                                                            : bool
     {
         return self::$forcePassResultsUpdateEnabled;
     }

◆ isHTML()

assQuestion::isHTML ( $a_text )

Checks if a given string contains HTML or not.

Deprecated:: use ilUtil::isHTML() (or successor) instead

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

References ilUtil\isHTML().

Referenced by addQTIMaterial().

                                    : bool
     {
         return ilUtil::isHTML($a_text);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isInActiveTest()

assQuestion::isInActiveTest ( )

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

References $query, $res, and getObjId().

                                     : bool
     {
         $query = 'SELECT user_fi FROM tst_active ' . PHP_EOL
             . 'JOIN tst_test_question ON tst_test_question.test_fi = tst_active.test_fi ' . PHP_EOL
             . 'JOIN qpl_questions ON qpl_questions.question_id = tst_test_question.question_fi ' . PHP_EOL
             . 'WHERE qpl_questions.obj_fi = ' . $this->db->quote($this->getObjId(), 'integer');
 
         $res = $this->db->query($query);
         return $res->numRows() > 0;
     }

Here is the call graph for this function:

◆ isInUse()

assQuestion::isInUse ( int $question_id = 0 )

Checks whether the question is in use or not in pools or tests.

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

References usageNumber().

                                                  : bool
     {
         return $this->usageNumber($question_id) > 0;
     }

Here is the call graph for this function:

◆ isNonEmptyItemListPostSubmission()

assQuestion::isNonEmptyItemListPostSubmission ( string $postSubmissionFieldname )

protected

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

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

                                                                                         : bool
     {
         if (!isset($_POST[$postSubmissionFieldname])) {
             return false;
         }
 
         if (!is_array($_POST[$postSubmissionFieldname])) {
             return false;
         }
 
         if (!count($_POST[$postSubmissionFieldname])) {
             return false;
         }
 
         return true;
     }

Here is the caller graph for this function:

◆ isObligationPossible()

static assQuestion::isObligationPossible ( int $questionId )

static

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

Referenced by assMultipleChoice\isAnswered().

                                                                 : bool
     {
         return false;
     }

Here is the caller graph for this function:

◆ isPreviewSolutionCorrect()

assQuestion::isPreviewSolutionCorrect ( ilAssQuestionPreviewSession $previewSession )

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

References calculateReachedPointsFromPreviewSession(), and getMaximumPoints().

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

Here is the call graph for this function:

◆ isValidAdditionalContentEditingMode()

assQuestion::isValidAdditionalContentEditingMode ( string $additionalContentEditingMode )

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

◆ lmMigrateQuestionTypeGenericContent()

assQuestion::lmMigrateQuestionTypeGenericContent ( ilAssSelfAssessmentMigrator $migrator )

protected

Definition at line 3375 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 3380 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 1909 of file class.assQuestion.php.

References $data, ilRTE\_replaceMediaObjectImageSrc(), and getId().

Referenced by assNumeric\saveToDb().

                                                 : 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'];
         }
 
         $result = $this->db->queryF(
             "SELECT internal_link, import_id, subquestion_index, type, value" .
             " FROM qpl_sol_sug WHERE question_fi = %s",
             ["integer"],
             [$this->getId()]
         );
 
         $suggestedSolutions = [];
 
         while ($row = $this->db->fetchAssoc($result)) {
             $value = $row["value"];
 
             try {
                 $unserializedValue = unserialize($value, ['allowed_classes' => false]);
                 if (is_array($unserializedValue)) {
                     $value = $unserializedValue;
                 }
             } catch (Exception $ex) {
             }
 
             if (is_string($value)) {
                 $value = ilRTE::_replaceMediaObjectImageSrc($value, 1);
             }
 
             $suggestedSolutions[$row["subquestion_index"]] = [
                 "type" => $row["type"],
                 "value" => $value,
                 "internal_link" => $row["internal_link"],
                 "import_id" => $row["import_id"]
             ];
         }
         $this->suggested_solutions = $suggestedSolutions;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ loadSuggestedSolution()

assQuestion::loadSuggestedSolution	(	int	$question_id,
		int	$subquestion_index = `0`
	)

Returns a suggested solution for a given subquestion index.

Returns: array array("internal_link" => $row["internal_link"],"import_id" => $row["import_id"]);

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

Referenced by _getSuggestedSolution().

                                                                                        : array
     {
         $result = $this->db->queryF(
             "SELECT * FROM qpl_sol_sug WHERE question_fi = %s AND subquestion_index = %s",
             array('integer','integer'),
             array($question_id, $subquestion_index)
         );
         if ($this->db->numRows($result) == 1) {
             $row = $this->db->fetchAssoc($result);
             return array(
                 "internal_link" => $row["internal_link"],
                 "import_id" => $row["import_id"]
             );
         }
         return [];
     }

Here is the caller graph for this function:

◆ log()

assQuestion::log	(	int	$active_id,
		string	$langVar
	)

protected

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

References $message, ilObjAssessmentFolder\_enabledAssessmentLogging(), ilObjAssessmentFolder\_getLogLanguage(), getId(), ILIAS\Repository\lng(), and logAction().

Referenced by resetUsersAnswer(), and assOrderingQuestion\saveWorkingData().

                                                            : void
     {
         if (ilObjAssessmentFolder::_enabledAssessmentLogging()) {
             $message = $this->lng->txtlng('assessment', $langVar, ilObjAssessmentFolder::_getLogLanguage());
             assQuestion::logAction($message, $active_id, $this->getId());
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ logAction()

static assQuestion::logAction	(	string	$logtext,
		int	$active_id,
		int	$question_id
	)

static

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

References $GLOBALS, ilObjAssessmentFolder\_addLog(), ilObjTest\_getObjectIDFromActiveID(), and getId().

Referenced by _setReachedPoints(), calculateResultsFromSolution(), assKprimChoice\isComplete(), assMultipleChoice\isForcedEmptySolution(), assNumeric\isValidSolutionSubmit(), log(), assErrorText\logUserAction(), assOrderingHorizontal\saveWorkingData(), assTextSubset\saveWorkingData(), assSingleChoice\saveWorkingData(), assTextQuestion\saveWorkingData(), assLongMenu\saveWorkingData(), assFileUpload\saveWorkingData(), assImagemapQuestion\saveWorkingData(), assFormulaQuestion\saveWorkingData(), assMatchingQuestion\saveWorkingData(), and assClozeTest\saveWorkingData().

                                                                                        : void
     {
         $original_id = self::_getOriginalId($question_id);
 
         ilObjAssessmentFolder::_addLog(
             $GLOBALS['DIC']['ilUser']->getId(),
             ilObjTest::_getObjectIDFromActiveID($active_id),
             $logtext,
             $question_id,
             $original_id
         );
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ lookupCurrentTestPass()

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

protected

Deprecated:: Use ilObjTest::_getPass($active_id) instead ILIAS 9

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

Referenced by ensureCurrentTestPass().

                                                                        : int
     {
         return \ilObjTest::_getPass($active_id);
     }

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

References $query, getId(), and getStep().

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

                                                                         : array
     {
         $return = array(
             '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, array('integer', 'integer', 'integer'), array($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 3950 of file class.assQuestion.php.

References getId().

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

                                                                : int
     {
         $result = $this->db->queryF(
             "SELECT MAX(step) max_step FROM tst_solutions WHERE active_fi = %s AND pass = %s AND question_fi = %s",
             array("integer", "integer", "integer"),
             array($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:

◆ lookupOriginalParentObjId()

static assQuestion::lookupOriginalParentObjId ( int $originalQuestionId )

static

returns the parent object id for given original question id (should be a qpl id, but theoretically it can be a tst id, too)

Deprecated:: : use assQuestion::lookupParentObjId() instead

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

                                                                              : int
     {
         return self::lookupParentObjId($originalQuestionId);
     }

◆ lookupParentObjId()

static assQuestion::lookupParentObjId ( int $questionId )

static

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

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

Referenced by ilObjTestGUI\copyAndLinkToQuestionpoolObject(), and ilAssQuestionSkillAssignmentsGUI\isSyncOriginalPossibleAndAllowed().

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

Here is the caller graph for this function:

◆ lookupResultRecordExist()

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

static

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

References $DIC, $ilDB, and $query.

                                                                                              : bool
     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
 
         $query = "
                         SELECT COUNT(*) cnt
                         FROM tst_test_result
                         WHERE active_fi = %s
                         AND question_fi = %s
                         AND pass = %s
                 ";
 
         $row = $ilDB->fetchAssoc($ilDB->queryF($query, array('integer', 'integer', 'integer'), array($activeId, $questionId, $pass)));
 
         return $row['cnt'] > 0;
     }

◆ lookupTestId()

assQuestion::lookupTestId ( int $active_id )

protected

Move to ilObjTest or similar

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

References $test_id, and ILIAS\Repository\int().

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ migrateContentForLearningModule()

assQuestion::migrateContentForLearningModule ( ilAssSelfAssessmentMigrator $migrator )

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

◆ missingResultRecordExists()

static assQuestion::missingResultRecordExists	(	int	$activeId,
		int	$pass,
		array	$questionIds
	)

static

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

References $DIC, $ilDB, and $query.

                                                                                                   : bool
     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
 
         $IN_questionIds = $ilDB->in('question_fi', $questionIds, false, 'integer');
 
         $query = "
                         SELECT COUNT(*) cnt
                         FROM tst_test_result
                         WHERE active_fi = %s
                         AND pass = %s
                         AND $IN_questionIds
                 ";
 
         $row = $ilDB->fetchAssoc($ilDB->queryF(
             $query,
             array('integer', 'integer'),
             array($activeId, $pass)
         ));
 
         return $row['cnt'] < count($questionIds);
     }

◆ moveUploadedMediaFile()

assQuestion::moveUploadedMediaFile	(	string	$file,
		string	$name
	)

Move an uploaded media file to an public accessible temp dir to present it.

Parameters

string	$file	File path
string	$name	Name of the file

Returns: string|bool Tempname or false

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

References CLIENT_WEB_DIR, ilFileUtils\createDirectory(), and ilFileUtils\moveUploadedFile().

     {
         $mediatempdir = CLIENT_WEB_DIR . "/assessment/temp";
         if (!@is_dir($mediatempdir)) {
             ilFileUtils::createDirectory($mediatempdir);
         }
         $temp_name = tempnam($mediatempdir, $name . "_____");
         $temp_name = str_replace("\\", "/", $temp_name);
         @unlink($temp_name);
         if (!ilFileUtils::moveUploadedFile($file, $name, $temp_name)) {
             return false;
         }
         return $temp_name;
     }

Here is the call graph for this function:

◆ onCopy()

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

protected

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

References copySuggestedSolutionFiles(), duplicateQuestionHints(), and duplicateSkillAssignments().

                                                                                                                      : void
     {
         $this->copySuggestedSolutionFiles($sourceParentId, $sourceQuestionId);
 
         // duplicate question feeback
         $this->feedbackOBJ->duplicateFeedback($sourceQuestionId, $targetQuestionId);
 
         // duplicate question hints
         $this->duplicateQuestionHints($sourceQuestionId, $targetQuestionId);
 
         // duplicate skill assignments
         $this->duplicateSkillAssignments($sourceParentId, $sourceQuestionId, $targetParentId, $targetQuestionId);
     }

Here is the call graph for this function:

◆ onDuplicate()

assQuestion::onDuplicate	(	int	$originalParentId,
		int	$originalQuestionId,
		int	$duplicateParentId,
		int	$duplicateQuestionId
	)

protected

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

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

                                                                                                                                     : void
     {
         $this->duplicateSuggestedSolutionFiles($originalParentId, $originalQuestionId);
         $this->feedbackOBJ->duplicateFeedback($originalQuestionId, $duplicateQuestionId);
         $this->duplicateQuestionHints($originalQuestionId, $duplicateQuestionId);
         $this->duplicateSkillAssignments($originalParentId, $originalQuestionId, $duplicateParentId, $duplicateQuestionId);
     }

Here is the call graph for this function:

◆ originalQuestionExists()

static assQuestion::originalQuestionExists ( int $questionId )

static

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

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

Referenced by ilObjTestGUI\copyAndLinkQuestionsToPoolObject(), and ilObjTestGUI\copyAndLinkToQuestionpoolObject().

                                                                   : bool
     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
 
         $query = "
                         SELECT COUNT(dupl.question_id) cnt
                         FROM qpl_questions dupl
                         INNER JOIN qpl_questions orig
                         ON orig.question_id = dupl.original_id
                         WHERE dupl.question_id = %s
                 ";
 
         $res = $ilDB->queryF($query, array('integer'), array($questionId));
         $row = $ilDB->fetchAssoc($res);
 
         return $row['cnt'] > 0;
     }

Here is the caller graph for this function:

◆ persistPreviewState()

assQuestion::persistPreviewState ( ilAssQuestionPreviewSession $previewSession )

final

persists the preview state for current user and question

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

References savePreviewData(), and validateSolutionSubmit().

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

Here is the call graph for this function:

◆ persistWorkingState()

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

final

persists the working state for current testactive and testpass

Returns: bool if saving happened

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

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

                                                                                                                                : bool
     {
         if (!$this->validateSolutionSubmit() && !$this->savePartial()) {
             return false;
         }
 
         $saveStatus = false;
 
         $this->getProcessLocker()->executePersistWorkingStateLockOperation(function () use ($active_id, $pass, $authorized, $obligationsEnabled, &$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, $obligationsEnabled);
             }
         });
 
         return $saveStatus;
     }

Here is the call graph for this function:

◆ prepareTextareaOutput()

assQuestion::prepareTextareaOutput	(	string	$txt_output,
		bool	$prepare_for_latex_output = `false`,
		bool	$omitNl2BrWhenTextArea = `false`
	)

Deprecated:: use ilUtil::prepareTextareaOutput() (or successor) instead

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

References ilLegacyFormElementsUtil\prepareTextareaOutput().

Referenced by assClozeTest\getClozeTextForHTMLOutput(), getSuggestedSolutionOutput(), purifyAndPrepareTextAreaOutput(), and assClozeTest\updateClozeTextFromGaps().

     {
         return ilLegacyFormElementsUtil::prepareTextareaOutput(
             $txt_output,
             $prepare_for_latex_output,
             $omitNl2BrWhenTextArea
         );
     }

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

References getHtmlQuestionContentPurifier(), isAdditionalContentEditingModePageObject(), and 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 $this->prepareTextareaOutput(
             $purified_content,
             true,
             true
         );
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ QTIMaterialToString()

assQuestion::QTIMaterialToString ( ilQTIMaterial $a_material )

Reads an QTI material tag and creates a text or XHTML string.

Returns: string text or xhtml string

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

References $i, $mobs, ilSession\get(), ilQTIMaterial\getMaterial(), ilQTIMaterial\getMaterialCount(), and ilSession\set().

                                                                   : string
     {
         $result = "";
         $mobs = ilSession::get('import_mob_xhtml') ?? [];
         for ($i = 0; $i < $a_material->getMaterialCount(); $i++) {
             $material = $a_material->getMaterial($i);
             if (strcmp($material["type"], "mattext") == 0) {
                 $result .= $material["material"]->getContent();
             }
             if (strcmp($material["type"], "matimage") == 0) {
                 $matimage = $material["material"];
                 if (preg_match("/(il_([0-9]+)_mob_([0-9]+))/", $matimage->getLabel(), $matches)) {
                     $mobs[] = [
                         "mob" => $matimage->getLabel(),
                         "uri" => $matimage->getUri()
                     ];
                 }
             }
         }
         ilSession::set('import_mob_xhtml', $mobs);
         return $result;
     }

Here is the call graph for this function:

◆ questionTitleExists()

assQuestion::questionTitleExists	(	int	$questionpool_id,
		string	$title
	)

Returns TRUE if the question title exists in a question pool in the database.

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

References $DIC, and $ilDB.

                                                                             : bool
     {
         global $DIC;
         $ilDB = $DIC['ilDB'];
 
         $result = $ilDB->queryF(
             "SELECT * FROM qpl_questions WHERE obj_fi = %s AND title = %s",
             array('integer','text'),
             array($questionpool_id, $title)
         );
         return ($result->numRows() > 0) ? true : false;
     }

◆ removeAllExistingSolutions()

assQuestion::removeAllExistingSolutions ( )

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

References $query, and getId().

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

Here is the call graph for this function:

◆ removeCurrentSolution()

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

Returns: int Affected rows

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

References $query, getId(), and getStep().

Referenced by assKprimChoice\isComplete(), assMultipleChoice\isForcedEmptySolution(), removeIntermediateSolution(), assOrderingHorizontal\saveWorkingData(), assErrorText\saveWorkingData(), assTextSubset\saveWorkingData(), assTextQuestion\saveWorkingData(), assLongMenu\saveWorkingData(), assFileUpload\saveWorkingData(), assImagemapQuestion\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,
                 array('integer', 'integer', 'integer', 'integer', 'integer'),
                 array($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,
             array('integer', 'integer', 'integer', 'integer'),
             array($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 4019 of file class.assQuestion.php.

References $query, 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,
             array('integer', 'integer', 'integer'),
             array($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 3684 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 4055 of file class.assQuestion.php.

References $query, 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,
             array('integer', 'integer', 'integer'),
             array($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 3656 of file class.assQuestion.php.

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

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

Here is the caller graph for this function:

◆ requiresJsSwitch()

assQuestion::requiresJsSwitch ( )

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

References supportsJavascriptOutput(), and supportsNonJsOutput().

                                       : bool
     {
         return $this->supportsJavascriptOutput() && $this->supportsNonJsOutput();
     }

Here is the call graph for this function:

◆ resetOriginalId()

static assQuestion::resetOriginalId ( int $questionId )

static

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

References $DIC, $ilDB, and $query.

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,
             array('integer', 'text'),
             array(time(), $questionId)
         );
     }

Here is the caller graph for this function:

◆ resetUsersAnswer()

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

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

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

                                                               : void
     {
         $this->removeExistingSolutions($activeId, $pass);
         $this->removeResultRecord($activeId, $pass);
 
         $this->log($activeId, "log_user_solution_willingly_deleted");
 
         self::_updateTestPassResults(
             $activeId,
             $pass,
             $this->areObligationsToBeConsidered(),
             $this->getProcessLocker(),
             $this->getTestId()
         );
     }

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

References getId(), and getStep().

                                                                                                                           : int
     {
         $next_id = $this->db->nextId("tst_solutions");
 
         $fieldData = array(
             "solution_id" => array("integer", $next_id),
             "active_fi" => array("integer", $active_id),
             "question_fi" => array("integer", $this->getId()),
             "value1" => array("clob", $value1),
             "value2" => array("clob", $value2),
             "pass" => array("integer", $pass),
             "tstamp" => array("integer", ((int) $tstamp > 0) ? (int) $tstamp : time()),
             'authorized' => array('integer', (int) $authorized)
         );
 
         if ($this->getStep() !== null) {
             $fieldData['step'] = array("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 2079 of file class.assQuestion.php.

References $DIC, $ilDB, and $query.

Referenced by 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,
             array('integer','integer', 'text'),
             array(time(), $originalId, $questionId)
         );
     }

Here is the caller graph for this function:

◆ savePartial()

assQuestion::savePartial ( )

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

Referenced by persistWorkingState().

                                  : bool
     {
         return false;
     }

Here is the caller graph for this function:

◆ savePreviewData()

assQuestion::savePreviewData ( ilAssQuestionPreviewSession $previewSession )

protected

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

References ilAssQuestionPreviewSession\setParticipantsSolution().

Referenced by persistPreviewState().

                                                                                    : void
     {
         $previewSession->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 = -1 )

Definition at line 2005 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 assSingleChoice\isComplete(), assOrderingHorizontal\saveToDb(), assNumeric\saveToDb(), assFlashQuestion\saveToDb(), assErrorText\saveToDb(), assFileUpload\saveToDb(), assTextSubset\saveToDb(), assTextQuestion\saveToDb(), assImagemapQuestion\saveToDb(), assOrderingQuestion\saveToDb(), assMultipleChoice\saveToDb(), assMatchingQuestion\saveToDb(), assLongMenu\saveToDb(), assKprimChoice\saveToDb(), assClozeTest\saveToDb(), and assFormulaQuestion\saveToDb().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ saveToDb()

assQuestion::saveToDb ( )

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

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

Referenced by assSingleChoice\isComplete(), migrateContentForLearningModule(), and syncWithOriginal().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ saveWorkingData()

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

abstract

Saves the learners input of the question to the database.

Parameters

int	$active_id	Active id of the user
int	$pass	Test pass
bool	$authorized

Returns: bool $status

Referenced by assKprimChoice\isComplete(), assMultipleChoice\isForcedEmptySolution(), assNumeric\isValidSolutionSubmit(), persistWorkingState(), and validateSolutionSubmit().

Here is the caller graph for this function:

◆ setAdditionalContentEditingMode()

assQuestion::setAdditionalContentEditingMode ( ?string $additionalContentEditingMode )

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

References $additionalContentEditingMode, and getValidAdditionalContentEditingModes().

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

                                                                                           : void
     {
         if (!in_array((string) $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 500 of file class.assQuestion.php.

References $author.

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

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

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

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

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

References $defaultnroftries.

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

◆ setExportDetailsXLS()

assQuestion::setExportDetailsXLS	(	ilAssExcelFormatHelper	$worksheet,
		int	$startrow,
		int	$active_id,
		int	$pass
	)

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

References ilExcel\getColumnCoord(), getQuestionType(), getTitle(), ILIAS\Repository\lng(), and ilAssExcelFormatHelper\setFormattedExcelTitle().

                                                                                                                     : int
     {
         $worksheet->setFormattedExcelTitle($worksheet->getColumnCoord(0) . $startrow, $this->lng->txt($this->getQuestionType()));
         $worksheet->setFormattedExcelTitle($worksheet->getColumnCoord(1) . $startrow, $this->getTitle());
 
         return $startrow;
     }

Here is the call graph for this function:

◆ setExportImagePath()

assQuestion::setExportImagePath ( string $path )

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

References $path.

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

◆ setExternalId()

assQuestion::setExternalId ( ?string $external_id )

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

References $external_id.

Referenced by __construct().

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

Here is the caller graph for this function:

◆ setForcePassResultUpdateEnabled()

static assQuestion::setForcePassResultUpdateEnabled ( bool $forcePassResultsUpdateEnabled )

static

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

References $forcePassResultsUpdateEnabled.

Referenced by ilTestScoring\recalculatePass().

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

Here is the caller graph for this function:

◆ setId()

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

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

References $id.

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

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

Here is the caller graph for this function:

◆ setLastChange()

assQuestion::setLastChange ( $lastChange )

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

References $lifecycle.

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

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

Here is the caller graph for this function:

◆ setNewOriginalId()

assQuestion::setNewOriginalId ( int $newId )

Deprecated:

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

References getId().

                                                 : void
     {
         self::saveOriginalId($this->getId(), $newId);
     }

Here is the call graph for this function:

◆ setNrOfTries()

assQuestion::setNrOfTries ( int $a_nr_of_tries )

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

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

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

References $obj_id.

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

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

Here is the caller graph for this function:

◆ setObligationsToBeConsidered()

assQuestion::setObligationsToBeConsidered ( bool $obligationsToBeConsidered )

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

References $obligationsToBeConsidered.

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

◆ setOriginalId()

assQuestion::setOriginalId ( ?int $original_id )

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

References $original_id.

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

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

Here is the caller graph for this function:

◆ setOutputType()

assQuestion::setOutputType ( int $outputType = OUTPUT_HTML )

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

References $outputType.

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

◆ setOwner()

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

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

References $owner.

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

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

Here is the caller graph for this function:

◆ setPoints()

assQuestion::setPoints ( float $points )

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

References $points.

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

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

Here is the caller graph for this function:

◆ setPreventRteUsage()

assQuestion::setPreventRteUsage ( bool $prevent_rte_usage )

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

References $processLocker.

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

◆ setQuestion()

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

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

References $question, and getQuestionType().

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setSelfAssessmentEditingMode()

assQuestion::setSelfAssessmentEditingMode ( bool $selfassessmenteditingmode )

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

References $selfassessmenteditingmode.

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

◆ setShuffle()

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

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

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

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

Here is the caller graph for this function:

◆ setShuffler()

assQuestion::setShuffler ( Transformation $shuffler )

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

References $step.

Referenced by assFileUpload\deleteUploadedFiles().

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

Here is the caller graph for this function:

◆ setSuggestedSolution()

assQuestion::setSuggestedSolution	(	string	$solution_id = `""`,
		int	$subquestion_index = `0`,
		bool	$is_import = `false`
	)

Sets a suggested solution for the question.

If there is more than one subquestion (i.e. close questions) may enter a subquestion index.

Parameters

string	$solution_id	An internal link pointing to the suggested solution
int	$subquestion_index	The index of a subquestion (i.e. a close test gap). Usually 0
bool	$is_import	A boolean indication that the internal link was imported from another ILIAS installation public

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

References _resolveInternalLink().

Referenced by assFlashQuestion\loadFromDb().

                                                                                                                        : void
     {
         if (strcmp($solution_id, "") != 0) {
             $import_id = "";
             if ($is_import) {
                 $import_id = $solution_id;
                 $solution_id = $this->_resolveInternalLink($import_id);
             }
             $this->suggested_solutions[$subquestion_index] = array(
                 "internal_link" => $solution_id,
                 "import_id" => $import_id
             );
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setTestId()

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

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

References $id.

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

◆ setThumbSize()

assQuestion::setThumbSize ( int $a_size )

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

Referenced by assOrderingQuestion\loadFromDb(), assSingleChoice\loadFromDb(), assMultipleChoice\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 470 of file class.assQuestion.php.

References $title.

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

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

Here is the caller graph for this function:

◆ supportsJavascriptOutput()

assQuestion::supportsJavascriptOutput ( )

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

Referenced by requiresJsSwitch().

                                               : bool
     {
         return false;
     }

Here is the caller graph for this function:

◆ supportsNonJsOutput()

assQuestion::supportsNonJsOutput ( )

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

Referenced by requiresJsSwitch().

                                          : bool
     {
         return true;
     }

Here is the caller graph for this function:

◆ syncHints()

assQuestion::syncHints ( )

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

References getId().

Referenced by syncWithOriginal().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ syncSkillAssignments()

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

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

References duplicateSkillAssignments(), and ilSkillUsage\setUsage().

                                                                                                                     : 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()) {
                 ilSkillUsage::setUsage(
                     $assignment->getParentObjId(),
                     $assignment->getSkillBaseId(),
                     $assignment->getSkillTrefId(),
                     false
                 );
             }
         }
 
         $this->duplicateSkillAssignments($srcParentId, $srcQuestionId, $trgParentId, $trgQuestionId);
     }

Here is the call graph for this function:

◆ syncSuggestedSolutionFiles()

assQuestion::syncSuggestedSolutionFiles	(	int	$target_question_id,
		int	$target_obj_id
	)

protected

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

References $filename, $index, ilFileUtils\delDir(), getSuggestedSolutionPath(), and ilFileUtils\makeDirParents().

Referenced by updateSuggestedSolutions().

      : void {
         $filepath = $this->getSuggestedSolutionPath();
         $filepath_original = str_replace(
             "{$this->getObjId()}/{$this->id}/solution",
             "{$target_obj_id}/{$target_question_id}/solution",
             $filepath
         );
         ilFileUtils::delDir($filepath_original);
         foreach ($this->suggested_solutions as $index => $solution) {
             if (strcmp($solution["type"], "file") == 0) {
                 if (!file_exists($filepath_original)) {
                     ilFileUtils::makeDirParents($filepath_original);
                 }
                 $filename = $solution["value"]["name"];
                 if (strlen($filename)) {
                     if (!@copy($filepath . $filename, $filepath_original . $filename)) {
                         $this->ilLog->root()->error("File could not be duplicated!!!!");
                         $this->ilLog->root()->error("object: " . print_r($this, true));
                     }
                 }
             }
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ syncWithOriginal()

assQuestion::syncWithOriginal ( )

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

References afterSyncWithOriginal(), beforeSyncWithOriginal(), copyPageOfQuestion(), createPageObject(), deletePageOfQuestion(), getId(), getObjId(), getOriginalId(), saveToDb(), setId(), setObjId(), setOriginalId(), syncHints(), syncXHTMLMediaObjectsOfQuestion(), and updateSuggestedSolutions().

                                       : void
     {
         if (!$this->getOriginalId()) {
             return; // No original -> no sync
         }
         $currentID = $this->getId();
         $currentObjId = $this->getObjId();
         $originalID = $this->getOriginalId();
         $originalObjId = self::lookupParentObjId($this->getOriginalId());
 
         if (!$originalObjId) {
             return; // Original does not exist -> no sync
         }
 
         $this->beforeSyncWithOriginal($this->getOriginalId(), $this->getId(), $originalObjId, $this->getObjId());
 
         // Now we become the original
         $this->setId($this->getOriginalId());
         $this->setOriginalId(null);
         $this->setObjId($originalObjId);
         // And save ourselves as the original
         $this->saveToDb();
 
         // Now we delete the originals page content
         $this->deletePageOfQuestion($originalID);
         $this->createPageObject();
         $this->copyPageOfQuestion($currentID);
 
         $this->setId($currentID);
         $this->setOriginalId($originalID);
         $this->setObjId($currentObjId);
 
         $this->updateSuggestedSolutions($this->getOriginalId(), $originalObjId);
         $this->syncXHTMLMediaObjectsOfQuestion();
 
         $this->afterSyncWithOriginal($this->getOriginalId(), $this->getId(), $originalObjId, $this->getObjId());
         $this->syncHints();
     }

Here is the call graph for this function:

◆ syncXHTMLMediaObjectsOfQuestion()

assQuestion::syncXHTMLMediaObjectsOfQuestion ( )

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

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

Referenced by syncWithOriginal().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ toJSON()

assQuestion::toJSON ( )

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

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

                             : string
     {
         return json_encode([]);
     }

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

Returns a QTI xml representation of the question.

Returns: string The QTI xml representation of the question

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

References getStep().

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

                                                                                                      : int
     {
         $fieldData = array(
             "value1" => array("clob", $value1),
             "value2" => array("clob", $value2),
             "tstamp" => array("integer", time()),
             'authorized' => array('integer', (int) $authorized)
         );
 
         if ($this->getStep() !== null) {
             $fieldData['step'] = array("integer", $this->getStep());
         }
 
         return $this->db->update("tst_solutions", $fieldData, array(
             'solution_id' => array('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 3771 of file class.assQuestion.php.

References getId(), and getStep().

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

                                                                                                                            : int
     {
         $fieldData = array(
             'authorized' => array('integer', (int) $authorized)
         );
 
         if (!$keepTime) {
             $fieldData['tstamp'] = array('integer', time());
         }
 
         $whereData = array(
             'question_fi' => array('integer', $this->getId()),
             'active_fi' => array('integer', $activeId),
             'pass' => array('integer', $pass)
         );
 
         if ($this->getStep() !== null) {
             $whereData['step'] = array("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:

◆ updateSuggestedSolutions()

assQuestion::updateSuggestedSolutions	(	int	$original_id = `-1`,
		int	$original_obj_id = `-1`
	)

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

References $index, $original_id, $type, ilInternalLink\_deleteAllLinksOfSource(), ilRTE\_replaceMediaObjectImageSrc(), ilInternalLink\_saveLink(), cleanupMediaObjectUsage(), getId(), and syncSuggestedSolutionFiles().

Referenced by saveToDb(), and syncWithOriginal().

                                                                                               : void
     {
         $id = $original_id !== -1 ? $original_id : $this->getId();
         $this->db->manipulateF(
             "DELETE FROM qpl_sol_sug WHERE question_fi = %s",
             array('integer'),
             array($id)
         );
         ilInternalLink::_deleteAllLinksOfSource("qst", $id);
         foreach ($this->suggested_solutions as $index => $solution) {
             $next_id = $this->db->nextId('qpl_sol_sug');
 
             $value = $solution['value'] ?? '';
             if (is_array($value)) {
                 $value = serialize($value);
             }
 
             $this->db->insert(
                 'qpl_sol_sug',
                 array(
                    'suggested_solution_id' => array('integer',  $next_id),
                    'question_fi' => array('integer',    $id ),
                    'type' => array('text', $solution['type'] ?? ''),
                    'value' => array('clob', ilRTE::_replaceMediaObjectImageSrc($value)),
                    'internal_link' => array( 'text', $solution['internal_link'] ?? ''),
                    'import_id' => array('text', null),
                    'subquestion_index' => array('integer', $index),
                    'tstamp' => array('integer', time()),
                 )
             );
             if (preg_match("/il_(\d*?)_(\w+)_(\d+)/", $solution["internal_link"], $matches)) {
                 ilInternalLink::_saveLink("qst", $id, $matches[2], (int) $matches[3], (int) $matches[1]);
             }
         }
         if ($original_id !== -1
             && $original_obj_id !== -1) {
             $this->syncSuggestedSolutionFiles($id, $original_obj_id);
         }
         $this->cleanupMediaObjectUsage();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ updateTimestamp()

assQuestion::updateTimestamp ( )

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

References getId().

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

Here is the call graph for this function:

◆ usageNumber()

assQuestion::usageNumber ( int $question_id = 0 )

Returns the number of place the question is in use in pools or tests.

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

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

Referenced by isInUse().

                                                      : int
     {
         if ($question_id < 1) {
             $question_id = $this->getId();
         }
 
         $result = $this->db->queryF(
             "SELECT COUNT(qpl_questions.question_id) question_count FROM qpl_questions, tst_test_question WHERE qpl_questions.original_id = %s AND qpl_questions.question_id = tst_test_question.question_fi",
             array('integer'),
             array($question_id)
         );
         $row = $this->db->fetchAssoc($result);
         $count = (int) $row["question_count"];
 
         $result = $this->db->queryF(
             "
                         SELECT tst_active.test_fi
                         FROM qpl_questions
                         INNER JOIN tst_test_rnd_qst ON tst_test_rnd_qst.question_fi = qpl_questions.question_id
                         INNER JOIN tst_active ON tst_active.active_id = tst_test_rnd_qst.active_fi
                         WHERE qpl_questions.original_id = %s
                         GROUP BY tst_active.test_fi",
             array('integer'),
             array($question_id)
         );
         $count += (int) $this->db->numRows($result);
 
         return $count;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ validateSolutionSubmit()

assQuestion::validateSolutionSubmit ( )

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

References saveWorkingData().

Referenced by persistPreviewState(), and persistWorkingState().

                                             : bool
     {
         return true;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

◆ $additionalContentEditingMode

string assQuestion::$additionalContentEditingMode = ''

private

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

Referenced by getAdditionalContentEditingMode(), and setAdditionalContentEditingMode().

◆ $allowedCharsetsByMimeType

assQuestion::$allowedCharsetsByMimeType

staticprotected

Initial value:

= array(
        self::IMG_MIME_TYPE_JPG => ['binary'],
        self::IMG_MIME_TYPE_PNG => ['binary'],
        self::IMG_MIME_TYPE_GIF => ['binary']
    )

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

◆ $allowedFileExtensionsByMimeType

assQuestion::$allowedFileExtensionsByMimeType

staticprotected

Initial value:

= array(
        self::IMG_MIME_TYPE_JPG => ['jpg', 'jpeg'],
        self::IMG_MIME_TYPE_PNG => ['png'],
        self::IMG_MIME_TYPE_GIF => ['gif']
    )

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

◆ $allowedImageMaterialFileExtensionsByMimeType

assQuestion::$allowedImageMaterialFileExtensionsByMimeType

staticprotected

Initial value:

= array(
        'image/jpeg' => ['jpg', 'jpeg'],
        'image/png' => ['png'],
        'image/gif' => ['gif']
    )

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

◆ $author

string assQuestion::$author

protected

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

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

◆ $comment

◆ $current_user

ilObjUser assQuestion::$current_user

protected

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

Referenced by createNewQuestion().

◆ $db

ilDBInterface assQuestion::$db

protected

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

Referenced by assClozeTest\calculateReachedPoints().

◆ $defaultnroftries

int assQuestion::$defaultnroftries = 0

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

Referenced by getDefaultNrOfTries(), and setDefaultNrOfTries().

◆ $dic

Container assQuestion::$dic

protected

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

◆ $export_image_path

string assQuestion::$export_image_path

private

(Web) Path to images

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

Referenced by getImagePathWeb().

◆ $external_id

string assQuestion::$external_id = null

protected

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

Referenced by getExternalId(), and setExternalId().

◆ $feedbackOBJ

ilAssQuestionFeedback assQuestion::$feedbackOBJ

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

◆ $forcePassResultsUpdateEnabled

assQuestion::$forcePassResultsUpdateEnabled = false

staticprotected

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

Referenced by setForcePassResultUpdateEnabled().

◆ $http

ILIAS HTTP Services assQuestion::$http

protected

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

◆ $id

int assQuestion::$id

protected

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

◆ $ilias

assQuestion::$ilias

protected

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

◆ $ilLog

ILIAS DI LoggingServices assQuestion::$ilLog

protected

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

Referenced by __construct(), assKprimChoice\afterSyncWithOriginal(), assOrderingQuestion\copyImages(), assMatchingQuestion\copyImages(), assMultipleChoice\copyImages(), assMultipleChoice\deleteImage(), assImagemapQuestion\duplicateImage(), assOrderingQuestion\duplicateImages(), assMatchingQuestion\duplicateImages(), assSingleChoice\duplicateImages(), assImagemapQuestion\setImageFilename(), assSingleChoice\syncImages(), and assMultipleChoice\syncImages().

◆ $imageSourceFixReplaceMap

assQuestion::$imageSourceFixReplaceMap

staticprotected

Initial value:

= array(
        'ok.svg' => 'ok.png',
        'not_ok.svg' => 'not_ok.png',
        'checkbox_checked.svg' => 'checkbox_checked.png',
        'checkbox_unchecked.svg' => 'checkbox_unchecked.png',
        'radiobutton_checked.svg' => 'radiobutton_checked.png',
        'radiobutton_unchecked.svg' => 'radiobutton_unchecked.png'
    )

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

◆ $lastChange

assQuestion::$lastChange

protected

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

Referenced by getLastChange(), and setLastChange().

◆ $lifecycle

ilAssQuestionLifecycle assQuestion::$lifecycle

protected

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

Referenced by getLifecycle(), and setLifecycle().

◆ $lng

ilLanguage assQuestion::$lng

protected

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

Referenced by __construct(), and assFileUpload\deliverFileUploadZIPFile().

◆ $nr_of_tries

int assQuestion::$nr_of_tries

private

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

Referenced by getNrOfTries().

◆ $obj_id

int assQuestion::$obj_id = 0

protected

Object id of the container object.

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

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

◆ $obligationsToBeConsidered

bool assQuestion::$obligationsToBeConsidered = false

private

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

Referenced by areObligationsToBeConsidered(), and setObligationsToBeConsidered().

◆ $original_id

int assQuestion::$original_id = null

protected

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

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

◆ $outputType

int assQuestion::$outputType = OUTPUT_JAVASCRIPT

protected

Contains the output type of a question.

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

Referenced by getOutputType(), and setOutputType().

◆ $owner

string assQuestion::$owner

protected

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

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

◆ $page

assQuestion::$page

protected

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

Referenced by copyPageOfQuestion(), deletePageOfQuestion(), and getPageOfQuestion().

◆ $points

float assQuestion::$points

protected

The maximum available points for the question.

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

◆ $prevent_rte_usage

bool assQuestion::$prevent_rte_usage = false

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

Referenced by getPreventRteUsage(), and setPreventRteUsage().

◆ $processLocker

ilAssQuestionProcessLocker assQuestion::$processLocker

protected

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

Referenced by getProcessLocker(), and setProcessLocker().

◆ $question

string assQuestion::$question

protected

◆ $questionActionCmd

string assQuestion::$questionActionCmd = 'handleQuestionAction'

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

◆ $refinery

ILIAS Refinery Factory assQuestion::$refinery

protected

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

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

◆ $selfassessmenteditingmode

bool assQuestion::$selfassessmenteditingmode = false

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

Referenced by getSelfAssessmentEditingMode(), and setSelfAssessmentEditingMode().

◆ $shuffle

bool assQuestion::$shuffle

protected

Indicates whether the answers will be shuffled or not.

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

Referenced by getShuffler(), and setShuffler().

◆ $step

assQuestion::$step

protected

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

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

◆ $suggested_solutions

array assQuestion::$suggested_solutions

protected

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

Referenced by getSuggestedSolutions().

◆ $test_id

int assQuestion::$test_id

protected

The database id of a test in which the question is contained.

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

Referenced by assFileUpload\deleteUploadedFiles(), assFileUpload\deliverFileUploadZIPFile(), getTestId(), assFileUpload\getUploadedFilesForWeb(), assFileUpload\hasFileUploads(), lookupTestId(), assFileUpload\removeIntermediateSolution(), and assFileUpload\saveWorkingData().

◆ $testQuestionConfig

ilTestQuestionConfig assQuestion::$testQuestionConfig

protected

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

◆ $testQuestionConfigInstance

ilTestQuestionConfig assQuestion::$testQuestionConfigInstance = null

private

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

Referenced by getTestPresentationConfig().

◆ $thumb_size

int assQuestion::$thumb_size

protected

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

Referenced by getThumbSize().

◆ $title

string assQuestion::$title

protected

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

Referenced by assFormulaQuestion\__construct(), assLongMenu\__construct(), assOrderingHorizontal\__construct(), assFlashQuestion\__construct(), assNumeric\__construct(), assKprimChoice\__construct(), assErrorText\__construct(), assTextSubset\__construct(), assImagemapQuestion\__construct(), assSingleChoice\__construct(), assOrderingQuestion\__construct(), assTextQuestion\__construct(), assMultipleChoice\__construct(), assMatchingQuestion\__construct(), assClozeTest\__construct(), __construct(), assOrderingHorizontal\copyObject(), assNumeric\copyObject(), assFileUpload\copyObject(), assImagemapQuestion\copyObject(), assOrderingQuestion\copyObject(), assTextSubset\copyObject(), assTextQuestion\copyObject(), assFlashQuestion\copyObject(), assErrorText\copyObject(), assSingleChoice\copyObject(), assMultipleChoice\copyObject(), assMatchingQuestion\copyObject(), assLongMenu\copyObject(), assFormulaQuestion\copyObject(), assKprimChoice\copyObject(), assClozeTest\copyObject(), assOrderingHorizontal\duplicate(), assNumeric\duplicate(), assFileUpload\duplicate(), assOrderingQuestion\duplicate(), assImagemapQuestion\duplicate(), assTextSubset\duplicate(), assFlashQuestion\duplicate(), assTextQuestion\duplicate(), assErrorText\duplicate(), assSingleChoice\duplicate(), assMultipleChoice\duplicate(), assMatchingQuestion\duplicate(), assLongMenu\duplicate(), assFormulaQuestion\duplicate(), assKprimChoice\duplicate(), assClozeTest\duplicate(), getSuggestedSolutionTitle(), getTitle(), and setTitle().

◆ $tpl

ilGlobalPageTemplate assQuestion::$tpl

protected

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

Referenced by __construct().

◆ ADDITIONAL_CONTENT_EDITING_MODE_IPE

const assQuestion::ADDITIONAL_CONTENT_EDITING_MODE_IPE = 'pageobject'

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

Referenced by assQuestionGUI\addBasicQuestionFormProperties(), ilTestExpressPageObjectGUI\addQuestion(), ilObjTestGUI\addQuestionObject(), ilObjQuestionPoolGUI\buildCreateQuestionForm(), ilObjTestGUI\createQuestionObject(), ilPCQuestionGUI\insert(), and isAdditionalContentEditingModePageObject().

◆ ADDITIONAL_CONTENT_EDITING_MODE_RTE

const assQuestion::ADDITIONAL_CONTENT_EDITING_MODE_RTE = 'default'

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

Referenced by assClozeTestGUI\addBasicQuestionFormProperties(), ilTestExpressPageObjectGUI\addQuestion(), ilObjTestGUI\addQuestionObject(), ilObjQuestionPoolGUI\buildCreateQuestionForm(), ilObjQuestionPoolGUI\createQuestionForTestObject(), ilObjQuestionPoolGUI\createQuestionObject(), ilObjTestGUI\createQuestionObject(), ilPCQuestionGUI\edit(), assQuestionImport\fetchAdditionalContentEditingModeInformation(), ilTestExpressPageObjectGUI\handleToolbarCommand(), ilPCQuestionGUI\insert(), assLongMenuGUI\populateQuestionSpecificFormPart(), and assClozeTestGUI\populateQuestionSpecificFormPart().

◆ DEFAULT_THUMB_SIZE

const assQuestion::DEFAULT_THUMB_SIZE = 150

private

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

◆ HAS_SPECIFIC_FEEDBACK

const assQuestion::HAS_SPECIFIC_FEEDBACK = true

protected

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

◆ IMG_MIME_TYPE_GIF

const assQuestion::IMG_MIME_TYPE_GIF = 'image/gif'

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

◆ IMG_MIME_TYPE_JPG

const assQuestion::IMG_MIME_TYPE_JPG = 'image/jpeg'

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

◆ IMG_MIME_TYPE_PNG

const assQuestion::IMG_MIME_TYPE_PNG = 'image/png'

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

◆ KEY_VALUES_IMPLOSION_SEPARATOR

const assQuestion::KEY_VALUES_IMPLOSION_SEPARATOR = ':'

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

Referenced by explodeKeyValues(), and implodeKeyValues().

◆ MAXIMUM_THUMB_SIZE

const assQuestion::MAXIMUM_THUMB_SIZE = 8192

private

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

◆ MINIMUM_THUMB_SIZE

const assQuestion::MINIMUM_THUMB_SIZE = 20

private

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

◆ TRIM_PATTERN

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

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

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

Modules/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

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ __get()

◆ __isset()

◆ __set()

◆ _areAnswered()

◆ _getInternalLinkHref()

◆ _getMaximumPoints()

◆ _getOriginalId()

◆ _getQuestionInfo()

◆ _getQuestionText()

◆ _getQuestionTitle()

◆ _getQuestionType()

◆ _getQuestionTypeName()

◆ _getReachedPoints()

◆ _getSolutionMaxPass()

◆ _getSuggestedSolution()

◆ _getSuggestedSolutionCount()

◆ _getSuggestedSolutionOutput()

◆ _getTitle()

◆ _getTotalRightAnswers()

◆ _includeClass()

◆ _instanciateQuestion()

◆ _instanciateQuestionGUI()

◆ _instantiateQuestion()

◆ _isUsedInRandomTest()

◆ _isWorkedThrough()

◆ _isWriteable()

◆ _needsManualScoring()

◆ _questionExists()

◆ _questionExistsInPool()

◆ _questionExistsInTest()

◆ _resolveInternalLink()

◆ _resolveIntLinks()

◆ _setReachedPoints()

◆ _updateTestResultCache()

◆ addAnswerOptionValue()

◆ addQTIMaterial()

◆ adjustReachedPointsByScoringOptions()

◆ afterSyncWithOriginal()

◆ areObligationsToBeConsidered()

◆ authorizedOrIntermediateSolutionExists()

◆ authorizedSolutionExists()

◆ beforeSyncWithOriginal()

◆ buildHashedImageFilename()

◆ buildImagePath()

◆ buildQuestionDataQuery()

◆ buildTestPresentationConfig()

◆ calculateReachedPoints()

◆ calculateReachedPointsFromPreviewSession()

◆ calculateResultsFromSolution()

◆ cleanupMediaObjectUsage()

◆ convertISO8601FormatH_i_s_ExtendedToSeconds()

◆ copyPageOfQuestion()

◆ copySuggestedSolutionFiles()

◆ copyXHTMLMediaObjectsOfQuestion()

◆ createNewQuestion()

◆ createPageObject()

◆ deductHintPointsFromReachedPoints()

◆ delete()

◆ deleteAdditionalTableData()

◆ deleteAnswers()

◆ deleteDummySolutionRecord()

◆ deletePageOfQuestion()

◆ deleteSolutionRecordByValues()

◆ deleteSuggestedSolutions()

◆ deleteTaxonomyAssignments()

◆ duplicate()

◆ duplicateIntermediateSolutionAuthorized()