Class for matching questions. More...
Inheritance diagram for assMatchingQuestion:
Collaboration diagram for assMatchingQuestion:
Public Member Functions | |
| __construct ( $title="", $comment="", $author="", $owner=-1, $question="", $matching_type=MT_TERMS_DEFINITIONS) | |
| assMatchingQuestion constructor More... | |
| isComplete () | |
| Returns true, if a matching question is complete for use. More... | |
| saveToDb ($original_id="") | |
| Saves a assMatchingQuestion object to a database. More... | |
| saveAnswerSpecificDataToDb () | |
| Saves the answer specific records into a question types answer table. More... | |
| saveAdditionalQuestionDataToDb () | |
| Saves a record to the question types additional data table. More... | |
| loadFromDb ($question_id) | |
| Loads a assMatchingQuestion object from a database. More... | |
| duplicate ($for_test=true, $title="", $author="", $owner="", $testObjId=null) | |
| Duplicates an assMatchingQuestion. More... | |
| copyObject ($target_questionpool_id, $title="") | |
| Copies an assMatchingQuestion. More... | |
| createNewOriginalFromThisDuplicate ($targetParentId, $targetQuestionTitle="") | |
| duplicateImages ($question_id, $objectId=null) | |
| copyImages ($question_id, $source_questionpool) | |
| insertMatchingPair ($position, $term=null, $definition=null, $points=0.0) | |
| Inserts a matching pair for an matching choice question. More... | |
| addMatchingPair ($term=null, $definition=null, $points=0.0) | |
| Adds an matching pair for an matching choice question. More... | |
| getTermWithIdentifier ($a_identifier) | |
| Returns a term with a given identifier. More... | |
| getDefinitionWithIdentifier ($a_identifier) | |
| Returns a definition with a given identifier. More... | |
| getMatchingPair ($index=0) | |
| Returns a matching pair with a given index. More... | |
| deleteMatchingPair ($index=0) | |
| Deletes a matching pair with a given index. More... | |
| flushMatchingPairs () | |
| Deletes all matching pairs. More... | |
| getMatchingPairCount () | |
| Returns the number of matching pairs. More... | |
| getTerms () | |
| Returns the terms of the matching question. More... | |
| getDefinitions () | |
| Returns the definitions of the matching question. More... | |
| getTermCount () | |
| Returns the number of terms. More... | |
| getDefinitionCount () | |
| Returns the number of definitions. More... | |
| addTerm ($term) | |
| Adds a term. More... | |
| addDefinition ($definition) | |
| Adds a definition. More... | |
| insertTerm ($position, $term=null) | |
| Inserts a term. More... | |
| insertDefinition ($position, $definition=null) | |
| Inserts a definition. More... | |
| flushTerms () | |
| Deletes all terms. More... | |
| flushDefinitions () | |
| Deletes all definitions. More... | |
| deleteTerm ($position) | |
| Deletes a term. More... | |
| deleteDefinition ($position) | |
| Deletes a definition. More... | |
| setTerm ($term, $index) | |
| Sets a specific term. More... | |
| calculateReachedPoints ($active_id, $pass=null, $authorizedSolution=true, $returndetails=false) | |
| Returns the points, a learner has reached answering the question. More... | |
| getMaximumPoints () | |
| Calculates and Returns the maximum points, a learner can reach answering the question. More... | |
| getMaximumScoringMatchingPairs () | |
| fetchIndexedValuesFromValuePairs (array $valuePairs) | |
| getEncryptedFilename ($filename) | |
| Returns the encrypted save filename of a matching picture Images are saved with an encrypted filename to prevent users from cheating by guessing the solution from the image filename. More... | |
| removeTermImage ($index) | |
| removeDefinitionImage ($index) | |
| deleteImagefile ($filename) | |
| Deletes an imagefile from the system if the file is deleted manually. More... | |
| setImageFile ($image_tempfilename, $image_filename, $previous_filename='') | |
| Sets the image file and uploads the image to the object's image directory. More... | |
| saveWorkingData ($active_id, $pass=null, $authorized=true) | |
| Saves the learners input of the question to the database. More... | |
| getRandomId () | |
| setShuffle ($shuffle=true) | |
| Sets the shuffle flag. More... | |
| getQuestionType () | |
| Returns the question type of the question. 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... | |
| getRTETextWithMediaObjects () | |
| Collects all text in the question which could contain media objects which were created with the Rich Text Editor. More... | |
| & | getMatchingPairs () |
| Returns the matchingpairs array. More... | |
| setExportDetailsXLS ($worksheet, $startrow, $active_id, $pass) | |
| {} More... | |
| getThumbGeometry () | |
| Get the thumbnail geometry. More... | |
| getThumbSize () | |
| Get the thumbnail geometry. More... | |
| setThumbGeometry ($a_geometry) | |
| Set the thumbnail geometry. More... | |
| rebuildThumbnails () | |
| Rebuild the thumbnail images with a new thumbnail size. More... | |
| getThumbPrefix () | |
| toJSON () | |
| Returns a JSON representation of the question TODO. More... | |
| supportsJavascriptOutput () | |
| supportsNonJsOutput () | |
| setMatchingMode ($matchingMode) | |
| getMatchingMode () | |
| getOperators ($expression) | |
| Get all available operations for a specific question. More... | |
| getExpressionTypes () | |
| Get all available expression types for a specific question. More... | |
| getAvailableAnswerOptions ($index=null) | |
| If index is null, the function returns an array with all anwser options Else it returns the specific answer option. More... | |
| Public Member Functions inherited from assQuestion | |
| __construct ( $title="", $comment="", $author="", $owner=-1, $question="") | |
| assQuestion constructor More... | |
| getShuffler () | |
| setShuffler (ilArrayElementShuffler $shuffler) | |
| 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... | |
| getTitleFilenameCompliant () | |
| returns the object title prepared to be used as a filename 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 () | |
| 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, $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, $authorizedSolution=true) | |
| 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, $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 ($active_id, $pass=null, $authorized=true) | |
| Saves the learners input of the question to the database. 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... | |
| getTestOutputSolutions ($activeId, $pass) | |
| getUserSolutionPreferingIntermediate ($active_id, $pass=null) | |
| getSolutionValues ($active_id, $pass=null, $authorized=true) | |
| 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... | |
| 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... | |
| copyXHTMLMediaObjectsOfQuestion ($a_q_id) | |
| syncXHTMLMediaObjectsOfQuestion () | |
| createPageObject () | |
| create page object of question More... | |
| copyPageOfQuestion ($a_q_id) | |
| getPageOfQuestion () | |
| 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) | |
| 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... | |
| 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 ($txt_output, $prepare_for_latex_output=false, $omitNl2BrWhenTextArea=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... | |
| buildHashedImageFilename ($plain_image_filename, $unique=false) | |
| 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... | |
| getActiveUserData ($active_id) | |
| Returns the user id and the test id for a given active id. More... | |
| setExportDetailsXLS ($worksheet, $startrow, $active_id, $pass) | |
| 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) | |
| formatSAQuestion ($a_q) | |
| Format self assessment question. More... | |
| setPreventRteUsage ($a_val) | |
| Set prevent rte usage. More... | |
| getPreventRteUsage () | |
| Get prevent rte usage. More... | |
| migrateContentForLearningModule (ilAssSelfAssessmentMigrator $migrator) | |
| 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... | |
| syncSkillAssignments ($srcParentId, $srcQuestionId, $trgParentId, $trgQuestionId) | |
| isAnswered ($active_id, $pass=null) | |
| returns boolean wether the question is answered during test pass 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 () | |
| removeIntermediateSolution ($active_id, $pass) | |
| removeCurrentSolution ($active_id, $pass, $authorized=true) | |
| saveCurrentSolution ($active_id, $pass, $value1, $value2, $authorized=true, $tstamp=null) | |
| updateCurrentSolution ($solutionId, $value1, $value2, $authorized=true) | |
| updateCurrentSolutionsAuthorization ($activeId, $pass, $authorized, $keepTime=false) | |
| setStep ($step) | |
| getStep () | |
| toJSON () | |
| duplicate ($for_test=true, $title="", $author="", $owner="", $testObjId=null) | |
| intermediateSolutionExists ($active_id, $pass) | |
| authorizedSolutionExists ($active_id, $pass) | |
| authorizedOrIntermediateSolutionExists ($active_id, $pass) | |
| isAddableAnswerOptionValue ($qIndex, $answerOptionValue) | |
| addAnswerOptionValue ($qIndex, $answerOptionValue, $points) | |
| removeAllExistingSolutions () | |
| removeExistingSolutions ($activeId, $pass) | |
| resetUsersAnswer ($activeId, $pass) | |
| removeResultRecord ($activeId, $pass) | |
| fetchValuePairsFromIndexedValues (array $indexedValues) | |
| fetchIndexedValuesFromValuePairs (array $valuePairs) | |
| areObligationsToBeConsidered () | |
| setObligationsToBeConsidered ($obligationsToBeConsidered) | |
| updateTimestamp () | |
| getTestPresentationConfig () | |
| Get the test question configuration (initialised once) More... | |
| savePartial () | |
| Public Member Functions inherited from iQuestionCondition | |
| getUserQuestionResult ($active_id, $pass) | |
| Get the user solution for a question by active_id and the test pass. More... | |
Protected Member Functions | |
| savePreviewData (ilAssQuestionPreviewSession $previewSession) | |
| generateThumbForFile ($path, $file) | |
| calculateReachedPointsForSolution ($found_values) | |
| afterSyncWithOriginal ($origQuestionId, $dupQuestionId, $origParentObjId, $dupParentObjId) | |
| {} More... | |
| Protected Member Functions inherited from assQuestion | |
| getQuestionAction () | |
| isNonEmptyItemListPostSubmission ($postSubmissionFieldname) | |
| ensureCurrentTestPass ($active_id, $pass) | |
| lookupCurrentTestPass ($active_id, $pass) | |
| lookupTestId ($active_id) | |
| log ($active_id, $langVar) | |
| 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) | |
| ensureNonNegativePoints ($points) | |
| getRTETextWithMediaObjects () | |
| Collects all text in the question which could contain media objects which were created with the Rich Text Editor. More... | |
| getSelfAssessmentFormatter () | |
| lmMigrateQuestionTypeGenericContent (ilAssSelfAssessmentMigrator $migrator) | |
| lmMigrateQuestionTypeSpecificContent (ilAssSelfAssessmentMigrator $migrator) | |
| duplicateQuestionHints ($originalQuestionId, $duplicateQuestionId) | |
| duplicateSkillAssignments ($srcParentId, $srcQuestionId, $trgParentId, $trgQuestionId) | |
| buildQuestionDataQuery () | |
| getCurrentSolutionResultSet ($active_id, $pass, $authorized=true) | |
| Get a restulset for the current user solution for a this question by active_id and pass. More... | |
| removeSolutionRecordById ($solutionId) | |
| getSolutionRecordById ($solutionId) | |
| deleteDummySolutionRecord ($activeId, $passIndex) | |
| isDummySolutionRecord ($solutionRecord) | |
| deleteSolutionRecordByValues ($activeId, $passIndex, $authorized, $matchValues) | |
| duplicateIntermediateSolutionAuthorized ($activeId, $passIndex) | |
| forceExistingIntermediateSolution ($activeId, $passIndex, $considerDummyRecordCreation) | |
| buildTestPresentationConfig () | |
| build basic test question configuration instance More... | |
Protected Attributes | |
| $terms | |
| $definitions | |
| $matchingMode = self::MATCHING_MODE_1_ON_1 | |
| 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 = OUTPUT_JAVASCRIPT | |
| $suggested_solutions | |
| $original_id | |
| $page | |
| $external_id = '' | |
| $questionChangeListeners = array() | |
| $processLocker | |
| $step = null | |
| $lastChange | |
| $shuffler | |
| $testQuestionConfig | |
Private Member Functions | |
| getPositiveScoredMatchingPairs () | |
| getMostPositiveScoredUniqueTermMatchingPairs () | |
| fetchSubmittedMatchingsFromPost () | |
| checkSubmittedMatchings ($submittedMatchings) | |
Additional Inherited Members | |
| Static Public Member Functions inherited from assQuestion | |
| static | setForcePassResultUpdateEnabled ($forcePassResultsUpdateEnabled) |
| static | isForcePassResultUpdateEnabled () |
| static | isAllowedImageMimeType ($mimeType) |
| static | fetchMimeTypeIdentifier ($contentTypeString) |
| static | getAllowedFileExtensionsForMimeType ($mimeType) |
| static | isAllowedImageFileExtension ($mimeType, $fileExtension) |
| static | getAllowedImageMaterialFileExtensions () |
| static | _getMaximumPoints ($question_id) |
| Returns the maximum points, a learner can reach answering the question. More... | |
| static | _getQuestionInfo ($question_id) |
| Returns question information from the database. More... | |
| 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 | _getReachedPoints ($active_id, $question_id, $pass=null) |
| Returns the points, a learner has reached answering the question. More... | |
| static | _updateTestResultCache ($active_id, ilAssQuestionProcessLocker $processLocker=null) |
| Move this to a proper place. More... | |
| static | logAction ($logtext="", $active_id="", $question_id="") |
| Logs an action into the Test&Assessment log. More... | |
| static | getQuestionTypeFromDb ($question_id) |
| get question type for question id More... | |
| static | _getTotalRightAnswers ($a_q_id) |
| get number of answers for question id (static) note: do not use $this inside this method More... | |
| static | _getTitle ($a_q_id) |
| Returns the title of a question. More... | |
| static | _getQuestionText ($a_q_id) |
| Returns question text. More... | |
| static | isFileAvailable ($file) |
| static | _getQuestionType ($question_id) |
| Returns the question type of a question with a given id. More... | |
| static | _getQuestionTitle ($question_id) |
| Returns the question title of a question with a given id. More... | |
| static | saveOriginalId ($questionId, $originalId) |
| static | resetOriginalId ($questionId) |
| static | _getInternalLinkHref ($target="") |
| 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 | _getSolutionMaxPass ($question_id, $active_id) |
| Returns the maximum pass a users question solution. More... | |
| static | _isWriteable ($question_id, $user_id) |
| Returns true if the question is writeable by a certain user. More... | |
| static | _isUsedInRandomTest ($question_id="") |
| Checks whether the question is used in a random test or not. More... | |
| 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 | _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... | |
| static | _needsManualScoring ($question_id) |
| 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 | _questionExistsInTest ($question_id, $test_id) |
| static | lookupParentObjId ($questionId) |
| ilDBInterface $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 | implodeKeyValues ($keyValues) |
| static | explodeKeyValues ($keyValues) |
| static | setResultGateway ($resultGateway) |
| static | getResultGateway () |
| static | sumTimesInISO8601FormatH_i_s_Extended ($time1, $time2) |
| static | convertISO8601FormatH_i_s_ExtendedToSeconds ($time) |
| static | missingResultRecordExists ($activeId, $pass, $questionIds) |
| static | getQuestionsMissingResultRecord ($activeId, $pass, $questionIds) |
| static | lookupResultRecordExist ($activeId, $questionId, $pass) |
| 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... | |
| static | getKeyValuesImplosionSeparator () |
| Static Protected Attributes inherited from assQuestion | |
| static | $allowedFileExtensionsByMimeType |
| static | $allowedCharsetsByMimeType |
| static | $allowedImageMaterialFileExtensionsByMimeType |
| static | $forcePassResultsUpdateEnabled = false |
| static | $imageSourceFixReplaceMap |
Detailed Description
Class for matching questions.
assMatchingQuestion is a class for matching questions.
- Version
- $Id$
Definition at line 24 of file class.assMatchingQuestion.php.
Constructor & Destructor Documentation
◆ __construct()
| assMatchingQuestion::__construct | ( | $title = "", |
|
$comment = "", |
|||
$author = "", |
|||
$owner = -1, |
|||
$question = "", |
|||
$matching_type = MT_TERMS_DEFINITIONS |
|||
| ) |
assMatchingQuestion constructor
The constructor takes possible arguments an creates an instance of the assMatchingQuestion 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 matching question int $matching_type
- Returns
Definition at line 85 of file class.assMatchingQuestion.php.
References assQuestion\$author, assQuestion\$comment, $matching_type, assQuestion\$owner, assQuestion\$question, and assQuestion\$title.
Member Function Documentation
◆ addDefinition()
| assMatchingQuestion::addDefinition | ( | $definition | ) |
Adds a definition.
- Parameters
-
object $definition The definition
- See also
- $definitions
Definition at line 740 of file class.assMatchingQuestion.php.
◆ addMatchingPair()
| assMatchingQuestion::addMatchingPair | ( | $term = null, |
|
$definition = null, |
|||
$points = 0.0 |
|||
| ) |
Adds an matching pair for an matching choice question.
The students have to fill in an order for the matching pair. The matching pair is an ASS_AnswerMatching object that will be created and assigned to the array $this->matchingpairs.
- Parameters
-
assAnswerMatchingTerm | null $term A matching term assAnswerMatchingDefinition | null $definition A matching definition float $points The points for selecting the matching pair, incl. negative.
- See also
- $matchingpairs
Definition at line 574 of file class.assMatchingQuestion.php.
References assQuestion\$points.
◆ addTerm()
| assMatchingQuestion::addTerm | ( | $term | ) |
Adds a term.
- Parameters
-
string $term The text of the term
- See also
- $terms
Definition at line 729 of file class.assMatchingQuestion.php.
◆ afterSyncWithOriginal()
|
protected |
{}
Definition at line 1593 of file class.assMatchingQuestion.php.
References assQuestion\buildImagePath(), ilUtil\delDir(), ilUtil\makeDirParents(), and ilUtil\rCopy().
Here is the call graph for this function:
◆ calculateReachedPoints()
| assMatchingQuestion::calculateReachedPoints | ( | $active_id, | |
$pass = null, |
|||
$authorizedSolution = true, |
|||
$returndetails = false |
|||
| ) |
Returns the points, a learner has reached answering the question.
The points are calculated from the given answers.
public
- Parameters
-
integer $active_id integer $pass boolean $returndetails (deprecated !!)
- Returns
- integer/array $points/$details (array $details is deprecated !!)
Definition at line 851 of file class.assMatchingQuestion.php.
References $data, $DIC, $ilDB, $pass, assQuestion\$points, $result, calculateReachedPointsForSolution(), assQuestion\getCurrentSolutionResultSet(), and assQuestion\getSolutionMaxPass().
Referenced by getExpressionTypes().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ calculateReachedPointsForSolution()
|
protected |
- Parameters
-
$found_values
- Returns
- int
Definition at line 1462 of file class.assMatchingQuestion.php.
References assQuestion\$points, and $terms.
Referenced by calculateReachedPoints().
Here is the caller graph for this function:
◆ checkSubmittedMatchings()
|
private |
Definition at line 1065 of file class.assMatchingQuestion.php.
References $i, $terms, getMatchingMode(), and ilUtil\sendFailure().
Referenced by savePreviewData(), and saveWorkingData().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ copyImages()
| assMatchingQuestion::copyImages | ( | $question_id, | |
| $source_questionpool | |||
| ) |
Definition at line 488 of file class.assMatchingQuestion.php.
References $DIC, $filename, $ilLog, assQuestion\getImagePath(), getThumbPrefix(), assQuestion\isFileAvailable(), and ilUtil\makeDirParents().
Here is the call graph for this function:
◆ copyObject()
| assMatchingQuestion::copyObject | ( | $target_questionpool_id, | |
$title = "" |
|||
| ) |
Copies an assMatchingQuestion.
Definition at line 379 of file class.assMatchingQuestion.php.
References assQuestion\$original_id, assQuestion\$title, assQuestion\_getOriginalId(), and assQuestion\getObjId().
Here is the call graph for this function:
◆ createNewOriginalFromThisDuplicate()
| assMatchingQuestion::createNewOriginalFromThisDuplicate | ( | $targetParentId, | |
$targetQuestionTitle = "" |
|||
| ) |
Definition at line 408 of file class.assMatchingQuestion.php.
References assQuestion\$id, and assQuestion\getObjId().
Here is the call graph for this function:
◆ deleteDefinition()
| assMatchingQuestion::deleteDefinition | ( | $position | ) |
Deletes a definition.
- Parameters
-
integer $position The position of the definition in the definition array
- See also
- $definitions
Definition at line 823 of file class.assMatchingQuestion.php.
◆ deleteImagefile()
| assMatchingQuestion::deleteImagefile | ( | $filename | ) |
Deletes an imagefile from the system if the file is deleted manually.
- Parameters
-
string $filename Image file filename
- Returns
- boolean Success
Definition at line 1002 of file class.assMatchingQuestion.php.
References $filename, $result, assQuestion\getImagePath(), and getThumbPrefix().
Referenced by removeDefinitionImage(), removeTermImage(), and setImageFile().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ deleteMatchingPair()
| assMatchingQuestion::deleteMatchingPair | ( | $index = 0 | ) |
Deletes a matching pair with a given index.
The index of the first matching pair is 0, the index of the second matching pair is 1 and so on.
- Parameters
-
integer $index A nonnegative index of the n-th matching pair
- See also
- $matchingpairs
Definition at line 644 of file class.assMatchingQuestion.php.
References $index.
◆ deleteTerm()
| assMatchingQuestion::deleteTerm | ( | $position | ) |
Deletes a term.
- Parameters
-
string $term_id The id of the term to delete
- See also
- $terms
Definition at line 811 of file class.assMatchingQuestion.php.
◆ duplicate()
| assMatchingQuestion::duplicate | ( | $for_test = true, |
|
$title = "", |
|||
$author = "", |
|||
$owner = "", |
|||
$testObjId = null |
|||
| ) |
Duplicates an assMatchingQuestion.
Definition at line 330 of file class.assMatchingQuestion.php.
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:
◆ duplicateImages()
| assMatchingQuestion::duplicateImages | ( | $question_id, | |
$objectId = null |
|||
| ) |
Definition at line 443 of file class.assMatchingQuestion.php.
References $DIC, $filename, $ilLog, assQuestion\getImagePath(), getThumbPrefix(), and ilUtil\makeDirParents().
Here is the call graph for this function:
◆ fetchIndexedValuesFromValuePairs()
| assMatchingQuestion::fetchIndexedValuesFromValuePairs | ( | array | $valuePairs | ) |
- Parameters
-
array $valuePairs
- Returns
- array $indexedValues
Definition at line 945 of file class.assMatchingQuestion.php.
◆ fetchSubmittedMatchingsFromPost()
|
private |
Definition at line 1042 of file class.assMatchingQuestion.php.
References $_POST, $postData, getDefinitions(), assQuestion\getId(), and getTerms().
Referenced by savePreviewData(), and saveWorkingData().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ flushDefinitions()
| assMatchingQuestion::flushDefinitions | ( | ) |
Deletes all definitions.
- See also
- $definitions
Definition at line 800 of file class.assMatchingQuestion.php.
◆ flushMatchingPairs()
| assMatchingQuestion::flushMatchingPairs | ( | ) |
Deletes all matching pairs.
- See also
- $matchingpairs
Definition at line 663 of file class.assMatchingQuestion.php.
◆ flushTerms()
| assMatchingQuestion::flushTerms | ( | ) |
◆ generateThumbForFile()
|
protected |
Definition at line 1329 of file class.assMatchingQuestion.php.
References $filename, $path, ilUtil\convertImage(), getThumbGeometry(), and getThumbPrefix().
Referenced by rebuildThumbnails().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ getAdditionalTableName()
| assMatchingQuestion::getAdditionalTableName | ( | ) |
Returns the name of the additional question data table in the database.
- Returns
- string The additional table name
Definition at line 1206 of file class.assMatchingQuestion.php.
Referenced by saveAdditionalQuestionDataToDb().
Here is the caller graph for this function:
◆ getAnswerTableName()
| assMatchingQuestion::getAnswerTableName | ( | ) |
Returns the name of the answer table in the database.
- Returns
- string The answer table name
Definition at line 1216 of file class.assMatchingQuestion.php.
◆ getAvailableAnswerOptions()
| assMatchingQuestion::getAvailableAnswerOptions | ( | $index = null | ) |
If index is null, the function returns an array with all anwser options Else it returns the specific answer option.
- Parameters
-
null | int $index
- Returns
- array|ASS_AnswerSimple
Implements iQuestionCondition.
Definition at line 1581 of file class.assMatchingQuestion.php.
References $index, getMatchingPair(), and getMatchingPairs().
Here is the call graph for this function:
◆ getDefinitionCount()
| assMatchingQuestion::getDefinitionCount | ( | ) |
Returns the number of definitions.
- Returns
- integer The number of definitions
- See also
- $definitions
Definition at line 718 of file class.assMatchingQuestion.php.
◆ getDefinitions()
| assMatchingQuestion::getDefinitions | ( | ) |
Returns the definitions of the matching question.
- Returns
- array An array containing the definitions
- See also
- $terms
Definition at line 696 of file class.assMatchingQuestion.php.
References $definitions.
Referenced by fetchSubmittedMatchingsFromPost(), and toJSON().
Here is the caller graph for this function:
◆ getDefinitionWithIdentifier()
| assMatchingQuestion::getDefinitionWithIdentifier | ( | $a_identifier | ) |
Returns a definition with a given identifier.
Definition at line 605 of file class.assMatchingQuestion.php.
◆ getEncryptedFilename()
| assMatchingQuestion::getEncryptedFilename | ( | $filename | ) |
Returns the encrypted save filename of a matching picture Images are saved with an encrypted filename to prevent users from cheating by guessing the solution from the image filename.
- Parameters
-
string $filename Original filename
- Returns
- string Encrypted filename
Definition at line 968 of file class.assMatchingQuestion.php.
References $filename.
◆ getExpressionTypes()
| assMatchingQuestion::getExpressionTypes | ( | ) |
Get all available expression types for a specific question.
- Returns
- array
Implements iQuestionCondition.
Definition at line 1495 of file class.assMatchingQuestion.php.
References $data, $definitions, $DIC, $ilDB, $index, $pass, assQuestion\$points, $result, $row, $terms, calculateReachedPoints(), iQuestionCondition\EmptyAnswerExpression, assQuestion\getId(), getMaximumPoints(), iQuestionCondition\getUserQuestionResult(), iQuestionCondition\MatchingResultExpression, iQuestionCondition\NumericResultExpression, and iQuestionCondition\PercentageResultExpression.
Here is the call graph for this function:
◆ getMatchingMode()
| assMatchingQuestion::getMatchingMode | ( | ) |
Definition at line 1453 of file class.assMatchingQuestion.php.
References $matchingMode.
Referenced by checkSubmittedMatchings(), getMaximumScoringMatchingPairs(), saveAdditionalQuestionDataToDb(), and toJSON().
Here is the caller graph for this function:
◆ getMatchingPair()
| assMatchingQuestion::getMatchingPair | ( | $index = 0 | ) |
Returns a matching pair with a given index.
The index of the first matching pair is 0, the index of the second matching pair is 1 and so on.
- Parameters
-
integer $index A nonnegative index of the n-th matching pair
- Returns
- object ASS_AnswerMatching-Object
- See also
- $matchingpairs
Definition at line 623 of file class.assMatchingQuestion.php.
References $index.
Referenced by getAvailableAnswerOptions().
Here is the caller graph for this function:
◆ getMatchingPairCount()
| assMatchingQuestion::getMatchingPairCount | ( | ) |
Returns the number of matching pairs.
- Returns
- integer The number of matching pairs of the matching question
- See also
- $matchingpairs
Definition at line 674 of file class.assMatchingQuestion.php.
◆ getMatchingPairs()
| & assMatchingQuestion::getMatchingPairs | ( | ) |
Returns the matchingpairs array.
Definition at line 1233 of file class.assMatchingQuestion.php.
References $matchingpairs.
Referenced by getAvailableAnswerOptions(), saveAnswerSpecificDataToDb(), setExportDetailsXLS(), and toJSON().
Here is the caller graph for this function:
◆ getMaximumPoints()
| assMatchingQuestion::getMaximumPoints | ( | ) |
Calculates and Returns the maximum points, a learner can reach answering the question.
Definition at line 883 of file class.assMatchingQuestion.php.
References assQuestion\$points, and getMaximumScoringMatchingPairs().
Referenced by getExpressionTypes(), and isComplete().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ getMaximumScoringMatchingPairs()
| assMatchingQuestion::getMaximumScoringMatchingPairs | ( | ) |
Definition at line 894 of file class.assMatchingQuestion.php.
References getMatchingMode(), getMostPositiveScoredUniqueTermMatchingPairs(), and getPositiveScoredMatchingPairs().
Referenced by getMaximumPoints().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ getMostPositiveScoredUniqueTermMatchingPairs()
|
private |
Definition at line 920 of file class.assMatchingQuestion.php.
Referenced by getMaximumScoringMatchingPairs().
Here is the caller graph for this function:
◆ getOperators()
| assMatchingQuestion::getOperators | ( | $expression | ) |
Get all available operations for a specific question.
- Parameters
-
$expression
Implements iQuestionCondition.
Definition at line 1485 of file class.assMatchingQuestion.php.
References ilOperatorsExpressionMapping\getOperatorsByExpression().
Here is the call graph for this function:
◆ getPositiveScoredMatchingPairs()
|
private |
Definition at line 905 of file class.assMatchingQuestion.php.
Referenced by getMaximumScoringMatchingPairs().
Here is the caller graph for this function:
◆ getQuestionType()
| assMatchingQuestion::getQuestionType | ( | ) |
Returns the question type of the question.
- Returns
- integer The question type of the question
Definition at line 1196 of file class.assMatchingQuestion.php.
Referenced by toJSON().
Here is the caller graph for this function:
◆ getRandomId()
| assMatchingQuestion::getRandomId | ( | ) |
Definition at line 1153 of file class.assMatchingQuestion.php.
References $key.
◆ getRTETextWithMediaObjects()
| assMatchingQuestion::getRTETextWithMediaObjects | ( | ) |
Collects all text in the question which could contain media objects which were created with the Rich Text Editor.
Definition at line 1225 of file class.assMatchingQuestion.php.
◆ getTermCount()
| assMatchingQuestion::getTermCount | ( | ) |
Returns the number of terms.
- Returns
- integer The number of terms
- See also
- $terms
Definition at line 707 of file class.assMatchingQuestion.php.
◆ getTerms()
| assMatchingQuestion::getTerms | ( | ) |
Returns the terms of the matching question.
- Returns
- array An array containing the terms
- See also
- $terms
Definition at line 685 of file class.assMatchingQuestion.php.
References $terms.
Referenced by fetchSubmittedMatchingsFromPost(), and toJSON().
Here is the caller graph for this function:
◆ getTermWithIdentifier()
| assMatchingQuestion::getTermWithIdentifier | ( | $a_identifier | ) |
Returns a term with a given identifier.
Definition at line 592 of file class.assMatchingQuestion.php.
◆ getThumbGeometry()
| assMatchingQuestion::getThumbGeometry | ( | ) |
Get the thumbnail geometry.
- Returns
- integer Geometry
Definition at line 1282 of file class.assMatchingQuestion.php.
References $thumb_geometry.
Referenced by generateThumbForFile(), getThumbSize(), saveAdditionalQuestionDataToDb(), and setImageFile().
Here is the caller graph for this function:
◆ getThumbPrefix()
| assMatchingQuestion::getThumbPrefix | ( | ) |
Definition at line 1324 of file class.assMatchingQuestion.php.
Referenced by copyImages(), deleteImagefile(), duplicateImages(), generateThumbForFile(), and setImageFile().
Here is the caller graph for this function:
◆ getThumbSize()
| assMatchingQuestion::getThumbSize | ( | ) |
Get the thumbnail geometry.
- Returns
- integer Geometry
Definition at line 1292 of file class.assMatchingQuestion.php.
References getThumbGeometry().
Here is the call graph for this function:
◆ insertDefinition()
| assMatchingQuestion::insertDefinition | ( | $position, | |
$definition = null |
|||
| ) |
Inserts a definition.
- Parameters
-
object $definition The definition
- See also
- $definitions
Definition at line 772 of file class.assMatchingQuestion.php.
◆ insertMatchingPair()
| assMatchingQuestion::insertMatchingPair | ( | $position, | |
$term = null, |
|||
$definition = null, |
|||
$points = 0.0 |
|||
| ) |
Inserts a matching pair for an matching choice question.
The students have to fill in an order for the matching pair. The matching pair is an ASS_AnswerMatching object that will be created and assigned to the array $this->matchingpairs.
- Parameters
-
integer $position The insert position in the matching pairs array object $term A matching term object $definition A matching definition double $points The points for selecting the matching pair (even negative points can be used)
- See also
- $matchingpairs
Definition at line 542 of file class.assMatchingQuestion.php.
References assQuestion\$points.
◆ insertTerm()
| assMatchingQuestion::insertTerm | ( | $position, | |
$term = null |
|||
| ) |
Inserts a term.
- Parameters
-
string $term The text of the term
- See also
- $terms
Definition at line 751 of file class.assMatchingQuestion.php.
◆ isComplete()
| assMatchingQuestion::isComplete | ( | ) |
Returns true, if a matching question is complete for use.
- Returns
- boolean True, if the matching question is complete for use, otherwise false
Definition at line 105 of file class.assMatchingQuestion.php.
References getMaximumPoints().
Here is the call graph for this function:
◆ loadFromDb()
| assMatchingQuestion::loadFromDb | ( | $question_id | ) |
Loads a assMatchingQuestion object from a database.
- Parameters
-
object $db A pear DB object integer $question_id A unique key which defines the multiple choice test in the database
Definition at line 235 of file class.assMatchingQuestion.php.
References $data, $DIC, $ilDB, $query, $result, ilRTE\_replaceMediaObjectImageSrc(), assQuestion\setAdditionalContentEditingMode(), assQuestion\setAuthor(), assQuestion\setComment(), assQuestion\setEstimatedWorkingTime(), assQuestion\setId(), setMatchingMode(), assQuestion\setNrOfTries(), assQuestion\setObjId(), assQuestion\setOriginalId(), assQuestion\setOwner(), assQuestion\setPoints(), assQuestion\setQuestion(), setShuffle(), setThumbGeometry(), and assQuestion\setTitle().
Here is the call graph for this function:
◆ rebuildThumbnails()
| assMatchingQuestion::rebuildThumbnails | ( | ) |
Rebuild the thumbnail images with a new thumbnail size.
Definition at line 1310 of file class.assMatchingQuestion.php.
References generateThumbForFile(), and assQuestion\getImagePath().
Referenced by saveAnswerSpecificDataToDb().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ removeDefinitionImage()
| assMatchingQuestion::removeDefinitionImage | ( | $index | ) |
Definition at line 986 of file class.assMatchingQuestion.php.
References $index, and deleteImagefile().
Here is the call graph for this function:
◆ removeTermImage()
| assMatchingQuestion::removeTermImage | ( | $index | ) |
Definition at line 977 of file class.assMatchingQuestion.php.
References $index, and deleteImagefile().
Here is the call graph for this function:
◆ saveAdditionalQuestionDataToDb()
| assMatchingQuestion::saveAdditionalQuestionDataToDb | ( | ) |
Saves a record to the question types additional data table.
- Returns
- mixed
Implements ilObjQuestionScoringAdjustable.
Definition at line 207 of file class.assMatchingQuestion.php.
References $DIC, $ilDB, getAdditionalTableName(), assQuestion\getId(), getMatchingMode(), and getThumbGeometry().
Referenced by saveToDb().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ saveAnswerSpecificDataToDb()
| assMatchingQuestion::saveAnswerSpecificDataToDb | ( | ) |
Saves the answer specific records into a question types answer table.
- Returns
- mixed
Implements ilObjAnswerScoringAdjustable.
Definition at line 137 of file class.assMatchingQuestion.php.
References $DIC, $ilDB, $key, $matchingpairs, assQuestion\getId(), getMatchingPairs(), and rebuildThumbnails().
Referenced by saveToDb().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ savePreviewData()
|
protected |
Definition at line 1144 of file class.assMatchingQuestion.php.
References checkSubmittedMatchings(), fetchSubmittedMatchingsFromPost(), and ilAssQuestionPreviewSession\setParticipantsSolution().
Here is the call graph for this function:
◆ saveToDb()
| assMatchingQuestion::saveToDb | ( | $original_id = "" | ) |
Saves a assMatchingQuestion object to a database.
- Parameters
-
string $original_id
Definition at line 124 of file class.assMatchingQuestion.php.
References $DIC, $ilDB, assQuestion\$original_id, saveAdditionalQuestionDataToDb(), saveAnswerSpecificDataToDb(), and assQuestion\saveQuestionDataToDb().
Here is the call graph for this function:
◆ saveWorkingData()
| assMatchingQuestion::saveWorkingData | ( | $active_id, | |
$pass = null, |
|||
$authorized = true |
|||
| ) |
Saves the learners input of the question to the database.
public
- Parameters
-
integer $active_id Active id of the user integer $pass Test pass
- Returns
- boolean $status
Definition at line 1100 of file class.assMatchingQuestion.php.
References $DIC, $i, $ilDB, $pass, $terms, ilObjAssessmentFolder\_enabledAssessmentLogging(), ilObjAssessmentFolder\_getLogLanguage(), ilObjTest\_getPass(), checkSubmittedMatchings(), fetchSubmittedMatchingsFromPost(), assQuestion\getId(), assQuestion\getProcessLocker(), assQuestion\logAction(), assQuestion\removeCurrentSolution(), and assQuestion\saveCurrentSolution().
Here is the call graph for this function:
◆ setExportDetailsXLS()
| assMatchingQuestion::setExportDetailsXLS | ( | $worksheet, | |
| $startrow, | |||
| $active_id, | |||
| $pass | |||
| ) |
{}
Definition at line 1241 of file class.assMatchingQuestion.php.
References $i, $pass, assQuestion\getImagePath(), getMatchingPairs(), and assQuestion\getSolutionValues().
Here is the call graph for this function:
◆ setImageFile()
| assMatchingQuestion::setImageFile | ( | $image_tempfilename, | |
| $image_filename, | |||
$previous_filename = '' |
|||
| ) |
Sets the image file and uploads the image to the object's image directory.
- Parameters
-
string $image_filename Name of the original image file string $image_tempfilename Name of the temporary uploaded image file
- Returns
- integer An errorcode if the image upload fails, 0 otherwise public
Definition at line 1018 of file class.assMatchingQuestion.php.
References $result, ilUtil\convertImage(), deleteImagefile(), assQuestion\getImagePath(), getThumbGeometry(), getThumbPrefix(), and ilUtil\makeDirParents().
Here is the call graph for this function:
◆ setMatchingMode()
| assMatchingQuestion::setMatchingMode | ( | $matchingMode | ) |
Definition at line 1448 of file class.assMatchingQuestion.php.
References $matchingMode.
Referenced by loadFromDb().
Here is the caller graph for this function:
◆ setShuffle()
| assMatchingQuestion::setShuffle | ( | $shuffle = true | ) |
Sets the shuffle flag.
- Parameters
-
integer $shuffle A flag indicating whether the answers are shuffled or not
- See also
- $shuffle
Definition at line 1176 of file class.assMatchingQuestion.php.
References assQuestion\$shuffle.
Referenced by loadFromDb().
Here is the caller graph for this function:
◆ setTerm()
| assMatchingQuestion::setTerm | ( | $term, | |
| $index | |||
| ) |
Sets a specific term.
- Parameters
-
string $term The text of the term string $index The index of the term
- See also
- $terms
Definition at line 836 of file class.assMatchingQuestion.php.
References $index.
◆ setThumbGeometry()
| assMatchingQuestion::setThumbGeometry | ( | $a_geometry | ) |
Set the thumbnail geometry.
- Parameters
-
integer $a_geometry Geometry
Definition at line 1302 of file class.assMatchingQuestion.php.
Referenced by loadFromDb().
Here is the caller graph for this function:
◆ supportsJavascriptOutput()
| assMatchingQuestion::supportsJavascriptOutput | ( | ) |
Definition at line 1438 of file class.assMatchingQuestion.php.
◆ supportsNonJsOutput()
| assMatchingQuestion::supportsNonJsOutput | ( | ) |
Definition at line 1443 of file class.assMatchingQuestion.php.
◆ toJSON()
| assMatchingQuestion::toJSON | ( | ) |
Returns a JSON representation of the question TODO.
Definition at line 1355 of file class.assMatchingQuestion.php.
References $def, $definitions, $DIC, assQuestion\$lng, $mobs, $result, $terms, ilObjMediaObject\_getMobsOfObject(), assQuestion\formatSAQuestion(), getDefinitions(), assQuestion\getId(), getMatchingMode(), getMatchingPairs(), assQuestion\getNrOfTries(), assQuestion\getQuestion(), getQuestionType(), assQuestion\getShuffler(), getTerms(), assQuestion\getTitle(), and assQuestion\setShuffler().
Here is the call graph for this function:
Field Documentation
◆ $definitions
|
protected |
Definition at line 51 of file class.assMatchingQuestion.php.
Referenced by getDefinitions(), getExpressionTypes(), and toJSON().
◆ $element_height
| assMatchingQuestion::$element_height |
Definition at line 64 of file class.assMatchingQuestion.php.
◆ $matching_type
| assMatchingQuestion::$matching_type |
Definition at line 42 of file class.assMatchingQuestion.php.
Referenced by __construct().
◆ $matchingMode
|
protected |
Definition at line 69 of file class.assMatchingQuestion.php.
Referenced by getMatchingMode(), and setMatchingMode().
◆ $matchingpairs
| assMatchingQuestion::$matchingpairs |
Definition at line 33 of file class.assMatchingQuestion.php.
Referenced by getMatchingPairs(), and saveAnswerSpecificDataToDb().
◆ $terms
|
protected |
Definition at line 49 of file class.assMatchingQuestion.php.
Referenced by calculateReachedPointsForSolution(), checkSubmittedMatchings(), getExpressionTypes(), getTerms(), saveWorkingData(), and toJSON().
◆ $thumb_geometry
| assMatchingQuestion::$thumb_geometry = 100 |
Definition at line 57 of file class.assMatchingQuestion.php.
Referenced by getThumbGeometry().
◆ MATCHING_MODE_1_ON_1
| const assMatchingQuestion::MATCHING_MODE_1_ON_1 = '1:1' |
Definition at line 66 of file class.assMatchingQuestion.php.
Referenced by assMatchingQuestionImport\fromXML(), and assMatchingQuestionGUI\populateQuestionSpecificFormPart().
◆ MATCHING_MODE_N_ON_N
| const assMatchingQuestion::MATCHING_MODE_N_ON_N = 'n:n' |
Definition at line 67 of file class.assMatchingQuestion.php.
Referenced by assMatchingQuestionGUI\isValidTermAndDefinitionAmount(), and assMatchingQuestionGUI\populateQuestionSpecificFormPart().
The documentation for this class was generated from the following file:
- Modules/TestQuestionPool/classes/class.assMatchingQuestion.php
