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... | |||||||||||||
| setExternalId ($external_id) | |||||||||||||
| getExternalId () | |||||||||||||
| getSuggestedSolutionOutput () | |||||||||||||
| & | _getSuggestedSolution ($question_id, $subquestion_index=0) | ||||||||||||
| Returns a suggested solution for a given subquestion index. More... | |||||||||||||
| getSuggestedSolutions () | |||||||||||||
| Return the suggested solutions. More... | |||||||||||||
| getReachedPoints ($active_id, $pass=null) | |||||||||||||
| Returns the points, a learner has reached answering the question This is the fast way to get the points directly from the database. More... | |||||||||||||
| getMaximumPoints () | |||||||||||||
| Returns the maximum points, a learner can reach answering the question. More... | |||||||||||||
| getAdjustedReachedPoints ($active_id, $pass=null, $authorizedSolution=true) | |||||||||||||
| returns the reached points ... More... | |||||||||||||
| calculateResultsFromSolution ($active_id, $pass=null, $obligationsEnabled=false) | |||||||||||||
| Calculates the question results from a previously saved question solution. More... | |||||||||||||
| persistWorkingState ($active_id, $pass=null, $obligationsEnabled=false, $authorized=true) | |||||||||||||
| persists the working state for current testactive and testpass More... | |||||||||||||
| persistPreviewState (ilAssQuestionPreviewSession $previewSession) | |||||||||||||
| persists the preview state for current user and question More... | |||||||||||||
| validateSolutionSubmit () | |||||||||||||
| saveWorkingData ($active_id, $pass=null, $authorized=true) | |||||||||||||
| Saves the learners input of the question to the database. More... | |||||||||||||
| moveUploadedMediaFile ($file, $name) | |||||||||||||
| Move an uploaded media file to an public accessible temp dir to present it. More... | |||||||||||||
| getSuggestedSolutionPath () | |||||||||||||
| Returns the path for a suggested solution. More... | |||||||||||||
| getJavaPath () | |||||||||||||
| Returns the image path for web accessable images of a question. More... | |||||||||||||
| getImagePath ($question_id=null, $object_id=null) | |||||||||||||
| Returns the image path for web accessable images of a question. More... | |||||||||||||
| buildImagePath ($questionId, $parentObjectId) | |||||||||||||
| getFlashPath () | |||||||||||||
| Returns the image path for web accessable flash files of a question. More... | |||||||||||||
| getJavaPathWeb () | |||||||||||||
| Returns the web image path for web accessable java applets of a question. More... | |||||||||||||
| getSuggestedSolutionPathWeb () | |||||||||||||
| Returns the web path for a suggested solution. More... | |||||||||||||
| getImagePathWeb () | |||||||||||||
| Returns the web image path for web accessable images of a question. More... | |||||||||||||
| getFlashPathWeb () | |||||||||||||
| Returns the web image path for web accessable flash applications of a question. More... | |||||||||||||
| getTestOutputSolutions ($activeId, $pass) | |||||||||||||
| getUserSolutionPreferingIntermediate ($active_id, $pass=null) | |||||||||||||
| getSolutionValues ($active_id, $pass=null, $authorized=true) | |||||||||||||
| Loads solutions of a given user from the database an returns it. More... | |||||||||||||
| isInUse ($question_id="") | |||||||||||||
| Checks whether the question is in use or not. More... | |||||||||||||
| isClone ($question_id="") | |||||||||||||
| Checks whether the question is a clone of another question or not. More... | |||||||||||||
| pcArrayShuffle ($array) | |||||||||||||
| Shuffles the values of a given array. More... | |||||||||||||
| getAdditionalTableName () | |||||||||||||
| Returns the name of the additional question data table in the database. More... | |||||||||||||
| getAnswerTableName () | |||||||||||||
| Returns the name of the answer table in the database. More... | |||||||||||||
| deleteAnswers ($question_id) | |||||||||||||
| Deletes datasets from answers tables. More... | |||||||||||||
| deleteAdditionalTableData ($question_id) | |||||||||||||
| Deletes datasets from the additional question table in the database. More... | |||||||||||||
| delete ($question_id) | |||||||||||||
| Deletes a question and all materials from the database. More... | |||||||||||||
| getTotalAnswers () | |||||||||||||
| get total number of answers More... | |||||||||||||
| _getTotalAnswers ($a_q_id) | |||||||||||||
| get number of answers for question id (static) note: do not use $this inside this method More... | |||||||||||||
| copyXHTMLMediaObjectsOfQuestion ($a_q_id) | |||||||||||||
| syncXHTMLMediaObjectsOfQuestion () | |||||||||||||
| createPageObject () | |||||||||||||
| create page object of question More... | |||||||||||||
| copyPageOfQuestion ($a_q_id) | |||||||||||||
| getPageOfQuestion () | |||||||||||||
| setOriginalId ($original_id) | |||||||||||||
| getOriginalId () | |||||||||||||
| fixSvgToPng ($imageFilenameContainingString) | |||||||||||||
| fixUnavailableSkinImageSources ($html) | |||||||||||||
| loadFromDb ($question_id) | |||||||||||||
| Loads the question from the database. More... | |||||||||||||
| createNewQuestion ($a_create_page=true) | |||||||||||||
| Creates a new question without an owner when a new question is created This assures that an ID is given to the question if a file upload or something else occurs. More... | |||||||||||||
| saveQuestionDataToDb ($original_id="") | |||||||||||||
| saveToDb ($original_id="") | |||||||||||||
| Saves the question to the database. More... | |||||||||||||
| setNewOriginalId ($newId) | |||||||||||||
| deleteSuggestedSolutions () | |||||||||||||
| Deletes all suggestes solutions in the database. More... | |||||||||||||
| getSuggestedSolution ($subquestion_index=0) | |||||||||||||
| Returns a suggested solution for a given subquestion index. More... | |||||||||||||
| getSuggestedSolutionTitle ($subquestion_index=0) | |||||||||||||
| Returns the title of a suggested solution at a given subquestion_index. More... | |||||||||||||
| setSuggestedSolution ($solution_id="", $subquestion_index=0, $is_import=false) | |||||||||||||
| Sets a suggested solution for the question. More... | |||||||||||||
| _resolveInternalLink ($internal_link) | |||||||||||||
| _resolveIntLinks ($question_id) | |||||||||||||
| syncWithOriginal () | |||||||||||||
| createRandomSolution ($test_id, $user_id) | |||||||||||||
| _questionExists ($question_id) | |||||||||||||
| Returns true if the question already exists in the database. More... | |||||||||||||
| _questionExistsInPool ($question_id) | |||||||||||||
| Returns true if the question already exists in the database and is assigned to a question pool. More... | |||||||||||||
| getPoints () | |||||||||||||
| Returns the maximum available points for the question. More... | |||||||||||||
| setPoints ($a_points) | |||||||||||||
| Sets the maximum available points for the question. More... | |||||||||||||
| getSolutionMaxPass ($active_id) | |||||||||||||
| Returns the maximum pass a users question solution. More... | |||||||||||||
| calculateReachedPoints ($active_id, $pass=null, $authorizedSolution=true, $returndetails=false) | |||||||||||||
| Returns the points, a learner has reached answering the question. More... | |||||||||||||
| deductHintPointsFromReachedPoints (ilAssQuestionPreviewSession $previewSession, $reachedPoints) | |||||||||||||
| calculateReachedPointsFromPreviewSession (ilAssQuestionPreviewSession $previewSession) | |||||||||||||
| isPreviewSolutionCorrect (ilAssQuestionPreviewSession $previewSession) | |||||||||||||
| adjustReachedPointsByScoringOptions ($points, $active_id, $pass=null) | |||||||||||||
| Adjust the given reached points by checks for all special scoring options in the test container. More... | |||||||||||||
| isHTML ($a_text) | |||||||||||||
| Checks if a given string contains HTML or not. More... | |||||||||||||
| prepareTextareaOutput ($txt_output, $prepare_for_latex_output=false, $omitNl2BrWhenTextArea=false) | |||||||||||||
| Prepares a string for a text area output in tests. More... | |||||||||||||
| QTIMaterialToString ($a_material) | |||||||||||||
| Reads an QTI material tag an creates a text string. More... | |||||||||||||
| addQTIMaterial (&$a_xml_writer, $a_material, $close_material_tag=true, $add_mobs=true) | |||||||||||||
| Creates a QTI material tag from a plain text or xhtml text. More... | |||||||||||||
| buildHashedImageFilename ($plain_image_filename, $unique=false) | |||||||||||||
| getQuestion () | |||||||||||||
| Gets the question string of the question object. More... | |||||||||||||
| setQuestion ($question="") | |||||||||||||
| Sets the question string of the question object. More... | |||||||||||||
| getQuestionType () | |||||||||||||
| Returns the question type of the question. More... | |||||||||||||
| getQuestionTypeID () | |||||||||||||
| Returns the question type of the question. More... | |||||||||||||
| cleanupMediaObjectUsage () | |||||||||||||
| synchronises appearances of media objects in the question with media object usage table More... | |||||||||||||
| & | getInstances () | ||||||||||||
| Gets all instances of the question. More... | |||||||||||||
| getActiveUserData ($active_id) | |||||||||||||
| Returns the user id and the test id for a given active id. More... | |||||||||||||
| setExportDetailsXLS ($worksheet, $startrow, $active_id, $pass) | |||||||||||||
| Creates an Excel worksheet for the detailed cumulated results of this question. More... | |||||||||||||
| __get ($value) | |||||||||||||
| Object getter. More... | |||||||||||||
| __set ($key, $value) | |||||||||||||
| Object setter. More... | |||||||||||||
| getNrOfTries () | |||||||||||||
| setNrOfTries ($a_nr_of_tries) | |||||||||||||
| setExportImagePath ($a_path) | |||||||||||||
| formatSAQuestion ($a_q) | |||||||||||||
| Format self assessment question. More... | |||||||||||||
| setPreventRteUsage ($a_val) | |||||||||||||
| Set prevent rte usage. More... | |||||||||||||
| getPreventRteUsage () | |||||||||||||
| Get prevent rte usage. More... | |||||||||||||
| migrateContentForLearningModule (ilAssSelfAssessmentMigrator $migrator) | |||||||||||||
| setSelfAssessmentEditingMode ($a_selfassessmenteditingmode) | |||||||||||||
| Set Self-Assessment Editing Mode. More... | |||||||||||||
| getSelfAssessmentEditingMode () | |||||||||||||
| Get Self-Assessment Editing Mode. More... | |||||||||||||
| setDefaultNrOfTries ($a_defaultnroftries) | |||||||||||||
| Set Default Nr of Tries. More... | |||||||||||||
| getDefaultNrOfTries () | |||||||||||||
| Get Default Nr of Tries. More... | |||||||||||||
| syncSkillAssignments ($srcParentId, $srcQuestionId, $trgParentId, $trgQuestionId) | |||||||||||||
| isAnswered ($active_id, $pass=null) | |||||||||||||
| returns boolean wether the question is answered during test pass or not More... | |||||||||||||
| isAutosaveable () | |||||||||||||
| getAdditionalContentEditingMode () | |||||||||||||
| getter for additional content editing mode for this question More... | |||||||||||||
| setAdditionalContentEditingMode ($additinalContentEditingMode) | |||||||||||||
| setter for additional content editing mode for this question More... | |||||||||||||
| isAdditionalContentEditingModePageObject () | |||||||||||||
| isser for additional "pageobject" content editing mode More... | |||||||||||||
| isValidAdditionalContentEditingMode ($additionalContentEditingMode) | |||||||||||||
| returns the fact wether the passed additional content mode is valid or not More... | |||||||||||||
| getValidAdditionalContentEditingModes () | |||||||||||||
| getter for valid additional content editing modes More... | |||||||||||||
| addQuestionChangeListener (ilQuestionChangeListener $listener) | |||||||||||||
| getQuestionChangeListeners () | |||||||||||||
| getHtmlUserSolutionPurifier () | |||||||||||||
| getHtmlQuestionContentPurifier () | |||||||||||||
| setLastChange ($lastChange) | |||||||||||||
| getLastChange () | |||||||||||||
| removeIntermediateSolution ($active_id, $pass) | |||||||||||||
| removeCurrentSolution ($active_id, $pass, $authorized=true) | |||||||||||||
| saveCurrentSolution ($active_id, $pass, $value1, $value2, $authorized=true, $tstamp=null) | |||||||||||||
| updateCurrentSolution ($solutionId, $value1, $value2, $authorized=true) | |||||||||||||
| updateCurrentSolutionsAuthorization ($activeId, $pass, $authorized, $keepTime=false) | |||||||||||||
| setStep ($step) | |||||||||||||
| getStep () | |||||||||||||
| toJSON () | |||||||||||||
| duplicate ($for_test=true, $title="", $author="", $owner="", $testObjId=null) | |||||||||||||
| intermediateSolutionExists ($active_id, $pass) | |||||||||||||
| authorizedSolutionExists ($active_id, $pass) | |||||||||||||
| authorizedOrIntermediateSolutionExists ($active_id, $pass) | |||||||||||||
| 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... | |||||||||||||
| 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) | |||||||||||||
| reworkWorkingData ($active_id, $pass, $obligationsAnswered, $authorized) | |||||||||||||
{Reworks the allready saved working data if neccessary.
| |||||||||||||
| 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) | |||||||||||||
| reworkWorkingData ($active_id, $pass, $obligationsAnswered, $authorized) | |||||||||||||
| Reworks the allready saved working data if neccessary. More... | |||||||||||||
| savePreviewData (ilAssQuestionPreviewSession $previewSession) | |||||||||||||
| deletePageOfQuestion ($question_id) | |||||||||||||
| Deletes the page object of a question with a given ID. More... | |||||||||||||
| onDuplicate ($originalParentId, $originalQuestionId, $duplicateParentId, $duplicateQuestionId) | |||||||||||||
| Will be called when a question is duplicated (inside a question pool or for insertion in a test) More... | |||||||||||||
| beforeSyncWithOriginal ($origQuestionId, $dupQuestionId, $origParentObjId, $dupParentObjId) | |||||||||||||
| afterSyncWithOriginal ($origQuestionId, $dupQuestionId, $origParentObjId, $dupParentObjId) | |||||||||||||
| onCopy ($sourceParentId, $sourceQuestionId, $targetParentId, $targetQuestionId) | |||||||||||||
| Will be called when a question is copied (into another question pool) More... | |||||||||||||
| duplicateSuggestedSolutionFiles ($parent_id, $question_id) | |||||||||||||
| Duplicates the files of a suggested solution if the question is duplicated. More... | |||||||||||||
| syncSuggestedSolutionFiles ($original_id) | |||||||||||||
| Syncs the files of a suggested solution if the question is synced. More... | |||||||||||||
| copySuggestedSolutionFiles ($source_questionpool_id, $source_question_id) | |||||||||||||
| 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) | |||||||||||||
| 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 | |
| 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, and assQuestion\$title.
Member Function Documentation
◆ __get()
| assFormulaQuestion::__get | ( | $value | ) |
Object getter.
Reimplemented from assQuestion.
Definition at line 1302 of file class.assFormulaQuestion.php.
1303 {
1304 switch ($value) {
1305 case "resultunits":
1307 break;
1308 default:
1309 return parent::__get($value);
1310 break;
1311 }
1312 }
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:1325
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 846 of file class.assFormulaQuestion.php.
847 {
850 }
852 $user_solution = array();
853 foreach ($solutions as $idx => $solution_value) {
854 if (preg_match("/^(\\\$v\\d+)$/", $solution_value["value1"], $matches)) {
855 $user_solution[$matches[1]] = $solution_value["value2"];
857 $varObj->setValue($solution_value["value2"]);
858 } elseif (preg_match("/^(\\\$r\\d+)$/", $solution_value["value1"], $matches)) {
859 if (!array_key_exists($matches[1], $user_solution)) {
860 $user_solution[$matches[1]] = array();
861 }
862 $user_solution[$matches[1]]["value"] = $solution_value["value2"];
863 } elseif (preg_match("/^(\\\$r\\d+)_unit$/", $solution_value["value1"], $matches)) {
864 if (!array_key_exists($matches[1], $user_solution)) {
865 $user_solution[$matches[1]] = array();
866 }
867 $user_solution[$matches[1]]["unit"] = $solution_value["value2"];
868 }
869 }
870 //vd($this->getResults());
871 $points = 0;
873 //vd($user_solution[$result->getResult()]["value"]);
874 $points += $result->getReachedPoints($this->getVariables(), $this->getResults(), $user_solution[$result->getResult()]["value"], $user_solution[$result->getResult()]["unit"], $this->unitrepository->getUnits());
875 }
876
878 }
getSolutionValues($active_id, $pass=null, $authorized=true)
Loads solutions of a given user from the database an returns it.
Definition: class.assQuestion.php:1739
getSolutionMaxPass($active_id)
Returns the maximum pass a users question solution.
Definition: class.assQuestion.php:3260
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 880 of file class.assFormulaQuestion.php.
881 {
882 $user_solution = $previewSession->getParticipantsSolution();
883
884 $points = 0;
887 $u = isset($user_solution[$result->getResult() . '_unit']) ? $user_solution[$result->getResult() . '_unit'] : null;
888
890 $this->getVariables(),
891 $this->getResults(),
892 $v,
893 $u,
894 $this->unitrepository->getUnits()
895 );
896 }
897
899
901 }
deductHintPointsFromReachedPoints(ilAssQuestionPreviewSession $previewSession, $reachedPoints)
Definition: class.assQuestion.php:3360
ensureNonNegativePoints($points)
Definition: class.assQuestion.php:3379
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 762 of file class.assFormulaQuestion.php.
763 {
764 if ($this->id <= 0) {
765 // The question has not been saved. It cannot be duplicated
766 return;
767 }
768 // duplicate the question in database
769 $clone = $this;
770 include_once("./Modules/TestQuestionPool/classes/class.assQuestion.php");
772 $clone->id = -1;
773 $source_questionpool_id = $this->getObjId();
774 $clone->setObjId($target_questionpool_id);
776 $clone->setTitle($title);
777 }
778 $clone->saveToDb();
779
780 $clone->unitrepository->cloneUnits($original_id, $clone->getId());
781
782 // copy question page content
783 $clone->copyPageOfQuestion($original_id);
784 // copy XHTML media objects
785 $clone->copyXHTMLMediaObjectsOfQuestion($original_id);
786
787 $clone->onCopy($source_questionpool_id, $original_id, $clone->getObjId(), $clone->getId());
788
789 return $clone->id;
790 }
static _getOriginalId($question_id)
Returns the original id of a question.
Definition: class.assQuestion.php:3053
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 792 of file class.assFormulaQuestion.php.
793 {
794 if ($this->id <= 0) {
795 // The question has not been saved. It cannot be duplicated
796 return;
797 }
798
799 include_once("./Modules/TestQuestionPool/classes/class.assQuestion.php");
800
801 $sourceQuestionId = $this->id;
802 $sourceParentId = $this->getObjId();
803
804 // duplicate the question in database
805 $clone = $this;
806 $clone->id = -1;
807
808 $clone->setObjId($targetParentId);
809
810 if ($targetQuestionTitle) {
811 $clone->setTitle($targetQuestionTitle);
812 }
813
814 $clone->saveToDb();
815 // copy question page content
816 $clone->copyPageOfQuestion($sourceQuestionId);
817 // copy XHTML media objects
818 $clone->copyXHTMLMediaObjectsOfQuestion($sourceQuestionId);
819
820 $clone->onCopy($sourceParentId, $sourceQuestionId, $clone->getObjId(), $clone->getId());
821
822 return $clone->id;
823 }
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 1141 of file class.assFormulaQuestion.php.
1142 {
1143 global $ilDB;
1144
1145 $affectedRows = $ilDB->manipulateF(
1146 "DELETE FROM il_qpl_qst_fq_var WHERE question_fi = %s",
1147 array('integer'),
1148 array($question_id)
1149 );
1150
1151 $affectedRows = $ilDB->manipulateF(
1152 "DELETE FROM il_qpl_qst_fq_res 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_unit WHERE question_fi = %s",
1159 array('integer'),
1160 array($question_id)
1161 );
1162
1163 $affectedRows = $ilDB->manipulateF(
1164 "DELETE FROM il_qpl_qst_fq_ucat WHERE question_fi = %s",
1165 array('integer'),
1166 array($question_id)
1167 );
1168
1169 $affectedRows = $ilDB->manipulateF(
1170 "DELETE FROM il_qpl_qst_fq_unit WHERE question_fi = %s",
1171 array('integer'),
1172 array($question_id)
1173 );
1174 }
References $ilDB.
◆ duplicate()
| assFormulaQuestion::duplicate | ( | $for_test = true, |
|
$title = "", |
|||
$author = "", |
|||
$owner = "", |
|||
$testObjId = null |
|||
| ) |
Duplicates an assFormulaQuestion @access public.
Reimplemented from assQuestion.
Definition at line 711 of file class.assFormulaQuestion.php.
712 {
713 if ($this->id <= 0) {
714 // The question has not been saved. It cannot be duplicated
715 return;
716 }
717 // duplicate the question in database
718 $this_id = $this->getId();
719 $thisObjId = $this->getObjId();
720
721 $clone = $this;
722 include_once("./Modules/TestQuestionPool/classes/class.assQuestion.php");
724 $clone->id = -1;
725
726 if ((int) $testObjId > 0) {
727 $clone->setObjId($testObjId);
728 }
729
731 $clone->setTitle($title);
732 }
733
735 $clone->setAuthor($author);
736 }
738 $clone->setOwner($owner);
739 }
740
741 if ($for_test) {
742 $clone->saveToDb($original_id);
743 } else {
744 $clone->saveToDb();
745 }
746
747 $clone->unitrepository->cloneUnits($this_id, $clone->getId());
748
749 // copy question page content
750 $clone->copyPageOfQuestion($this_id);
751 // copy XHTML media objects
752 $clone->copyXHTMLMediaObjectsOfQuestion($this_id);
753 $clone->onDuplicate($thisObjId, $this_id, $clone->getObjId(), $clone->getId());
754
755 return $clone->id;
756 }
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 1122 of file class.assFormulaQuestion.php.
1123 {
1124 return "";
1125 }
◆ 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 1131 of file class.assFormulaQuestion.php.
1132 {
1133 return "";
1134 }
◆ 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 1441 of file class.assFormulaQuestion.php.
1442 {
1445 } else {
1447 }
1448 }
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 1224 of file class.assFormulaQuestion.php.
1225 {
1226 $user_solution = array();
1227
1228 foreach ($solutions as $idx => $solution_value) {
1229 if (preg_match("/^(\\\$v\\d+)$/", $solution_value["value1"], $matches)) {
1230 $user_solution[$matches[1]] = $solution_value["value2"];
1231 $varObj = $this->getVariable($matches[1]);
1232 $varObj->setValue($solution_value["value2"]);
1233 } elseif (preg_match("/^(\\\$r\\d+)$/", $solution_value["value1"], $matches)) {
1234 if (!array_key_exists($matches[1], $user_solution)) {
1235 $user_solution[$matches[1]] = array();
1236 }
1237 $user_solution[$matches[1]]["value"] = $solution_value["value2"];
1238 } elseif (preg_match("/^(\\\$r\\d+)_unit$/", $solution_value["value1"], $matches)) {
1239 if (!array_key_exists($matches[1], $user_solution)) {
1240 $user_solution[$matches[1]] = array();
1241 }
1242 $user_solution[$matches[1]]["unit"] = $solution_value["value2"];
1243 }
1244 }
1246 $resVal = $result->calculateFormula($this->getVariables(), $this->getResults(), parent::getId(), false);
1247
1252 $unit_factor = 1;
1253 // there is no fix result_unit, any "available unit" is accepted
1254
1255 $available_units = $result->getAvailableResultUnits(parent::getId());
1256 $result_name = $result->getResult();
1257
1258 if ($available_units[$result_name] != null) {
1259 $check_unit = in_array($user_solution[$result_name]['unit'], $available_units[$result_name]);
1260 }
1261
1262 if ($check_unit == true) {
1263 //get unit-factor
1265 }
1266
1267 $user_solution[$result->getResult()]["value"] = round(ilMath::_div($resVal, $unit_factor), 55);
1268 }
1271 $value = assFormulaQuestionResult::convertDecimalToCoprimeFraction($resVal);
1272 if (is_array($value)) {
1275 } else {
1278 }
1279 } elseif ($result->getPrecision() > 0) {
1282 $result->getPrecision()
1283 );
1284 } else {
1287 );
1288 }
1289 }
1290 return $user_solution;
1291 }
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:805
static lookupUnitFactor($a_unit_id)
Definition: class.assFormulaQuestionUnit.php:144
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 1380 of file class.assFormulaQuestion.php.
1381 {
1382 return array(
1386 );
1387 }
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 829 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 1370 of file class.assFormulaQuestion.php.
1371 {
1372 require_once "./Modules/TestQuestionPool/classes/class.ilOperatorsExpressionMapping.php";
1374 }
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 1113 of file class.assFormulaQuestion.php.
1114 {
1115 return "assFormulaQuestion";
1116 }
◆ 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 1180 of file class.assFormulaQuestion.php.
References $text.
◆ getSolutionSubmit()
|
protected |
- Returns
- array
Definition at line 1333 of file class.assFormulaQuestion.php.
1334 {
1335 $solutionSubmit = array();
1337 if (preg_match("/^result_(\\\$r\\d+)$/", $k)) {
1338 $solutionSubmit[$k] = $v;
1339 } elseif (preg_match("/^result_(\\\$r\\d+)_unit$/", $k)) {
1340 $solutionSubmit[$k] = $v;
1341 }
1342 }
1343 return $solutionSubmit;
1344 }
References $_POST.
Referenced by savePreviewData(), saveWorkingData(), and validateSolutionSubmit().
Here is the caller graph for this function:
◆ getUnitrepository()
| assFormulaQuestion::getUnitrepository | ( | ) |
- Returns
- \ilUnitConfigurationRepository
Definition at line 1325 of file class.assFormulaQuestion.php.
1326 {
1328 }
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:829
References getMaximumPoints().
Here is the call graph for this function:
◆ isValidSolutionResultValue()
|
protected |
Definition at line 903 of file class.assFormulaQuestion.php.
904 {
905 $submittedValue = str_replace(',', '.', $submittedValue);
906
907 if (is_numeric($submittedValue)) {
908 return true;
909 }
910
911 if (preg_match('/^[-+]{0,1}\d+\/\d+$/', $submittedValue)) {
912 return true;
913 }
914
915 return false;
916 }
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 628 of file class.assFormulaQuestion.php.
629 {
630 global $ilDB;
631
633 "SELECT qpl_questions.* FROM qpl_questions WHERE question_id = %s",
634 array('integer'),
635 array($question_id)
636 );
639 $this->setId($question_id);
648
649 try {
652 }
653
655
656 include_once("./Services/RTE/classes/class.ilRTE.php");
658 $this->setEstimatedWorkingTime(substr($data["working_time"], 0, 2), substr($data["working_time"], 3, 2), substr($data["working_time"], 6, 2));
659
660 // load variables
662 "SELECT * FROM il_qpl_qst_fq_var WHERE question_fi = %s",
663 array('integer'),
664 array($question_id)
665 );
668 $varObj = new assFormulaQuestionVariable($data["variable"], $data["range_min"], $data["range_max"], $this->getUnitrepository()->getUnit($data["unit_fi"]), $data["varprecision"], $data["intprecision"]);
671 $this->addVariable($varObj);
672 }
673 }
674 // load results
676 "SELECT * FROM il_qpl_qst_fq_res WHERE question_fi = %s",
677 array('integer'),
678 array($question_id)
679 );
682 $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"]);
686 $this->addResult($resObj);
687 }
688 }
689
690 // load result units
692 "SELECT * FROM il_qpl_qst_fq_res_unit WHERE question_fi = %s",
693 array('integer'),
694 array($question_id)
695 );
700 $this->addResultUnit($resObj, $unit);
701 }
702 }
703 }
704 parent::loadFromDb($question_id);
705 }
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:2750
setTitle($title="")
Sets the title string of the assQuestion object.
Definition: class.assQuestion.php:591
setOwner($owner="")
Sets the creator/owner ID of the assQuestion object.
Definition: class.assQuestion.php:732
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:671
setAuthor($author="")
Sets the authors name of the assQuestion object.
Definition: class.assQuestion.php:717
setPoints($a_points)
Sets the maximum available points for the question.
Definition: class.assQuestion.php:3249
setComment($comment="")
Sets the comment string of the assQuestion object.
Definition: class.assQuestion.php:627
setAdditionalContentEditingMode($additinalContentEditingMode)
setter for additional content editing mode for this question
Definition: class.assQuestion.php:4500
setQuestion($question="")
Sets the question string of the question object.
Definition: class.assQuestion.php:3680
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, $ilDB, $result, ilRTE\_replaceMediaObjectImageSrc(), addResult(), addResultUnit(), addVariable(), getResult(), getUnitrepository(), assQuestion\setAdditionalContentEditingMode(), assQuestion\setAuthor(), assQuestion\setComment(), assQuestion\setEstimatedWorkingTime(), setId(), 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 1016 of file class.assFormulaQuestion.php.
1017 {
1018 global $ilDB;
1019
1020 $return = array(
1021 'authorized' => false,
1022 'intermediate' => false
1023 );
1024
1026 SELECT authorized, COUNT(*) cnt
1027 FROM tst_solutions
1031 AND value1 like '\$r%'
1032 AND value2 is not null
1033 AND value2 <> ''
1034 ";
1035
1038 }
1039
1041 GROUP BY authorized
1042 ";
1043
1045
1049 } else {
1051 }
1052 }
1053 return $return;
1054 }
References $ilDB, $pass, $query, $result, $row, 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 1064 of file class.assFormulaQuestion.php.
1065 {
1066 global $ilDB;
1067
1069 DELETE FROM tst_solutions
1073 AND value1 like '\$r%'
1074 ";
1075
1078 }
1079
1081 }
References $ilDB, $pass, $query, assQuestion\getId(), and assQuestion\getStep().
Here is the call graph for this function:
◆ reworkWorkingData()
|
protected |
{Reworks the allready saved working data if neccessary.
- Parameters
-
integer $active_id integer $pass boolean $obligationsAnswered boolean $authorized
Reimplemented from assQuestion.
Definition at line 1104 of file class.assFormulaQuestion.php.
1105 {
1106 // nothing to rework!
1107 }
◆ savePreviewData()
|
protected |
Reimplemented from assQuestion.
Definition at line 1084 of file class.assFormulaQuestion.php.
1085 {
1086 $userSolution = $previewSession->getParticipantsSolution();
1087
1089 $matches = null;
1090
1092 $userSolution[$matches[1]] = $val;
1094 $userSolution[$matches[1] . "_unit"] = $val;
1095 }
1096 }
1097
1098 $previewSession->setParticipantsSolution($userSolution);
1099 }
getSolutionSubmit()
Definition: class.assFormulaQuestion.php:1333
setParticipantsSolution($participantSolution)
Definition: class.ilAssQuestionPreviewSession.php:74
References $key, 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 $ilDB;
532
534 // save variables
535 $affectedRows = $ilDB->manipulateF(
536 "
537 DELETE FROM il_qpl_qst_fq_var
538 WHERE question_fi = %s",
539 array("integer"),
540 array($this->getId())
541 );
542
543 foreach ($this->variables as $variable) {
545 $ilDB->insert(
546 'il_qpl_qst_fq_var',
547 array(
548 'variable_id' => array('integer', $next_id),
550 'variable' => array('text', $variable->getVariable()),
551 'range_min' => array('float', ((strlen($variable->getRangeMin())) ? $variable->getRangeMin() : 0.0)),
552 'range_max' => array('float', ((strlen($variable->getRangeMax())) ? $variable->getRangeMax() : 0.0)),
553 'unit_fi' => array('integer', (is_object($variable->getUnit()) ? (int) $variable->getUnit()->getId() : 0)),
554 'varprecision' => array('integer', (int) $variable->getPrecision()),
555 'intprecision' => array('integer', (int) $variable->getIntprecision()),
556 'range_min_txt' => array('text', $variable->getRangeMinTxt()),
557 'range_max_txt' => array('text', $variable->getRangeMaxTxt())
558 )
559 );
560 }
561 // save results
562 $affectedRows = $ilDB->manipulateF(
563 "DELETE FROM il_qpl_qst_fq_res WHERE question_fi = %s",
564 array("integer"),
565 array($this->getId())
566 );
567
571 $tmp_result_unit = $result->getUnit()->getId();
572 } else {
573 $tmp_result_unit = null;
574 }
575
577
579 "result_id" => array("integer", $next_id),
584 "tolerance" => array("float", ((strlen($result->getTolerance())) ? $result->getTolerance() : 0)),
585 "unit_fi" => array("integer", (int) $tmp_result_unit),
586 "formula" => array("clob", $formula),
596
597 ));
598 }
599 // save result units
600 $affectedRows = $ilDB->manipulateF(
601 "DELETE FROM il_qpl_qst_fq_res_unit WHERE question_fi = %s",
602 array("integer"),
603 array($this->getId())
604 );
608 $affectedRows = $ilDB->manipulateF(
609 "INSERT INTO il_qpl_qst_fq_res_unit (result_unit_id, question_fi, result, unit_fi) VALUES (%s, %s, %s, %s)",
610 array('integer', 'integer', 'text', 'integer'),
611 array(
612 $next_id,
613 $this->getId(),
614 $result->getResult(),
615 $unit->getId()
616 )
617 );
618 }
619 }
620
621 parent::saveToDb();
622 }
saveQuestionDataToDb($original_id="")
Definition: class.assQuestion.php:2526
References $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 925 of file class.assFormulaQuestion.php.
926 {
927 global $ilDB;
928
930 include_once "./Modules/Test/classes/class.ilObjTest.php";
932 }
933
934 $entered_values = false;
935
936 $this->getProcessLocker()->executeUserSolutionUpdateLockOperation(function () use (&$entered_values, $ilDB, $active_id, $pass, $authorized) {
937 $solutionSubmit = $this->getSolutionSubmit();
939 $matches = null;
941 if (strlen($value)) {
942 $entered_values = true;
943 }
944
945 $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]);
946
949 }
950
951 $result = $ilDB->queryF(
952 $queryResult,
953 array('integer', 'integer', 'integer', 'integer'),
955 );
958 $ilDB->manipulateF(
959 "DELETE FROM tst_solutions WHERE solution_id = %s AND authorized = %s",
960 array('integer', 'integer'),
962 );
963 }
964 }
965
966 $this->saveCurrentSolution($active_id, $pass, $matches[1], str_replace(",", ".", $value), $authorized);
968 $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");
969
972 }
973
974 $result = $ilDB->queryF(
975 $queryResultUnit,
976 array('integer', 'integer', 'integer', 'integer'),
978 );
981 $ilDB->manipulateF(
982 "DELETE FROM tst_solutions WHERE solution_id = %s AND authorized = %s",
983 array('integer', 'integer'),
985 );
986 }
987 }
988
990 }
991 }
992 });
993
994 if ($entered_values) {
995 include_once("./Modules/Test/classes/class.ilObjAssessmentFolder.php");
997 assQuestion::logAction($this->lng->txtlng("assessment", "log_user_entered_values", ilObjAssessmentFolder::_getLogLanguage()), $active_id, $this->getId());
998 }
999 } else {
1000 include_once("./Modules/Test/classes/class.ilObjAssessmentFolder.php");
1002 assQuestion::logAction($this->lng->txtlng("assessment", "log_user_not_entered_values", ilObjAssessmentFolder::_getLogLanguage()), $active_id, $this->getId());
1003 }
1004 }
1005
1006 return true;
1007 }
saveCurrentSolution($active_id, $pass, $value1, $value2, $authorized=true, $tstamp=null)
Definition: class.assQuestion.php:4787
static logAction($logtext="", $active_id="", $question_id="")
Logs an action into the Test&Assessment log.
Definition: class.assQuestion.php:1557
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:7852
References $ilDB, $key, $pass, $result, $row, 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 1189 of file class.assFormulaQuestion.php.
1190 {
1192
1194
1195 $i = 1;
1196 foreach ($solution as $solutionvalue) {
1199 if (strpos($solutionvalue["value1"], "_unit")) {
1201 if (is_object($unit)) {
1203 }
1204 } else {
1206 }
1207 if (preg_match("/(\\\$v\\d+)/", $solutionvalue["value1"], $matches)) {
1209 if (is_object($var) && (is_object($var->getUnit()))) {
1211 }
1212 }
1213 $i++;
1214 }
1215
1217 }
References $i, $pass, $worksheet, 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 1293 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 1317 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
271
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 }
298 if (false && $forsolution && $result_output) { // fix for mantis #25956
299 $value_org = $resObj->calculateFormula($this->getVariables(), $this->getResults(), parent::getId());
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());
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 {
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) {
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)) {
435 $template->parseCurrentBlock();
436 } else {
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
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 .= ")";
468
469 $resultOutput = $template->get();
470 }
471 $text = preg_replace("/\\\$" . substr($result, 1) . "(?![0-9]+)/", $input . " " . $units . " " . $checkSign . " " . $resultOutput . " " . "\\1", $text);
472 }
473 }
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:79
static prepareFormOutput($a_str, $a_strip=false)
prepares string output for html forms @access public
Definition: class.ilUtil.php:2855
References $result, $template, $text, $userdata, assFormulaQuestionResult\convertDecimalToCoprimeFraction(), fetchAllVariables(), ilUtil\getImagePath(), assQuestion\getQuestion(), getResult(), getResults(), getResultUnits(), getUnitrepository(), getVariables(), ilUtil\prepareFormOutput(), assFormulaQuestionResult\RESULT_CO_FRAC, assFormulaQuestionResult\RESULT_DEC, assFormulaQuestionResult\RESULT_FRAC, assFormulaQuestionResult\RESULT_NO_SELECTION, and sprintf.
Here is the call graph for this function:
◆ validateSolutionSubmit()
| assFormulaQuestion::validateSolutionSubmit | ( | ) |
Reimplemented from assQuestion.
Definition at line 1346 of file class.assFormulaQuestion.php.
1347 {
1352 return false;
1353 }
1355 continue;
1356 }
1357 }
1358
1359 return true;
1360 }
isValidSolutionResultValue($submittedValue)
Definition: class.assFormulaQuestion.php:903
static sendFailure($a_info="", $a_keep=false)
Send Failure Message to Screen.
Definition: class.ilUtil.php:4530
References $key, 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
