ILIAS  release_8 Revision v8.24
Public Member Functions | Static Public Member Functions | Data Fields | Protected Member Functions | Static Protected Member Functions | Protected Attributes | Static Protected Attributes | Private Member Functions | Private Attributes
assQuestion Class Reference
Modules/TestQuestionPool

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

+ Inheritance diagram for assQuestion:
+ Collaboration diagram for assQuestion:

Public Member Functions

 __construct (string $title="", string $comment="", string $author="", int $owner=-1, string $question="")
 assQuestion constructor More...
 
 getShuffler ()
 
 setShuffler (Transformation $shuffler)
 
 setProcessLocker (ilAssQuestionProcessLocker $processLocker)
 
 getProcessLocker ()
 
 fromXML ($item, int $questionpool_id, ?int $tst_id, &$tst_object, int &$question_counter, array $import_mapping, array &$solutionhints=[])
 Receives parameters from a QTI parser and creates a valid ILIAS question object. More...
 
 toXML (bool $a_include_header=true, bool $a_include_binary=true, bool $a_shuffle=false, bool $test_output=false, bool $force_image_references=false)
 Returns a QTI xml representation of the question. More...
 
 isComplete ()
 Returns true, if a question is complete for use. More...
 
 questionTitleExists (int $questionpool_id, string $title)
 Returns TRUE if the question title exists in a question pool in the database. More...
 
 setTitle (string $title="")
 
 setId (int $id=-1)
 
 setTestId (int $id=-1)
 
 setComment (string $comment="")
 
 setOutputType (int $outputType=OUTPUT_HTML)
 
 setShuffle (?bool $shuffle=true)
 
 setAuthor (string $author="")
 
 setOwner (int $owner=-1)
 
 getTitle ()
 
 getTitleForHTMLOutput ()
 
 getTitleFilenameCompliant ()
 
 getId ()
 
 getShuffle ()
 
 getTestId ()
 
 getComment ()
 
 getDescriptionForHTMLOutput ()
 
 getThumbSize ()
 
 setThumbSize (int $a_size)
 
 getMinimumThumbSize ()
 
 getMaximumThumbSize ()
 
 getOutputType ()
 
 supportsJavascriptOutput ()
 
 supportsNonJsOutput ()
 
 requiresJsSwitch ()
 
 getAuthor ()
 
 getAuthorForHTMLOutput ()
 
 getOwner ()
 
 getObjId ()
 
 setObjId (int $obj_id=0)
 
 getLifecycle ()
 
 setLifecycle (ilAssQuestionLifecycle $lifecycle)
 
 setExternalId (?string $external_id)
 
 getExternalId ()
 
 getSuggestedSolutionOutput ()
 
 _getSuggestedSolution (int $question_id, int $subquestion_index=0)
 
 loadSuggestedSolution (int $question_id, int $subquestion_index=0)
 Returns a suggested solution for a given subquestion index. More...
 
 getSuggestedSolutions ()
 
 getReachedPoints (int $active_id, int $pass)
 
 getMaximumPoints ()
 
 getAdjustedReachedPoints (int $active_id, int $pass, bool $authorizedSolution=true)
 returns the reached points ... More...
 
 calculateResultsFromSolution (int $active_id, int $pass, bool $obligationsEnabled=false)
 Calculates the question results from a previously saved question solution. More...
 
 persistWorkingState (int $active_id, $pass, bool $obligationsEnabled=false, bool $authorized=true)
 persists the working state for current testactive and testpass More...
 
 persistPreviewState (ilAssQuestionPreviewSession $previewSession)
 persists the preview state for current user and question More...
 
 validateSolutionSubmit ()
 
 saveWorkingData (int $active_id, int $pass, bool $authorized=true)
 Saves the learners input of the question to the database. More...
 
 moveUploadedMediaFile (string $file, string $name)
 Move an uploaded media file to an public accessible temp dir to present it. More...
 
 getSuggestedSolutionPath ()
 
 getImagePath ($question_id=null, $object_id=null)
 Returns the image path for web accessable images of a question. More...
 
 buildImagePath ($questionId, $parentObjectId)
 
 getFlashPath ()
 Returns the image path for web accessable flash files of a question. More...
 
 getSuggestedSolutionPathWeb ()
 
 getImagePathWeb ()
 Returns the web image path for web accessable images of a question. More...
 
 getTestOutputSolutions (int $activeId, int $pass)
 
 getUserSolutionPreferingIntermediate (int $active_id, $pass=null)
 
 getSolutionValues ($active_id, $pass=null, bool $authorized=true)
 Loads solutions of a given user from the database an returns it. More...
 
 isInUse (int $question_id=0)
 Checks whether the question is in use or not in pools or tests. More...
 
 usageNumber (int $question_id=0)
 Returns the number of place the question is in use in pools or tests. More...
 
 isClone (int $question_id=0)
 Checks whether the question is a clone of another question or not. More...
 
 getAdditionalTableName ()
 
 getAnswerTableName ()
 
 deleteAnswers (int $question_id)
 
 deleteAdditionalTableData (int $question_id)
 
 delete (int $question_id)
 
 getTotalAnswers ()
 
 copyXHTMLMediaObjectsOfQuestion (int $a_q_id)
 
 syncXHTMLMediaObjectsOfQuestion ()
 
 createPageObject ()
 
 copyPageOfQuestion (int $a_q_id)
 
 getPageOfQuestion ()
 
 setOriginalId (?int $original_id)
 
 getOriginalId ()
 
 fixSvgToPng (string $imageFilenameContainingString)
 
 fixUnavailableSkinImageSources (string $html)
 
 loadFromDb (int $question_id)
 
 createNewQuestion (bool $a_create_page=true)
 Creates a new question without an owner when a new question is created This assures that an ID is given to the question if a file upload or something else occurs. More...
 
 saveQuestionDataToDb (int $original_id=-1)
 
 saveToDb ()
 
 setNewOriginalId (int $newId)
 
 deleteSuggestedSolutions ()
 
 getSuggestedSolution (int $subquestion_index=0)
 Returns a suggested solution for a given subquestion index. More...
 
 getSuggestedSolutionTitle (int $subquestion_index=0)
 Returns the title of a suggested solution at a given subquestion_index. More...
 
 setSuggestedSolution (string $solution_id="", int $subquestion_index=0, bool $is_import=false)
 Sets a suggested solution for the question. More...
 
 updateSuggestedSolutions (int $original_id=-1, int $original_obj_id=-1)
 
 _resolveInternalLink (string $internal_link)
 
 _resolveIntLinks (int $question_id)
 
 syncWithOriginal ()
 
 _questionExists ($question_id)
 Returns true if the question already exists in the database. More...
 
 _questionExistsInPool (int $question_id)
 
 getPoints ()
 
 setPoints (float $points)
 
 getSolutionMaxPass (int $active_id)
 
 calculateReachedPoints ($active_id, $pass=null, $authorizedSolution=true, $returndetails=false)
 Returns the points, a learner has reached answering the question. More...
 
 deductHintPointsFromReachedPoints (ilAssQuestionPreviewSession $previewSession, $reachedPoints)
 
 calculateReachedPointsFromPreviewSession (ilAssQuestionPreviewSession $previewSession)
 
 isPreviewSolutionCorrect (ilAssQuestionPreviewSession $previewSession)
 
 adjustReachedPointsByScoringOptions ($points, $active_id, $pass=null)
 Adjust the given reached points by checks for all special scoring options in the test container. More...
 
 isHTML ($a_text)
 Checks if a given string contains HTML or not. More...
 
 prepareTextareaOutput (string $txt_output, bool $prepare_for_latex_output=false, bool $omitNl2BrWhenTextArea=false)
 
 QTIMaterialToString (ilQTIMaterial $a_material)
 Reads an QTI material tag and creates a text or XHTML string. More...
 
 addQTIMaterial (ilXmlWriter $a_xml_writer, string $a_material, bool $close_material_tag=true, bool $add_mobs=true)
 
 buildHashedImageFilename (string $plain_image_filename, bool $unique=false)
 
 getQuestion ()
 
 getQuestionForHTMLOutput ()
 
 setQuestion (string $question="")
 
 getQuestionType ()
 Returns the question type of the question. More...
 
 getQuestionTypeID ()
 
 syncHints ()
 
 cleanupMediaObjectUsage ()
 
 getInstances ()
 
 getActiveUserData (int $active_id)
 Returns the user id and the test id for a given active id. More...
 
 hasSpecificFeedback ()
 
 setExportDetailsXLS (ilAssExcelFormatHelper $worksheet, int $startrow, int $active_id, int $pass)
 
 __get ($value)
 Object getter. More...
 
 __set ($key, $value)
 Object setter. More...
 
 __isset ($key)
 Object issetter. More...
 
 getNrOfTries ()
 
 setNrOfTries (int $a_nr_of_tries)
 
 setExportImagePath (string $path)
 
 formatSAQuestion ($a_q)
 
 setPreventRteUsage (bool $prevent_rte_usage)
 
 getPreventRteUsage ()
 
 migrateContentForLearningModule (ilAssSelfAssessmentMigrator $migrator)
 
 setSelfAssessmentEditingMode (bool $selfassessmenteditingmode)
 
 getSelfAssessmentEditingMode ()
 
 setDefaultNrOfTries (int $defaultnroftries)
 
 getDefaultNrOfTries ()
 
 syncSkillAssignments (int $srcParentId, int $srcQuestionId, int $trgParentId, int $trgQuestionId)
 
 ensureHintPageObjectExists ($pageObjectId)
 
 isAnswered (int $active_id, int $pass)
 
 isAutosaveable ()
 
 getAdditionalContentEditingMode ()
 
 setAdditionalContentEditingMode (?string $additionalContentEditingMode)
 
 isAdditionalContentEditingModePageObject ()
 
 isValidAdditionalContentEditingMode (string $additionalContentEditingMode)
 
 getValidAdditionalContentEditingModes ()
 
 getHtmlUserSolutionPurifier ()
 
 getHtmlQuestionContentPurifier ()
 
 setLastChange ($lastChange)
 
 getLastChange ()
 
 removeIntermediateSolution (int $active_id, int $pass)
 
 removeCurrentSolution (int $active_id, int $pass, bool $authorized=true)
 
 saveCurrentSolution (int $active_id, int $pass, $value1, $value2, bool $authorized=true, $tstamp=0)
 
 updateCurrentSolution (int $solutionId, $value1, $value2, bool $authorized=true)
 
 updateCurrentSolutionsAuthorization (int $activeId, int $pass, bool $authorized, bool $keepTime=false)
 
 setStep ($step)
 
 getStep ()
 
 toJSON ()
 
 duplicate (bool $for_test=true, string $title="", string $author="", string $owner="", $testObjId=null)
 
 intermediateSolutionExists (int $active_id, int $pass)
 
 authorizedSolutionExists (int $active_id, ?int $pass)
 
 authorizedOrIntermediateSolutionExists (int $active_id, int $pass)
 
 lookupForExistingSolutions (int $activeId, int $pass)
 Lookup if an authorized or intermediate solution exists. More...
 
 isAddableAnswerOptionValue (int $qIndex, string $answerOptionValue)
 
 addAnswerOptionValue (int $qIndex, string $answerOptionValue, float $points)
 
 removeAllExistingSolutions ()
 
 removeExistingSolutions (int $activeId, int $pass)
 
 resetUsersAnswer (int $activeId, int $pass)
 
 removeResultRecord (int $activeId, int $pass)
 
 fetchValuePairsFromIndexedValues (array $indexedValues)
 
 fetchIndexedValuesFromValuePairs (array $valuePairs)
 
 areObligationsToBeConsidered ()
 
 setObligationsToBeConsidered (bool $obligationsToBeConsidered)
 
 updateTimestamp ()
 
 getTestPresentationConfig ()
 
 savePartial ()
 
 isInActiveTest ()
 

Static Public Member Functions

static setForcePassResultUpdateEnabled (bool $forcePassResultsUpdateEnabled)
 
static isForcePassResultUpdateEnabled ()
 
static isAllowedImageMimeType ($mimeType)
 
static fetchMimeTypeIdentifier (string $contentType)
 
static getAllowedFileExtensionsForMimeType (string $mimeType)
 
static isAllowedImageFileExtension (string $mimeType, string $fileExtension)
 
static getAllowedImageMaterialFileExtensions ()
 
static _getMaximumPoints (int $question_id)
 Returns the maximum points, a learner can reach answering the question. More...
 
static _getQuestionInfo (int $question_id)
 
static _getSuggestedSolutionCount (int $question_id)
 
static _getSuggestedSolutionOutput (int $question_id)
 
static _getReachedPoints (int $active_id, int $question_id, int $pass)
 
static _updateTestResultCache (int $active_id, ilAssQuestionProcessLocker $processLocker=null)
 @TODO Move this to a proper place. More...
 
static logAction (string $logtext, int $active_id, int $question_id)
 
static getQuestionTypeFromDb (int $question_id)
 
static _getTotalRightAnswers (int $a_q_id)
 
static _getTitle (int $a_q_id)
 
static _getQuestionText (int $a_q_id)
 
static isFileAvailable (string $file)
 
static _getQuestionType (int $question_id)
 
static _getQuestionTitle (int $question_id)
 
static saveOriginalId (int $questionId, int $originalId)
 
static resetOriginalId (int $questionId)
 
static _getInternalLinkHref (string $target="")
 
static _getOriginalId (int $question_id)
 
static originalQuestionExists (int $questionId)
 
static _instanciateQuestion (int $question_id)
 
static _instantiateQuestion (int $question_id)
 
static instantiateQuestion (int $question_id)
 
static _getSolutionMaxPass (int $question_id, int $active_id)
 Returns the maximum pass a users question solution. More...
 
static _isWriteable (int $question_id, int $user_id)
 
static _isUsedInRandomTest (int $question_id)
 
static _isWorkedThrough (int $active_id, int $question_id, int $pass)
 Returns true if the question was worked through in the given pass Worked through means that the user entered at least one value. More...
 
static _areAnswered (int $a_user_id, array $a_question_ids)
 Checks if an array of question ids is answered by a user or not. More...
 
static _setReachedPoints (int $active_id, int $question_id, float $points, float $maxpoints, int $pass, bool $manualscoring, bool $obligationsEnabled)
 Sets the points, a learner has reached answering the question Additionally objective results are updated. More...
 
static _needsManualScoring (int $question_id)
 
static _includeClass (string $question_type, int $gui=0)
 
static getFeedbackClassNameByQuestionType (string $questionType)
 
static isCoreQuestionType (string $questionType)
 
static includeCoreClass ($questionType, $withGuiClass)
 
static _getQuestionTypeName ($type_tag)
 
static _instanciateQuestionGUI (int $question_id)
 
static instantiateQuestionGUI (int $a_question_id)
 
static _questionExistsInTest (int $question_id, int $test_id)
 
static lookupParentObjId (int $questionId)
 
static lookupOriginalParentObjId (int $originalQuestionId)
 returns the parent object id for given original question id (should be a qpl id, but theoretically it can be a tst id, too) More...
 
static isObligationPossible (int $questionId)
 
static implodeKeyValues (array $keyValues)
 
static explodeKeyValues (string $keyValues)
 
static convertISO8601FormatH_i_s_ExtendedToSeconds (string $time)
 
static missingResultRecordExists (int $activeId, int $pass, array $questionIds)
 
static getQuestionsMissingResultRecord (int $activeId, int $pass, array $questionIds)
 
static lookupResultRecordExist (int $activeId, int $questionId, int $pass)
 
static extendedTrim (string $value)
 Trim non-printable characters from the beginning and end of a string. More...
 

Data Fields

const IMG_MIME_TYPE_JPG = 'image/jpeg'
 
const IMG_MIME_TYPE_PNG = 'image/png'
 
const IMG_MIME_TYPE_GIF = 'image/gif'
 
const TRIM_PATTERN = '/^[\p{C}\p{Z}]+|[\p{C}\p{Z}]+$/u'
 
const ADDITIONAL_CONTENT_EDITING_MODE_RTE = 'default'
 
const ADDITIONAL_CONTENT_EDITING_MODE_IPE = 'pageobject'
 
ilAssQuestionFeedback $feedbackOBJ
 
bool $prevent_rte_usage = false
 
bool $selfassessmenteditingmode = false
 
int $defaultnroftries = 0
 
string $questionActionCmd = 'handleQuestionAction'
 
const KEY_VALUES_IMPLOSION_SEPARATOR = ':'
 

Protected Member Functions

 getQuestionAction ()
 
 isNonEmptyItemListPostSubmission (string $postSubmissionFieldname)
 
 ensureCurrentTestPass (int $active_id, int $pass)
 
 lookupCurrentTestPass (int $active_id, int $pass)
 
 lookupTestId (int $active_id)
 @refactor Move to ilObjTest or similar More...
 
 log (int $active_id, string $langVar)
 
 savePreviewData (ilAssQuestionPreviewSession $previewSession)
 
 deletePageOfQuestion (int $question_id)
 
 onDuplicate (int $originalParentId, int $originalQuestionId, int $duplicateParentId, int $duplicateQuestionId)
 
 beforeSyncWithOriginal (int $origQuestionId, int $dupQuestionId, int $origParentObjId, int $dupParentObjId)
 
 afterSyncWithOriginal (int $origQuestionId, int $dupQuestionId, int $origParentObjId, int $dupParentObjId)
 
 onCopy (int $sourceParentId, int $sourceQuestionId, int $targetParentId, int $targetQuestionId)
 
 duplicateSuggestedSolutionFiles (int $parent_id, int $question_id)
 Duplicates the files of a suggested solution if the question is duplicated. More...
 
 syncSuggestedSolutionFiles (int $target_question_id, int $target_obj_id)
 
 copySuggestedSolutionFiles (int $source_questionpool_id, int $source_question_id)
 
 ensureNonNegativePoints ($points)
 
 purifyAndPrepareTextAreaOutput (string $content)
 
 getRTETextWithMediaObjects ()
 
 getSelfAssessmentFormatter ()
 
 lmMigrateQuestionTypeGenericContent (ilAssSelfAssessmentMigrator $migrator)
 
 lmMigrateQuestionTypeSpecificContent (ilAssSelfAssessmentMigrator $migrator)
 
 duplicateQuestionHints (int $originalQuestionId, int $duplicateQuestionId)
 
 duplicateSkillAssignments (int $srcParentId, int $srcQuestionId, int $trgParentId, int $trgQuestionId)
 
 buildQuestionDataQuery ()
 
 getCurrentSolutionResultSet (int $active_id, int $pass, bool $authorized=true)
 
 removeSolutionRecordById (int $solutionId)
 
 getSolutionRecordById (int $solutionId)
 
 deleteDummySolutionRecord (int $activeId, int $passIndex)
 
 isDummySolutionRecord (array $solutionRecord)
 
 deleteSolutionRecordByValues (int $activeId, int $passIndex, bool $authorized, array $matchValues)
 
 duplicateIntermediateSolutionAuthorized (int $activeId, int $passIndex)
 
 forceExistingIntermediateSolution (int $activeId, int $passIndex, bool $considerDummyRecordCreation)
 
 lookupMaxStep (int $active_id, int $pass)
 
 buildTestPresentationConfig ()
 build basic test question configuration instance More...
 

Static Protected Member Functions

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

Protected Attributes

const HAS_SPECIFIC_FEEDBACK = true
 
ILIAS HTTP Services $http
 
ILIAS Refinery Factory $refinery
 
ILIAS DI LoggingServices $ilLog
 
int $id
 
string $title
 
string $comment
 
string $owner
 
string $author
 
int $thumb_size
 
string $question
 The question text. More...
 
float $points
 The maximum available points for the question. More...
 
bool $shuffle
 Indicates whether the answers will be shuffled or not. More...
 
int $test_id
 The database id of a test in which the question is contained. More...
 
int $obj_id = 0
 Object id of the container object. More...
 
 $ilias
 
ilGlobalPageTemplate $tpl
 
ilLanguage $lng
 
ilDBInterface $db
 
Container $dic
 
int $outputType = OUTPUT_JAVASCRIPT
 Contains the output type of a question. More...
 
array $suggested_solutions
 
int $original_id = null
 
 $page
 
string $external_id = null
 
ilAssQuestionProcessLocker $processLocker
 
 $step
 
 $lastChange
 
Transformation $shuffler
 
ilTestQuestionConfig $testQuestionConfig
 
ilAssQuestionLifecycle $lifecycle
 
ilObjUser $current_user
 

Static Protected Attributes

static $allowedFileExtensionsByMimeType
 
static $allowedCharsetsByMimeType
 
static $allowedImageMaterialFileExtensionsByMimeType
 
static $forcePassResultsUpdateEnabled = false
 
static $imageSourceFixReplaceMap
 

Private Member Functions

 generateExternalId (int $question_id)
 
 deleteTaxonomyAssignments ()
 

Private Attributes

const DEFAULT_THUMB_SIZE = 150
 
const MINIMUM_THUMB_SIZE = 20
 
const MAXIMUM_THUMB_SIZE = 8192
 
int $nr_of_tries
 
string $export_image_path
 (Web) Path to images More...
 
string $additionalContentEditingMode = ''
 
bool $obligationsToBeConsidered = false
 
ilTestQuestionConfig $testQuestionConfigInstance = null
 

Detailed Description

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

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

@abstract

Author
Helmut Schottmüller helmu.nosp@m.t.sc.nosp@m.hottm.nosp@m.uell.nosp@m.er@ma.nosp@m.c.co.nosp@m.m
Björn Heyser bheys.nosp@m.er@d.nosp@m.ataba.nosp@m.y.de
Version
$Id$

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

Constructor & Destructor Documentation

◆ __construct()

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

assQuestion constructor

Reimplemented in assFormulaQuestion.

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

198 {
199 global $DIC;
200 $this->dic = $DIC;
201 $lng = $DIC['lng'];
202 $tpl = $DIC['tpl'];
203 $ilDB = $DIC['ilDB'];
204 $ilLog = $DIC->logger();
205
206 $this->current_user = $DIC['ilUser'];
207 $this->lng = $lng;
208 $this->tpl = $tpl;
209 $this->db = $ilDB;
210 $this->ilLog = $ilLog;
211 $this->http = $DIC->http();
212 $this->refinery = $DIC->refinery();
213
214 $this->thumb_size = self::DEFAULT_THUMB_SIZE;
215
216 $this->title = $title;
217 $this->comment = $comment;
218 $this->setAuthor($author);
219 $this->setOwner($owner);
220
221 $this->setQuestion($question);
222
223 $this->id = -1;
224 $this->test_id = -1;
225 $this->suggested_solutions = [];
226 $this->shuffle = 1;
227 $this->nr_of_tries = 0;
228 $this->setExternalId(null);
229
230 $this->questionActionCmd = 'handleQuestionAction';
231 $this->export_image_path = '';
232 $this->shuffler = $DIC->refinery()->random()->dontShuffle();
233 $this->lifecycle = ilAssQuestionLifecycle::getDraftInstance();
234 }
assQuestion\$question
string $question
The question text.
Definition: class.assQuestion.php:82
assQuestion\$tpl
ilGlobalPageTemplate $tpl
Definition: class.assQuestion.php:111
assQuestion\setQuestion
setQuestion(string $question="")
Definition: class.assQuestion.php:3020
assQuestion\$ilLog
ILIAS DI LoggingServices $ilLog
Definition: class.assQuestion.php:70
assQuestion\setAuthor
setAuthor(string $author="")
Definition: class.assQuestion.php:500
assQuestion\setOwner
setOwner(int $owner=-1)
Definition: class.assQuestion.php:508
assQuestion\setExternalId
setExternalId(?string $external_id)
Definition: class.assQuestion.php:633
assQuestion\DEFAULT_THUMB_SIZE
const DEFAULT_THUMB_SIZE
Definition: class.assQuestion.php:61
ilLog
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
Definition: class.ilLog.php:31
$DIC
global $DIC
Definition: feed.php:28
ILIAS\FileDelivery\http
static http()
Fetches the global http state from ILIAS.
Definition: HttpServiceAware.php:54

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

+ Here is the call graph for this function:

Member Function Documentation

◆ __get()

assQuestion::__get (   $value)

Object getter.

Deprecated:
Simply do not use this. @removal ILIAS 9

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

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

◆ __isset()

assQuestion::__isset (   $key)

Object issetter.

Deprecated:
Simply do not use this. @removal ILIAS 9

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

3308 {
3309 throw new BadMethodCallException('assQuestion::__isset is discouraged, used with: ' . $key);
3310 }
ILIAS\LTI\ToolProvider\$key
string $key
Consumer key/client ID value.
Definition: System.php:193

References ILIAS\LTI\ToolProvider\$key.

◆ __set()

assQuestion::__set (   $key,
  $value 
)

Object setter.

Deprecated:
Simply do not use this. @removal ILIAS 9

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

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

References ILIAS\LTI\ToolProvider\$key.

◆ _areAnswered()

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

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

Parameters
intuser_id
array$question_idsuser id array

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

2798 : bool
2799 {
2800 global $DIC;
2801 $ilDB = $DIC['ilDB'];
2802
2803 $res = $ilDB->queryF(
2804 "SELECT DISTINCT(question_fi) FROM tst_test_result JOIN tst_active " .
2805 "ON (active_id = active_fi) " .
2806 "WHERE " . $ilDB->in('question_fi', $a_question_ids, false, 'integer') .
2807 " AND user_fi = %s",
2808 array('integer'),
2809 array($a_user_id)
2810 );
2811 return ($res->numRows() == count($a_question_ids)) ? true : false;
2812 }
true
return true
Definition: class.ilIniFile.php:164
$res
$res
Definition: ltiservices.php:69

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

Referenced by ilCourseObjectiveResult\getStatus().

+ Here is the caller graph for this function:

◆ _getInternalLinkHref()

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

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

2438 : string
2439 {
2440 global $DIC;
2441 $linktypes = array(
2442 "lm" => "LearningModule",
2443 "pg" => "PageObject",
2444 "st" => "StructureObject",
2445 "git" => "GlossaryItem",
2446 "mob" => "MediaObject"
2447 );
2448 $href = "";
2449 if (preg_match("/il__(\w+)_(\d+)/", $target, $matches)) {
2450 $type = $matches[1];
2451 $target_id = $matches[2];
2452 switch ($linktypes[$matches[1]]) {
2453 case "MediaObject":
2454 $href = "./ilias.php?baseClass=ilLMPresentationGUI&obj_type=" . $linktypes[$type]
2455 . "&cmd=media&ref_id=" . $DIC->testQuestionPool()->internal()->request()->getRefId()
2456 . "&mob_id=" . $target_id;
2457 break;
2458 case "StructureObject":
2459 case "GlossaryItem":
2460 case "PageObject":
2461 case "LearningModule":
2462 default:
2463 $href = "./goto.php?target=" . $type . "_" . $target_id;
2464 break;
2465 }
2466 }
2467 return $href;
2468 }
$target_id
$target_id
Definition: goto.php:52
$type
$type
Definition: proxy_ylocal.php:10

References $DIC, $target_id, and $type.

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

+ Here is the caller graph for this function:

◆ _getMaximumPoints()

static assQuestion::_getMaximumPoints ( int  $question_id)
static

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

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

650 : float
651 {
652 global $DIC;
653 $ilDB = $DIC['ilDB'];
654
655 $points = 0.0;
656 $result = $ilDB->queryF(
657 "SELECT points FROM qpl_questions WHERE question_id = %s",
658 array('integer'),
659 array($question_id)
660 );
661 if ($ilDB->numRows($result) == 1) {
662 $row = $ilDB->fetchAssoc($result);
663 $points = (float) $row["points"];
664 }
665 return $points;
666 }
assQuestion\$points
float $points
The maximum available points for the question.
Definition: class.assQuestion.php:87

References $DIC, and $ilDB.

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

+ Here is the caller graph for this function:

◆ _getOriginalId()

static assQuestion::_getOriginalId ( int  $question_id)
static

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

2470 : int
2471 {
2472 global $DIC;
2473 $ilDB = $DIC['ilDB'];
2474 $result = $ilDB->queryF(
2475 "SELECT * FROM qpl_questions WHERE question_id = %s",
2476 array('integer'),
2477 array($question_id)
2478 );
2479 if ($ilDB->numRows($result) > 0) {
2480 $row = $ilDB->fetchAssoc($result);
2481 if ($row["original_id"] > 0) {
2482 return $row["original_id"];
2483 }
2484
2485 return (int) $row["question_id"];
2486 }
2487
2488 return -1;
2489 }

References $DIC, and $ilDB.

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

+ Here is the caller graph for this function:

◆ _getQuestionInfo()

static assQuestion::_getQuestionInfo ( int  $question_id)
static
Returns
array Database row as associative array having qpl_questions.*, qpl_qst_type.type_tag

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

671 : array
672 {
673 global $DIC;
674 $ilDB = $DIC['ilDB'];
675
676 $result = $ilDB->queryF(
677 "SELECT qpl_questions.*, qpl_qst_type.type_tag FROM qpl_qst_type, qpl_questions WHERE qpl_questions.question_id = %s AND qpl_questions.question_type_fi = qpl_qst_type.question_type_id",
678 array('integer'),
679 array($question_id)
680 );
681
682 if ($ilDB->numRows($result)) {
683 return $ilDB->fetchAssoc($result);
684 }
685 return [];
686 }

References $DIC, and $ilDB.

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

+ Here is the caller graph for this function:

◆ _getQuestionText()

static assQuestion::_getQuestionText ( int  $a_q_id)
static

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

1722 : string
1723 {
1724 global $DIC;
1725 $ilDB = $DIC['ilDB'];
1726
1727 $result = $ilDB->queryF(
1728 "SELECT question_text FROM qpl_questions WHERE question_id = %s",
1729 array('integer'),
1730 array($a_q_id)
1731 );
1732
1733 if ($result->numRows() == 1) {
1734 $row = $ilDB->fetchAssoc($result);
1735 return $row["question_text"] ?? '';
1736 }
1737
1738 return "";
1739 }

References $DIC, and $ilDB.

Referenced by ilLMQuestionListTableGUI\fillRow().

+ Here is the caller graph for this function:

◆ _getQuestionTitle()

static assQuestion::_getQuestionTitle ( int  $question_id)
static

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

1824 : string
1825 {
1826 global $DIC;
1827 $ilDB = $DIC['ilDB'];
1828
1829 if ($question_id < 1) {
1830 return "";
1831 }
1832
1833 $result = $ilDB->queryF(
1834 "SELECT title FROM qpl_questions WHERE qpl_questions.question_id = %s",
1835 array('integer'),
1836 array($question_id)
1837 );
1838 if ($result->numRows() == 1) {
1839 $data = $ilDB->fetchAssoc($result);
1840 return $data["title"];
1841 }
1842
1843 return "";
1844 }

References $data, $DIC, and $ilDB.

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

+ Here is the caller graph for this function:

◆ _getQuestionType()

static assQuestion::_getQuestionType ( int  $question_id)
static

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

1803 : string
1804 {
1805 global $DIC;
1806 $ilDB = $DIC['ilDB'];
1807
1808 if ($question_id < 1) {
1809 return "";
1810 }
1811 $result = $ilDB->queryF(
1812 "SELECT type_tag FROM qpl_questions, qpl_qst_type WHERE qpl_questions.question_id = %s AND qpl_questions.question_type_fi = qpl_qst_type.question_type_id",
1813 array('integer'),
1814 array($question_id)
1815 );
1816 if ($result->numRows() == 1) {
1817 $data = $ilDB->fetchAssoc($result);
1818 return $data["type_tag"];
1819 }
1820
1821 return "";
1822 }

References $data, $DIC, and $ilDB.

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

+ Here is the caller graph for this function:

◆ _getQuestionTypeName()

static assQuestion::_getQuestionTypeName (   $type_tag)
static

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

3211 : string
3212 {
3213 global $DIC;
3214 if (file_exists("./Modules/TestQuestionPool/classes/class." . $type_tag . ".php")) {
3215 $lng = $DIC['lng'];
3216 return $lng->txt($type_tag);
3217 }
3218 $component_factory = $DIC['component.factory'];
3219
3220 foreach ($component_factory->getActivePluginsInSlot("qst") as $pl) {
3221 if ($pl->getQuestionType() === $type_tag) {
3222 return $pl->getQuestionTypeTranslation();
3223 }
3224 }
3225 return "";
3226 }
ilLanguage\txt
txt(string $a_topic, string $a_default_lang_fallback_mod="")
gets the text for a given topic if the topic is not in the list, the topic itself with "-" will be re...
Definition: class.ilLanguage.php:172

References $DIC, and $lng.

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

+ Here is the caller graph for this function:

◆ _getReachedPoints()

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

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

788 : float
789 {
790 global $DIC;
791 $ilDB = $DIC['ilDB'];
792
793 $points = 0.0;
794
795 $result = $ilDB->queryF(
796 "SELECT * FROM tst_test_result WHERE active_fi = %s AND question_fi = %s AND pass = %s",
797 array('integer','integer','integer'),
798 array($active_id, $question_id, $pass)
799 );
800 if ($result->numRows() == 1) {
801 $row = $ilDB->fetchAssoc($result);
802 $points = (float) $row["points"];
803 }
804 return $points;
805 }

References $DIC, and $ilDB.

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

+ Here is the caller graph for this function:

◆ _getSolutionMaxPass()

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

Returns the maximum pass a users question solution.

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

2650 : ?int
2651 {
2652 /* include_once "./Modules/Test/classes/class.ilObjTest.php";
2653 $pass = ilObjTest::_getPass($active_id);
2654 return $pass;*/
2655
2656 // the following code was the old solution which added the non answered
2657 // questions of a pass from the answered questions of the previous pass
2658 // with the above solution, only the answered questions of the last pass are counted
2659 global $DIC;
2660 $ilDB = $DIC['ilDB'];
2661
2662 $result = $ilDB->queryF(
2663 "SELECT MAX(pass) maxpass FROM tst_test_result WHERE active_fi = %s AND question_fi = %s",
2664 array('integer','integer'),
2665 array($active_id, $question_id)
2666 );
2667 if ($result->numRows() === 1) {
2668 $row = $ilDB->fetchAssoc($result);
2669 return $row["maxpass"];
2670 }
2671
2672 return null;
2673 }

References $DIC, and $ilDB.

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

+ Here is the caller graph for this function:

◆ _getSuggestedSolution()

assQuestion::_getSuggestedSolution ( int  $question_id,
int  $subquestion_index = 0 
)
Deprecated:
Use loadSuggestedSolution instead @removal ILIAS 9

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

753 : array
754 {
755 return $this->loadSuggestedSolution($question_id, $subquestion_index);
756 }
assQuestion\loadSuggestedSolution
loadSuggestedSolution(int $question_id, int $subquestion_index=0)
Returns a suggested solution for a given subquestion index.
Definition: class.assQuestion.php:763

◆ _getSuggestedSolutionCount()

static assQuestion::_getSuggestedSolutionCount ( int  $question_id)
static

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

688 : int
689 {
690 global $DIC;
691 $ilDB = $DIC['ilDB'];
692
693 $result = $ilDB->queryF(
694 "SELECT suggested_solution_id FROM qpl_sol_sug WHERE question_fi = %s",
695 array('integer'),
696 array($question_id)
697 );
698 return $ilDB->numRows($result);
699 }

References $DIC, and $ilDB.

◆ _getSuggestedSolutionOutput()

static assQuestion::_getSuggestedSolutionOutput ( int  $question_id)
static
Returns
string HTML
Exceptions
ilWACException

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

705 : string
706 {
707 $question = self::_instantiateQuestion($question_id);
708 if (!is_object($question)) {
709 return "";
710 }
711 return $question->getSuggestedSolutionOutput();
712 }
assQuestion\_instantiateQuestion
static _instantiateQuestion(int $question_id)
Definition: class.assQuestion.php:2596

Referenced by ilTestScoringByQuestionsGUI\getAnswerDetail().

+ Here is the caller graph for this function:

◆ _getTitle()

static assQuestion::_getTitle ( int  $a_q_id)
static

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

1704 : string
1705 {
1706 global $DIC;
1707 $ilDB = $DIC['ilDB'];
1708
1709 $result = $ilDB->queryF(
1710 "SELECT title FROM qpl_questions WHERE question_id = %s",
1711 array('integer'),
1712 array($a_q_id)
1713 );
1714
1715 if ($result->numRows() == 1) {
1716 $row = $ilDB->fetchAssoc($result);
1717 return $row["title"];
1718 }
1719 return "";
1720 }

References $DIC, and $ilDB.

Referenced by ilLMMailNotification\send().

+ Here is the caller graph for this function:

◆ _getTotalRightAnswers()

static assQuestion::_getTotalRightAnswers ( int  $a_q_id)
static

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

1666 : int
1667 {
1668 global $DIC;
1669 $ilDB = $DIC['ilDB'];
1670
1671 $result = $ilDB->queryF(
1672 "SELECT question_id FROM qpl_questions WHERE original_id = %s OR question_id = %s",
1673 array('integer','integer'),
1674 array($a_q_id, $a_q_id)
1675 );
1676 if ($result->numRows() == 0) {
1677 return 0;
1678 }
1679
1680 $found_id = [];
1681 while ($row = $ilDB->fetchAssoc($result)) {
1682 $found_id[] = $row["question_id"];
1683 }
1684
1685 $result = $ilDB->query("SELECT * FROM tst_test_result WHERE " . $ilDB->in('question_fi', $found_id, false, 'integer'));
1686 $answers = [];
1687 while ($row = $ilDB->fetchAssoc($result)) {
1688 $reached = $row["points"];
1689 $max = self::_getMaximumPoints($row["question_fi"]);
1690 $answers[] = array("reached" => $reached, "max" => $max);
1691 }
1692 $max = 0.0;
1693 $reached = 0.0;
1694 foreach ($answers as $key => $value) {
1695 $max += $value["max"];
1696 $reached += $value["reached"];
1697 }
1698 if ($max > 0) {
1699 return $reached / $max;
1700 }
1701 return 0;
1702 }
assQuestion\_getMaximumPoints
static _getMaximumPoints(int $question_id)
Returns the maximum points, a learner can reach answering the question.
Definition: class.assQuestion.php:650

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

Referenced by ilQuestionCumulatedStatisticsTableGUI\initData().

+ Here is the caller graph for this function:

◆ _includeClass()

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

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

3184 : void
3185 {
3186 if (self::isCoreQuestionType($question_type)) {
3187 self::includeCoreClass($question_type, $gui);
3188 }
3189 }
assQuestion\includeCoreClass
static includeCoreClass($questionType, $withGuiClass)
Definition: class.assQuestion.php:3201

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

+ Here is the caller graph for this function:

◆ _instanciateQuestion()

static assQuestion::_instanciateQuestion ( int  $question_id)
static
Deprecated:
use assQuestion::instantiateQuestion() instead. @removal ILIAS 9

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

2588 : assQuestion
2589 {
2590 return self::_instantiateQuestion($question_id);
2591 }
assQuestion
Abstract basic class which is to be extended by the concrete assessment question type classes.
Definition: class.assQuestion.php:42

Referenced by ilFixMissingQuestionDuplicationMigration\step().

+ Here is the caller graph for this function:

◆ _instanciateQuestionGUI()

static assQuestion::_instanciateQuestionGUI ( int  $question_id)
static
Deprecated:
Use instantiateQuestionGUI (without legacy underscore & typos) instead. @removal ILIAS 9

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

3232 : assQuestionGUI
3233 {
3234 return self::instantiateQuestionGUI($question_id);
3235 }
assQuestionGUI
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
Definition: class.assQuestionGUI.php:30
assQuestion\instantiateQuestionGUI
static instantiateQuestionGUI(int $a_question_id)
Definition: class.assQuestion.php:3237

◆ _instantiateQuestion()

static assQuestion::_instantiateQuestion ( int  $question_id)
static
Deprecated:
use assQuestion::instantiateQuestion() instead.

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

2596 : assQuestion
2597 {
2598 return self::instantiateQuestion($question_id);
2599 }
assQuestion\instantiateQuestion
static instantiateQuestion(int $question_id)
Definition: class.assQuestion.php:2606

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

+ Here is the caller graph for this function:

◆ _isUsedInRandomTest()

static assQuestion::_isUsedInRandomTest ( int  $question_id)
static

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

2698 : bool
2699 {
2700 global $DIC;
2701 $ilDB = $DIC['ilDB'];
2702
2703 $result = $ilDB->queryF(
2704 "SELECT test_random_question_id FROM tst_test_rnd_qst WHERE question_fi = %s",
2705 array('integer'),
2706 array($question_id)
2707 );
2708 return $ilDB->numRows($result) > 0;
2709 }

References $DIC, and $ilDB.

Referenced by ilObjQuestionPool\getDeleteableQuestionDetails().

+ Here is the caller graph for this function:

◆ _isWorkedThrough()

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

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

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

2787 : bool
2788 {
2789 return self::lookupResultRecordExist($active_id, $question_id, $pass);
2790 }
assQuestion\lookupResultRecordExist
static lookupResultRecordExist(int $activeId, int $questionId, int $pass)
Definition: class.assQuestion.php:4134

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

+ Here is the caller graph for this function:

◆ _isWriteable()

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

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

2675 : bool
2676 {
2677 global $DIC;
2678 $ilDB = $DIC['ilDB'];
2679
2680 if (($question_id < 1) || ($user_id < 1)) {
2681 return false;
2682 }
2683
2684 $result = $ilDB->queryF(
2685 "SELECT obj_fi FROM qpl_questions WHERE question_id = %s",
2686 array('integer'),
2687 array($question_id)
2688 );
2689 if ($ilDB->numRows($result) == 1) {
2690 $row = $ilDB->fetchAssoc($result);
2691 $qpl_object_id = (int) $row["obj_fi"];
2692 return ilObjQuestionPool::_isWriteable($qpl_object_id, $user_id);
2693 }
2694
2695 return false;
2696 }
ilObjQuestionPool\_isWriteable
static _isWriteable($object_id, $user_id)
Returns true, if the question pool is writeable by a given user.
Definition: class.ilObjQuestionPool.php:1101

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

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

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ _needsManualScoring()

static assQuestion::_needsManualScoring ( int  $question_id)
static

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

3147 : bool
3148 {
3149 $scoring = ilObjAssessmentFolder::_getManualScoringTypes();
3150 $questiontype = assQuestion::_getQuestionType($question_id);
3151 if (in_array($questiontype, $scoring)) {
3152 return true;
3153 }
3154
3155 return false;
3156 }
assQuestion\_getQuestionType
static _getQuestionType(int $question_id)
Definition: class.assQuestion.php:1803
ilObjAssessmentFolder\_getManualScoringTypes
static _getManualScoringTypes()
Retrieve the manual scoring settings as type strings.
Definition: class.ilObjAssessmentFolder.php:151

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

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

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ _questionExists()

assQuestion::_questionExists (   $question_id)

Returns true if the question already exists in the database.

Parameters
integer$question_idThe database id of the question
Returns
boolean True, if the question exists, otherwise False @access public

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

2557 {
2558 if ($question_id < 1) {
2559 return false;
2560 }
2561
2562 $result = $this->db->queryF(
2563 "SELECT question_id FROM qpl_questions WHERE question_id = %s",
2564 array('integer'),
2565 array($question_id)
2566 );
2567 return $result->numRows() == 1;
2568 }

◆ _questionExistsInPool()

assQuestion::_questionExistsInPool ( int  $question_id)

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

2570 : bool
2571 {
2572 if ($question_id < 1) {
2573 return false;
2574 }
2575
2576 $result = $this->db->queryF(
2577 "SELECT question_id FROM qpl_questions INNER JOIN object_data ON obj_fi = obj_id WHERE question_id = %s AND type = 'qpl'",
2578 array('integer'),
2579 array($question_id)
2580 );
2581 return $this->db->numRows($result) == 1;
2582 }

◆ _questionExistsInTest()

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

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

3327 : bool
3328 {
3329 global $DIC;
3330 $ilDB = $DIC['ilDB'];
3331
3332 if ($question_id < 1) {
3333 return false;
3334 }
3335
3336 $result = $ilDB->queryF(
3337 "SELECT question_fi FROM tst_test_question WHERE question_fi = %s AND test_fi = %s",
3338 array('integer', 'integer'),
3339 array($question_id, $test_id)
3340 );
3341 return $ilDB->numRows($result) == 1;
3342 }
assQuestion\$test_id
int $test_id
The database id of a test in which the question is contained.
Definition: class.assQuestion.php:97

References $DIC, and $ilDB.

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

+ Here is the caller graph for this function:

◆ _resolveInternalLink()

assQuestion::_resolveInternalLink ( string  $internal_link)

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

2368 : string
2369 {
2370 if (preg_match("/il_(\d+)_(\w+)_(\d+)/", $internal_link, $matches)) {
2371 switch ($matches[2]) {
2372 case "lm":
2373 $resolved_link = ilLMObject::_getIdForImportId($internal_link);
2374 break;
2375 case "pg":
2376 $resolved_link = ilInternalLink::_getIdForImportId("PageObject", $internal_link);
2377 break;
2378 case "st":
2379 $resolved_link = ilInternalLink::_getIdForImportId("StructureObject", $internal_link);
2380 break;
2381 case "git":
2382 $resolved_link = ilInternalLink::_getIdForImportId("GlossaryItem", $internal_link);
2383 break;
2384 case "mob":
2385 $resolved_link = ilInternalLink::_getIdForImportId("MediaObject", $internal_link);
2386 break;
2387 }
2388 if (strcmp($resolved_link, "") == 0) {
2389 $resolved_link = $internal_link;
2390 }
2391 } else {
2392 $resolved_link = $internal_link;
2393 }
2394 return $resolved_link;
2395 }
ilLMObject\_getIdForImportId
static _getIdForImportId(string $a_import_id)
get current object id for import id (static)
Definition: class.ilLMObject.php:555

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

+ Here is the call graph for this function:

◆ _resolveIntLinks()

assQuestion::_resolveIntLinks ( int  $question_id)

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

2397 : void
2398 {
2399 $resolvedlinks = 0;
2400 $result = $this->db->queryF(
2401 "SELECT * FROM qpl_sol_sug WHERE question_fi = %s",
2402 array('integer'),
2403 array($question_id)
2404 );
2405 if ($this->db->numRows($result) > 0) {
2406 while ($row = $this->db->fetchAssoc($result)) {
2407 $internal_link = $row["internal_link"];
2408 $resolved_link = $this->_resolveInternalLink($internal_link);
2409 if (strcmp($internal_link, $resolved_link) != 0) {
2410 // internal link was resolved successfully
2411 $affectedRows = $this->db->manipulateF(
2412 "UPDATE qpl_sol_sug SET internal_link = %s WHERE suggested_solution_id = %s",
2413 array('text','integer'),
2414 array($resolved_link, $row["suggested_solution_id"])
2415 );
2416 $resolvedlinks++;
2417 }
2418 }
2419 }
2420 if ($resolvedlinks) {
2421 ilInternalLink::_deleteAllLinksOfSource("qst", $question_id);
2422
2423 $result = $this->db->queryF(
2424 "SELECT * FROM qpl_sol_sug WHERE question_fi = %s",
2425 array('integer'),
2426 array($question_id)
2427 );
2428 if ($this->db->numRows($result) > 0) {
2429 while ($row = $this->db->fetchAssoc($result)) {
2430 if (preg_match("/il_(\d*?)_(\w+)_(\d+)/", $row["internal_link"], $matches)) {
2431 ilInternalLink::_saveLink("qst", $question_id, $matches[2], $matches[3], $matches[1]);
2432 }
2433 }
2434 }
2435 }
2436 }
assQuestion\_resolveInternalLink
_resolveInternalLink(string $internal_link)
Definition: class.assQuestion.php:2368

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

Referenced by ilQuestionPageParser\processPagesToParse().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ _setReachedPoints()

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

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

Parameters
integer$user_idThe database ID of the learner
integer$test_idThe database Id of the test containing the question
integer$pointsThe points the user has reached answering the question
Returns
boolean true on success, otherwise false @access public

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

2919 : bool
2920 {
2921 global $DIC;
2922 $ilDB = $DIC['ilDB'];
2923 $refinery = $DIC['refinery'];
2924
2925 $float_trafo = $refinery->kindlyTo()->float();
2926 try {
2927 $points = $float_trafo->transform($points);
2928 } catch (ILIAS\Refinery\ConstraintViolationException $e) {
2929 return false;
2930 }
2931
2932 if ($points <= $maxpoints) {
2933 if ($pass === null) {
2934 $pass = assQuestion::_getSolutionMaxPass($question_id, $active_id);
2935 }
2936
2937 $rowsnum = 0;
2938 $old_points = 0;
2939
2940 if ($pass !== null) {
2941 $result = $ilDB->queryF(
2942 "SELECT points FROM tst_test_result WHERE active_fi = %s AND question_fi = %s AND pass = %s",
2943 array('integer','integer','integer'),
2944 array($active_id, $question_id, $pass)
2945 );
2946 $manual = ($manualscoring) ? 1 : 0;
2947 $rowsnum = $result->numRows();
2948 }
2949 if ($rowsnum > 0) {
2950 $row = $ilDB->fetchAssoc($result);
2951 $old_points = $row["points"];
2952 if ($old_points != $points) {
2953 $affectedRows = $ilDB->manipulateF(
2954 "UPDATE tst_test_result SET points = %s, manual = %s, tstamp = %s WHERE active_fi = %s AND question_fi = %s AND pass = %s",
2955 array('float', 'integer', 'integer', 'integer', 'integer', 'integer'),
2956 array($points, $manual, time(), $active_id, $question_id, $pass)
2957 );
2958 }
2959 } else {
2960 $next_id = $ilDB->nextId('tst_test_result');
2961 $affectedRows = $ilDB->manipulateF(
2962 "INSERT INTO tst_test_result (test_result_id, active_fi, question_fi, points, pass, manual, tstamp) VALUES (%s, %s, %s, %s, %s, %s, %s)",
2963 array('integer', 'integer','integer', 'float', 'integer', 'integer','integer'),
2964 array($next_id, $active_id, $question_id, $points, $pass, $manual, time())
2965 );
2966 }
2967
2968 if (self::isForcePassResultUpdateEnabled() || $old_points != $points || $rowsnum == 0) {
2969 assQuestion::_updateTestPassResults($active_id, $pass, $obligationsEnabled);
2970 ilCourseObjectiveResult::_updateObjectiveResult(ilObjTest::_getUserIdFromActiveId($active_id), $question_id, $points);
2971 if (ilObjAssessmentFolder::_enabledAssessmentLogging()) {
2972 global $DIC;
2973 $lng = $DIC['lng'];
2974 $ilUser = $DIC['ilUser'];
2975 $username = ilObjTestAccess::_getParticipantData($active_id);
2976 assQuestion::logAction(sprintf(
2977 $lng->txtlng(
2978 "assessment",
2979 "log_answer_changed_points",
2980 ilObjAssessmentFolder::_getLogLanguage()
2981 ),
2982 $username,
2983 $old_points,
2984 $points,
2985 $ilUser->getFullname() . " (" . $ilUser->getLogin() . ")"
2986 ), $active_id, $question_id);
2987 }
2988 }
2989
2990 return true;
2991 }
2992
2993 return false;
2994 }
assQuestion\logAction
static logAction(string $logtext, int $active_id, int $question_id)
Definition: class.assQuestion.php:1199
assQuestion\$refinery
ILIAS Refinery Factory $refinery
Definition: class.assQuestion.php:68
assQuestion\_getSolutionMaxPass
static _getSolutionMaxPass(int $question_id, int $active_id)
Returns the maximum pass a users question solution.
Definition: class.assQuestion.php:2650
ilCourseObjectiveResult\_updateObjectiveResult
static _updateObjectiveResult(int $a_user_id, int $a_active_id, int $a_question_id)
Definition: class.ilCourseObjectiveResult.php:259
ilLanguage\txtlng
txtlng(string $a_module, string $a_topic, string $a_language)
gets the text for a given topic in a given language if the topic is not in the list,...
Definition: class.ilLanguage.php:159
ilObjTestAccess\_getParticipantData
static _getParticipantData($active_id)
Retrieves a participant name from active id.
Definition: class.ilObjTestAccess.php:582
ilObjTest\_getUserIdFromActiveId
static _getUserIdFromActiveId($active_id)
Definition: class.ilObjTest.php:8029
$ilUser
$ilUser
Definition: imgupload.php:34
ILIAS
Class ChatMainBarProvider \MainMenu\Provider.

References $DIC, Vendor\Package\$e, $ilDB, $ilUser, $lng, ILIAS\Repository\$refinery, ilObjAssessmentFolder\_enabledAssessmentLogging(), ilObjAssessmentFolder\_getLogLanguage(), ilObjTestAccess\_getParticipantData(), _getSolutionMaxPass(), ilObjTest\_getUserIdFromActiveId(), ilCourseObjectiveResult\_updateObjectiveResult(), and logAction().

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

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ _updateTestResultCache()

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

@TODO Move this to a proper place.

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

994 : void
995 {
996 global $DIC;
997 $ilDB = $DIC['ilDB'];
998
999 $pass = ilObjTest::_getResultPass($active_id);
1000
1001 if ($pass !== null) {
1002 $query = "
1003 SELECT tst_pass_result.*
1004 FROM tst_pass_result
1005 WHERE active_fi = %s
1006 AND pass = %s
1007 ";
1008
1009 $result = $ilDB->queryF(
1010 $query,
1011 array('integer','integer'),
1012 array($active_id, $pass)
1013 );
1014
1015 $test_pass_result_row = $ilDB->fetchAssoc($result);
1016
1017 if (!is_array($test_pass_result_row)) {
1018 $test_pass_result_row = [];
1019 }
1020 $max = (float) ($test_pass_result_row['maxpoints'] ?? 0);
1021 $reached = (float) ($test_pass_result_row['points'] ?? 0);
1022 $percentage = ($max <= 0.0 || $reached <= 0.0) ? 0 : ($reached / $max) * 100.0;
1023
1024 $obligationsAnswered = (int) ($test_pass_result_row['obligations_answered'] ?? 1);
1025
1026 $mark = ASS_MarkSchema::_getMatchingMarkFromActiveId($active_id, $percentage);
1027 $isPassed = isset($mark["passed"]) && $mark["passed"];
1028
1029 $hint_count = $test_pass_result_row['hint_count'] ?? 0;
1030 $hint_points = $test_pass_result_row['hint_points'] ?? 0.0;
1031
1032 $userTestResultUpdateCallback = function () use ($ilDB, $active_id, $pass, $max, $reached, $isPassed, $obligationsAnswered, $hint_count, $hint_points, $mark) {
1033 $passedOnceBefore = 0;
1034 $query = "SELECT passed_once FROM tst_result_cache WHERE active_fi = %s";
1035 $res = $ilDB->queryF($query, array('integer'), array($active_id));
1036 while ($passed_once_result_row = $ilDB->fetchAssoc($res)) {
1037 $passedOnceBefore = (int) $passed_once_result_row['passed_once'];
1038 }
1039
1040 $passedOnce = (int) ($isPassed || $passedOnceBefore);
1041
1042 $ilDB->manipulateF(
1043 "DELETE FROM tst_result_cache WHERE active_fi = %s",
1044 array('integer'),
1045 array($active_id)
1046 );
1047
1048 $ilDB->insert('tst_result_cache', array(
1049 'active_fi' => array('integer', $active_id),
1050 'pass' => array('integer', strlen($pass) ? $pass : 0),
1051 'max_points' => array('float', strlen($max) ? $max : 0),
1052 'reached_points' => array('float', strlen($reached) ? $reached : 0),
1053 'mark_short' => array('text', strlen($mark["short_name"] ?? '') ? $mark["short_name"] : " "),
1054 'mark_official' => array('text', strlen($mark["official_name"] ?? '') ? $mark["official_name"] : " "),
1055 'passed_once' => array('integer', $passedOnce),
1056 'passed' => array('integer', (int) $isPassed),
1057 'failed' => array('integer', (int) !$isPassed),
1058 'tstamp' => array('integer', time()),
1059 'hint_count' => array('integer', $hint_count),
1060 'hint_points' => array('float', $hint_points),
1061 'obligations_answered' => array('integer', $obligationsAnswered)
1062 ));
1063 };
1064
1065 if (is_object($processLocker)) {
1066 $processLocker->executeUserTestResultUpdateLockOperation($userTestResultUpdateCallback);
1067 } else {
1068 $userTestResultUpdateCallback();
1069 }
1070 }
1071 }
assQuestion\$processLocker
ilAssQuestionProcessLocker $processLocker
Definition: class.assQuestion.php:162
ilAssQuestionProcessLocker\executeUserTestResultUpdateLockOperation
executeUserTestResultUpdateLockOperation(callable $operation)
Definition: class.ilAssQuestionProcessLocker.php:134
ilObjTest\_getResultPass
static _getResultPass($active_id)
Retrieves the pass number that should be counted for a given user.
Definition: class.ilObjTest.php:7319
$query
$query
Definition: proxy_ylocal.php:13

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

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

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

Reimplemented in assClozeTest, and assTextSubset.

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

4009 : void
4010 {
4011 }

◆ addQTIMaterial()

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

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

2863 : void
2864 {
2865 $a_xml_writer->xmlStartTag("material");
2866 $attrs = array(
2867 "texttype" => "text/plain"
2868 );
2869 if ($this->isHTML($a_material)) {
2870 $attrs["texttype"] = "text/xhtml";
2871 }
2872 $a_xml_writer->xmlElement("mattext", $attrs, ilRTE::_replaceMediaObjectImageSrc($a_material, 0));
2873 if ($add_mobs) {
2874 $mobs = ilObjMediaObject::_getMobsOfObject("qpl:html", $this->getId());
2875 foreach ($mobs as $mob) {
2876 $moblabel = "il_" . IL_INST_ID . "_mob_" . $mob;
2877 if (strpos($a_material, "mm_$mob") !== false) {
2878 if (ilObjMediaObject::_exists($mob)) {
2879 $mob_obj = new ilObjMediaObject($mob);
2880 $imgattrs = array(
2881 "label" => $moblabel,
2882 "uri" => "objects/" . "il_" . IL_INST_ID . "_mob_" . $mob . "/" . $mob_obj->getTitle()
2883 );
2884 }
2885 $a_xml_writer->xmlElement("matimage", $imgattrs, null);
2886 }
2887 }
2888 }
2889 if ($close_material_tag) {
2890 $a_xml_writer->xmlEndTag("material");
2891 }
2892 }
assQuestion\isHTML
isHTML($a_text)
Checks if a given string contains HTML or not.
Definition: class.assQuestion.php:2819
ilObjMediaObject\_exists
static _exists(int $id, bool $reference=false, ?string $type=null)
checks if an object exists in object_data
Definition: class.ilObjMediaObject.php:51
ilObjMediaObject\_getMobsOfObject
static _getMobsOfObject(string $a_type, int $a_id, int $a_usage_hist_nr=0, string $a_lang="-")
Definition: class.ilObjMediaObject.php:814
ilRTE\_replaceMediaObjectImageSrc
static _replaceMediaObjectImageSrc(string $a_text, int $a_direction=0, string $nic='')
Replaces image source from mob image urls with the mob id or replaces mob id with the correct image s...
Definition: class.ilRTE.php:177
ilXmlWriter\xmlElement
xmlElement(string $tag, $attrs=null, $data=null, $encode=true, $escape=true)
Writes a basic element (no children, just textual content)
Definition: class.ilXmlWriter.php:342
ilXmlWriter\xmlEndTag
xmlEndTag(string $tag)
Writes an endtag.
Definition: class.ilXmlWriter.php:305
ilXmlWriter\xmlStartTag
xmlStartTag(string $tag, ?array $attrs=null, bool $empty=false, bool $encode=true, bool $escape=true)
Writes a starttag.
Definition: class.ilXmlWriter.php:262
IL_INST_ID
const IL_INST_ID
Definition: constants.php:40
$mobs
$mobs
Definition: imgupload.php:70

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

+ Here is the call graph for this function:

◆ adjustReachedPointsByScoringOptions()

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

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

@final @access public

Parameters
integer$points
integer$active_id
integer$pass

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

2766 : float
2767 {
2768 $count_system = ilObjTest::_getCountSystem($active_id);
2769 if ($count_system == 1) {
2770 if (abs($this->getMaximumPoints() - $points) > 0.0000000001) {
2771 $points = 0;
2772 }
2773 }
2774 $score_cutting = ilObjTest::_getScoreCutting($active_id);
2775 if ($score_cutting == 0) {
2776 if ($points < 0) {
2777 $points = 0;
2778 }
2779 }
2780 return $points;
2781 }
ilObjTest\_getCountSystem
static _getCountSystem($active_id)
Gets the count system for the calculation of points.
Definition: class.ilObjTest.php:1872
ilObjTest\_getScoreCutting
static _getScoreCutting($active_id)
Determines if the score of a question should be cut at 0 points or the score of the whole test.
Definition: class.ilObjTest.php:1942

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

+ Here is the call graph for this function:

◆ afterSyncWithOriginal()

assQuestion::afterSyncWithOriginal ( int  $origQuestionId,
int  $dupQuestionId,
int  $origParentObjId,
int  $dupParentObjId 
)
protected

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

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

◆ areObligationsToBeConsidered()

assQuestion::areObligationsToBeConsidered ( )

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

4174 : bool
4175 {
4176 return $this->obligationsToBeConsidered;
4177 }
assQuestion\$obligationsToBeConsidered
bool $obligationsToBeConsidered
Definition: class.assQuestion.php:175

◆ authorizedOrIntermediateSolutionExists()

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

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

3943 : bool
3944 {
3945 $solutionAvailability = $this->lookupForExistingSolutions($active_id, $pass);
3946 return $solutionAvailability['authorized'] || $solutionAvailability['intermediate'];
3947 }
assQuestion\lookupForExistingSolutions
lookupForExistingSolutions(int $activeId, int $pass)
Lookup if an authorized or intermediate solution exists.
Definition: class.assQuestion.php:3968

◆ authorizedSolutionExists()

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

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

3934 : bool
3935 {
3936 if ($pass === null) {
3937 return false;
3938 }
3939 $solutionAvailability = $this->lookupForExistingSolutions($active_id, $pass);
3940 return (bool) $solutionAvailability['authorized'];
3941 }

◆ beforeSyncWithOriginal()

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

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

2114 : void
2115 {
2116 }

◆ buildHashedImageFilename()

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

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

2894 : string
2895 {
2896 $extension = "";
2897
2898 if (preg_match("/.*\.(png|jpg|gif|jpeg)$/i", $plain_image_filename, $matches)) {
2899 $extension = "." . $matches[1];
2900 }
2901
2902 if ($unique) {
2903 $plain_image_filename = uniqid($plain_image_filename . microtime(true), true);
2904 }
2905
2906 return md5($plain_image_filename) . $extension;
2907 }

Referenced by assKprimChoice\handleFileUpload().

+ Here is the caller graph for this function:

◆ buildImagePath()

assQuestion::buildImagePath (   $questionId,
  $parentObjectId 
)

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

1257 : string
1258 {
1259 return CLIENT_WEB_DIR . "/assessment/{$parentObjectId}/{$questionId}/images/";
1260 }
CLIENT_WEB_DIR
const CLIENT_WEB_DIR
Definition: constants.php:47

References CLIENT_WEB_DIR.

Referenced by assMatchingQuestion\afterSyncWithOriginal().

+ Here is the caller graph for this function:

◆ buildQuestionDataQuery()

assQuestion::buildQuestionDataQuery ( )
protected

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

3598 : string
3599 {
3600 return "
3601 SELECT qpl_questions.*,
3602 {$this->getAdditionalTableName()}.*
3603 FROM qpl_questions
3604 LEFT JOIN {$this->getAdditionalTableName()}
3605 ON {$this->getAdditionalTableName()}.question_fi = qpl_questions.question_id
3606 WHERE qpl_questions.question_id = %s
3607 ";
3608 }

Referenced by assKprimChoice\loadFromDb().

+ 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

Reimplemented in assFileUpload, assFlashQuestion, assMultipleChoice, assOrderingHorizontal, and assOrderingQuestion.

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

4216 : ilTestQuestionConfig
4217 {
4218 return new ilTestQuestionConfig();
4219 }
ilTestQuestionConfig
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
Definition: class.ilTestQuestionConfig.php:24

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

@abstract @access public

Parameters
integer$active_id
integer$pass
boolean$returndetails(deprecated !!)
Returns
integer/array $points/$details (array $details is deprecated !!)

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

◆ calculateReachedPointsFromPreviewSession()

assQuestion::calculateReachedPointsFromPreviewSession ( ilAssQuestionPreviewSession  $previewSession)

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

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

2736 {
2737 $reachedPoints = $this->calculateReachedPointsForSolution($previewSession->getParticipantsSolution());
2738 $reachedPoints = $this->deductHintPointsFromReachedPoints($previewSession, $reachedPoints);
2739
2740 return $this->ensureNonNegativePoints($reachedPoints);
2741 }
assQuestion\deductHintPointsFromReachedPoints
deductHintPointsFromReachedPoints(ilAssQuestionPreviewSession $previewSession, $reachedPoints)
Definition: class.assQuestion.php:2724
assQuestion\ensureNonNegativePoints
ensureNonNegativePoints($points)
Definition: class.assQuestion.php:2743

References ilAssQuestionPreviewSession\getParticipantsSolution().

+ Here is the call graph for this function:

◆ calculateResultsFromSolution()

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

Calculates the question results from a previously saved question solution.

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

841 : void
842 {
843 global $DIC;
844 $ilDB = $DIC['ilDB'];
845 $ilUser = $DIC['ilUser'];
846
847 // determine reached points for submitted solution
848 $reached_points = $this->calculateReachedPoints($active_id, $pass);
849 $questionHintTracking = new ilAssQuestionHintTracking($this->getId(), $active_id, $pass);
850 $requestsStatisticData = $questionHintTracking->getRequestStatisticDataByQuestionAndTestpass();
851 $reached_points = $reached_points - $requestsStatisticData->getRequestsPoints();
852
853 // adjust reached points regarding to tests scoring options
854 $reached_points = $this->adjustReachedPointsByScoringOptions($reached_points, $active_id, $pass);
855
856 if ($obligationsEnabled && ilObjTest::isQuestionObligatory($this->getId())) {
857 $isAnswered = $this->isAnswered($active_id, $pass);
858 } else {
859 $isAnswered = true;
860 }
861
862 if (is_null($reached_points)) {
863 $reached_points = 0.0;
864 }
865
866 // fau: testNav - check for existing authorized solution to know if a result record should be written
867 $existingSolutions = $this->lookupForExistingSolutions($active_id, $pass);
868
869 $this->getProcessLocker()->executeUserQuestionResultUpdateOperation(function () use ($ilDB, $active_id, $pass, $reached_points, $requestsStatisticData, $isAnswered, $existingSolutions) {
870 $query = "
871 DELETE FROM tst_test_result
872
873 WHERE active_fi = %s
874 AND question_fi = %s
875 AND pass = %s
876 ";
877
878 $types = array('integer', 'integer', 'integer');
879 $values = array($active_id, $this->getId(), $pass);
880
881 if ($this->getStep() !== null) {
882 $query .= "
883 AND step = %s
884 ";
885
886 $types[] = 'integer';
887 $values[] = $this->getStep();
888 }
889 $ilDB->manipulateF($query, $types, $values);
890
891 if ($existingSolutions['authorized']) {
892 $next_id = $ilDB->nextId("tst_test_result");
893 $fieldData = array(
894 'test_result_id' => array('integer', $next_id),
895 'active_fi' => array('integer', $active_id),
896 'question_fi' => array('integer', $this->getId()),
897 'pass' => array('integer', $pass),
898 'points' => array('float', $reached_points),
899 'tstamp' => array('integer', time()),
900 'hint_count' => array('integer', $requestsStatisticData->getRequestsCount()),
901 'hint_points' => array('float', $requestsStatisticData->getRequestsPoints()),
902 'answered' => array('integer', $isAnswered)
903 );
904
905 if ($this->getStep() !== null) {
906 $fieldData['step'] = array('integer', $this->getStep());
907 }
908
909 $ilDB->insert('tst_test_result', $fieldData);
910 }
911 });
912
913 if (ilObjAssessmentFolder::_enabledAssessmentLogging()) {
914 assQuestion::logAction(
915 sprintf(
916 $this->lng->txtlng(
917 "assessment",
918 "log_user_answered_question",
919 ilObjAssessmentFolder::_getLogLanguage()
920 ),
921 $reached_points
922 ),
923 $active_id,
924 $this->getId()
925 );
926 }
927
928 // update test pass results
929 self::_updateTestPassResults($active_id, $pass, $obligationsEnabled, $this->getProcessLocker());
930 ilCourseObjectiveResult::_updateObjectiveResult($ilUser->getId(), $active_id, $this->getId());
931 }
assQuestion\adjustReachedPointsByScoringOptions
adjustReachedPointsByScoringOptions($points, $active_id, $pass=null)
Adjust the given reached points by checks for all special scoring options in the test container.
Definition: class.assQuestion.php:2766
assQuestion\calculateReachedPoints
calculateReachedPoints($active_id, $pass=null, $authorizedSolution=true, $returndetails=false)
Returns the points, a learner has reached answering the question.
assQuestion\isAnswered
isAnswered(int $active_id, int $pass)
Definition: class.assQuestion.php:3505
ilObjTest\isQuestionObligatory
static isQuestionObligatory($question_id)
checks wether the question with given id is marked as obligatory or not
Definition: class.ilObjTest.php:10191

References $DIC, $ilDB, $ilUser, $query, ilObjAssessmentFolder\_enabledAssessmentLogging(), ilObjAssessmentFolder\_getLogLanguage(), ilCourseObjectiveResult\_updateObjectiveResult(), ILIAS\Survey\Mode\getId(), ilObjTest\isQuestionObligatory(), ILIAS\Repository\lng(), and logAction().

+ Here is the call graph for this function:

◆ cleanupMediaObjectUsage()

assQuestion::cleanupMediaObjectUsage ( )

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

3103 : void
3104 {
3105 $combinedtext = $this->getRTETextWithMediaObjects();
3106 ilRTE::_cleanupMediaObjectUsage($combinedtext, "qpl:html", $this->getId());
3107 }
ilRTE\_cleanupMediaObjectUsage
static _cleanupMediaObjectUsage(string $a_text, string $a_usage_type, int $a_usage_id)
Synchronises appearances of media objects in $a_text with media object usage table.
Definition: class.ilRTE.php:144

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

+ Here is the call graph for this function:

◆ convertISO8601FormatH_i_s_ExtendedToSeconds()

static assQuestion::convertISO8601FormatH_i_s_ExtendedToSeconds ( string  $time)
static

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

3908 : int
3909 {
3910 $sec = 0;
3911 $time_array = explode(':', $time);
3912 if (count($time_array) == 3) {
3913 $sec += (int) $time_array[0] * 3600;
3914 $sec += (int) $time_array[1] * 60;
3915 $sec += (int) $time_array[2];
3916 }
3917 return $sec;
3918 }

References ILIAS\Repository\int().

+ Here is the call graph for this function:

◆ copyPageOfQuestion()

assQuestion::copyPageOfQuestion ( int  $a_q_id)

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

1786 : void
1787 {
1788 if ($a_q_id > 0) {
1789 $page = new ilAssQuestionPage($a_q_id);
1790
1791 $xml = str_replace("il__qst_" . $a_q_id, "il__qst_" . $this->id, $page->getXMLContent());
1792 $this->page->setXMLContent($xml);
1793 $this->page->updateFromXML();
1794 }
1795 }
ilAssQuestionPage
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
Definition: class.ilAssQuestionPage.php:29
$xml
$xml
Definition: metadata.php:351

References $xml.

◆ copySuggestedSolutionFiles()

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

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

2261 : void
2262 {
2263 foreach ($this->suggested_solutions as $index => $solution) {
2264 if (strcmp($solution["type"], "file") == 0) {
2265 $filepath = $this->getSuggestedSolutionPath();
2266 $filepath_original = str_replace("/$this->obj_id/$this->id/solution", "/$source_questionpool_id/$source_question_id/solution", $filepath);
2267 if (!file_exists($filepath)) {
2268 ilFileUtils::makeDirParents($filepath);
2269 }
2270 $filename = $solution["value"]["name"];
2271 if (strlen($filename)) {
2272 if (!copy($filepath_original . $filename, $filepath . $filename)) {
2273 $this->ilLog->root()->error("File could not be copied!!!!");
2274 $this->ilLog->root()->error("object: " . print_r($this, true));
2275 }
2276 }
2277 }
2278 }
2279 }
$filename
$filename
Definition: buildRTE.php:78
ilFileUtils\makeDirParents
static makeDirParents(string $a_dir)
Create a new directory and all parent directories.
Definition: class.ilFileUtils.php:298
$index
$index
Definition: metadata.php:145

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

+ Here is the call graph for this function:

◆ copyXHTMLMediaObjectsOfQuestion()

assQuestion::copyXHTMLMediaObjectsOfQuestion ( int  $a_q_id)

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

1758 : void
1759 {
1760 $mobs = ilObjMediaObject::_getMobsOfObject("qpl:html", $a_q_id);
1761 foreach ($mobs as $mob) {
1762 ilObjMediaObject::_saveUsage($mob, "qpl:html", $this->getId());
1763 }
1764 }
ilObjMediaObject\_saveUsage
static _saveUsage(int $a_mob_id, string $a_type, int $a_id, int $a_usage_hist_nr=0, string $a_lang="-")
Save usage of mob within another container (e.g.
Definition: class.ilObjMediaObject.php:852

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

+ Here is the call graph for this function:

◆ createNewQuestion()

assQuestion::createNewQuestion ( bool  $a_create_page = true)

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

Returns
integer ID of the new question

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

1961 : int
1962 {
1963 $ilUser = $this->current_user;
1964
1965 $complete = "0";
1966 $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();
1967 if ($obj_id > 0) {
1968 if ($a_create_page) {
1969 $tstamp = 0;
1970 } else {
1971 // question pool must not try to purge
1972 $tstamp = time();
1973 }
1974
1975 $next_id = $this->db->nextId('qpl_questions');
1976 $this->db->insert("qpl_questions", array(
1977 "question_id" => array("integer", $next_id),
1978 "question_type_fi" => array("integer", $this->getQuestionTypeID()),
1979 "obj_fi" => array("integer", $obj_id),
1980 "title" => array("text", null),
1981 "description" => array("text", null),
1982 "author" => array("text", $this->getAuthor()),
1983 "owner" => array("integer", $ilUser->getId()),
1984 "question_text" => array("clob", null),
1985 "points" => array("float", "0.0"),
1986 "nr_of_tries" => array("integer", $this->getDefaultNrOfTries()), // #10771
1987 "complete" => array("text", $complete),
1988 "created" => array("integer", time()),
1989 "original_id" => array("integer", null),
1990 "tstamp" => array("integer", $tstamp),
1991 "external_id" => array("text", $this->getExternalId()),
1992 'add_cont_edit_mode' => array('text', $this->getAdditionalContentEditingMode())
1993 ));
1994 $this->setId($next_id);
1995
1996 if ($a_create_page) {
1997 // create page object of question
1998 $this->createPageObject();
1999 }
2000 }
2001
2002 return $this->getId();
2003 }
assQuestion\$current_user
ilObjUser $current_user
Definition: class.assQuestion.php:187
assQuestion\setId
setId(int $id=-1)
Definition: class.assQuestion.php:475
assQuestion\$obj_id
int $obj_id
Object id of the container object.
Definition: class.assQuestion.php:102
ilObject\_lookupObjId
static _lookupObjId(int $ref_id)
Definition: class.ilObject.php:930

References $ilUser, ilObject\_lookupObjId(), and ILIAS\Survey\Mode\getId().

+ Here is the call graph for this function:

◆ createPageObject()

assQuestion::createPageObject ( )

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

1774 : void
1775 {
1776 $qpl_id = $this->getObjId();
1777 $this->page = new ilAssQuestionPage(0);
1778 $this->page->setId($this->getId());
1779 $this->page->setParentId($qpl_id);
1780 $this->page->setXMLContent("<PageObject><PageContent>" .
1781 "<Question QRef=\"il__qst_" . $this->getId() . "\"/>" .
1782 "</PageContent></PageObject>");
1783 $this->page->create(false);
1784 }

References ILIAS\Survey\Mode\getId().

+ Here is the call graph for this function:

◆ deductHintPointsFromReachedPoints()

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

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

2724 : ?float
2725 {
2726 global $DIC;
2727
2728 $hintTracking = new ilAssQuestionPreviewHintTracking($DIC->database(), $previewSession);
2729 $requestsStatisticData = $hintTracking->getRequestStatisticData();
2730 $reachedPoints = $reachedPoints - $requestsStatisticData->getRequestsPoints();
2731
2732 return $reachedPoints;
2733 }

References $DIC.

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

+ Here is the caller graph for this function:

◆ delete()

assQuestion::delete ( int  $question_id)

Reimplemented in assLongMenu.

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

1510 : void
1511 {
1512 if ($question_id < 1) {
1513 return;
1514 }
1515
1516 $result = $this->db->queryF(
1517 "SELECT obj_fi FROM qpl_questions WHERE question_id = %s",
1518 array('integer'),
1519 array($question_id)
1520 );
1521 if ($this->db->numRows($result) == 1) {
1522 $row = $this->db->fetchAssoc($result);
1523 $obj_id = $row["obj_fi"];
1524 } else {
1525 return; // nothing to do
1526 }
1527 try {
1528 $this->deletePageOfQuestion($question_id);
1529 } catch (Exception $e) {
1530 $this->ilLog->root()->error("EXCEPTION: Could not delete page of question $question_id: $e");
1531 return;
1532 }
1533
1534 $affectedRows = $this->db->manipulateF(
1535 "DELETE FROM qpl_questions WHERE question_id = %s",
1536 array('integer'),
1537 array($question_id)
1538 );
1539 if ($affectedRows == 0) {
1540 return;
1541 }
1542
1543 try {
1544 $this->deleteAdditionalTableData($question_id);
1545 $this->deleteAnswers($question_id);
1546 $this->feedbackOBJ->deleteGenericFeedbacks($question_id, $this->isAdditionalContentEditingModePageObject());
1547 $this->feedbackOBJ->deleteSpecificAnswerFeedbacks($question_id, $this->isAdditionalContentEditingModePageObject());
1548 } catch (Exception $e) {
1549 $this->ilLog->root()->error("EXCEPTION: Could not delete additional table data of question $question_id: $e");
1550 return;
1551 }
1552
1553 try {
1554 // delete the question in the tst_test_question table (list of test questions)
1555 $affectedRows = $this->db->manipulateF(
1556 "DELETE FROM tst_test_question WHERE question_fi = %s",
1557 array('integer'),
1558 array($question_id)
1559 );
1560 } catch (Exception $e) {
1561 $this->ilLog->root()->error("EXCEPTION: Could not delete delete question $question_id from a test: $e");
1562 return;
1563 }
1564
1565 try {
1566 // delete suggested solutions contained in the question
1567 $affectedRows = $this->db->manipulateF(
1568 "DELETE FROM qpl_sol_sug WHERE question_fi = %s",
1569 array('integer'),
1570 array($question_id)
1571 );
1572 } catch (Exception $e) {
1573 $this->ilLog->root()->error("EXCEPTION: Could not delete suggested solutions of question $question_id: $e");
1574 return;
1575 }
1576
1577 try {
1578 $directory = CLIENT_WEB_DIR . "/assessment/" . $obj_id . "/$question_id";
1579 if (preg_match("/\d+/", $obj_id) and preg_match("/\d+/", $question_id) and is_dir($directory)) {
1580 ilFileUtils::delDir($directory);
1581 }
1582 } catch (Exception $e) {
1583 $this->ilLog->root()->error("EXCEPTION: Could not delete question file directory $directory of question $question_id: $e");
1584 return;
1585 }
1586
1587 try {
1588 $mobs = ilObjMediaObject::_getMobsOfObject("qpl:html", $question_id);
1589 // remaining usages are not in text anymore -> delete them
1590 // and media objects (note: delete method of ilObjMediaObject
1591 // checks whether object is used in another context; if yes,
1592 // the object is not deleted!)
1593 foreach ($mobs as $mob) {
1594 ilObjMediaObject::_removeUsage($mob, "qpl:html", $question_id);
1595 if (ilObjMediaObject::_exists($mob)) {
1596 $mob_obj = new ilObjMediaObject($mob);
1597 $mob_obj->delete();
1598 }
1599 }
1600 } catch (Exception $e) {
1601 $this->ilLog->root()->error("EXCEPTION: Error deleting the media objects of question $question_id: $e");
1602 return;
1603 }
1604 ilAssQuestionHintTracking::deleteRequestsByQuestionIds(array($question_id));
1605 ilAssQuestionHintList::deleteHintsByQuestionIds(array($question_id));
1606 $assignmentList = new ilAssQuestionSkillAssignmentList($this->db);
1607 $assignmentList->setParentObjId($obj_id);
1608 $assignmentList->setQuestionIdFilter($question_id);
1609 $assignmentList->loadFromDb();
1610 foreach ($assignmentList->getAssignmentsByQuestionId($question_id) as $assignment) {
1611 /* @var ilAssQuestionSkillAssignment $assignment */
1612 $assignment->deleteFromDb();
1613
1614 // remove skill usage
1615 if (!$assignment->isSkillUsed()) {
1616 ilSkillUsage::setUsage(
1617 $assignment->getParentObjId(),
1618 $assignment->getSkillBaseId(),
1619 $assignment->getSkillTrefId(),
1620 false
1621 );
1622 }
1623 }
1624
1625 $this->deleteTaxonomyAssignments();
1626
1627 try {
1628 ilObjQuestionPool::_updateQuestionCount($this->getObjId());
1629 } catch (Exception $e) {
1630 $this->ilLog->root()->error("EXCEPTION: Error updating the question pool question count of question pool " . $this->getObjId() . " when deleting question $question_id: $e");
1631 return;
1632 }
1633 }
assQuestion\deletePageOfQuestion
deletePageOfQuestion(int $question_id)
Definition: class.assQuestion.php:1502
assQuestion\deleteAdditionalTableData
deleteAdditionalTableData(int $question_id)
Definition: class.assQuestion.php:1483
assQuestion\deleteAnswers
deleteAnswers(int $question_id)
Definition: class.assQuestion.php:1464
assQuestion\isAdditionalContentEditingModePageObject
isAdditionalContentEditingModePageObject()
Definition: class.assQuestion.php:3560
ilAssQuestionHintList\deleteHintsByQuestionIds
static deleteHintsByQuestionIds($questionIds)
Deletes all question hints relating to questions included in given question ids.
Definition: class.ilAssQuestionHintList.php:366
ilFileUtils\delDir
static delDir(string $a_dir, bool $a_clean_only=false)
removes a dir and all its content (subdirs and files) recursively
Definition: class.ilFileUtils.php:632
ilObjMediaObject\_removeUsage
static _removeUsage(int $a_mob_id, string $a_type, int $a_id, int $a_usage_hist_nr=0, string $a_lang="-")
Remove usage of mob in another container.
Definition: class.ilObjMediaObject.php:882
ilObjQuestionPool\_updateQuestionCount
static _updateQuestionCount($object_id)
Updates the number of available questions for a question pool in the database.
Definition: class.ilObjQuestionPool.php:1526
ilSkillUsage\setUsage
static setUsage(int $a_obj_id, int $a_skill_id, int $a_tref_id, bool $a_use=true)
Definition: class.ilSkillUsage.php:70

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

+ Here is the call graph for this function:

◆ deleteAdditionalTableData()

assQuestion::deleteAdditionalTableData ( int  $question_id)

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

1483 : void
1484 {
1485 $additional_table_name = $this->getAdditionalTableName();
1486
1487 if (!is_array($additional_table_name)) {
1488 $additional_table_name = array($additional_table_name);
1489 }
1490
1491 foreach ($additional_table_name as $table) {
1492 if (strlen($table)) {
1493 $this->db->manipulateF(
1494 "DELETE FROM $table WHERE question_fi = %s",
1495 array('integer'),
1496 array($question_id)
1497 );
1498 }
1499 }
1500 }

◆ deleteAnswers()

assQuestion::deleteAnswers ( int  $question_id)

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

1464 : void
1465 {
1466 $answer_table_name = $this->getAnswerTableName();
1467
1468 if (!is_array($answer_table_name)) {
1469 $answer_table_name = array($answer_table_name);
1470 }
1471
1472 foreach ($answer_table_name as $table) {
1473 if (strlen($table)) {
1474 $this->db->manipulateF(
1475 "DELETE FROM $table WHERE question_fi = %s",
1476 array('integer'),
1477 array($question_id)
1478 );
1479 }
1480 }
1481 }

◆ deleteDummySolutionRecord()

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

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

3808 : void
3809 {
3810 foreach ($this->getSolutionValues($activeId, $passIndex, false) as $solutionRec) {
3811 if ($solutionRec['value1'] == '' && $solutionRec['value2'] == '') {
3812 $this->removeSolutionRecordById($solutionRec['solution_id']);
3813 }
3814 }
3815 }
assQuestion\getSolutionValues
getSolutionValues($active_id, $pass=null, bool $authorized=true)
Loads solutions of a given user from the database an returns it.
Definition: class.assQuestion.php:1327
assQuestion\removeSolutionRecordById
removeSolutionRecordById(int $solutionId)
Definition: class.assQuestion.php:3656

Referenced by assFileUpload\saveWorkingData().

+ Here is the caller graph for this function:

◆ deletePageOfQuestion()

assQuestion::deletePageOfQuestion ( int  $question_id)
protected

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

1502 : void
1503 {
1504 if (ilAssQuestionPage::_exists('qpl', $question_id, "", true)) {
1505 $page = new ilAssQuestionPage($question_id);
1506 $page->delete();
1507 }
1508 }
ilPageObject\_exists
static _exists(string $a_parent_type, int $a_id, string $a_lang="", bool $a_no_cache=false)
Checks whether page exists.
Definition: class.ilPageObject.php:317

References ilPageObject\_exists().

+ Here is the call graph for this function:

◆ deleteSolutionRecordByValues()

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

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

3822 : void
3823 {
3824 $types = array("integer", "integer", "integer", "integer");
3825 $values = array($activeId, $this->getId(), $passIndex, (int) $authorized);
3826 $valuesCondition = [];
3827
3828 foreach ($matchValues as $valueField => $value) {
3829 switch ($valueField) {
3830 case 'value1':
3831 case 'value2':
3832 $valuesCondition[] = "{$valueField} = %s";
3833 $types[] = 'text';
3834 $values[] = $value;
3835 break;
3836
3837 default:
3838 throw new ilTestQuestionPoolException('invalid value field given: ' . $valueField);
3839 }
3840 }
3841
3842 $valuesCondition = implode(' AND ', $valuesCondition);
3843
3844 $query = "
3845 DELETE FROM tst_solutions
3846 WHERE active_fi = %s
3847 AND question_fi = %s
3848 AND pass = %s
3849 AND authorized = %s
3850 AND $valuesCondition
3851 ";
3852
3853 if ($this->getStep() !== null) {
3854 $query .= " AND step = %s ";
3855 $types[] = 'integer';
3856 $values[] = $this->getStep();
3857 }
3858
3859 $this->db->manipulateF($query, $types, $values);
3860 }

References $query, and ILIAS\Survey\Mode\getId().

+ Here is the call graph for this function:

◆ deleteSuggestedSolutions()

assQuestion::deleteSuggestedSolutions ( )

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

2137 : void
2138 {
2139 // delete the links in the qpl_sol_sug table
2140 $this->db->manipulateF(
2141 "DELETE FROM qpl_sol_sug WHERE question_fi = %s",
2142 array('integer'),
2143 array($this->getId())
2144 );
2145 ilInternalLink::_deleteAllLinksOfSource("qst", $this->getId());
2146 $this->suggested_solutions = [];
2147 ilFileUtils::delDir($this->getSuggestedSolutionPath());
2148 }

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

+ Here is the call graph for this function:

◆ deleteTaxonomyAssignments()

assQuestion::deleteTaxonomyAssignments ( )
private

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

1635 : void
1636 {
1637 $taxIds = ilObjTaxonomy::getUsageOfObject($this->getObjId());
1638
1639 foreach ($taxIds as $taxId) {
1640 $taxNodeAssignment = new ilTaxNodeAssignment('qpl', $this->getObjId(), 'quest', $taxId);
1641 $taxNodeAssignment->deleteAssignmentsOfItem($this->getId());
1642 }
1643 }
ilObjTaxonomy\getUsageOfObject
static getUsageOfObject(int $a_obj_id, bool $a_include_titles=false)
Definition: class.ilObjTaxonomy.php:234
ilTaxNodeAssignment
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
Definition: class.ilTaxNodeAssignment.php:25

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

+ Here is the call graph for this function:

◆ duplicate()

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

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

◆ duplicateIntermediateSolutionAuthorized()

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

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

3862 : void
3863 {
3864 foreach ($this->getSolutionValues($activeId, $passIndex, false) as $rec) {
3865 $this->saveCurrentSolution($activeId, $passIndex, $rec['value1'], $rec['value2'], true, $rec['tstamp']);
3866 }
3867 }
assQuestion\saveCurrentSolution
saveCurrentSolution(int $active_id, int $pass, $value1, $value2, bool $authorized=true, $tstamp=0)
Definition: class.assQuestion.php:3729

◆ duplicateQuestionHints()

assQuestion::duplicateQuestionHints ( int  $originalQuestionId,
int  $duplicateQuestionId 
)
protected

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

3431 : void
3432 {
3433 $hintIds = ilAssQuestionHintList::duplicateListForQuestion($originalQuestionId, $duplicateQuestionId);
3434
3435 if ($this->isAdditionalContentEditingModePageObject()) {
3436 foreach ($hintIds as $originalHintId => $duplicateHintId) {
3437 $this->ensureHintPageObjectExists($originalHintId);
3438 $originalPageObject = new ilAssHintPage($originalHintId);
3439 $originalXML = $originalPageObject->getXMLContent();
3440
3441 $duplicatePageObject = new ilAssHintPage();
3442 $duplicatePageObject->setId($duplicateHintId);
3443 $duplicatePageObject->setParentId($this->getId());
3444 $duplicatePageObject->setXMLContent($originalXML);
3445 $duplicatePageObject->createFromXML();
3446 }
3447 }
3448 }
assQuestion\ensureHintPageObjectExists
ensureHintPageObjectExists($pageObjectId)
Definition: class.assQuestion.php:3495
ilAssHintPage
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
Definition: class.ilAssHintPage.php:28
ilAssQuestionHintList\duplicateListForQuestion
static duplicateListForQuestion($originalQuestionId, $duplicateQuestionId)
duplicates a hint list from given original question id to given duplicate question id and returns an ...
Definition: class.ilAssQuestionHintList.php:184

References ilAssQuestionHintList\duplicateListForQuestion(), and ILIAS\Survey\Mode\getId().

+ Here is the call graph for this function:

◆ duplicateSkillAssignments()

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

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

3450 : void
3451 {
3452 $assignmentList = new ilAssQuestionSkillAssignmentList($this->db);
3453 $assignmentList->setParentObjId($srcParentId);
3454 $assignmentList->setQuestionIdFilter($srcQuestionId);
3455 $assignmentList->loadFromDb();
3456
3457 foreach ($assignmentList->getAssignmentsByQuestionId($srcQuestionId) as $assignment) {
3458 $assignment->setParentObjId($trgParentId);
3459 $assignment->setQuestionId($trgQuestionId);
3460 $assignment->saveToDb();
3461
3462 // add skill usage
3463 ilSkillUsage::setUsage(
3464 $trgParentId,
3465 $assignment->getSkillBaseId(),
3466 $assignment->getSkillTrefId()
3467 );
3468 }
3469 }

References ilSkillUsage\setUsage().

+ Here is the call graph for this function:

◆ duplicateSuggestedSolutionFiles()

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

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

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

2206 : void
2207 {
2208 foreach ($this->suggested_solutions as $index => $solution) {
2209 if (!is_array($solution) ||
2210 !array_key_exists("type", $solution) ||
2211 strcmp($solution["type"], "file") !== 0) {
2212 continue;
2213 }
2214
2215 $filepath = $this->getSuggestedSolutionPath();
2216 $filepath_original = str_replace(
2217 "/{$this->obj_id}/{$this->id}/solution",
2218 "/$parent_id/$question_id/solution",
2219 $filepath
2220 );
2221 if (!file_exists($filepath)) {
2222 ilFileUtils::makeDirParents($filepath);
2223 }
2224 $filename = $solution["value"]["name"];
2225 if (strlen($filename)) {
2226 if (!copy($filepath_original . $filename, $filepath . $filename)) {
2227 $this->ilLog->root()->error("File could not be duplicated!!!!");
2228 $this->ilLog->root()->error("object: " . print_r($this, true));
2229 }
2230 }
2231 }
2232 }

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

+ Here is the call graph for this function:

◆ ensureCurrentTestPass()

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

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

321 : int
322 {
323 if (is_int($pass) && $pass >= 0) {
324 return $pass;
325 }
326
327 return $this->lookupCurrentTestPass($active_id, $pass);
328 }
assQuestion\lookupCurrentTestPass
lookupCurrentTestPass(int $active_id, int $pass)
Definition: class.assQuestion.php:334

References lookupCurrentTestPass().

Referenced by assFileUpload\saveWorkingData().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ ensureHintPageObjectExists()

assQuestion::ensureHintPageObjectExists (   $pageObjectId)

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

3495 : void
3496 {
3497 if (!ilAssHintPage::_exists('qht', $pageObjectId)) {
3498 $pageObject = new ilAssHintPage();
3499 $pageObject->setParentId($this->getId());
3500 $pageObject->setId($pageObjectId);
3501 $pageObject->createFromXML();
3502 }
3503 }

References ilPageObject\_exists(), and ILIAS\Survey\Mode\getId().

+ Here is the call graph for this function:

◆ ensureNonNegativePoints()

assQuestion::ensureNonNegativePoints (   $points)
protected

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

2744 {
2745 return $points > 0 ? $points : 0;
2746 }

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

+ Here is the caller graph for this function:

◆ explodeKeyValues()

static assQuestion::explodeKeyValues ( string  $keyValues)
static

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

3803 : array
3804 {
3805 return explode(assQuestion::KEY_VALUES_IMPLOSION_SEPARATOR, $keyValues);
3806 }
assQuestion\KEY_VALUES_IMPLOSION_SEPARATOR
const KEY_VALUES_IMPLOSION_SEPARATOR
Definition: class.assQuestion.php:3796

References KEY_VALUES_IMPLOSION_SEPARATOR.

Referenced by assImagemapQuestion\getReuseSolutionSelectionParameter().

+ 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$valueThe string to trim.
Returns
string The trimmed string.

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

4254 : string
4255 {
4256 return preg_replace(self::TRIM_PATTERN, '', $value);
4257 }

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

+ Here is the caller graph for this function:

◆ fetchIndexedValuesFromValuePairs()

assQuestion::fetchIndexedValuesFromValuePairs ( array  $valuePairs)

Reimplemented in assMatchingQuestion.

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

4163 : array
4164 {
4165 $indexedValues = [];
4166
4167 foreach ($valuePairs as $valuePair) {
4168 $indexedValues[ $valuePair['value1'] ] = $valuePair['value2'];
4169 }
4170
4171 return $indexedValues;
4172 }

◆ fetchMimeTypeIdentifier()

static assQuestion::fetchMimeTypeIdentifier ( string  $contentType)
static

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

253 : string
254 {
255 return current(explode(';', $contentType));
256 }

Referenced by ilQtiMatImageSecurity\validateContent().

+ Here is the caller graph for this function:

◆ fetchValuePairsFromIndexedValues()

assQuestion::fetchValuePairsFromIndexedValues ( array  $indexedValues)

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

4152 : array
4153 {
4154 $valuePairs = [];
4155
4156 foreach ($indexedValues as $value1 => $value2) {
4157 $valuePairs[] = array('value1' => $value1, 'value2' => $value2);
4158 }
4159
4160 return $valuePairs;
4161 }

◆ fixSvgToPng()

assQuestion::fixSvgToPng ( string  $imageFilenameContainingString)

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

1865 : string
1866 {
1867 $needles = array_keys(self::$imageSourceFixReplaceMap);
1868 $replacements = array_values(self::$imageSourceFixReplaceMap);
1869 return str_replace($needles, $replacements, $imageFilenameContainingString);
1870 }

◆ fixUnavailableSkinImageSources()

assQuestion::fixUnavailableSkinImageSources ( string  $html)

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

1872 : string
1873 {
1874 $matches = null;
1875 if (preg_match_all('/src="(.*?)"/m', $html, $matches)) {
1876 $sources = $matches[1];
1877
1878 $needleReplacementMap = [];
1879
1880 foreach ($sources as $src) {
1881 $file = ilFileUtils::removeTrailingPathSeparators(ILIAS_ABSOLUTE_PATH) . DIRECTORY_SEPARATOR . $src;
1882
1883 if (file_exists($file)) {
1884 continue;
1885 }
1886
1887 $levels = explode(DIRECTORY_SEPARATOR, $src);
1888 if (count($levels) < 5 || $levels[0] !== 'Customizing' || $levels[2] !== 'skin') {
1889 continue;
1890 }
1891
1892 $component = '';
1893
1894 if ($levels[4] === 'Modules' || $levels[4] === 'Services') {
1895 $component = $levels[4] . DIRECTORY_SEPARATOR . $levels[5];
1896 }
1897
1898 $needleReplacementMap[$src] = ilUtil::getImagePath(basename($src), $component);
1899 }
1900
1901 if (count($needleReplacementMap)) {
1902 $html = str_replace(array_keys($needleReplacementMap), array_values($needleReplacementMap), $html);
1903 }
1904 }
1905
1906 return $html;
1907 }
ilFileUtils\removeTrailingPathSeparators
static removeTrailingPathSeparators(string $path)
Definition: class.ilFileUtils.php:1038
ilUtil\getImagePath
static getImagePath(string $img, string $module_path="", string $mode="output", bool $offline=false)
get image path (for images located in a template directory)
Definition: class.ilUtil.php:67

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

+ Here is the call graph for this function:

◆ forceExistingIntermediateSolution()

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

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

3869 : void
3870 {
3871 $intermediateSolution = $this->getSolutionValues($activeId, $passIndex, false);
3872
3873 if (!count($intermediateSolution)) {
3874 // make the authorized solution intermediate (keeping timestamps)
3875 // this keeps the solution_ids in synch with eventually selected in $_POST['deletefiles']
3876 $this->updateCurrentSolutionsAuthorization($activeId, $passIndex, false, true);
3877
3878 // create a backup as authorized solution again (keeping timestamps)
3879 $this->duplicateIntermediateSolutionAuthorized($activeId, $passIndex);
3880
3881 if ($considerDummyRecordCreation) {
3882 // create an additional dummy record to indicate the existence of an intermediate solution
3883 // even if all entries are deleted from the intermediate solution later
3884 $this->saveCurrentSolution($activeId, $passIndex, null, null, false);
3885 }
3886 }
3887 }
assQuestion\updateCurrentSolutionsAuthorization
updateCurrentSolutionsAuthorization(int $activeId, int $pass, bool $authorized, bool $keepTime=false)
Definition: class.assQuestion.php:3771
assQuestion\duplicateIntermediateSolutionAuthorized
duplicateIntermediateSolutionAuthorized(int $activeId, int $passIndex)
Definition: class.assQuestion.php:3862

Referenced by assFileUpload\saveWorkingData().

+ Here is the caller graph for this function:

◆ formatSAQuestion()

assQuestion::formatSAQuestion (   $a_q)

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

3344 : string
3345 {
3346 return $this->getSelfAssessmentFormatter()->format($a_q);
3347 }

Referenced by assClozeTest\toJSON(), assKprimChoice\toJSON(), assLongMenu\toJSON(), assMatchingQuestion\toJSON(), assOrderingHorizontal\toJSON(), assTextQuestion\toJSON(), and assTextSubset\toJSON().

+ 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$itemThe QTI item object
integer$questionpool_idThe id of the parent questionpool
integer$tst_idThe id of the parent test if the question is part of a test
object$tst_objectA reference to the parent test object
integer$question_counterA reference to a question counter to count the questions of an imported question pool
array$import_mappingAn array containing references to included ILIAS objects

Reimplemented in assErrorText, assFileUpload, assFlashQuestion, and assOrderingHorizontal.

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

410 : array
411 {
412 $classname = $this->getQuestionType() . "Import";
413 $import = new $classname($this);
414 $import_mapping = $import->fromXML($item, $questionpool_id, $tst_id, $tst_object, $question_counter, $import_mapping);
415
416 foreach ($solutionhints as $hint) {
417 $h = new ilAssQuestionHint();
418 $h->setQuestionId($import->getQuestionId());
419 $h->setIndex($hint['index'] ?? "");
420 $h->setPoints($hint['points'] ?? "");
421 $h->setText($hint['txt'] ?? "");
422 $h->save();
423 }
424 return $import_mapping;
425 }
assQuestion\getQuestionType
getQuestionType()
Returns the question type of the question.

References getQuestionType().

+ Here is the call graph for this function:

◆ generateExternalId()

assQuestion::generateExternalId ( int  $question_id)
private

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

282 : string
283 {
284 if ($question_id > 0) {
285 return 'il_' . IL_INST_ID . '_qst_' . $question_id;
286 }
287
288 return uniqid('', true);
289 }

References IL_INST_ID.

◆ getActiveUserData()

assQuestion::getActiveUserData ( int  $active_id)

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

Parameters
integer$active_idActive id for a test/user
Returns
array Result array containing the user_id and test_id

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

3164 : array
3165 {
3166 $result = $this->db->queryF(
3167 "SELECT * FROM tst_active WHERE active_id = %s",
3168 array('integer'),
3169 array($active_id)
3170 );
3171 if ($this->db->numRows($result)) {
3172 $row = $this->db->fetchAssoc($result);
3173 return array("user_id" => $row["user_fi"], "test_id" => $row["test_fi"]);
3174 }
3175
3176 return [];
3177 }

◆ getAdditionalContentEditingMode()

assQuestion::getAdditionalContentEditingMode ( )

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

3546 : string
3547 {
3548 return $this->additionalContentEditingMode;
3549 }
assQuestion\$additionalContentEditingMode
string $additionalContentEditingMode
Definition: class.assQuestion.php:152

◆ getAdditionalTableName()

assQuestion::getAdditionalTableName ( )
Returns
string|array Or Array?
See also
Deletion methods here

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

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

1452 {
1453 return "";
1454 }

◆ getAdjustedReachedPoints()

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

returns the reached points ...

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

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

824 : float
825 {
826 // determine reached points for submitted solution
827 $reached_points = $this->calculateReachedPoints($active_id, $pass, $authorizedSolution);
828 $hintTracking = new ilAssQuestionHintTracking($this->getId(), $active_id, $pass);
829 $requestsStatisticData = $hintTracking->getRequestStatisticDataByQuestionAndTestpass();
830 $reached_points = $reached_points - $requestsStatisticData->getRequestsPoints();
831
832 // adjust reached points regarding to tests scoring options
833 $reached_points = $this->adjustReachedPointsByScoringOptions($reached_points, $active_id, $pass);
834
835 return $reached_points;
836 }

References ILIAS\Survey\Mode\getId().

+ Here is the call graph for this function:

◆ getAllowedFileExtensionsForMimeType()

static assQuestion::getAllowedFileExtensionsForMimeType ( string  $mimeType)
static

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

258 : array
259 {
260 foreach (self::$allowedFileExtensionsByMimeType as $allowedMimeType => $extensions) {
261 $rexCharsets = implode('|', self::$allowedCharsetsByMimeType[$allowedMimeType]);
262 $rexMimeType = preg_quote($allowedMimeType, '/');
263
264 $rex = '/^' . $rexMimeType . '(;(\s)*charset=(' . $rexCharsets . '))*$/';
265
266 if (!preg_match($rex, $mimeType)) {
267 continue;
268 }
269
270 return $extensions;
271 }
272
273 return [];
274 }

◆ getAllowedImageMaterialFileExtensions()

static assQuestion::getAllowedImageMaterialFileExtensions ( )
static
Returns
array all allowed file extensions for image material

@noinspection SlowArrayOperationsInLoopInspection

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

369 : array
370 {
371 $extensions = [];
372
373 foreach (self::$allowedImageMaterialFileExtensionsByMimeType as $mimeType => $mimeExtensions) {
375 $extensions = array_merge($extensions, $mimeExtensions);
376 }
377 return array_unique($extensions);
378 }

Referenced by ilImageWizardInputGUI\__construct().

+ Here is the caller graph for this function:

◆ getAnswerTableName()

assQuestion::getAnswerTableName ( )
Returns
string|array Or Array?
See also
Deletion methods here

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

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

1460 {
1461 return "";
1462 }

◆ getAuthor()

assQuestion::getAuthor ( )

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

598 : string
599 {
600 return $this->author;
601 }

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

+ Here is the caller graph for this function:

◆ getAuthorForHTMLOutput()

assQuestion::getAuthorForHTMLOutput ( )

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

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

References ILIAS\Repository\refinery().

+ Here is the call graph for this function:

◆ getComment()

assQuestion::getComment ( )

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

543 : string
544 {
545 return $this->comment;
546 }

References $comment.

◆ getCurrentSolutionResultSet()

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

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

3620 : \ilDBStatement
3621 {
3622 if ($this->getStep() !== null) {
3623 $query = "
3624 SELECT *
3625 FROM tst_solutions
3626 WHERE active_fi = %s
3627 AND question_fi = %s
3628 AND pass = %s
3629 AND step = %s
3630 AND authorized = %s
3631 ";
3632
3633 return $this->db->queryF(
3634 $query,
3635 array('integer', 'integer', 'integer', 'integer', 'integer'),
3636 array($active_id, $this->getId(), $pass, $this->getStep(), (int) $authorized)
3637 );
3638 }
3639
3640 $query = "
3641 SELECT *
3642 FROM tst_solutions
3643 WHERE active_fi = %s
3644 AND question_fi = %s
3645 AND pass = %s
3646 AND authorized = %s
3647 ";
3648
3649 return $this->db->queryF(
3650 $query,
3651 array('integer', 'integer', 'integer', 'integer'),
3652 array($active_id, $this->getId(), $pass, (int) $authorized)
3653 );
3654 }
ilDBStatement
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
Definition: interface.ilDBStatement.php:28

References $query, and ILIAS\Survey\Mode\getId().

Referenced by assClozeTest\calculateReachedPoints(), assErrorText\calculateReachedPoints(), assFileUpload\calculateReachedPoints(), assFlashQuestion\calculateReachedPoints(), assKprimChoice\calculateReachedPoints(), assLongMenu\calculateReachedPoints(), assMatchingQuestion\calculateReachedPoints(), assOrderingHorizontal\calculateReachedPoints(), assTextQuestion\calculateReachedPoints(), and assTextSubset\calculateReachedPoints().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ getDefaultNrOfTries()

assQuestion::getDefaultNrOfTries ( )

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

3400 : int
3401 {
3402 return $this->defaultnroftries;
3403 }

◆ getDescriptionForHTMLOutput()

assQuestion::getDescriptionForHTMLOutput ( )

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

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

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

+ Here is the call graph for this function:

◆ getExternalId()

assQuestion::getExternalId ( )

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

638 : string
639 {
640 if ($this->external_id === null || $this->external_id === '') {
641 return $this->generateExternalId($this->getId());
642 }
643
644 return $this->external_id;
645 }
assQuestion\generateExternalId
generateExternalId(int $question_id)
Definition: class.assQuestion.php:282

References ILIAS\Survey\Mode\getId().

+ Here is the call graph for this function:

◆ getFeedbackClassNameByQuestionType()

static assQuestion::getFeedbackClassNameByQuestionType ( string  $questionType)
static

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

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

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

+ Here is the caller graph for this function:

◆ getFlashPath()

assQuestion::getFlashPath ( )

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

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

Deprecated:
Flash is obsolete

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

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

References CLIENT_WEB_DIR.

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

+ Here is the caller graph for this function:

◆ getHtmlQuestionContentPurifier()

assQuestion::getHtmlQuestionContentPurifier ( )
Returns
ilHtmlPurifierInterface|ilAssHtmlUserSolutionPurifier

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

3593 : ilHtmlPurifierInterface
3594 {
3595 return ilHtmlPurifierFactory::getInstanceByType('qpl_usersolution');
3596 }
ilHtmlPurifierFactory\getInstanceByType
static getInstanceByType(string $type)
Definition: class.ilHtmlPurifierFactory.php:27
ilHtmlPurifierInterface
Interface for html sanitizing functionality.
Definition: interface.ilHtmlPurifierInterface.php:26

References ilHtmlPurifierFactory\getInstanceByType().

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

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ getHtmlUserSolutionPurifier()

assQuestion::getHtmlUserSolutionPurifier ( )
Returns
ilHtmlPurifierInterface|ilAssHtmlUserSolutionPurifier

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

3585 : ilHtmlPurifierInterface
3586 {
3587 return ilHtmlPurifierFactory::getInstanceByType('qpl_usersolution');
3588 }

References ilHtmlPurifierFactory\getInstanceByType().

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

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ getId()

assQuestion::getId ( )

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

528 : int
529 {
530 return $this->id;
531 }

References $id.

Referenced by ilQuestionCumulatedStatisticsTableGUI\__construct(), ilQuestionUsagesTableGUI\__construct(), ilAssQuestionHintsOrderingClipboard\__construct(), assLongMenu\buildFolderName(), assClozeTest\calculateCombinationResult(), assClozeTest\copyObject(), assErrorText\copyObject(), assFileUpload\copyObject(), assFlashQuestion\copyObject(), assFormulaQuestion\copyObject(), assImagemapQuestion\copyObject(), assKprimChoice\copyObject(), assLongMenu\copyObject(), assMatchingQuestion\copyObject(), assMultipleChoice\copyObject(), assOrderingHorizontal\copyObject(), assSingleChoice\copyObject(), assTextQuestion\copyObject(), assTextSubset\copyObject(), assClozeTest\createNewOriginalFromThisDuplicate(), assErrorText\createNewOriginalFromThisDuplicate(), assFileUpload\createNewOriginalFromThisDuplicate(), assFlashQuestion\createNewOriginalFromThisDuplicate(), assFormulaQuestion\createNewOriginalFromThisDuplicate(), assImagemapQuestion\createNewOriginalFromThisDuplicate(), assKprimChoice\createNewOriginalFromThisDuplicate(), assLongMenu\createNewOriginalFromThisDuplicate(), assMatchingQuestion\createNewOriginalFromThisDuplicate(), assMultipleChoice\createNewOriginalFromThisDuplicate(), assNumeric\createNewOriginalFromThisDuplicate(), assOrderingHorizontal\createNewOriginalFromThisDuplicate(), assSingleChoice\createNewOriginalFromThisDuplicate(), assTextQuestion\createNewOriginalFromThisDuplicate(), assTextSubset\createNewOriginalFromThisDuplicate(), assClozeTest\duplicate(), assErrorText\duplicate(), assFileUpload\duplicate(), assFlashQuestion\duplicate(), assFormulaQuestion\duplicate(), assImagemapQuestion\duplicate(), assKprimChoice\duplicate(), assLongMenu\duplicate(), assMatchingQuestion\duplicate(), assMultipleChoice\duplicate(), assNumeric\duplicate(), assOrderingHorizontal\duplicate(), assSingleChoice\duplicate(), assTextQuestion\duplicate(), assTextSubset\duplicate(), assMatchingQuestion\fetchSubmittedMatchingsFromPost(), assErrorText\getAnswersFromRequest(), assLongMenu\getCorrectAnswersAsJson(), assFileUpload\getFileUploadPath(), assFileUpload\getFileUploadPathWeb(), assClozeTest\getMaximumPoints(), assFileUpload\getUploadedFiles(), assFileUpload\handleSubmission(), assFileUpload\hasFileUploads(), assFileUpload\isAnswered(), assKprimChoice\isAnswered(), assTextQuestion\loadFromDb(), log(), assErrorText\logUserAction(), assFormulaQuestion\lookupForExistingSolutions(), assLongMenu\lookupForExistingSolutions(), ilAssNestedOrderingElementsInputGUI\prepareReprintable(), assFormulaQuestion\removeExistingSolutions(), ilAssOrderingQuestionAuthoringFormGUI\renewOrderingElementInput(), assClozeTest\saveAdditionalQuestionDataToDb(), assErrorText\saveAdditionalQuestionDataToDb(), assFileUpload\saveAdditionalQuestionDataToDb(), assFlashQuestion\saveAdditionalQuestionDataToDb(), assImagemapQuestion\saveAdditionalQuestionDataToDb(), assKprimChoice\saveAdditionalQuestionDataToDb(), assLongMenu\saveAdditionalQuestionDataToDb(), assMatchingQuestion\saveAdditionalQuestionDataToDb(), assOrderingHorizontal\saveAdditionalQuestionDataToDb(), assClozeTest\saveAnswerSpecificDataToDb(), assErrorText\saveAnswerSpecificDataToDb(), assImagemapQuestion\saveAnswerSpecificDataToDb(), assKprimChoice\saveAnswerSpecificDataToDb(), assLongMenu\saveAnswerSpecificDataToDb(), assMatchingQuestion\saveAnswerSpecificDataToDb(), assClozeTest\saveClozeNumericGapRecordToDb(), assClozeTest\saveClozeSelectGapRecordToDb(), assClozeTest\saveClozeTextGapRecordToDb(), assFormulaQuestion\saveToDb(), assMultipleChoice\saveToDb(), assFormulaQuestion\saveWorkingData(), assFormulaQuestion\setId(), assTextQuestion\setReachedPoints(), assClozeTest\toJSON(), assKprimChoice\toJSON(), assLongMenu\toJSON(), assMatchingQuestion\toJSON(), assOrderingHorizontal\toJSON(), assTextQuestion\toJSON(), assTextSubset\toJSON(), and ilLOTestQuestionAdapter\updateQuestionResult().

+ Here is the caller graph for this function:

◆ getImagePath()

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

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

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

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

1244 : string
1245 {
1246 if ($question_id === null) {
1247 $question_id = $this->id;
1248 }
1249
1250 if ($object_id === null) {
1251 $object_id = $this->obj_id;
1252 }
1253
1254 return $this->buildImagePath($question_id, $object_id);
1255 }
assQuestion\buildImagePath
buildImagePath($questionId, $parentObjectId)
Definition: class.assQuestion.php:1257

References $id.

Referenced by assImagemapQuestion\copyImage(), assMatchingQuestion\copyImages(), assMatchingQuestion\deleteImagefile(), assImagemapQuestion\duplicateImage(), assMatchingQuestion\duplicateImages(), assKprimChoice\handleFileUpload(), assKprimChoice\loadAnswerData(), assMultipleChoice\loadFromDb(), assSingleChoice\loadFromDb(), assMatchingQuestion\rebuildThumbnails(), assMultipleChoice\rebuildThumbnails(), assSingleChoice\rebuildThumbnails(), assMatchingQuestion\setExportDetailsXLS(), assMatchingQuestion\setImageFile(), and assImagemapQuestion\setImageFilename().

+ Here is the caller graph for this function:

◆ getImagePathWeb()

assQuestion::getImagePathWeb ( )

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

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

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

1288 : string
1289 {
1290 if (!$this->export_image_path) {
1291 $webdir = ilFileUtils::removeTrailingPathSeparators(CLIENT_WEB_DIR) . "/assessment/$this->obj_id/$this->id/images/";
1292 return str_replace(
1293 ilFileUtils::removeTrailingPathSeparators(ILIAS_ABSOLUTE_PATH),
1294 ilFileUtils::removeTrailingPathSeparators(ILIAS_HTTP_PATH),
1295 $webdir
1296 );
1297 }
1298 return $this->export_image_path;
1299 }
assQuestion\$export_image_path
string $export_image_path
(Web) Path to images
Definition: class.assQuestion.php:145

References CLIENT_WEB_DIR, and ilFileUtils\removeTrailingPathSeparators().

Referenced by assKprimChoice\loadAnswerData(), and assKprimChoice\toJSON().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ getInstances()

assQuestion::getInstances ( )

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

3109 : array
3110 {
3111 $result = $this->db->queryF(
3112 "SELECT question_id FROM qpl_questions WHERE original_id = %s",
3113 array("integer"),
3114 array($this->getId())
3115 );
3116 $instances = [];
3117 $ids = [];
3118 while ($row = $this->db->fetchAssoc($result)) {
3119 $ids[] = $row["question_id"];
3120 }
3121 foreach ($ids as $question_id) {
3122 // check non random tests
3123 $result = $this->db->queryF(
3124 "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",
3125 array("integer"),
3126 array($question_id)
3127 );
3128 while ($row = $this->db->fetchAssoc($result)) {
3129 $instances[$row['obj_fi']] = ilObject::_lookupTitle($row['obj_fi']);
3130 }
3131 // check random tests
3132 $result = $this->db->queryF(
3133 "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",
3134 array("integer"),
3135 array($question_id)
3136 );
3137 while ($row = $this->db->fetchAssoc($result)) {
3138 $instances[$row['obj_fi']] = ilObject::_lookupTitle($row['obj_fi']);
3139 }
3140 }
3141 foreach ($instances as $key => $value) {
3142 $instances[$key] = array("obj_id" => $key, "title" => $value, "author" => ilObjTest::_lookupAuthor($key), "refs" => ilObject::_getAllReferences($key));
3143 }
3144 return $instances;
3145 }
ilObjTest\_lookupAuthor
static _lookupAuthor($obj_id)
Gets the authors name of the ilObjTest object.
Definition: class.ilObjTest.php:6197
ilObject\_getAllReferences
static _getAllReferences(int $id)
get all reference ids for object ID
Definition: class.ilObject.php:816
ilObject\_lookupTitle
static _lookupTitle(int $obj_id)
Definition: class.ilObject.php:837

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

+ Here is the call graph for this function:

◆ getLastChange()

assQuestion::getLastChange ( )

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

3616 {
3617 return $this->lastChange;
3618 }

◆ getLifecycle()

assQuestion::getLifecycle ( )

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

623 : ilAssQuestionLifecycle
624 {
625 return $this->lifecycle;
626 }
assQuestion\$lifecycle
ilAssQuestionLifecycle $lifecycle
Definition: class.assQuestion.php:179

◆ getMaximumPoints()

assQuestion::getMaximumPoints ( )

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

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

812 : float
813 {
814 return $this->points;
815 }

◆ getMaximumThumbSize()

assQuestion::getMaximumThumbSize ( )

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

572 : int
573 {
574 return self::MAXIMUM_THUMB_SIZE;
575
576 }
assQuestion\MAXIMUM_THUMB_SIZE
const MAXIMUM_THUMB_SIZE
Definition: class.assQuestion.php:63

◆ getMinimumThumbSize()

assQuestion::getMinimumThumbSize ( )

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

567 : int
568 {
569 return self::MINIMUM_THUMB_SIZE;
570 }
assQuestion\MINIMUM_THUMB_SIZE
const MINIMUM_THUMB_SIZE
Definition: class.assQuestion.php:62

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

+ Here is the caller graph for this function:

◆ getNrOfTries()

assQuestion::getNrOfTries ( )

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

3312 : int
3313 {
3314 return $this->nr_of_tries;
3315 }

Referenced by assClozeTest\toJSON(), assKprimChoice\toJSON(), assLongMenu\toJSON(), assMatchingQuestion\toJSON(), assOrderingHorizontal\toJSON(), assTextQuestion\toJSON(), and assTextSubset\toJSON().

+ Here is the caller graph for this function:

◆ getNumExistingSolutionRecords()

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

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

3520 : int
3521 {
3522 global $DIC;
3523 $ilDB = $DIC['ilDB'];
3524
3525 $query = "
3526 SELECT count(active_fi) cnt
3527
3528 FROM tst_solutions
3529
3530 WHERE active_fi = %s
3531 AND question_fi = %s
3532 AND pass = %s
3533 ";
3534
3535 $res = $ilDB->queryF(
3536 $query,
3537 array('integer','integer','integer'),
3538 array($activeId, $questionId, $pass)
3539 );
3540
3541 $row = $ilDB->fetchAssoc($res);
3542
3543 return (int) $row['cnt'];
3544 }

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

Referenced by assFileUpload\isAnswered(), assKprimChoice\isAnswered(), assMultipleChoice\isAnswered(), assSingleChoice\isAnswered(), and assTextQuestion\isAnswered().

+ Here is the caller graph for this function:

◆ getObjId()

assQuestion::getObjId ( )

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

613 : int
614 {
615 return $this->obj_id;
616 }

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

+ Here is the caller graph for this function:

◆ getOriginalId()

assQuestion::getOriginalId ( )

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

1851 : ?int
1852 {
1853 return $this->original_id;
1854 }

◆ getOutputType()

assQuestion::getOutputType ( )

Reimplemented in assMultipleChoice, and assSingleChoice.

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

578 : int
579 {
580 return $this->outputType;
581 }
assQuestion\$outputType
int $outputType
Contains the output type of a question.
Definition: class.assQuestion.php:122

◆ getOwner()

assQuestion::getOwner ( )

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

608 : int
609 {
610 return $this->owner;
611 }

◆ getPageOfQuestion()

assQuestion::getPageOfQuestion ( )

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

1797 : string
1798 {
1799 $page = new ilAssQuestionPage($this->id);
1800 return $page->getXMLContent();
1801 }

◆ getPoints()

assQuestion::getPoints ( )

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

2628 : float
2629 {
2630 if (strcmp($this->points, "") == 0) {
2631 return 0.0;
2632 }
2633
2634 return $this->points;
2635 }

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

+ Here is the caller graph for this function:

◆ getPreventRteUsage()

assQuestion::getPreventRteUsage ( )

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

3361 : bool
3362 {
3363 return $this->prevent_rte_usage;
3364 }

◆ getProcessLocker()

assQuestion::getProcessLocker ( )

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

395 : ilAssQuestionProcessLocker
396 {
397 return $this->processLocker;
398 }

References $processLocker.

Referenced by assClozeTest\saveWorkingData(), assErrorText\saveWorkingData(), assFileUpload\saveWorkingData(), assFormulaQuestion\saveWorkingData(), assMatchingQuestion\saveWorkingData(), assOrderingHorizontal\saveWorkingData(), assTextQuestion\saveWorkingData(), assTextSubset\saveWorkingData(), and assLongMenu\saveWorkingData().

+ Here is the caller graph for this function:

◆ getQuestion()

assQuestion::getQuestion ( )

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

2996 : string
2997 {
2998 return $this->question;
2999 }

Referenced by assFormulaQuestion\checkForDuplicateResults(), assFormulaQuestion\checkForDuplicateVariables(), assFormulaQuestion\getInitialVariableSolutionValues(), assFormulaQuestion\hasRequiredVariableSolutionValues(), assOrderingQuestion\isComplete(), assFormulaQuestion\parseQuestionText(), assFormulaQuestion\substituteVariables(), assClozeTest\toJSON(), assKprimChoice\toJSON(), assLongMenu\toJSON(), assMatchingQuestion\toJSON(), assOrderingHorizontal\toJSON(), assTextQuestion\toJSON(), and assTextSubset\toJSON().

+ Here is the caller graph for this function:

◆ getQuestionAction()

assQuestion::getQuestionAction ( )
protected

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

291 : string
292 {
293 if (!isset($_POST['cmd']) || !isset($_POST['cmd'][$this->questionActionCmd])) {
294 return '';
295 }
296
297 if (!is_array($_POST['cmd'][$this->questionActionCmd]) || !count($_POST['cmd'][$this->questionActionCmd])) {
298 return '';
299 }
300
301 return key($_POST['cmd'][$this->questionActionCmd]);
302 }

Referenced by assFileUpload\isFileDeletionAction().

+ Here is the caller graph for this function:

◆ getQuestionForHTMLOutput()

assQuestion::getQuestionForHTMLOutput ( )

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

3001 : string
3002 {
3003 return $this->purifyAndPrepareTextAreaOutput($this->question);
3004 }
assQuestion\purifyAndPrepareTextAreaOutput
purifyAndPrepareTextAreaOutput(string $content)
Definition: class.assQuestion.php:3006

◆ getQuestionsMissingResultRecord()

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

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

4099 : array
4100 {
4101 global $DIC;
4102 $ilDB = $DIC['ilDB'];
4103
4104 $IN_questionIds = $ilDB->in('question_fi', $questionIds, false, 'integer');
4105
4106 $query = "
4107 SELECT question_fi
4108 FROM tst_test_result
4109 WHERE active_fi = %s
4110 AND pass = %s
4111 AND $IN_questionIds
4112 ";
4113
4114 $res = $ilDB->queryF(
4115 $query,
4116 array('integer', 'integer'),
4117 array($activeId, $pass)
4118 );
4119
4120 $questionsHavingResultRecord = [];
4121
4122 while ($row = $ilDB->fetchAssoc($res)) {
4123 $questionsHavingResultRecord[] = $row['question_fi'];
4124 }
4125
4126 $questionsMissingResultRecordt = array_diff(
4127 $questionIds,
4128 $questionsHavingResultRecord
4129 );
4130
4131 return $questionsMissingResultRecordt;
4132 }

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

Referenced by ilTestOutputGUI\handlePrimaryButton().

+ Here is the caller graph for this function:

◆ getQuestionType()

assQuestion::getQuestionType ( )
abstract

Returns the question type of the question.

Returns
string The question type of the question

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

Referenced by fromXML().

+ Here is the caller graph for this function:

◆ getQuestionTypeFromDb()

static assQuestion::getQuestionTypeFromDb ( int  $question_id)
static

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

1434 : string
1435 {
1436 global $DIC;
1437 $ilDB = $DIC['ilDB'];
1438
1439 $result = $ilDB->queryF(
1440 "SELECT qpl_qst_type.type_tag FROM qpl_qst_type, qpl_questions WHERE qpl_questions.question_id = %s AND qpl_questions.question_type_fi = qpl_qst_type.question_type_id",
1441 array('integer'),
1442 array($question_id)
1443 );
1444 $data = $ilDB->fetchAssoc($result);
1445 return $data["type_tag"] ?? '';
1446 }

References $data, $DIC, and $ilDB.

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

+ Here is the caller graph for this function:

◆ getQuestionTypeID()

assQuestion::getQuestionTypeID ( )

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

3032 : int
3033 {
3034 $result = $this->db->queryF(
3035 "SELECT question_type_id FROM qpl_qst_type WHERE type_tag = %s",
3036 array('text'),
3037 array($this->getQuestionType())
3038 );
3039 if ($this->db->numRows($result) == 1) {
3040 $row = $this->db->fetchAssoc($result);
3041 return (int) $row["question_type_id"];
3042 }
3043 return 0;
3044 }

◆ getReachedPoints()

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

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

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

References ILIAS\Survey\Mode\getId().

Referenced by ilLOTestQuestionAdapter\updateQuestionResult().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ getRTETextWithMediaObjects()

assQuestion::getRTETextWithMediaObjects ( )
protected

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

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

3080 : string
3081 {
3082 // must be called in parent classes. add additional RTE text in the parent
3083 // classes and call this method to add the standard RTE text
3084 $collected = $this->getQuestion();
3085 $collected .= $this->feedbackOBJ->getGenericFeedbackContent($this->getId(), false);
3086 $collected .= $this->feedbackOBJ->getGenericFeedbackContent($this->getId(), true);
3087 $collected .= $this->feedbackOBJ->getAllSpecificAnswerFeedbackContents($this->getId());
3088
3089 foreach ($this->suggested_solutions as $solution_array) {
3090 if (is_string(['value'])) {
3091 $collected .= $solution_array["value"];
3092 }
3093 }
3094 $questionHintList = ilAssQuestionHintList::getListByQuestionId($this->getId());
3095 foreach ($questionHintList as $questionHint) {
3096 /* @var $questionHint ilAssQuestionHint */
3097 $collected .= $questionHint->getText();
3098 }
3099
3100 return $collected;
3101 }
ilAssQuestionHintList\getListByQuestionId
static getListByQuestionId($questionId)
instantiates a question hint list for the passed question id
Definition: class.ilAssQuestionHintList.php:242

References ILIAS\Survey\Mode\getId(), and ilAssQuestionHintList\getListByQuestionId().

+ Here is the call graph for this function:

◆ getSelfAssessmentEditingMode()

assQuestion::getSelfAssessmentEditingMode ( )

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

3390 : bool
3391 {
3392 return $this->selfassessmenteditingmode;
3393 }
assQuestion\$selfassessmenteditingmode
bool $selfassessmenteditingmode
Definition: class.assQuestion.php:158

Referenced by ilAssQuestionAuthoringFormGUI\addGenericAssessmentQuestionCommandButtons().

+ Here is the caller graph for this function:

◆ getSelfAssessmentFormatter()

assQuestion::getSelfAssessmentFormatter ( )
protected

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

3349 : \ilAssSelfAssessmentQuestionFormatter
3350 {
3351 return new \ilAssSelfAssessmentQuestionFormatter();
3352 }
ilAssSelfAssessmentQuestionFormatter
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
Definition: class.ilAssSelfAssessmentQuestionFormatter.php:23

◆ getShuffle()

assQuestion::getShuffle ( )

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

533 : bool
534 {
535 return $this->shuffle;
536 }
assQuestion\$shuffle
bool $shuffle
Indicates whether the answers will be shuffled or not.
Definition: class.assQuestion.php:92

Referenced by assClozeTest\toJSON(), assLongMenu\toJSON(), and assTextQuestion\toJSON().

+ Here is the caller graph for this function:

◆ getShuffler()

assQuestion::getShuffler ( )

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

380 : Transformation
381 {
382 return $this->shuffler;
383 }
assQuestion\$shuffler
Transformation $shuffler
Definition: class.assQuestion.php:173
ILIAS\Refinery\Transformation
A transformation is a function from one datatype to another.
Definition: Transformation.php:35

References $shuffler.

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

+ Here is the caller graph for this function:

◆ getSolutionMaxPass()

assQuestion::getSolutionMaxPass ( int  $active_id)

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

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

References ILIAS\Survey\Mode\getId().

Referenced by assClozeTest\calculateReachedPoints(), assErrorText\calculateReachedPoints(), assFileUpload\calculateReachedPoints(), assFlashQuestion\calculateReachedPoints(), assFormulaQuestion\calculateReachedPoints(), assKprimChoice\calculateReachedPoints(), assLongMenu\calculateReachedPoints(), assMatchingQuestion\calculateReachedPoints(), assOrderingHorizontal\calculateReachedPoints(), assTextQuestion\calculateReachedPoints(), assTextSubset\calculateReachedPoints(), assFileUpload\getUploadedFiles(), and assTextQuestion\setReachedPoints().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ getSolutionRecordById()

assQuestion::getSolutionRecordById ( int  $solutionId)
protected
Returns
array tst_solutions.*

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

3669 : array
3670 {
3671 $result = $this->db->queryF(
3672 "SELECT * FROM tst_solutions WHERE solution_id = %s",
3673 array('integer'),
3674 array($solutionId)
3675 );
3676
3677 if ($this->db->numRows($result) > 0) {
3678 return $this->db->fetchAssoc($result);
3679 }
3680 return [];
3681 }

Referenced by assFileUpload\saveWorkingData().

+ Here is the caller graph for this function:

◆ getSolutionValues()

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

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

Parameters
int | string$active_id
Returns
array Assoc result from tst_solutions.*

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

1327 : array
1328 {
1329 if ($pass === null && is_numeric($active_id)) {
1330 $pass = $this->getSolutionMaxPass((int) $active_id);
1331 }
1332
1333 if ($this->getStep() !== null) {
1334 $query = "
1335 SELECT *
1336 FROM tst_solutions
1337 WHERE active_fi = %s
1338 AND question_fi = %s
1339 AND pass = %s
1340 AND step = %s
1341 AND authorized = %s
1342 ORDER BY solution_id";
1343
1344 $result = $this->db->queryF(
1345 $query,
1346 array('integer', 'integer', 'integer', 'integer', 'integer'),
1347 array((int) $active_id, $this->getId(), $pass, $this->getStep(), (int) $authorized)
1348 );
1349 } else {
1350 $query = "
1351 SELECT *
1352 FROM tst_solutions
1353 WHERE active_fi = %s
1354 AND question_fi = %s
1355 AND pass = %s
1356 AND authorized = %s
1357 ORDER BY solution_id
1358 ";
1359
1360 $result = $this->db->queryF(
1361 $query,
1362 array('integer', 'integer', 'integer', 'integer'),
1363 array((int) $active_id, $this->getId(), $pass, (int) $authorized)
1364 );
1365 }
1366
1367 $values = [];
1368
1369 while ($row = $this->db->fetchAssoc($result)) {
1370 $values[] = $row;
1371 }
1372
1373 return $values;
1374 }
assQuestion\getSolutionMaxPass
getSolutionMaxPass(int $active_id)
Definition: class.assQuestion.php:2642

References $query, and ILIAS\Survey\Mode\getId().

Referenced by assFormulaQuestion\calculateReachedPoints(), ilTestCorrectionsGUI\getSolutions(), assFileUpload\getUserSolutionPreferingIntermediate(), assClozeTest\setExportDetailsXLS(), assErrorText\setExportDetailsXLS(), assFileUpload\setExportDetailsXLS(), assFormulaQuestion\setExportDetailsXLS(), assKprimChoice\setExportDetailsXLS(), assLongMenu\setExportDetailsXLS(), assMatchingQuestion\setExportDetailsXLS(), assNumeric\setExportDetailsXLS(), assOrderingHorizontal\setExportDetailsXLS(), assTextQuestion\setExportDetailsXLS(), and assTextSubset\setExportDetailsXLS().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ getStep()

assQuestion::getStep ( )
Returns
int|null

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

3903 : ?int
3904 {
3905 return $this->step;
3906 }

Referenced by assFormulaQuestion\lookupForExistingSolutions(), assLongMenu\lookupForExistingSolutions(), assFormulaQuestion\removeExistingSolutions(), and assFormulaQuestion\saveWorkingData().

+ Here is the caller graph for this function:

◆ getSuggestedSolution()

assQuestion::getSuggestedSolution ( int  $subquestion_index = 0)

Returns a suggested solution for a given subquestion index.

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

2153 : array
2154 {
2155 if (array_key_exists($subquestion_index, $this->suggested_solutions)) {
2156 return $this->suggested_solutions[$subquestion_index];
2157 }
2158 return [];
2159 }

◆ getSuggestedSolutionOutput()

assQuestion::getSuggestedSolutionOutput ( )
Returns
string HTML
Exceptions
ilWACException

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

718 : string
719 {
720 $output = [];
721 foreach ($this->suggested_solutions as $solution) {
722 switch ($solution["type"]) {
723 case "lm":
724 case "st":
725 case "pg":
726 case "git":
727 $output[] = '<a href="' . assQuestion::_getInternalLinkHref($solution["internal_link"]) . '">' . $this->lng->txt("solution_hint") . '</a>';
728 break;
729 case "file":
730 $possible_texts = array_values(array_filter(array(
731 ilLegacyFormElementsUtil::prepareFormOutput($solution['value']['filename']),
732 ilLegacyFormElementsUtil::prepareFormOutput($solution['value']['name']),
733 $this->lng->txt('tst_show_solution_suggested')
734 )));
735 ilWACSignedPath::setTokenMaxLifetimeInSeconds(60);
736 $output[] = '<a href="' . ilWACSignedPath::signFile($this->getSuggestedSolutionPathWeb() . $solution["value"]["name"]) . '">' . $possible_texts[0] . '</a>';
737 break;
738 case "text":
739 $solutionValue = $solution["value"];
740 $solutionValue = $this->fixSvgToPng($solutionValue);
741 $solutionValue = $this->fixUnavailableSkinImageSources($solutionValue);
742 $output[] = $this->prepareTextareaOutput($solutionValue, true);
743 break;
744 }
745 }
746 return implode("<br />", $output);
747 }
assQuestion\fixSvgToPng
fixSvgToPng(string $imageFilenameContainingString)
Definition: class.assQuestion.php:1865
assQuestion\prepareTextareaOutput
prepareTextareaOutput(string $txt_output, bool $prepare_for_latex_output=false, bool $omitNl2BrWhenTextArea=false)
Definition: class.assQuestion.php:2827
assQuestion\fixUnavailableSkinImageSources
fixUnavailableSkinImageSources(string $html)
Definition: class.assQuestion.php:1872
assQuestion\_getInternalLinkHref
static _getInternalLinkHref(string $target="")
Definition: class.assQuestion.php:2438
ilLegacyFormElementsUtil\prepareFormOutput
static prepareFormOutput($a_str, bool $a_strip=false)
Definition: class.ilLegacyFormElementsUtil.php:38
ilWACSignedPath\setTokenMaxLifetimeInSeconds
static setTokenMaxLifetimeInSeconds(int $token_max_lifetime_in_seconds)
Definition: class.ilWACSignedPath.php:346
ilWACSignedPath\signFile
static signFile(string $path_to_file)
Definition: class.ilWACSignedPath.php:215

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

+ Here is the call graph for this function:

◆ getSuggestedSolutionPath()

assQuestion::getSuggestedSolutionPath ( )

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

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

References CLIENT_WEB_DIR.

◆ getSuggestedSolutionPathWeb()

assQuestion::getSuggestedSolutionPathWeb ( )

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

1273 : string
1274 {
1275 $webdir = ilFileUtils::removeTrailingPathSeparators(CLIENT_WEB_DIR) . "/assessment/$this->obj_id/$this->id/solution/";
1276 return str_replace(
1277 ilFileUtils::removeTrailingPathSeparators(ILIAS_ABSOLUTE_PATH),
1278 ilFileUtils::removeTrailingPathSeparators(ILIAS_HTTP_PATH),
1279 $webdir
1280 );
1281 }

References CLIENT_WEB_DIR, and ilFileUtils\removeTrailingPathSeparators().

+ Here is the call graph for this function:

◆ getSuggestedSolutions()

assQuestion::getSuggestedSolutions ( )
Returns
string[] HTML

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

783 : array
784 {
785 return $this->suggested_solutions;
786 }
assQuestion\$suggested_solutions
array $suggested_solutions
Definition: class.assQuestion.php:129

◆ getSuggestedSolutionTitle()

assQuestion::getSuggestedSolutionTitle ( int  $subquestion_index = 0)

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

This can be usable for displaying suggested solutions

Parameters
integer$subquestion_indexThe index of a subquestion (i.e. a close test gap). Usually 0
Returns
string A string containing the type and title of the internal link

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

2168 : string
2169 {
2170 if (array_key_exists($subquestion_index, $this->suggested_solutions)) {
2171 $title = $this->suggested_solutions[$subquestion_index]["internal_link"];
2172 // TO DO: resolve internal link an get link type and title
2173 } else {
2174 $title = "";
2175 }
2176 return $title;
2177 }

◆ getTestId()

assQuestion::getTestId ( )

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

538 : int
539 {
540 return $this->test_id;
541 }

◆ getTestOutputSolutions()

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

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

1302 : array
1303 {
1304 if ($this->getTestPresentationConfig()->isSolutionInitiallyPrefilled()) {
1305 return $this->getSolutionValues($activeId, $pass, true);
1306 }
1307 return $this->getUserSolutionPreferingIntermediate($activeId, $pass);
1308 }
assQuestion\getUserSolutionPreferingIntermediate
getUserSolutionPreferingIntermediate(int $active_id, $pass=null)
Definition: class.assQuestion.php:1311

◆ getTestPresentationConfig()

assQuestion::getTestPresentationConfig ( )

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

4201 : ilTestQuestionConfig
4202 {
4203 if ($this->testQuestionConfigInstance === null) {
4204 $this->testQuestionConfigInstance = $this->buildTestPresentationConfig();
4205 }
4206
4207 return $this->testQuestionConfigInstance;
4208 }
assQuestion\buildTestPresentationConfig
buildTestPresentationConfig()
build basic test question configuration instance
Definition: class.assQuestion.php:4216
assQuestion\$testQuestionConfigInstance
ilTestQuestionConfig $testQuestionConfigInstance
Definition: class.assQuestion.php:4199

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

+ Here is the caller graph for this function:

◆ getThumbSize()

assQuestion::getThumbSize ( )

Reimplemented in assKprimChoice, and assMatchingQuestion.

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

553 : int
554 {
555 return $this->thumb_size;
556 }

Referenced by assMultipleChoice\generateThumbForFile(), assSingleChoice\generateThumbForFile(), assMultipleChoice\rebuildThumbnails(), and assSingleChoice\rebuildThumbnails().

+ Here is the caller graph for this function:

◆ getTitle()

assQuestion::getTitle ( )

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

513 : string
514 {
515 return $this->title;
516 }

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

+ Here is the caller graph for this function:

◆ getTitleFilenameCompliant()

assQuestion::getTitleFilenameCompliant ( )

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

523 : string
524 {
525 return ilFileUtils::getASCIIFilename($this->getTitle());
526 }
ilFileUtils\getASCIIFilename
static getASCIIFilename(string $a_filename)
Definition: class.ilFileUtils.php:812

References ilFileUtils\getASCIIFilename().

+ Here is the call graph for this function:

◆ getTitleForHTMLOutput()

assQuestion::getTitleForHTMLOutput ( )

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

518 : string
519 {
520 return $this->refinery->string()->stripTags()->transform($this->title);
521 }

References ILIAS\Repository\refinery().

Referenced by assClozeTest\toJSON(), assKprimChoice\toJSON(), assLongMenu\toJSON(), assMatchingQuestion\toJSON(), assOrderingHorizontal\toJSON(), assTextQuestion\toJSON(), and assTextSubset\toJSON().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ getTotalAnswers()

assQuestion::getTotalAnswers ( )

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

1645 : int
1646 {
1647 // get all question references to the question id
1648 $result = $this->db->queryF(
1649 "SELECT question_id FROM qpl_questions WHERE original_id = %s OR question_id = %s",
1650 array('integer','integer'),
1651 array($this->id, $this->id)
1652 );
1653 if ($this->db->numRows($result) == 0) {
1654 return 0;
1655 }
1656 $found_id = [];
1657 while ($row = $this->db->fetchAssoc($result)) {
1658 $found_id[] = $row["question_id"];
1659 }
1660
1661 $result = $this->db->query("SELECT * FROM tst_test_result WHERE " . $this->db->in('question_fi', $found_id, false, 'integer'));
1662
1663 return $this->db->numRows($result);
1664 }

◆ getUserSolutionPreferingIntermediate()

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

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

1311 : array
1312 {
1313 $solution = $this->getSolutionValues($active_id, $pass, false);
1314
1315 if (!count($solution)) {
1316 $solution = $this->getSolutionValues($active_id, $pass, true);
1317 }
1318
1319 return $solution;
1320 }

◆ getValidAdditionalContentEditingModes()

assQuestion::getValidAdditionalContentEditingModes ( )

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

3574 : array
3575 {
3576 return array(
3577 self::ADDITIONAL_CONTENT_EDITING_MODE_RTE,
3578 self::ADDITIONAL_CONTENT_EDITING_MODE_IPE
3579 );
3580 }

◆ hasSpecificFeedback()

assQuestion::hasSpecificFeedback ( )

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

3179 : bool
3180 {
3181 return static::HAS_SPECIFIC_FEEDBACK;
3182 }

◆ implodeKeyValues()

static assQuestion::implodeKeyValues ( array  $keyValues)
static

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

3798 : string
3799 {
3800 return implode(assQuestion::KEY_VALUES_IMPLOSION_SEPARATOR, $keyValues);
3801 }

References KEY_VALUES_IMPLOSION_SEPARATOR.

Referenced by assImagemapQuestionGUI\buildSelectionParameter().

+ Here is the caller graph for this function:

◆ includeCoreClass()

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

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

3201 : void
3202 {
3203 if ($withGuiClass) {
3204 // object class is included by gui classes constructor
3205 } else {
3206 }
3207
3208 $feedbackClassName = self::getFeedbackClassNameByQuestionType($questionType);
3209 }
assQuestion\getFeedbackClassNameByQuestionType
static getFeedbackClassNameByQuestionType(string $questionType)
Definition: class.assQuestion.php:3191

◆ instantiateQuestion()

static assQuestion::instantiateQuestion ( int  $question_id)
static
Parameters
int$question_id
Returns
assQuestion
Exceptions
InvalidArgumentException

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

2606 : assQuestion
2607 {
2608 global $DIC;
2609 $ilCtrl = $DIC['ilCtrl'];
2610 $ilDB = $DIC['ilDB'];
2611 $lng = $DIC['lng'];
2612
2613 $question_type = assQuestion::_getQuestionType($question_id);
2614 if ($question_type === '') {
2615 throw new InvalidArgumentException('No question with ID ' . $question_id . ' exists');
2616 }
2617
2618 assQuestion::_includeClass($question_type);
2619 $question = new $question_type();
2620 $question->loadFromDb($question_id);
2621
2622 $feedbackObjectClassname = self::getFeedbackClassNameByQuestionType($question_type);
2623 $question->feedbackOBJ = new $feedbackObjectClassname($question, $ilCtrl, $ilDB, $lng);
2624
2625 return $question;
2626 }
assQuestion\_includeClass
static _includeClass(string $question_type, int $gui=0)
Definition: class.assQuestion.php:3184

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

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

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ instantiateQuestionGUI()

static assQuestion::instantiateQuestionGUI ( int  $a_question_id)
static

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

3237 : assQuestionGUI
3238 {
3239 //Shouldn't you live in assQuestionGUI, Mister?
3240
3241 global $DIC;
3242 $ilCtrl = $DIC['ilCtrl'];
3243 $ilDB = $DIC['ilDB'];
3244 $lng = $DIC['lng'];
3245 $ilUser = $DIC['ilUser'];
3246
3247 if (strcmp($a_question_id, "") != 0) {
3248 $question_type = assQuestion::_getQuestionType($a_question_id);
3249
3250 assQuestion::_includeClass($question_type, 1);
3251
3252 $question_type_gui = $question_type . 'GUI';
3253 $question_gui = new $question_type_gui();
3254 $question_gui->object->loadFromDb($a_question_id);
3255
3256 $feedbackObjectClassname = self::getFeedbackClassNameByQuestionType($question_type);
3257 $question_gui->object->feedbackOBJ = new $feedbackObjectClassname($question_gui->object, $ilCtrl, $ilDB, $lng);
3258
3259 $assSettings = new ilSetting('assessment');
3260 $processLockerFactory = new ilAssQuestionProcessLockerFactory($assSettings, $ilDB);
3261 $processLockerFactory->setQuestionId($question_gui->object->getId());
3262 $processLockerFactory->setUserId($ilUser->getId());
3263 $processLockerFactory->setAssessmentLogEnabled(ilObjAssessmentFolder::_enabledAssessmentLogging());
3264 $question_gui->object->setProcessLocker($processLockerFactory->getLocker());
3265 } else {
3266 global $DIC;
3267 $ilLog = $DIC['ilLog'];
3268 $ilLog->write('Instantiate question called without question id. (instantiateQuestionGUI@assQuestion)', $ilLog->WARNING);
3269 throw new InvalidArgumentException('Instantiate question called without question id. (instantiateQuestionGUI@assQuestion)');
3270 }
3271 return $question_gui;
3272 }
ilSetting
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
Definition: class.ilSetting.php:27

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

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

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ intermediateSolutionExists()

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

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

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

Referenced by assFileUpload\saveWorkingData().

+ Here is the caller graph for this function:

◆ isAddableAnswerOptionValue()

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

Reimplemented in assClozeTest, and assTextSubset.

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

4004 : bool
4005 {
4006 return false;
4007 }

◆ isAdditionalContentEditingModePageObject()

assQuestion::isAdditionalContentEditingModePageObject ( )

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

3560 : bool
3561 {
3562 return $this->getAdditionalContentEditingMode() == assQuestion::ADDITIONAL_CONTENT_EDITING_MODE_IPE;
3563 }
assQuestion\ADDITIONAL_CONTENT_EDITING_MODE_IPE
const ADDITIONAL_CONTENT_EDITING_MODE_IPE
Definition: class.assQuestion.php:150

References ADDITIONAL_CONTENT_EDITING_MODE_IPE.

Referenced by assClozeTest\getClozeTextForHTMLOutput().

+ Here is the caller graph for this function:

◆ isAllowedImageFileExtension()

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

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

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

Referenced by ilQtiMatImageSecurity\validateLabel().

+ Here is the caller graph for this function:

◆ isAllowedImageMimeType()

static assQuestion::isAllowedImageMimeType (   $mimeType)
static

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

248 : bool
249 {
250 return (bool) count(self::getAllowedFileExtensionsForMimeType($mimeType));
251 }

Referenced by ilQtiMatImageSecurity\validateContent().

+ Here is the caller graph for this function:

◆ isAnswered()

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

Reimplemented in assFileUpload, assKprimChoice, assMultipleChoice, assSingleChoice, and assTextQuestion.

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

3505 : bool
3506 {
3507 return true;
3508 }

◆ isAutosaveable()

assQuestion::isAutosaveable ( )

Reimplemented in assFileUpload, assFlashQuestion, and assImagemapQuestion.

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

3515 : bool
3516 {
3517 return true;
3518 }

◆ isClone()

assQuestion::isClone ( int  $question_id = 0)

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

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

1420 : bool
1421 {
1422 if ($question_id < 1) {
1423 $question_id = $this->id;
1424 }
1425 $result = $this->db->queryF(
1426 "SELECT COUNT(original_id) cnt FROM qpl_questions WHERE question_id = %s",
1427 array('integer'),
1428 array($question_id)
1429 );
1430 $row = $this->db->fetchAssoc($result);
1431 return ((int) $row["cnt"]) > 0;
1432 }

References $id.

◆ isComplete()

assQuestion::isComplete ( )

Returns true, if a question is complete for use.

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

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

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

449 : bool
450 {
451 return false;
452 }

◆ isCoreQuestionType()

static assQuestion::isCoreQuestionType ( string  $questionType)
static

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

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

◆ isDummySolutionRecord()

assQuestion::isDummySolutionRecord ( array  $solutionRecord)
protected

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

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

Referenced by assFileUpload\calculateReachedPoints().

+ Here is the caller graph for this function:

◆ isFileAvailable()

static assQuestion::isFileAvailable ( string  $file)
static

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

1741 : bool
1742 {
1743 if (!file_exists($file)) {
1744 return false;
1745 }
1746
1747 if (!is_file($file)) {
1748 return false;
1749 }
1750
1751 if (!is_readable($file)) {
1752 return false;
1753 }
1754
1755 return true;
1756 }

Referenced by assMatchingQuestion\copyImages().

+ Here is the caller graph for this function:

◆ isForcePassResultUpdateEnabled()

static assQuestion::isForcePassResultUpdateEnabled ( )
static

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

243 : bool
244 {
245 return self::$forcePassResultsUpdateEnabled;
246 }
assQuestion\$forcePassResultsUpdateEnabled
static $forcePassResultsUpdateEnabled
Definition: class.assQuestion.php:236

References $forcePassResultsUpdateEnabled.

◆ isHTML()

assQuestion::isHTML (   $a_text)

Checks if a given string contains HTML or not.

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

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

2819 : bool
2820 {
2821 return ilUtil::isHTML($a_text);
2822 }
ilUtil\isHTML
static isHTML(string $a_text)
Checks if a given string contains HTML or not.
Definition: class.ilUtil.php:1169

References ilUtil\isHTML().

+ Here is the call graph for this function:

◆ isInActiveTest()

assQuestion::isInActiveTest ( )

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

4229 : bool
4230 {
4231 $query = 'SELECT user_fi FROM tst_active ' . PHP_EOL
4232 . 'JOIN tst_test_question ON tst_test_question.test_fi = tst_active.test_fi ' . PHP_EOL
4233 . 'JOIN qpl_questions ON qpl_questions.question_id = tst_test_question.question_fi ' . PHP_EOL
4234 . 'WHERE qpl_questions.obj_fi = ' . $this->db->quote($this->getObjId(), 'integer');
4235
4236 $res = $this->db->query($query);
4237 return $res->numRows() > 0;
4238 }

References $query, and $res.

◆ isInUse()

assQuestion::isInUse ( int  $question_id = 0)

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

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

1379 : bool
1380 {
1381 return $this->usageNumber($question_id) > 0;
1382 }
assQuestion\usageNumber
usageNumber(int $question_id=0)
Returns the number of place the question is in use in pools or tests.
Definition: class.assQuestion.php:1387

◆ isNonEmptyItemListPostSubmission()

assQuestion::isNonEmptyItemListPostSubmission ( string  $postSubmissionFieldname)
protected

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

304 : bool
305 {
306 if (!isset($_POST[$postSubmissionFieldname])) {
307 return false;
308 }
309
310 if (!is_array($_POST[$postSubmissionFieldname])) {
311 return false;
312 }
313
314 if (!count($_POST[$postSubmissionFieldname])) {
315 return false;
316 }
317
318 return true;
319 }

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

+ Here is the caller graph for this function:

◆ isObligationPossible()

static assQuestion::isObligationPossible ( int  $questionId)
static

Reimplemented in assFileUpload, assKprimChoice, assSingleChoice, and assTextQuestion.

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

3510 : bool
3511 {
3512 return false;
3513 }

◆ isPreviewSolutionCorrect()

assQuestion::isPreviewSolutionCorrect ( ilAssQuestionPreviewSession  $previewSession)

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

2748 : bool
2749 {
2750 $reachedPoints = $this->calculateReachedPointsFromPreviewSession($previewSession);
2751
2752 return !($reachedPoints < $this->getMaximumPoints());
2753 }
assQuestion\calculateReachedPointsFromPreviewSession
calculateReachedPointsFromPreviewSession(ilAssQuestionPreviewSession $previewSession)
Definition: class.assQuestion.php:2735

◆ isValidAdditionalContentEditingMode()

assQuestion::isValidAdditionalContentEditingMode ( string  $additionalContentEditingMode)

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

3565 : bool
3566 {
3567 if (in_array($additionalContentEditingMode, $this->getValidAdditionalContentEditingModes())) {
3568 return true;
3569 }
3570
3571 return false;
3572 }
assQuestion\getValidAdditionalContentEditingModes
getValidAdditionalContentEditingModes()
Definition: class.assQuestion.php:3574

◆ lmMigrateQuestionTypeGenericContent()

assQuestion::lmMigrateQuestionTypeGenericContent ( ilAssSelfAssessmentMigrator  $migrator)
protected

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

3375 : void
3376 {
3377 $this->setQuestion($migrator->migrateToLmContent($this->getQuestion()));
3378 }

References ilAssSelfAssessmentMigrator\migrateToLmContent().

+ Here is the call graph for this function:

◆ lmMigrateQuestionTypeSpecificContent()

assQuestion::lmMigrateQuestionTypeSpecificContent ( ilAssSelfAssessmentMigrator  $migrator)
protected

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

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

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

◆ loadFromDb()

assQuestion::loadFromDb ( int  $question_id)

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

1909 : void
1910 {
1911 $result = $this->db->queryF(
1912 'SELECT external_id FROM qpl_questions WHERE question_id = %s',
1913 ['integer'],
1914 [$question_id]
1915 );
1916 if ($this->db->numRows($result) === 1) {
1917 $data = $this->db->fetchAssoc($result);
1918 $this->external_id = $data['external_id'];
1919 }
1920
1921 $result = $this->db->queryF(
1922 "SELECT internal_link, import_id, subquestion_index, type, value" .
1923 " FROM qpl_sol_sug WHERE question_fi = %s",
1924 ["integer"],
1925 [$this->getId()]
1926 );
1927
1928 $suggestedSolutions = [];
1929
1930 while ($row = $this->db->fetchAssoc($result)) {
1931 $value = $row["value"];
1932
1933 try {
1934 $unserializedValue = unserialize($value, ['allowed_classes' => false]);
1935 if (is_array($unserializedValue)) {
1936 $value = $unserializedValue;
1937 }
1938 } catch (Exception $ex) {
1939 }
1940
1941 if (is_string($value)) {
1942 $value = ilRTE::_replaceMediaObjectImageSrc($value, 1);
1943 }
1944
1945 $suggestedSolutions[$row["subquestion_index"]] = [
1946 "type" => $row["type"],
1947 "value" => $value,
1948 "internal_link" => $row["internal_link"],
1949 "import_id" => $row["import_id"]
1950 ];
1951 }
1952 $this->suggested_solutions = $suggestedSolutions;
1953 }

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

+ Here is the call graph for this function:

◆ loadSuggestedSolution()

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

Returns a suggested solution for a given subquestion index.

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

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

763 : array
764 {
765 $result = $this->db->queryF(
766 "SELECT * FROM qpl_sol_sug WHERE question_fi = %s AND subquestion_index = %s",
767 array('integer','integer'),
768 array($question_id, $subquestion_index)
769 );
770 if ($this->db->numRows($result) == 1) {
771 $row = $this->db->fetchAssoc($result);
772 return array(
773 "internal_link" => $row["internal_link"],
774 "import_id" => $row["import_id"]
775 );
776 }
777 return [];
778 }

◆ log()

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

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

358 : void
359 {
360 if (ilObjAssessmentFolder::_enabledAssessmentLogging()) {
361 $message = $this->lng->txtlng('assessment', $langVar, ilObjAssessmentFolder::_getLogLanguage());
362 assQuestion::logAction($message, $active_id, $this->getId());
363 }
364 }
$message
$message
Definition: xapiexit.php:32

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

+ Here is the call graph for this function:

◆ logAction()

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

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

1199 : void
1200 {
1201 $original_id = self::_getOriginalId($question_id);
1202
1203 ilObjAssessmentFolder::_addLog(
1204 $GLOBALS['DIC']['ilUser']->getId(),
1205 ilObjTest::_getObjectIDFromActiveID($active_id),
1206 $logtext,
1207 $question_id,
1208 $original_id
1209 );
1210 }
$GLOBALS
if(!defined('PATH_SEPARATOR')) $GLOBALS['_PEAR_default_error_mode']
Definition: PEAR.php:64
assQuestion\_getOriginalId
static _getOriginalId(int $question_id)
Definition: class.assQuestion.php:2470
ilObjAssessmentFolder\_addLog
static _addLog( $user_id, $object_id, $logtext, $question_id=0, $original_id=0, $test_only=false, $test_ref_id=0)
Add an assessment log entry.
Definition: class.ilObjAssessmentFolder.php:230
ilObjTest\_getObjectIDFromActiveID
static _getObjectIDFromActiveID($active_id)
Returns the ILIAS test object id for a given active id.
Definition: class.ilObjTest.php:6497

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

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

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ lookupCurrentTestPass()

assQuestion::lookupCurrentTestPass ( int  $active_id,
int  $pass 
)
protected
Deprecated:
Use ilObjTest::_getPass($active_id) instead @removal ILIAS 9

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

334 : int
335 {
336 return \ilObjTest::_getPass($active_id);
337 }

Referenced by ensureCurrentTestPass().

+ 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]

Reimplemented in assFormulaQuestion, and assLongMenu.

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

3968 : array
3969 {
3970 $return = array(
3971 'authorized' => false,
3972 'intermediate' => false
3973 );
3974
3975 $query = "
3976 SELECT authorized, COUNT(*) cnt
3977 FROM tst_solutions
3978 WHERE active_fi = %s
3979 AND question_fi = %s
3980 AND pass = %s
3981 ";
3982
3983 if ($this->getStep() !== null) {
3984 $query .= " AND step = " . $this->db->quote((int) $this->getStep(), 'integer') . " ";
3985 }
3986
3987 $query .= "
3988 GROUP BY authorized
3989 ";
3990
3991 $result = $this->db->queryF($query, array('integer', 'integer', 'integer'), array($activeId, $this->getId(), $pass));
3992
3993 while ($row = $this->db->fetchAssoc($result)) {
3994 if ($row['authorized']) {
3995 $return['authorized'] = $row['cnt'] > 0;
3996 } else {
3997 $return['intermediate'] = $row['cnt'] > 0;
3998 }
3999 }
4000 return $return;
4001 }

References $query, and ILIAS\Survey\Mode\getId().

+ Here is the call graph for this function:

◆ lookupMaxStep()

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

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

3950 : int
3951 {
3952 $result = $this->db->queryF(
3953 "SELECT MAX(step) max_step FROM tst_solutions WHERE active_fi = %s AND pass = %s AND question_fi = %s",
3954 array("integer", "integer", "integer"),
3955 array($active_id, $pass, $this->getId())
3956 );
3957
3958 $row = $this->db->fetchAssoc($result);
3959
3960 return (int) $row['max_step'];
3961 }

References ILIAS\Survey\Mode\getId().

+ Here is the call graph for this function:

◆ lookupOriginalParentObjId()

static assQuestion::lookupOriginalParentObjId ( int  $originalQuestionId)
static

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

Deprecated:
: use assQuestion::lookupParentObjId() instead

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

3426 : int
3427 {
3428 return self::lookupParentObjId($originalQuestionId);
3429 }
assQuestion\lookupParentObjId
static lookupParentObjId(int $questionId)
Definition: class.assQuestion.php:3407

◆ lookupParentObjId()

static assQuestion::lookupParentObjId ( int  $questionId)
static

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

3407 : int
3408 {
3409 global $DIC;
3410 $ilDB = $DIC['ilDB'];
3411
3412 $query = "SELECT obj_fi FROM qpl_questions WHERE question_id = %s";
3413
3414 $res = $ilDB->queryF($query, array('integer'), array($questionId));
3415 $row = $ilDB->fetchAssoc($res);
3416
3417 return $row['obj_fi'];
3418 }

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

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

+ Here is the caller graph for this function:

◆ lookupResultRecordExist()

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

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

4134 : bool
4135 {
4136 global $DIC;
4137 $ilDB = $DIC['ilDB'];
4138
4139 $query = "
4140 SELECT COUNT(*) cnt
4141 FROM tst_test_result
4142 WHERE active_fi = %s
4143 AND question_fi = %s
4144 AND pass = %s
4145 ";
4146
4147 $row = $ilDB->fetchAssoc($ilDB->queryF($query, array('integer', 'integer', 'integer'), array($activeId, $questionId, $pass)));
4148
4149 return $row['cnt'] > 0;
4150 }

References $DIC, $ilDB, and $query.

◆ lookupTestId()

assQuestion::lookupTestId ( int  $active_id)
protected

@refactor Move to ilObjTest or similar

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

342 : int
343 {
344 $result = $this->db->queryF(
345 "SELECT test_fi FROM tst_active WHERE active_id = %s",
346 array('integer'),
347 array($active_id)
348 );
349 $test_id = -1;
350 if ($this->db->numRows($result) > 0) {
351 $row = $this->db->fetchAssoc($result);
352 $test_id = (int) $row["test_fi"];
353 }
354
355 return $test_id;
356 }

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

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

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ migrateContentForLearningModule()

assQuestion::migrateContentForLearningModule ( ilAssSelfAssessmentMigrator  $migrator)

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

3366 : void
3367 {
3368 $this->lmMigrateQuestionTypeGenericContent($migrator);
3369 $this->lmMigrateQuestionTypeSpecificContent($migrator);
3370 $this->saveToDb();
3371
3372 $this->feedbackOBJ->migrateContentForLearningModule($migrator, $this->getId());
3373 }
assQuestion\lmMigrateQuestionTypeGenericContent
lmMigrateQuestionTypeGenericContent(ilAssSelfAssessmentMigrator $migrator)
Definition: class.assQuestion.php:3375
assQuestion\lmMigrateQuestionTypeSpecificContent
lmMigrateQuestionTypeSpecificContent(ilAssSelfAssessmentMigrator $migrator)
Definition: class.assQuestion.php:3380

References ILIAS\Survey\Mode\getId().

Referenced by ilAssSelfAssessmentQuestionFormatter\prepareQuestionForLearningModule().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ missingResultRecordExists()

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

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

4075 : bool
4076 {
4077 global $DIC;
4078 $ilDB = $DIC['ilDB'];
4079
4080 $IN_questionIds = $ilDB->in('question_fi', $questionIds, false, 'integer');
4081
4082 $query = "
4083 SELECT COUNT(*) cnt
4084 FROM tst_test_result
4085 WHERE active_fi = %s
4086 AND pass = %s
4087 AND $IN_questionIds
4088 ";
4089
4090 $row = $ilDB->fetchAssoc($ilDB->queryF(
4091 $query,
4092 array('integer', 'integer'),
4093 array($activeId, $pass)
4094 ));
4095
4096 return $row['cnt'] < count($questionIds);
4097 }

References $DIC, $ilDB, and $query.

◆ moveUploadedMediaFile()

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

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

Parameters
string$fileFile path
string$nameName of the file
Returns
string|bool Tempname or false

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

1220 {
1221 $mediatempdir = CLIENT_WEB_DIR . "/assessment/temp";
1222 if (!@is_dir($mediatempdir)) {
1223 ilFileUtils::createDirectory($mediatempdir);
1224 }
1225 $temp_name = tempnam($mediatempdir, $name . "_____");
1226 $temp_name = str_replace("\\", "/", $temp_name);
1227 @unlink($temp_name);
1228 if (!ilFileUtils::moveUploadedFile($file, $name, $temp_name)) {
1229 return false;
1230 }
1231 return $temp_name;
1232 }
ilFileUtils\createDirectory
static createDirectory(string $a_dir, int $a_mod=0755)
create directory
Definition: class.ilFileUtils.php:794
ilFileUtils\moveUploadedFile
static moveUploadedFile(string $a_file, string $a_name, string $a_target, bool $a_raise_errors=true, string $a_mode="move_uploaded")
move uploaded file
Definition: class.ilFileUtils.php:504
$name
if($format !==null) $name
Definition: metadata.php:247

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

+ Here is the call graph for this function:

◆ onCopy()

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

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

2123 : void
2124 {
2125 $this->copySuggestedSolutionFiles($sourceParentId, $sourceQuestionId);
2126
2127 // duplicate question feeback
2128 $this->feedbackOBJ->duplicateFeedback($sourceQuestionId, $targetQuestionId);
2129
2130 // duplicate question hints
2131 $this->duplicateQuestionHints($sourceQuestionId, $targetQuestionId);
2132
2133 // duplicate skill assignments
2134 $this->duplicateSkillAssignments($sourceParentId, $sourceQuestionId, $targetParentId, $targetQuestionId);
2135 }
assQuestion\copySuggestedSolutionFiles
copySuggestedSolutionFiles(int $source_questionpool_id, int $source_question_id)
Definition: class.assQuestion.php:2261
assQuestion\duplicateQuestionHints
duplicateQuestionHints(int $originalQuestionId, int $duplicateQuestionId)
Definition: class.assQuestion.php:3431
assQuestion\duplicateSkillAssignments
duplicateSkillAssignments(int $srcParentId, int $srcQuestionId, int $trgParentId, int $trgQuestionId)
Definition: class.assQuestion.php:3450

◆ onDuplicate()

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

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

2106 : void
2107 {
2108 $this->duplicateSuggestedSolutionFiles($originalParentId, $originalQuestionId);
2109 $this->feedbackOBJ->duplicateFeedback($originalQuestionId, $duplicateQuestionId);
2110 $this->duplicateQuestionHints($originalQuestionId, $duplicateQuestionId);
2111 $this->duplicateSkillAssignments($originalParentId, $originalQuestionId, $duplicateParentId, $duplicateQuestionId);
2112 }
assQuestion\duplicateSuggestedSolutionFiles
duplicateSuggestedSolutionFiles(int $parent_id, int $question_id)
Duplicates the files of a suggested solution if the question is duplicated.
Definition: class.assQuestion.php:2206

◆ originalQuestionExists()

static assQuestion::originalQuestionExists ( int  $questionId)
static

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

2491 : bool
2492 {
2493 global $DIC;
2494 $ilDB = $DIC['ilDB'];
2495
2496 $query = "
2497 SELECT COUNT(dupl.question_id) cnt
2498 FROM qpl_questions dupl
2499 INNER JOIN qpl_questions orig
2500 ON orig.question_id = dupl.original_id
2501 WHERE dupl.question_id = %s
2502 ";
2503
2504 $res = $ilDB->queryF($query, array('integer'), array($questionId));
2505 $row = $ilDB->fetchAssoc($res);
2506
2507 return $row['cnt'] > 0;
2508 }

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

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

+ Here is the caller graph for this function:

◆ persistPreviewState()

assQuestion::persistPreviewState ( ilAssQuestionPreviewSession  $previewSession)
final

persists the preview state for current user and question

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

967 : bool
968 {
969 $this->savePreviewData($previewSession);
970 return $this->validateSolutionSubmit();
971 }
assQuestion\savePreviewData
savePreviewData(ilAssQuestionPreviewSession $previewSession)
Definition: class.assQuestion.php:988

◆ persistWorkingState()

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

persists the working state for current testactive and testpass

Returns
bool if saving happened

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

937 : bool
938 {
939 if (!$this->validateSolutionSubmit() && !$this->savePartial()) {
940 return false;
941 }
942
943 $saveStatus = false;
944
945 $this->getProcessLocker()->executePersistWorkingStateLockOperation(function () use ($active_id, $pass, $authorized, $obligationsEnabled, &$saveStatus) {
946 if ($pass === null) {
947 $pass = ilObjTest::_getPass($active_id);
948 }
949
950 $saveStatus = $this->saveWorkingData($active_id, $pass, $authorized);
951
952 if ($authorized) {
953 // fau: testNav - remove an intermediate solution if the authorized solution is saved
954 // the intermediate solution would set the displayed question status as "editing ..."
955 $this->removeIntermediateSolution($active_id, $pass);
956 // fau.
957 $this->calculateResultsFromSolution($active_id, $pass, $obligationsEnabled);
958 }
959 });
960
961 return $saveStatus;
962 }
assQuestion\calculateResultsFromSolution
calculateResultsFromSolution(int $active_id, int $pass, bool $obligationsEnabled=false)
Calculates the question results from a previously saved question solution.
Definition: class.assQuestion.php:841
assQuestion\removeIntermediateSolution
removeIntermediateSolution(int $active_id, int $pass)
Definition: class.assQuestion.php:3684
assQuestion\saveWorkingData
saveWorkingData(int $active_id, int $pass, bool $authorized=true)
Saves the learners input of the question to the database.
ilObjTest\_getPass
static _getPass($active_id)
Retrieves the actual pass of a given user for a given test.
Definition: class.ilObjTest.php:7225

References ilObjTest\_getPass().

+ Here is the call graph for this function:

◆ prepareTextareaOutput()

assQuestion::prepareTextareaOutput ( string  $txt_output,
bool  $prepare_for_latex_output = false,
bool  $omitNl2BrWhenTextArea = false 
)
Deprecated:
use ilUtil::prepareTextareaOutput() (or successor) instead

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

2828 {
2829 return ilLegacyFormElementsUtil::prepareTextareaOutput(
2830 $txt_output,
2831 $prepare_for_latex_output,
2832 $omitNl2BrWhenTextArea
2833 );
2834 }
ilLegacyFormElementsUtil\prepareTextareaOutput
static prepareTextareaOutput(string $txt_output, bool $prepare_for_latex_output=false, bool $omitNl2BrWhenTextArea=false)
Prepares a string for a text area output where latex code may be in it If the text is HTML-free,...
Definition: class.ilLegacyFormElementsUtil.php:110

References ilLegacyFormElementsUtil\prepareTextareaOutput().

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

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ purifyAndPrepareTextAreaOutput()

assQuestion::purifyAndPrepareTextAreaOutput ( string  $content)
protected

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

3006 : string
3007 {
3008 $purified_content = $this->getHtmlQuestionContentPurifier()->purify($content);
3009 if ($this->isAdditionalContentEditingModePageObject()
3010 || !(new ilSetting('advanced_editing'))->get('advanced_editing_javascript_editor') === 'tinymce') {
3011 $purified_content = nl2br($purified_content);
3012 }
3013 return $this->prepareTextareaOutput(
3014 $purified_content,
3015 true,
3016 true
3017 );
3018 }

Referenced by assFormulaQuestion\substituteVariables().

+ Here is the caller graph for this function:

◆ QTIMaterialToString()

assQuestion::QTIMaterialToString ( ilQTIMaterial  $a_material)

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

Returns
string text or xhtml string

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

2840 : string
2841 {
2842 $result = "";
2843 $mobs = ilSession::get('import_mob_xhtml') ?? [];
2844 for ($i = 0; $i < $a_material->getMaterialCount(); $i++) {
2845 $material = $a_material->getMaterial($i);
2846 if (strcmp($material["type"], "mattext") == 0) {
2847 $result .= $material["material"]->getContent();
2848 }
2849 if (strcmp($material["type"], "matimage") == 0) {
2850 $matimage = $material["material"];
2851 if (preg_match("/(il_([0-9]+)_mob_([0-9]+))/", $matimage->getLabel(), $matches)) {
2852 $mobs[] = [
2853 "mob" => $matimage->getLabel(),
2854 "uri" => $matimage->getUri()
2855 ];
2856 }
2857 }
2858 }
2859 ilSession::set('import_mob_xhtml', $mobs);
2860 return $result;
2861 }
ilQTIMaterial\getMaterial
getMaterial(int $a_index)
Definition: class.ilQTIMaterial.php:63
ilSession\get
static get(string $a_var)
Definition: class.ilSession.php:459
ilSession\set
static set(string $a_var, $a_val)
Set a value.
Definition: class.ilSession.php:451
$i
$i
Definition: metadata.php:41

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

+ Here is the call graph for this function:

◆ questionTitleExists()

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

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

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

457 : bool
458 {
459 global $DIC;
460 $ilDB = $DIC['ilDB'];
461
462 $result = $ilDB->queryF(
463 "SELECT * FROM qpl_questions WHERE obj_fi = %s AND title = %s",
464 array('integer','text'),
465 array($questionpool_id, $title)
466 );
467 return ($result->numRows() > 0) ? true : false;
468 }

References $DIC, $ilDB, and true.

◆ removeAllExistingSolutions()

assQuestion::removeAllExistingSolutions ( )

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

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

References $query, and ILIAS\Survey\Mode\getId().

+ Here is the call graph for this function:

◆ removeCurrentSolution()

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

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

3694 : int
3695 {
3696 if ($this->getStep() !== null) {
3697 $query = '
3698 DELETE FROM tst_solutions
3699 WHERE active_fi = %s
3700 AND question_fi = %s
3701 AND pass = %s
3702 AND step = %s
3703 AND authorized = %s
3704 ';
3705
3706 return $this->db->manipulateF(
3707 $query,
3708 array('integer', 'integer', 'integer', 'integer', 'integer'),
3709 array($active_id, $this->getId(), $pass, $this->getStep(), (int) $authorized)
3710 );
3711 }
3712
3713 $query = "
3714 DELETE FROM tst_solutions
3715 WHERE active_fi = %s
3716 AND question_fi = %s
3717 AND pass = %s
3718 AND authorized = %s
3719 ";
3720
3721 return $this->db->manipulateF(
3722 $query,
3723 array('integer', 'integer', 'integer', 'integer'),
3724 array($active_id, $this->getId(), $pass, (int) $authorized)
3725 );
3726 }

References $query, and ILIAS\Survey\Mode\getId().

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

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ removeExistingSolutions()

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

Reimplemented in assFormulaQuestion.

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

4019 : int
4020 {
4021 $query = "
4022 DELETE FROM tst_solutions
4023 WHERE active_fi = %s
4024 AND question_fi = %s
4025 AND pass = %s
4026 ";
4027
4028 if ($this->getStep() !== null) {
4029 $query .= " AND step = " . $this->db->quote((int) $this->getStep(), 'integer') . " ";
4030 }
4031
4032 return $this->db->manipulateF(
4033 $query,
4034 array('integer', 'integer', 'integer'),
4035 array($activeId, $this->getId(), $pass)
4036 );
4037 }

References $query, and ILIAS\Survey\Mode\getId().

+ Here is the call graph for this function:

◆ removeIntermediateSolution()

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

Reimplemented in assFileUpload.

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

3684 : void
3685 {
3686 $this->getProcessLocker()->executeUserSolutionUpdateLockOperation(function () use ($active_id, $pass) {
3687 $this->removeCurrentSolution($active_id, $pass, false);
3688 });
3689 }
assQuestion\removeCurrentSolution
removeCurrentSolution(int $active_id, int $pass, bool $authorized=true)
Definition: class.assQuestion.php:3694

◆ removeResultRecord()

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

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

4055 : int
4056 {
4057 $query = "
4058 DELETE FROM tst_test_result
4059 WHERE active_fi = %s
4060 AND question_fi = %s
4061 AND pass = %s
4062 ";
4063
4064 if ($this->getStep() !== null) {
4065 $query .= " AND step = " . $this->db->quote((int) $this->getStep(), 'integer') . " ";
4066 }
4067
4068 return $this->db->manipulateF(
4069 $query,
4070 array('integer', 'integer', 'integer'),
4071 array($activeId, $this->getId(), $pass)
4072 );
4073 }

References $query, and ILIAS\Survey\Mode\getId().

+ Here is the call graph for this function:

◆ removeSolutionRecordById()

assQuestion::removeSolutionRecordById ( int  $solutionId)
protected

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

3656 : int
3657 {
3658 return $this->db->manipulateF(
3659 "DELETE FROM tst_solutions WHERE solution_id = %s",
3660 array('integer'),
3661 array($solutionId)
3662 );
3663 }

Referenced by assFileUpload\saveWorkingData().

+ Here is the caller graph for this function:

◆ requiresJsSwitch()

assQuestion::requiresJsSwitch ( )

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

593 : bool
594 {
595 return $this->supportsJavascriptOutput() && $this->supportsNonJsOutput();
596 }

◆ resetOriginalId()

static assQuestion::resetOriginalId ( int  $questionId)
static

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

2092 : void
2093 {
2094 global $DIC;
2095 $ilDB = $DIC->database();
2096
2097 $query = "UPDATE qpl_questions SET tstamp = %s, original_id = NULL WHERE question_id = %s";
2098
2099 $ilDB->manipulateF(
2100 $query,
2101 array('integer', 'text'),
2102 array(time(), $questionId)
2103 );
2104 }

References $DIC, $ilDB, and $query.

Referenced by ilTestRandomQuestionSetPoolDeriver\updateTestQuestionStage().

+ Here is the caller graph for this function:

◆ resetUsersAnswer()

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

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

4039 : void
4040 {
4041 $this->removeExistingSolutions($activeId, $pass);
4042 $this->removeResultRecord($activeId, $pass);
4043
4044 $this->log($activeId, "log_user_solution_willingly_deleted");
4045
4046 self::_updateTestPassResults(
4047 $activeId,
4048 $pass,
4049 $this->areObligationsToBeConsidered(),
4050 $this->getProcessLocker(),
4051 $this->getTestId()
4052 );
4053 }
assQuestion\removeResultRecord
removeResultRecord(int $activeId, int $pass)
Definition: class.assQuestion.php:4055
assQuestion\removeExistingSolutions
removeExistingSolutions(int $activeId, int $pass)
Definition: class.assQuestion.php:4019
assQuestion\log
log(int $active_id, string $langVar)
Definition: class.assQuestion.php:358

◆ saveCurrentSolution()

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

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

3729 : int
3730 {
3731 $next_id = $this->db->nextId("tst_solutions");
3732
3733 $fieldData = array(
3734 "solution_id" => array("integer", $next_id),
3735 "active_fi" => array("integer", $active_id),
3736 "question_fi" => array("integer", $this->getId()),
3737 "value1" => array("clob", $value1),
3738 "value2" => array("clob", $value2),
3739 "pass" => array("integer", $pass),
3740 "tstamp" => array("integer", ((int) $tstamp > 0) ? (int) $tstamp : time()),
3741 'authorized' => array('integer', (int) $authorized)
3742 );
3743
3744 if ($this->getStep() !== null) {
3745 $fieldData['step'] = array("integer", $this->getStep());
3746 }
3747
3748 return $this->db->insert("tst_solutions", $fieldData);
3749 }

References ILIAS\Survey\Mode\getId().

Referenced by assClozeTest\saveWorkingData(), assErrorText\saveWorkingData(), assFileUpload\saveWorkingData(), assFormulaQuestion\saveWorkingData(), assMatchingQuestion\saveWorkingData(), assOrderingHorizontal\saveWorkingData(), assTextQuestion\saveWorkingData(), assTextSubset\saveWorkingData(), and assLongMenu\saveWorkingData().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ saveOriginalId()

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

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

2079 : void
2080 {
2081 global $DIC;
2082 $ilDB = $DIC->database();
2083 $query = "UPDATE qpl_questions SET tstamp = %s, original_id = %s WHERE question_id = %s";
2084
2085 $ilDB->manipulateF(
2086 $query,
2087 array('integer','integer', 'text'),
2088 array(time(), $originalId, $questionId)
2089 );
2090 }

References $DIC, $ilDB, and $query.

Referenced by ilTestRandomQuestionSetPoolDeriver\updateTestQuestionStage().

+ Here is the caller graph for this function:

◆ savePartial()

assQuestion::savePartial ( )

Reimplemented in assClozeTest.

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

4223 : bool
4224 {
4225 return false;
4226 }

◆ savePreviewData()

assQuestion::savePreviewData ( ilAssQuestionPreviewSession  $previewSession)
protected

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

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

988 : void
989 {
990 $previewSession->setParticipantsSolution($this->getSolutionSubmit());
991 }

References ilAssQuestionPreviewSession\setParticipantsSolution().

+ Here is the call graph for this function:

◆ saveQuestionDataToDb()

assQuestion::saveQuestionDataToDb ( int  $original_id = -1)

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

2005 : void
2006 {
2007 if ($this->getId() == -1) {
2008 $next_id = $this->db->nextId('qpl_questions');
2009 $this->db->insert("qpl_questions", array(
2010 "question_id" => array("integer", $next_id),
2011 "question_type_fi" => array("integer", $this->getQuestionTypeID()),
2012 "obj_fi" => array("integer", $this->getObjId()),
2013 "title" => array("text", $this->getTitle()),
2014 "description" => array("text", $this->getComment()),
2015 "author" => array("text", $this->getAuthor()),
2016 "owner" => array("integer", $this->getOwner()),
2017 "question_text" => array("clob", ilRTE::_replaceMediaObjectImageSrc($this->getQuestion(), 0)),
2018 "points" => array("float", $this->getMaximumPoints()),
2019 "nr_of_tries" => array("integer", $this->getNrOfTries()),
2020 "created" => array("integer", time()),
2021 "original_id" => array("integer", ($original_id != -1) ? $original_id : null),
2022 "tstamp" => array("integer", time()),
2023 "external_id" => array("text", $this->getExternalId()),
2024 'add_cont_edit_mode' => array('text', $this->getAdditionalContentEditingMode())
2025 ));
2026 $this->setId($next_id);
2027 // create page object of question
2028 $this->createPageObject();
2029 } else {
2030 // Vorhandenen Datensatz aktualisieren
2031 $this->db->update("qpl_questions", array(
2032 "obj_fi" => array("integer", $this->getObjId()),
2033 "title" => array("text", $this->getTitle()),
2034 "description" => array("text", $this->getComment()),
2035 "author" => array("text", $this->getAuthor()),
2036 "question_text" => array("clob", ilRTE::_replaceMediaObjectImageSrc($this->getQuestion(), 0)),
2037 "points" => array("float", $this->getMaximumPoints()),
2038 "nr_of_tries" => array("integer", $this->getNrOfTries()),
2039 "tstamp" => array("integer", time()),
2040 'complete' => array('integer', $this->isComplete()),
2041 "external_id" => array("text", $this->getExternalId())
2042 ), array(
2043 "question_id" => array("integer", $this->getId())
2044 ));
2045 }
2046 }
assQuestion\isComplete
isComplete()
Returns true, if a question is complete for use.
Definition: class.assQuestion.php:449

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

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

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ saveToDb()

assQuestion::saveToDb ( )

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

2048 : void
2049 {
2050 $this->updateSuggestedSolutions();
2051
2052 // remove unused media objects from ILIAS
2053 $this->cleanupMediaObjectUsage();
2054
2055 $complete = "0";
2056 if ($this->isComplete()) {
2057 $complete = "1";
2058 }
2059
2060 $this->db->update('qpl_questions', array(
2061 'tstamp' => array('integer', time()),
2062 'owner' => array('integer', $this->getOwner()),
2063 'complete' => array('integer', $complete),
2064 'lifecycle' => array('text', $this->getLifecycle()->getIdentifier()),
2065 ), array(
2066 'question_id' => array('integer', $this->getId())
2067 ));
2068 ilObjQuestionPool::_updateQuestionCount($this->obj_id);
2069 }
assQuestion\updateSuggestedSolutions
updateSuggestedSolutions(int $original_id=-1, int $original_obj_id=-1)
Definition: class.assQuestion.php:2281

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

+ Here is the call 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_idActive id of the user
int$passTest pass
bool$authorized
Returns
bool $status

Reimplemented in assLongMenu.

◆ setAdditionalContentEditingMode()

assQuestion::setAdditionalContentEditingMode ( ?string  $additionalContentEditingMode)

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

3551 : void
3552 {
3553 if (!in_array((string) $additionalContentEditingMode, $this->getValidAdditionalContentEditingModes())) {
3554 throw new ilTestQuestionPoolException('invalid additional content editing mode given: ' . $additionalContentEditingMode);
3555 }
3556
3557 $this->additionalContentEditingMode = $additionalContentEditingMode;
3558 }

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

+ Here is the caller graph for this function:

◆ setAuthor()

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

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

500 : void
501 {
502 if (!$author) {
503 $author = $this->current_user->getFullname();
504 }
505 $this->author = $author;
506 }

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

+ Here is the caller graph for this function:

◆ setComment()

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

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

485 : void
486 {
487 $this->comment = $comment;
488 }

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

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

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ setDefaultNrOfTries()

assQuestion::setDefaultNrOfTries ( int  $defaultnroftries)

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

3395 : void
3396 {
3397 $this->defaultnroftries = $defaultnroftries;
3398 }

◆ setExportDetailsXLS()

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

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

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

3274 : int
3275 {
3276 $worksheet->setFormattedExcelTitle($worksheet->getColumnCoord(0) . $startrow, $this->lng->txt($this->getQuestionType()));
3277 $worksheet->setFormattedExcelTitle($worksheet->getColumnCoord(1) . $startrow, $this->getTitle());
3278
3279 return $startrow;
3280 }
ilAssExcelFormatHelper\setFormattedExcelTitle
setFormattedExcelTitle($coordinates, $value)
Definition: class.ilAssExcelFormatHelper.php:43
ilExcel\getColumnCoord
getColumnCoord(int $a_col)
Get column "name" from number.
Definition: class.ilExcel.php:384

References ilExcel\getColumnCoord(), and ilAssExcelFormatHelper\setFormattedExcelTitle().

+ Here is the call graph for this function:

◆ setExportImagePath()

assQuestion::setExportImagePath ( string  $path)

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

3322 : void
3323 {
3324 $this->export_image_path = $path;
3325 }
$path
$path
Definition: ltiservices.php:32

References $path.

◆ setExternalId()

assQuestion::setExternalId ( ?string  $external_id)

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

633 : void
634 {
635 $this->external_id = $external_id;
636 }

Referenced by __construct().

+ Here is the caller graph for this function:

◆ setForcePassResultUpdateEnabled()

static assQuestion::setForcePassResultUpdateEnabled ( bool  $forcePassResultsUpdateEnabled)
static

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

238 : void
239 {
240 self::$forcePassResultsUpdateEnabled = $forcePassResultsUpdateEnabled;
241 }

References $forcePassResultsUpdateEnabled.

◆ setId()

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

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

475 : void
476 {
477 $this->id = $id;
478 }

References $id.

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

+ Here is the caller graph for this function:

◆ setLastChange()

assQuestion::setLastChange (   $lastChange)

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

3610 : void
3611 {
3612 $this->lastChange = $lastChange;
3613 }

Referenced by assKprimChoice\loadFromDb().

+ Here is the caller graph for this function:

◆ setLifecycle()

assQuestion::setLifecycle ( ilAssQuestionLifecycle  $lifecycle)

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

628 : void
629 {
630 $this->lifecycle = $lifecycle;
631 }

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

+ Here is the caller graph for this function:

◆ setNewOriginalId()

assQuestion::setNewOriginalId ( int  $newId)
Deprecated:

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

2074 : void
2075 {
2076 self::saveOriginalId($this->getId(), $newId);
2077 }
assQuestion\saveOriginalId
static saveOriginalId(int $questionId, int $originalId)
Definition: class.assQuestion.php:2079

References ILIAS\Survey\Mode\getId().

+ Here is the call graph for this function:

◆ setNrOfTries()

assQuestion::setNrOfTries ( int  $a_nr_of_tries)

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

3317 : void
3318 {
3319 $this->nr_of_tries = $a_nr_of_tries;
3320 }

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

+ Here is the caller graph for this function:

◆ setObjId()

assQuestion::setObjId ( int  $obj_id = 0)

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

618 : void
619 {
620 $this->obj_id = $obj_id;
621 }

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

+ Here is the caller graph for this function:

◆ setObligationsToBeConsidered()

assQuestion::setObligationsToBeConsidered ( bool  $obligationsToBeConsidered)

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

4179 : void
4180 {
4181 $this->obligationsToBeConsidered = $obligationsToBeConsidered;
4182 }

◆ setOriginalId()

assQuestion::setOriginalId ( ?int  $original_id)

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

1846 : void
1847 {
1848 $this->original_id = $original_id;
1849 }

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

+ Here is the caller graph for this function:

◆ setOutputType()

assQuestion::setOutputType ( int  $outputType = OUTPUT_HTML)

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

490 : void
491 {
492 $this->outputType = $outputType;
493 }

◆ setOwner()

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

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

508 : void
509 {
510 $this->owner = $owner;
511 }

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

+ Here is the caller graph for this function:

◆ setPoints()

assQuestion::setPoints ( float  $points)

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

2637 : void
2638 {
2639 $this->points = $points;
2640 }

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

+ Here is the caller graph for this function:

◆ setPreventRteUsage()

assQuestion::setPreventRteUsage ( bool  $prevent_rte_usage)

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

3356 : void
3357 {
3358 $this->prevent_rte_usage = $prevent_rte_usage;
3359 }

◆ setProcessLocker()

assQuestion::setProcessLocker ( ilAssQuestionProcessLocker  $processLocker)

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

390 : void
391 {
392 $this->processLocker = $processLocker;
393 }

References $processLocker.

◆ setQuestion()

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

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

3020 : void
3021 {
3022 $this->question = $question;
3023 }

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

+ Here is the caller graph for this function:

◆ setSelfAssessmentEditingMode()

assQuestion::setSelfAssessmentEditingMode ( bool  $selfassessmenteditingmode)

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

3385 : void
3386 {
3387 $this->selfassessmenteditingmode = $selfassessmenteditingmode;
3388 }

◆ setShuffle()

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

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

495 : void
496 {
497 $this->shuffle = $shuffle ?? false;
498 }

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

+ Here is the caller graph for this function:

◆ setShuffler()

assQuestion::setShuffler ( Transformation  $shuffler)

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

385 : void
386 {
387 $this->shuffler = $shuffler;
388 }

References $shuffler.

Referenced by assMatchingQuestion\toJSON().

+ Here is the caller graph for this function:

◆ setStep()

assQuestion::setStep (   $step)
Parameters
int | null$step

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

3895 : void
3896 {
3897 $this->step = $step;
3898 }

◆ setSuggestedSolution()

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

Sets a suggested solution for the question.

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

Parameters
string$solution_idAn internal link pointing to the suggested solution
int$subquestion_indexThe index of a subquestion (i.e. a close test gap). Usually 0
bool$is_importA boolean indication that the internal link was imported from another ILIAS installation @access public

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

2188 : void
2189 {
2190 if (strcmp($solution_id, "") != 0) {
2191 $import_id = "";
2192 if ($is_import) {
2193 $import_id = $solution_id;
2194 $solution_id = $this->_resolveInternalLink($import_id);
2195 }
2196 $this->suggested_solutions[$subquestion_index] = array(
2197 "internal_link" => $solution_id,
2198 "import_id" => $import_id
2199 );
2200 }
2201 }

Referenced by assFlashQuestion\loadFromDb().

+ Here is the caller graph for this function:

◆ setTestId()

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

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

480 : void
481 {
482 $this->test_id = $id;
483 }

References $id.

◆ setThumbSize()

assQuestion::setThumbSize ( int  $a_size)

Reimplemented in assKprimChoice.

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

558 : void
559 {
560 if ($a_size >= self::MINIMUM_THUMB_SIZE) {
561 $this->thumb_size = $a_size;
562 } else {
563 throw new ilException("Thumb size must be at least " . self::MINIMUM_THUMB_SIZE . "px");
564 }
565 }
ilException
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
Definition: class.ilException.php:26

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

+ Here is the caller graph for this function:

◆ setTitle()

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

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

470 : void
471 {
472 $this->title = $title;
473 }

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

+ Here is the caller graph for this function:

◆ supportsJavascriptOutput()

assQuestion::supportsJavascriptOutput ( )

Reimplemented in assMatchingQuestion, assOrderingHorizontal, and assOrderingQuestion.

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

583 : bool
584 {
585 return false;
586 }

◆ supportsNonJsOutput()

assQuestion::supportsNonJsOutput ( )

Reimplemented in assMatchingQuestion, assOrderingHorizontal, and assOrderingQuestion.

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

588 : bool
589 {
590 return true;
591 }

◆ syncHints()

assQuestion::syncHints ( )

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

3046 : void
3047 {
3048 // delete hints of the original
3049 $this->db->manipulateF(
3050 "DELETE FROM qpl_hints WHERE qht_question_fi = %s",
3051 array('integer'),
3052 array($this->original_id)
3053 );
3054
3055 // get hints of the actual question
3056 $result = $this->db->queryF(
3057 "SELECT * FROM qpl_hints WHERE qht_question_fi = %s",
3058 array('integer'),
3059 array($this->getId())
3060 );
3061
3062 // save hints to the original
3063 if ($this->db->numRows($result) > 0) {
3064 while ($row = $this->db->fetchAssoc($result)) {
3065 $next_id = $this->db->nextId('qpl_hints');
3066 $this->db->insert(
3067 'qpl_hints',
3068 array(
3069 'qht_hint_id' => array('integer', $next_id),
3070 'qht_question_fi' => array('integer', $this->original_id),
3071 'qht_hint_index' => array('integer', $row["qht_hint_index"]),
3072 'qht_hint_points' => array('float', $row["qht_hint_points"]),
3073 'qht_hint_text' => array('text', $row["qht_hint_text"]),
3074 )
3075 );
3076 }
3077 }
3078 }

References ILIAS\Survey\Mode\getId().

+ Here is the call graph for this function:

◆ syncSkillAssignments()

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

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

3471 : void
3472 {
3473 $assignmentList = new ilAssQuestionSkillAssignmentList($this->db);
3474 $assignmentList->setParentObjId($trgParentId);
3475 $assignmentList->setQuestionIdFilter($trgQuestionId);
3476 $assignmentList->loadFromDb();
3477
3478 foreach ($assignmentList->getAssignmentsByQuestionId($trgQuestionId) as $assignment) {
3479 $assignment->deleteFromDb();
3480
3481 // remove skill usage
3482 if (!$assignment->isSkillUsed()) {
3483 ilSkillUsage::setUsage(
3484 $assignment->getParentObjId(),
3485 $assignment->getSkillBaseId(),
3486 $assignment->getSkillTrefId(),
3487 false
3488 );
3489 }
3490 }
3491
3492 $this->duplicateSkillAssignments($srcParentId, $srcQuestionId, $trgParentId, $trgQuestionId);
3493 }

References ilSkillUsage\setUsage().

+ Here is the call graph for this function:

◆ syncSuggestedSolutionFiles()

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

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

2237 : void {
2238 $filepath = $this->getSuggestedSolutionPath();
2239 $filepath_original = str_replace(
2240 "{$this->getObjId()}/{$this->id}/solution",
2241 "{$target_obj_id}/{$target_question_id}/solution",
2242 $filepath
2243 );
2244 ilFileUtils::delDir($filepath_original);
2245 foreach ($this->suggested_solutions as $index => $solution) {
2246 if (strcmp($solution["type"], "file") == 0) {
2247 if (!file_exists($filepath_original)) {
2248 ilFileUtils::makeDirParents($filepath_original);
2249 }
2250 $filename = $solution["value"]["name"];
2251 if (strlen($filename)) {
2252 if (!@copy($filepath . $filename, $filepath_original . $filename)) {
2253 $this->ilLog->root()->error("File could not be duplicated!!!!");
2254 $this->ilLog->root()->error("object: " . print_r($this, true));
2255 }
2256 }
2257 }
2258 }
2259 }

◆ syncWithOriginal()

assQuestion::syncWithOriginal ( )

Reimplemented in assImagemapQuestion, and assMultipleChoice.

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

2510 : void
2511 {
2512 if (!$this->getOriginalId()) {
2513 return; // No original -> no sync
2514 }
2515 $currentID = $this->getId();
2516 $currentObjId = $this->getObjId();
2517 $originalID = $this->getOriginalId();
2518 $originalObjId = self::lookupParentObjId($this->getOriginalId());
2519
2520 if (!$originalObjId) {
2521 return; // Original does not exist -> no sync
2522 }
2523
2524 $this->beforeSyncWithOriginal($this->getOriginalId(), $this->getId(), $originalObjId, $this->getObjId());
2525
2526 // Now we become the original
2527 $this->setId($this->getOriginalId());
2528 $this->setOriginalId(null);
2529 $this->setObjId($originalObjId);
2530 // And save ourselves as the original
2531 $this->saveToDb();
2532
2533 // Now we delete the originals page content
2534 $this->deletePageOfQuestion($originalID);
2535 $this->createPageObject();
2536 $this->copyPageOfQuestion($currentID);
2537
2538 $this->setId($currentID);
2539 $this->setOriginalId($originalID);
2540 $this->setObjId($currentObjId);
2541
2542 $this->updateSuggestedSolutions($this->getOriginalId(), $originalObjId);
2543 $this->syncXHTMLMediaObjectsOfQuestion();
2544
2545 $this->afterSyncWithOriginal($this->getOriginalId(), $this->getId(), $originalObjId, $this->getObjId());
2546 $this->syncHints();
2547 }
assQuestion\setOriginalId
setOriginalId(?int $original_id)
Definition: class.assQuestion.php:1846
assQuestion\afterSyncWithOriginal
afterSyncWithOriginal(int $origQuestionId, int $dupQuestionId, int $origParentObjId, int $dupParentObjId)
Definition: class.assQuestion.php:2118
assQuestion\copyPageOfQuestion
copyPageOfQuestion(int $a_q_id)
Definition: class.assQuestion.php:1786
assQuestion\setObjId
setObjId(int $obj_id=0)
Definition: class.assQuestion.php:618
assQuestion\beforeSyncWithOriginal
beforeSyncWithOriginal(int $origQuestionId, int $dupQuestionId, int $origParentObjId, int $dupParentObjId)
Definition: class.assQuestion.php:2114

References ILIAS\Survey\Mode\getId().

+ Here is the call graph for this function:

◆ syncXHTMLMediaObjectsOfQuestion()

assQuestion::syncXHTMLMediaObjectsOfQuestion ( )

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

1766 : void
1767 {
1768 $mobs = ilObjMediaObject::_getMobsOfObject("qpl:html", $this->getId());
1769 foreach ($mobs as $mob) {
1770 ilObjMediaObject::_saveUsage($mob, "qpl:html", $this->original_id);
1771 }
1772 }

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

+ Here is the call graph for this function:

◆ toJSON()

assQuestion::toJSON ( )

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

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

3920 : string
3921 {
3922 return json_encode([]);
3923 }

◆ toXML()

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

Returns a QTI xml representation of the question.

Returns
string The QTI xml representation of the question

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

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

◆ updateCurrentSolution()

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

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

3752 : int
3753 {
3754 $fieldData = array(
3755 "value1" => array("clob", $value1),
3756 "value2" => array("clob", $value2),
3757 "tstamp" => array("integer", time()),
3758 'authorized' => array('integer', (int) $authorized)
3759 );
3760
3761 if ($this->getStep() !== null) {
3762 $fieldData['step'] = array("integer", $this->getStep());
3763 }
3764
3765 return $this->db->update("tst_solutions", $fieldData, array(
3766 'solution_id' => array('integer', $solutionId)
3767 ));
3768 }

◆ updateCurrentSolutionsAuthorization()

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

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

3771 : int
3772 {
3773 $fieldData = array(
3774 'authorized' => array('integer', (int) $authorized)
3775 );
3776
3777 if (!$keepTime) {
3778 $fieldData['tstamp'] = array('integer', time());
3779 }
3780
3781 $whereData = array(
3782 'question_fi' => array('integer', $this->getId()),
3783 'active_fi' => array('integer', $activeId),
3784 'pass' => array('integer', $pass)
3785 );
3786
3787 if ($this->getStep() !== null) {
3788 $whereData['step'] = array("integer", $this->getStep());
3789 }
3790
3791 return $this->db->update('tst_solutions', $fieldData, $whereData);
3792 }

References ILIAS\Survey\Mode\getId().

Referenced by assFileUpload\saveWorkingData().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ updateSuggestedSolutions()

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

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

2281 : void
2282 {
2283 $id = $original_id !== -1 ? $original_id : $this->getId();
2284 $this->db->manipulateF(
2285 "DELETE FROM qpl_sol_sug WHERE question_fi = %s",
2286 array('integer'),
2287 array($id)
2288 );
2289 ilInternalLink::_deleteAllLinksOfSource("qst", $id);
2290 foreach ($this->suggested_solutions as $index => $solution) {
2291 $next_id = $this->db->nextId('qpl_sol_sug');
2292
2293 $value = $solution['value'] ?? '';
2294 if (is_array($value)) {
2295 $value = serialize($value);
2296 }
2297
2298 $this->db->insert(
2299 'qpl_sol_sug',
2300 array(
2301 'suggested_solution_id' => array('integer', $next_id),
2302 'question_fi' => array('integer', $id ),
2303 'type' => array('text', $solution['type'] ?? ''),
2304 'value' => array('clob', ilRTE::_replaceMediaObjectImageSrc($value)),
2305 'internal_link' => array( 'text', $solution['internal_link'] ?? ''),
2306 'import_id' => array('text', null),
2307 'subquestion_index' => array('integer', $index),
2308 'tstamp' => array('integer', time()),
2309 )
2310 );
2311 if (preg_match("/il_(\d*?)_(\w+)_(\d+)/", $solution["internal_link"], $matches)) {
2312 ilInternalLink::_saveLink("qst", $id, $matches[2], (int) $matches[3], (int) $matches[1]);
2313 }
2314 }
2315 if ($original_id !== -1
2316 && $original_obj_id !== -1) {
2317 $this->syncSuggestedSolutionFiles($id, $original_obj_id);
2318 }
2319 $this->cleanupMediaObjectUsage();
2320 }
assQuestion\syncSuggestedSolutionFiles
syncSuggestedSolutionFiles(int $target_question_id, int $target_obj_id)
Definition: class.assQuestion.php:2234

References $id, $index, ilInternalLink\_deleteAllLinksOfSource(), ilRTE\_replaceMediaObjectImageSrc(), ilInternalLink\_saveLink(), and ILIAS\Survey\Mode\getId().

+ Here is the call graph for this function:

◆ updateTimestamp()

assQuestion::updateTimestamp ( )

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

4184 : void
4185 {
4186 $this->db->manipulateF(
4187 "UPDATE qpl_questions SET tstamp = %s WHERE question_id = %s",
4188 array('integer', 'integer'),
4189 array(time(), $this->getId())
4190 );
4191 }

References ILIAS\Survey\Mode\getId().

+ Here is the call graph for this function:

◆ usageNumber()

assQuestion::usageNumber ( int  $question_id = 0)

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

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

1387 : int
1388 {
1389 if ($question_id < 1) {
1390 $question_id = $this->getId();
1391 }
1392
1393 $result = $this->db->queryF(
1394 "SELECT COUNT(qpl_questions.question_id) question_count FROM qpl_questions, tst_test_question WHERE qpl_questions.original_id = %s AND qpl_questions.question_id = tst_test_question.question_fi",
1395 array('integer'),
1396 array($question_id)
1397 );
1398 $row = $this->db->fetchAssoc($result);
1399 $count = (int) $row["question_count"];
1400
1401 $result = $this->db->queryF(
1402 "
1403 SELECT tst_active.test_fi
1404 FROM qpl_questions
1405 INNER JOIN tst_test_rnd_qst ON tst_test_rnd_qst.question_fi = qpl_questions.question_id
1406 INNER JOIN tst_active ON tst_active.active_id = tst_test_rnd_qst.active_fi
1407 WHERE qpl_questions.original_id = %s
1408 GROUP BY tst_active.test_fi",
1409 array('integer'),
1410 array($question_id)
1411 );
1412 $count += (int) $this->db->numRows($result);
1413
1414 return $count;
1415 }

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

+ Here is the call graph for this function:

◆ validateSolutionSubmit()

assQuestion::validateSolutionSubmit ( )

Reimplemented in assClozeTest, assFormulaQuestion, assMultipleChoice, assNumeric, and assOrderingQuestion.

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

973 : bool
974 {
975 return true;
976 }

Field Documentation

◆ $additionalContentEditingMode

string assQuestion::$additionalContentEditingMode = ''
private

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

◆ $allowedCharsetsByMimeType

assQuestion::$allowedCharsetsByMimeType
staticprotected
Initial value:
= array(
self::IMG_MIME_TYPE_JPG => ['binary'],
self::IMG_MIME_TYPE_PNG => ['binary'],
self::IMG_MIME_TYPE_GIF => ['binary']
)

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

◆ $allowedFileExtensionsByMimeType

assQuestion::$allowedFileExtensionsByMimeType
staticprotected
Initial value:
= array(
self::IMG_MIME_TYPE_JPG => ['jpg', 'jpeg'],
self::IMG_MIME_TYPE_PNG => ['png'],
self::IMG_MIME_TYPE_GIF => ['gif']
)

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

◆ $allowedImageMaterialFileExtensionsByMimeType

assQuestion::$allowedImageMaterialFileExtensionsByMimeType
staticprotected
Initial value:
= array(
'image/jpeg' => ['jpg', 'jpeg'],
'image/png' => ['png'],
'image/gif' => ['gif']
)

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

◆ $author

string assQuestion::$author
protected

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

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

◆ $comment

string assQuestion::$comment
protected

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

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

◆ $current_user

ilObjUser assQuestion::$current_user
protected

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

◆ $db

ilDBInterface assQuestion::$db
protected

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

Referenced by assClozeTest\calculateReachedPoints().

◆ $defaultnroftries

int assQuestion::$defaultnroftries = 0

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

◆ $dic

Container assQuestion::$dic
protected

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

◆ $export_image_path

string assQuestion::$export_image_path
private

(Web) Path to images

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

◆ $external_id

string assQuestion::$external_id = null
protected

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

◆ $feedbackOBJ

ilAssQuestionFeedback assQuestion::$feedbackOBJ

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

◆ $forcePassResultsUpdateEnabled

assQuestion::$forcePassResultsUpdateEnabled = false
staticprotected

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

Referenced by isForcePassResultUpdateEnabled(), and setForcePassResultUpdateEnabled().

◆ $http

ILIAS HTTP Services assQuestion::$http
protected

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

◆ $id

int assQuestion::$id
protected

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

Referenced by assFormulaQuestion\addResultUnits(), assClozeTest\createNewOriginalFromThisDuplicate(), assErrorText\createNewOriginalFromThisDuplicate(), assFileUpload\createNewOriginalFromThisDuplicate(), assFlashQuestion\createNewOriginalFromThisDuplicate(), assFormulaQuestion\createNewOriginalFromThisDuplicate(), assImagemapQuestion\createNewOriginalFromThisDuplicate(), assKprimChoice\createNewOriginalFromThisDuplicate(), assLongMenu\createNewOriginalFromThisDuplicate(), assMatchingQuestion\createNewOriginalFromThisDuplicate(), assMultipleChoice\createNewOriginalFromThisDuplicate(), assNumeric\createNewOriginalFromThisDuplicate(), assOrderingHorizontal\createNewOriginalFromThisDuplicate(), assSingleChoice\createNewOriginalFromThisDuplicate(), assTextQuestion\createNewOriginalFromThisDuplicate(), assTextSubset\createNewOriginalFromThisDuplicate(), assKprimChoice\setExportDetailsXLS(), and assFormulaQuestion\setId().

◆ $ilias

assQuestion::$ilias
protected

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

◆ $ilLog

ILIAS DI LoggingServices assQuestion::$ilLog
protected

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

Referenced by __construct(), assMatchingQuestion\copyImages(), assImagemapQuestion\duplicateImage(), assMatchingQuestion\duplicateImages(), and assImagemapQuestion\setImageFilename().

◆ $imageSourceFixReplaceMap

assQuestion::$imageSourceFixReplaceMap
staticprotected
Initial value:
= array(
'ok.svg' => 'ok.png',
'not_ok.svg' => 'not_ok.png',
'checkbox_checked.svg' => 'checkbox_checked.png',
'checkbox_unchecked.svg' => 'checkbox_unchecked.png',
'radiobutton_checked.svg' => 'radiobutton_checked.png',
'radiobutton_unchecked.svg' => 'radiobutton_unchecked.png'
)

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

◆ $lastChange

assQuestion::$lastChange
protected

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

◆ $lifecycle

ilAssQuestionLifecycle assQuestion::$lifecycle
protected

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

◆ $lng

ilLanguage assQuestion::$lng
protected

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

Referenced by __construct(), assFileUpload\deliverFileUploadZIPFile(), assKprimChoice\getAnswerTypeSelectOptions(), assKprimChoice\getFalseOptionLabelTranslation(), assKprimChoice\getInstructionTextTranslation(), assKprimChoice\getTrueOptionLabelTranslation(), and assKprimChoice\getValidOptionLabelsTranslated().

◆ $nr_of_tries

int assQuestion::$nr_of_tries
private

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

◆ $obj_id

int assQuestion::$obj_id = 0
protected

Object id of the container object.

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

◆ $obligationsToBeConsidered

bool assQuestion::$obligationsToBeConsidered = false
private

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

◆ $original_id

int assQuestion::$original_id = null
protected

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

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

◆ $outputType

int assQuestion::$outputType = OUTPUT_JAVASCRIPT
protected

Contains the output type of a question.

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

◆ $owner

string assQuestion::$owner
protected

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

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

◆ $page

assQuestion::$page
protected

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

◆ $points

float assQuestion::$points
protected

The maximum available points for the question.

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

Referenced by assSingleChoice\addAnswer(), assImagemapQuestion\addAnswer(), assMultipleChoice\addAnswer(), assTextSubset\addAnswer(), assClozeTest\addAnswerOptionValue(), assTextSubset\addAnswerOptionValue(), assMatchingQuestion\addMatchingPair(), assClozeTest\calculateCombinationResult(), assErrorText\calculateReachedPoints(), assFlashQuestion\calculateReachedPoints(), assFormulaQuestion\calculateReachedPoints(), assKprimChoice\calculateReachedPoints(), assMatchingQuestion\calculateReachedPoints(), assOrderingHorizontal\calculateReachedPoints(), assTextSubset\calculateReachedPointsForSolution(), assMatchingQuestion\calculateReachedPointsForSolution(), assKprimChoice\calculateReachedPointsForSolution(), assLongMenu\calculateReachedPointsForSolution(), assTextQuestion\calculateReachedPointsForSolution(), assClozeTest\calculateReachedPointsForSolution(), assOrderingHorizontal\calculateReachedPointsForSolution(), assFlashQuestion\calculateReachedPointsFromPreviewSession(), assFormulaQuestion\calculateReachedPointsFromPreviewSession(), assNumeric\calculateReachedPointsFromPreviewSession(), assLongMenu\checkQuestionCustomPart(), assClozeTest\getMaximumGapPoints(), assClozeTest\getMaximumPoints(), assFlashQuestion\getMaximumPoints(), assFormulaQuestion\getMaximumPoints(), assLongMenu\getMaximumPoints(), assMatchingQuestion\getMaximumPoints(), assTextQuestion\getMaximumPoints(), assTextSubset\getMaximumPoints(), assTextQuestion\getMinimumPoints(), assLongMenu\getPointsForGap(), assLongMenu\getUserQuestionResult(), assFileUpload\handleSubmission(), assMatchingQuestion\insertMatchingPair(), assLongMenu\saveAnswerSpecificDataToDb(), assErrorText\setErrorsFromParsedErrorText(), assClozeTest\setGapAnswerPoints(), and assTextQuestion\setReachedPoints().

◆ $prevent_rte_usage

bool assQuestion::$prevent_rte_usage = false

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

◆ $processLocker

ilAssQuestionProcessLocker assQuestion::$processLocker
protected

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

Referenced by getProcessLocker(), and setProcessLocker().

◆ $question

string assQuestion::$question
protected

The question text.

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

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

◆ $questionActionCmd

string assQuestion::$questionActionCmd = 'handleQuestionAction'

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

◆ $refinery

ILIAS Refinery Factory assQuestion::$refinery
protected

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

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

◆ $selfassessmenteditingmode

bool assQuestion::$selfassessmenteditingmode = false

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

◆ $shuffle

bool assQuestion::$shuffle
protected

Indicates whether the answers will be shuffled or not.

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

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

◆ $shuffler

Transformation assQuestion::$shuffler
protected

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

Referenced by getShuffler(), and setShuffler().

◆ $step

assQuestion::$step
protected

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

◆ $suggested_solutions

array assQuestion::$suggested_solutions
protected

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

◆ $test_id

int assQuestion::$test_id
protected

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

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

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

◆ $testQuestionConfig

ilTestQuestionConfig assQuestion::$testQuestionConfig
protected

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

◆ $testQuestionConfigInstance

ilTestQuestionConfig assQuestion::$testQuestionConfigInstance = null
private

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

◆ $thumb_size

int assQuestion::$thumb_size
protected

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

◆ $title

string assQuestion::$title
protected

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

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

◆ $tpl

ilGlobalPageTemplate assQuestion::$tpl
protected

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

Referenced by __construct().

◆ ADDITIONAL_CONTENT_EDITING_MODE_IPE

const assQuestion::ADDITIONAL_CONTENT_EDITING_MODE_IPE = 'pageobject'

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

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

◆ ADDITIONAL_CONTENT_EDITING_MODE_RTE

const assQuestion::ADDITIONAL_CONTENT_EDITING_MODE_RTE = 'default'

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

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

◆ DEFAULT_THUMB_SIZE

const assQuestion::DEFAULT_THUMB_SIZE = 150
private

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

Referenced by __construct().

◆ HAS_SPECIFIC_FEEDBACK

const assQuestion::HAS_SPECIFIC_FEEDBACK = true
protected

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

◆ IMG_MIME_TYPE_GIF

const assQuestion::IMG_MIME_TYPE_GIF = 'image/gif'

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

◆ IMG_MIME_TYPE_JPG

const assQuestion::IMG_MIME_TYPE_JPG = 'image/jpeg'

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

◆ IMG_MIME_TYPE_PNG

const assQuestion::IMG_MIME_TYPE_PNG = 'image/png'

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

◆ KEY_VALUES_IMPLOSION_SEPARATOR

const assQuestion::KEY_VALUES_IMPLOSION_SEPARATOR = ':'

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

Referenced by explodeKeyValues(), and implodeKeyValues().

◆ MAXIMUM_THUMB_SIZE

const assQuestion::MAXIMUM_THUMB_SIZE = 8192
private

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

◆ MINIMUM_THUMB_SIZE

const assQuestion::MINIMUM_THUMB_SIZE = 20
private

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

◆ TRIM_PATTERN

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

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

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