ILIAS
Release_4_4_x_branch Revision 61816
|
Class for numeric questions. More...
Public Member Functions | |
__construct ($title="", $comment="", $author="", $owner=-1, $question="") | |
assNumeric constructor | |
isComplete () | |
Returns true, if a numeric question is complete for use. | |
saveToDb ($original_id="") | |
Saves a assNumeric object to a database. | |
duplicate ($for_test=true, $title="", $author="", $owner="", $testObjId=null) | |
Duplicates an assNumericQuestion. | |
copyObject ($target_questionpool_id, $title="") | |
Copies an assNumeric object. | |
createNewOriginalFromThisDuplicate ($targetParentId, $targetQuestionTitle="") | |
getLowerLimit () | |
getUpperLimit () | |
setLowerLimit ($a_limit) | |
setUpperLimit ($a_limit) | |
getMaximumPoints () | |
Returns the maximum points, a learner can reach answering the question. | |
contains ($value) | |
Checks for a given value within the range. | |
getQuestionType () | |
Returns the question type of the question. | |
getMaxChars () | |
Returns the maximum number of characters for the numeric input field. | |
setMaxChars ($maxchars) | |
Sets the maximum number of characters for the numeric input field. | |
getAdditionalTableName () | |
Returns the name of the additional question data table in the database. | |
getRTETextWithMediaObjects () | |
Collects all text in the question which could contain media objects which were created with the Rich Text Editor. | |
setExportDetailsXLS (&$worksheet, $startrow, $active_id, $pass, &$format_title, &$format_bold) | |
Creates an Excel worksheet for the detailed cumulated results of this question. | |
Public Member Functions inherited from assQuestion | |
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. | |
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. | |
questionTitleExists ($questionpool_id, $title) | |
Returns TRUE if the question title exists in the database. | |
setTitle ($title="") | |
Sets the title string of the assQuestion object. | |
setId ($id=-1) | |
Sets the id of the assQuestion object. | |
setTestId ($id=-1) | |
Sets the test id of the assQuestion object. | |
setComment ($comment="") | |
Sets the comment string of the assQuestion object. | |
setOutputType ($outputType=OUTPUT_HTML) | |
Sets the output type. | |
setShuffle ($shuffle=true) | |
Sets the shuffle flag. | |
setEstimatedWorkingTime ($hour=0, $min=0, $sec=0) | |
Sets the estimated working time of a question. | |
keyInArray ($searchkey, $array) | |
returns TRUE if the key occurs in an array | |
setAuthor ($author="") | |
Sets the authors name of the assQuestion object. | |
setOwner ($owner="") | |
Sets the creator/owner ID of the assQuestion object. | |
getTitle () | |
Gets the title string of the assQuestion object. | |
getId () | |
Gets the id of the assQuestion object. | |
getShuffle () | |
Gets the shuffle flag. | |
getTestId () | |
Gets the test id of the assQuestion object. | |
getComment () | |
Gets the comment string of the assQuestion object. | |
getOutputType () | |
Gets the output type. | |
supportsJavascriptOutput () | |
Returns true if the question type supports JavaScript output. | |
supportsNonJsOutput () | |
requiresJsSwitch () | |
getEstimatedWorkingTime () | |
Gets the estimated working time of a question. | |
getAuthor () | |
Gets the authors name of the assQuestion object. | |
getOwner () | |
Gets the creator/owner ID of the assQuestion object. | |
getObjId () | |
Get the object id of the container object. | |
setObjId ($obj_id=0) | |
Set the object id of the container object. | |
setExternalId ($external_id) | |
getExternalId () | |
_getMaximumPoints ($question_id) | |
Returns the maximum points, a learner can reach answering the question. | |
& | _getQuestionInfo ($question_id) |
Returns question information from the database. | |
getSuggestedSolutionOutput () | |
& | _getSuggestedSolution ($question_id, $subquestion_index=0) |
Returns a suggested solution for a given subquestion index. | |
getSuggestedSolutions () | |
Return the suggested solutions. | |
_getReachedPoints ($active_id, $question_id, $pass=NULL) | |
Returns the points, a learner has reached answering the question. | |
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. | |
getAdjustedReachedPoints ($active_id, $pass=NULL) | |
returns the reached points ... | |
calculateResultsFromSolution ($active_id, $pass=NULL, $obligationsEnabled=false) | |
Calculates the question results from a previously saved question solution. | |
persistWorkingState ($active_id, $pass=NULL, $obligationsEnabled=false) | |
persists the working state for current testactive and testpass | |
saveWorkingData ($active_id, $pass=NULL) | |
Saves the learners input of the question to the database. | |
_updateTestResultCache ($active_id, ilAssQuestionProcessLocker $processLocker=null) | |
Move this to a proper place. | |
logAction ($logtext="", $active_id="", $question_id="") | |
Logs an action into the Test&Assessment log. | |
_logAction ($logtext="", $active_id="", $question_id="") | |
Logs an action into the Test&Assessment log. | |
moveUploadedMediaFile ($file, $name) | |
Move an uploaded media file to an public accessible temp dir to present it. | |
getSuggestedSolutionPath () | |
Returns the path for a suggested solution. | |
getJavaPath () | |
Returns the image path for web accessable images of a question. | |
getImagePath ($question_id=null, $object_id=null) | |
Returns the image path for web accessable images of a question. | |
getFlashPath () | |
Returns the image path for web accessable flash files of a question. | |
getJavaPathWeb () | |
Returns the web image path for web accessable java applets of a question. | |
getSuggestedSolutionPathWeb () | |
Returns the web path for a suggested solution. | |
getImagePathWeb () | |
Returns the web image path for web accessable images of a question. | |
getFlashPathWeb () | |
Returns the web image path for web accessable flash applications of a question. | |
& | getSolutionValues ($active_id, $pass=NULL) |
Loads solutions of a given user from the database an returns it. | |
isInUse ($question_id="") | |
Checks whether the question is in use or not. | |
isClone ($question_id="") | |
Checks whether the question is a clone of another question or not. | |
pcArrayShuffle ($array) | |
Shuffles the values of a given array. | |
getQuestionTypeFromDb ($question_id) | |
get question type for question id | |
getAnswerTableName () | |
Returns the name of the answer table in the database. | |
deleteAnswers ($question_id) | |
Deletes datasets from answers tables. | |
deleteAdditionalTableData ($question_id) | |
Deletes datasets from the additional question table in the database. | |
delete ($question_id) | |
Deletes a question and all materials from the database. | |
getTotalAnswers () | |
get total number of answers | |
_getTotalAnswers ($a_q_id) | |
get number of answers for question id (static) note: do not use $this inside this method | |
_getTotalRightAnswers ($a_q_id) | |
get number of answers for question id (static) note: do not use $this inside this method | |
_getTitle ($a_q_id) | |
Returns the title of a question. | |
_getQuestionText ($a_q_id) | |
Returns question text. | |
copyXHTMLMediaObjectsOfQuestion ($a_q_id) | |
syncXHTMLMediaObjectsOfQuestion () | |
createPageObject () | |
create page object of question | |
copyPageOfQuestion ($a_q_id) | |
getPageOfQuestion () | |
_getQuestionType ($question_id) | |
Returns the question type of a question with a given id. | |
_getQuestionTitle ($question_id) | |
Returns the question title of a question with a given id. | |
setOriginalId ($original_id) | |
getOriginalId () | |
loadFromDb ($question_id) | |
Loads the question from the database. | |
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. | |
saveQuestionDataToDb ($original_id="") | |
setNewOriginalId ($newId) | |
deleteSuggestedSolutions () | |
Deletes all suggestes solutions in the database. | |
getSuggestedSolution ($subquestion_index=0) | |
Returns a suggested solution for a given subquestion index. | |
getSuggestedSolutionTitle ($subquestion_index=0) | |
Returns the title of a suggested solution at a given subquestion_index. | |
setSuggestedSolution ($solution_id="", $subquestion_index=0, $is_import=false) | |
Sets a suggested solution for the question. | |
_resolveInternalLink ($internal_link) | |
_resolveIntLinks ($question_id) | |
_getInternalLinkHref ($target="") | |
syncWithOriginal () | |
createRandomSolution ($test_id, $user_id) | |
_questionExists ($question_id) | |
Returns true if the question already exists in the database. | |
_questionExistsInPool ($question_id) | |
Returns true if the question already exists in the database and is assigned to a question pool. | |
getPoints () | |
Returns the maximum available points for the question. | |
setPoints ($a_points) | |
Sets the maximum available points for the question. | |
getSolutionMaxPass ($active_id) | |
Returns the maximum pass a users question solution. | |
_getSolutionMaxPass ($question_id, $active_id) | |
Returns the maximum pass a users question solution. | |
_isWriteable ($question_id, $user_id) | |
Returns true if the question is writeable by a certain user. | |
_isUsedInRandomTest ($question_id="") | |
Checks whether the question is used in a random test or not. | |
calculateReachedPoints ($active_id, $pass=NULL, $returndetails=FALSE) | |
Returns the points, a learner has reached answering the question. | |
adjustReachedPointsByScoringOptions ($points, $active_id, $pass=NULL) | |
Adjust the given reached points by checks for all special scoring options in the test container. | |
isHTML ($a_text) | |
Checks if a given string contains HTML or not. | |
prepareTextareaOutput ($txt_output, $prepare_for_latex_output=FALSE) | |
Prepares a string for a text area output in tests. | |
QTIMaterialToString ($a_material) | |
Reads an QTI material tag an creates a text string. | |
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. | |
createNewImageFileName ($image_filename) | |
_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. | |
getQuestion () | |
Gets the question string of the question object. | |
setQuestion ($question="") | |
Sets the question string of the question object. | |
getQuestionTypeID () | |
Returns the question type of the question. | |
cleanupMediaObjectUsage () | |
synchronises appearances of media objects in the question with media object usage table | |
& | getInstances () |
Gets all instances of the question. | |
_needsManualScoring ($question_id) | |
getActiveUserData ($active_id) | |
Returns the user id and the test id for a given active id. | |
__get ($value) | |
Object getter. | |
__set ($key, $value) | |
Object setter. | |
getNrOfTries () | |
setNrOfTries ($a_nr_of_tries) | |
setExportImagePath ($a_path) | |
_questionExistsInTest ($question_id, $test_id) | |
formatSAQuestion ($a_q) | |
Format self assessment question. | |
setPreventRteUsage ($a_val) | |
Set prevent rte usage. | |
getPreventRteUsage () | |
Get prevent rte usage. | |
setSelfAssessmentEditingMode ($a_selfassessmenteditingmode) | |
Set Self-Assessment Editing Mode. | |
getSelfAssessmentEditingMode () | |
Get Self-Assessment Editing Mode. | |
setDefaultNrOfTries ($a_defaultnroftries) | |
Set Default Nr of Tries. | |
getDefaultNrOfTries () | |
Get Default Nr of Tries. | |
isAnswered ($active_id, $pass=null) | |
returns boolean wether the question is answered during test pass or not | |
setObligationsToBeConsidered ($obligationsToBeConsidered=true) | |
sets the flag wether obligations are to be considered or not | |
areObligationsToBeConsidered () | |
gets the flag wether obligations are to be considered or not | |
isAutosaveable () | |
getAdditionalContentEditingMode () | |
getter for additional content editing mode for this question | |
setAdditionalContentEditingMode ($additinalContentEditingMode) | |
setter for additional content editing mode for this question | |
isAdditionalContentEditingModePageObject () | |
isser for additional "pageobject" content editing mode | |
isValidAdditionalContentEditingMode ($additionalContentEditingMode) | |
returns the fact wether the passed additional content mode is valid or not | |
getValidAdditionalContentEditingModes () | |
getter for valid additional content editing modes | |
addQuestionChangeListener (ilQuestionChangeListener $listener) | |
getQuestionChangeListeners () | |
getHtmlUserSolutionPurifier () | |
Public Member Functions inherited from ilObjQuestionScoringAdjustable | |
saveAdditionalQuestionDataToDb () | |
Saves a record to the question types additional data table. | |
Public Member Functions inherited from ilObjAnswerScoringAdjustable | |
saveAnswerSpecificDataToDb () | |
Saves the answer specific records into a question types answer table. |
Data Fields | |
$maxchars | |
Data Fields inherited from assQuestion | |
const | ADDITIONAL_CONTENT_EDITING_MODE_DEFAULT = 'default' |
constant for additional content editing mode "default" | |
const | ADDITIONAL_CONTENT_EDITING_MODE_PAGE_OBJECT = 'pageobject' |
constant for additional content editing mode "pageobject" | |
$feedbackOBJ = null | |
$prevent_rte_usage = false | |
$selfassessmenteditingmode = false | |
$defaultnroftries = false |
Protected Member Functions | |
reworkWorkingData ($active_id, $pass, $obligationsAnswered) | |
Reworks the allready saved working data if neccessary. | |
Protected Member Functions inherited from assQuestion | |
deletePageOfQuestion ($question_id) | |
Deletes the page object of a question with a given ID. | |
onDuplicate ($originalParentId, $originalQuestionId, $duplicateParentId, $duplicateQuestionId) | |
Will be called when a question is duplicated (inside a question pool or for insertion in a test) | |
onSyncWithOriginal ($originalQuestionId, $duplicateQuestionId) | |
onCopy ($sourceParentId, $sourceQuestionId, $targetParentId, $targetQuestionId) | |
Will be called when a question is copied (into another question pool) | |
duplicateSuggestedSolutionFiles ($parent_id, $question_id) | |
Duplicates the files of a suggested solution if the question is duplicated. | |
syncSuggestedSolutionFiles ($original_id) | |
Syncs the files of a suggested solution if the question is synced. | |
copySuggestedSolutionFiles ($source_questionpool_id, $source_question_id) | |
duplicateQuestionHints ($originalQuestionId, $duplicateQuestionId) |
Protected Attributes | |
$lower_limit | |
$upper_limit | |
Protected Attributes inherited from assQuestion | |
$id | |
$title | |
$comment | |
$owner | |
$author | |
$question | |
$points | |
$est_working_time | |
$shuffle | |
$test_id | |
$obj_id | |
$ilias | |
$tpl | |
$lng | |
$outputType | |
$suggested_solutions | |
$original_id | |
$page | |
$external_id = '' | |
$questionChangeListeners = array() | |
$processLocker |
Additional Inherited Members | |
Static Public Member Functions inherited from assQuestion | |
static | _getSuggestedSolutionCount ($question_id) |
Returns the number of suggested solutions associated with a question. | |
static | _getSuggestedSolutionOutput ($question_id) |
Returns the output of the suggested solution. | |
static | _getOriginalId ($question_id) |
Returns the original id of a question. | |
static | originalQuestionExists ($questionId) |
static | _instanciateQuestion ($question_id) |
Creates an instance of a question with a given question id. | |
static | _instantiateQuestion ($question_id) |
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. | |
static | _areAnswered ($a_user_id, $a_question_ids) |
Checks if an array of question ids is answered by an user or not. | |
static | _includeClass ($question_type, $gui=0) |
Include the php class file for a given question type. | |
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. | |
static & | _instanciateQuestionGUI ($question_id) |
Creates an instance of a question gui with a given question id. | |
static | instantiateQuestionGUI ($a_question_id) |
Creates an instance of a question gui with a given question id. | |
static | lookupParentObjId ($questionId) |
ilDB $ilDB | |
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) | |
static | isObligationPossible ($questionId) |
returns boolean wether it is possible to set this question type as obligatory or not considering the current question configuration | |
Static Protected Member Functions inherited from assQuestion | |
static | doesSolutionRecordsExist ($activeId, $pass, $questionId) |
checks wether there are existing solution records for the given test active / pass and given question id |
Class for numeric questions.
assNumeric is a class for numeric questions. To solve a numeric question, a learner has to enter a numerical value in a defined range.
Definition at line 24 of file class.assNumeric.php.
assNumeric::__construct | ( | $title = "" , |
|
$comment = "" , |
|||
$author = "" , |
|||
$owner = -1 , |
|||
$question = "" |
|||
) |
assNumeric constructor
The constructor takes possible arguments an creates an instance of the assNumeric object.
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 numeric question |
Reimplemented from assQuestion.
Definition at line 43 of file class.assNumeric.php.
References assQuestion\$author, assQuestion\$comment, assQuestion\$owner, assQuestion\$question, and assQuestion\$title.
assNumeric::contains | ( | $value | ) |
Checks for a given value within the range.
double | $value | The value to check |
Definition at line 371 of file class.assNumeric.php.
References $result, and getUpperLimit().
assNumeric::copyObject | ( | $target_questionpool_id, | |
$title = "" |
|||
) |
Copies an assNumeric object.
integer | $target_questionpool_id | |
string | $title |
Definition at line 220 of file class.assNumeric.php.
References assQuestion\$original_id, assQuestion\$title, assQuestion\_getOriginalId(), and assQuestion\getObjId().
assNumeric::createNewOriginalFromThisDuplicate | ( | $targetParentId, | |
$targetQuestionTitle = "" |
|||
) |
Definition at line 250 of file class.assNumeric.php.
References assQuestion\$id, and assQuestion\getObjId().
assNumeric::duplicate | ( | $for_test = true , |
|
$title = "" , |
|||
$author = "" , |
|||
$owner = "" , |
|||
$testObjId = null |
|||
) |
Duplicates an assNumericQuestion.
bool | $for_test | |
string | $title | |
string | $author | |
string | $owner | |
integer | null | $testObjId |
Reimplemented from assQuestion.
Definition at line 158 of file class.assNumeric.php.
References assQuestion\$author, assQuestion\$original_id, assQuestion\$owner, assQuestion\$title, assQuestion\_getOriginalId(), assQuestion\getId(), and assQuestion\getObjId().
assNumeric::getAdditionalTableName | ( | ) |
Returns the name of the additional question data table in the database.
Reimplemented from assQuestion.
Definition at line 598 of file class.assNumeric.php.
assNumeric::getLowerLimit | ( | ) |
Definition at line 285 of file class.assNumeric.php.
References $lower_limit.
assNumeric::getMaxChars | ( | ) |
Returns the maximum number of characters for the numeric input field.
Definition at line 578 of file class.assNumeric.php.
References $maxchars.
assNumeric::getMaximumPoints | ( | ) |
Returns the maximum points, a learner can reach answering the question.
Reimplemented from assQuestion.
Definition at line 312 of file class.assNumeric.php.
References assQuestion\getPoints().
Referenced by isComplete().
assNumeric::getQuestionType | ( | ) |
Returns the question type of the question.
Reimplemented from assQuestion.
Definition at line 568 of file class.assNumeric.php.
assNumeric::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 607 of file class.assNumeric.php.
assNumeric::getUpperLimit | ( | ) |
Definition at line 290 of file class.assNumeric.php.
References $upper_limit.
Referenced by contains().
assNumeric::isComplete | ( | ) |
Returns true, if a numeric question is complete for use.
Reimplemented from assQuestion.
Definition at line 60 of file class.assNumeric.php.
References getMaximumPoints().
|
protected |
Reworks the allready saved working data if neccessary.
integer | $active_id | |
integer | $pass | |
boolean | $obligationsAnswered |
Reimplemented from assQuestion.
Definition at line 558 of file class.assNumeric.php.
assNumeric::saveToDb | ( | $original_id = "" | ) |
Saves a assNumeric object to a database.
string | $original_id |
Reimplemented from assQuestion.
Definition at line 79 of file class.assNumeric.php.
References assQuestion\$original_id, ilObjQuestionScoringAdjustable\saveAdditionalQuestionDataToDb(), ilObjAnswerScoringAdjustable\saveAnswerSpecificDataToDb(), and assQuestion\saveQuestionDataToDb().
assNumeric::setExportDetailsXLS | ( | & | $worksheet, |
$startrow, | |||
$active_id, | |||
$pass, | |||
& | $format_title, | ||
& | $format_bold | ||
) |
Creates an Excel worksheet for the detailed cumulated results of this question.
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 |
object | $format_title | Excel title format |
object | $format_bold | Excel bold format |
Reimplemented from assQuestion.
Definition at line 624 of file class.assNumeric.php.
References $pass, ilExcelUtils\_convert_text(), assQuestion\getSolutionValues(), and assQuestion\getTitle().
assNumeric::setLowerLimit | ( | $a_limit | ) |
Definition at line 295 of file class.assNumeric.php.
assNumeric::setMaxChars | ( | $maxchars | ) |
Sets the maximum number of characters for the numeric input field.
integer | $maxchars | The maximum number of characters |
Definition at line 588 of file class.assNumeric.php.
References $maxchars.
assNumeric::setUpperLimit | ( | $a_limit | ) |
Definition at line 301 of file class.assNumeric.php.
|
protected |
Definition at line 26 of file class.assNumeric.php.
Referenced by getLowerLimit().
assNumeric::$maxchars |
Definition at line 30 of file class.assNumeric.php.
Referenced by getMaxChars(), and setMaxChars().
|
protected |
Definition at line 27 of file class.assNumeric.php.
Referenced by getUpperLimit().