assFormulaQuestion Class Reference
Class for single choice questions assFormulaQuestion is a class for single choice questions. More...
Inheritance diagram for assFormulaQuestion:
Collaboration diagram for assFormulaQuestion:
Public Member Functions | |||||||||||||
| __construct ( $title="", $comment="", $author="", $owner=-1, $question="") | |||||||||||||
| assFormulaQuestion constructor The constructor takes possible arguments an creates an instance of the assFormulaQuestion object. More... | |||||||||||||
| clearVariables () | |||||||||||||
| getVariables () | |||||||||||||
| getVariable ($variable) | |||||||||||||
| addVariable ($variable) | |||||||||||||
| clearResults () | |||||||||||||
| getResults () | |||||||||||||
| getResult ($result) | |||||||||||||
| addResult ($result) | |||||||||||||
| addResultUnits ($result, $unit_ids) | |||||||||||||
| addResultUnit ($result, $unit) | |||||||||||||
| getResultUnits ($result) | |||||||||||||
| hasResultUnit ($result, $unit_id) | |||||||||||||
| parseQuestionText () | |||||||||||||
| checkForDuplicateVariables () | |||||||||||||
| checkForDuplicateResults () | |||||||||||||
| fetchAllResults ($questionText) | |||||||||||||
| fetchAllVariables ($questionText) | |||||||||||||
| hasRequiredVariableSolutionValues (array $userSolution) | |||||||||||||
| getInitialVariableSolutionValues () | |||||||||||||
| substituteVariables (array $userdata, $graphicalOutput=false, $forsolution=false, $result_output=false) | |||||||||||||
| canUseAdvancedRating ($result) | |||||||||||||
| Check if advanced rating can be used for a result. More... | |||||||||||||
| isComplete () | |||||||||||||
| Returns true, if the question is complete for use. More... | |||||||||||||
| saveToDb ($original_id="") | |||||||||||||
| Saves a assFormulaQuestion object to a database @access public. More... | |||||||||||||
| loadFromDb ($question_id) | |||||||||||||
| Loads a assFormulaQuestion object from a database. More... | |||||||||||||
| duplicate ($for_test=true, $title="", $author="", $owner="", $testObjId=null) | |||||||||||||
| Duplicates an assFormulaQuestion @access public. More... | |||||||||||||
| copyObject ($target_questionpool_id, $title="") | |||||||||||||
| Copies an assFormulaQuestion object @access public. More... | |||||||||||||
| createNewOriginalFromThisDuplicate ($targetParentId, $targetQuestionTitle="") | |||||||||||||
| getMaximumPoints () | |||||||||||||
| Returns the maximum points, a learner can reach answering the question. More... | |||||||||||||
| 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. More... | |||||||||||||
| calculateReachedPointsFromPreviewSession (ilAssQuestionPreviewSession $previewSession) | |||||||||||||
| saveWorkingData ($active_id, $pass=null, $authorized=true) | |||||||||||||
| Saves the learners input of the question to the database. More... | |||||||||||||
| lookupForExistingSolutions ($activeId, $pass) | |||||||||||||
| Lookup if an authorized or intermediate solution exists. More... | |||||||||||||
| removeExistingSolutions ($activeId, $pass) | |||||||||||||
| Remove an existing solution without removing the variables. 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... | |||||||||||||
| deleteAnswers ($question_id) | |||||||||||||
| Deletes datasets from answers tables. 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) | |||||||||||||
{Creates an Excel worksheet for the detailed cumulated results of this question.
| |||||||||||||
| getBestSolution ($solutions) | |||||||||||||
| Returns the best solution for a given pass of a participant. More... | |||||||||||||
| setId ($id=-1) | |||||||||||||
| Sets the id of the assQuestion object. More... | |||||||||||||
| __get ($value) | |||||||||||||
| Object getter. More... | |||||||||||||
| setUnitrepository ($unitrepository) | |||||||||||||
| getUnitrepository () | |||||||||||||
| validateSolutionSubmit () | |||||||||||||
| 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 | |||||||||||||
| getShuffler () | |||||||||||||
| setShuffler (ilArrayElementShuffler $shuffler) | |||||||||||||
| setProcessLocker ($processLocker) | |||||||||||||
| getProcessLocker () | |||||||||||||
| fromXML (&$item, &$questionpool_id, &$tst_id, &$tst_object, &$question_counter, &$import_mapping, array $solutionhints=[]) | |||||||||||||
| 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... | |||||||||||||
| getDescriptionForHTMLOutput () | |||||||||||||
| 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... | |||||||||||||
| getAuthorForHTMLOutput () | |||||||||||||
| 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... | |||||||||||||
| getLifecycle () | |||||||||||||
| setLifecycle (ilAssQuestionLifecycle $lifecycle) | |||||||||||||
| 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 () | |||||||||||||
| _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... | |||||||||||||
| getQuestionForHTMLOutput () | |||||||||||||
| 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 () | |||||||||||||
| isInActiveTest () | |||||||||||||
| Public Member Functions inherited from iQuestionCondition | |||||||||||||
| getOperators ($expression) | |||||||||||||
| Get all available operations for a specific question. More... | |||||||||||||
| getExpressionTypes () | |||||||||||||
| Get all available expression types for a specific question. More... | |||||||||||||
| getUserQuestionResult ($active_id, $pass) | |||||||||||||
| Get the user solution for a question by active_id and the test pass. 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... | |||||||||||||
Protected Member Functions | |
| isValidSolutionResultValue ($submittedValue) | |
| savePreviewData (ilAssQuestionPreviewSession $previewSession) | |
| getSolutionSubmit () | |
| 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) | |
| purifyAndPrepareTextAreaOutput (string $content) | |
| 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... | |
Private Attributes | |
| $variables | |
| $results | |
| $resultunits | |
| $unitrepository | |
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) |
| @TODO 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) |
| @global 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) |
| 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_RTE = 'default' |
| constant for additional content editing mode "default" More... | |
| const | ADDITIONAL_CONTENT_EDITING_MODE_IPE = 'pageobject' |
| constant for additional content editing mode "pageobject" More... | |
| $feedbackOBJ = null | |
| $prevent_rte_usage = false | |
| $selfassessmenteditingmode = false | |
| $defaultnroftries = 0 | |
| $questionActionCmd = 'handleQuestionAction' | |
| const | KEY_VALUES_IMPLOSION_SEPARATOR = ':' |
| Data Fields inherited from iQuestionCondition | |
| const | StringResultExpression = '~TEXT~' |
| const | PercentageResultExpression = '%n%' |
| const | NumericResultExpression = '#n#' |
| const | MatchingResultExpression = ';n:m;' |
| const | OrderingResultExpression = '$n,m,o,p$' |
| const | NumberOfResultExpression = '+n+' |
| const | ExclusiveResultExpression = '*n,m,o,p*' |
| const | EmptyAnswerExpression = "?" |
| 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 () |
| Protected Attributes inherited from assQuestion | |
| $id | |
| $title | |
| $comment | |
| $owner | |
| $author | |
| $question | |
| $points | |
| $est_working_time | |
| $shuffle | |
| $test_id | |
| $obj_id | |
| $ilias | |
| $tpl | |
| $lng | |
| $db | |
| $refinery | |
| $outputType = OUTPUT_JAVASCRIPT | |
| $suggested_solutions | |
| $original_id | |
| $page | |
| $external_id = '' | |
| $questionChangeListeners = array() | |
| $processLocker | |
| $step = null | |
| $lastChange | |
| $shuffler | |
| $testQuestionConfig | |
| $lifecycle | |
| Static Protected Attributes inherited from assQuestion | |
| static | $allowedFileExtensionsByMimeType |
| static | $allowedCharsetsByMimeType |
| static | $allowedImageMaterialFileExtensionsByMimeType |
| static | $forcePassResultsUpdateEnabled = false |
| static | $imageSourceFixReplaceMap |
Detailed Description
Class for single choice questions assFormulaQuestion is a class for single choice questions.
- Version
- Id
- class.assFormulaQuestion.php 1236 2010-02-15 15:44:16Z hschottm
Definition at line 19 of file class.assFormulaQuestion.php.
Constructor & Destructor Documentation
◆ __construct()
| assFormulaQuestion::__construct | ( | $title = "", |
|
$comment = "", |
|||
$author = "", |
|||
$owner = -1, |
|||
$question = "" |
|||
| ) |
assFormulaQuestion constructor The constructor takes possible arguments an creates an instance of the assFormulaQuestion 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 single choice question @access public
- See also
- assQuestion:assQuestion()
Definition at line 41 of file class.assFormulaQuestion.php.
47 {
49 $this->variables = array();
50 $this->results = array();
51 $this->resultunits = array();
53 }
Class ilUnitConfigurationRepository.
Definition: class.ilUnitConfigurationRepository.php:11
References assQuestion\$author, assQuestion\$comment, assQuestion\$owner, assQuestion\$question, assQuestion\$title, and ILIAS\GlobalScreen\Provider\__construct().
Here is the call graph for this function:
Member Function Documentation
◆ __get()
| assFormulaQuestion::__get | ( | $value | ) |
Object getter.
Reimplemented from assQuestion.
Definition at line 1312 of file class.assFormulaQuestion.php.
1313 {
1314 switch ($value) {
1315 case "resultunits":
1317 break;
1318 default:
1319 return parent::__get($value);
1320 break;
1321 }
1322 }
References $resultunits.
◆ addResult()
| assFormulaQuestion::addResult | ( | $result | ) |
Definition at line 96 of file class.assFormulaQuestion.php.
97 {
99 }
References $result.
Referenced by loadFromDb(), and parseQuestionText().
Here is the caller graph for this function:
◆ addResultUnit()
| assFormulaQuestion::addResultUnit | ( | $result, | |
| $unit | |||
| ) |
Definition at line 114 of file class.assFormulaQuestion.php.
115 {
118 $this->resultunits[$result->getResult()] = array();
119 }
120 $this->resultunits[$result->getResult()][$unit->getId()] = $unit;
121 }
122 }
References $result.
Referenced by loadFromDb().
Here is the caller graph for this function:
◆ addResultUnits()
| assFormulaQuestion::addResultUnits | ( | $result, | |
| $unit_ids | |||
| ) |
Definition at line 101 of file class.assFormulaQuestion.php.
102 {
103 $this->resultunits[$result->getResult()] = array();
105 return;
106 }
110 }
111 }
112 }
getUnitrepository()
Definition: class.assFormulaQuestion.php:1335
References assQuestion\$id, $result, and getUnitrepository().
Here is the call graph for this function:
◆ addVariable()
| assFormulaQuestion::addVariable | ( | $variable | ) |
Definition at line 73 of file class.assFormulaQuestion.php.
74 {
75 $this->variables[$variable->getVariable()] = $variable;
76 }
Referenced by loadFromDb(), and parseQuestionText().
Here is the caller graph for this function:
◆ calculateReachedPoints()
| assFormulaQuestion::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.
- Parameters
-
integer $user_id The database ID of the learner integer $test_id The database Id of the test containing the question @access public
Reimplemented from assQuestion.
Definition at line 856 of file class.assFormulaQuestion.php.
857 {
860 }
862 $user_solution = array();
863 foreach ($solutions as $idx => $solution_value) {
864 if (preg_match("/^(\\\$v\\d+)$/", $solution_value["value1"], $matches)) {
865 $user_solution[$matches[1]] = $solution_value["value2"];
867 $varObj->setValue($solution_value["value2"]);
868 } elseif (preg_match("/^(\\\$r\\d+)$/", $solution_value["value1"], $matches)) {
869 if (!array_key_exists($matches[1], $user_solution)) {
870 $user_solution[$matches[1]] = array();
871 }
872 $user_solution[$matches[1]]["value"] = $solution_value["value2"];
873 } elseif (preg_match("/^(\\\$r\\d+)_unit$/", $solution_value["value1"], $matches)) {
874 if (!array_key_exists($matches[1], $user_solution)) {
875 $user_solution[$matches[1]] = array();
876 }
877 $user_solution[$matches[1]]["unit"] = $solution_value["value2"];
878 }
879 }
880 //vd($this->getResults());
881 $points = 0;
883 //vd($user_solution[$result->getResult()]["value"]);
884 $points += $result->getReachedPoints($this->getVariables(), $this->getResults(), $user_solution[$result->getResult()]["value"], $user_solution[$result->getResult()]["unit"], $this->unitrepository->getUnits());
885 }
886
888 }
getSolutionValues($active_id, $pass=null, $authorized=true)
Loads solutions of a given user from the database an returns it.
Definition: class.assQuestion.php:1818
getSolutionMaxPass($active_id)
Returns the maximum pass a users question solution.
Definition: class.assQuestion.php:3368
References $pass, assQuestion\$points, $result, getResults(), assQuestion\getSolutionMaxPass(), assQuestion\getSolutionValues(), getVariable(), and getVariables().
Here is the call graph for this function:
◆ calculateReachedPointsFromPreviewSession()
| assFormulaQuestion::calculateReachedPointsFromPreviewSession | ( | ilAssQuestionPreviewSession | $previewSession | ) |
Reimplemented from assQuestion.
Definition at line 890 of file class.assFormulaQuestion.php.
891 {
892 $user_solution = $previewSession->getParticipantsSolution();
893
894 $points = 0;
897 $u = isset($user_solution[$result->getResult() . '_unit']) ? $user_solution[$result->getResult() . '_unit'] : null;
898
900 $this->getVariables(),
901 $this->getResults(),
902 $v,
903 $u,
904 $this->unitrepository->getUnits()
905 );
906 }
907
909
911 }
deductHintPointsFromReachedPoints(ilAssQuestionPreviewSession $previewSession, $reachedPoints)
Definition: class.assQuestion.php:3471
ensureNonNegativePoints($points)
Definition: class.assQuestion.php:3490
getParticipantsSolution()
Definition: class.ilAssQuestionPreviewSession.php:79
References assQuestion\$points, $result, assQuestion\deductHintPointsFromReachedPoints(), assQuestion\ensureNonNegativePoints(), ilAssQuestionPreviewSession\getParticipantsSolution(), getResults(), and getVariables().
Here is the call graph for this function:
◆ canUseAdvancedRating()
| assFormulaQuestion::canUseAdvancedRating | ( | $result | ) |
Check if advanced rating can be used for a result.
This is only possible if there is exactly one possible correct unit for the result, otherwise it is impossible to determine wheather the unit is correct or the value.
- Returns
- boolean True if advanced rating could be used, false otherwise
Definition at line 485 of file class.assFormulaQuestion.php.
486 {
488 $resultunit = $result->getUnit();
489 $similar_units = 0;
490 foreach ($result_units as $unit) {
491 if (is_object($resultunit)) {
492 if ($resultunit->getId() != $unit->getId()) {
493 if ($resultunit->getBaseUnit() && $unit->getBaseUnit()) {
494 if ($resultunit->getBaseUnit() == $unit->getBaseUnit()) {
495 return false;
496 }
497 }
498 if ($resultunit->getBaseUnit()) {
499 if ($resultunit->getBaseUnit() == $unit->getId()) {
500 return false;
501 }
502 }
503 if ($unit->getBaseUnit()) {
504 if ($unit->getBaseUnit() == $resultunit->getId()) {
505 return false;
506 }
507 }
508 }
509 }
510 }
511 return true;
512 }
getResultUnits($result)
Definition: class.assFormulaQuestion.php:124
References $result, and getResultUnits().
Here is the call graph for this function:
◆ checkForDuplicateResults()
| assFormulaQuestion::checkForDuplicateResults | ( | ) |
Definition at line 173 of file class.assFormulaQuestion.php.
174 {
176 if ((count(array_unique($rmatches[1]))) != count($rmatches[1])) {
177 return false;
178 }
179 }
180 return true;
181 }
References assQuestion\getQuestion().
Here is the call graph for this function:
◆ checkForDuplicateVariables()
| assFormulaQuestion::checkForDuplicateVariables | ( | ) |
Definition at line 163 of file class.assFormulaQuestion.php.
164 {
166 if ((count(array_unique($matches[1]))) != count($matches[1])) {
167 return false;
168 }
169 }
170 return true;
171 }
References assQuestion\getQuestion().
Here is the call graph for this function:
◆ clearResults()
| assFormulaQuestion::clearResults | ( | ) |
Definition at line 78 of file class.assFormulaQuestion.php.
79 {
80 $this->results = array();
81 }
Referenced by parseQuestionText().
Here is the caller graph for this function:
◆ clearVariables()
| assFormulaQuestion::clearVariables | ( | ) |
Definition at line 55 of file class.assFormulaQuestion.php.
56 {
57 $this->variables = array();
58 }
Referenced by parseQuestionText().
Here is the caller graph for this function:
◆ copyObject()
| assFormulaQuestion::copyObject | ( | $target_questionpool_id, | |
$title = "" |
|||
| ) |
Copies an assFormulaQuestion object @access public.
Definition at line 772 of file class.assFormulaQuestion.php.
773 {
774 if ($this->id <= 0) {
775 // The question has not been saved. It cannot be duplicated
776 return;
777 }
778 // duplicate the question in database
779 $clone = $this;
780 include_once("./Modules/TestQuestionPool/classes/class.assQuestion.php");
782 $clone->id = -1;
783 $source_questionpool_id = $this->getObjId();
784 $clone->setObjId($target_questionpool_id);
786 $clone->setTitle($title);
787 }
788 $clone->saveToDb();
789
790 $clone->unitrepository->cloneUnits($original_id, $clone->getId());
791
792 // copy question page content
793 $clone->copyPageOfQuestion($original_id);
794 // copy XHTML media objects
795 $clone->copyXHTMLMediaObjectsOfQuestion($original_id);
796
797 $clone->onCopy($source_questionpool_id, $original_id, $clone->getObjId(), $clone->getId());
798
799 return $clone->id;
800 }
static _getOriginalId($question_id)
Returns the original id of a question.
Definition: class.assQuestion.php:3157
References assQuestion\$original_id, assQuestion\$title, assQuestion\_getOriginalId(), and assQuestion\getObjId().
Here is the call graph for this function:
◆ createNewOriginalFromThisDuplicate()
| assFormulaQuestion::createNewOriginalFromThisDuplicate | ( | $targetParentId, | |
$targetQuestionTitle = "" |
|||
| ) |
Definition at line 802 of file class.assFormulaQuestion.php.
803 {
804 if ($this->id <= 0) {
805 // The question has not been saved. It cannot be duplicated
806 return;
807 }
808
809 include_once("./Modules/TestQuestionPool/classes/class.assQuestion.php");
810
811 $sourceQuestionId = $this->id;
812 $sourceParentId = $this->getObjId();
813
814 // duplicate the question in database
815 $clone = $this;
816 $clone->id = -1;
817
818 $clone->setObjId($targetParentId);
819
820 if ($targetQuestionTitle) {
821 $clone->setTitle($targetQuestionTitle);
822 }
823
824 $clone->saveToDb();
825 // copy question page content
826 $clone->copyPageOfQuestion($sourceQuestionId);
827 // copy XHTML media objects
828 $clone->copyXHTMLMediaObjectsOfQuestion($sourceQuestionId);
829
830 $clone->onCopy($sourceParentId, $sourceQuestionId, $clone->getObjId(), $clone->getId());
831
832 return $clone->id;
833 }
References assQuestion\$id, and assQuestion\getObjId().
Here is the call graph for this function:
◆ deleteAnswers()
| assFormulaQuestion::deleteAnswers | ( | $question_id | ) |
Deletes datasets from answers tables.
- Parameters
-
integer $question_id The question id which should be deleted in the answers table @access public
Reimplemented from assQuestion.
Definition at line 1146 of file class.assFormulaQuestion.php.
1147 {
1148 global $DIC;
1150
1151 $affectedRows = $ilDB->manipulateF(
1152 "DELETE FROM il_qpl_qst_fq_var WHERE question_fi = %s",
1153 array('integer'),
1154 array($question_id)
1155 );
1156
1157 $affectedRows = $ilDB->manipulateF(
1158 "DELETE FROM il_qpl_qst_fq_res WHERE question_fi = %s",
1159 array('integer'),
1160 array($question_id)
1161 );
1162
1163 $affectedRows = $ilDB->manipulateF(
1164 "DELETE FROM il_qpl_qst_fq_res_unit WHERE question_fi = %s",
1165 array('integer'),
1166 array($question_id)
1167 );
1168
1169 $affectedRows = $ilDB->manipulateF(
1170 "DELETE FROM il_qpl_qst_fq_ucat WHERE question_fi = %s",
1171 array('integer'),
1172 array($question_id)
1173 );
1174
1175 $affectedRows = $ilDB->manipulateF(
1176 "DELETE FROM il_qpl_qst_fq_unit WHERE question_fi = %s",
1177 array('integer'),
1178 array($question_id)
1179 );
1180 }
◆ duplicate()
| assFormulaQuestion::duplicate | ( | $for_test = true, |
|
$title = "", |
|||
$author = "", |
|||
$owner = "", |
|||
$testObjId = null |
|||
| ) |
Duplicates an assFormulaQuestion @access public.
Reimplemented from assQuestion.
Definition at line 721 of file class.assFormulaQuestion.php.
722 {
723 if ($this->id <= 0) {
724 // The question has not been saved. It cannot be duplicated
725 return;
726 }
727 // duplicate the question in database
728 $this_id = $this->getId();
729 $thisObjId = $this->getObjId();
730
731 $clone = $this;
732 include_once("./Modules/TestQuestionPool/classes/class.assQuestion.php");
734 $clone->id = -1;
735
736 if ((int) $testObjId > 0) {
737 $clone->setObjId($testObjId);
738 }
739
741 $clone->setTitle($title);
742 }
743
745 $clone->setAuthor($author);
746 }
748 $clone->setOwner($owner);
749 }
750
751 if ($for_test) {
752 $clone->saveToDb($original_id);
753 } else {
754 $clone->saveToDb();
755 }
756
757 $clone->unitrepository->cloneUnits($this_id, $clone->getId());
758
759 // copy question page content
760 $clone->copyPageOfQuestion($this_id);
761 // copy XHTML media objects
762 $clone->copyXHTMLMediaObjectsOfQuestion($this_id);
763 $clone->onDuplicate($thisObjId, $this_id, $clone->getObjId(), $clone->getId());
764
765 return $clone->id;
766 }
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:
◆ fetchAllResults()
| assFormulaQuestion::fetchAllResults | ( | $questionText | ) |
- Parameters
-
string $questionText
- Returns
- assFormulaQuestionResult[] $resObjects
Definition at line 187 of file class.assFormulaQuestion.php.
188 {
189 $resObjects = array();
190 $matches = null;
191
192 if (preg_match_all("/(\\\$r\\d+)/ims", $questionText, $matches)) {
193 foreach ($matches[1] as $resultKey) {
194 $resObjects[] = $this->getResult($resultKey);
195 }
196 }
197
198 return $resObjects;
199 }
References getResult().
Referenced by getInitialVariableSolutionValues().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ fetchAllVariables()
| assFormulaQuestion::fetchAllVariables | ( | $questionText | ) |
- Parameters
-
string $questionText
- Returns
- assFormulaQuestionVariable[] $varObjects
Definition at line 205 of file class.assFormulaQuestion.php.
206 {
207 $varObjects = array();
208 $matches = null;
209
210 if (preg_match_all("/(\\\$v\\d+)/ims", $questionText, $matches)) {
211 foreach ($matches[1] as $variableKey) {
212 $varObjects[] = $this->getVariable($variableKey);
213 }
214 }
215
216 return $varObjects;
217 }
References getVariable().
Referenced by getInitialVariableSolutionValues(), hasRequiredVariableSolutionValues(), and substituteVariables().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ getAdditionalTableName()
| assFormulaQuestion::getAdditionalTableName | ( | ) |
Returns the name of the additional question data table in the database.
- Returns
- string The additional table name
Reimplemented from assQuestion.
Definition at line 1127 of file class.assFormulaQuestion.php.
1128 {
1129 return "";
1130 }
◆ getAnswerTableName()
| assFormulaQuestion::getAnswerTableName | ( | ) |
Returns the name of the answer table in the database.
- Returns
- string The answer table name
Reimplemented from assQuestion.
Definition at line 1136 of file class.assFormulaQuestion.php.
1137 {
1138 return "";
1139 }
◆ getAvailableAnswerOptions()
| assFormulaQuestion::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 1452 of file class.assFormulaQuestion.php.
1453 {
1456 } else {
1458 }
1459 }
References $index, getResult(), and getResults().
Here is the call graph for this function:
◆ getBestSolution()
| assFormulaQuestion::getBestSolution | ( | $solutions | ) |
Returns the best solution for a given pass of a participant.
- Returns
- array An associated array containing the best solution @access public
Definition at line 1230 of file class.assFormulaQuestion.php.
1231 {
1232 $user_solution = array();
1233
1234 foreach ($solutions as $idx => $solution_value) {
1235 if (preg_match("/^(\\\$v\\d+)$/", $solution_value["value1"], $matches)) {
1236 $user_solution[$matches[1]] = $solution_value["value2"];
1237 $varObj = $this->getVariable($matches[1]);
1238 $varObj->setValue($solution_value["value2"]);
1239 } elseif (preg_match("/^(\\\$r\\d+)$/", $solution_value["value1"], $matches)) {
1240 if (!array_key_exists($matches[1], $user_solution)) {
1241 $user_solution[$matches[1]] = array();
1242 }
1243 $user_solution[$matches[1]]["value"] = $solution_value["value2"];
1244 } elseif (preg_match("/^(\\\$r\\d+)_unit$/", $solution_value["value1"], $matches)) {
1245 if (!array_key_exists($matches[1], $user_solution)) {
1246 $user_solution[$matches[1]] = array();
1247 }
1248 $user_solution[$matches[1]]["unit"] = $solution_value["value2"];
1249 }
1250 }
1252 $resVal = $result->calculateFormula($this->getVariables(), $this->getResults(), parent::getId(), false);
1253
1258 $unit_factor = 1;
1259 // there is no fix result_unit, any "available unit" is accepted
1260
1261 $available_units = $result->getAvailableResultUnits(parent::getId());
1262 $result_name = $result->getResult();
1263
1264 if ($available_units[$result_name] != null) {
1265 $check_unit = in_array($user_solution[$result_name]['unit'], $available_units[$result_name]);
1266 }
1267
1268 if ($check_unit == true) {
1269 //get unit-factor
1271 }
1272
1273 try {
1277 }
1278 }
1281 $value = assFormulaQuestionResult::convertDecimalToCoprimeFraction($resVal);
1282 if (is_array($value)) {
1285 } else {
1288 }
1289 } else {
1290 $user_solution[$result->getResult()]["value"] = round($user_solution[$result->getResult()]["value"], $result->getPrecision());
1291 /*
1292 $user_solution[$result->getResult()]["value"] = ilMath::_div(
1293 $user_solution[$result->getResult()]["value"],
1294 1,
1295 $result->getPrecision()
1296 );
1297 */
1298 }
1299 }
1300 return $user_solution;
1301 }
const RESULT_CO_FRAC
Definition: class.assFormulaQuestionResult.php:15
const RESULT_FRAC
Definition: class.assFormulaQuestionResult.php:14
static convertDecimalToCoprimeFraction($decimal_value, $tolerance=1.e-9)
Definition: class.assFormulaQuestionResult.php:827
static lookupUnitFactor($a_unit_id)
Definition: class.assFormulaQuestionUnit.php:145
Class ilMathException.
Definition: class.ilMathDivisionByZeroException.php:11
References $result, ilMath\_div(), assFormulaQuestionResult\convertDecimalToCoprimeFraction(), getResults(), getVariable(), getVariables(), assFormulaQuestionUnit\lookupUnitFactor(), assFormulaQuestionResult\RESULT_CO_FRAC, and assFormulaQuestionResult\RESULT_FRAC.
Here is the call graph for this function:
◆ getExpressionTypes()
| assFormulaQuestion::getExpressionTypes | ( | ) |
Get all available expression types for a specific question.
- Returns
- array
Implements iQuestionCondition.
Definition at line 1390 of file class.assFormulaQuestion.php.
1391 {
1392 return array(
1396 );
1397 }
const PercentageResultExpression
Definition: interface.iQuestionCondition.php:12
const NumericResultExpression
Definition: interface.iQuestionCondition.php:13
const EmptyAnswerExpression
Definition: interface.iQuestionCondition.php:18
References iQuestionCondition\EmptyAnswerExpression, iQuestionCondition\NumericResultExpression, and iQuestionCondition\PercentageResultExpression.
◆ getInitialVariableSolutionValues()
| assFormulaQuestion::getInitialVariableSolutionValues | ( | ) |
- Returns
- array $initialVariableSolutionValues
Definition at line 241 of file class.assFormulaQuestion.php.
242 {
245 }
246
247 $variableSolutionValues = array();
248
250 $variableSolutionValues[$varObj->getVariable()] = $varObj->getValue();
251 }
252
253 return $variableSolutionValues;
254 }
fetchAllVariables($questionText)
Definition: class.assFormulaQuestion.php:205
fetchAllResults($questionText)
Definition: class.assFormulaQuestion.php:187
References fetchAllResults(), fetchAllVariables(), assQuestion\getQuestion(), getResults(), and getVariables().
Here is the call graph for this function:
◆ getMaximumPoints()
| assFormulaQuestion::getMaximumPoints | ( | ) |
Returns the maximum points, a learner can reach answering the question.
- See also
- $points
Reimplemented from assQuestion.
Definition at line 839 of file class.assFormulaQuestion.php.
References assQuestion\$points, and $result.
Referenced by isComplete().
Here is the caller graph for this function:
◆ getOperators()
| assFormulaQuestion::getOperators | ( | $expression | ) |
Get all available operations for a specific question.
- Parameters
-
$expression
Implements iQuestionCondition.
Definition at line 1380 of file class.assFormulaQuestion.php.
1381 {
1382 require_once "./Modules/TestQuestionPool/classes/class.ilOperatorsExpressionMapping.php";
1384 }
static getOperatorsByExpression($expression)
Definition: class.ilOperatorsExpressionMapping.php:34
References ilOperatorsExpressionMapping\getOperatorsByExpression().
Here is the call graph for this function:
◆ getQuestionType()
| assFormulaQuestion::getQuestionType | ( | ) |
Returns the question type of the question.
- Returns
- string The question type of the question
Reimplemented from assQuestion.
Definition at line 1118 of file class.assFormulaQuestion.php.
1119 {
1120 return "assFormulaQuestion";
1121 }
◆ getResult()
| assFormulaQuestion::getResult | ( | $result | ) |
Definition at line 88 of file class.assFormulaQuestion.php.
89 {
92 }
93 return null;
94 }
References $result.
Referenced by fetchAllResults(), getAvailableAnswerOptions(), loadFromDb(), and substituteVariables().
Here is the caller graph for this function:
◆ getResults()
| assFormulaQuestion::getResults | ( | ) |
Definition at line 83 of file class.assFormulaQuestion.php.
84 {
86 }
References $results.
Referenced by calculateReachedPoints(), calculateReachedPointsFromPreviewSession(), getAvailableAnswerOptions(), getBestSolution(), getInitialVariableSolutionValues(), and substituteVariables().
Here is the caller graph for this function:
◆ getResultUnits()
| assFormulaQuestion::getResultUnits | ( | $result | ) |
Definition at line 124 of file class.assFormulaQuestion.php.
125 {
128 } else {
129 return array();
130 }
131 }
References $result.
Referenced by canUseAdvancedRating(), saveToDb(), and substituteVariables().
Here is the caller graph for this function:
◆ getRTETextWithMediaObjects()
| assFormulaQuestion::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 1186 of file class.assFormulaQuestion.php.
1187 {
1188 $text = parent::getRTETextWithMediaObjects();
1189 return $text;
1190 }
◆ getSolutionSubmit()
|
protected |
- Returns
- array
Definition at line 1343 of file class.assFormulaQuestion.php.
1344 {
1345 $solutionSubmit = array();
1347 if (preg_match("/^result_(\\\$r\\d+)$/", $k)) {
1348 $solutionSubmit[$k] = $v;
1349 } elseif (preg_match("/^result_(\\\$r\\d+)_unit$/", $k)) {
1350 $solutionSubmit[$k] = $v;
1351 }
1352 }
1353 return $solutionSubmit;
1354 }
References $_POST.
Referenced by savePreviewData(), saveWorkingData(), and validateSolutionSubmit().
Here is the caller graph for this function:
◆ getUnitrepository()
| assFormulaQuestion::getUnitrepository | ( | ) |
- Returns
- \ilUnitConfigurationRepository
Definition at line 1335 of file class.assFormulaQuestion.php.
1336 {
1338 }
References $unitrepository.
Referenced by addResultUnits(), loadFromDb(), setExportDetailsXLS(), and substituteVariables().
Here is the caller graph for this function:
◆ getVariable()
| assFormulaQuestion::getVariable | ( | $variable | ) |
Definition at line 65 of file class.assFormulaQuestion.php.
66 {
67 if (array_key_exists($variable, $this->variables)) {
68 return $this->variables[$variable];
69 }
70 return null;
71 }
Referenced by calculateReachedPoints(), fetchAllVariables(), getBestSolution(), and setExportDetailsXLS().
Here is the caller graph for this function:
◆ getVariables()
| assFormulaQuestion::getVariables | ( | ) |
Definition at line 60 of file class.assFormulaQuestion.php.
61 {
63 }
References $variables.
Referenced by calculateReachedPoints(), calculateReachedPointsFromPreviewSession(), getBestSolution(), getInitialVariableSolutionValues(), and substituteVariables().
Here is the caller graph for this function:
◆ hasRequiredVariableSolutionValues()
| assFormulaQuestion::hasRequiredVariableSolutionValues | ( | array | $userSolution | ) |
- Parameters
-
array $userSolution
- Returns
- bool
Definition at line 223 of file class.assFormulaQuestion.php.
224 {
226 if (!isset($userSolution[$varObj->getVariable()])) {
227 return false;
228 }
229
230 if (!strlen($userSolution[$varObj->getVariable()])) {
231 return false;
232 }
233 }
234
235 return true;
236 }
References fetchAllVariables(), and assQuestion\getQuestion().
Here is the call graph for this function:
◆ hasResultUnit()
| assFormulaQuestion::hasResultUnit | ( | $result, | |
| $unit_id | |||
| ) |
Definition at line 133 of file class.assFormulaQuestion.php.
134 {
137 return true;
138 }
139 }
140
141 return false;
142 }
References $result.
◆ isComplete()
| assFormulaQuestion::isComplete | ( | ) |
Returns true, if the question is complete for use.
- Returns
- boolean True, if the single choice question is complete for use, otherwise false
Reimplemented from assQuestion.
Definition at line 518 of file class.assFormulaQuestion.php.
519 {
520 if (($this->title) and ($this->author) and ($this->question) and ($this->getMaximumPoints() > 0)) {
521 return true;
522 } else {
523 return false;
524 }
525 }
getMaximumPoints()
Returns the maximum points, a learner can reach answering the question.
Definition: class.assFormulaQuestion.php:839
References getMaximumPoints().
Here is the call graph for this function:
◆ isValidSolutionResultValue()
|
protected |
Definition at line 913 of file class.assFormulaQuestion.php.
914 {
915 $submittedValue = str_replace(',', '.', $submittedValue);
916
917 if (is_numeric($submittedValue)) {
918 return true;
919 }
920
921 if (preg_match('/^[-+]{0,1}\d+\/\d+$/', $submittedValue)) {
922 return true;
923 }
924
925 return false;
926 }
Referenced by validateSolutionSubmit().
Here is the caller graph for this function:
◆ loadFromDb()
| assFormulaQuestion::loadFromDb | ( | $question_id | ) |
Loads a assFormulaQuestion object from a database.
- Parameters
-
integer $question_id A unique key which defines the question in the database
Reimplemented from assQuestion.
Definition at line 631 of file class.assFormulaQuestion.php.
632 {
633 global $DIC;
635
637 "SELECT qpl_questions.* FROM qpl_questions WHERE question_id = %s",
638 array('integer'),
639 array($question_id)
640 );
643 $this->setId($question_id);
652
653 try {
657 }
658
659 try {
662 }
663
665
666 include_once("./Services/RTE/classes/class.ilRTE.php");
668 $this->setEstimatedWorkingTime(substr($data["working_time"], 0, 2), substr($data["working_time"], 3, 2), substr($data["working_time"], 6, 2));
669
670 // load variables
672 "SELECT * FROM il_qpl_qst_fq_var WHERE question_fi = %s",
673 array('integer'),
674 array($question_id)
675 );
678 $varObj = new assFormulaQuestionVariable($data["variable"], $data["range_min"], $data["range_max"], $this->getUnitrepository()->getUnit($data["unit_fi"]), $data["varprecision"], $data["intprecision"]);
681 $this->addVariable($varObj);
682 }
683 }
684 // load results
686 "SELECT * FROM il_qpl_qst_fq_res WHERE question_fi = %s",
687 array('integer'),
688 array($question_id)
689 );
692 $resObj = new assFormulaQuestionResult($data["result"], $data["range_min"], $data["range_max"], $data["tolerance"], $this->getUnitrepository()->getUnit($data["unit_fi"]), $data["formula"], $data["points"], $data["resprecision"], $data["rating_simple"], $data["rating_sign"], $data["rating_value"], $data["rating_unit"]);
696 $this->addResult($resObj);
697 }
698 }
699
700 // load result units
702 "SELECT * FROM il_qpl_qst_fq_res_unit WHERE question_fi = %s",
703 array('integer'),
704 array($question_id)
705 );
710 $this->addResultUnit($resObj, $unit);
711 }
712 }
713 }
714 parent::loadFromDb($question_id);
715 }
Formula Question Variable.
Definition: class.assFormulaQuestionVariable.php:11
addResultUnit($result, $unit)
Definition: class.assFormulaQuestion.php:114
setSuggestedSolution($solution_id="", $subquestion_index=0, $is_import=false)
Sets a suggested solution for the question.
Definition: class.assQuestion.php:2850
setTitle($title="")
Sets the title string of the assQuestion object.
Definition: class.assQuestion.php:628
setOwner($owner="")
Sets the creator/owner ID of the assQuestion object.
Definition: class.assQuestion.php:769
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:708
setAuthor($author="")
Sets the authors name of the assQuestion object.
Definition: class.assQuestion.php:754
setLifecycle(ilAssQuestionLifecycle $lifecycle)
Definition: class.assQuestion.php:962
setPoints($a_points)
Sets the maximum available points for the question.
Definition: class.assQuestion.php:3357
setComment($comment="")
Sets the comment string of the assQuestion object.
Definition: class.assQuestion.php:664
setAdditionalContentEditingMode($additinalContentEditingMode)
setter for additional content editing mode for this question
Definition: class.assQuestion.php:4660
setQuestion($question="")
Sets the question string of the question object.
Definition: class.assQuestion.php:3804
static getDraftInstance()
Definition: class.ilAssQuestionLifecycle.php:172
static getInstance($identifier)
Definition: class.ilAssQuestionLifecycle.php:160
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:228
References $data, $DIC, Vendor\Package\$e, $ilDB, $result, ilRTE\_replaceMediaObjectImageSrc(), addResult(), addResultUnit(), addVariable(), ilAssQuestionLifecycle\getDraftInstance(), ilAssQuestionLifecycle\getInstance(), getResult(), getUnitrepository(), assQuestion\setAdditionalContentEditingMode(), assQuestion\setAuthor(), assQuestion\setComment(), assQuestion\setEstimatedWorkingTime(), setId(), assQuestion\setLifecycle(), assQuestion\setObjId(), assQuestion\setOriginalId(), assQuestion\setOwner(), assQuestion\setPoints(), assQuestion\setQuestion(), assQuestion\setSuggestedSolution(), and assQuestion\setTitle().
Here is the call graph for this function:
◆ lookupForExistingSolutions()
| assFormulaQuestion::lookupForExistingSolutions | ( | $activeId, | |
| $pass | |||
| ) |
Lookup if an authorized or intermediate solution exists.
- Parameters
-
int $activeId int $pass
- Returns
- array ['authorized' => bool, 'intermediate' => bool]
Definition at line 1027 of file class.assFormulaQuestion.php.
1028 {
1029 global $DIC;
1031
1032 $return = array(
1033 'authorized' => false,
1034 'intermediate' => false
1035 );
1036
1038 SELECT authorized, COUNT(*) cnt
1039 FROM tst_solutions
1043 AND value1 like '\$r%'
1044 AND value2 is not null
1045 AND value2 <> ''
1046 ";
1047
1050 }
1051
1053 GROUP BY authorized
1054 ";
1055
1057
1059 if ($row['authorized']) {
1060 $return['authorized'] = $row['cnt'] > 0;
1061 } else {
1062 $return['intermediate'] = $row['cnt'] > 0;
1063 }
1064 }
1065 return $return;
1066 }
References $DIC, $ilDB, $pass, $query, $result, assQuestion\getId(), and assQuestion\getStep().
Here is the call graph for this function:
◆ parseQuestionText()
| assFormulaQuestion::parseQuestionText | ( | ) |
Definition at line 144 of file class.assFormulaQuestion.php.
145 {
146 $this->clearResults();
147 $this->clearVariables();
149 foreach ($matches[1] as $variable) {
151 $this->addVariable($varObj);
152 }
153 }
154
158 $this->addResult($resObj);
159 }
160 }
161 }
References $result, addResult(), addVariable(), clearResults(), clearVariables(), and assQuestion\getQuestion().
Here is the call graph for this function:
◆ removeExistingSolutions()
| assFormulaQuestion::removeExistingSolutions | ( | $activeId, | |
| $pass | |||
| ) |
Remove an existing solution without removing the variables.
- Parameters
-
int $activeId int $pass
- Returns
- int
Reimplemented from assQuestion.
Definition at line 1076 of file class.assFormulaQuestion.php.
1077 {
1078 global $DIC;
1080
1082 DELETE FROM tst_solutions
1086 AND value1 like '\$r%'
1087 ";
1088
1091 }
1092
1094 }
References $DIC, $ilDB, $pass, $query, assQuestion\getId(), and assQuestion\getStep().
Here is the call graph for this function:
◆ savePreviewData()
|
protected |
Reimplemented from assQuestion.
Definition at line 1097 of file class.assFormulaQuestion.php.
1098 {
1099 $userSolution = $previewSession->getParticipantsSolution();
1100
1102 $matches = null;
1103
1104 if (preg_match("/^result_(\\\$r\\d+)$/", $key, $matches)) {
1105 $userSolution[$matches[1]] = $val;
1106 } elseif (preg_match("/^result_(\\\$r\\d+)_unit$/", $key, $matches)) {
1107 $userSolution[$matches[1] . "_unit"] = $val;
1108 }
1109 }
1110
1111 $previewSession->setParticipantsSolution($userSolution);
1112 }
getSolutionSubmit()
Definition: class.assFormulaQuestion.php:1343
setParticipantsSolution($participantSolution)
Definition: class.ilAssQuestionPreviewSession.php:74
References ilAssQuestionPreviewSession\getParticipantsSolution(), getSolutionSubmit(), and ilAssQuestionPreviewSession\setParticipantsSolution().
Here is the call graph for this function:
◆ saveToDb()
| assFormulaQuestion::saveToDb | ( | $original_id = "" | ) |
Saves a assFormulaQuestion object to a database @access public.
Reimplemented from assQuestion.
Definition at line 531 of file class.assFormulaQuestion.php.
532 {
533 global $DIC;
535
537 // save variables
538 $affectedRows = $ilDB->manipulateF(
539 "
540 DELETE FROM il_qpl_qst_fq_var
541 WHERE question_fi = %s",
542 array("integer"),
543 array($this->getId())
544 );
545
546 foreach ($this->variables as $variable) {
548 $ilDB->insert(
549 'il_qpl_qst_fq_var',
550 array(
551 'variable_id' => array('integer', $next_id),
553 'variable' => array('text', $variable->getVariable()),
554 'range_min' => array('float', ((strlen($variable->getRangeMin())) ? $variable->getRangeMin() : 0.0)),
555 'range_max' => array('float', ((strlen($variable->getRangeMax())) ? $variable->getRangeMax() : 0.0)),
556 'unit_fi' => array('integer', (is_object($variable->getUnit()) ? (int) $variable->getUnit()->getId() : 0)),
557 'varprecision' => array('integer', (int) $variable->getPrecision()),
558 'intprecision' => array('integer', (int) $variable->getIntprecision()),
559 'range_min_txt' => array('text', $variable->getRangeMinTxt()),
560 'range_max_txt' => array('text', $variable->getRangeMaxTxt())
561 )
562 );
563 }
564 // save results
565 $affectedRows = $ilDB->manipulateF(
566 "DELETE FROM il_qpl_qst_fq_res WHERE question_fi = %s",
567 array("integer"),
568 array($this->getId())
569 );
570
574 $tmp_result_unit = $result->getUnit()->getId();
575 } else {
576 $tmp_result_unit = null;
577 }
578
580
582 "result_id" => array("integer", $next_id),
587 "tolerance" => array("float", ((strlen($result->getTolerance())) ? $result->getTolerance() : 0)),
588 "unit_fi" => array("integer", (int) $tmp_result_unit),
589 "formula" => array("clob", $formula),
599
600 ));
601 }
602 // save result units
603 $affectedRows = $ilDB->manipulateF(
604 "DELETE FROM il_qpl_qst_fq_res_unit WHERE question_fi = %s",
605 array("integer"),
606 array($this->getId())
607 );
611 $affectedRows = $ilDB->manipulateF(
612 "INSERT INTO il_qpl_qst_fq_res_unit (result_unit_id, question_fi, result, unit_fi) VALUES (%s, %s, %s, %s)",
613 array('integer', 'integer', 'text', 'integer'),
614 array(
615 $next_id,
616 $this->getId(),
617 $result->getResult(),
618 $unit->getId()
619 )
620 );
621 }
622 }
623
624 parent::saveToDb();
625 }
saveQuestionDataToDb($original_id="")
Definition: class.assQuestion.php:2622
References $DIC, $ilDB, assQuestion\$original_id, $result, assQuestion\getId(), getResultUnits(), and assQuestion\saveQuestionDataToDb().
Here is the call graph for this function:
◆ saveWorkingData()
| assFormulaQuestion::saveWorkingData | ( | $active_id, | |
$pass = null, |
|||
$authorized = true |
|||
| ) |
Saves the learners input of the question to the database.
- Parameters
-
integer $test_id The database id of the test containing this question
- Returns
- boolean Indicates the save status (true if saved successful, false otherwise) @access public
- See also
- $answers
Reimplemented from assQuestion.
Definition at line 935 of file class.assFormulaQuestion.php.
936 {
937 global $DIC;
939
941 include_once "./Modules/Test/classes/class.ilObjTest.php";
943 }
944
945 $entered_values = false;
946
947 $this->getProcessLocker()->executeUserSolutionUpdateLockOperation(function () use (&$entered_values, $ilDB, $active_id, $pass, $authorized) {
948 $solutionSubmit = $this->getSolutionSubmit();
949 foreach ($solutionSubmit as $key => $value) {
950 $matches = null;
951 if (preg_match("/^result_(\\\$r\\d+)$/", $key, $matches)) {
952 if (strlen($value)) {
953 $entered_values = true;
954 }
955
956 $queryResult = "SELECT solution_id FROM tst_solutions WHERE active_fi = %s AND pass = %s AND question_fi = %s AND authorized = %s AND " . $ilDB->like('value1', 'clob', $matches[1]);
957
960 }
961
963 $queryResult,
964 array('integer', 'integer', 'integer', 'integer'),
966 );
969 $ilDB->manipulateF(
970 "DELETE FROM tst_solutions WHERE solution_id = %s AND authorized = %s",
971 array('integer', 'integer'),
972 array($row['solution_id'], (int) $authorized)
973 );
974 }
975 }
976
977 $this->saveCurrentSolution($active_id, $pass, $matches[1], str_replace(",", ".", $value), $authorized);
978 } elseif (preg_match("/^result_(\\\$r\\d+)_unit$/", $key, $matches)) {
979 $queryResultUnit = "SELECT solution_id FROM tst_solutions WHERE active_fi = %s AND pass = %s AND question_fi = %s AND authorized = %s AND " . $ilDB->like('value1', 'clob', $matches[1] . "_unit");
980
983 }
984
986 $queryResultUnit,
987 array('integer', 'integer', 'integer', 'integer'),
989 );
992 $ilDB->manipulateF(
993 "DELETE FROM tst_solutions WHERE solution_id = %s AND authorized = %s",
994 array('integer', 'integer'),
995 array($row['solution_id'], (int) $authorized)
996 );
997 }
998 }
999
1001 }
1002 }
1003 });
1004
1005 if ($entered_values) {
1006 include_once("./Modules/Test/classes/class.ilObjAssessmentFolder.php");
1008 assQuestion::logAction($this->lng->txtlng("assessment", "log_user_entered_values", ilObjAssessmentFolder::_getLogLanguage()), $active_id, $this->getId());
1009 }
1010 } else {
1011 include_once("./Modules/Test/classes/class.ilObjAssessmentFolder.php");
1013 assQuestion::logAction($this->lng->txtlng("assessment", "log_user_not_entered_values", ilObjAssessmentFolder::_getLogLanguage()), $active_id, $this->getId());
1014 }
1015 }
1016
1017 return true;
1018 }
saveCurrentSolution($active_id, $pass, $value1, $value2, $authorized=true, $tstamp=null)
Definition: class.assQuestion.php:4947
static logAction($logtext="", $active_id="", $question_id="")
Logs an action into the Test&Assessment log.
Definition: class.assQuestion.php:1640
static _getLogLanguage()
retrieve the log language for assessment logging
Definition: class.ilObjAssessmentFolder.php:159
static _enabledAssessmentLogging()
check wether assessment logging is enabled or not
Definition: class.ilObjAssessmentFolder.php:118
static _getPass($active_id)
Retrieves the actual pass of a given user for a given test.
Definition: class.ilObjTest.php:8083
References $DIC, $ilDB, $pass, $result, ilObjAssessmentFolder\_enabledAssessmentLogging(), ilObjAssessmentFolder\_getLogLanguage(), ilObjTest\_getPass(), assQuestion\getId(), assQuestion\getProcessLocker(), getSolutionSubmit(), assQuestion\getStep(), assQuestion\logAction(), and assQuestion\saveCurrentSolution().
Here is the call graph for this function:
◆ setExportDetailsXLS()
| assFormulaQuestion::setExportDetailsXLS | ( | $worksheet, | |
| $startrow, | |||
| $active_id, | |||
| $pass | |||
| ) |
{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
- Returns
- object
Reimplemented from assQuestion.
Definition at line 1195 of file class.assFormulaQuestion.php.
1196 {
1197 parent::setExportDetailsXLS($worksheet, $startrow, $active_id, $pass);
1198
1200
1201 $i = 1;
1202 foreach ($solution as $solutionvalue) {
1204 $worksheet->setBold($worksheet->getColumnCoord(0) . ($startrow + $i));
1205 if (strpos($solutionvalue["value1"], "_unit")) {
1207 if (is_object($unit)) {
1208 $worksheet->setCell($startrow + $i, 2, $unit->getUnit());
1209 }
1210 } else {
1212 }
1213 if (preg_match("/(\\\$v\\d+)/", $solutionvalue["value1"], $matches)) {
1215 if (is_object($var) && (is_object($var->getUnit()))) {
1216 $worksheet->setCell($startrow + $i, 3, $var->getUnit()->getUnit());
1217 }
1218 }
1219 $i++;
1220 }
1221
1223 }
References $i, $pass, assQuestion\getSolutionValues(), getUnitrepository(), and getVariable().
Here is the call graph for this function:
◆ setId()
| assFormulaQuestion::setId | ( | $id = -1 | ) |
Sets the id of the assQuestion object.
- Parameters
-
integer $id A unique integer value @access public
- See also
- $id
Reimplemented from assQuestion.
Definition at line 1303 of file class.assFormulaQuestion.php.
References assQuestion\$id, and assQuestion\getId().
Referenced by loadFromDb().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ setUnitrepository()
| assFormulaQuestion::setUnitrepository | ( | $unitrepository | ) |
- Parameters
-
\ilUnitConfigurationRepository $unitrepository
Definition at line 1327 of file class.assFormulaQuestion.php.
References $unitrepository.
◆ substituteVariables()
| assFormulaQuestion::substituteVariables | ( | array | $userdata, |
$graphicalOutput = false, |
|||
$forsolution = false, |
|||
$result_output = false |
|||
| ) |
- Parameters
-
array $userdata bool $graphicalOutput bool $forsolution bool $result_output ilAssQuestionPreviewSession | null $previewSession
- Returns
- bool|mixed|string
Definition at line 264 of file class.assFormulaQuestion.php.
265 {
266 if ((count($this->results) == 0) && (count($this->variables) == 0)) {
267 return false;
268 }
269
270 $text = $this->getQuestion();
271
273 if (isset($userdata[$varObj->getVariable()]) && strlen($userdata[$varObj->getVariable()])) {
274 $varObj->setValue($userdata[$varObj->getVariable()]);
275 }
276
277 $unit = (is_object($varObj->getUnit())) ? $varObj->getUnit()->getUnit() : "";
278 $val = (strlen($varObj->getValue()) > 8) ? strtoupper(sprintf("%e", $varObj->getValue())) : $varObj->getValue();
279
280 $text = preg_replace("/\\$" . substr($varObj->getVariable(), 1) . "(?![0-9]+)/", $val . " " . $unit . "\\1", $text);
281 }
282
283 $text = $this->purifyAndPrepareTextAreaOutput($text);
284
287 $resObj = $this->getResult($result);
288 $value = "";
289 $frac_helper = '';
291
292 if (
293 $resObj->getResultType() == assFormulaQuestionResult::RESULT_FRAC ||
294 $resObj->getResultType() == assFormulaQuestionResult::RESULT_CO_FRAC
295 ) {
296 $is_frac = true;
297 }
298 if (is_array($userdata)) {
300 if (false && $forsolution && $result_output) { // fix for mantis #25956
301 $value_org = $resObj->calculateFormula($this->getVariables(), $this->getResults(), parent::getId());
302 $value = sprintf("%." . $resObj->getPrecision() . "f", $value_org);
303 if ($is_frac) {
304 $value = assFormulaQuestionResult::convertDecimalToCoprimeFraction($value_org);
305 if (is_array($value)) {
306 $frac_helper = $value[1];
307 $value = $value[0];
308 }
309 }
310 } else {
311 if ($forsolution) {
313 } else {
315 }
316 }
317 }
318 } else {
319 if ($forsolution) {
320 $value = $resObj->calculateFormula($this->getVariables(), $this->getResults(), parent::getId());
321 $value = sprintf("%." . $resObj->getPrecision() . "f", $value);
322
323 if ($is_frac) {
324 $value = assFormulaQuestionResult::convertDecimalToCoprimeFraction($value);
325 if (is_array($value)) {
326 $frac_helper = $value[1];
327 $value = $value[0];
328 }
329 $value = ' value="' . $value . '"';
330 }
331 } else {
332 // Precision fix for Preview by tjoussen
333 // If all default values are set, this function is called in getPreview
334 $use_precision = !($userdata == null && $graphicalOutput == false && $forsolution == false && $result_output == false);
335
336 $val = $resObj->calculateFormula($this->getVariables(), $this->getResults(), parent::getId(), $use_precision);
337
339 || $resObj->getResultType() == assFormulaQuestionResult::RESULT_CO_FRAC) {
340 $val = $resObj->convertDecimalToCoprimeFraction($val);
341 if (is_array($val)) {
342 $frac_helper = $val[1];
343 $val = $val[0];
344 }
345 } else {
346 $val = sprintf("%." . $resObj->getPrecision() . "f", $val);
347 $val = (strlen($val) > 8) ? strtoupper(sprintf("%e", $val)) : $val;
348 }
349 $value = ' value="' . $val . '"';
350 }
351 }
352
353 if ($forsolution) {
354 $input = '<span class="ilc_qinput_TextInput solutionbox">' . ilUtil::prepareFormOutput($value) . '</span>';
355 } else {
356 $input = '<input class="ilc_qinput_TextInput" type="text" spellcheck="false" autocomplete="off" autocorrect="off" autocapitalize="off" name="result_' . $result . '"' . $value . ' />';
357 }
358
359 $units = "";
361 if ($forsolution) {
362 if (is_array($userdata)) {
365 $units = $unit->getUnit();
366 }
367 }
368 } else {
369 if ($resObj->getUnit()) {
370 $units = $resObj->getUnit()->getUnit();
371 }
372 }
373 } else {
375 $units .= '<option value="-1">' . $this->lng->txt("select_unit") . '</option>';
377 $units .= '<option value="' . $unit->getId() . '"';
380 $units .= ' selected="selected"';
381 }
382 }
383 $units .= '>' . $unit->getUnit() . '</option>';
384 }
385 $units .= '</select>';
386 }
387 } else {
388 $units = "";
389 }
390 switch ($resObj->getResultType()) {
392 $units .= ' ' . $this->lng->txt('expected_result_type') . ': ' . $this->lng->txt('result_dec');
393 break;
395 if (strlen($frac_helper)) {
396 $units .= ' ≈ ' . $frac_helper . ', ';
397 } elseif (is_array($userdata) && isset($userdata[$result]) && strlen($userdata[$result]["frac_helper"])) {
398 if (!preg_match('-/-', $value)) {
400 }
401 }
402 $units .= ' ' . $this->lng->txt('expected_result_type') . ': ' . $this->lng->txt('result_frac');
403 break;
405 if (strlen($frac_helper)) {
406 $units .= ' ≈ ' . $frac_helper . ', ';
407 } elseif (is_array($userdata) && isset($userdata[$result]) && strlen($userdata[$result]["frac_helper"])) {
408 if (!preg_match('-/-', $value)) {
410 }
411 }
412 $units .= ' ' . $this->lng->txt('expected_result_type') . ': ' . $this->lng->txt('result_co_frac');
413 break;
415 break;
416 }
417 $checkSign = "";
418 if ($graphicalOutput) {
419 $resunit = null;
420 $user_value = '';
424 }
425
428 }
429 }
430
431 $template = new ilTemplate("tpl.il_as_qpl_formulaquestion_output_solution_image.html", true, true, 'Modules/TestQuestionPool');
432
433 if ($resObj->isCorrect($this->getVariables(), $this->getResults(), $user_value, $resunit)) {
434 $template->setCurrentBlock("icon_ok");
436 $template->setVariable("TEXT_OK", $this->lng->txt("answer_is_right"));
437 $template->parseCurrentBlock();
438 } else {
439 $template->setCurrentBlock("icon_not_ok");
441 $template->setVariable("TEXT_NOT_OK", $this->lng->txt("answer_is_wrong"));
442 $template->parseCurrentBlock();
443 }
444 $checkSign = $template->get();
445 }
446 $resultOutput = "";
447 if ($result_output) {
448 $template = new ilTemplate("tpl.il_as_qpl_formulaquestion_output_solution_result.html", true, true, 'Modules/TestQuestionPool');
449
450 if (is_array($userdata)) {
451 $found = $resObj->getResultInfo($this->getVariables(), $this->getResults(), $userdata[$resObj->getResult()]["value"], $userdata[$resObj->getResult()]["unit"], $this->getUnitrepository()->getUnits());
452 } else {
453 $found = $resObj->getResultInfo($this->getVariables(), $this->getResults(), $resObj->calculateFormula($this->getVariables(), $this->getResults(), parent::getId()), is_object($resObj->getUnit()) ? $resObj->getUnit()->getId() : null, $this->getUnitrepository()->getUnits());
454 }
455 $resulttext = "(";
456 if ($resObj->getRatingSimple()) {
457 if ($frac_helper) {
458 $resulttext .= "n/a";
459 } else {
460 $resulttext .= $found['points'] . " " . (($found['points'] == 1) ? $this->lng->txt('point') : $this->lng->txt('points'));
461 }
462 } else {
463 $resulttext .= $this->lng->txt("rated_sign") . " " . (($found['sign']) ? $found['sign'] : 0) . " " . (($found['sign'] == 1) ? $this->lng->txt('point') : $this->lng->txt('points')) . ", ";
464 $resulttext .= $this->lng->txt("rated_value") . " " . (($found['value']) ? $found['value'] : 0) . " " . (($found['value'] == 1) ? $this->lng->txt('point') : $this->lng->txt('points')) . ", ";
465 $resulttext .= $this->lng->txt("rated_unit") . " " . (($found['unit']) ? $found['unit'] : 0) . " " . (($found['unit'] == 1) ? $this->lng->txt('point') : $this->lng->txt('points'));
466 }
467
468 $resulttext .= ")";
469 $template->setVariable("RESULT_OUTPUT", $resulttext);
470
471 $resultOutput = $template->get();
472 }
473 $text = preg_replace("/\\\$" . substr($result, 1) . "(?![0-9]+)/", $input . " " . $units . " " . $checkSign . " " . $resultOutput . " " . "\\1", $text);
474 }
475 }
476 return $text;
477 }
const RESULT_NO_SELECTION
Definition: class.assFormulaQuestionResult.php:12
const RESULT_DEC
Definition: class.assFormulaQuestionResult.php:13
purifyAndPrepareTextAreaOutput(string $content)
Definition: class.assQuestion.php:3814
special template class to simplify handling of ITX/PEAR
Definition: class.ilTemplate.php:14
static getImagePath($img, $module_path="", $mode="output", $offline=false)
get image path (for images located in a template directory)
Definition: class.ilUtil.php:96
static prepareFormOutput($a_str, $a_strip=false)
prepares string output for html forms @access public
Definition: class.ilUtil.php:2820
References $result, assFormulaQuestionResult\convertDecimalToCoprimeFraction(), fetchAllVariables(), ilUtil\getImagePath(), assQuestion\getQuestion(), getResult(), getResults(), getResultUnits(), getUnitrepository(), getVariables(), ilUtil\prepareFormOutput(), assQuestion\purifyAndPrepareTextAreaOutput(), assFormulaQuestionResult\RESULT_CO_FRAC, assFormulaQuestionResult\RESULT_DEC, assFormulaQuestionResult\RESULT_FRAC, and assFormulaQuestionResult\RESULT_NO_SELECTION.
Here is the call graph for this function:
◆ validateSolutionSubmit()
| assFormulaQuestion::validateSolutionSubmit | ( | ) |
Reimplemented from assQuestion.
Definition at line 1356 of file class.assFormulaQuestion.php.
1357 {
1359 if (preg_match("/^result_(\\\$r\\d+)$/", $key)) {
1362 return false;
1363 }
1364 } elseif (preg_match("/^result_(\\\$r\\d+)_unit$/", $key)) {
1365 continue;
1366 }
1367 }
1368
1369 return true;
1370 }
isValidSolutionResultValue($submittedValue)
Definition: class.assFormulaQuestion.php:913
static sendFailure($a_info="", $a_keep=false)
Send Failure Message to Screen.
Definition: class.ilUtil.php:4534
References getSolutionSubmit(), isValidSolutionResultValue(), and ilUtil\sendFailure().
Here is the call graph for this function:
Field Documentation
◆ $results
|
private |
Definition at line 22 of file class.assFormulaQuestion.php.
Referenced by getResults().
◆ $resultunits
|
private |
Definition at line 23 of file class.assFormulaQuestion.php.
Referenced by __get().
◆ $unitrepository
|
private |
Definition at line 28 of file class.assFormulaQuestion.php.
Referenced by getUnitrepository(), and setUnitrepository().
◆ $variables
|
private |
Definition at line 21 of file class.assFormulaQuestion.php.
Referenced by getVariables().
The documentation for this class was generated from the following file:
- Modules/TestQuestionPool/classes/class.assFormulaQuestion.php
