4 require_once
'./Modules/TestQuestionPool/classes/class.assQuestion.php';
5 require_once
'./Modules/Test/classes/inc.AssessmentConstants.php';
6 require_once
'./Modules/TestQuestionPool/interfaces/interface.ilObjQuestionScoringAdjustable.php';
7 require_once
'./Modules/TestQuestionPool/interfaces/interface.ilObjAnswerScoringAdjustable.php';
8 require_once
'./Modules/TestQuestionPool/interfaces/interface.iQuestionCondition.php';
9 require_once
'./Modules/TestQuestionPool/classes/class.ilUserQuestionResult.php';
10 require_once
'Modules/TestQuestionPool/interfaces/interface.ilAssSpecificFeedbackOptionLabelProvider.php';
84 $this->thumb_size = 150;
86 $this->answers =
array();
88 $this->feedback_setting = 2;
99 if (strlen($this->title) and ($this->author) and ($this->question) and (count($this->answers)) and ($this->
getMaximumPoints() > 0)) {
100 foreach ($this->answers as $answer) {
101 if ((strlen($answer->getAnswertext()) == 0) && (strlen($answer->getImage()) == 0)) {
135 $oldthumbsize =
$data[
'thumb_size'];
154 if (strlen($answer->getImage())) {
173 switch (strtoupper($path_info[
'extension'])) {
208 $this->
setId($question_id);
217 include_once(
"./Services/RTE/classes/class.ilRTE.php");
223 $this->isSingleline = (
$data[
'allow_images']) ?
false :
true;
224 $this->lastChange =
$data[
'tstamp'];
225 $this->feedback_setting =
$data[
'feedback_setting'];
234 "SELECT * FROM qpl_a_sc WHERE question_fi = %s ORDER BY aorder ASC",
238 include_once
"./Modules/TestQuestionPool/classes/class.assAnswerBinaryStateImage.php";
242 if (!@file_exists($imagefilename)) {
243 $data[
"imagefile"] =
"";
245 include_once(
"./Services/RTE/classes/class.ilRTE.php");
251 parent::loadFromDb($question_id);
261 if ($this->
id <= 0) {
266 $this_id = $this->
getId();
270 include_once(
"./Modules/TestQuestionPool/classes/class.assQuestion.php");
274 if ((
int) $testObjId > 0) {
275 $clone->setObjId($testObjId);
295 $clone->copyPageOfQuestion($this_id);
298 $clone->copyXHTMLMediaObjectsOfQuestion($this_id);
300 $clone->duplicateImages($this_id, $thisObjId);
302 $clone->onDuplicate($thisObjId, $this_id, $clone->getObjId(), $clone->getId());
314 if ($this->
id <= 0) {
320 include_once(
"./Modules/TestQuestionPool/classes/class.assQuestion.php");
323 $source_questionpool_id = $this->
getObjId();
324 $clone->setObjId($target_questionpool_id);
334 $clone->copyImages(
$original_id, $source_questionpool_id);
336 $clone->onCopy($source_questionpool_id,
$original_id, $clone->getObjId(), $clone->getId());
343 if ($this->
id <= 0) {
348 include_once(
"./Modules/TestQuestionPool/classes/class.assQuestion.php");
351 $sourceParentId = $this->
getObjId();
357 $clone->setObjId($targetParentId);
359 if ($targetQuestionTitle) {
360 $clone->setTitle($targetQuestionTitle);
365 $clone->copyPageOfQuestion($sourceQuestionId);
367 $clone->copyXHTMLMediaObjectsOfQuestion($sourceQuestionId);
369 $clone->copyImages($sourceQuestionId, $sourceParentId);
371 $clone->onCopy($sourceParentId, $sourceQuestionId, $clone->getObjId(), $clone->getId());
419 include_once
"./Modules/TestQuestionPool/classes/class.assAnswerBinaryStateImage.php";
420 if (array_key_exists($order, $this->answers)) {
423 $newchoices =
array();
424 for (
$i = 0;
$i < $order;
$i++) {
425 array_push($newchoices, $this->answers[
$i]);
427 array_push($newchoices, $answer);
428 for (
$i = $order;
$i < count($this->answers);
$i++) {
433 $this->answers = $newchoices;
437 array_push($this->answers, $answer);
450 return count($this->answers);
467 if (count($this->answers) < 1) {
470 if (
$index >= count($this->answers)) {
474 return $this->answers[
$index];
490 if (count($this->answers) < 1) {
493 if (
$index >= count($this->answers)) {
496 $answer = $this->answers[
$index];
497 if (strlen($answer->getImage())) {
500 unset($this->answers[
$index]);
501 $this->answers = array_values($this->answers);
502 for (
$i = 0;
$i < count($this->answers);
$i++) {
503 if ($this->answers[
$i]->getOrder() >
$index) {
504 $this->answers[
$i]->setOrder(
$i);
517 $this->answers =
array();
529 foreach ($this->answers as
$key => $value) {
530 if ($value->getPoints() >
$points) {
549 if ($returndetails) {
550 throw new ilTestException(
'return details not implemented for ' . __METHOD__);
555 $found_values =
array();
556 if (is_null(
$pass)) {
561 if (strcmp(
$data[
"value1"],
"") != 0) {
562 array_push($found_values,
$data[
"value1"]);
566 foreach ($this->answers as
$key => $answer) {
567 if (count($found_values) > 0) {
568 if (in_array(
$key, $found_values)) {
569 $points += $answer->getPoints();
583 foreach ($this->answers as
$key => $answer) {
584 if (is_numeric($participantSolution) &&
$key == $participantSolution) {
585 $points = $answer->getPoints();
607 if (is_null(
$pass)) {
608 include_once
"./Modules/Test/classes/class.ilObjTest.php";
614 $this->
getProcessLocker()->executeUserSolutionUpdateLockOperation(
function () use (&$entered_values, $ilDB, $active_id,
$pass, $authorized) {
617 $update =
$row[
"solution_id"];
620 if (strlen(
$_POST[
"multiple_choice_result"])) {
627 if (strlen(
$_POST[
"multiple_choice_result"])) {
634 if ($entered_values) {
635 include_once(
"./Modules/Test/classes/class.ilObjAssessmentFolder.php");
640 include_once(
"./Modules/Test/classes/class.ilObjAssessmentFolder.php");
651 if (strlen(
$_POST[
'multiple_choice_result' . $this->
getId() .
'ID'])) {
672 ) .
" (question_fi, shuffle, allow_images, thumb_size, feedback_setting) VALUES (%s, %s, %s, %s, %s)",
673 array(
"integer",
"text",
"text",
"integer",
'integer' ),
677 ($this->isSingleline) ?
"0" :
"1",
688 if (!$this->isSingleline) {
692 "DELETE FROM qpl_a_sc WHERE question_fi = %s",
697 foreach ($this->answers as
$key => $value) {
699 $answer_obj = $this->answers[
$key];
700 $next_id = $ilDB->nextId(
'qpl_a_sc');
702 "INSERT INTO qpl_a_sc (answer_id, question_fi, answertext, points, aorder, imagefile, tstamp) VALUES (%s, %s, %s, %s, %s, %s, %s)",
703 array(
'integer',
'integer',
'text',
'float',
'integer',
'text',
'integer' ),
708 $answer_obj->getPoints(),
709 $answer_obj->getOrder(),
710 $answer_obj->getImage(),
734 return "assSingleChoice";
767 public function setImageFile($image_filename, $image_tempfilename =
"")
770 if (!empty($image_tempfilename)) {
771 $image_filename = str_replace(
" ",
"_", $image_filename);
773 if (!file_exists($imagepath)) {
777 if (!ilUtil::moveUploadedFile($image_tempfilename, $image_filename, $imagepath . $image_filename)) {
780 include_once
"./Services/MediaObjects/classes/class.ilObjMediaObject.php";
782 if (!preg_match(
"/^image/", $mimetype)) {
783 unlink($imagepath . $image_filename);
805 @unlink($imagepath . $image_filename);
806 $thumbpath = $imagepath . $this->
getThumbPrefix() . $image_filename;
814 $imagepath_original = str_replace(
"/$this->id/images",
"/$question_id/images", $imagepath);
816 if ((
int) $objectId > 0) {
817 $imagepath_original = str_replace(
"/$this->obj_id/",
"/$objectId/", $imagepath_original);
820 foreach ($this->answers as $answer) {
823 if (!file_exists($imagepath)) {
826 if (!@copy($imagepath_original .
$filename, $imagepath . $filename)) {
827 $ilLog->write(
"image could not be duplicated!!!!", $ilLog->ERROR);
828 $ilLog->write(
"object: " . print_r($this,
true), $ilLog->ERROR);
830 if (@file_exists($imagepath_original . $this->
getThumbPrefix() . $filename)) {
832 $ilLog->write(
"image thumbnail could not be duplicated!!!!", $ilLog->ERROR);
833 $ilLog->write(
"object: " . print_r($this,
true), $ilLog->ERROR);
840 public function copyImages($question_id, $source_questionpool)
846 $imagepath_original = str_replace(
"/$this->id/images",
"/$question_id/images", $imagepath);
847 $imagepath_original = str_replace(
"/$this->obj_id/",
"/$source_questionpool/", $imagepath_original);
848 foreach ($this->answers as $answer) {
851 if (!file_exists($imagepath)) {
855 if (file_exists($imagepath_original .
$filename)) {
856 if (!copy($imagepath_original . $filename, $imagepath . $filename)) {
857 $ilLog->warning(sprintf(
858 "Could not clone source image '%s' to '%s' (srcQuestionId: %s|tgtQuestionId: %s|srcParentObjId: %s|tgtParentObjId: %s)",
859 $imagepath_original . $filename,
860 $imagepath . $filename,
863 $source_questionpool,
869 if (file_exists($imagepath_original . $this->
getThumbPrefix() . $filename)) {
871 $ilLog->warning(sprintf(
872 "Could not clone thumbnail source image '%s' to '%s' (srcQuestionId: %s|tgtQuestionId: %s|srcParentObjId: %s|tgtParentObjId: %s)",
877 $source_questionpool,
894 $imagepath_original = str_replace(
"/$this->id/images",
"/$question_id/images", $imagepath);
896 foreach ($this->answers as $answer) {
899 if (@file_exists($imagepath .
$filename)) {
900 if (!file_exists($imagepath)) {
903 if (!file_exists($imagepath_original)) {
906 if (!@copy($imagepath . $filename, $imagepath_original . $filename)) {
907 $ilLog->write(
"image could not be duplicated!!!!", $ilLog->ERROR);
908 $ilLog->write(
"object: " . print_r($this,
true), $ilLog->ERROR);
911 if (@file_exists($imagepath . $this->
getThumbPrefix() . $filename)) {
913 $ilLog->write(
"image thumbnail could not be duplicated!!!!", $ilLog->ERROR);
914 $ilLog->write(
"object: " . print_r($this,
true), $ilLog->ERROR);
927 $text = parent::getRTETextWithMediaObjects();
928 foreach ($this->answers as
$index => $answer) {
929 $text .= $this->feedbackOBJ->getSpecificAnswerFeedbackContent($this->
getId(),
$index);
930 $answer_obj = $this->answers[
$index];
931 $text .= $answer_obj->getAnswertext();
954 $worksheet->setCell($startrow +
$i, 0, $answer->getAnswertext());
957 count($solution) > 0 &&
958 isset($solution[0]) &&
959 is_array($solution[0]) &&
960 strlen($solution[0][
'value1']) > 0 &&
$id == $solution[0][
'value1']
969 return $startrow +
$i + 1;
979 $this->thumb_size = $a_size;
998 include_once(
"./Services/RTE/classes/class.ilRTE.php");
1008 'onenotcorrect' => $this->
formatSAQuestion($this->feedbackOBJ->getGenericFeedbackTestPresentation($this->getId(),
false)),
1009 'allcorrect' => $this->
formatSAQuestion($this->feedbackOBJ->getGenericFeedbackTestPresentation($this->getId(),
true))
1015 if ((
string) $answer_obj->getImage()) {
1018 array_push($answers,
array(
1019 "answertext" => (
string) $this->
formatSAQuestion($answer_obj->getAnswertext()),
1020 'html_id' => (
int) $this->
getId() .
'_' .
$key,
1021 "points" => (float) $answer_obj->getPoints(),
1022 "order" => (int) $answer_obj->getOrder(),
1023 "image" => (
string) $answer_obj->getImage(),
1025 $this->feedbackOBJ->getSpecificAnswerFeedbackExportPresentation($this->getId(),
$key)
1043 $answer = $this->answers[
$index];
1044 if (is_object($answer)) {
1046 $answer->setImage(
'');
1052 $value = rand(0, count($this->answers)-1);
1053 $_POST[
"multiple_choice_result"] = (strlen($value)) ? (
string) $value :
'0';
1062 $multilineAnswerSetting = $ilUser->getPref(
"tst_multiline_answers");
1063 if ($multilineAnswerSetting != 1) {
1064 $multilineAnswerSetting = 0;
1066 return $multilineAnswerSetting;
1072 $ilUser->writePref(
"tst_multiline_answers", $a_setting);
1086 $this->feedback_setting = $a_feedback_setting;
1100 if ($this->feedback_setting) {
1109 return 'feedback_correct_sc_mc';
1126 return $numExistingSolutionRecords > 0;
1154 require_once
"./Modules/TestQuestionPool/classes/class.ilOperatorsExpressionMapping.php";
1185 $maxStep = $this->lookupMaxStep($active_id,
$pass);
1187 if ($maxStep !== null) {
1188 $data = $ilDB->queryF(
1189 "SELECT * FROM tst_solutions WHERE active_fi = %s AND pass = %s AND question_fi = %s AND step = %s",
1190 array(
"integer",
"integer",
"integer",
"integer"),
1194 $data = $ilDB->queryF(
1195 "SELECT * FROM tst_solutions WHERE active_fi = %s AND pass = %s AND question_fi = %s",
1196 array(
"integer",
"integer",
"integer"),
1238 parent::afterSyncWithOriginal($origQuestionId, $dupQuestionId, $origParentObjId, $dupParentObjId);
1240 $origImagePath = $this->
buildImagePath($origQuestionId, $origParentObjId);
1241 $dupImagePath = $this->
buildImagePath($dupQuestionId, $dupParentObjId);
1244 if (is_dir($dupImagePath)) {
getSpecificFeedbackAllCorrectOptionLabel()
static makeDirParents($a_dir)
Create a new directory and all parent directories.
static logAction($logtext="", $active_id="", $question_id="")
Logs an action into the Test&Assessment log.
getOutputType()
Gets the single choice output type which is either OUTPUT_ORDER (=0) or OUTPUT_RANDOM (=1)...
getId()
Gets the id of the assQuestion object.
saveToDb($original_id="")
Saves the question to the database.
generateThumbForFile($path, $file)
static _getOriginalId($question_id)
Returns the original id of a question.
formatSAQuestion($a_q)
Format self assessment question.
const PercentageResultExpression
removeAnswerImage($index)
Class iQuestionCondition.
getMaximumPoints()
Returns the maximum points, a learner can reach answering the question.
static _getPass($active_id)
Retrieves the actual pass of a given user for a given test.
static getNumExistingSolutionRecords($activeId, $pass, $questionId)
returns the number of existing solution records for the given test active / pass and given question i...
const NumberOfResultExpression
saveAdditionalQuestionDataToDb()
Saves a record to the question types additional data table.
static rCopy($a_sdir, $a_tdir, $preserveTimeAttributes=false)
Copies content of a directory $a_sdir recursively to a directory $a_tdir.
Abstract basic class which is to be extended by the concrete assessment question type classes...
Class for answers with a binary state indicator.
setOutputType($output_type=OUTPUT_ORDER)
Sets the output type of the assSingleChoice object.
setMultilineAnswerSetting($a_setting=0)
& getAnswers()
Returns a reference to the answers array.
afterSyncWithOriginal($origQuestionId, $dupQuestionId, $origParentObjId, $dupParentObjId)
{}
getAnswerCount()
Returns the number of answers.
ensureNonNegativePoints($points)
calculateResultsFromSolution($active_id, $pass=null, $obligationsEnabled=false)
Calculates the question results from a previously saved question solution.
getAvailableAnswerOptions($index=null)
If index is null, the function returns an array with all anwser options Else it returns the specific ...
getSolutionValues($active_id, $pass=null, $authorized=true)
Loads solutions of a given user from the database an returns it.
isComplete()
Returns true, if a single choice question is complete for use.
setId($id=-1)
Sets the id of the assQuestion object.
copyObject($target_questionpool_id, $title="")
Copies an assSingleChoice object.
getQuestionType()
Returns the question type of the question.
getAnswerTableName()
Returns the name of the answer table in the database.
getImagePathWeb()
Returns the web image path for web accessable images of a question.
getSolutionMaxPass($active_id)
Returns the maximum pass a users question solution.
setEstimatedWorkingTime($hour=0, $min=0, $sec=0)
Sets the estimated working time of a question from given hour, minute and second. ...
migrateToLmContent($content)
loadFromDb($question_id)
Loads a assSingleChoice object from a database.
getParticipantsSolution()
getUserQuestionResult($active_id, $pass)
Get the user solution for a question by active_id and the test pass.
setNrOfTries($a_nr_of_tries)
setSpecificFeedbackSetting($a_feedback_setting)
Sets the feedback settings in effect for the question.
setAdditionalContentEditingMode($additinalContentEditingMode)
setter for additional content editing mode for this question
duplicate($for_test=true, $title="", $author="", $owner="", $testObjId=null)
Duplicates an assSingleChoiceQuestion.
getAnswer($index=0)
Returns an answer with a given index.
setShuffle($shuffle=true)
Sets the shuffle flag.
static _replaceMediaObjectImageSrc($a_text, $a_direction=0, $nic=IL_INST_ID)
Replaces image source from mob image urls with the mob id or replaces mob id with the correct image s...
getOperators($expression)
Get all available operations for a specific question.
getObjId()
Get the object id of the container object.
getShuffle()
Gets the shuffle flag.
Base Exception for all Exceptions relating to Modules/Test.
getMultilineAnswerSetting()
saveWorkingData($active_id, $pass=null, $authorized=true)
Saves the learners input of the question to the database.
getSpecificFeedbackSetting()
Gets the current feedback settings in effect for the question.
setParticipantsSolution($participantSolution)
createNewOriginalFromThisDuplicate($targetParentId, $targetQuestionTitle="")
removeSolutionRecordById($solutionId)
deleteImage($image_filename)
Deletes an image file.
static _getLogLanguage()
retrieve the log language for assessment logging
setAuthor($author="")
Sets the authors name of the assQuestion object.
calculateReachedPointsFromPreviewSession(ilAssQuestionPreviewSession $previewSession)
static _enabledAssessmentLogging()
check wether assessment logging is enabled or not
getImagePath($question_id=null, $object_id=null)
Returns the image path for web accessable images of a question.
Class ilUserQuestionResult.
createRandomSolution($active_id, $pass)
setExportDetailsXLS($worksheet, $startrow, $active_id, $pass)
{}
isAnswered($active_id, $pass=null)
returns boolean wether the question is answered during test pass or not
saveCurrentSolution($active_id, $pass, $value1, $value2, $authorized=true, $tstamp=null)
Class for single choice questions.
deleteAnswer($index=0)
Deletes an answer with a given index.
Interface ilObjAnswerScoringAdjustable.
toJSON()
Returns a JSON representation of the question.
addAnswer( $answertext="", $points=0.0, $order=0, $answerimage="")
Adds a possible answer for a single choice question.
__construct( $title="", $comment="", $author="", $owner=-1, $question="", $output_type=OUTPUT_ORDER)
assSingleChoice constructor
getQuestion()
Gets the question string of the question object.
syncImages()
Sync images of a MC question on synchronisation with the original question.
static convertImage( $a_from, $a_to, $a_target_format="", $a_geometry="", $a_background_color="")
convert image
flushAnswers()
Deletes all answers.
updateCurrentSolution($solutionId, $value1, $value2, $authorized=true)
getAdditionalTableName()
Returns the name of the additional question data table in the database.
lmMigrateQuestionTypeSpecificContent(ilAssSelfAssessmentMigrator $migrator)
Create styles array
The data for the language used.
static getOperatorsByExpression($expression)
saveAnswerSpecificDataToDb()
Saves the answer specific records into a question types answer table.
deductHintPointsFromReachedPoints(ilAssQuestionPreviewSession $previewSession, $reachedPoints)
setPoints($a_points)
Sets the maximum available points for the question.
saveQuestionDataToDb($original_id="")
getRTETextWithMediaObjects()
Collects all text in the question which could contain media objects which were created with the Rich ...
calculateReachedPoints($active_id, $pass=null, $authorizedSolution=true, $returndetails=false)
Returns the points, a learner has reached answering the question.
reworkWorkingData($active_id, $pass, $obligationsAnswered, $authorized)
{}
setImageFile($image_filename, $image_tempfilename="")
Sets the image file and uploads the image to the object's image directory.
setQuestion($question="")
Sets the question string of the question object.
duplicateImages($question_id, $objectId=null)
Interface ilObjQuestionScoringAdjustable.
buildImagePath($questionId, $parentObjectId)
setOriginalId($original_id)
getExpressionTypes()
Get all available expression types for a specific question.
getCurrentSolutionResultSet($active_id, $pass, $authorized=true)
Get a restulset for the current user solution for a this question by active_id and pass...
getTitle()
Gets the title string of the assQuestion object.
Add data(end) time
Method that wraps PHPs time in order to allow simulations with the workflow.
if(!file_exists("$old.txt")) if($old===$new) if(file_exists("$new.txt")) $file
static isObligationPossible($questionId)
returns boolean wether it is possible to set this question type as obligatory or not considering the ...
setTitle($title="")
Sets the title string of the assQuestion object.
setObjId($obj_id=0)
Set the object id of the container object.
static delDir($a_dir, $a_clean_only=false)
removes a dir and all its content (subdirs and files) recursively
setComment($comment="")
Sets the comment string of the assQuestion object.
savePreviewData(ilAssQuestionPreviewSession $previewSession)
setOwner($owner="")
Sets the creator/owner ID of the assQuestion object.
const EmptyAnswerExpression