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 | |||||||||||||
| __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... | |||||||||||||
| 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... | |||||||||||||
| 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 | |||||||||||||
| 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) | |
| 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_DEFAULT = 'default' |
| constant for additional content editing mode "default" More... | |
| const | ADDITIONAL_CONTENT_EDITING_MODE_PAGE_OBJECT = 'pageobject' |
| constant for additional content editing mode "pageobject" More... | |
| $feedbackOBJ = null | |
| $prevent_rte_usage = false | |
| $selfassessmenteditingmode = false | |
| $defaultnroftries = 0 | |
| $questionActionCmd = 'handleQuestionAction' | |
| 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 | |
| $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()
Reimplemented from 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 1310 of file class.assFormulaQuestion.php.
1311 {
1312 switch ($value) {
1313 case "resultunits":
1315 break;
1316 default:
1317 return parent::__get($value);
1318 break;
1319 }
1320 }
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:1333
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 854 of file class.assFormulaQuestion.php.
855 {
858 }
860 $user_solution = array();
861 foreach ($solutions as $idx => $solution_value) {
862 if (preg_match("/^(\\\$v\\d+)$/", $solution_value["value1"], $matches)) {
863 $user_solution[$matches[1]] = $solution_value["value2"];
865 $varObj->setValue($solution_value["value2"]);
866 } elseif (preg_match("/^(\\\$r\\d+)$/", $solution_value["value1"], $matches)) {
867 if (!array_key_exists($matches[1], $user_solution)) {
868 $user_solution[$matches[1]] = array();
869 }
870 $user_solution[$matches[1]]["value"] = $solution_value["value2"];
871 } elseif (preg_match("/^(\\\$r\\d+)_unit$/", $solution_value["value1"], $matches)) {
872 if (!array_key_exists($matches[1], $user_solution)) {
873 $user_solution[$matches[1]] = array();
874 }
875 $user_solution[$matches[1]]["unit"] = $solution_value["value2"];
876 }
877 }
878 //vd($this->getResults());
879 $points = 0;
881 //vd($user_solution[$result->getResult()]["value"]);
882 $points += $result->getReachedPoints($this->getVariables(), $this->getResults(), $user_solution[$result->getResult()]["value"], $user_solution[$result->getResult()]["unit"], $this->unitrepository->getUnits());
883 }
884
886 }
getSolutionValues($active_id, $pass=null, $authorized=true)
Loads solutions of a given user from the database an returns it.
Definition: class.assQuestion.php:1776
getSolutionMaxPass($active_id)
Returns the maximum pass a users question solution.
Definition: class.assQuestion.php:3326
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 888 of file class.assFormulaQuestion.php.
889 {
890 $user_solution = $previewSession->getParticipantsSolution();
891
892 $points = 0;
895 $u = isset($user_solution[$result->getResult() . '_unit']) ? $user_solution[$result->getResult() . '_unit'] : null;
896
898 $this->getVariables(),
899 $this->getResults(),
900 $v,
901 $u,
902 $this->unitrepository->getUnits()
903 );
904 }
905
907
909 }
deductHintPointsFromReachedPoints(ilAssQuestionPreviewSession $previewSession, $reachedPoints)
Definition: class.assQuestion.php:3429
ensureNonNegativePoints($points)
Definition: class.assQuestion.php:3448
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 483 of file class.assFormulaQuestion.php.
484 {
486 $resultunit = $result->getUnit();
487 $similar_units = 0;
488 foreach ($result_units as $unit) {
489 if (is_object($resultunit)) {
490 if ($resultunit->getId() != $unit->getId()) {
491 if ($resultunit->getBaseUnit() && $unit->getBaseUnit()) {
492 if ($resultunit->getBaseUnit() == $unit->getBaseUnit()) {
493 return false;
494 }
495 }
496 if ($resultunit->getBaseUnit()) {
497 if ($resultunit->getBaseUnit() == $unit->getId()) {
498 return false;
499 }
500 }
501 if ($unit->getBaseUnit()) {
502 if ($unit->getBaseUnit() == $resultunit->getId()) {
503 return false;
504 }
505 }
506 }
507 }
508 }
509 return true;
510 }
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 770 of file class.assFormulaQuestion.php.
771 {
772 if ($this->id <= 0) {
773 // The question has not been saved. It cannot be duplicated
774 return;
775 }
776 // duplicate the question in database
777 $clone = $this;
778 include_once("./Modules/TestQuestionPool/classes/class.assQuestion.php");
780 $clone->id = -1;
781 $source_questionpool_id = $this->getObjId();
782 $clone->setObjId($target_questionpool_id);
784 $clone->setTitle($title);
785 }
786 $clone->saveToDb();
787
788 $clone->unitrepository->cloneUnits($original_id, $clone->getId());
789
790 // copy question page content
791 $clone->copyPageOfQuestion($original_id);
792 // copy XHTML media objects
793 $clone->copyXHTMLMediaObjectsOfQuestion($original_id);
794
795 $clone->onCopy($source_questionpool_id, $original_id, $clone->getObjId(), $clone->getId());
796
797 return $clone->id;
798 }
static _getOriginalId($question_id)
Returns the original id of a question.
Definition: class.assQuestion.php:3115
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 800 of file class.assFormulaQuestion.php.
801 {
802 if ($this->id <= 0) {
803 // The question has not been saved. It cannot be duplicated
804 return;
805 }
806
807 include_once("./Modules/TestQuestionPool/classes/class.assQuestion.php");
808
809 $sourceQuestionId = $this->id;
810 $sourceParentId = $this->getObjId();
811
812 // duplicate the question in database
813 $clone = $this;
814 $clone->id = -1;
815
816 $clone->setObjId($targetParentId);
817
818 if ($targetQuestionTitle) {
819 $clone->setTitle($targetQuestionTitle);
820 }
821
822 $clone->saveToDb();
823 // copy question page content
824 $clone->copyPageOfQuestion($sourceQuestionId);
825 // copy XHTML media objects
826 $clone->copyXHTMLMediaObjectsOfQuestion($sourceQuestionId);
827
828 $clone->onCopy($sourceParentId, $sourceQuestionId, $clone->getObjId(), $clone->getId());
829
830 return $clone->id;
831 }
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 1144 of file class.assFormulaQuestion.php.
1145 {
1146 global $DIC;
1148
1149 $affectedRows = $ilDB->manipulateF(
1150 "DELETE FROM il_qpl_qst_fq_var WHERE question_fi = %s",
1151 array('integer'),
1152 array($question_id)
1153 );
1154
1155 $affectedRows = $ilDB->manipulateF(
1156 "DELETE FROM il_qpl_qst_fq_res WHERE question_fi = %s",
1157 array('integer'),
1158 array($question_id)
1159 );
1160
1161 $affectedRows = $ilDB->manipulateF(
1162 "DELETE FROM il_qpl_qst_fq_res_unit WHERE question_fi = %s",
1163 array('integer'),
1164 array($question_id)
1165 );
1166
1167 $affectedRows = $ilDB->manipulateF(
1168 "DELETE FROM il_qpl_qst_fq_ucat WHERE question_fi = %s",
1169 array('integer'),
1170 array($question_id)
1171 );
1172
1173 $affectedRows = $ilDB->manipulateF(
1174 "DELETE FROM il_qpl_qst_fq_unit WHERE question_fi = %s",
1175 array('integer'),
1176 array($question_id)
1177 );
1178 }
◆ duplicate()
| assFormulaQuestion::duplicate | ( | $for_test = true, |
|
$title = "", |
|||
$author = "", |
|||
$owner = "", |
|||
$testObjId = null |
|||
| ) |
Duplicates an assFormulaQuestion @access public.
Reimplemented from assQuestion.
Definition at line 719 of file class.assFormulaQuestion.php.
720 {
721 if ($this->id <= 0) {
722 // The question has not been saved. It cannot be duplicated
723 return;
724 }
725 // duplicate the question in database
726 $this_id = $this->getId();
727 $thisObjId = $this->getObjId();
728
729 $clone = $this;
730 include_once("./Modules/TestQuestionPool/classes/class.assQuestion.php");
732 $clone->id = -1;
733
734 if ((int) $testObjId > 0) {
735 $clone->setObjId($testObjId);
736 }
737
739 $clone->setTitle($title);
740 }
741
743 $clone->setAuthor($author);
744 }
746 $clone->setOwner($owner);
747 }
748
749 if ($for_test) {
750 $clone->saveToDb($original_id);
751 } else {
752 $clone->saveToDb();
753 }
754
755 $clone->unitrepository->cloneUnits($this_id, $clone->getId());
756
757 // copy question page content
758 $clone->copyPageOfQuestion($this_id);
759 // copy XHTML media objects
760 $clone->copyXHTMLMediaObjectsOfQuestion($this_id);
761 $clone->onDuplicate($thisObjId, $this_id, $clone->getObjId(), $clone->getId());
762
763 return $clone->id;
764 }
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 1125 of file class.assFormulaQuestion.php.
1126 {
1127 return "";
1128 }
◆ 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 1134 of file class.assFormulaQuestion.php.
1135 {
1136 return "";
1137 }
◆ 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 1450 of file class.assFormulaQuestion.php.
1451 {
1454 } else {
1456 }
1457 }
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 1228 of file class.assFormulaQuestion.php.
1229 {
1230 $user_solution = array();
1231
1232 foreach ($solutions as $idx => $solution_value) {
1233 if (preg_match("/^(\\\$v\\d+)$/", $solution_value["value1"], $matches)) {
1234 $user_solution[$matches[1]] = $solution_value["value2"];
1235 $varObj = $this->getVariable($matches[1]);
1236 $varObj->setValue($solution_value["value2"]);
1237 } elseif (preg_match("/^(\\\$r\\d+)$/", $solution_value["value1"], $matches)) {
1238 if (!array_key_exists($matches[1], $user_solution)) {
1239 $user_solution[$matches[1]] = array();
1240 }
1241 $user_solution[$matches[1]]["value"] = $solution_value["value2"];
1242 } elseif (preg_match("/^(\\\$r\\d+)_unit$/", $solution_value["value1"], $matches)) {
1243 if (!array_key_exists($matches[1], $user_solution)) {
1244 $user_solution[$matches[1]] = array();
1245 }
1246 $user_solution[$matches[1]]["unit"] = $solution_value["value2"];
1247 }
1248 }
1250 $resVal = $result->calculateFormula($this->getVariables(), $this->getResults(), parent::getId(), false);
1251
1256 $unit_factor = 1;
1257 // there is no fix result_unit, any "available unit" is accepted
1258
1259 $available_units = $result->getAvailableResultUnits(parent::getId());
1260 $result_name = $result->getResult();
1261
1262 if ($available_units[$result_name] != null) {
1263 $check_unit = in_array($user_solution[$result_name]['unit'], $available_units[$result_name]);
1264 }
1265
1266 if ($check_unit == true) {
1267 //get unit-factor
1269 }
1270
1271 try {
1275 }
1276 }
1279 $value = assFormulaQuestionResult::convertDecimalToCoprimeFraction($resVal);
1280 if (is_array($value)) {
1283 } else {
1286 }
1287 } else {
1288 $user_solution[$result->getResult()]["value"] = round($user_solution[$result->getResult()]["value"], $result->getPrecision());
1289 /*
1290 $user_solution[$result->getResult()]["value"] = ilMath::_div(
1291 $user_solution[$result->getResult()]["value"],
1292 1,
1293 $result->getPrecision()
1294 );
1295 */
1296 }
1297 }
1298 return $user_solution;
1299 }
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:830
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 1388 of file class.assFormulaQuestion.php.
1389 {
1390 return array(
1394 );
1395 }
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 837 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 1378 of file class.assFormulaQuestion.php.
1379 {
1380 require_once "./Modules/TestQuestionPool/classes/class.ilOperatorsExpressionMapping.php";
1382 }
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 1116 of file class.assFormulaQuestion.php.
1117 {
1118 return "assFormulaQuestion";
1119 }
◆ 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 1184 of file class.assFormulaQuestion.php.
1185 {
1186 $text = parent::getRTETextWithMediaObjects();
1187 return $text;
1188 }
◆ getSolutionSubmit()
|
protected |
- Returns
- array
Definition at line 1341 of file class.assFormulaQuestion.php.
1342 {
1343 $solutionSubmit = array();
1345 if (preg_match("/^result_(\\\$r\\d+)$/", $k)) {
1346 $solutionSubmit[$k] = $v;
1347 } elseif (preg_match("/^result_(\\\$r\\d+)_unit$/", $k)) {
1348 $solutionSubmit[$k] = $v;
1349 }
1350 }
1351 return $solutionSubmit;
1352 }
References $_POST.
Referenced by savePreviewData(), saveWorkingData(), and validateSolutionSubmit().
Here is the caller graph for this function:
◆ getUnitrepository()
| assFormulaQuestion::getUnitrepository | ( | ) |
- Returns
- \ilUnitConfigurationRepository
Definition at line 1333 of file class.assFormulaQuestion.php.
1334 {
1336 }
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 516 of file class.assFormulaQuestion.php.
517 {
518 if (($this->title) and ($this->author) and ($this->question) and ($this->getMaximumPoints() > 0)) {
519 return true;
520 } else {
521 return false;
522 }
523 }
getMaximumPoints()
Returns the maximum points, a learner can reach answering the question.
Definition: class.assFormulaQuestion.php:837
References getMaximumPoints().
Here is the call graph for this function:
◆ isValidSolutionResultValue()
|
protected |
Definition at line 911 of file class.assFormulaQuestion.php.
912 {
913 $submittedValue = str_replace(',', '.', $submittedValue);
914
915 if (is_numeric($submittedValue)) {
916 return true;
917 }
918
919 if (preg_match('/^[-+]{0,1}\d+\/\d+$/', $submittedValue)) {
920 return true;
921 }
922
923 return false;
924 }
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 629 of file class.assFormulaQuestion.php.
630 {
631 global $DIC;
633
635 "SELECT qpl_questions.* FROM qpl_questions WHERE question_id = %s",
636 array('integer'),
637 array($question_id)
638 );
641 $this->setId($question_id);
650
651 try {
655 }
656
657 try {
660 }
661
663
664 include_once("./Services/RTE/classes/class.ilRTE.php");
666 $this->setEstimatedWorkingTime(substr($data["working_time"], 0, 2), substr($data["working_time"], 3, 2), substr($data["working_time"], 6, 2));
667
668 // load variables
670 "SELECT * FROM il_qpl_qst_fq_var WHERE question_fi = %s",
671 array('integer'),
672 array($question_id)
673 );
676 $varObj = new assFormulaQuestionVariable($data["variable"], $data["range_min"], $data["range_max"], $this->getUnitrepository()->getUnit($data["unit_fi"]), $data["varprecision"], $data["intprecision"]);
679 $this->addVariable($varObj);
680 }
681 }
682 // load results
684 "SELECT * FROM il_qpl_qst_fq_res WHERE question_fi = %s",
685 array('integer'),
686 array($question_id)
687 );
690 $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"]);
694 $this->addResult($resObj);
695 }
696 }
697
698 // load result units
700 "SELECT * FROM il_qpl_qst_fq_res_unit WHERE question_fi = %s",
701 array('integer'),
702 array($question_id)
703 );
708 $this->addResultUnit($resObj, $unit);
709 }
710 }
711 }
712 parent::loadFromDb($question_id);
713 }
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:2808
setTitle($title="")
Sets the title string of the assQuestion object.
Definition: class.assQuestion.php:604
setOwner($owner="")
Sets the creator/owner ID of the assQuestion object.
Definition: class.assQuestion.php:745
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:684
setAuthor($author="")
Sets the authors name of the assQuestion object.
Definition: class.assQuestion.php:730
setLifecycle(ilAssQuestionLifecycle $lifecycle)
Definition: class.assQuestion.php:928
setPoints($a_points)
Sets the maximum available points for the question.
Definition: class.assQuestion.php:3315
setComment($comment="")
Sets the comment string of the assQuestion object.
Definition: class.assQuestion.php:640
setAdditionalContentEditingMode($additinalContentEditingMode)
setter for additional content editing mode for this question
Definition: class.assQuestion.php:4594
setQuestion($question="")
Sets the question string of the question object.
Definition: class.assQuestion.php:3754
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 1025 of file class.assFormulaQuestion.php.
1026 {
1027 global $DIC;
1029
1030 $return = array(
1031 'authorized' => false,
1032 'intermediate' => false
1033 );
1034
1036 SELECT authorized, COUNT(*) cnt
1037 FROM tst_solutions
1041 AND value1 like '\$r%'
1042 AND value2 is not null
1043 AND value2 <> ''
1044 ";
1045
1048 }
1049
1051 GROUP BY authorized
1052 ";
1053
1055
1057 if ($row['authorized']) {
1058 $return['authorized'] = $row['cnt'] > 0;
1059 } else {
1060 $return['intermediate'] = $row['cnt'] > 0;
1061 }
1062 }
1063 return $return;
1064 }
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 1074 of file class.assFormulaQuestion.php.
1075 {
1076 global $DIC;
1078
1080 DELETE FROM tst_solutions
1084 AND value1 like '\$r%'
1085 ";
1086
1089 }
1090
1092 }
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 1095 of file class.assFormulaQuestion.php.
1096 {
1097 $userSolution = $previewSession->getParticipantsSolution();
1098
1100 $matches = null;
1101
1102 if (preg_match("/^result_(\\\$r\\d+)$/", $key, $matches)) {
1103 $userSolution[$matches[1]] = $val;
1104 } elseif (preg_match("/^result_(\\\$r\\d+)_unit$/", $key, $matches)) {
1105 $userSolution[$matches[1] . "_unit"] = $val;
1106 }
1107 }
1108
1109 $previewSession->setParticipantsSolution($userSolution);
1110 }
getSolutionSubmit()
Definition: class.assFormulaQuestion.php:1341
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 529 of file class.assFormulaQuestion.php.
530 {
531 global $DIC;
533
535 // save variables
536 $affectedRows = $ilDB->manipulateF(
537 "
538 DELETE FROM il_qpl_qst_fq_var
539 WHERE question_fi = %s",
540 array("integer"),
541 array($this->getId())
542 );
543
544 foreach ($this->variables as $variable) {
546 $ilDB->insert(
547 'il_qpl_qst_fq_var',
548 array(
549 'variable_id' => array('integer', $next_id),
551 'variable' => array('text', $variable->getVariable()),
552 'range_min' => array('float', ((strlen($variable->getRangeMin())) ? $variable->getRangeMin() : 0.0)),
553 'range_max' => array('float', ((strlen($variable->getRangeMax())) ? $variable->getRangeMax() : 0.0)),
554 'unit_fi' => array('integer', (is_object($variable->getUnit()) ? (int) $variable->getUnit()->getId() : 0)),
555 'varprecision' => array('integer', (int) $variable->getPrecision()),
556 'intprecision' => array('integer', (int) $variable->getIntprecision()),
557 'range_min_txt' => array('text', $variable->getRangeMinTxt()),
558 'range_max_txt' => array('text', $variable->getRangeMaxTxt())
559 )
560 );
561 }
562 // save results
563 $affectedRows = $ilDB->manipulateF(
564 "DELETE FROM il_qpl_qst_fq_res WHERE question_fi = %s",
565 array("integer"),
566 array($this->getId())
567 );
568
572 $tmp_result_unit = $result->getUnit()->getId();
573 } else {
574 $tmp_result_unit = null;
575 }
576
578
580 "result_id" => array("integer", $next_id),
585 "tolerance" => array("float", ((strlen($result->getTolerance())) ? $result->getTolerance() : 0)),
586 "unit_fi" => array("integer", (int) $tmp_result_unit),
587 "formula" => array("clob", $formula),
597
598 ));
599 }
600 // save result units
601 $affectedRows = $ilDB->manipulateF(
602 "DELETE FROM il_qpl_qst_fq_res_unit WHERE question_fi = %s",
603 array("integer"),
604 array($this->getId())
605 );
609 $affectedRows = $ilDB->manipulateF(
610 "INSERT INTO il_qpl_qst_fq_res_unit (result_unit_id, question_fi, result, unit_fi) VALUES (%s, %s, %s, %s)",
611 array('integer', 'integer', 'text', 'integer'),
612 array(
613 $next_id,
614 $this->getId(),
615 $result->getResult(),
616 $unit->getId()
617 )
618 );
619 }
620 }
621
622 parent::saveToDb();
623 }
saveQuestionDataToDb($original_id="")
Definition: class.assQuestion.php:2580
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 933 of file class.assFormulaQuestion.php.
934 {
935 global $DIC;
937
939 include_once "./Modules/Test/classes/class.ilObjTest.php";
941 }
942
943 $entered_values = false;
944
945 $this->getProcessLocker()->executeUserSolutionUpdateLockOperation(function () use (&$entered_values, $ilDB, $active_id, $pass, $authorized) {
946 $solutionSubmit = $this->getSolutionSubmit();
947 foreach ($solutionSubmit as $key => $value) {
948 $matches = null;
949 if (preg_match("/^result_(\\\$r\\d+)$/", $key, $matches)) {
950 if (strlen($value)) {
951 $entered_values = true;
952 }
953
954 $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]);
955
958 }
959
961 $queryResult,
962 array('integer', 'integer', 'integer', 'integer'),
964 );
967 $ilDB->manipulateF(
968 "DELETE FROM tst_solutions WHERE solution_id = %s AND authorized = %s",
969 array('integer', 'integer'),
970 array($row['solution_id'], (int) $authorized)
971 );
972 }
973 }
974
975 $this->saveCurrentSolution($active_id, $pass, $matches[1], str_replace(",", ".", $value), $authorized);
976 } elseif (preg_match("/^result_(\\\$r\\d+)_unit$/", $key, $matches)) {
977 $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");
978
981 }
982
984 $queryResultUnit,
985 array('integer', 'integer', 'integer', 'integer'),
987 );
990 $ilDB->manipulateF(
991 "DELETE FROM tst_solutions WHERE solution_id = %s AND authorized = %s",
992 array('integer', 'integer'),
993 array($row['solution_id'], (int) $authorized)
994 );
995 }
996 }
997
999 }
1000 }
1001 });
1002
1003 if ($entered_values) {
1004 include_once("./Modules/Test/classes/class.ilObjAssessmentFolder.php");
1006 assQuestion::logAction($this->lng->txtlng("assessment", "log_user_entered_values", ilObjAssessmentFolder::_getLogLanguage()), $active_id, $this->getId());
1007 }
1008 } else {
1009 include_once("./Modules/Test/classes/class.ilObjAssessmentFolder.php");
1011 assQuestion::logAction($this->lng->txtlng("assessment", "log_user_not_entered_values", ilObjAssessmentFolder::_getLogLanguage()), $active_id, $this->getId());
1012 }
1013 }
1014
1015 return true;
1016 }
saveCurrentSolution($active_id, $pass, $value1, $value2, $authorized=true, $tstamp=null)
Definition: class.assQuestion.php:4881
static logAction($logtext="", $active_id="", $question_id="")
Logs an action into the Test&Assessment log.
Definition: class.assQuestion.php:1594
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:8110
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 1193 of file class.assFormulaQuestion.php.
1194 {
1195 parent::setExportDetailsXLS($worksheet, $startrow, $active_id, $pass);
1196
1198
1199 $i = 1;
1200 foreach ($solution as $solutionvalue) {
1202 $worksheet->setBold($worksheet->getColumnCoord(0) . ($startrow + $i));
1203 if (strpos($solutionvalue["value1"], "_unit")) {
1205 if (is_object($unit)) {
1206 $worksheet->setCell($startrow + $i, 1, $unit->getUnit());
1207 }
1208 } else {
1210 }
1211 if (preg_match("/(\\\$v\\d+)/", $solutionvalue["value1"], $matches)) {
1213 if (is_object($var) && (is_object($var->getUnit()))) {
1214 $worksheet->setCell($startrow + $i, 2, $var->getUnit()->getUnit());
1215 }
1216 }
1217 $i++;
1218 }
1219
1221 }
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 1301 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 1325 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
285 $resObj = $this->getResult($result);
286 $value = "";
287 $frac_helper = '';
289
290 if (
291 $resObj->getResultType() == assFormulaQuestionResult::RESULT_FRAC ||
292 $resObj->getResultType() == assFormulaQuestionResult::RESULT_CO_FRAC
293 ) {
294 $is_frac = true;
295 }
296 if (is_array($userdata)) {
298 if (false && $forsolution && $result_output) { // fix for mantis #25956
299 $value_org = $resObj->calculateFormula($this->getVariables(), $this->getResults(), parent::getId());
300 $value = sprintf("%." . $resObj->getPrecision() . "f", $value_org);
301 if ($is_frac) {
302 $value = assFormulaQuestionResult::convertDecimalToCoprimeFraction($value_org);
303 if (is_array($value)) {
304 $frac_helper = $value[1];
305 $value = $value[0];
306 }
307 }
308 } else {
309 if ($forsolution) {
311 } else {
313 }
314 }
315 }
316 } else {
317 if ($forsolution) {
318 $value = $resObj->calculateFormula($this->getVariables(), $this->getResults(), parent::getId());
319 $value = sprintf("%." . $resObj->getPrecision() . "f", $value);
320
321 if ($is_frac) {
322 $value = assFormulaQuestionResult::convertDecimalToCoprimeFraction($value);
323 if (is_array($value)) {
324 $frac_helper = $value[1];
325 $value = $value[0];
326 }
327 $value = ' value="' . $value . '"';
328 }
329 } else {
330 // Precision fix for Preview by tjoussen
331 // If all default values are set, this function is called in getPreview
332 $use_precision = !($userdata == null && $graphicalOutput == false && $forsolution == false && $result_output == false);
333
334 $val = $resObj->calculateFormula($this->getVariables(), $this->getResults(), parent::getId(), $use_precision);
335
337 || $resObj->getResultType() == assFormulaQuestionResult::RESULT_CO_FRAC) {
338 $val = $resObj->convertDecimalToCoprimeFraction($val);
339 if (is_array($val)) {
340 $frac_helper = $val[1];
341 $val = $val[0];
342 }
343 } else {
344 $val = sprintf("%." . $resObj->getPrecision() . "f", $val);
345 $val = (strlen($val) > 8) ? strtoupper(sprintf("%e", $val)) : $val;
346 }
347 $value = ' value="' . $val . '"';
348 }
349 }
350
351 if ($forsolution) {
352 $input = '<span class="ilc_qinput_TextInput solutionbox">' . ilUtil::prepareFormOutput($value) . '</span>';
353 } else {
354 $input = '<input class="ilc_qinput_TextInput" type="text" spellcheck="false" autocomplete="off" autocorrect="off" autocapitalize="off" name="result_' . $result . '"' . $value . ' />';
355 }
356
357 $units = "";
359 if ($forsolution) {
360 if (is_array($userdata)) {
363 $units = $unit->getUnit();
364 }
365 }
366 } else {
367 if ($resObj->getUnit()) {
368 $units = $resObj->getUnit()->getUnit();
369 }
370 }
371 } else {
373 $units .= '<option value="-1">' . $this->lng->txt("select_unit") . '</option>';
375 $units .= '<option value="' . $unit->getId() . '"';
378 $units .= ' selected="selected"';
379 }
380 }
381 $units .= '>' . $unit->getUnit() . '</option>';
382 }
383 $units .= '</select>';
384 }
385 } else {
386 $units = "";
387 }
388 switch ($resObj->getResultType()) {
390 $units .= ' ' . $this->lng->txt('expected_result_type') . ': ' . $this->lng->txt('result_dec');
391 break;
393 if (strlen($frac_helper)) {
394 $units .= ' ≈ ' . $frac_helper . ', ';
395 } elseif (is_array($userdata) && isset($userdata[$result]) && strlen($userdata[$result]["frac_helper"])) {
396 if (!preg_match('-/-', $value)) {
398 }
399 }
400 $units .= ' ' . $this->lng->txt('expected_result_type') . ': ' . $this->lng->txt('result_frac');
401 break;
403 if (strlen($frac_helper)) {
404 $units .= ' ≈ ' . $frac_helper . ', ';
405 } elseif (is_array($userdata) && isset($userdata[$result]) && strlen($userdata[$result]["frac_helper"])) {
406 if (!preg_match('-/-', $value)) {
408 }
409 }
410 $units .= ' ' . $this->lng->txt('expected_result_type') . ': ' . $this->lng->txt('result_co_frac');
411 break;
413 break;
414 }
415 $checkSign = "";
416 if ($graphicalOutput) {
417 $resunit = null;
418 $user_value = '';
422 }
423
426 }
427 }
428
429 $template = new ilTemplate("tpl.il_as_qpl_formulaquestion_output_solution_image.html", true, true, 'Modules/TestQuestionPool');
430
431 if ($resObj->isCorrect($this->getVariables(), $this->getResults(), $user_value, $resunit)) {
432 $template->setCurrentBlock("icon_ok");
434 $template->setVariable("TEXT_OK", $this->lng->txt("answer_is_right"));
435 $template->parseCurrentBlock();
436 } else {
437 $template->setCurrentBlock("icon_not_ok");
439 $template->setVariable("TEXT_NOT_OK", $this->lng->txt("answer_is_wrong"));
440 $template->parseCurrentBlock();
441 }
442 $checkSign = $template->get();
443 }
444 $resultOutput = "";
445 if ($result_output) {
446 $template = new ilTemplate("tpl.il_as_qpl_formulaquestion_output_solution_result.html", true, true, 'Modules/TestQuestionPool');
447
448 if (is_array($userdata)) {
449 $found = $resObj->getResultInfo($this->getVariables(), $this->getResults(), $userdata[$resObj->getResult()]["value"], $userdata[$resObj->getResult()]["unit"], $this->getUnitrepository()->getUnits());
450 } else {
451 $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());
452 }
453 $resulttext = "(";
454 if ($resObj->getRatingSimple()) {
455 if ($frac_helper) {
456 $resulttext .= "n/a";
457 } else {
458 $resulttext .= $found['points'] . " " . (($found['points'] == 1) ? $this->lng->txt('point') : $this->lng->txt('points'));
459 }
460 } else {
461 $resulttext .= $this->lng->txt("rated_sign") . " " . (($found['sign']) ? $found['sign'] : 0) . " " . (($found['sign'] == 1) ? $this->lng->txt('point') : $this->lng->txt('points')) . ", ";
462 $resulttext .= $this->lng->txt("rated_value") . " " . (($found['value']) ? $found['value'] : 0) . " " . (($found['value'] == 1) ? $this->lng->txt('point') : $this->lng->txt('points')) . ", ";
463 $resulttext .= $this->lng->txt("rated_unit") . " " . (($found['unit']) ? $found['unit'] : 0) . " " . (($found['unit'] == 1) ? $this->lng->txt('point') : $this->lng->txt('points'));
464 }
465
466 $resulttext .= ")";
467 $template->setVariable("RESULT_OUTPUT", $resulttext);
468
469 $resultOutput = $template->get();
470 }
471 $text = preg_replace("/\\\$" . substr($result, 1) . "(?![0-9]+)/", $input . " " . $units . " " . $checkSign . " " . $resultOutput . " " . "\\1", $text);
472 }
473 }
474 return $text;
475 }
const RESULT_NO_SELECTION
Definition: class.assFormulaQuestionResult.php:12
const RESULT_DEC
Definition: class.assFormulaQuestionResult.php:13
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:80
static prepareFormOutput($a_str, $a_strip=false)
prepares string output for html forms @access public
Definition: class.ilUtil.php:2822
References $result, assFormulaQuestionResult\convertDecimalToCoprimeFraction(), fetchAllVariables(), ilUtil\getImagePath(), assQuestion\getQuestion(), getResult(), getResults(), getResultUnits(), getUnitrepository(), getVariables(), ilUtil\prepareFormOutput(), 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 1354 of file class.assFormulaQuestion.php.
1355 {
1357 if (preg_match("/^result_(\\\$r\\d+)$/", $key)) {
1360 return false;
1361 }
1362 } elseif (preg_match("/^result_(\\\$r\\d+)_unit$/", $key)) {
1363 continue;
1364 }
1365 }
1366
1367 return true;
1368 }
isValidSolutionResultValue($submittedValue)
Definition: class.assFormulaQuestion.php:911
static sendFailure($a_info="", $a_keep=false)
Send Failure Message to Screen.
Definition: class.ilUtil.php:4519
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
