assFormulaQuestion Class Reference
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V. More...
Inheritance diagram for assFormulaQuestion:
Collaboration diagram for assFormulaQuestion:
Public Member Functions | |
| __construct (string $title="", string $comment="", string $author="", int $owner=-1, string $question="") | |
| assQuestion constructor More... | |
| clearVariables () | |
| getVariables () | |
| getVariable ($variable) | |
| addVariable ($variable) | |
| clearResults () | |
| getResults () | |
| getResult ($result) | |
| addResult ($result) | |
| addResultUnits ($result, $unit_ids) | |
| addResultUnit ($result, $unit) | |
| getResultUnits (assFormulaQuestionResult $result) | |
| getAllResultUnits () | |
| hasResultUnit ($result, $unit_id) | |
| parseQuestionText () | |
| checkForDuplicateVariables () | |
| checkForDuplicateResults () | |
| fetchAllResults ($questionText) | |
| fetchAllVariables ($questionText) | |
| hasRequiredVariableSolutionValues (array $userSolution) | |
| getInitialVariableSolutionValues () | |
| substituteVariables (array $userdata, bool $graphicalOutput=false, bool $forsolution=false, bool $result_output=false, array $correctness_icons=[]) | |
| 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 (bool $for_test=true, string $title="", string $author="", string $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 (int $activeId, int $pass) | |
| Lookup if an authorized or intermediate solution exists. More... | |
| removeExistingSolutions (int $activeId, int $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 (ilAssExcelFormatHelper $worksheet, int $startrow, int $active_id, int $pass) | |
| {} More... | |
| getBestSolution ($solutions) | |
| Returns the best solution for a given pass of a participant. More... | |
| setId ($id=-1) | |
| 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 (string $title="", string $comment="", string $author="", int $owner=-1, string $question="") | |
| assQuestion constructor More... | |
| getShuffler () | |
| setShuffler (Transformation $shuffler) | |
| setProcessLocker (ilAssQuestionProcessLocker $processLocker) | |
| getProcessLocker () | |
| fromXML ($item, int $questionpool_id, ?int $tst_id, &$tst_object, int &$question_counter, array $import_mapping, array &$solutionhints=[]) | |
| Receives parameters from a QTI parser and creates a valid ILIAS question object. More... | |
| toXML (bool $a_include_header=true, bool $a_include_binary=true, bool $a_shuffle=false, bool $test_output=false, bool $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 (int $questionpool_id, string $title) | |
| Returns TRUE if the question title exists in a question pool in the database. More... | |
| setTitle (string $title="") | |
| setId (int $id=-1) | |
| setTestId (int $id=-1) | |
| setComment (string $comment="") | |
| setOutputType (int $outputType=OUTPUT_HTML) | |
| setShuffle (?bool $shuffle=true) | |
| setAuthor (string $author="") | |
| setOwner (int $owner=-1) | |
| getTitle () | |
| getTitleForHTMLOutput () | |
| getTitleFilenameCompliant () | |
| getId () | |
| getShuffle () | |
| getTestId () | |
| getComment () | |
| getDescriptionForHTMLOutput () | |
| getThumbSize () | |
| setThumbSize (int $a_size) | |
| getMinimumThumbSize () | |
| getMaximumThumbSize () | |
| getOutputType () | |
| supportsJavascriptOutput () | |
| supportsNonJsOutput () | |
| requiresJsSwitch () | |
| getAuthor () | |
| getAuthorForHTMLOutput () | |
| getOwner () | |
| getObjId () | |
| setObjId (int $obj_id=0) | |
| getLifecycle () | |
| setLifecycle (ilAssQuestionLifecycle $lifecycle) | |
| setExternalId (?string $external_id) | |
| getExternalId () | |
| getSuggestedSolutionOutput () | |
| _getSuggestedSolution (int $question_id, int $subquestion_index=0) | |
| loadSuggestedSolution (int $question_id, int $subquestion_index=0) | |
| Returns a suggested solution for a given subquestion index. More... | |
| getSuggestedSolutions () | |
| getReachedPoints (int $active_id, int $pass) | |
| getMaximumPoints () | |
| getAdjustedReachedPoints (int $active_id, int $pass, bool $authorizedSolution=true) | |
| returns the reached points ... More... | |
| calculateResultsFromSolution (int $active_id, int $pass, bool $obligationsEnabled=false) | |
| Calculates the question results from a previously saved question solution. More... | |
| persistWorkingState (int $active_id, $pass, bool $obligationsEnabled=false, bool $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 (int $active_id, int $pass, bool $authorized=true) | |
| Saves the learners input of the question to the database. More... | |
| moveUploadedMediaFile (string $file, string $name) | |
| Move an uploaded media file to an public accessible temp dir to present it. More... | |
| getSuggestedSolutionPath () | |
| 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... | |
| getSuggestedSolutionPathWeb () | |
| getImagePathWeb () | |
| Returns the web image path for web accessable images of a question. More... | |
| getTestOutputSolutions (int $activeId, int $pass) | |
| getUserSolutionPreferingIntermediate (int $active_id, $pass=null) | |
| getSolutionValues ($active_id, $pass=null, bool $authorized=true) | |
| Loads solutions of a given user from the database an returns it. More... | |
| isInUse (int $question_id=0) | |
| Checks whether the question is in use or not in pools or tests. More... | |
| usageNumber (int $question_id=0) | |
| Returns the number of place the question is in use in pools or tests. More... | |
| isClone (int $question_id=0) | |
| Checks whether the question is a clone of another question or not. More... | |
| getAdditionalTableName () | |
| getAnswerTableName () | |
| deleteAnswers (int $question_id) | |
| deleteAdditionalTableData (int $question_id) | |
| delete (int $question_id) | |
| getTotalAnswers () | |
| copyXHTMLMediaObjectsOfQuestion (int $a_q_id) | |
| syncXHTMLMediaObjectsOfQuestion () | |
| createPageObject () | |
| copyPageOfQuestion (int $a_q_id) | |
| getPageOfQuestion () | |
| setOriginalId (?int $original_id) | |
| getOriginalId () | |
| fixSvgToPng (string $imageFilenameContainingString) | |
| fixUnavailableSkinImageSources (string $html) | |
| loadFromDb (int $question_id) | |
| createNewQuestion (bool $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 (int $original_id=-1) | |
| saveToDb () | |
| setNewOriginalId (int $newId) | |
| deleteSuggestedSolutions () | |
| getSuggestedSolution (int $subquestion_index=0) | |
| Returns a suggested solution for a given subquestion index. More... | |
| getSuggestedSolutionTitle (int $subquestion_index=0) | |
| Returns the title of a suggested solution at a given subquestion_index. More... | |
| setSuggestedSolution (string $solution_id="", int $subquestion_index=0, bool $is_import=false) | |
| Sets a suggested solution for the question. More... | |
| updateSuggestedSolutions (int $original_id=-1, int $original_obj_id=-1) | |
| _resolveInternalLink (string $internal_link) | |
| _resolveIntLinks (int $question_id) | |
| syncWithOriginal () | |
| _questionExists ($question_id) | |
| Returns true if the question already exists in the database. More... | |
| _questionExistsInPool (int $question_id) | |
| getPoints () | |
| setPoints (float $points) | |
| getSolutionMaxPass (int $active_id) | |
| 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 (string $txt_output, bool $prepare_for_latex_output=false, bool $omitNl2BrWhenTextArea=false) | |
| QTIMaterialToString (ilQTIMaterial $a_material) | |
| Reads an QTI material tag and creates a text or XHTML string. More... | |
| addQTIMaterial (ilXmlWriter $a_xml_writer, string $a_material, bool $close_material_tag=true, bool $add_mobs=true) | |
| buildHashedImageFilename (string $plain_image_filename, bool $unique=false) | |
| getQuestion () | |
| getQuestionForHTMLOutput () | |
| setQuestion (string $question="") | |
| getQuestionType () | |
| Returns the question type of the question. More... | |
| getQuestionTypeID () | |
| syncHints () | |
| cleanupMediaObjectUsage () | |
| getInstances () | |
| getActiveUserData (int $active_id) | |
| Returns the user id and the test id for a given active id. More... | |
| hasSpecificFeedback () | |
| setExportDetailsXLS (ilAssExcelFormatHelper $worksheet, int $startrow, int $active_id, int $pass) | |
| __get ($value) | |
| Object getter. More... | |
| __set ($key, $value) | |
| Object setter. More... | |
| __isset ($key) | |
| Object issetter. More... | |
| getNrOfTries () | |
| setNrOfTries (int $a_nr_of_tries) | |
| setExportImagePath (string $path) | |
| formatSAQuestion ($a_q) | |
| setPreventRteUsage (bool $prevent_rte_usage) | |
| getPreventRteUsage () | |
| migrateContentForLearningModule (ilAssSelfAssessmentMigrator $migrator) | |
| setSelfAssessmentEditingMode (bool $selfassessmenteditingmode) | |
| getSelfAssessmentEditingMode () | |
| setDefaultNrOfTries (int $defaultnroftries) | |
| getDefaultNrOfTries () | |
| syncSkillAssignments (int $srcParentId, int $srcQuestionId, int $trgParentId, int $trgQuestionId) | |
| ensureHintPageObjectExists ($pageObjectId) | |
| isAnswered (int $active_id, int $pass) | |
| isAutosaveable () | |
| getAdditionalContentEditingMode () | |
| setAdditionalContentEditingMode (?string $additionalContentEditingMode) | |
| isAdditionalContentEditingModePageObject () | |
| isValidAdditionalContentEditingMode (string $additionalContentEditingMode) | |
| getValidAdditionalContentEditingModes () | |
| getHtmlUserSolutionPurifier () | |
| getHtmlQuestionContentPurifier () | |
| setLastChange ($lastChange) | |
| getLastChange () | |
| removeIntermediateSolution (int $active_id, int $pass) | |
| removeCurrentSolution (int $active_id, int $pass, bool $authorized=true) | |
| saveCurrentSolution (int $active_id, int $pass, $value1, $value2, bool $authorized=true, $tstamp=0) | |
| updateCurrentSolution (int $solutionId, $value1, $value2, bool $authorized=true) | |
| updateCurrentSolutionsAuthorization (int $activeId, int $pass, bool $authorized, bool $keepTime=false) | |
| setStep ($step) | |
| getStep () | |
| toJSON () | |
| duplicate (bool $for_test=true, string $title="", string $author="", string $owner="", $testObjId=null) | |
| intermediateSolutionExists (int $active_id, int $pass) | |
| authorizedSolutionExists (int $active_id, ?int $pass) | |
| authorizedOrIntermediateSolutionExists (int $active_id, int $pass) | |
| lookupForExistingSolutions (int $activeId, int $pass) | |
| Lookup if an authorized or intermediate solution exists. More... | |
| isAddableAnswerOptionValue (int $qIndex, string $answerOptionValue) | |
| addAnswerOptionValue (int $qIndex, string $answerOptionValue, float $points) | |
| removeAllExistingSolutions () | |
| removeExistingSolutions (int $activeId, int $pass) | |
| resetUsersAnswer (int $activeId, int $pass) | |
| removeResultRecord (int $activeId, int $pass) | |
| fetchValuePairsFromIndexedValues (array $indexedValues) | |
| fetchIndexedValuesFromValuePairs (array $valuePairs) | |
| areObligationsToBeConsidered () | |
| setObligationsToBeConsidered (bool $obligationsToBeConsidered) | |
| updateTimestamp () | |
| getTestPresentationConfig () | |
| savePartial () | |
| isInActiveTest () | |
| Public Member Functions inherited from iQuestionCondition | |
| getOperators ($expression) | |
| Get all available operations for a specific question. More... | |
| getExpressionTypes () | |
| Get all available expression types for a specific question. More... | |
| getUserQuestionResult ($active_id, $pass) | |
| Get the user solution for a question by active_id and the test pass. More... | |
| getAvailableAnswerOptions ($index=null) | |
| If index is null, the function returns an array with all anwser options Else it returns the specific answer option. More... | |
Protected Member Functions | |
| generateResultInputHTML (string $result_key, string $result_value, bool $forsolution) | |
| isValidSolutionResultValue ($submittedValue) | |
| savePreviewData (ilAssQuestionPreviewSession $previewSession) | |
| getSolutionSubmit () | |
| Protected Member Functions inherited from assQuestion | |
| getQuestionAction () | |
| isNonEmptyItemListPostSubmission (string $postSubmissionFieldname) | |
| ensureCurrentTestPass (int $active_id, int $pass) | |
| lookupCurrentTestPass (int $active_id, int $pass) | |
| lookupTestId (int $active_id) | |
| @refactor Move to ilObjTest or similar More... | |
| log (int $active_id, string $langVar) | |
| savePreviewData (ilAssQuestionPreviewSession $previewSession) | |
| deletePageOfQuestion (int $question_id) | |
| onDuplicate (int $originalParentId, int $originalQuestionId, int $duplicateParentId, int $duplicateQuestionId) | |
| beforeSyncWithOriginal (int $origQuestionId, int $dupQuestionId, int $origParentObjId, int $dupParentObjId) | |
| afterSyncWithOriginal (int $origQuestionId, int $dupQuestionId, int $origParentObjId, int $dupParentObjId) | |
| onCopy (int $sourceParentId, int $sourceQuestionId, int $targetParentId, int $targetQuestionId) | |
| duplicateSuggestedSolutionFiles (int $parent_id, int $question_id) | |
| Duplicates the files of a suggested solution if the question is duplicated. More... | |
| syncSuggestedSolutionFiles (int $target_question_id, int $target_obj_id) | |
| copySuggestedSolutionFiles (int $source_questionpool_id, int $source_question_id) | |
| ensureNonNegativePoints ($points) | |
| purifyAndPrepareTextAreaOutput (string $content) | |
| getRTETextWithMediaObjects () | |
| getSelfAssessmentFormatter () | |
| lmMigrateQuestionTypeGenericContent (ilAssSelfAssessmentMigrator $migrator) | |
| lmMigrateQuestionTypeSpecificContent (ilAssSelfAssessmentMigrator $migrator) | |
| duplicateQuestionHints (int $originalQuestionId, int $duplicateQuestionId) | |
| duplicateSkillAssignments (int $srcParentId, int $srcQuestionId, int $trgParentId, int $trgQuestionId) | |
| buildQuestionDataQuery () | |
| getCurrentSolutionResultSet (int $active_id, int $pass, bool $authorized=true) | |
| removeSolutionRecordById (int $solutionId) | |
| getSolutionRecordById (int $solutionId) | |
| deleteDummySolutionRecord (int $activeId, int $passIndex) | |
| isDummySolutionRecord (array $solutionRecord) | |
| deleteSolutionRecordByValues (int $activeId, int $passIndex, bool $authorized, array $matchValues) | |
| duplicateIntermediateSolutionAuthorized (int $activeId, int $passIndex) | |
| forceExistingIntermediateSolution (int $activeId, int $passIndex, bool $considerDummyRecordCreation) | |
| lookupMaxStep (int $active_id, int $pass) | |
| buildTestPresentationConfig () | |
| build basic test question configuration instance More... | |
Private Attributes | |
| array | $variables |
| array | $results |
| array | $resultunits |
| ilUnitConfigurationRepository | $unitrepository |
Additional Inherited Members | |
| Static Public Member Functions inherited from assQuestion | |
| static | setForcePassResultUpdateEnabled (bool $forcePassResultsUpdateEnabled) |
| static | isForcePassResultUpdateEnabled () |
| static | isAllowedImageMimeType ($mimeType) |
| static | fetchMimeTypeIdentifier (string $contentType) |
| static | getAllowedFileExtensionsForMimeType (string $mimeType) |
| static | isAllowedImageFileExtension (string $mimeType, string $fileExtension) |
| static | getAllowedImageMaterialFileExtensions () |
| static | _getMaximumPoints (int $question_id) |
| Returns the maximum points, a learner can reach answering the question. More... | |
| static | _getQuestionInfo (int $question_id) |
| static | _getSuggestedSolutionCount (int $question_id) |
| static | _getSuggestedSolutionOutput (int $question_id) |
| static | _getReachedPoints (int $active_id, int $question_id, int $pass) |
| static | _updateTestResultCache (int $active_id, ilAssQuestionProcessLocker $processLocker=null) |
| @TODO Move this to a proper place. More... | |
| static | logAction (string $logtext, int $active_id, int $question_id) |
| static | getQuestionTypeFromDb (int $question_id) |
| static | _getTotalRightAnswers (int $a_q_id) |
| static | _getTitle (int $a_q_id) |
| static | _getQuestionText (int $a_q_id) |
| static | isFileAvailable (string $file) |
| static | _getQuestionType (int $question_id) |
| static | _getQuestionTitle (int $question_id) |
| static | saveOriginalId (int $questionId, int $originalId) |
| static | resetOriginalId (int $questionId) |
| static | _getInternalLinkHref (string $target="") |
| static | _getOriginalId (int $question_id) |
| static | originalQuestionExists (int $questionId) |
| static | _instanciateQuestion (int $question_id) |
| static | _instantiateQuestion (int $question_id) |
| static | instantiateQuestion (int $question_id) |
| static | _getSolutionMaxPass (int $question_id, int $active_id) |
| Returns the maximum pass a users question solution. More... | |
| static | _isWriteable (int $question_id, int $user_id) |
| static | _isUsedInRandomTest (int $question_id) |
| static | _isWorkedThrough (int $active_id, int $question_id, int $pass) |
| 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 (int $a_user_id, array $a_question_ids) |
| Checks if an array of question ids is answered by a user or not. More... | |
| static | _setReachedPoints (int $active_id, int $question_id, float $points, float $maxpoints, int $pass, bool $manualscoring, bool $obligationsEnabled) |
| Sets the points, a learner has reached answering the question Additionally objective results are updated. More... | |
| static | _needsManualScoring (int $question_id) |
| static | _includeClass (string $question_type, int $gui=0) |
| static | getFeedbackClassNameByQuestionType (string $questionType) |
| static | isCoreQuestionType (string $questionType) |
| static | includeCoreClass ($questionType, $withGuiClass) |
| static | _getQuestionTypeName ($type_tag) |
| static | _instanciateQuestionGUI (int $question_id) |
| static | instantiateQuestionGUI (int $a_question_id) |
| static | _questionExistsInTest (int $question_id, int $test_id) |
| static | lookupParentObjId (int $questionId) |
| static | lookupOriginalParentObjId (int $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 (int $questionId) |
| static | implodeKeyValues (array $keyValues) |
| static | explodeKeyValues (string $keyValues) |
| static | convertISO8601FormatH_i_s_ExtendedToSeconds (string $time) |
| static | missingResultRecordExists (int $activeId, int $pass, array $questionIds) |
| static | getQuestionsMissingResultRecord (int $activeId, int $pass, array $questionIds) |
| static | lookupResultRecordExist (int $activeId, int $questionId, int $pass) |
| static | extendedTrim (string $value) |
| Trim non-printable characters from the beginning and end of a string. More... | |
| 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 | TRIM_PATTERN = '/^[\p{C}\p{Z}]+|[\p{C}\p{Z}]+$/u' |
| const | ADDITIONAL_CONTENT_EDITING_MODE_RTE = 'default' |
| const | ADDITIONAL_CONTENT_EDITING_MODE_IPE = 'pageobject' |
| ilAssQuestionFeedback | $feedbackOBJ |
| bool | $prevent_rte_usage = false |
| bool | $selfassessmenteditingmode = false |
| int | $defaultnroftries = 0 |
| string | $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 (int $activeId, int $pass, int $questionId) |
| Protected Attributes inherited from assQuestion | |
| const | HAS_SPECIFIC_FEEDBACK = true |
| ILIAS HTTP Services | $http |
| ILIAS Refinery Factory | $refinery |
| ILIAS DI LoggingServices | $ilLog |
| int | $id |
| string | $title |
| string | $comment |
| string | $owner |
| string | $author |
| int | $thumb_size |
| string | $question |
| The question text. More... | |
| float | $points |
| The maximum available points for the question. More... | |
| bool | $shuffle |
| Indicates whether the answers will be shuffled or not. More... | |
| int | $test_id |
| The database id of a test in which the question is contained. More... | |
| int | $obj_id = 0 |
| Object id of the container object. More... | |
| $ilias | |
| ilGlobalPageTemplate | $tpl |
| ilLanguage | $lng |
| ilDBInterface | $db |
| Container | $dic |
| int | $outputType = OUTPUT_JAVASCRIPT |
| Contains the output type of a question. More... | |
| array | $suggested_solutions |
| int | $original_id = null |
| $page | |
| string | $external_id = null |
| ilAssQuestionProcessLocker | $processLocker |
| $step | |
| $lastChange | |
| Transformation | $shuffler |
| ilTestQuestionConfig | $testQuestionConfig |
| ilAssQuestionLifecycle | $lifecycle |
| ilObjUser | $current_user |
| Static Protected Attributes inherited from assQuestion | |
| static | $allowedFileExtensionsByMimeType |
| static | $allowedCharsetsByMimeType |
| static | $allowedImageMaterialFileExtensionsByMimeType |
| static | $forcePassResultsUpdateEnabled = false |
| static | $imageSourceFixReplaceMap |
Detailed Description
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V.
ILIAS is licensed with the GPL-3.0, see https://www.gnu.org/licenses/gpl-3.0.en.html You should have received a copy of said license along with the source code, too.
If this is not the case or you just want to try ILIAS, you'll find us at: https://www.ilias.de https://github.com/ILIAS-eLearning 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 28 of file class.assFormulaQuestion.php.
Constructor & Destructor Documentation
◆ __construct()
| assFormulaQuestion::__construct | ( | string | $title = "", |
| string | $comment = "", |
||
| string | $author = "", |
||
| int | $owner = -1, |
||
| string | $question = "" |
||
| ) |
assQuestion constructor
Reimplemented from assQuestion.
Definition at line 35 of file class.assFormulaQuestion.php.
41 {
43 $this->variables = array();
44 $this->results = array();
45 $this->resultunits = array();
47 }
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
Definition: class.ilUnitConfigurationRepository.php:25
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
◆ addResult()
| assFormulaQuestion::addResult | ( | $result | ) |
Definition at line 90 of file class.assFormulaQuestion.php.
90 : void
91 {
92 $this->results[$result->getResult()] = $result;
93 }
Referenced by loadFromDb(), and parseQuestionText().
Here is the caller graph for this function:
◆ addResultUnit()
| assFormulaQuestion::addResultUnit | ( | $result, | |
| $unit | |||
| ) |
Definition at line 108 of file class.assFormulaQuestion.php.
108 : void
109 {
110 if (is_object($result) && is_object($unit)) {
111 if (!array_key_exists($result->getResult(), $this->resultunits) ||
112 !is_array($this->resultunits[$result->getResult()])) {
113 $this->resultunits[$result->getResult()] = array();
114 }
115 $this->resultunits[$result->getResult()][$unit->getId()] = $unit;
116 }
117 }
Referenced by loadFromDb().
Here is the caller graph for this function:
◆ addResultUnits()
| assFormulaQuestion::addResultUnits | ( | $result, | |
| $unit_ids | |||
| ) |
Definition at line 95 of file class.assFormulaQuestion.php.
95 : void
96 {
97 $this->resultunits[$result->getResult()] = array();
98 if ((!is_object($result)) || (!is_array($unit_ids))) {
99 return;
100 }
104 }
105 }
106 }
getUnitrepository()
Definition: class.assFormulaQuestion.php:1338
References assQuestion\$id, and getUnitrepository().
Here is the call graph for this function:
◆ addVariable()
| assFormulaQuestion::addVariable | ( | $variable | ) |
Definition at line 67 of file class.assFormulaQuestion.php.
67 : void
68 {
69 $this->variables[$variable->getVariable()] = $variable;
70 }
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 858 of file class.assFormulaQuestion.php.
859 {
860 if (is_null($pass)) {
861 $pass = $this->getSolutionMaxPass($active_id);
862 }
863 $solutions = $this->getSolutionValues($active_id, $pass, $authorizedSolution);
864 $user_solution = array();
865 foreach ($solutions as $idx => $solution_value) {
866 if (preg_match("/^(\\\$v\\d+)$/", $solution_value["value1"], $matches)) {
867 $user_solution[$matches[1]] = $solution_value["value2"];
869 $varObj->setValue($solution_value["value2"]);
870 } elseif (preg_match("/^(\\\$r\\d+)$/", $solution_value["value1"], $matches)) {
871 if (!array_key_exists($matches[1], $user_solution)) {
872 $user_solution[$matches[1]] = array();
873 }
874 $user_solution[$matches[1]]["value"] = $solution_value["value2"];
875 } elseif (preg_match("/^(\\\$r\\d+)_unit$/", $solution_value["value1"], $matches)) {
876 if (!array_key_exists($matches[1], $user_solution)) {
877 $user_solution[$matches[1]] = array();
878 }
879 $user_solution[$matches[1]]["unit"] = $solution_value["value2"];
880 }
881 }
882 //vd($this->getResults());
883 $points = 0;
885 //vd($user_solution[$result->getResult()]["value"]);
886 $points += $result->getReachedPoints(
887 $this->getVariables(),
888 $this->getResults(),
889 $user_solution[$result->getResult()]["value"] ?? '',
890 $user_solution[$result->getResult()]["unit"] ?? '',
891 $this->unitrepository->getUnits()
892 );
893 }
894
896 }
getSolutionValues($active_id, $pass=null, bool $authorized=true)
Loads solutions of a given user from the database an returns it.
Definition: class.assQuestion.php:1327
getSolutionMaxPass(int $active_id)
Definition: class.assQuestion.php:2642
References assQuestion\$points, 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 898 of file class.assFormulaQuestion.php.
899 {
900 $user_solution = $previewSession->getParticipantsSolution();
901
902 $points = 0;
904 $v = isset($user_solution[$result->getResult()]) ? $user_solution[$result->getResult()] : null;
905 $u = isset($user_solution[$result->getResult() . '_unit']) ? $user_solution[$result->getResult() . '_unit'] : null;
906
907 $points += $result->getReachedPoints(
908 $this->getVariables(),
909 $this->getResults(),
910 $v,
911 $u,
912 $this->unitrepository->getUnits()
913 );
914 }
915
917
919 }
deductHintPointsFromReachedPoints(ilAssQuestionPreviewSession $previewSession, $reachedPoints)
Definition: class.assQuestion.php:2724
ensureNonNegativePoints($points)
Definition: class.assQuestion.php:2743
getParticipantsSolution()
Definition: class.ilAssQuestionPreviewSession.php:96
References assQuestion\$points, assQuestion\deductHintPointsFromReachedPoints(), assQuestion\ensureNonNegativePoints(), ilAssQuestionPreviewSession\getParticipantsSolution(), getResults(), and getVariables().
Here is the call graph for this function:
◆ canUseAdvancedRating()
| assFormulaQuestion::canUseAdvancedRating | ( | $result | ) |
Check if advanced rating can be used for a result.
This is only possible if there is exactly one possible correct unit for the result, otherwise it is impossible to determine wheather the unit is correct or the value.
- Returns
- boolean True if advanced rating could be used, false otherwise
Definition at line 485 of file class.assFormulaQuestion.php.
485 : bool
486 {
487 $result_units = $this->getResultUnits($result);
488 $resultunit = $result->getUnit();
489 $similar_units = 0;
490 foreach ($result_units as $unit) {
491 if (is_object($resultunit)) {
492 if ($resultunit->getId() != $unit->getId()) {
493 if ($resultunit->getBaseUnit() && $unit->getBaseUnit()) {
494 if ($resultunit->getBaseUnit() == $unit->getBaseUnit()) {
495 return false;
496 }
497 }
498 if ($resultunit->getBaseUnit()) {
499 if ($resultunit->getBaseUnit() == $unit->getId()) {
500 return false;
501 }
502 }
503 if ($unit->getBaseUnit()) {
504 if ($unit->getBaseUnit() == $resultunit->getId()) {
505 return false;
506 }
507 }
508 }
509 }
510 }
511 return true;
512 }
getResultUnits(assFormulaQuestionResult $result)
Definition: class.assFormulaQuestion.php:119
References getResultUnits().
Here is the call graph for this function:
◆ checkForDuplicateResults()
| assFormulaQuestion::checkForDuplicateResults | ( | ) |
Definition at line 179 of file class.assFormulaQuestion.php.
179 : bool
180 {
182 if ((count(array_unique($rmatches[1]))) != count($rmatches[1])) {
183 return false;
184 }
185 }
186 return true;
187 }
References assQuestion\getQuestion().
Here is the call graph for this function:
◆ checkForDuplicateVariables()
| assFormulaQuestion::checkForDuplicateVariables | ( | ) |
Definition at line 169 of file class.assFormulaQuestion.php.
169 : bool
170 {
172 if ((count(array_unique($matches[1]))) != count($matches[1])) {
173 return false;
174 }
175 }
176 return true;
177 }
References assQuestion\getQuestion().
Here is the call graph for this function:
◆ clearResults()
| assFormulaQuestion::clearResults | ( | ) |
Definition at line 72 of file class.assFormulaQuestion.php.
72 : void
73 {
74 $this->results = array();
75 }
Referenced by parseQuestionText().
Here is the caller graph for this function:
◆ clearVariables()
| assFormulaQuestion::clearVariables | ( | ) |
Definition at line 49 of file class.assFormulaQuestion.php.
49 : void
50 {
51 $this->variables = array();
52 }
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 776 of file class.assFormulaQuestion.php.
776 : int
777 {
779 throw new RuntimeException('The question has not been saved. It cannot be duplicated');
780 }
781 // duplicate the question in database
782 $clone = $this;
783 include_once("./Modules/TestQuestionPool/classes/class.assQuestion.php");
785 $clone->id = -1;
786 $source_questionpool_id = $this->getObjId();
787 $clone->setObjId($target_questionpool_id);
789 $clone->setTitle($title);
790 }
791 $clone->saveToDb();
792
793 $clone->unitrepository->cloneUnits($original_id, $clone->getId());
794
795 // copy question page content
796 $clone->copyPageOfQuestion($original_id);
797 // copy XHTML media objects
798 $clone->copyXHTMLMediaObjectsOfQuestion($original_id);
799
800 $clone->onCopy($source_questionpool_id, $original_id, $clone->getObjId(), $clone->getId());
801
802 return $clone->id;
803 }
static _getOriginalId(int $question_id)
Definition: class.assQuestion.php:2470
References assQuestion\$original_id, assQuestion\$title, assQuestion\_getOriginalId(), assQuestion\getId(), and assQuestion\getObjId().
Here is the call graph for this function:
◆ createNewOriginalFromThisDuplicate()
| assFormulaQuestion::createNewOriginalFromThisDuplicate | ( | $targetParentId, | |
$targetQuestionTitle = "" |
|||
| ) |
Definition at line 805 of file class.assFormulaQuestion.php.
805 : int
806 {
808 throw new RuntimeException('The question has not been saved. It cannot be duplicated');
809 }
810
811 include_once("./Modules/TestQuestionPool/classes/class.assQuestion.php");
812
813 $sourceQuestionId = $this->id;
814 $sourceParentId = $this->getObjId();
815
816 // duplicate the question in database
817 $clone = $this;
818 $clone->id = -1;
819
820 $clone->setObjId($targetParentId);
821
822 if ($targetQuestionTitle) {
823 $clone->setTitle($targetQuestionTitle);
824 }
825
826 $clone->saveToDb();
827 // copy question page content
828 $clone->copyPageOfQuestion($sourceQuestionId);
829 // copy XHTML media objects
830 $clone->copyXHTMLMediaObjectsOfQuestion($sourceQuestionId);
831
832 $clone->onCopy($sourceParentId, $sourceQuestionId, $clone->getObjId(), $clone->getId());
833
834 return $clone->id;
835 }
References assQuestion\$id, assQuestion\getId(), 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
Definition at line 1162 of file class.assFormulaQuestion.php.
1162 : void
1163 {
1164 global $DIC;
1166
1167 $affectedRows = $ilDB->manipulateF(
1168 "DELETE FROM il_qpl_qst_fq_var WHERE question_fi = %s",
1169 array('integer'),
1170 array($question_id)
1171 );
1172
1173 $affectedRows = $ilDB->manipulateF(
1174 "DELETE FROM il_qpl_qst_fq_res WHERE question_fi = %s",
1175 array('integer'),
1176 array($question_id)
1177 );
1178
1179 $affectedRows = $ilDB->manipulateF(
1180 "DELETE FROM il_qpl_qst_fq_res_unit WHERE question_fi = %s",
1181 array('integer'),
1182 array($question_id)
1183 );
1184
1185 $affectedRows = $ilDB->manipulateF(
1186 "DELETE FROM il_qpl_qst_fq_ucat WHERE question_fi = %s",
1187 array('integer'),
1188 array($question_id)
1189 );
1190
1191 $affectedRows = $ilDB->manipulateF(
1192 "DELETE FROM il_qpl_qst_fq_unit WHERE question_fi = %s",
1193 array('integer'),
1194 array($question_id)
1195 );
1196 }
◆ duplicate()
| assFormulaQuestion::duplicate | ( | bool | $for_test = true, |
| string | $title = "", |
||
| string | $author = "", |
||
| string | $owner = "", |
||
$testObjId = null |
|||
| ) |
Duplicates an assFormulaQuestion @access public.
Reimplemented from assQuestion.
Definition at line 725 of file class.assFormulaQuestion.php.
725 : int
726 {
727 if ($this->id <= 0) {
728 // The question has not been saved. It cannot be duplicated
729 return -1;
730 }
731 // duplicate the question in database
732 $this_id = $this->getId();
733 $thisObjId = $this->getObjId();
734
735 $clone = $this;
736 include_once("./Modules/TestQuestionPool/classes/class.assQuestion.php");
738 $clone->id = -1;
739
740 if ((int) $testObjId > 0) {
741 $clone->setObjId($testObjId);
742 }
743
745 $clone->setTitle($title);
746 }
747
749 $clone->setAuthor($author);
750 }
752 $clone->setOwner($owner);
753 }
754
755 if ($for_test) {
756 $clone->saveToDb($original_id);
757 } else {
758 $clone->saveToDb();
759 }
760
761 $clone->unitrepository->cloneUnits($this_id, $clone->getId());
762
763 // copy question page content
764 $clone->copyPageOfQuestion($this_id);
765 // copy XHTML media objects
766 $clone->copyXHTMLMediaObjectsOfQuestion($this_id);
767 $clone->onDuplicate($thisObjId, $this_id, $clone->getObjId(), $clone->getId());
768
769 return $clone->id;
770 }
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 193 of file class.assFormulaQuestion.php.
193 : array
194 {
195 $resObjects = array();
196 $matches = null;
197
198 if (preg_match_all("/(\\\$r\\d+)/ims", $questionText, $matches)) {
199 foreach ($matches[1] as $resultKey) {
200 $resObjects[] = $this->getResult($resultKey);
201 }
202 }
203
204 return $resObjects;
205 }
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 211 of file class.assFormulaQuestion.php.
211 : array
212 {
213 $varObjects = array();
214 $matches = null;
215
216 if (preg_match_all("/(\\\$v\\d+)/ims", $questionText, $matches)) {
217 foreach ($matches[1] as $variableKey) {
218 $varObjects[] = $this->getVariable($variableKey);
219 }
220 }
221
222 return $varObjects;
223 }
References getVariable().
Referenced by getInitialVariableSolutionValues(), hasRequiredVariableSolutionValues(), and substituteVariables().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ generateResultInputHTML()
|
protected |
Definition at line 465 of file class.assFormulaQuestion.php.
465 : string
466 {
467 if ($forsolution) {
468 return '<span class="ilc_qinput_TextInput solutionbox">'
469 . ilLegacyFormElementsUtil::prepareFormOutput($result_value)
470 . '</span>';
471 }
472 $input = '<input class="ilc_qinput_TextInput" type="text"';
473 $input .= 'spellcheck="false" autocomplete="off" autocorrect="off" autocapitalize="off"';
474 $input .= 'name="result_' . $result_key . '"';
475 $input .= ' value="' . $result_value . '"/>';
476 return $input;
477 }
static prepareFormOutput($a_str, bool $a_strip=false)
Definition: class.ilLegacyFormElementsUtil.php:38
References ilLegacyFormElementsUtil\prepareFormOutput().
Referenced by 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 1143 of file class.assFormulaQuestion.php.
1143 : string
1144 {
1145 return "";
1146 }
◆ getAllResultUnits()
| assFormulaQuestion::getAllResultUnits | ( | ) |
Definition at line 134 of file class.assFormulaQuestion.php.
134 : array
135 {
137 }
References $resultunits.
◆ 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 1152 of file class.assFormulaQuestion.php.
1152 : string
1153 {
1154 return "";
1155 }
◆ 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 1468 of file class.assFormulaQuestion.php.
1469 {
1472 } else {
1474 }
1475 }
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 1246 of file class.assFormulaQuestion.php.
1246 : array
1247 {
1248 $user_solution = array();
1249
1250 foreach ($solutions as $idx => $solution_value) {
1251 if (preg_match("/^(\\\$v\\d+)$/", $solution_value["value1"], $matches)) {
1252 $user_solution[$matches[1]] = $solution_value["value2"];
1253 $varObj = $this->getVariable($matches[1]);
1254 $varObj->setValue($solution_value["value2"]);
1255 } elseif (preg_match("/^(\\\$r\\d+)$/", $solution_value["value1"], $matches)) {
1256 if (!array_key_exists($matches[1], $user_solution)) {
1257 $user_solution[$matches[1]] = array();
1258 }
1259 $user_solution[$matches[1]]["value"] = $solution_value["value2"];
1260 } elseif (preg_match("/^(\\\$r\\d+)_unit$/", $solution_value["value1"], $matches)) {
1261 if (!array_key_exists($matches[1], $user_solution)) {
1262 $user_solution[$matches[1]] = array();
1263 }
1264 $user_solution[$matches[1]]["unit"] = $solution_value["value2"];
1265 }
1266 }
1268 $resVal = $result->calculateFormula($this->getVariables(), $this->getResults(), parent::getId(), false);
1269
1270 if (is_object($result->getUnit())) {
1271 $user_solution[$result->getResult()]["unit"] = $result->getUnit()->getId();
1272 $user_solution[$result->getResult()]["value"] = $resVal;
1273 } elseif ($result->getUnit() == null) {
1274 $unit_factor = 1;
1275 // there is no fix result_unit, any "available unit" is accepted
1276
1277 $available_units = $result->getAvailableResultUnits(parent::getId());
1278 $result_name = $result->getResult();
1279
1280 $check_unit = false;
1281 if (array_key_exists($result_name, $available_units) &&
1282 $available_units[$result_name] !== null) {
1283 $check_unit = in_array($user_solution[$result_name]['unit'], $available_units[$result_name]);
1284 }
1285
1286 if ($check_unit == true) {
1287 //get unit-factor
1289 }
1290
1291 try {
1294 $user_solution[$result->getResult()]["value"] = 0;
1295 }
1296 }
1298 || $result->getResultType() == assFormulaQuestionResult::RESULT_FRAC) {
1299 $value = assFormulaQuestionResult::convertDecimalToCoprimeFraction($resVal);
1300 if (is_array($value)) {
1301 $user_solution[$result->getResult()]["value"] = $value[0];
1302 $user_solution[$result->getResult()]["frac_helper"] = $value[1];
1303 } else {
1304 $user_solution[$result->getResult()]["value"] = $value;
1305 $user_solution[$result->getResult()]["frac_helper"] = null;
1306 }
1307 } else {
1308 $user_solution[$result->getResult()]["value"] = round($user_solution[$result->getResult()]["value"], $result->getPrecision());
1309 /*
1310 $user_solution[$result->getResult()]["value"] = ilMath::_div(
1311 $user_solution[$result->getResult()]["value"],
1312 1,
1313 $result->getPrecision()
1314 );
1315 */
1316 }
1317 }
1318 return $user_solution;
1319 }
const RESULT_CO_FRAC
Definition: class.assFormulaQuestionResult.php:30
const RESULT_FRAC
Definition: class.assFormulaQuestionResult.php:29
static convertDecimalToCoprimeFraction($decimal_value, $tolerance=1.e-9)
Definition: class.assFormulaQuestionResult.php:847
static lookupUnitFactor(int $a_unit_id)
Definition: class.assFormulaQuestionUnit.php:135
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
Definition: class.ilMathDivisionByZeroException.php:26
References ilMath\_div(), assFormulaQuestionResult\convertDecimalToCoprimeFraction(), ILIAS\Survey\Mode\getId(), 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 1406 of file class.assFormulaQuestion.php.
1406 : array
1407 {
1408 return array(
1412 );
1413 }
const PercentageResultExpression
Definition: interface.iQuestionCondition.php:28
const NumericResultExpression
Definition: interface.iQuestionCondition.php:29
const EmptyAnswerExpression
Definition: interface.iQuestionCondition.php:34
References iQuestionCondition\EmptyAnswerExpression, iQuestionCondition\NumericResultExpression, and iQuestionCondition\PercentageResultExpression.
◆ getInitialVariableSolutionValues()
| assFormulaQuestion::getInitialVariableSolutionValues | ( | ) |
- Returns
- array $initialVariableSolutionValues
Definition at line 247 of file class.assFormulaQuestion.php.
247 : array
248 {
251 }
252
253 $variableSolutionValues = array();
254
256 $variableSolutionValues[$varObj->getVariable()] = $varObj->getValue();
257 }
258
259 return $variableSolutionValues;
260 }
fetchAllVariables($questionText)
Definition: class.assFormulaQuestion.php:211
fetchAllResults($questionText)
Definition: class.assFormulaQuestion.php:193
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 841 of file class.assFormulaQuestion.php.
841 : float
842 {
843 $points = 0;
844 foreach ($this->results as $result) {
845 $points += $result->getPoints();
846 }
848 }
References assQuestion\$points.
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 1397 of file class.assFormulaQuestion.php.
1397 : array
1398 {
1400 }
static getOperatorsByExpression($expression)
Definition: class.ilOperatorsExpressionMapping.php:47
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 1134 of file class.assFormulaQuestion.php.
1134 : string
1135 {
1136 return "assFormulaQuestion";
1137 }
◆ getResult()
| assFormulaQuestion::getResult | ( | $result | ) |
Definition at line 82 of file class.assFormulaQuestion.php.
83 {
84 if (array_key_exists($result, $this->results)) {
85 return $this->results[$result];
86 }
87 return null;
88 }
Referenced by fetchAllResults(), getAvailableAnswerOptions(), loadFromDb(), and substituteVariables().
Here is the caller graph for this function:
◆ getResults()
| assFormulaQuestion::getResults | ( | ) |
Definition at line 77 of file class.assFormulaQuestion.php.
77 : array
78 {
80 }
References $results.
Referenced by calculateReachedPoints(), calculateReachedPointsFromPreviewSession(), getAvailableAnswerOptions(), getBestSolution(), getInitialVariableSolutionValues(), getSolutionSubmit(), and substituteVariables().
Here is the caller graph for this function:
◆ getResultUnits()
| assFormulaQuestion::getResultUnits | ( | assFormulaQuestionResult | $result | ) |
Definition at line 119 of file class.assFormulaQuestion.php.
119 : array
120 {
122 return [];
123 }
124
125 $result_units = $this->resultunits[$result->getResult()];
126
129 });
130
131 return $result_units;
132 }
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
Definition: class.assFormulaQuestionUnit.php:27
$a
thx to https://mlocati.github.io/php-cs-fixer-configurator for the examples
Definition: example_cleaned.php:49
References Vendor\Package\$a, Vendor\Package\$b, and assFormulaQuestionResult\getResult().
Referenced by canUseAdvancedRating(), saveToDb(), and substituteVariables().
Here is the call graph for this function:
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 1202 of file class.assFormulaQuestion.php.
1202 : string
1203 {
1204 $text = parent::getRTETextWithMediaObjects();
1205 return $text;
1206 }
◆ getSolutionSubmit()
|
protected |
- Returns
- array
Definition at line 1346 of file class.assFormulaQuestion.php.
1346 : array
1347 {
1348 $solutionSubmit = [];
1349
1350 $post = $this->dic->http()->wrapper()->post();
1351
1355 $value = $post->retrieve(
1356 $key,
1357 $this->dic->refinery()->kindlyTo()->string()
1358 );
1359
1360 $solutionSubmit[$key] = $value;
1361 }
1363 $value = $post->retrieve(
1365 $this->dic->refinery()->kindlyTo()->string()
1366 );
1368 }
1369 }
1370 return $solutionSubmit;
1371 }
References Vendor\Package\$a, $index, ILIAS\LTI\ToolProvider\$key, $post, and getResults().
Referenced by savePreviewData(), saveWorkingData(), and validateSolutionSubmit().
Here is the call graph for this function:
Here is the caller graph for this function:
◆ getUnitrepository()
| assFormulaQuestion::getUnitrepository | ( | ) |
- Returns
- \ilUnitConfigurationRepository
Definition at line 1338 of file class.assFormulaQuestion.php.
1339 {
1341 }
ilUnitConfigurationRepository $unitrepository
Definition: class.assFormulaQuestion.php:33
References $unitrepository.
Referenced by addResultUnits(), loadFromDb(), setExportDetailsXLS(), and substituteVariables().
Here is the caller graph for this function:
◆ getVariable()
| assFormulaQuestion::getVariable | ( | $variable | ) |
Definition at line 59 of file class.assFormulaQuestion.php.
60 {
61 if (array_key_exists($variable, $this->variables)) {
62 return $this->variables[$variable];
63 }
64 return null;
65 }
Referenced by calculateReachedPoints(), fetchAllVariables(), getBestSolution(), and setExportDetailsXLS().
Here is the caller graph for this function:
◆ getVariables()
| assFormulaQuestion::getVariables | ( | ) |
Definition at line 54 of file class.assFormulaQuestion.php.
54 : array
55 {
57 }
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 229 of file class.assFormulaQuestion.php.
229 : bool
230 {
232 if (!isset($userSolution[$varObj->getVariable()])) {
233 return false;
234 }
235
236 if (!strlen($userSolution[$varObj->getVariable()])) {
237 return false;
238 }
239 }
240
241 return true;
242 }
References fetchAllVariables(), and assQuestion\getQuestion().
Here is the call graph for this function:
◆ hasResultUnit()
| assFormulaQuestion::hasResultUnit | ( | $result, | |
| $unit_id | |||
| ) |
Definition at line 139 of file class.assFormulaQuestion.php.
139 : bool
140 {
141 if (array_key_exists($result->getResult(), $this->resultunits)) {
142 if (array_key_exists($unit_id, $this->resultunits[$result->getResult()])) {
143 return true;
144 }
145 }
146
147 return false;
148 }
◆ isComplete()
| assFormulaQuestion::isComplete | ( | ) |
Returns true, if the question is complete for use.
- Returns
- boolean True, if the single choice question is complete for use, otherwise false
Reimplemented from assQuestion.
Definition at line 518 of file class.assFormulaQuestion.php.
518 : bool
519 {
520 if (($this->title) and ($this->author) and ($this->question) and ($this->getMaximumPoints() > 0)) {
521 return true;
522 } else {
523 return false;
524 }
525 }
getMaximumPoints()
Returns the maximum points, a learner can reach answering the question.
Definition: class.assFormulaQuestion.php:841
References getMaximumPoints().
Here is the call graph for this function:
◆ isValidSolutionResultValue()
|
protected |
Definition at line 921 of file class.assFormulaQuestion.php.
921 : bool
922 {
923 $submittedValue = str_replace(',', '.', $submittedValue);
924
925 if (is_numeric($submittedValue)) {
926 return true;
927 }
928
929 if (preg_match('/^[-+]{0,1}\d+\/\d+$/', $submittedValue)) {
930 return true;
931 }
932
933 return false;
934 }
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
Definition at line 636 of file class.assFormulaQuestion.php.
636 : void
637 {
638 global $DIC;
640
641 $result = $ilDB->queryF(
642 "SELECT qpl_questions.* FROM qpl_questions WHERE question_id = %s",
643 array('integer'),
644 array($question_id)
645 );
646 if ($result->numRows() == 1) {
648 $this->setId($question_id);
651 //$this->setSuggestedSolution($data["solution_hint"]);
657
658 try {
662 }
663
664 try {
667 }
668
670
671 include_once("./Services/RTE/classes/class.ilRTE.php");
673
674 // load variables
675 $result = $ilDB->queryF(
676 "SELECT * FROM il_qpl_qst_fq_var WHERE question_fi = %s",
677 array('integer'),
678 array($question_id)
679 );
680 if ($result->numRows() > 0) {
682 $varObj = new assFormulaQuestionVariable($data["variable"], $data["range_min"], $data["range_max"], $this->getUnitrepository()->getUnit($data["unit_fi"]), $data["varprecision"], $data["intprecision"]);
685 $this->addVariable($varObj);
686 }
687 }
688 // load results
689 $result = $ilDB->queryF(
690 "SELECT * FROM il_qpl_qst_fq_res WHERE question_fi = %s",
691 array('integer'),
692 array($question_id)
693 );
694 if ($result->numRows() > 0) {
696 $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"]);
700 $this->addResult($resObj);
701 }
702 }
703
704 // load result units
705 $result = $ilDB->queryF(
706 "SELECT * FROM il_qpl_qst_fq_res_unit WHERE question_fi = %s",
707 array('integer'),
708 array($question_id)
709 );
710 if ($result->numRows() > 0) {
714 $this->addResultUnit($resObj, $unit);
715 }
716 }
717 }
718 parent::loadFromDb($question_id);
719 }
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
Definition: class.assFormulaQuestionResult.php:26
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
Definition: class.assFormulaQuestionVariable.php:25
addResultUnit($result, $unit)
Definition: class.assFormulaQuestion.php:108
setAdditionalContentEditingMode(?string $additionalContentEditingMode)
Definition: class.assQuestion.php:3551
setLifecycle(ilAssQuestionLifecycle $lifecycle)
Definition: class.assQuestion.php:628
static getDraftInstance()
Definition: class.ilAssQuestionLifecycle.php:149
static getInstance($identifier)
Definition: class.ilAssQuestionLifecycle.php:140
static _replaceMediaObjectImageSrc(string $a_text, int $a_direction=0, string $nic='')
Replaces image source from mob image urls with the mob id or replaces mob id with the correct image s...
Definition: class.ilRTE.php:177
References $data, $DIC, Vendor\Package\$e, $ilDB, ilRTE\_replaceMediaObjectImageSrc(), addResult(), addResultUnit(), addVariable(), ilAssQuestionLifecycle\getDraftInstance(), ilAssQuestionLifecycle\getInstance(), getResult(), getUnitrepository(), assQuestion\setAdditionalContentEditingMode(), assQuestion\setAuthor(), assQuestion\setComment(), setId(), assQuestion\setLifecycle(), assQuestion\setObjId(), assQuestion\setOriginalId(), assQuestion\setOwner(), assQuestion\setPoints(), assQuestion\setQuestion(), and assQuestion\setTitle().
Here is the call graph for this function:
◆ lookupForExistingSolutions()
| assFormulaQuestion::lookupForExistingSolutions | ( | int | $activeId, |
| int | $pass | ||
| ) |
Lookup if an authorized or intermediate solution exists.
- Parameters
-
int $activeId int $pass
- Returns
- array ['authorized' => bool, 'intermediate' => bool]
Reimplemented from assQuestion.
Definition at line 1043 of file class.assFormulaQuestion.php.
1043 : array
1044 {
1045 global $DIC;
1047
1048 $return = array(
1049 'authorized' => false,
1050 'intermediate' => false
1051 );
1052
1054 SELECT authorized, COUNT(*) cnt
1055 FROM tst_solutions
1059 AND value1 like '\$r%'
1060 AND value2 is not null
1061 AND value2 <> ''
1062 ";
1063
1066 }
1067
1069 GROUP BY authorized
1070 ";
1071
1073
1075 if ($row['authorized']) {
1076 $return['authorized'] = $row['cnt'] > 0;
1077 } else {
1078 $return['intermediate'] = $row['cnt'] > 0;
1079 }
1080 }
1081 return $return;
1082 }
References $DIC, $ilDB, $query, assQuestion\getId(), and assQuestion\getStep().
Here is the call graph for this function:
◆ parseQuestionText()
| assFormulaQuestion::parseQuestionText | ( | ) |
Definition at line 150 of file class.assFormulaQuestion.php.
150 : void
151 {
152 $this->clearResults();
153 $this->clearVariables();
155 foreach ($matches[1] as $variable) {
157 $this->addVariable($varObj);
158 }
159 }
160
162 foreach ($rmatches[1] as $result) {
164 $this->addResult($resObj);
165 }
166 }
167 }
References addResult(), addVariable(), clearResults(), clearVariables(), and assQuestion\getQuestion().
Here is the call graph for this function:
◆ removeExistingSolutions()
| assFormulaQuestion::removeExistingSolutions | ( | int | $activeId, |
| int | $pass | ||
| ) |
Remove an existing solution without removing the variables.
- Parameters
-
int $activeId int $pass
- Returns
- int
Reimplemented from assQuestion.
Definition at line 1092 of file class.assFormulaQuestion.php.
1092 : int
1093 {
1094 global $DIC;
1096
1098 DELETE FROM tst_solutions
1102 AND value1 like '\$r%'
1103 ";
1104
1107 }
1108
1110 }
References $DIC, $ilDB, $query, assQuestion\getId(), and assQuestion\getStep().
Here is the call graph for this function:
◆ savePreviewData()
|
protected |
Reimplemented from assQuestion.
Definition at line 1113 of file class.assFormulaQuestion.php.
1113 : void
1114 {
1115 $userSolution = $previewSession->getParticipantsSolution();
1116
1118 $matches = null;
1119
1121 $userSolution[$matches[1]] = $val;
1123 $userSolution[$matches[1] . "_unit"] = $val;
1124 }
1125 }
1126
1127 $previewSession->setParticipantsSolution($userSolution);
1128 }
getSolutionSubmit()
Definition: class.assFormulaQuestion.php:1346
setParticipantsSolution($participantSolution)
Definition: class.ilAssQuestionPreviewSession.php:91
References ILIAS\LTI\ToolProvider\$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.
Definition at line 531 of file class.assFormulaQuestion.php.
531 : void
532 {
533 global $DIC;
535
537 $this->saveQuestionDataToDb();
538 } else {
540 }
541
542 // save variables
543 $affectedRows = $ilDB->manipulateF(
544 "
545 DELETE FROM il_qpl_qst_fq_var
546 WHERE question_fi = %s",
547 array("integer"),
548 array($this->getId())
549 );
550
551 foreach ($this->variables as $variable) {
553 $ilDB->insert(
554 'il_qpl_qst_fq_var',
555 array(
556 'variable_id' => array('integer', $next_id),
558 'variable' => array('text', $variable->getVariable()),
559 'range_min' => array('float', ((strlen($variable->getRangeMin())) ? $variable->getRangeMin() : 0.0)),
560 'range_max' => array('float', ((strlen($variable->getRangeMax())) ? $variable->getRangeMax() : 0.0)),
561 'unit_fi' => array('integer', (is_object($variable->getUnit()) ? (int) $variable->getUnit()->getId() : 0)),
562 'varprecision' => array('integer', (int) $variable->getPrecision()),
563 'intprecision' => array('integer', (int) $variable->getIntprecision()),
564 'range_min_txt' => array('text', $variable->getRangeMinTxt()),
565 'range_max_txt' => array('text', $variable->getRangeMaxTxt())
566 )
567 );
568 }
569 // save results
570 $affectedRows = $ilDB->manipulateF(
571 "DELETE FROM il_qpl_qst_fq_res WHERE question_fi = %s",
572 array("integer"),
573 array($this->getId())
574 );
575
576 foreach ($this->results as $result) {
578 if (is_object($result->getUnit())) {
579 $tmp_result_unit = $result->getUnit()->getId();
580 } else {
581 $tmp_result_unit = null;
582 }
583
584 $formula = str_replace(",", ".", $result->getFormula());
585
587 "result_id" => array("integer", $next_id),
589 "result" => array("text", $result->getResult()),
590 "range_min" => array("float", ((strlen($result->getRangeMin())) ? $result->getRangeMin() : 0)),
591 "range_max" => array("float", ((strlen($result->getRangeMax())) ? $result->getRangeMax() : 0)),
592 "tolerance" => array("float", ((strlen($result->getTolerance())) ? $result->getTolerance() : 0)),
593 "unit_fi" => array("integer", (int) $tmp_result_unit),
594 "formula" => array("clob", $formula),
595 "resprecision" => array("integer", $result->getPrecision()),
596 "rating_simple" => array("integer", ($result->getRatingSimple()) ? 1 : 0),
597 "rating_sign" => array("float", ($result->getRatingSimple()) ? 0 : $result->getRatingSign()),
598 "rating_value" => array("float", ($result->getRatingSimple()) ? 0 : $result->getRatingValue()),
599 "rating_unit" => array("float", ($result->getRatingSimple()) ? 0 : $result->getRatingUnit()),
600 "points" => array("float", $result->getPoints()),
601 "result_type" => array('integer', (int) $result->getResultType()),
602 "range_min_txt" => array("text", $result->getRangeMinTxt()),
603 "range_max_txt" => array("text", $result->getRangeMaxTxt())
604
605 ));
606 }
607 // save result units
608 $affectedRows = $ilDB->manipulateF(
609 "DELETE FROM il_qpl_qst_fq_res_unit WHERE question_fi = %s",
610 array("integer"),
611 array($this->getId())
612 );
613 foreach ($this->results as $result) {
616 $affectedRows = $ilDB->manipulateF(
617 "INSERT INTO il_qpl_qst_fq_res_unit (result_unit_id, question_fi, result, unit_fi) VALUES (%s, %s, %s, %s)",
618 array('integer', 'integer', 'text', 'integer'),
619 array(
620 $next_id,
621 $this->getId(),
622 $result->getResult(),
623 $unit->getId()
624 )
625 );
626 }
627 }
628
629 parent::saveToDb();
630 }
saveQuestionDataToDb(int $original_id=-1)
Definition: class.assQuestion.php:2005
References $DIC, $ilDB, assQuestion\$original_id, 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
Definition at line 943 of file class.assFormulaQuestion.php.
943 : bool
944 {
945 global $DIC;
947
948 if (is_null($pass)) {
949 include_once "./Modules/Test/classes/class.ilObjTest.php";
950 $pass = ilObjTest::_getPass($active_id);
951 }
952
953 $entered_values = false;
954
955 $this->getProcessLocker()->executeUserSolutionUpdateLockOperation(function () use (&$entered_values, $ilDB, $active_id, $pass, $authorized) {
956 $solutionSubmit = $this->getSolutionSubmit();
958 $matches = null;
960 if (strlen($value)) {
961 $entered_values = true;
962 }
963
964 $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]);
965
968 }
969
970 $result = $ilDB->queryF(
971 $queryResult,
972 array('integer', 'integer', 'integer', 'integer'),
974 );
975 if ($result->numRows()) {
977 $ilDB->manipulateF(
978 "DELETE FROM tst_solutions WHERE solution_id = %s AND authorized = %s",
979 array('integer', 'integer'),
980 array($row['solution_id'], (int) $authorized)
981 );
982 }
983 }
984
985 $this->saveCurrentSolution($active_id, $pass, $matches[1], str_replace(",", ".", $value), $authorized);
987 $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");
988
991 }
992
993 $result = $ilDB->queryF(
994 $queryResultUnit,
995 array('integer', 'integer', 'integer', 'integer'),
997 );
998 if ($result->numRows()) {
1000 $ilDB->manipulateF(
1001 "DELETE FROM tst_solutions WHERE solution_id = %s AND authorized = %s",
1002 array('integer', 'integer'),
1003 array($row['solution_id'], (int) $authorized)
1004 );
1005 }
1006 }
1007
1009 }
1010 }
1011 });
1012
1013 if ($entered_values) {
1014 include_once("./Modules/Test/classes/class.ilObjAssessmentFolder.php");
1017 "assessment",
1018 "log_user_entered_values",
1020 ), $active_id, $this->getId());
1021 }
1022 } else {
1023 include_once("./Modules/Test/classes/class.ilObjAssessmentFolder.php");
1026 "assessment",
1027 "log_user_not_entered_values",
1029 ), $active_id, $this->getId());
1030 }
1031 }
1032
1033 return true;
1034 }
static logAction(string $logtext, int $active_id, int $question_id)
Definition: class.assQuestion.php:1199
saveCurrentSolution(int $active_id, int $pass, $value1, $value2, bool $authorized=true, $tstamp=0)
Definition: class.assQuestion.php:3729
static _getLogLanguage()
Definition: class.ilObjAssessmentFolder.php:114
static _enabledAssessmentLogging()
Definition: class.ilObjAssessmentFolder.php:72
static _getPass($active_id)
Retrieves the actual pass of a given user for a given test.
Definition: class.ilObjTest.php:7225
References $DIC, $ilDB, ILIAS\LTI\ToolProvider\$key, ilObjAssessmentFolder\_enabledAssessmentLogging(), ilObjAssessmentFolder\_getLogLanguage(), ilObjTest\_getPass(), assQuestion\getId(), assQuestion\getProcessLocker(), getSolutionSubmit(), assQuestion\getStep(), ILIAS\Repository\lng(), assQuestion\logAction(), and assQuestion\saveCurrentSolution().
Here is the call graph for this function:
◆ setExportDetailsXLS()
| assFormulaQuestion::setExportDetailsXLS | ( | ilAssExcelFormatHelper | $worksheet, |
| int | $startrow, | ||
| int | $active_id, | ||
| int | $pass | ||
| ) |
{}
Reimplemented from assQuestion.
Definition at line 1211 of file class.assFormulaQuestion.php.
1211 : int
1212 {
1213 parent::setExportDetailsXLS($worksheet, $startrow, $active_id, $pass);
1214
1215 $solution = $this->getSolutionValues($active_id, $pass);
1216
1217 $i = 1;
1218 foreach ($solution as $solutionvalue) {
1221 if (strpos($solutionvalue["value1"], "_unit")) {
1223 if (is_object($unit)) {
1225 }
1226 } else {
1228 }
1229 if (preg_match("/(\\\$v\\d+)/", $solutionvalue["value1"], $matches)) {
1231 if (is_object($var) && (is_object($var->getUnit()))) {
1233 }
1234 }
1235 $i++;
1236 }
1237
1239 }
setCell($a_row, $a_col, $a_value, $datatype=null)
Definition: class.ilAssExcelFormatHelper.php:70
References $i, ilExcel\getColumnCoord(), assQuestion\getSolutionValues(), getUnitrepository(), getVariable(), ilExcel\setBold(), and ilAssExcelFormatHelper\setCell().
Here is the call graph for this function:
◆ setId()
| assFormulaQuestion::setId | ( | $id = -1 | ) |
Definition at line 1321 of file class.assFormulaQuestion.php.
1321 : void
1322 {
1323 parent::setId($id);
1324 $this->unitrepository->setConsumerId($this->getId());
1325 }
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 1330 of file class.assFormulaQuestion.php.
References $unitrepository.
◆ substituteVariables()
| assFormulaQuestion::substituteVariables | ( | array | $userdata, |
| bool | $graphicalOutput = false, |
||
| bool | $forsolution = false, |
||
| bool | $result_output = false, |
||
| array | $correctness_icons = [] |
||
| ) |
- Parameters
-
int[] $selections string[] $correctness_icons
- Returns
- bool|mixed|string
Definition at line 267 of file class.assFormulaQuestion.php.
268 {
269 if ((count($this->results) == 0) && (count($this->variables) == 0)) {
270 return false;
271 }
272
273 $text = $this->getQuestion();
274
276 if (isset($userdata[$varObj->getVariable()]) && strlen($userdata[$varObj->getVariable()])) {
277 $varObj->setValue($userdata[$varObj->getVariable()]);
278 }
279
280 $unit = (is_object($varObj->getUnit())) ? $varObj->getUnit()->getUnit() : "";
281 $val = (strlen($varObj->getValue()) > 8) ? strtoupper(sprintf("%e", $varObj->getValue())) : $varObj->getValue();
282
283 $text = preg_replace("/\\$" . substr($varObj->getVariable(), 1) . "(?![0-9]+)/", $val . " " . $unit . "\\1", $text);
284 }
285
286 $text = $this->purifyAndPrepareTextAreaOutput($text);
287
289 foreach ($rmatches[1] as $result) {
290 $resObj = $this->getResult($result);
291 $value = "";
292 $frac_helper = '';
293 $userdata[$result]['result_type'] = $resObj->getResultType();
294 $is_frac = false;
295 if (
296 $resObj->getResultType() == assFormulaQuestionResult::RESULT_FRAC ||
297 $resObj->getResultType() == assFormulaQuestionResult::RESULT_CO_FRAC
298 ) {
299 $is_frac = true;
300 }
301 if (is_array($userdata) &&
302 isset($userdata[$result]) &&
303 isset($userdata[$result]["value"])) {
304
306 } elseif ($forsolution) {
307 $value = '';
308 if (!is_array($userdata)) {
309 $value = $resObj->calculateFormula($this->getVariables(), $this->getResults(), parent::getId());
310 $value = sprintf("%." . $resObj->getPrecision() . "f", $value);
311 }
312
313 if ($is_frac) {
314 $value = assFormulaQuestionResult::convertDecimalToCoprimeFraction($value);
315 if (is_array($value)) {
316 $frac_helper = $value[1];
317 $value = $value[0];
318 }
319 }
320
322 } else {
324 }
325
326 $units = "";
327 $result_units = $this->getResultUnits($resObj);
328 if (count($result_units) > 0) {
329 if ($forsolution) {
330 if (is_array($userdata)) {
331 foreach ($result_units as $unit) {
332 if (isset($userdata[$result]["unit"]) && $userdata[$result]["unit"] == $unit->getId()) {
333 $units = $unit->getUnit();
334 }
335 }
336 } else {
337 if ($resObj->getUnit()) {
338 $units = $resObj->getUnit()->getUnit();
339 }
340 }
341 } else {
342 $units = '<select name="result_' . $result . '_unit">';
344 foreach ($result_units as $unit) {
345 $units .= '<option value="' . $unit->getId() . '"';
346 if (array_key_exists($result, $userdata) &&
347 is_array($userdata[$result]) &&
348 array_key_exists('unit', $userdata[$result])) {
349 if ($userdata[$result]["unit"] == $unit->getId()) {
350 $units .= ' selected="selected"';
351 }
352 }
353 $units .= '>' . $unit->getUnit() . '</option>';
354 }
355 $units .= '</select>';
356 }
357 } else {
358 $units = "";
359 }
360 switch ($resObj->getResultType()) {
363 break;
365 if ($frac_helper !== '') {
366 $units .= ' ≈ ' . $frac_helper . ', ';
367 } elseif (is_array($userdata) &&
368 array_key_exists($result, $userdata) &&
369 array_key_exists('frac_helper', $userdata[$result]) &&
370 is_string($userdata[$result]["frac_helper"])) {
371 if (!preg_match('-/-', $value)) {
372 $units .= ' ≈ ' . $userdata[$result]["frac_helper"] . ', ';
373 }
374 }
375 $units .= ' ' . $this->lng->txt('expected_result_type') . ': ' . $this->lng->txt('result_frac');
376 break;
378 if ($frac_helper !== '') {
379 $units .= ' ≈ ' . $frac_helper . ', ';
380 } elseif (is_array($userdata) && isset($userdata[$result]) && isset($userdata[$result]["frac_helper"]) && $userdata[$result]["frac_helper"] !== '') {
381 if (!preg_match('-/-', $value)) {
382 $units .= ' ≈ ' . $userdata[$result]["frac_helper"] . ', ';
383 }
384 }
385 $units .= ' ' . $this->lng->txt('expected_result_type') . ': ' . $this->lng->txt('result_co_frac');
386 break;
388 break;
389 }
390 $checkSign = "";
391 if ($graphicalOutput) {
392 $resunit = null;
393 $user_value = '';
394 if (is_array($userdata) &&
395 array_key_exists($result, $userdata) &&
396 is_array($userdata[$result])) {
397 if (array_key_exists('unit', $userdata[$result]) && $userdata[$result]["unit"] > 0) {
399 }
400
401 if (isset($userdata[$result]["value"])) {
402 $user_value = $userdata[$result]["value"];
403 }
404 }
405
406 $template = new ilTemplate("tpl.il_as_qpl_formulaquestion_output_solution_image.html", true, true, 'Modules/TestQuestionPool');
407
408 $correctness_icon = $correctness_icons['not_correct'];
409 if ($resObj->isCorrect($this->getVariables(), $this->getResults(), $user_value, $resunit)) {
410 $correctness_icon = $correctness_icons['correct'];
411 }
412 $template->setCurrentBlock("icon_ok");
413 $template->setVariable("ICON_OK", $correctness_icon);
414 $template->parseCurrentBlock();
415
416 $checkSign = $template->get();
417 }
418 $resultOutput = "";
419 if ($result_output) {
420 $template = new ilTemplate("tpl.il_as_qpl_formulaquestion_output_solution_result.html", true, true, 'Modules/TestQuestionPool');
421
422 if (is_array($userdata) &&
423 array_key_exists($resObj->getResult(), $userdata) &&
424 array_key_exists('value', $userdata[$resObj->getResult()])) {
425 $found = $resObj->getResultInfo(
426 $this->getVariables(),
427 $this->getResults(),
428 $userdata[$resObj->getResult()]["value"],
429 $userdata[$resObj->getResult()]["unit"] ?? null,
430 $this->getUnitrepository()->getUnits()
431 );
432 } else {
433 $found = $resObj->getResultInfo(
434 $this->getVariables(),
435 $this->getResults(),
436 $resObj->calculateFormula($this->getVariables(), $this->getResults(), parent::getId()),
437 is_object($resObj->getUnit()) ? $resObj->getUnit()->getId() : null,
438 $this->getUnitrepository()->getUnits()
439 );
440 }
441 $resulttext = "(";
442 if ($resObj->getRatingSimple()) {
443 if ($frac_helper) {
444 $resulttext .= "n/a";
445 } else {
446 $resulttext .= $found['points'] . " " . (($found['points'] == 1) ? $this->lng->txt('point') : $this->lng->txt('points'));
447 }
448 } else {
449 $resulttext .= $this->lng->txt("rated_sign") . " " . (($found['sign']) ? $found['sign'] : 0) . " " . (($found['sign'] == 1) ? $this->lng->txt('point') : $this->lng->txt('points')) . ", ";
450 $resulttext .= $this->lng->txt("rated_value") . " " . (($found['value']) ? $found['value'] : 0) . " " . (($found['value'] == 1) ? $this->lng->txt('point') : $this->lng->txt('points')) . ", ";
451 $resulttext .= $this->lng->txt("rated_unit") . " " . (($found['unit']) ? $found['unit'] : 0) . " " . (($found['unit'] == 1) ? $this->lng->txt('point') : $this->lng->txt('points'));
452 }
453
454 $resulttext .= ")";
455 $template->setVariable("RESULT_OUTPUT", $resulttext);
456
457 $resultOutput = $template->get();
458 }
459 $text = preg_replace("/\\\$" . substr($result, 1) . "(?![0-9]+)/", $input . " " . $units . " " . $checkSign . " " . $resultOutput . " " . "\\1", $text);
460 }
461 }
462 return $text;
463 }
const RESULT_NO_SELECTION
Definition: class.assFormulaQuestionResult.php:27
const RESULT_DEC
Definition: class.assFormulaQuestionResult.php:28
generateResultInputHTML(string $result_key, string $result_value, bool $forsolution)
Definition: class.assFormulaQuestion.php:465
purifyAndPrepareTextAreaOutput(string $content)
Definition: class.assQuestion.php:3006
special template class to simplify handling of ITX/PEAR
Definition: class.ilTemplate.php:17
References assFormulaQuestionResult\convertDecimalToCoprimeFraction(), fetchAllVariables(), generateResultInputHTML(), ILIAS\Survey\Mode\getId(), assQuestion\getQuestion(), getResult(), getResults(), getResultUnits(), getUnitrepository(), getVariables(), ILIAS\Repository\lng(), assQuestion\purifyAndPrepareTextAreaOutput(), assFormulaQuestionResult\RESULT_CO_FRAC, assFormulaQuestionResult\RESULT_DEC, assFormulaQuestionResult\RESULT_FRAC, and assFormulaQuestionResult\RESULT_NO_SELECTION.
Here is the call graph for this function:
◆ validateSolutionSubmit()
| assFormulaQuestion::validateSolutionSubmit | ( | ) |
Reimplemented from assQuestion.
Definition at line 1373 of file class.assFormulaQuestion.php.
1373 : bool
1374 {
1377 $this->tpl->setOnScreenMessage(
1378 'failure',
1380 true
1381 );
1382 return false;
1383 }
1384 }
1385
1386 return true;
1387 }
isValidSolutionResultValue($submittedValue)
Definition: class.assFormulaQuestion.php:921
References ILIAS\LTI\ToolProvider\$key, getSolutionSubmit(), isValidSolutionResultValue(), and ILIAS\Repository\lng().
Here is the call graph for this function:
Field Documentation
◆ $results
|
private |
Definition at line 31 of file class.assFormulaQuestion.php.
Referenced by getResults().
◆ $resultunits
|
private |
Definition at line 32 of file class.assFormulaQuestion.php.
Referenced by getAllResultUnits().
◆ $unitrepository
|
private |
Definition at line 33 of file class.assFormulaQuestion.php.
Referenced by getUnitrepository(), and setUnitrepository().
◆ $variables
|
private |
Definition at line 30 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
