assQuestion Class Reference

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...
	setTitle (string $title="")
	setId (int $id=-1)
	setTestId (int $id=-1)
	setComment (string $comment="")
	setShuffle (?bool $shuffle=true)
	setAuthor (string $author="")
	setOwner (int $owner=-1)
	getTitle ()
	getTitleForHTMLOutput ()
	getTitleFilenameCompliant ()
	getId ()
	getShuffle ()
	getTestId ()
	getComment ()
	getDescriptionForHTMLOutput ()
	getThumbSize ()
	setThumbSize (int $a_size)
	getMinimumThumbSize ()
	getMaximumThumbSize ()
	getAuthor ()
	getAuthorForHTMLOutput ()
	getOwner ()
	getObjId ()
	setObjId (int $obj_id=0)
	getLifecycle ()
	setLifecycle (ilAssQuestionLifecycle $lifecycle)
	setExternalId (?string $external_id)
	getExternalId ()
	getSuggestedSolutionOutput ()
	getSuggestedSolutions ()
	getReachedPoints (int $active_id, int $pass)
	getMaximumPoints ()
	getAdjustedReachedPoints (int $active_id, int $pass, bool $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...
	getSuggestedSolutionPath ()
	getImagePath ($question_id=null, $object_id=null)
	Returns the image path for web accessable images of a question. More...
	getSuggestedSolutionPathWeb ()
	getImagePathWeb ()
	Returns the web image path for web accessable images of a question. More...
	getTestOutputSolutions (int $activeId, int $pass)
	getUserSolutionPreferingIntermediate (int $active_id, $pass=null)
	getSolutionValues ($active_id, $pass=null, bool $authorized=true)
	Loads solutions of a given user from the database an returns it. 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 ()
	deleteSuggestedSolutions ()
	getSuggestedSolution (int $subquestion_index=0)
	resolveInternalLink (string $internal_link)
	resolveSuggestedSolutionLinks ()
	syncWithOriginal ()
	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...
	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 ()
	setExportDetailsXLSX (ilAssExcelFormatHelper $worksheet, int $startrow, int $col, int $active_id, int $pass)
	getNrOfTries ()
	setNrOfTries (int $a_nr_of_tries)
	setExportImagePath (string $path)
	formatSAQuestion ($a_q)
	setPreventRteUsage (bool $prevent_rte_usage)
	getPreventRteUsage ()
	migrateContentForLearningModule (ilAssSelfAssessmentMigrator $migrator)
	setSelfAssessmentEditingMode (bool $selfassessmenteditingmode)
	getSelfAssessmentEditingMode ()
	setDefaultNrOfTries (int $defaultnroftries)
	getDefaultNrOfTries ()
	syncSkillAssignments (int $srcParentId, int $srcQuestionId, int $trgParentId, int $trgQuestionId)
	ensureHintPageObjectExists ($pageObjectId)
	isAnswered (int $active_id, int $pass)
	getAdditionalContentEditingMode ()
	setAdditionalContentEditingMode (?string $additionalContentEditingMode)
	isAdditionalContentEditingModePageObject ()
	isValidAdditionalContentEditingMode (string $additionalContentEditingMode)
	getValidAdditionalContentEditingModes ()
	getHtmlUserSolutionPurifier ()
	getHtmlQuestionContentPurifier ()
	setLastChange ($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="", int $owner=-1, $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 ()

Static Public Member Functions
static	setForcePassResultUpdateEnabled (bool $forcePassResultsUpdateEnabled)
static	isForcePassResultUpdateEnabled ()
static	_getSuggestedSolutionOutput (int $question_id)
static	_getReachedPoints (int $active_id, int $question_id, int $pass)
static	logAction (string $logtext, int $active_id, int $question_id)
static	isFileAvailable (string $file)
static	saveOriginalId (int $questionId, int $originalId)
static	resetOriginalId (int $questionId)
static	_getInternalLinkHref (string $target="")
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	_setReachedPoints (int $active_id, int $question_id, float $points, float $maxpoints, int $pass, bool $manualscoring, bool $obligationsEnabled, ?int $test_id=null)
	Sets the points, a learner has reached answering the question Additionally objective results are updated. More...
static	_needsManualScoring (int $question_id)
static	getFeedbackClassNameByQuestionType (string $questionType)
static	instantiateQuestionGUI (int $a_question_id)
static	_questionExistsInTest (int $question_id, int $test_id)
static	lookupParentObjId (int $questionId)
static	isObligationPossible (int $questionId)
static	implodeKeyValues (array $keyValues)
static	explodeKeyValues (string $keyValues)
static	convertISO8601FormatH_i_s_ExtendedToSeconds (string $time)
static	extendedTrim (string $value)
	Trim non-printable characters from the beginning and end of a string. More...

Data Fields
const	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)
	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)
	duplicateComments (int $parent_source_id, int $source_id, int $parent_target_id, int $target_id)
	deleteComments ()
	getNotesManager ()
	getNotesDataService ()
	getNotesRepo ()
	syncSuggestedSolutions (int $target_question_id, int $target_obj_id)
	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)
	copySuggestedSolutions (int $target_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...
	getSuggestedSolutionsRepo ()
	loadSuggestedSolutions ()

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

Protected Attributes
const	HAS_SPECIFIC_FEEDBACK = true
ILIAS TestQuestionPool QuestionInfoService	$questioninfo
ILIAS Test TestParticipantInfoService	$testParticipantInfo
ILIAS HTTP Services	$http
ILIAS Refinery Factory	$refinery
ILIAS TestQuestionPool QuestionFilesService	$questionFilesService
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
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
SkillUsageService	$skillUsageService
assQuestionSuggestedSolutionsDatabaseRepository	$suggestedsolution_repo = null

Static Protected Attributes
static	$forcePassResultsUpdateEnabled = false
static	$imageSourceFixReplaceMap

Private Member Functions
	importHint (int $question_id, array $hint_array)
	deleteTaxonomyAssignments ()

Private Attributes
const	DEFAULT_THUMB_SIZE = 150
const	MINIMUM_THUMB_SIZE = 20
const	MAXIMUM_THUMB_SIZE = 8192
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 46 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 174 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->questioninfo = $DIC->testQuestionPool()->questionInfo();
        $this->questionFilesService = $DIC->testQuestionPool()->questionFiles();
        $this->testParticipantInfo = $DIC->test()->testParticipantInfo();
        $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();
        $this->skillUsageService = $DIC->skills()->usage();
    }

Here is the call graph for this function:

Member Function Documentation

_getInternalLinkHref()

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

static

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

References $DIC.

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:

_getReachedPoints()

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

static

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

References $DIC, $ilDB, and $points.

Referenced by ilTestScoringByQuestionsGUI\appendFormToModal(), ilTestScoringGUI\buildManScoringParticipantForm(), ilTestServiceGUI\getPassListOfAnswersWithScoring(), ilTestScoringByQuestionsGUI\saveManScoringByQuestion(), 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 1796 of file class.assQuestion.php.

References $DIC, and $ilDB.

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

                                                                                : ?int
    {
        // the following code was the old solution which added the non answered
        // questions of a pass from the answered questions of the previous pass
        // with the above solution, only the answered questions of the last pass are counted
        global $DIC;
        $ilDB = $DIC['ilDB'];

        $result = $ilDB->queryF(
            "SELECT MAX(pass) maxpass FROM tst_test_result WHERE active_fi = %s AND question_fi = %s",
            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:

_getSuggestedSolutionOutput()

static assQuestion::_getSuggestedSolutionOutput ( int  $question_id )

static

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

_isWriteable()

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

static

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

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

Referenced by ilAssQuestionFeedbackEditingGUI\isSyncAfterSaveRequired(), ilAssQuestionHintsGUI\performDeleteCmd(), assQuestionGUI\saveEdit(), ilAssQuestionHintGUI\saveFormCmd(), ilAssQuestionHintsGUI\saveListOrderCmd(), assQuestionGUI\saveQuestionToTest(), 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 2175 of file class.assQuestion.php.

References $DIC, and ilObjAssessmentFolder\_getManualScoringTypes().

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

                                                                : bool
    {
        global $DIC;
        $questioninfo = $DIC->testQuestionPool()->questionInfo();
        $scoring = ilObjAssessmentFolder::_getManualScoringTypes();
        $questiontype = $questioninfo->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:

_questionExistsInTest()

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

static

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

References $DIC, and $ilDB.

Referenced by assQuestionGUI\saveQuestionToTest().

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

_setReachedPoints()

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

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

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

Referenced by assFileUpload\handleSubmission(), ilTestScoringByQuestionsGUI\saveManScoringByQuestion(), and ilTestScoringGUI\saveManScoringParticipantScreen().

     : 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) {
                $test_id = $test_id ? (int) ilObjTest::_getObjectIDFromTestID($test_id) : ilObjTest::_lookupTestObjIdForQuestionId($question_id);
                if ($test_id === null || $test_id == 0) {
                    return false;
                }
                $test = new ilObjTest(
                    $test_id,
                    false
                );
                $test->updateTestPassResults($active_id, $pass, $obligationsEnabled);
                ilCourseObjectiveResult::_updateObjectiveResult(ilObjTest::_getUserIdFromActiveId($active_id), $active_id, $question_id);
                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:

addAnswerOptionValue()

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

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

                                                                                               : void
    {
    }

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 1895 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 1419 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 3035 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 2877 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 2868 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 1415 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 1911 of file class.assQuestion.php.

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

                                                                                                : string
    {
        $extension = "";

        if (preg_match("/.*\.(png|jpg|gif|jpeg)$/i", $plain_image_filename, $matches)) {
            $extension = "." . $matches[1];
        }

        if ($unique) {
            $plain_image_filename = uniqid($plain_image_filename . microtime(true), true);
        }

        return md5($plain_image_filename) . $extension;
    }

Here is the caller graph for this function:

buildQuestionDataQuery()

assQuestion::buildQuestionDataQuery ( )

protected

Definition at line 2534 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 3077 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 _isWriteable(), assNumeric\calculateReachedPointsFromPreviewSession(), calculateResultsFromSolution(), getAdjustedReachedPoints(), and assNumeric\getExpressionTypes().

Here is the caller graph for this function:

calculateReachedPointsFromPreviewSession()

assQuestion::calculateReachedPointsFromPreviewSession

(

ilAssQuestionPreviewSession

$previewSession

)

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

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

Referenced by persistWorkingState().

                                                                                                                   : void
    {
        // determine reached points for submitted solution
        $reached_points = $this->calculateReachedPoints($active_id, $pass);
        $questionHintTracking = new ilAssQuestionHintTracking($this->getId(), $active_id, $pass);
        $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 ($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 = ['integer', 'integer', 'integer'];
                $values = [$active_id, $this->getId(), $pass];

                if ($this->getStep() !== null) {
                    $query .= "
                    AND                         step = %s
                ";

                    $types[] = 'integer';
                    $values[] = $this->getStep();
                }
                $this->db->manipulateF($query, $types, $values);

                if ($existingSolutions['authorized']) {
                    $next_id = $this->db->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());
                    }

                    $this->db->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
        $test = new ilObjTest(
            $this->getObjId(),
            false
        );
        $test->updateTestPassResults($active_id, $pass, $obligationsEnabled, $this->getProcessLocker());
        ilCourseObjectiveResult::_updateObjectiveResult($this->current_user->getId(), $active_id, $this->getId());
    }

Here is the call graph for this function:

Here is the caller graph for this function:

cleanupMediaObjectUsage()

assQuestion::cleanupMediaObjectUsage

(

)

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

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

Referenced by saveToDb().

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

Here is the call graph for this function:

Here is the caller graph for this function:

convertISO8601FormatH_i_s_ExtendedToSeconds()

static assQuestion::convertISO8601FormatH_i_s_ExtendedToSeconds ( string  $time )

static

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

References $page.

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

copySuggestedSolutionFiles()

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

protected

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

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

Referenced by onCopy().

                                                                                                       : void
    {
        foreach ($this->suggested_solutions as $index => $solution) {
            if ($solution->isOfTypeFile()) {
                $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->getFilename();
                if ($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:

copySuggestedSolutions()

assQuestion::copySuggestedSolutions ( int  $target_question_id )

protected

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

References getSuggestedSolutions(), and getSuggestedSolutionsRepo().

Referenced by onCopy(), and onDuplicate().

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

Here is the call graph for this function:

Here is the caller graph for this function:

copyXHTMLMediaObjectsOfQuestion()

assQuestion::copyXHTMLMediaObjectsOfQuestion

(

int

$a_q_id

)

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

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

References $current_user, 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 1145 of file class.assQuestion.php.

References getId(), and getObjId().

Referenced by createNewQuestion(), and saveQuestionDataToDb().

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

Here is the call graph for this function:

Here is the caller graph for this function:

deductHintPointsFromReachedPoints()

assQuestion::deductHintPointsFromReachedPoints	(	ilAssQuestionPreviewSession	$previewSession,
			$reachedPoints
	)

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

References $DIC, and ilAssQuestionPreviewHintTracking\getRequestStatisticData().

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

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

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

                                            : void
    {
        if ($question_id < 1) {
            return;
        }

        $result = $this->db->queryF(
            "SELECT obj_fi FROM qpl_questions WHERE question_id = %s",
            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");
        }

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

        try {
            $this->getSuggestedSolutionsRepo()->deleteForQuestion($question_id);
        } catch (Exception $e) {
            $this->ilLog->root()->error("EXCEPTION: Could not delete suggested solutions of question $question_id: $e");
        }

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

        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");
        }
        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()) {
                $this->skillUsageService->removeUsage(
                    $assignment->getParentObjId(),
                    $assignment->getSkillBaseId(),
                    $assignment->getSkillTrefId()
                );
            }
        }

        $this->deleteTaxonomyAssignments();
        $this->deleteComments();

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

Here is the call graph for this function:

deleteAdditionalTableData()

assQuestion::deleteAdditionalTableData

(

int

$question_id

)

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

deleteComments()

assQuestion::deleteComments ( )

protected

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

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

Referenced by delete().

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

Here is the call graph for this function:

Here is the caller graph for this function:

deleteDummySolutionRecord()

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

protected

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

References $page, and ilPageObject\_exists().

Referenced by delete().

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

Here is the call graph for this function:

Here is the caller graph for this function:

deleteSolutionRecordByValues()

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

protected

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

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

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

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

Here is the call graph for this function:

deleteTaxonomyAssignments()

assQuestion::deleteTaxonomyAssignments ( )

private

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

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

Referenced by delete().

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

duplicate()

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

abstract

Referenced by toJSON().

Here is the caller graph for this function:

duplicateComments()

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

protected

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

References getNotesDataService(), and getNotesManager().

Referenced by onCopy(), and onDuplicate().

     : void {
        $manager = $this->getNotesManager();
        $data_service = $this->getNotesDataService();
        $notes = $manager->getNotesForRepositoryObjIds([$parent_source_id], Note::PUBLIC);
        $notes = array_filter(
            $notes,
            fn($n) => $n->getContext()->getSubObjId() === $source_id
        );

        foreach ($notes as $note) {
            $new_context = $data_service->context(
                $parent_target_id,
                $target_id,
                $note->getContext()->getType()
            );
            $new_note = $data_service->note(
                -1,
                $new_context,
                $note->getText(),
                $note->getAuthor(),
                $note->getType(),
                $note->getCreationDate(),
                $note->getUpdateDate(),
                $note->getRecipient()
            );
            $manager->createNote($new_note, [], true);
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

duplicateIntermediateSolutionAuthorized()

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

protected

Definition at line 2798 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 2372 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 2391 of file class.assQuestion.php.

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

                                                                                                                            : void
    {
        $assignmentList = new ilAssQuestionSkillAssignmentList($this->db);
        $assignmentList->setParentObjId($srcParentId);
        $assignmentList->setQuestionIdFilter($srcQuestionId);
        $assignmentList->loadFromDb();

        foreach ($assignmentList->getAssignmentsByQuestionId($srcQuestionId) as $assignment) {
            $assignment->setParentObjId($trgParentId);
            $assignment->setQuestionId($trgQuestionId);
            $assignment->saveToDb();

            // add skill usage
            $this->skillUsageService->addUsage(
                $trgParentId,
                $assignment->getSkillBaseId(),
                $assignment->getSkillTrefId()
            );
        }
    }

Here is the caller graph for this function:

duplicateSuggestedSolutionFiles()

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

protected

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

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

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

Referenced by onDuplicate().

                                                                                        : void
    {
        foreach ($this->suggested_solutions as $index => $solution) {
            if (!$solution->isOfTypeFile()) {
                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->getFilename();
            if (strlen($filename) &&
                !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:

ensureHintPageObjectExists()

assQuestion::ensureHintPageObjectExists

(

$pageObjectId

)

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

References $points.

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

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

Here is the caller graph for this function:

explodeKeyValues()

static assQuestion::explodeKeyValues ( string  $keyValues )

static

Definition at line 2739 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 3112 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 3024 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:

fetchValuePairsFromIndexedValues()

assQuestion::fetchValuePairsFromIndexedValues

(

array

$indexedValues

)

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

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

fixUnavailableSkinImageSources()

assQuestion::fixUnavailableSkinImageSources

(

string

$html

)

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

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

                                                                : string
    {
        $matches = null;
        if (preg_match_all('/src="(.*?)"/m', $html, $matches)) {
            $sources = $matches[1];

            $needleReplacementMap = [];

            foreach ($sources as $src) {
                $file = ilFileUtils::removeTrailingPathSeparators(ILIAS_ABSOLUTE_PATH) . DIRECTORY_SEPARATOR . $src;

                if (file_exists($file)) {
                    continue;
                }

                $levels = explode(DIRECTORY_SEPARATOR, $src);
                if (count($levels) < 5 || $levels[0] !== 'Customizing' || $levels[2] !== 'skin') {
                    continue;
                }

                $component = '';

                if ($levels[4] === '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:

forceExistingIntermediateSolution()

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

protected

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

References getSelfAssessmentFormatter().

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

References getQuestionType(), and importHint().

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

Here is the call graph for this function:

getActiveUserData()

assQuestion::getActiveUserData

(

int

$active_id

)

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

Parameters

integer

$active_id

Active id for a test/user

Returns

array Result array containing the user_id and test_id

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

References $additionalContentEditingMode.

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

                                                     : string
    {
        return $this->additionalContentEditingMode;
    }

Here is the caller graph for this function:

getAdditionalTableName()

assQuestion::getAdditionalTableName ( )

abstract

Returns

string|array Or Array?

See also

Deletion methods here

Referenced by deleteAdditionalTableData(), and getSolutionValues().

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

getAnswerTableName()

assQuestion::getAnswerTableName ( )

abstract

Returns

string|array Or Array?

See also

Deletion methods here

Referenced by deleteAnswers(), and getSolutionValues().

Here is the caller graph for this function:

getAuthor()

assQuestion::getAuthor

(

)

Definition at line 459 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 464 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 425 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 2556 of file class.assQuestion.php.

References getId(), and getStep().

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

                                                                                                      : \ilDBStatement
    {
        if ($this->getStep() !== null) {
            $query = "
                                SELECT *
                                FROM tst_solutions
                                WHERE active_fi = %s
                                AND question_fi = %s
                                AND pass = %s
                                AND step = %s
                                AND authorized = %s
                        ";

            return $this->db->queryF(
                $query,
                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 2352 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 430 of file class.assQuestion.php.

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

                                                 : string
    {
        return htmlspecialchars($this->comment);
    }

Here is the call graph for this function:

getExternalId()

assQuestion::getExternalId

(

)

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

References $external_id, getId(), and IL_INST_ID.

Referenced by createNewQuestion(), and saveQuestionDataToDb().

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

Here is the call graph for this function:

Here is the caller graph for this function:

getFeedbackClassNameByQuestionType()

static assQuestion::getFeedbackClassNameByQuestionType ( string  $questionType )

static

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

getHtmlQuestionContentPurifier()

assQuestion::getHtmlQuestionContentPurifier

(

)

Returns

ilHtmlPurifierInterface|ilAssHtmlUserSolutionPurifier

Definition at line 2529 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 2521 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 410 of file class.assQuestion.php.

References $id.

Referenced by ilQuestionUsagesTableGUI\__construct(), ilQuestionCumulatedStatisticsTableGUI\__construct(), ilAssQuestionHintsOrderingClipboard\__construct(), assLongMenu\buildFolderName(), assOrderingQuestion\buildNestedOrderingElementInputGui(), assClozeTest\calculateCombinationResult(), calculateResultsFromSolution(), cleanupMediaObjectUsage(), assOrderingHorizontal\copyObject(), assFileUpload\copyObject(), assImagemapQuestion\copyObject(), assTextSubset\copyObject(), assOrderingQuestion\copyObject(), assTextQuestion\copyObject(), assMultipleChoice\copyObject(), assSingleChoice\copyObject(), assErrorText\copyObject(), assMatchingQuestion\copyObject(), assLongMenu\copyObject(), assKprimChoice\copyObject(), assFormulaQuestion\copyObject(), assClozeTest\copyObject(), copyXHTMLMediaObjectsOfQuestion(), assOrderingHorizontal\createNewOriginalFromThisDuplicate(), assNumeric\createNewOriginalFromThisDuplicate(), assFileUpload\createNewOriginalFromThisDuplicate(), assTextSubset\createNewOriginalFromThisDuplicate(), assImagemapQuestion\createNewOriginalFromThisDuplicate(), assTextQuestion\createNewOriginalFromThisDuplicate(), assOrderingQuestion\createNewOriginalFromThisDuplicate(), assSingleChoice\createNewOriginalFromThisDuplicate(), assMultipleChoice\createNewOriginalFromThisDuplicate(), assErrorText\createNewOriginalFromThisDuplicate(), assMatchingQuestion\createNewOriginalFromThisDuplicate(), assLongMenu\createNewOriginalFromThisDuplicate(), assKprimChoice\createNewOriginalFromThisDuplicate(), assFormulaQuestion\createNewOriginalFromThisDuplicate(), assClozeTest\createNewOriginalFromThisDuplicate(), createNewQuestion(), createPageObject(), deleteComments(), deleteSolutionRecordByValues(), deleteSuggestedSolutions(), deleteTaxonomyAssignments(), assOrderingHorizontal\duplicate(), assNumeric\duplicate(), assFileUpload\duplicate(), assOrderingQuestion\duplicate(), assImagemapQuestion\duplicate(), assTextSubset\duplicate(), assTextQuestion\duplicate(), assSingleChoice\duplicate(), assMultipleChoice\duplicate(), assErrorText\duplicate(), assMatchingQuestion\duplicate(), assLongMenu\duplicate(), assKprimChoice\duplicate(), assFormulaQuestion\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(), assMultipleChoice\getExpressionTypes(), assOrderingQuestion\getExpressionTypes(), assFormulaQuestion\getExpressionTypes(), assClozeTest\getExpressionTypes(), getExternalId(), assFileUpload\getFileUploadPath(), assFileUpload\getFileUploadPathWeb(), getInstances(), assTextQuestion\getLatestAutosaveContent(), assClozeTest\getMaximumPoints(), assOrderingQuestion\getOrderingElementList(), assErrorText\getParsedErrorTextForJS(), getReachedPoints(), assImagemapQuestion\getRTETextWithMediaObjects(), assMultipleChoice\getRTETextWithMediaObjects(), assSingleChoice\getRTETextWithMediaObjects(), getRTETextWithMediaObjects(), getSolutionMaxPass(), assOrderingQuestion\getSolutionOrderingElementList(), assTextQuestion\getSolutionSubmit(), getSolutionValues(), assFileUpload\getUploadedFiles(), assErrorText\getUserQuestionResult(), assMatchingQuestion\getUserQuestionResult(), assFormulaQuestion\getVariableSolutionValuesForPass(), assFileUpload\handleSubmission(), assFileUpload\hasFileUploads(), isAnswered(), assSingleChoice\isComplete(), assKprimChoice\isComplete(), assMultipleChoice\isForcedEmptySolution(), assNumeric\isValidSolutionSubmit(), assTextQuestion\loadFromDb(), loadSuggestedSolutions(), log(), assErrorText\logUserAction(), assLongMenu\lookupForExistingSolutions(), assFormulaQuestion\lookupForExistingSolutions(), lookupForExistingSolutions(), lookupMaxStep(), migrateContentForLearningModule(), ilAssNestedOrderingElementsInputGUI\prepareReprintable(), removeAllExistingSolutions(), removeCurrentSolution(), assFormulaQuestion\removeExistingSolutions(), removeExistingSolutions(), removeResultRecord(), ilAssOrderingQuestionAuthoringFormGUI\renewOrderingElementInput(), resolveSuggestedSolutionLinks(), assFileUpload\saveAdditionalQuestionDataToDb(), assErrorText\saveAdditionalQuestionDataToDb(), assImagemapQuestion\saveAdditionalQuestionDataToDb(), assMatchingQuestion\saveAdditionalQuestionDataToDb(), 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(), assFormulaQuestion\saveCurrentSolution(), saveCurrentSolution(), assNumeric\savePreviewData(), assSingleChoice\savePreviewData(), assOrderingQuestion\savePreviewData(), saveQuestionDataToDb(), assMultipleChoice\saveToDb(), assFormulaQuestion\saveToDb(), saveToDb(), assOrderingHorizontal\saveWorkingData(), assSingleChoice\saveWorkingData(), assTextQuestion\saveWorkingData(), assTextSubset\saveWorkingData(), assLongMenu\saveWorkingData(), assFileUpload\saveWorkingData(), assImagemapQuestion\saveWorkingData(), assFormulaQuestion\saveWorkingData(), assMatchingQuestion\saveWorkingData(), assClozeTest\saveWorkingData(), assFormulaQuestion\setId(), assOrderingQuestion\setOrderingElementList(), syncHints(), assMultipleChoice\syncImages(), syncSuggestedSolutions(), syncWithOriginal(), syncXHTMLMediaObjectsOfQuestion(), assOrderingHorizontal\toJSON(), assTextSubset\toJSON(), assTextQuestion\toJSON(), assLongMenu\toJSON(), assKprimChoice\toJSON(), assErrorText\toJSON(), assImagemapQuestion\toJSON(), assMultipleChoice\toJSON(), assSingleChoice\toJSON(), assOrderingQuestion\toJSON(), assMatchingQuestion\toJSON(), assClozeTest\toJSON(), updateCurrentSolutionsAuthorization(), ilLOTestQuestionAdapter\updateQuestionResult(), and updateTimestamp().

                           : int
    {
        return $this->id;
    }

Here is the caller graph for this function:

getImagePath()

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

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

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

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

References $id, and $obj_id.

Referenced by assOrderingQuestion\buildOrderingImagesFormDataConverter(), assOrderingQuestion\cleanImagefiles(), assImagemapQuestion\copyImage(), assOrderingQuestion\copyImages(), assMatchingQuestion\copyImages(), assMultipleChoice\copyImages(), assMultipleChoice\deleteImage(), assSingleChoice\deleteImage(), assImagemapQuestion\deleteImage(), assMatchingQuestion\deleteImagefile(), assOrderingQuestion\dropImageFile(), assImagemapQuestion\duplicateImage(), assOrderingQuestion\duplicateImages(), assMatchingQuestion\duplicateImages(), assSingleChoice\duplicateImages(), assOrderingQuestion\ensureImagePathExists(), assKprimChoice\handleFileUpload(), assMultipleChoice\isForcedEmptySolution(), assOrderingQuestion\isImageFileStored(), assKprimChoice\loadAnswerData(), assSingleChoice\loadFromDb(), assMultipleChoice\loadFromDb(), assOrderingQuestion\rebuildThumbnails(), assMatchingQuestion\rebuildThumbnails(), assSingleChoice\savePreviewData(), assMatchingQuestion\setExportDetailsXLSX(), assMultipleChoice\setImageFile(), assSingleChoice\setImageFile(), assMatchingQuestion\setImageFile(), assImagemapQuestion\setImageFilename(), assOrderingQuestion\storeImageFile(), assMultipleChoice\syncImages(), assSingleChoice\syncImages(), and assOrderingQuestion\updateImageFile().

                                                                        : string
    {
        if ($question_id === null) {
            $question_id = $this->id;
        }

        if ($object_id === null) {
            $object_id = $this->obj_id;
        }

        return $this->questionFilesService->buildImagePath($question_id, $object_id);
    }

Here is the caller graph for this function:

getImagePathWeb()

assQuestion::getImagePathWeb

(

)

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

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

Definition at line 823 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(), assKprimChoice\toJSON(), assImagemapQuestion\toJSON(), assMultipleChoice\toJSON(), assSingleChoice\toJSON(), and assOrderingQuestion\toJSON().

                                     : string
    {
        if (!$this->export_image_path) {
            $webdir = ilFileUtils::removeTrailingPathSeparators(CLIENT_WEB_DIR) . "/assessment/$this->obj_id/$this->id/images/";
            return str_replace(
                ilFileUtils::removeTrailingPathSeparators(ILIAS_ABSOLUTE_PATH),
                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 2137 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 2551 of file class.assQuestion.php.

References $lastChange.

    {
        return $this->lastChange;
    }

getLifecycle()

assQuestion::getLifecycle

(

)

Definition at line 484 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 589 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 454 of file class.assQuestion.php.

                                         : int
    {
        return self::MAXIMUM_THUMB_SIZE;
    }

getMinimumThumbSize()

assQuestion::getMinimumThumbSize

(

)

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

getNotesDataService()

assQuestion::getNotesDataService ( )

protected

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

References $service.

Referenced by duplicateComments().

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

Here is the caller graph for this function:

getNotesManager()

assQuestion::getNotesManager ( )

protected

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

References $service.

Referenced by deleteComments(), and duplicateComments().

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

Here is the caller graph for this function:

getNotesRepo()

assQuestion::getNotesRepo ( )

protected

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

References $service.

Referenced by deleteComments().

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

Here is the caller graph for this function:

getNrOfTries()

assQuestion::getNrOfTries

(

)

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

References $nr_of_tries.

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

                                  : int
    {
        return $this->nr_of_tries;
    }

Here is the caller graph for this function:

getNumExistingSolutionRecords()

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

staticprotected

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

References $DIC, $ilDB, and $res.

Referenced by isAnswered().

                                                                                                      : int
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];

        $query = "
                        SELECT          count(active_fi) cnt

                        FROM            tst_solutions

                        WHERE           active_fi = %s
                        AND                     question_fi = %s
                        AND                     pass = %s
                ";

        $res = $ilDB->queryF(
            $query,
            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 474 of file class.assQuestion.php.

References $obj_id.

Referenced by calculateResultsFromSolution(), assOrderingHorizontal\copyObject(), assNumeric\copyObject(), assFileUpload\copyObject(), assImagemapQuestion\copyObject(), assOrderingQuestion\copyObject(), assTextSubset\copyObject(), assTextQuestion\copyObject(), assMultipleChoice\copyObject(), assSingleChoice\copyObject(), assErrorText\copyObject(), assMatchingQuestion\copyObject(), assLongMenu\copyObject(), assKprimChoice\copyObject(), assFormulaQuestion\copyObject(), assClozeTest\copyObject(), assOrderingHorizontal\createNewOriginalFromThisDuplicate(), assNumeric\createNewOriginalFromThisDuplicate(), assFileUpload\createNewOriginalFromThisDuplicate(), assTextSubset\createNewOriginalFromThisDuplicate(), assImagemapQuestion\createNewOriginalFromThisDuplicate(), assTextQuestion\createNewOriginalFromThisDuplicate(), assOrderingQuestion\createNewOriginalFromThisDuplicate(), assMultipleChoice\createNewOriginalFromThisDuplicate(), assSingleChoice\createNewOriginalFromThisDuplicate(), assErrorText\createNewOriginalFromThisDuplicate(), assMatchingQuestion\createNewOriginalFromThisDuplicate(), assLongMenu\createNewOriginalFromThisDuplicate(), assKprimChoice\createNewOriginalFromThisDuplicate(), assFormulaQuestion\createNewOriginalFromThisDuplicate(), assClozeTest\createNewOriginalFromThisDuplicate(), createNewQuestion(), createPageObject(), delete(), deleteComments(), deleteTaxonomyAssignments(), assOrderingHorizontal\duplicate(), assNumeric\duplicate(), assFileUpload\duplicate(), assOrderingQuestion\duplicate(), assImagemapQuestion\duplicate(), assTextSubset\duplicate(), assTextQuestion\duplicate(), assSingleChoice\duplicate(), assMultipleChoice\duplicate(), assErrorText\duplicate(), assMatchingQuestion\duplicate(), assLongMenu\duplicate(), assKprimChoice\duplicate(), assFormulaQuestion\duplicate(), assClozeTest\duplicate(), saveQuestionDataToDb(), saveToDb(), and syncWithOriginal().

                              : int
    {
        return $this->obj_id;
    }

Here is the caller graph for this function:

getOriginalId()

assQuestion::getOriginalId

(

)

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

References $original_id.

Referenced by syncWithOriginal().

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

Here is the caller graph for this function:

getOwner()

assQuestion::getOwner

(

)

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

References $page.

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

getPoints()

assQuestion::getPoints

(

)

Definition at line 1774 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(), 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 2313 of file class.assQuestion.php.

References $prevent_rte_usage.

                                        : bool
    {
        return $this->prevent_rte_usage;
    }

getProcessLocker()

assQuestion::getProcessLocker

(

)

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

References $processLocker.

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

                                      : ilAssQuestionProcessLocker
    {
        return $this->processLocker;
    }

Here is the caller graph for this function:

getQuestion()

assQuestion::getQuestion

(

)

Definition at line 2029 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(), assKprimChoice\toJSON(), assErrorText\toJSON(), assImagemapQuestion\toJSON(), assMultipleChoice\toJSON(), assSingleChoice\toJSON(), assOrderingQuestion\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 233 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]) || $_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 2034 of file class.assQuestion.php.

References purifyAndPrepareTextAreaOutput().

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

Here is the call graph for this function:

getQuestionType()

assQuestion::getQuestionType ( )

abstract

Returns the question type of the question.

Returns

string The question type of the question

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

Here is the caller graph for this function:

getQuestionTypeID()

assQuestion::getQuestionTypeID

(

)

Definition at line 2065 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 584 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 2113 of file class.assQuestion.php.

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

Referenced by cleanupMediaObjectUsage().

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

        $questionHintList = ilAssQuestionHintList::getListByQuestionId($this->getId());
        foreach ($questionHintList as $questionHint) {
            /* @var $questionHint ilAssQuestionHint */
            $collected .= $questionHint->getText();
        }

        return $collected;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getSelfAssessmentEditingMode()

assQuestion::getSelfAssessmentEditingMode

(

)

Definition at line 2342 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 2301 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 415 of file class.assQuestion.php.

References $shuffle.

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

                                : bool
    {
        return $this->shuffle;
    }

Here is the caller graph for this function:

getShuffler()

assQuestion::getShuffler

(

)

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

References getId().

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

getSolutionRecordById()

assQuestion::getSolutionRecordById ( int  $solutionId )

protected

Returns

array tst_solutions.*

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

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

Referenced by assOrderingQuestion\calculateReachedPoints(), assFormulaQuestion\calculateReachedPoints(), deleteDummySolutionRecord(), duplicateIntermediateSolutionAuthorized(), forceExistingIntermediateSolution(), assOrderingQuestion\getOrderingElementListForSolutionOutput(), ilTestCorrectionsGUI\getSolutions(), ilTestCorrectionsGUI\getSolutionsByParticipantResults(), getTestOutputSolutions(), assFileUpload\getUploadedFilesForWeb(), assFileUpload\getUserSolutionPreferingIntermediate(), getUserSolutionPreferingIntermediate(), assOrderingHorizontal\setExportDetailsXLSX(), assErrorText\setExportDetailsXLSX(), assNumeric\setExportDetailsXLSX(), assTextSubset\setExportDetailsXLSX(), assTextQuestion\setExportDetailsXLSX(), assLongMenu\setExportDetailsXLSX(), assImagemapQuestion\setExportDetailsXLSX(), assFileUpload\setExportDetailsXLSX(), assKprimChoice\setExportDetailsXLSX(), assMultipleChoice\setExportDetailsXLSX(), assSingleChoice\setExportDetailsXLSX(), assOrderingQuestion\setExportDetailsXLSX(), assMatchingQuestion\setExportDetailsXLSX(), assFormulaQuestion\setExportDetailsXLSX(), and assClozeTest\setExportDetailsXLSX().

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

References $step.

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

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

Here is the caller graph for this function:

getSuggestedSolution()

assQuestion::getSuggestedSolution

(

int

$subquestion_index = 0

)

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

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

getSuggestedSolutionOutput()

assQuestion::getSuggestedSolutionOutput

(

)

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

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

                                                : string
    {
        $output = [];
        foreach ($this->suggested_solutions as $solution) {
            switch ($solution->getType()) {
                case assQuestionSuggestedSolution::TYPE_LM:
                case assQuestionSuggestedSolution::TYPE_LM_CHAPTER:
                case assQuestionSuggestedSolution::TYPE_LM_PAGE:
                case assQuestionSuggestedSolution::TYPE_GLOSARY_TERM:
                    $output[] = '<a href="'
                        . assQuestion::_getInternalLinkHref($solution->getInternalLink())
                        . '">'
                        . $this->lng->txt("solution_hint")
                        . '</a>';
                    break;

                case assQuestionSuggestedSolution::TYPE_FILE:
                    $possible_texts = array_values(
                        array_filter(
                            [
                                ilLegacyFormElementsUtil::prepareFormOutput($solution->getTitle()),
                                ilLegacyFormElementsUtil::prepareFormOutput($solution->getFilename()),
                                $this->lng->txt('tst_show_solution_suggested')
                            ]
                        )
                    );

                    ilWACSignedPath::setTokenMaxLifetimeInSeconds(60);
                    $output[] = '<a href="'
                        . ilWACSignedPath::signFile(
                            $this->getSuggestedSolutionPathWeb() . $solution->getFilename()
                        )
                        . '">'
                        . $possible_texts[0]
                        . '</a>';
                    break;
            }
        }
        return implode("<br />", $output);
    }

Here is the call graph for this function:

getSuggestedSolutionPath()

assQuestion::getSuggestedSolutionPath

(

)

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

(

)

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

References $suggested_solutions.

Referenced by copySuggestedSolutions().

                                           : array
    {
        return $this->suggested_solutions;
    }

Here is the caller graph for this function:

getSuggestedSolutionsRepo()

assQuestion::getSuggestedSolutionsRepo ( )

protected

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

References $suggestedsolution_repo, and ilQuestionPoolDIC\dic().

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

                                                  : assQuestionSuggestedSolutionsDatabaseRepository
    {
        if (is_null($this->suggestedsolution_repo)) {
            $dic = ilQuestionPoolDIC::dic();
            $this->suggestedsolution_repo = $dic['question.repo.suggestedsolutions'];
        }
        return $this->suggestedsolution_repo;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getTestId()

assQuestion::getTestId

(

)

Definition at line 420 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 837 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 3062 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 435 of file class.assQuestion.php.

References $thumb_size.

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

                                  : int
    {
        return $this->thumb_size;
    }

Here is the caller graph for this function:

getTitle()

assQuestion::getTitle

(

)

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

References $title.

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

                              : string
    {
        return $this->title;
    }

Here is the caller graph for this function:

getTitleFilenameCompliant()

assQuestion::getTitleFilenameCompliant

(

)

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

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

                                           : string
    {
        return htmlspecialchars($this->title);
    }

Here is the caller graph for this function:

getTotalAnswers()

assQuestion::getTotalAnswers

(

)

Definition at line 1091 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 846 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 2510 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 2209 of file class.assQuestion.php.

                                         : bool
    {
        return static::HAS_SPECIFIC_FEEDBACK;
    }

implodeKeyValues()

static assQuestion::implodeKeyValues ( array  $keyValues )

static

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

References KEY_VALUES_IMPLOSION_SEPARATOR.

Referenced by assImagemapQuestionGUI\buildSelectionParameter().

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

Here is the caller graph for this function:

importHint()

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

private

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

References getAdditionalContentEditingMode().

Referenced by fromXML().

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

        $hint->setText($hint_array['txt'] ?? '');
        $hint->save();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

instantiateQuestion()

static assQuestion::instantiateQuestion ( int  $question_id )

static

Parameters

int

$question_id

Returns

assQuestion

Exceptions

InvalidArgumentException

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

References $DIC, $ilDB, and $question.

Referenced by ilObjTest\_instanciateQuestion(), ilTestFixedQuestionSetConfig\cloneQuestionSetRelatedData(), ilObjTestGUI\copyAndLinkQuestionsToPoolObject(), ilPCQuestion\copyPoolQuestionIntoPage(), ilObjQuestionPool\deleteQuestion(), ilTestEvaluationGUI\exportFileUploadsForAllParticipants(), ilTestEvaluationGUI\exportQuestionForAllParticipants(), ilTestResultsToXML\exportTestResults(), ilAssLacQuestionProvider\getQuestion(), ilTestPlayerAbstractGUI\getQuestionInstance(), ilTestExport\getQuestionQtiXml(), ilTestRandomQuestionSetPoolDeriver\getQuestionsForPool(), ilTestSequence\getSequenceSummary(), ilPCQuestion\handleCopiedContent(), ilQuestionPageParser\processPagesToParse(), ilAssIncompleteQuestionPurger\purgeQuestionIds(), ilTestRandomQuestionSetStagingPoolBuilder\removeStagedQuestions(), ilTestScoringByQuestionsGUI\saveManScoringByQuestion(), ilSoapTestAdministration\saveQuestion(), ilSoapTestAdministration\saveQuestionSolution(), ilTestEvaluationGUI\singleResults(), ilTestRandomQuestionSetStagingPoolBuilder\stageQuestionsFromSourcePool(), ilTestRandomQuestionSetStagingPoolBuilder\stageQuestionsFromSourcePoolCheap(), ilAssQuestionSkillAssignmentsGUI\syncOriginalCmd(), and ilExcelTestExport\withUserPages().

                                                                : assQuestion
    {
        global $DIC;
        $ilCtrl = $DIC['ilCtrl'];
        $ilDB = $DIC['ilDB'];
        $lng = $DIC['lng'];
        $questioninfo = $DIC->testQuestionPool()->questionInfo();
        $question_type = $questioninfo->getQuestionType($question_id);
        if ($question_type === '') {
            throw new InvalidArgumentException('No question with ID ' . $question_id . ' exists');
        }

        $question = new $question_type();
        $question->loadFromDb($question_id);

        $feedbackObjectClassname = self::getFeedbackClassNameByQuestionType($question_type);
        $question->feedbackOBJ = new $feedbackObjectClassname($question, $ilCtrl, $ilDB, $lng);

        return $question;
    }

Here is the caller graph for this function:

instantiateQuestionGUI()

static assQuestion::instantiateQuestionGUI ( int  $a_question_id )

static

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

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

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'];
        $questioninfo = $DIC->testQuestionPool()->questionInfo();
        if (strcmp($a_question_id, "") != 0) {
            $question_type = $questioninfo->getQuestionType($a_question_id);

            $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 2862 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 2938 of file class.assQuestion.php.

                                                                                      : bool
    {
        return false;
    }

isAdditionalContentEditingModePageObject()

assQuestion::isAdditionalContentEditingModePageObject

(

)

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

References ADDITIONAL_CONTENT_EDITING_MODE_IPE, and getAdditionalContentEditingMode().

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

isAnswered()

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

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

References getId(), and getNumExistingSolutionRecords().

Referenced by calculateResultsFromSolution().

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

Here is the call graph for this function:

Here is the caller graph for this function:

isComplete()

assQuestion::isComplete ( )

abstract

Returns true, if a question is complete for use.

Returns

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

Referenced by saveQuestionDataToDb(), saveToDb(), and toXML().

Here is the caller graph for this function:

isDummySolutionRecord()

assQuestion::isDummySolutionRecord ( array  $solutionRecord )

protected

Definition at line 2753 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 1112 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 228 of file class.assQuestion.php.

                                                           : bool
    {
        return self::$forcePassResultsUpdateEnabled;
    }

isNonEmptyItemListPostSubmission()

assQuestion::isNonEmptyItemListPostSubmission ( string  $postSubmissionFieldname )

protected

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

Referenced by assMultipleChoice\getSpecificFeedbackAllCorrectOptionLabel().

                                                                : bool
    {
        return false;
    }

Here is the caller graph for this function:

isPreviewSolutionCorrect()

assQuestion::isPreviewSolutionCorrect

(

ilAssQuestionPreviewSession

$previewSession

)

Definition at line 1877 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 2501 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 2327 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 2332 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 1238 of file class.assQuestion.php.

References $data, and loadSuggestedSolutions().

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

        $suggested_solutions = $this->loadSuggestedSolutions();
        $this->suggested_solutions = array();
        if ($suggested_solutions) {
            foreach ($suggested_solutions as $solution) {
                $this->suggested_solutions[$solution->getSubquestionIndex()] = $solution;
            }
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

loadSuggestedSolutions()

assQuestion::loadSuggestedSolutions ( )

protected

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

References getId(), and getSuggestedSolutionsRepo().

Referenced by loadFromDb().

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

Here is the call graph for this function:

Here is the caller graph for this function:

log()

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

protected

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

References $DIC, $original_id, ilObjAssessmentFolder\_addLog(), and ilObjTest\_getObjectIDFromActiveID().

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

                                                                                       : void
    {
        global $DIC;
        $original_id = $DIC->testQuestionPool()->questionInfo()->getOriginalId($question_id);

        ilObjAssessmentFolder::_addLog(
            $DIC->user()->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:

lookupForExistingSolutions()

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

Lookup if an authorized or intermediate solution exists.

Returns

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

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

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

References getId().

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

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

lookupParentObjId()

static assQuestion::lookupParentObjId ( int  $questionId )

static

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

References $DIC, $ilDB, 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:

migrateContentForLearningModule()

assQuestion::migrateContentForLearningModule

(

ilAssSelfAssessmentMigrator

$migrator

)

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

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

Referenced by ilAssSelfAssessmentQuestionFormatter\prepareQuestionForLearningModule().

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

onCopy()

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

protected

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

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

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

Here is the call graph for this function:

onDuplicate()

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

protected

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

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

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

Here is the call graph for this function:

persistPreviewState()

assQuestion::persistPreviewState ( ilAssQuestionPreviewSession  $previewSession )

final

persists the preview state for current user and question

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

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

                                                                                                                               : bool
    {
        if (!$this instanceof ilAssQuestionPartiallySaveable && !$this->validateSolutionSubmit()) {
            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:

purifyAndPrepareTextAreaOutput()

assQuestion::purifyAndPrepareTextAreaOutput ( string  $content )

protected

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

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

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

removeAllExistingSolutions()

assQuestion::removeAllExistingSolutions

(

)

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

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

References getId(), and getStep().

Referenced by assKprimChoice\isComplete(), assMultipleChoice\isForcedEmptySolution(), removeIntermediateSolution(), assOrderingHorizontal\saveWorkingData(), assErrorText\saveWorkingData(), assTextQuestion\saveWorkingData(), assTextSubset\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 2953 of file class.assQuestion.php.

References getId(), and getStep().

Referenced by resetUsersAnswer().

                                                                     : int
    {
        $query = "
                        DELETE FROM tst_solutions
                        WHERE active_fi = %s
                        AND question_fi = %s
                        AND pass = %s
                ";

        if ($this->getStep() !== null) {
            $query .= " AND step = " . $this->db->quote((int) $this->getStep(), 'integer') . " ";
        }

        return $this->db->manipulateF(
            $query,
            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 2620 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 2993 of file class.assQuestion.php.

References getId(), and getStep().

Referenced by resetUsersAnswer().

                                                                : int
    {
        $query = "
                        DELETE FROM tst_test_result
                        WHERE active_fi = %s
                        AND question_fi = %s
                        AND pass = %s
                ";

        if ($this->getStep() !== null) {
            $query .= " AND step = " . $this->db->quote((int) $this->getStep(), 'integer') . " ";
        }

        return $this->db->manipulateF(
            $query,
            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 2592 of file class.assQuestion.php.

Referenced by deleteDummySolutionRecord(), assNumeric\isValidSolutionSubmit(), and assSingleChoice\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:

resetOriginalId()

static assQuestion::resetOriginalId ( int  $questionId )

static

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

References $DIC, and $ilDB.

Referenced by ilTestRandomQuestionSetPoolDeriver\updateTestQuestionStage().

                                                           : void
    {
        global $DIC;
        $ilDB = $DIC->database();

        $query = "UPDATE qpl_questions SET tstamp = %s, original_id = NULL WHERE question_id = %s";

        $ilDB->manipulateF(
            $query,
            ['integer', 'text'],
            [time(), $questionId]
        );
    }

Here is the caller graph for this function:

resetUsersAnswer()

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

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

        $test = new ilObjTest(
            $this->test_id,
            false
        );
        $test->updateTestPassResults(
            $activeId,
            $pass,
            $this->areObligationsToBeConsidered(),
            $this->getProcessLocker(),
            $this->getTestId()
        );
    }

Here is the call graph for this function:

resolveInternalLink()

assQuestion::resolveInternalLink

(

string

$internal_link

)

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

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

Referenced by resolveSuggestedSolutionLinks().

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

Here is the call graph for this function:

Here is the caller graph for this function:

resolveSuggestedSolutionLinks()

assQuestion::resolveSuggestedSolutionLinks

(

)

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

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

                                                   : void
    {
        $resolvedlinks = 0;
        $result = $this->db->queryF(
            "SELECT * FROM qpl_sol_sug WHERE question_fi = %s",
            array('integer'),
            array($this->getId())
        );
        if ($this->db->numRows($result) > 0) {
            while ($row = $this->db->fetchAssoc($result)) {
                $internal_link = $row["internal_link"];
                $resolved_link = $this->resolveInternalLink($internal_link);
                if ($internal_link !== $resolved_link) {
                    // internal link was resolved successfully
                    $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) {
            // there are resolved links -> reenter theses links to the database
            // delete all internal links from the database
            ilInternalLink::_deleteAllLinksOfSource("qst", $this->getId());

            $result = $this->db->queryF(
                "SELECT * FROM qpl_sol_sug WHERE question_fi = %s",
                array('integer'),
                array($this->getId())
            );
            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", $this->getId(), $matches[2], $matches[3], $matches[1]);
                    }
                }
            }
        }
    }

Here is the call graph for this function:

saveCurrentSolution()

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

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

References getId(), and getStep().

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

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

References $DIC, and $ilDB.

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

                                                                           : void
    {
        global $DIC;
        $ilDB = $DIC->database();
        $query = "UPDATE qpl_questions SET tstamp = %s, original_id = %s WHERE question_id = %s";

        $ilDB->manipulateF(
            $query,
            ['integer','integer', 'text'],
            [time(), $originalId, $questionId]
        );
    }

Here is the caller graph for this function:

savePreviewData()

assQuestion::savePreviewData ( ilAssQuestionPreviewSession  $previewSession )

protected

Definition at line 767 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 1309 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(), assErrorText\saveToDb(), assFileUpload\saveToDb(), assTextSubset\saveToDb(), assTextQuestion\saveToDb(), assImagemapQuestion\saveToDb(), assOrderingQuestion\saveToDb(), assMultipleChoice\saveToDb(), assMatchingQuestion\saveToDb(), assLongMenu\saveToDb(), assClozeTest\saveToDb(), assKprimChoice\saveToDb(), and assFormulaQuestion\saveToDb().

                                                               : void
    {
        if ($this->getId() == -1) {
            $next_id = $this->db->nextId('qpl_questions');
            $this->db->insert("qpl_questions", array(
                "question_id" => array("integer", $next_id),
                "question_type_fi" => array("integer", $this->getQuestionTypeID()),
                "obj_fi" => array("integer", $this->getObjId()),
                "title" => ["text", mb_substr($this->getTitle(), 0, 124)],
                "description" => ["text", mb_substr($this->getComment(), 0, 1000)],
                "author" => ["text", mb_substr($this->getAuthor(), 0, 512)],
                "owner" => 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" => ["text", mb_substr($this->getTitle(), 0, 124)],
                "description" => ["text", mb_substr($this->getComment(), 0, 1000)],
                "author" => ["text", mb_substr($this->getAuthor(), 0, 512)],
                "question_text" => 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 1352 of file class.assQuestion.php.

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

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

                              : void
    {
        // remove unused media objects from ILIAS
        $this->cleanupMediaObjectUsage();

        $complete = "0";
        if ($this->isComplete()) {
            $complete = "1";
        }

        $this->db->update(
            'qpl_questions',
            [
                'tstamp' => ['integer', time()],
                'owner' => ['integer', $this->getOwner()],
                'complete' => ['integer', $complete],
                'lifecycle' => ['text', $this->getLifecycle()->getIdentifier()],
            ],
            [
                'question_id' => array('integer', $this->getId())
            ]
        );

        ilObjQuestionPool::_updateQuestionCount($this->getObjId());
    }

Here is the call graph for this function:

Here is the caller graph for this function:

saveWorkingData()

assQuestion::saveWorkingData ( int  $active_id, int  $pass, 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 2487 of file class.assQuestion.php.

References $additionalContentEditingMode, and getValidAdditionalContentEditingModes().

Referenced by assOrderingHorizontal\loadFromDb(), assTextSubset\loadFromDb(), assFileUpload\loadFromDb(), assTextQuestion\loadFromDb(), assOrderingQuestion\loadFromDb(), assErrorText\loadFromDb(), assSingleChoice\loadFromDb(), assMultipleChoice\loadFromDb(), assClozeTest\loadFromDb(), assKprimChoice\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 382 of file class.assQuestion.php.

References $author.

Referenced by __construct(), assOrderingHorizontal\loadFromDb(), assTextSubset\loadFromDb(), assFileUpload\loadFromDb(), assTextQuestion\loadFromDb(), assOrderingQuestion\loadFromDb(), assErrorText\loadFromDb(), assSingleChoice\loadFromDb(), assMultipleChoice\loadFromDb(), assClozeTest\loadFromDb(), assKprimChoice\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 372 of file class.assQuestion.php.

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

Referenced by assOrderingHorizontal\loadFromDb(), assTextSubset\loadFromDb(), assFileUpload\loadFromDb(), assTextQuestion\loadFromDb(), assOrderingQuestion\loadFromDb(), assErrorText\loadFromDb(), assSingleChoice\loadFromDb(), assMultipleChoice\loadFromDb(), assClozeTest\loadFromDb(), assKprimChoice\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 2347 of file class.assQuestion.php.

References $defaultnroftries.

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

setExportDetailsXLSX()

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

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

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

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

        return $startrow;
    }

Here is the call graph for this function:

setExportImagePath()

assQuestion::setExportImagePath

(

string

$path

)

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

References $path.

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

setExternalId()

assQuestion::setExternalId

(

?string

$external_id

)

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

References $forcePassResultsUpdateEnabled.

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

setId()

assQuestion::setId

(

int

$id = -1

)

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

References $id.

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

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

Here is the caller graph for this function:

setLastChange()

assQuestion::setLastChange

(

$lastChange

)

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

References $lifecycle.

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

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

Here is the caller graph for this function:

setNrOfTries()

assQuestion::setNrOfTries

(

int

$a_nr_of_tries

)

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

Referenced by assOrderingHorizontal\loadFromDb(), assTextSubset\loadFromDb(), assFileUpload\loadFromDb(), assTextQuestion\loadFromDb(), assOrderingQuestion\loadFromDb(), assSingleChoice\loadFromDb(), assErrorText\loadFromDb(), assMultipleChoice\loadFromDb(), assClozeTest\loadFromDb(), assKprimChoice\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 479 of file class.assQuestion.php.

References $obj_id.

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

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

Here is the caller graph for this function:

setObligationsToBeConsidered()

assQuestion::setObligationsToBeConsidered

(

bool

$obligationsToBeConsidered

)

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

References $obligationsToBeConsidered.

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

setOriginalId()

assQuestion::setOriginalId

(

?int

$original_id

)

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

References $original_id.

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

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

Here is the caller graph for this function:

setOwner()

assQuestion::setOwner

(

int

$owner = -1

)

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

References $owner.

Referenced by __construct(), assOrderingHorizontal\loadFromDb(), assTextSubset\loadFromDb(), assFileUpload\loadFromDb(), assTextQuestion\loadFromDb(), assOrderingQuestion\loadFromDb(), assErrorText\loadFromDb(), assSingleChoice\loadFromDb(), assMultipleChoice\loadFromDb(), assClozeTest\loadFromDb(), assKprimChoice\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 1783 of file class.assQuestion.php.

References $points.

Referenced by assOrderingHorizontal\loadFromDb(), assTextSubset\loadFromDb(), assFileUpload\loadFromDb(), assTextQuestion\loadFromDb(), assOrderingQuestion\loadFromDb(), assErrorText\loadFromDb(), assSingleChoice\loadFromDb(), assMultipleChoice\loadFromDb(), assClozeTest\loadFromDb(), assKprimChoice\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 2308 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 281 of file class.assQuestion.php.

References $processLocker.

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

setQuestion()

assQuestion::setQuestion

(

string

$question = ""

)

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

References $question, and getQuestionType().

Referenced by assClozeTest\__construct(), __construct(), lmMigrateQuestionTypeGenericContent(), assOrderingHorizontal\loadFromDb(), assTextSubset\loadFromDb(), assFileUpload\loadFromDb(), assTextQuestion\loadFromDb(), assOrderingQuestion\loadFromDb(), assSingleChoice\loadFromDb(), assErrorText\loadFromDb(), assMultipleChoice\loadFromDb(), assClozeTest\loadFromDb(), assKprimChoice\loadFromDb(), assMatchingQuestion\loadFromDb(), assLongMenu\loadFromDb(), assImagemapQuestion\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 2337 of file class.assQuestion.php.

References $selfassessmenteditingmode.

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

setShuffle()

assQuestion::setShuffle

(

?bool

$shuffle = true

)

Definition at line 377 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 276 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 2829 of file class.assQuestion.php.

References $step.

Referenced by assFileUpload\getUploadedFilesForWeb().

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

Here is the caller graph for this function:

setTestId()

assQuestion::setTestId

(

int

$id = -1

)

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

References $id.

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

setThumbSize()

assQuestion::setThumbSize

(

int

$a_size

)

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

References $title.

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

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

Here is the caller graph for this function:

syncHints()

assQuestion::syncHints

(

)

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

References duplicateSkillAssignments().

                                                                                                                    : void
    {
        $assignmentList = new ilAssQuestionSkillAssignmentList($this->db);
        $assignmentList->setParentObjId($trgParentId);
        $assignmentList->setQuestionIdFilter($trgQuestionId);
        $assignmentList->loadFromDb();

        foreach ($assignmentList->getAssignmentsByQuestionId($trgQuestionId) as $assignment) {
            $assignment->deleteFromDb();

            // remove skill usage
            if (!$assignment->isSkillUsed()) {
                $this->skillUsageService->removeUsage(
                    $assignment->getParentObjId(),
                    $assignment->getSkillBaseId(),
                    $assignment->getSkillTrefId()
                );
            }
        }

        $this->duplicateSkillAssignments($srcParentId, $srcQuestionId, $trgParentId, $trgQuestionId);
    }

Here is the call graph for this function:

syncSuggestedSolutionFiles()

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

protected

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

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

Referenced by syncSuggestedSolutions().

     : 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 ($solution->isOfTypeFile()) {
                if (!file_exists($filepath_original)) {
                    ilFileUtils::makeDirParents($filepath_original);
                }
                $filename = $solution->getFilename();
                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:

syncSuggestedSolutions()

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

protected

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

References getId(), getSuggestedSolutionsRepo(), and syncSuggestedSolutionFiles().

Referenced by syncWithOriginal().

     : void {
        $this->getSuggestedSolutionsRepo()->syncForQuestion($this->getId(), $target_question_id);
        $this->syncSuggestedSolutionFiles($target_question_id, $target_obj_id);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

syncWithOriginal()

assQuestion::syncWithOriginal

(

)

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

References afterSyncWithOriginal(), beforeSyncWithOriginal(), getId(), getObjId(), getOriginalId(), syncHints(), syncSuggestedSolutions(), and syncXHTMLMediaObjectsOfQuestion().

                                      : void
    {
        $original_id = $this->getOriginalId();
        if ($original_id === null) {
            return; // No original -> no sync
        }

        $original_obj_id = self::lookupParentObjId($this->getOriginalId());

        if (!$original_obj_id) {
            return; // Original does not exist -> no sync
        }

        $this->beforeSyncWithOriginal($this->getOriginalId(), $this->getId(), $original_obj_id, $this->getObjId());

        $original = clone $this;
        // Now we become the original
        $original->setId($this->getOriginalId());
        $original->setOriginalId(null);
        $original->setObjId($original_obj_id);

        $original->saveToDb();

        $original->deletePageOfQuestion($this->getOriginalId());
        $original->createPageObject();
        $original->copyPageOfQuestion($this->getId());

        $this->syncSuggestedSolutions($this->getOriginalId(), $original_obj_id);
        $this->syncXHTMLMediaObjectsOfQuestion();
        $this->afterSyncWithOriginal($this->getOriginalId(), $this->getId(), $original_obj_id, $this->getObjId());
        $this->syncHints();
    }

Here is the call graph for this function:

syncXHTMLMediaObjectsOfQuestion()

assQuestion::syncXHTMLMediaObjectsOfQuestion

(

)

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

References 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 2854 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 338 of file class.assQuestion.php.

References getQuestionType(), and isComplete().

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

updateTimestamp()

assQuestion::updateTimestamp

(

)

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

validateSolutionSubmit()

assQuestion::validateSolutionSubmit

(

)

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

Referenced by getAdditionalContentEditingMode(), and setAdditionalContentEditingMode().

$author

string assQuestion::$author

protected

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

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

$comment

string assQuestion::$comment

protected

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

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

$current_user

ilObjUser assQuestion::$current_user

protected

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

Referenced by createNewQuestion().

$db

ilDBInterface assQuestion::$db

protected

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

Referenced by assClozeTest\calculateReachedPoints(), and assFormulaQuestion\saveToDb().

$defaultnroftries

int assQuestion::$defaultnroftries = 0

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

Referenced by getDefaultNrOfTries(), and setDefaultNrOfTries().

$dic

Container assQuestion::$dic

protected

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

$export_image_path

string assQuestion::$export_image_path

private

(Web) Path to images

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

Referenced by getImagePathWeb().

$external_id

string assQuestion::$external_id = null

protected

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

Referenced by getExternalId(), and setExternalId().

$feedbackOBJ

ilAssQuestionFeedback assQuestion::$feedbackOBJ

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

$forcePassResultsUpdateEnabled

assQuestion::$forcePassResultsUpdateEnabled = false

staticprotected

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

Referenced by setForcePassResultUpdateEnabled().

$http

ILIAS HTTP Services assQuestion::$http

protected

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

$id

int assQuestion::$id

protected

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

Referenced by assFormulaQuestion\addResultUnits(), assOrderingHorizontal\createNewOriginalFromThisDuplicate(), assNumeric\createNewOriginalFromThisDuplicate(), assFileUpload\createNewOriginalFromThisDuplicate(), assTextSubset\createNewOriginalFromThisDuplicate(), assImagemapQuestion\createNewOriginalFromThisDuplicate(), assTextQuestion\createNewOriginalFromThisDuplicate(), assOrderingQuestion\createNewOriginalFromThisDuplicate(), assMultipleChoice\createNewOriginalFromThisDuplicate(), assSingleChoice\createNewOriginalFromThisDuplicate(), assErrorText\createNewOriginalFromThisDuplicate(), assMatchingQuestion\createNewOriginalFromThisDuplicate(), assLongMenu\createNewOriginalFromThisDuplicate(), assKprimChoice\createNewOriginalFromThisDuplicate(), assFormulaQuestion\createNewOriginalFromThisDuplicate(), assClozeTest\createNewOriginalFromThisDuplicate(), getId(), getImagePath(), assImagemapQuestion\setExportDetailsXLSX(), assKprimChoice\setExportDetailsXLSX(), assMultipleChoice\setExportDetailsXLSX(), assSingleChoice\setExportDetailsXLSX(), setId(), assFormulaQuestion\setId(), and setTestId().

$ilias

assQuestion::$ilias

protected

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

$ilLog

ILIAS DI LoggingServices assQuestion::$ilLog

protected

Definition at line 61 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(), assMultipleChoice\syncImages(), and assSingleChoice\syncImages().

$imageSourceFixReplaceMap

assQuestion::$imageSourceFixReplaceMap

staticprotected

Initial value:

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

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

$lastChange

assQuestion::$lastChange

protected

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

Referenced by getLastChange(), and setLastChange().

$lifecycle

ilAssQuestionLifecycle assQuestion::$lifecycle

protected

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

Referenced by getLifecycle(), and setLifecycle().

$lng

ilLanguage assQuestion::$lng

protected

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

Referenced by __construct().

$nr_of_tries

int assQuestion::$nr_of_tries

private

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

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

$obligationsToBeConsidered

bool assQuestion::$obligationsToBeConsidered = false

private

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

Referenced by areObligationsToBeConsidered(), and setObligationsToBeConsidered().

$original_id

int assQuestion::$original_id = null

protected

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

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

$owner

string assQuestion::$owner

protected

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

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

$page

assQuestion::$page

protected

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

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

$prevent_rte_usage

bool assQuestion::$prevent_rte_usage = false

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

Referenced by getPreventRteUsage(), and setPreventRteUsage().

$processLocker

ilAssQuestionProcessLocker assQuestion::$processLocker

protected

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

Referenced by getProcessLocker(), and setProcessLocker().

$question

string assQuestion::$question

protected

The question text.

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

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

$questionActionCmd

string assQuestion::$questionActionCmd = 'handleQuestionAction'

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

$questionFilesService

ILIAS TestQuestionPool QuestionFilesService assQuestion::$questionFilesService

protected

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

$questioninfo

ILIAS TestQuestionPool QuestionInfoService assQuestion::$questioninfo

protected

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

$refinery

ILIAS Refinery Factory assQuestion::$refinery

protected

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

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

$selfassessmenteditingmode

bool assQuestion::$selfassessmenteditingmode = false

Definition at line 144 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 83 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 159 of file class.assQuestion.php.

Referenced by getShuffler(), and setShuffler().

$skillUsageService

SkillUsageService assQuestion::$skillUsageService

protected

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

$step

assQuestion::$step

protected

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

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

$suggested_solutions

array assQuestion::$suggested_solutions

protected

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

Referenced by getSuggestedSolutions().

$suggestedsolution_repo

assQuestionSuggestedSolutionsDatabaseRepository assQuestion::$suggestedsolution_repo = null

protected

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

Referenced by getSuggestedSolutionsRepo().

$test_id

int assQuestion::$test_id

protected

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

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

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

$testParticipantInfo

ILIAS Test TestParticipantInfoService assQuestion::$testParticipantInfo

protected

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

$testQuestionConfig

ilTestQuestionConfig assQuestion::$testQuestionConfig

protected

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

$testQuestionConfigInstance

ilTestQuestionConfig assQuestion::$testQuestionConfigInstance = null

private

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

Referenced by getTestPresentationConfig().

$thumb_size

int assQuestion::$thumb_size

protected

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

Referenced by getThumbSize().

$title

string assQuestion::$title

protected

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

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

$tpl

ilGlobalPageTemplate assQuestion::$tpl

protected

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

Referenced by __construct().

ADDITIONAL_CONTENT_EDITING_MODE_IPE

const assQuestion::ADDITIONAL_CONTENT_EDITING_MODE_IPE = 'pageobject'

Definition at line 136 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 135 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 50 of file class.assQuestion.php.

HAS_SPECIFIC_FEEDBACK

const assQuestion::HAS_SPECIFIC_FEEDBACK = true

protected

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

KEY_VALUES_IMPLOSION_SEPARATOR

const assQuestion::KEY_VALUES_IMPLOSION_SEPARATOR = ':'

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

Referenced by explodeKeyValues(), and implodeKeyValues().

MAXIMUM_THUMB_SIZE

const assQuestion::MAXIMUM_THUMB_SIZE = 8192

private

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

MINIMUM_THUMB_SIZE

const assQuestion::MINIMUM_THUMB_SIZE = 20

private

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

TRIM_PATTERN

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

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

---

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

• Modules/TestQuestionPool/classes/class.assQuestion.php