Public Member Functions |
Static Public Member Functions |
Data Fields |
Protected Member Functions |
Private Member Functions |
Private Attributes
assTextQuestion Class Reference
Class for text questions. More...
Inheritance diagram for assTextQuestion:
Collaboration diagram for assTextQuestion:
Public Member Functions | |
| __construct ( $title="", $comment="", $author="", $owner=-1, $question="") | |
| assTextQuestion constructor More... | |
| isComplete () | |
| Returns true, if a multiple choice question is complete for use. More... | |
| saveToDb ($original_id="") | |
| Saves a assTextQuestion object to a database. More... | |
| loadFromDb ($question_id) | |
| Loads a assTextQuestion object from a database. More... | |
| duplicate ($for_test=true, $title="", $author="", $owner="", $testObjId=null) | |
| Duplicates an assTextQuestion. More... | |
| copyObject ($target_questionpool_id, $title="") | |
| Copies an assTextQuestion object. More... | |
| createNewOriginalFromThisDuplicate ($targetParentId, $targetQuestionTitle="") | |
| getMaxNumOfChars () | |
| Gets the maximum number of characters for the text solution. More... | |
| setMaxNumOfChars ($maxchars=0) | |
| Sets the maximum number of characters for the text solution. More... | |
| getMaximumPoints () | |
| Returns the maximum points, a learner can reach answering the question. More... | |
| getMinimumPoints () | |
| setReachedPoints ($active_id, $points, $pass=NULL) | |
| Sets the points, a learner has reached answering the question. More... | |
| isKeywordMatching ($answertext, $a_keyword) | |
| Checks if one of the keywords matches the answertext. More... | |
| calculateReachedPoints ($active_id, $pass=NULL, $returndetails=FALSE) | |
| Returns the points, a learner has reached answering the question. More... | |
| saveWorkingData ($active_id, $pass=NULL) | |
| Saves the learners input of the question to the database. More... | |
| getSolutionSubmit () | |
| createRandomSolution ($test_id, $user_id) | |
| getQuestionType () | |
| Returns the question type of the question. More... | |
| getTextRating () | |
| Returns the rating option for text comparisons. More... | |
| setTextRating ($a_text_rating) | |
| Sets the rating option for text comparisons. More... | |
| getAdditionalTableName () | |
| Returns the name of the additional question data table in the database. More... | |
| getRTETextWithMediaObjects () | |
| Collects all text in the question which could contain media objects which were created with the Rich Text Editor. More... | |
| setExportDetailsXLS (&$worksheet, $startrow, $active_id, $pass, &$format_title, &$format_bold) | |
| Creates an Excel worksheet for the detailed cumulated results of this question. More... | |
| toJSON () | |
| Returns a JSON representation of the question. More... | |
| getAnswerCount () | |
| addAnswer ( $answertext="", $points=0.0, $points_unchecked=0.0, $order=0, $answerimage="") | |
| Adds a possible answer for a multiple choice question. More... | |
| getAnswers () | |
| getAnswer ($index=0) | |
| Returns an answer with a given index. More... | |
| deleteAnswer ($index=0) | |
| Deletes an answer with a given index. More... | |
| getAnswerTableName () | |
| Returns the name of the answer table in the database. More... | |
| flushAnswers () | |
| Deletes all answers. More... | |
| setAnswers ($answers) | |
| duplicateAnswers ($original_id) | |
| getKeywordRelation () | |
| setKeywordRelation ($a_relation) | |
| This method implements a default behaviour. More... | |
| isAnswered ($active_id, $pass) | |
| returns boolean wether the question is answered during test pass or not More... | |
| Public Member Functions inherited from assQuestion | |
| __construct ( $title="", $comment="", $author="", $owner=-1, $question="") | |
| assQuestion constructor More... | |
| setProcessLocker ($processLocker) | |
| getProcessLocker () | |
| fromXML (&$item, &$questionpool_id, &$tst_id, &$tst_object, &$question_counter, &$import_mapping) | |
| Receives parameters from a QTI parser and creates a valid ILIAS question object. More... | |
| toXML ($a_include_header=true, $a_include_binary=true, $a_shuffle=false, $test_output=false, $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 ($questionpool_id, $title) | |
| Returns TRUE if the question title exists in the database. More... | |
| setTitle ($title="") | |
| Sets the title string of the assQuestion object. More... | |
| setId ($id=-1) | |
| Sets the id of the assQuestion object. More... | |
| setTestId ($id=-1) | |
| Sets the test id of the assQuestion object. More... | |
| setComment ($comment="") | |
| Sets the comment string of the assQuestion object. More... | |
| setOutputType ($outputType=OUTPUT_HTML) | |
| Sets the output type. More... | |
| setShuffle ($shuffle=true) | |
| Sets the shuffle flag. More... | |
| setEstimatedWorkingTime ($hour=0, $min=0, $sec=0) | |
| Sets the estimated working time of a question from given hour, minute and second. More... | |
| setEstimatedWorkingTimeFromDurationString ($durationString) | |
| Sets the estimated working time of a question from a given datetime string. More... | |
| keyInArray ($searchkey, $array) | |
| returns TRUE if the key occurs in an array More... | |
| setAuthor ($author="") | |
| Sets the authors name of the assQuestion object. More... | |
| setOwner ($owner="") | |
| Sets the creator/owner ID of the assQuestion object. More... | |
| getTitle () | |
| Gets the title string of the assQuestion object. More... | |
| getId () | |
| Gets the id of the assQuestion object. More... | |
| getShuffle () | |
| Gets the shuffle flag. More... | |
| getTestId () | |
| Gets the test id of the assQuestion object. More... | |
| getComment () | |
| Gets the comment string of the assQuestion object. More... | |
| getOutputType () | |
| Gets the output type. More... | |
| supportsJavascriptOutput () | |
| Returns true if the question type supports JavaScript output. More... | |
| supportsNonJsOutput () | |
| requiresJsSwitch () | |
| getEstimatedWorkingTime () | |
| Gets the estimated working time of a question. More... | |
| getAuthor () | |
| Gets the authors name of the assQuestion object. More... | |
| getOwner () | |
| Gets the creator/owner ID of the assQuestion object. More... | |
| getObjId () | |
| Get the object id of the container object. More... | |
| setObjId ($obj_id=0) | |
| Set the object id of the container object. More... | |
| setExternalId ($external_id) | |
| getExternalId () | |
| _getMaximumPoints ($question_id) | |
| Returns the maximum points, a learner can reach answering the question. More... | |
| & | _getQuestionInfo ($question_id) |
| Returns question information from the database. More... | |
| getSuggestedSolutionOutput () | |
| & | _getSuggestedSolution ($question_id, $subquestion_index=0) |
| Returns a suggested solution for a given subquestion index. More... | |
| getSuggestedSolutions () | |
| Return the suggested solutions. More... | |
| _getReachedPoints ($active_id, $question_id, $pass=NULL) | |
| Returns the points, a learner has reached answering the question. More... | |
| getReachedPoints ($active_id, $pass=NULL) | |
| Returns the points, a learner has reached answering the question This is the fast way to get the points directly from the database. More... | |
| getMaximumPoints () | |
| Returns the maximum points, a learner can reach answering the question. More... | |
| getAdjustedReachedPoints ($active_id, $pass=NULL) | |
| returns the reached points ... More... | |
| calculateResultsFromSolution ($active_id, $pass=NULL, $obligationsEnabled=false) | |
| Calculates the question results from a previously saved question solution. More... | |
| persistWorkingState ($active_id, $pass=NULL, $obligationsEnabled=false) | |
| persists the working state for current testactive and testpass More... | |
| persistPreviewState (ilAssQuestionPreviewSession $previewSession) | |
| persists the preview state for current user and question More... | |
| saveWorkingData ($active_id, $pass=NULL) | |
| Saves the learners input of the question to the database. More... | |
| _updateTestResultCache ($active_id, ilAssQuestionProcessLocker $processLocker=null) | |
| @TODO Move this to a proper place. More... | |
| logAction ($logtext="", $active_id="", $question_id="") | |
| Logs an action into the Test&Assessment log. More... | |
| _logAction ($logtext="", $active_id="", $question_id="") | |
| Logs an action into the Test&Assessment log. More... | |
| moveUploadedMediaFile ($file, $name) | |
| Move an uploaded media file to an public accessible temp dir to present it. More... | |
| getSuggestedSolutionPath () | |
| Returns the path for a suggested solution. More... | |
| getJavaPath () | |
| Returns the image path for web accessable images of a question. More... | |
| 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... | |
| getJavaPathWeb () | |
| Returns the web image path for web accessable java applets of a question. More... | |
| getSuggestedSolutionPathWeb () | |
| Returns the web path for a suggested solution. More... | |
| getImagePathWeb () | |
| Returns the web image path for web accessable images of a question. More... | |
| getFlashPathWeb () | |
| Returns the web image path for web accessable flash applications of a question. More... | |
| & | getSolutionValues ($active_id, $pass=NULL) |
| Loads solutions of a given user from the database an returns it. More... | |
| isInUse ($question_id="") | |
| Checks whether the question is in use or not. More... | |
| isClone ($question_id="") | |
| Checks whether the question is a clone of another question or not. More... | |
| pcArrayShuffle ($array) | |
| Shuffles the values of a given array. More... | |
| getQuestionTypeFromDb ($question_id) | |
| get question type for question id More... | |
| getAdditionalTableName () | |
| Returns the name of the additional question data table in the database. More... | |
| getAnswerTableName () | |
| Returns the name of the answer table in the database. More... | |
| deleteAnswers ($question_id) | |
| Deletes datasets from answers tables. More... | |
| deleteAdditionalTableData ($question_id) | |
| Deletes datasets from the additional question table in the database. More... | |
| delete ($question_id) | |
| Deletes a question and all materials from the database. More... | |
| getTotalAnswers () | |
| get total number of answers More... | |
| _getTotalAnswers ($a_q_id) | |
| get number of answers for question id (static) note: do not use $this inside this method More... | |
| _getTitle ($a_q_id) | |
| Returns the title of a question. More... | |
| _getQuestionText ($a_q_id) | |
| Returns question text. More... | |
| copyXHTMLMediaObjectsOfQuestion ($a_q_id) | |
| syncXHTMLMediaObjectsOfQuestion () | |
| createPageObject () | |
| create page object of question More... | |
| copyPageOfQuestion ($a_q_id) | |
| getPageOfQuestion () | |
| _getQuestionType ($question_id) | |
| Returns the question type of a question with a given id. More... | |
| _getQuestionTitle ($question_id) | |
| Returns the question title of a question with a given id. More... | |
| setOriginalId ($original_id) | |
| getOriginalId () | |
| fixSvgToPng ($imageFilenameContainingString) | |
| fixUnavailableSkinImageSources ($html) | |
| loadFromDb ($question_id) | |
| Loads the question from the database. More... | |
| createNewQuestion ($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 ($original_id="") | |
| saveToDb ($original_id="") | |
| Saves the question to the database. More... | |
| setNewOriginalId ($newId) | |
| deleteSuggestedSolutions () | |
| Deletes all suggestes solutions in the database. More... | |
| getSuggestedSolution ($subquestion_index=0) | |
| Returns a suggested solution for a given subquestion index. More... | |
| getSuggestedSolutionTitle ($subquestion_index=0) | |
| Returns the title of a suggested solution at a given subquestion_index. More... | |
| setSuggestedSolution ($solution_id="", $subquestion_index=0, $is_import=false) | |
| Sets a suggested solution for the question. More... | |
| _resolveInternalLink ($internal_link) | |
| _resolveIntLinks ($question_id) | |
| _getInternalLinkHref ($target="") | |
| syncWithOriginal () | |
| createRandomSolution ($test_id, $user_id) | |
| _questionExists ($question_id) | |
| Returns true if the question already exists in the database. More... | |
| _questionExistsInPool ($question_id) | |
| Returns true if the question already exists in the database and is assigned to a question pool. More... | |
| getPoints () | |
| Returns the maximum available points for the question. More... | |
| setPoints ($a_points) | |
| Sets the maximum available points for the question. More... | |
| getSolutionMaxPass ($active_id) | |
| Returns the maximum pass a users question solution. More... | |
| _getSolutionMaxPass ($question_id, $active_id) | |
| Returns the maximum pass a users question solution. More... | |
| _isWriteable ($question_id, $user_id) | |
| Returns true if the question is writeable by a certain user. More... | |
| _isUsedInRandomTest ($question_id="") | |
| Checks whether the question is used in a random test or not. More... | |
| calculateReachedPoints ($active_id, $pass=NULL, $returndetails=FALSE) | |
| Returns the points, a learner has reached answering the question. More... | |
| 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 ($txt_output, $prepare_for_latex_output=FALSE) | |
| Prepares a string for a text area output in tests. More... | |
| QTIMaterialToString ($a_material) | |
| Reads an QTI material tag an creates a text string. More... | |
| addQTIMaterial (&$a_xml_writer, $a_material, $close_material_tag=TRUE, $add_mobs=TRUE) | |
| Creates a QTI material tag from a plain text or xhtml text. More... | |
| createNewImageFileName ($image_filename, $unique=false) | |
| _setReachedPoints ($active_id, $question_id, $points, $maxpoints, $pass, $manualscoring, $obligationsEnabled) | |
| Sets the points, a learner has reached answering the question Additionally objective results are updated. More... | |
| getQuestion () | |
| Gets the question string of the question object. More... | |
| setQuestion ($question="") | |
| Sets the question string of the question object. More... | |
| getQuestionType () | |
| Returns the question type of the question. More... | |
| getQuestionTypeID () | |
| Returns the question type of the question. More... | |
| cleanupMediaObjectUsage () | |
| synchronises appearances of media objects in the question with media object usage table More... | |
| & | getInstances () |
| Gets all instances of the question. More... | |
| _needsManualScoring ($question_id) | |
| getActiveUserData ($active_id) | |
| Returns the user id and the test id for a given active id. More... | |
| setExportDetailsXLS (&$worksheet, $startrow, $active_id, $pass, &$format_title, &$format_bold) | |
| Creates an Excel worksheet for the detailed cumulated results of this question. More... | |
| __get ($value) | |
| Object getter. More... | |
| __set ($key, $value) | |
| Object setter. More... | |
| getNrOfTries () | |
| setNrOfTries ($a_nr_of_tries) | |
| setExportImagePath ($a_path) | |
| _questionExistsInTest ($question_id, $test_id) | |
| formatSAQuestion ($a_q) | |
| Format self assessment question. More... | |
| setPreventRteUsage ($a_val) | |
| Set prevent rte usage. More... | |
| getPreventRteUsage () | |
| Get prevent rte usage. More... | |
| setSelfAssessmentEditingMode ($a_selfassessmenteditingmode) | |
| Set Self-Assessment Editing Mode. More... | |
| getSelfAssessmentEditingMode () | |
| Get Self-Assessment Editing Mode. More... | |
| setDefaultNrOfTries ($a_defaultnroftries) | |
| Set Default Nr of Tries. More... | |
| getDefaultNrOfTries () | |
| Get Default Nr of Tries. More... | |
| isAnswered ($active_id, $pass=null) | |
| returns boolean wether the question is answered during test pass or not More... | |
| setObligationsToBeConsidered ($obligationsToBeConsidered=true) | |
| sets the flag wether obligations are to be considered or not More... | |
| areObligationsToBeConsidered () | |
| gets the flag wether obligations are to be considered or not More... | |
| isAutosaveable () | |
| getAdditionalContentEditingMode () | |
| getter for additional content editing mode for this question More... | |
| setAdditionalContentEditingMode ($additinalContentEditingMode) | |
| setter for additional content editing mode for this question More... | |
| isAdditionalContentEditingModePageObject () | |
| isser for additional "pageobject" content editing mode More... | |
| isValidAdditionalContentEditingMode ($additionalContentEditingMode) | |
| returns the fact wether the passed additional content mode is valid or not More... | |
| getValidAdditionalContentEditingModes () | |
| getter for valid additional content editing modes More... | |
| addQuestionChangeListener (ilQuestionChangeListener $listener) | |
| getQuestionChangeListeners () | |
| getHtmlUserSolutionPurifier () | |
| getHtmlQuestionContentPurifier () | |
| setLastChange ($lastChange) | |
| getLastChange () | |
| setStep ($step) | |
| getStep () | |
| toJSON () | |
| duplicate ($for_test=true, $title="", $author="", $owner="", $testObjId=null) | |
| Public Member Functions inherited from ilObjQuestionScoringAdjustable | |
| saveAdditionalQuestionDataToDb () | |
| Saves a record to the question types additional data table. More... | |
| Public Member Functions inherited from ilObjAnswerScoringAdjustable | |
| saveAnswerSpecificDataToDb () | |
| Saves the answer specific records into a question types answer table. More... | |
Static Public Member Functions | |
| static | getValidScoringModes () |
| static | getScoringModesWithPointsByQuestion () |
| static | getScoringModesWithPointsByKeyword () |
| static | isObligationPossible ($questionId) |
| returns boolean wether it is possible to set this question type as obligatory or not considering the current question configuration More... | |
| Static Public Member Functions inherited from assQuestion | |
| static | isAllowedImageMimeType ($mimeType) |
| static | fetchMimeTypeIdentifier ($contentTypeString) |
| static | getAllowedFileExtensionsForMimeType ($mimeType) |
| static | isAllowedImageFileExtension ($mimeType, $fileExtension) |
| static | getAllowedImageFileExtensions () |
| static | _getSuggestedSolutionCount ($question_id) |
| Returns the number of suggested solutions associated with a question. More... | |
| static | _getSuggestedSolutionOutput ($question_id) |
| Returns the output of the suggested solution. More... | |
| static | _getTotalRightAnswers ($a_q_id) |
| get number of answers for question id (static) note: do not use $this inside this method More... | |
| static | isFileAvailable ($file) |
| static | _getOriginalId ($question_id) |
| Returns the original id of a question. More... | |
| static | originalQuestionExists ($questionId) |
| static | _instanciateQuestion ($question_id) |
| Creates an instance of a question with a given question id. More... | |
| static | _instantiateQuestion ($question_id) |
| static | _isWorkedThrough ($active_id, $question_id, $pass=NULL) |
| 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 ($a_user_id, $a_question_ids) |
| Checks if an array of question ids is answered by an user or not. More... | |
| static | _includeClass ($question_type, $gui=0) |
| Include the php class file for a given question type. More... | |
| static | getGuiClassNameByQuestionType ($questionType) |
| static | getObjectClassNameByQuestionType ($questionType) |
| static | getFeedbackClassNameByQuestionType ($questionType) |
| static | isCoreQuestionType ($questionType) |
| static | includeCoreClass ($questionType, $withGuiClass) |
| static | includePluginClass ($questionType, $withGuiClass) |
| static | _getQuestionTypeName ($type_tag) |
| Return the translation for a given question type tag. More... | |
| static & | _instanciateQuestionGUI ($question_id) |
| Creates an instance of a question gui with a given question id. More... | |
| static | instantiateQuestionGUI ($a_question_id) |
| Creates an instance of a question gui with a given question id. More... | |
| static | lookupParentObjId ($questionId) |
| @global ilDB $ilDB More... | |
| static | lookupOriginalParentObjId ($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 ($questionId) |
| returns boolean wether it is possible to set this question type as obligatory or not considering the current question configuration More... | |
| static | setResultGateway ($resultGateway) |
| static | getResultGateway () |
| static | sumTimesInISO8601FormatH_i_s_Extended ($time1, $time2) |
| static | convertISO8601FormatH_i_s_ExtendedToSeconds ($time) |
Data Fields | |
| $maxNumOfChars | |
| $keywords | |
| $answers | |
| $text_rating | |
| $keyword_relation = 'any' | |
| Data Fields inherited from assQuestion | |
| const | IMG_MIME_TYPE_JPG = 'image/jpeg' |
| const | IMG_MIME_TYPE_PNG = 'image/png' |
| const | IMG_MIME_TYPE_GIF = 'image/gif' |
| const | ADDITIONAL_CONTENT_EDITING_MODE_DEFAULT = 'default' |
| constant for additional content editing mode "default" More... | |
| const | ADDITIONAL_CONTENT_EDITING_MODE_PAGE_OBJECT = 'pageobject' |
| constant for additional content editing mode "pageobject" More... | |
| $feedbackOBJ = null | |
| $prevent_rte_usage = false | |
| $selfassessmenteditingmode = false | |
| $defaultnroftries = 0 | |
| $questionActionCmd = 'handleQuestionAction' | |
Protected Member Functions | |
| calculateReachedPointsForSolution ($solution) | |
| reworkWorkingData ($active_id, $pass, $obligationsAnswered) | |
| Reworks the allready saved working data if neccessary. More... | |
| Protected Member Functions inherited from assQuestion | |
| reworkWorkingData ($active_id, $pass, $obligationsAnswered) | |
| Reworks the allready saved working data if neccessary. More... | |
| savePreviewData (ilAssQuestionPreviewSession $previewSession) | |
| deletePageOfQuestion ($question_id) | |
| Deletes the page object of a question with a given ID. More... | |
| onDuplicate ($originalParentId, $originalQuestionId, $duplicateParentId, $duplicateQuestionId) | |
| Will be called when a question is duplicated (inside a question pool or for insertion in a test) More... | |
| beforeSyncWithOriginal ($origQuestionId, $dupQuestionId, $origParentObjId, $dupParentObjId) | |
| afterSyncWithOriginal ($origQuestionId, $dupQuestionId, $origParentObjId, $dupParentObjId) | |
| onCopy ($sourceParentId, $sourceQuestionId, $targetParentId, $targetQuestionId) | |
| Will be called when a question is copied (into another question pool) More... | |
| duplicateSuggestedSolutionFiles ($parent_id, $question_id) | |
| Duplicates the files of a suggested solution if the question is duplicated. More... | |
| syncSuggestedSolutionFiles ($original_id) | |
| Syncs the files of a suggested solution if the question is synced. More... | |
| copySuggestedSolutionFiles ($source_questionpool_id, $source_question_id) | |
| getRTETextWithMediaObjects () | |
| Collects all text in the question which could contain media objects which were created with the Rich Text Editor. More... | |
| duplicateQuestionHints ($originalQuestionId, $duplicateQuestionId) | |
| buildQuestionDataQuery () | |
| getSelfAssessmentFormatter () | |
Private Member Functions | |
| isValidTextRating ($textRating) | |
Private Attributes | |
| $matchcondition | |
Additional Inherited Members | |
| Static Protected Member Functions inherited from assQuestion | |
| static | getNumExistingSolutionRecords ($activeId, $pass, $questionId) |
| returns the number of existing solution records for the given test active / pass and given question id More... | |
| Protected Attributes inherited from assQuestion | |
| $id | |
| $title | |
| $comment | |
| $owner | |
| $author | |
| $question | |
| $points | |
| $est_working_time | |
| $shuffle | |
| $test_id | |
| $obj_id | |
| $ilias | |
| $tpl | |
| $lng | |
| $db | |
| $outputType | |
| $suggested_solutions | |
| $original_id | |
| $page | |
| $external_id = '' | |
| $questionChangeListeners = array() | |
| $processLocker | |
| $step = null | |
| $lastChange | |
| Static Protected Attributes inherited from assQuestion | |
| static | $allowedFileExtensionsByMimeType |
| static | $allowedCharsetsByMimeType |
| static | $imageSourceFixReplaceMap |
Detailed Description
Class for text questions.
assTextQuestion is a class for text questions
- Version
- $Id$
Definition at line 22 of file class.assTextQuestion.php.
Constructor & Destructor Documentation
◆ __construct()
| assTextQuestion::__construct | ( | $title = "", |
|
$comment = "", |
|||
$author = "", |
|||
$owner = -1, |
|||
$question = "" |
|||
| ) |
assTextQuestion constructor
The constructor takes possible arguments an creates an instance of the assTextQuestion object.
- Parameters
-
string $title A title string to describe the question string $comment A comment string to describe the question string $author A string containing the name of the questions author integer $owner A numerical ID to identify the owner/creator string $question The question string of the text question
Reimplemented from assQuestion.
Definition at line 69 of file class.assTextQuestion.php.
76 {
78 $this->maxNumOfChars = 0;
79 $this->points = 1;
80 $this->answers = array();
81 $this->matchcondition = 0;
82 }
References assQuestion\$author, assQuestion\$comment, assQuestion\$owner, assQuestion\$question, and assQuestion\$title.
Member Function Documentation
◆ addAnswer()
| assTextQuestion::addAnswer | ( | $answertext = "", |
|
$points = 0.0, |
|||
$points_unchecked = 0.0, |
|||
$order = 0, |
|||
$answerimage = "" |
|||
| ) |
Adds a possible answer for a multiple choice question.
A ASS_AnswerBinaryStateImage object will be created and assigned to the array $this->answers.
- Parameters
-
string $answertext The answer text double $points The points for selecting the answer (even negative points can be used) boolean $state Defines the answer as correct (TRUE) or incorrect (FALSE) integer $order A possible display order of the answer double $points The points for not selecting the answer (even negative points can be used) @access public
- See also
- $answers
- ASS_AnswerBinaryStateImage
Definition at line 908 of file class.assTextQuestion.php.
915 {
916 include_once "./Modules/TestQuestionPool/classes/class.assAnswerMultipleResponseImage.php";
917
918 // add answer
920 $this->answers[] = $answer;
921 }
ASS_AnswerBinaryStateImage is a class for answers with a binary state indicator (checked/unchecked,...
Definition: class.assAnswerMultipleResponseImage.php:19
References assQuestion\$points.
Referenced by loadFromDb(), and setAnswers().
Here is the caller graph for this function:
◆ calculateReachedPoints()
| assTextQuestion::calculateReachedPoints | ( | $active_id, | |
$pass = NULL, |
|||
$returndetails = FALSE |
|||
| ) |
Returns the points, a learner has reached answering the question.
The points are calculated from the given answers.
@access public
- Parameters
-
integer $active_id integer $pass boolean $returndetails (deprecated !!)
- Returns
- integer/array $points/$details (array $details is deprecated !!)
Reimplemented from assQuestion.
Definition at line 575 of file class.assTextQuestion.php.
576 {
577 if( $returndetails )
578 {
580 }
581
582 global $ilDB;
583
584 $points = 0;
586 {
588 }
589
590 $result = $ilDB->queryF("SELECT * FROM tst_solutions WHERE active_fi = %s AND question_fi = %s AND pass = %s",
591 array('integer','integer','integer'),
593 );
594
595 // Return min points when no answer was given.
597 {
599 }
600
601 // Return points of points are already on the row.
604 {
606 }
607
609 }
getSolutionMaxPass($active_id)
Returns the maximum pass a users question solution.
Definition: class.assQuestion.php:3171
calculateReachedPointsForSolution($solution)
Definition: class.assTextQuestion.php:490
Base Exception for all Exceptions relating to Modules/Test.
Definition: class.ilTestException.php:15
References $ilDB, $pass, assQuestion\$points, $result, $row, calculateReachedPointsForSolution(), assQuestion\getId(), getMinimumPoints(), and assQuestion\getSolutionMaxPass().
Here is the call graph for this function:
◆ calculateReachedPointsForSolution()
|
protected |
Definition at line 490 of file class.assTextQuestion.php.
491 {
492 // Return min points when keyword relation is NON KEYWORDS
494 {
496 }
497
498 // Return min points if there are no answers present.
500
502 {
504 }
505
507 {
508 case 'any':
509
510 $points = 0;
511
513 {
514 $qst_answer = $answer->getAnswertext();
515 $user_answer = ' '.$solution;
516
518 {
519 $points += $answer->getPoints();
520 }
521 }
522
523 break;
524
525 case 'all':
526
528
530 {
531 $qst_answer = $answer->getAnswertext();
532 $user_answer = ' '.$solution;
533
535 {
536 $points = 0;
537 break;
538 }
539 }
540
541 break;
542
543 case 'one':
544
545 $points = 0;
546
548 {
549 $qst_answer = $answer->getAnswertext();
550 $user_answer = ' '.$solution;
551
553 {
555 break;
556 }
557 }
558
559 break;
560 }
561
563 }
isKeywordMatching($answertext, $a_keyword)
Checks if one of the keywords matches the answertext.
Definition: class.assTextQuestion.php:440
getMaximumPoints()
Returns the maximum points, a learner can reach answering the question.
Definition: class.assTextQuestion.php:344
References $answers, assQuestion\$points, getAnswers(), getKeywordRelation(), getMaximumPoints(), getMinimumPoints(), and isKeywordMatching().
Referenced by calculateReachedPoints().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ copyObject()
| assTextQuestion::copyObject | ( | $target_questionpool_id, | |
$title = "" |
|||
| ) |
Copies an assTextQuestion object.
@access public
Definition at line 239 of file class.assTextQuestion.php.
240 {
241 if ($this->id <= 0)
242 {
243 // The question has not been saved. It cannot be duplicated
244 return;
245 }
246 // duplicate the question in database
247 $clone = $this;
248 include_once ("./Modules/TestQuestionPool/classes/class.assQuestion.php");
250 $clone->id = -1;
251 $source_questionpool_id = $this->getObjId();
252 $clone->setObjId($target_questionpool_id);
254 {
255 $clone->setTitle($title);
256 }
257 $clone->saveToDb();
258 // copy question page content
259 $clone->copyPageOfQuestion($original_id);
260 // copy XHTML media objects
261 $clone->copyXHTMLMediaObjectsOfQuestion($original_id);
262 // duplicate answers
263 #$clone->duplicateAnswers($original_id);
264
265 $clone->onCopy($source_questionpool_id, $original_id, $clone->getObjId(), $clone->getId());
266
267 return $clone->id;
268 }
static _getOriginalId($question_id)
Returns the original id of a question.
Definition: class.assQuestion.php:2957
References assQuestion\$original_id, assQuestion\$title, assQuestion\_getOriginalId(), and assQuestion\getObjId().
Here is the call graph for this function:
◆ createNewOriginalFromThisDuplicate()
| assTextQuestion::createNewOriginalFromThisDuplicate | ( | $targetParentId, | |
$targetQuestionTitle = "" |
|||
| ) |
Definition at line 270 of file class.assTextQuestion.php.
271 {
272 if ($this->id <= 0)
273 {
274 // The question has not been saved. It cannot be duplicated
275 return;
276 }
277
278 include_once ("./Modules/TestQuestionPool/classes/class.assQuestion.php");
279
280 $sourceQuestionId = $this->id;
281 $sourceParentId = $this->getObjId();
282
283 // duplicate the question in database
284 $clone = $this;
285 $clone->id = -1;
286
287 $clone->setObjId($targetParentId);
288
289 if ($targetQuestionTitle)
290 {
291 $clone->setTitle($targetQuestionTitle);
292 }
293
294 $clone->saveToDb();
295 // copy question page content
296 $clone->copyPageOfQuestion($sourceQuestionId);
297 // copy XHTML media objects
298 $clone->copyXHTMLMediaObjectsOfQuestion($sourceQuestionId);
299 // duplicate answers
300 #$clone->duplicateAnswers($sourceQuestionId);
301
302 $clone->onCopy($sourceParentId, $sourceQuestionId, $clone->getObjId(), $clone->getId());
303
304 return $clone->id;
305 }
References assQuestion\$id, and assQuestion\getObjId().
Here is the call graph for this function:
◆ createRandomSolution()
| assTextQuestion::createRandomSolution | ( | $test_id, | |
| $user_id | |||
| ) |
Reimplemented from assQuestion.
Definition at line 772 of file class.assTextQuestion.php.
773 {
774 }
◆ deleteAnswer()
| assTextQuestion::deleteAnswer | ( | $index = 0 | ) |
Deletes an answer with a given index.
The index of the first answer is 0, the index of the second answer is 1 and so on.
- Parameters
-
integer $index A nonnegative index of the n-th answer @access public
- See also
- $answers
Definition at line 954 of file class.assTextQuestion.php.
955 {
956 if ($index < 0) return;
957 if (count($this->answers) < 1) return;
958 if ($index >= count($this->answers)) return;
959 $answer = $this->answers[$index];
960 if (strlen($answer->getImage())) $this->deleteImage($answer->getImage());
961 unset($this->answers[$index]);
962 $this->answers = array_values($this->answers);
963 for ($i = 0; $i < count($this->answers); $i++)
964 {
965 if ($this->answers[$i]->getOrder() > $index)
966 {
967 $this->answers[$i]->setOrder($i);
968 }
969 }
970 }
◆ duplicate()
| assTextQuestion::duplicate | ( | $for_test = true, |
|
$title = "", |
|||
$author = "", |
|||
$owner = "", |
|||
$testObjId = null |
|||
| ) |
Duplicates an assTextQuestion.
@access public
Reimplemented from assQuestion.
Definition at line 179 of file class.assTextQuestion.php.
180 {
181 if ($this->id <= 0)
182 {
183 // The question has not been saved. It cannot be duplicated
184 return;
185 }
186 // duplicate the question in database
187 $this_id = $this->getId();
188 $thisObjId = $this->getObjId();
189
190 $clone = $this;
191 include_once ("./Modules/TestQuestionPool/classes/class.assQuestion.php");
193 $clone->id = -1;
194
195 if( (int)$testObjId > 0 )
196 {
197 $clone->setObjId($testObjId);
198 }
199
201 {
202 $clone->setTitle($title);
203 }
204
206 {
207 $clone->setAuthor($author);
208 }
210 {
211 $clone->setOwner($owner);
212 }
213
214 if ($for_test)
215 {
216 $clone->saveToDb($original_id);
217 }
218 else
219 {
220 $clone->saveToDb();
221 }
222
223 // copy question page content
224 $clone->copyPageOfQuestion($this_id);
225 // copy XHTML media objects
226 $clone->copyXHTMLMediaObjectsOfQuestion($this_id);
227 #$clone->duplicateAnswers($this_id);
228
229 $clone->onDuplicate($thisObjId, $this_id, $clone->getObjId(), $clone->getId());
230
231 return $clone->id;
232 }
References assQuestion\$author, assQuestion\$original_id, assQuestion\$owner, assQuestion\$title, assQuestion\_getOriginalId(), assQuestion\getId(), and assQuestion\getObjId().
Here is the call graph for this function:
◆ duplicateAnswers()
| assTextQuestion::duplicateAnswers | ( | $original_id | ) |
Definition at line 1016 of file class.assTextQuestion.php.
1017 {
1018 global $ilDB;
1019
1021 array('integer'),
1022 array($original_id)
1023 );
1025 {
1027 {
1029 $affectedRows = $ilDB->manipulateF(
1030 "INSERT INTO qpl_a_essay (answer_id, question_fi, answertext, points)
1031 VALUES (%s, %s, %s, %s)",
1032 array('integer','integer','text','float'),
1034 );
1035 }
1036 }
1037 }
References $ilDB, assQuestion\$original_id, $result, $row, and assQuestion\getId().
Here is the call graph for this function:
◆ flushAnswers()
| assTextQuestion::flushAnswers | ( | ) |
Deletes all answers.
@access public
- See also
- $answers
Definition at line 983 of file class.assTextQuestion.php.
984 {
985 $this->answers = array();
986 }
Referenced by loadFromDb(), and setAnswers().
Here is the caller graph for this function:
◆ getAdditionalTableName()
| assTextQuestion::getAdditionalTableName | ( | ) |
Returns the name of the additional question data table in the database.
- Returns
- string The additional table name @access public
Reimplemented from assQuestion.
Definition at line 831 of file class.assTextQuestion.php.
832 {
833 return "qpl_qst_essay";
834 }
Referenced by loadFromDb().
Here is the caller graph for this function:
◆ getAnswer()
| assTextQuestion::getAnswer | ( | $index = 0 | ) |
Returns an answer with a given index.
The index of the first answer is 0, the index of the second answer is 1 and so on.
- Parameters
-
integer $index A nonnegative index of the n-th answer
- Returns
- object ASS_AnswerBinaryStateImage-Object containing the answer @access public
- See also
- $answers
Definition at line 937 of file class.assTextQuestion.php.
938 {
939 if ($index < 0) return NULL;
940 if (count($this->answers) < 1) return NULL;
941 if ($index >= count($this->answers)) return NULL;
942
943 return $this->answers[$index];
944 }
◆ getAnswerCount()
| assTextQuestion::getAnswerCount | ( | ) |
Definition at line 890 of file class.assTextQuestion.php.
891 {
892 return count($this->answers);
893 }
◆ getAnswers()
| assTextQuestion::getAnswers | ( | ) |
Definition at line 923 of file class.assTextQuestion.php.
References $answers.
Referenced by calculateReachedPointsForSolution().
Here is the caller graph for this function:
◆ getAnswerTableName()
| assTextQuestion::getAnswerTableName | ( | ) |
Returns the name of the answer table in the database.
- Returns
- string The answer table name @access public
Reimplemented from assQuestion.
Definition at line 972 of file class.assTextQuestion.php.
973 {
974 return 'qpl_a_essay';
975 }
◆ getKeywordRelation()
| assTextQuestion::getKeywordRelation | ( | ) |
Definition at line 1039 of file class.assTextQuestion.php.
1040 {
1042 }
References $keyword_relation.
Referenced by calculateReachedPointsForSolution(), getMaximumPoints(), and getMinimumPoints().
Here is the caller graph for this function:
◆ getMaximumPoints()
| assTextQuestion::getMaximumPoints | ( | ) |
Returns the maximum points, a learner can reach answering the question.
@access public
- See also
- $points
Reimplemented from assQuestion.
Definition at line 344 of file class.assTextQuestion.php.
345 {
347 {
348 return parent::getPoints();
349 }
350
351 $points = 0;
352
353 foreach ($this->answers as $answer)
354 {
355 if ($answer->getPoints() > 0)
356 {
358 }
359 }
360
362 }
References assQuestion\$points, and getKeywordRelation().
Referenced by calculateReachedPointsForSolution(), and isComplete().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ getMaxNumOfChars()
| assTextQuestion::getMaxNumOfChars | ( | ) |
Gets the maximum number of characters for the text solution.
- Returns
- integer The maximum number of characters for the text solution @access public
- See also
- $maxNumOfChars
Definition at line 314 of file class.assTextQuestion.php.
315 {
316 if (strcmp($this->maxNumOfChars, "") == 0)
317 {
318 return 0;
319 }
320 else
321 {
323 }
324 }
References $maxNumOfChars.
Referenced by getSolutionSubmit(), and toJSON().
Here is the caller graph for this function:
◆ getMinimumPoints()
| assTextQuestion::getMinimumPoints | ( | ) |
Definition at line 364 of file class.assTextQuestion.php.
365 {
367 {
368 return 0;
369 }
370
371 $points = 0;
372
373 foreach ($this->answers as $answer)
374 {
375 if ($answer->getPoints() < 0)
376 {
378 }
379 }
380
382 }
References assQuestion\$points, and getKeywordRelation().
Referenced by calculateReachedPoints(), and calculateReachedPointsForSolution().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ getQuestionType()
| assTextQuestion::getQuestionType | ( | ) |
Returns the question type of the question.
- Returns
- integer The question type of the question @access public
Reimplemented from assQuestion.
Definition at line 782 of file class.assTextQuestion.php.
783 {
784 return "assTextQuestion";
785 }
Referenced by toJSON().
Here is the caller graph for this function:
◆ getRTETextWithMediaObjects()
| assTextQuestion::getRTETextWithMediaObjects | ( | ) |
Collects all text in the question which could contain media objects which were created with the Rich Text Editor.
Reimplemented from assQuestion.
Definition at line 840 of file class.assTextQuestion.php.
841 {
842 return parent::getRTETextWithMediaObjects();
843 }
◆ getScoringModesWithPointsByKeyword()
|
static |
Definition at line 1063 of file class.assTextQuestion.php.
1064 {
1065 return array('any');
1066 }
Referenced by assTextQuestionGUI\getBestAnswer().
Here is the caller graph for this function:
◆ getScoringModesWithPointsByQuestion()
|
static |
Definition at line 1058 of file class.assTextQuestion.php.
1059 {
1060 return array('non', 'all', 'one');
1061 }
◆ getSolutionSubmit()
| assTextQuestion::getSolutionSubmit | ( | ) |
- Returns
- mixed|string
Definition at line 681 of file class.assTextQuestion.php.
682 {
685 {
686 include_once "./Services/Utilities/classes/class.ilStr.php";
687 $text_without_tags = preg_replace("/<[^>*?]>/is", "", $text);
688 $len_with_tags = ilStr::strLen($text);
689 $len_without_tags = ilStr::strLen($text_without_tags);
691 {
693 {
695 }
696 }
697 }
699 {
700 $text = preg_replace("/<[^>]*$/ims", "", $text);
701 return $text;
702 } else
703 {
704 //$text = htmlentities($text, ENT_QUOTES, "UTF-8");
705 }
706 return $text;
707 }
getMaxNumOfChars()
Gets the maximum number of characters for the text solution.
Definition: class.assTextQuestion.php:314
static stripSlashes($a_str, $a_strip_html=true, $a_allow="")
strip slashes if magic qoutes is enabled
Definition: class.ilUtil.php:2673
References $_POST, getMaxNumOfChars(), assQuestion\isHTML(), ilUtil\stripSlashes(), ilStr\strLen(), and ilStr\subStr().
Referenced by saveWorkingData().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ getTextRating()
| assTextQuestion::getTextRating | ( | ) |
Returns the rating option for text comparisons.
- Returns
- string The rating option for text comparisons
- See also
- $text_rating @access User interface
Definition at line 794 of file class.assTextQuestion.php.
795 {
797 }
References $text_rating.
Referenced by isKeywordMatching().
Here is the caller graph for this function:
◆ getValidScoringModes()
|
static |
Definition at line 1053 of file class.assTextQuestion.php.
1054 {
1055 return array_merge(self::getScoringModesWithPointsByQuestion(), self::getScoringModesWithPointsByKeyword());
1056 }
◆ isAnswered()
| assTextQuestion::isAnswered | ( | $active_id, | |
| $pass | |||
| ) |
returns boolean wether the question is answered during test pass or not
(overwrites method in class assQuestion)
- Parameters
-
integer $active_id integer $pass
- Returns
- boolean $answered
Reimplemented from assQuestion.
Definition at line 1079 of file class.assTextQuestion.php.
1080 {
1081 $numExistingSolutionRecords = assQuestion::getNumExistingSolutionRecords($active_id, $pass, $this->getId());
1082
1083 return $numExistingSolutionRecords > 0;
1084 }
static getNumExistingSolutionRecords($activeId, $pass, $questionId)
returns the number of existing solution records for the given test active / pass and given question i...
Definition: class.assQuestion.php:4356
References $pass, assQuestion\getId(), and assQuestion\getNumExistingSolutionRecords().
Here is the call graph for this function:
◆ isComplete()
| assTextQuestion::isComplete | ( | ) |
Returns true, if a multiple choice question is complete for use.
- Returns
- boolean True, if the multiple choice question is complete for use, otherwise false
Reimplemented from assQuestion.
Definition at line 89 of file class.assTextQuestion.php.
90 {
91 if (strlen($this->title)
92 && $this->author
93 && $this->question
94 && $this->getMaximumPoints() > 0
95 )
96 {
97 return true;
98 }
99 return false;
100 }
References getMaximumPoints().
Here is the call graph for this function:
◆ isKeywordMatching()
| assTextQuestion::isKeywordMatching | ( | $answertext, | |
| $a_keyword | |||
| ) |
Checks if one of the keywords matches the answertext.
- Parameters
-
string $answertext The answertext of the user string $a_keyword The keyword which should be checked
- Returns
- boolean TRUE if the keyword matches, FALSE otherwise @access private
Definition at line 440 of file class.assTextQuestion.php.
441 {
442 $result = FALSE;
443 $textrating = $this->getTextRating();
444 include_once "./Services/Utilities/classes/class.ilStr.php";
445 switch ($textrating)
446 {
448 if (ilStr::strPos(ilStr::strToLower($answertext), ilStr::strToLower($a_keyword)) !== false) return TRUE;
449 break;
452 break;
453 }
454
455 // "<p>red</p>" would not match "red" even with distance of 5
456 $answertext = strip_tags($answertext);
457
458 $answerwords = array();
459 if (preg_match_all("/([^\s.]+)/", $answertext, $matches))
460 {
461 foreach ($matches[1] as $answerword)
462 {
463 array_push($answerwords, trim($answerword));
464 }
465 }
466 foreach ($answerwords as $a_original)
467 {
468 switch ($textrating)
469 {
471 if (levenshtein($a_original, $a_keyword) <= 1) return TRUE;
472 break;
474 if (levenshtein($a_original, $a_keyword) <= 2) return TRUE;
475 break;
477 if (levenshtein($a_original, $a_keyword) <= 3) return TRUE;
478 break;
480 if (levenshtein($a_original, $a_keyword) <= 4) return TRUE;
481 break;
483 if (levenshtein($a_original, $a_keyword) <= 5) return TRUE;
484 break;
485 }
486 }
488 }
getTextRating()
Returns the rating option for text comparisons.
Definition: class.assTextQuestion.php:794
const TEXTGAP_RATING_LEVENSHTEIN5
Definition: inc.AssessmentConstants.php:50
const TEXTGAP_RATING_LEVENSHTEIN4
Definition: inc.AssessmentConstants.php:49
const TEXTGAP_RATING_LEVENSHTEIN3
Definition: inc.AssessmentConstants.php:48
const TEXTGAP_RATING_CASESENSITIVE
Definition: inc.AssessmentConstants.php:45
const TEXTGAP_RATING_LEVENSHTEIN2
Definition: inc.AssessmentConstants.php:47
const TEXTGAP_RATING_CASEINSENSITIVE
Definition: inc.AssessmentConstants.php:44
const TEXTGAP_RATING_LEVENSHTEIN1
Definition: inc.AssessmentConstants.php:46
References $result, getTextRating(), ilStr\strPos(), ilStr\strToLower(), TEXTGAP_RATING_CASEINSENSITIVE, TEXTGAP_RATING_CASESENSITIVE, TEXTGAP_RATING_LEVENSHTEIN1, TEXTGAP_RATING_LEVENSHTEIN2, TEXTGAP_RATING_LEVENSHTEIN3, TEXTGAP_RATING_LEVENSHTEIN4, and TEXTGAP_RATING_LEVENSHTEIN5.
Referenced by calculateReachedPointsForSolution().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ isObligationPossible()
|
static |
returns boolean wether it is possible to set this question type as obligatory or not considering the current question configuration
(overwrites method in class assQuestion)
- Parameters
-
integer $questionId
- Returns
- boolean $obligationPossible
Reimplemented from assQuestion.
Definition at line 1096 of file class.assTextQuestion.php.
1097 {
1098 return true;
1099 }
◆ isValidTextRating()
|
private |
Definition at line 415 of file class.assTextQuestion.php.
416 {
417 switch($textRating)
418 {
426 return true;
427 }
428
429 return false;
430 }
References TEXTGAP_RATING_CASEINSENSITIVE, TEXTGAP_RATING_CASESENSITIVE, TEXTGAP_RATING_LEVENSHTEIN1, TEXTGAP_RATING_LEVENSHTEIN2, TEXTGAP_RATING_LEVENSHTEIN3, TEXTGAP_RATING_LEVENSHTEIN4, and TEXTGAP_RATING_LEVENSHTEIN5.
Referenced by loadFromDb().
Here is the caller graph for this function:
◆ loadFromDb()
| assTextQuestion::loadFromDb | ( | $question_id | ) |
Loads a assTextQuestion object from a database.
- Parameters
-
object $db A pear DB object integer $question_id A unique key which defines the text question in the database @access public
Reimplemented from assQuestion.
Definition at line 122 of file class.assTextQuestion.php.
123 {
124 global $ilDB;
125
126 $result = $ilDB->queryF("SELECT qpl_questions.*, " . $this->getAdditionalTableName() . ".* FROM qpl_questions LEFT JOIN " . $this->getAdditionalTableName() . " ON " . $this->getAdditionalTableName() . ".question_fi = qpl_questions.question_id WHERE qpl_questions.question_id = %s",
127 array("integer"),
128 array($question_id)
129 );
131 {
133 $this->setId($question_id);
142 include_once("./Services/RTE/classes/class.ilRTE.php");
146 $this->setTextRating($this->isValidTextRating($data["textgap_rating"]) ? $data["textgap_rating"] : TEXTGAP_RATING_CASEINSENSITIVE);
148 $this->setEstimatedWorkingTime(substr($data["working_time"], 0, 2), substr($data["working_time"], 3, 2), substr($data["working_time"], 6, 2));
150
151 try
152 {
154 }
156 {
157 }
158 }
159
161 array("integer"),
162 array($this->getId())
163 );
164
165 $this->flushAnswers();
167 {
169 }
170
171 parent::loadFromDb($question_id);
172 }
setTitle($title="")
Sets the title string of the assQuestion object.
Definition: class.assQuestion.php:453
setOwner($owner="")
Sets the creator/owner ID of the assQuestion object.
Definition: class.assQuestion.php:601
setEstimatedWorkingTime($hour=0, $min=0, $sec=0)
Sets the estimated working time of a question from given hour, minute and second.
Definition: class.assQuestion.php:536
setAuthor($author="")
Sets the authors name of the assQuestion object.
Definition: class.assQuestion.php:585
setPoints($a_points)
Sets the maximum available points for the question.
Definition: class.assQuestion.php:3160
setComment($comment="")
Sets the comment string of the assQuestion object.
Definition: class.assQuestion.php:489
setAdditionalContentEditingMode($additinalContentEditingMode)
setter for additional content editing mode for this question
Definition: class.assQuestion.php:4397
setQuestion($question="")
Sets the question string of the question object.
Definition: class.assQuestion.php:3598
setMaxNumOfChars($maxchars=0)
Sets the maximum number of characters for the text solution.
Definition: class.assTextQuestion.php:333
addAnswer( $answertext="", $points=0.0, $points_unchecked=0.0, $order=0, $answerimage="")
Adds a possible answer for a multiple choice question.
Definition: class.assTextQuestion.php:908
setKeywordRelation($a_relation)
This method implements a default behaviour.
Definition: class.assTextQuestion.php:1048
getAdditionalTableName()
Returns the name of the additional question data table in the database.
Definition: class.assTextQuestion.php:831
setTextRating($a_text_rating)
Sets the rating option for text comparisons.
Definition: class.assTextQuestion.php:806
isValidTextRating($textRating)
Definition: class.assTextQuestion.php:415
static _replaceMediaObjectImageSrc($a_text, $a_direction=0, $nic=IL_INST_ID)
replaces image source from mob image urls with the mob id or replaces mob id with the correct image s...
Definition: class.ilRTE.php:236
References $data, $ilDB, $result, $row, ilRTE\_replaceMediaObjectImageSrc(), addAnswer(), flushAnswers(), getAdditionalTableName(), assQuestion\getId(), isValidTextRating(), assQuestion\setAdditionalContentEditingMode(), assQuestion\setAuthor(), assQuestion\setComment(), assQuestion\setEstimatedWorkingTime(), assQuestion\setId(), setKeywordRelation(), setMaxNumOfChars(), assQuestion\setNrOfTries(), assQuestion\setObjId(), assQuestion\setOriginalId(), assQuestion\setOwner(), assQuestion\setPoints(), assQuestion\setQuestion(), assQuestion\setShuffle(), setTextRating(), assQuestion\setTitle(), and TEXTGAP_RATING_CASEINSENSITIVE.
Here is the call graph for this function:
◆ reworkWorkingData()
|
protected |
Reworks the allready saved working data if neccessary.
@access protected
- Parameters
-
integer $active_id integer $pass boolean $obligationsAnswered
Reimplemented from assQuestion.
Definition at line 767 of file class.assTextQuestion.php.
768 {
769 // nothing to rework!
770 }
◆ saveToDb()
| assTextQuestion::saveToDb | ( | $original_id = "" | ) |
Saves a assTextQuestion object to a database.
- Parameters
-
string $original_id
Reimplemented from assQuestion.
Definition at line 107 of file class.assTextQuestion.php.
108 {
110 $this->saveAdditionalQuestionDataToDb();
111 $this->saveAnswerSpecificDataToDb();
112 parent::saveToDb($original_id);
113 }
saveQuestionDataToDb($original_id="")
Definition: class.assQuestion.php:2426
saveAnswerSpecificDataToDb()
Saves the answer specific records into a question types answer table.
saveAdditionalQuestionDataToDb()
Saves a record to the question types additional data table.
References assQuestion\$original_id, ilObjQuestionScoringAdjustable\saveAdditionalQuestionDataToDb(), ilObjAnswerScoringAdjustable\saveAnswerSpecificDataToDb(), and assQuestion\saveQuestionDataToDb().
Here is the call graph for this function:
◆ saveWorkingData()
| assTextQuestion::saveWorkingData | ( | $active_id, | |
$pass = NULL |
|||
| ) |
Saves the learners input of the question to the database.
@access public
- Parameters
-
integer $active_id Active id of the user integer $pass Test pass
- Returns
- boolean $status
Reimplemented from assQuestion.
Definition at line 619 of file class.assTextQuestion.php.
620 {
621 global $ilDB;
622 global $ilUser;
623
624 include_once "./Services/Utilities/classes/class.ilStr.php";
626 {
627 include_once "./Modules/Test/classes/class.ilObjTest.php";
629 }
630
631 $this->getProcessLocker()->requestUserSolutionUpdateLock();
632
633 $affectedRows = $ilDB->manipulateF("DELETE FROM tst_solutions WHERE active_fi = %s AND question_fi = %s AND pass = %s",
634 array('integer','integer','integer'),
636 );
637
638 $text = $this->getSolutionSubmit();
639
640 $entered_values = 0;
641 if (strlen($text))
642 {
645 "solution_id" => array("integer", $next_id),
646 "active_fi" => array("integer", $active_id),
648 "value1" => array("clob", trim($text)),
649 "value2" => array("clob", null),
651 "tstamp" => array("integer", time())
652 ));
653 $entered_values++;
654 }
655
656 $this->getProcessLocker()->releaseUserSolutionUpdateLock();
657
658 if ($entered_values)
659 {
660 include_once ("./Modules/Test/classes/class.ilObjAssessmentFolder.php");
662 {
663 $this->logAction($this->lng->txtlng("assessment", "log_user_entered_values", ilObjAssessmentFolder::_getLogLanguage()), $active_id, $this->getId());
664 }
665 }
666 else
667 {
668 include_once ("./Modules/Test/classes/class.ilObjAssessmentFolder.php");
670 {
671 $this->logAction($this->lng->txtlng("assessment", "log_user_not_entered_values", ilObjAssessmentFolder::_getLogLanguage()), $active_id, $this->getId());
672 }
673 }
674
675 return true;
676 }
logAction($logtext="", $active_id="", $question_id="")
Logs an action into the Test&Assessment log.
Definition: class.assQuestion.php:1440
_getLogLanguage()
retrieve the log language for assessment logging
Definition: class.ilObjAssessmentFolder.php:222
_enabledAssessmentLogging()
check wether assessment logging is enabled or not
Definition: class.ilObjAssessmentFolder.php:177
_getPass($active_id)
Retrieves the actual pass of a given user for a given test.
Definition: class.ilObjTest.php:8204
References $ilDB, $ilUser, $pass, ilObjAssessmentFolder\_enabledAssessmentLogging(), ilObjAssessmentFolder\_getLogLanguage(), ilObjTest\_getPass(), assQuestion\getId(), assQuestion\getProcessLocker(), getSolutionSubmit(), and assQuestion\logAction().
Here is the call graph for this function:
◆ setAnswers()
| assTextQuestion::setAnswers | ( | $answers | ) |
Definition at line 988 of file class.assTextQuestion.php.
989 {
991 {
993 $withPoints = true;
994 }
995 else
996 {
997 $count = count($answers);
998 $withPoints = false;
999 }
1000
1001 $this->flushAnswers();
1002
1003 for( $i = 0; $i < $count; $i++ )
1004 {
1005 if($withPoints)
1006 {
1008 }
1009 else
1010 {
1012 }
1013 }
1014 }
References $answers, addAnswer(), and flushAnswers().
Here is the call graph for this function:
◆ setExportDetailsXLS()
| assTextQuestion::setExportDetailsXLS | ( | & | $worksheet, |
| $startrow, | |||
| $active_id, | |||
| $pass, | |||
| & | $format_title, | ||
| & | $format_bold | ||
| ) |
Creates an Excel worksheet for the detailed cumulated results of this question.
- Parameters
-
object $worksheet Reference to the parent excel worksheet object $startrow Startrow of the output in the excel worksheet object $active_id Active id of the participant object $pass Test pass object $format_title Excel title format object $format_bold Excel bold format array $eval_data Cumulated evaluation data @access public
Reimplemented from assQuestion.
Definition at line 857 of file class.assTextQuestion.php.
858 {
859 include_once ("./Services/Excel/classes/class.ilExcelUtils.php");
861 $worksheet->writeString($startrow, 0, ilExcelUtils::_convert_text($this->lng->txt($this->getQuestionType())), $format_title);
862 $worksheet->writeString($startrow, 1, ilExcelUtils::_convert_text($this->getTitle()), $format_title);
863 $i = 1;
864 $worksheet->writeString($startrow + $i, 0, ilExcelUtils::_convert_text($this->lng->txt("result")), $format_bold);
865 if (strlen($solutions[0]["value1"]))
866 {
868 }
869 $i++;
870 return $startrow + $i + 1;
871 }
& getSolutionValues($active_id, $pass=NULL)
Loads solutions of a given user from the database an returns it.
Definition: class.assQuestion.php:1622
_convert_text($a_text, $a_target="has been removed")
Definition: class.ilExcelUtils.php:14
References $pass, ilExcelUtils\_convert_text(), assQuestion\getSolutionValues(), and assQuestion\getTitle().
Here is the call graph for this function:
◆ setKeywordRelation()
| assTextQuestion::setKeywordRelation | ( | $a_relation | ) |
This method implements a default behaviour.
During the creation of a text question, the record which holds the keyword relation is not existing, so keyword_relation defaults to 'one'.
Definition at line 1048 of file class.assTextQuestion.php.
1049 {
1050 $this->keyword_relation = $a_relation;
1051 }
Referenced by loadFromDb().
Here is the caller graph for this function:
◆ setMaxNumOfChars()
| assTextQuestion::setMaxNumOfChars | ( | $maxchars = 0 | ) |
Sets the maximum number of characters for the text solution.
- Parameters
-
integer $maxchars The maximum number of characters for the text solution @access public
- See also
- $maxNumOfChars
Definition at line 333 of file class.assTextQuestion.php.
334 {
335 $this->maxNumOfChars = $maxchars;
336 }
Referenced by loadFromDb().
Here is the caller graph for this function:
◆ setReachedPoints()
| assTextQuestion::setReachedPoints | ( | $active_id, | |
| $points, | |||
$pass = NULL |
|||
| ) |
Sets the points, a learner has reached answering the question.
- Parameters
-
integer $user_id The database ID of the learner integer $test_id The database Id of the test containing the question integer $points The points the user has reached answering the question
- Returns
- boolean true on success, otherwise false @access public
Definition at line 392 of file class.assTextQuestion.php.
393 {
394 global $ilDB;
395
397 {
399 {
401 }
402 $affectedRows = $ilDB->manipulateF("UPDATE tst_test_result SET points = %s WHERE active_fi = %s AND question_fi = %s AND pass = %s",
403 array('float','integer','integer','integer'),
405 );
406 $this->_updateTestPassResults($active_id, $pass);
407 return TRUE;
408 }
409 else
410 {
411 return TRUE;
412 }
413 }
getPoints()
Returns the maximum available points for the question.
Definition: class.assQuestion.php:3141
References $ilDB, $pass, assQuestion\$points, assQuestion\getId(), assQuestion\getPoints(), and assQuestion\getSolutionMaxPass().
Here is the call graph for this function:
◆ setTextRating()
| assTextQuestion::setTextRating | ( | $a_text_rating | ) |
Sets the rating option for text comparisons.
- Parameters
-
string $a_textgap_rating The rating option for text comparisons
- See also
- $textgap_rating @access User interface
Definition at line 806 of file class.assTextQuestion.php.
807 {
808 switch ($a_text_rating)
809 {
817 $this->text_rating = $a_text_rating;
818 break;
819 default:
820 $this->text_rating = TEXTGAP_RATING_CASEINSENSITIVE;
821 break;
822 }
823 }
References TEXTGAP_RATING_CASEINSENSITIVE, TEXTGAP_RATING_CASESENSITIVE, TEXTGAP_RATING_LEVENSHTEIN1, TEXTGAP_RATING_LEVENSHTEIN2, TEXTGAP_RATING_LEVENSHTEIN3, TEXTGAP_RATING_LEVENSHTEIN4, and TEXTGAP_RATING_LEVENSHTEIN5.
Referenced by loadFromDb().
Here is the caller graph for this function:
◆ toJSON()
| assTextQuestion::toJSON | ( | ) |
Returns a JSON representation of the question.
Reimplemented from assQuestion.
Definition at line 876 of file class.assTextQuestion.php.
877 {
878 include_once("./Services/RTE/classes/class.ilRTE.php");
879 $result = array();
888 }
getQuestionType()
Returns the question type of the question.
Definition: class.assTextQuestion.php:782
References $result, assQuestion\formatSAQuestion(), assQuestion\getId(), getMaxNumOfChars(), assQuestion\getNrOfTries(), assQuestion\getQuestion(), getQuestionType(), assQuestion\getShuffle(), and assQuestion\getTitle().
Here is the call graph for this function:
Field Documentation
◆ $answers
| assTextQuestion::$answers |
Definition at line 43 of file class.assTextQuestion.php.
Referenced by calculateReachedPointsForSolution(), getAnswers(), and setAnswers().
◆ $keyword_relation
| assTextQuestion::$keyword_relation = 'any' |
Definition at line 55 of file class.assTextQuestion.php.
Referenced by getKeywordRelation().
◆ $keywords
| assTextQuestion::$keywords |
Definition at line 41 of file class.assTextQuestion.php.
◆ $matchcondition
|
private |
Definition at line 53 of file class.assTextQuestion.php.
◆ $maxNumOfChars
| assTextQuestion::$maxNumOfChars |
Definition at line 31 of file class.assTextQuestion.php.
Referenced by getMaxNumOfChars().
◆ $text_rating
| assTextQuestion::$text_rating |
Definition at line 50 of file class.assTextQuestion.php.
Referenced by getTextRating().
The documentation for this class was generated from the following file:
- Modules/TestQuestionPool/classes/class.assTextQuestion.php
