4 require_once
'Modules/TestQuestionPool/classes/class.assQuestion.php';
5 require_once
'Modules/TestQuestionPool/interfaces/interface.ilObjQuestionScoringAdjustable.php';
6 require_once
'Modules/TestQuestionPool/interfaces/interface.ilObjAnswerScoringAdjustable.php';
7 require_once
'Modules/TestQuestionPool/interfaces/interface.ilAssSpecificFeedbackOptionLabelProvider.php';
55 $this->shuffleAnswersEnabled =
true;
56 $this->answerType = self::ANSWER_TYPE_SINGLE_LINE;
57 $this->thumbSize = self::DEFAULT_THUMB_SIZE;
58 $this->scorePartialSolutionEnabled =
true;
59 $this->optionLabel = self::OPTION_LABEL_RIGHT_WRONG;
60 $this->customTrueOptionLabel =
'';
61 $this->customFalseOptionLabel =
'';
63 require_once
'Modules/TestQuestionPool/classes/feedback/class.ilAssConfigurableMultiOptionQuestionFeedback.php';
66 $this->answers =
array();
73 return 'assKprimChoice';
78 return "qpl_qst_kprim";
180 if($answer->getPosition() == $position)
191 $this->answers[] = $answer;
198 while(
$data = $this->db->fetchAssoc(
$res))
200 $this->
setId($questionId);
214 require_once
'Services/RTE/classes/class.ilRTE.php';
224 if( is_numeric($data[
'thumb_size']) )
237 if( $data[
'score_partsol'] !== null )
242 if( isset($data[
'feedback_setting']) )
258 parent::loadFromDb($questionId);
265 $res = $this->db->queryF(
266 "SELECT * FROM {$this->getAnswerTableName()} WHERE question_fi = %s ORDER BY position ASC",
270 require_once
'Modules/TestQuestionPool/classes/class.ilAssKprimChoiceAnswer.php';
271 require_once
'Services/RTE/classes/class.ilRTE.php';
277 $answer->setPosition(
$data[
'position']);
281 $answer->setImageFile(
$data[
'imagefile']);
286 $answer->setCorrectness(
$data[
'correctness']);
288 $this->answers[$answer->getPosition()] = $answer;
291 for( $i = count($this->answers); $i < self::NUM_REQUIRED_ANSWERS; $i++ )
295 $answer->setPosition($i);
297 $this->answers[$answer->getPosition()] = $answer;
308 parent::saveToDb($originalId);
316 'question_fi' =>
array(
'integer', $this->
getId())
338 'question_fi' =>
array(
'integer', (
int)$this->
getId()),
339 'position' =>
array(
'integer', (
int)$answer->getPosition())
342 'answertext' =>
array(
'text', $answer->getAnswertext()),
343 'imagefile' =>
array(
'text', $answer->getImageFile()),
344 'correctness' =>
array(
'integer', (
int)$answer->getCorrectness())
354 foreach(
array($this->title, $this->author, $this->question) as
$text )
371 if( is_null($answer->getCorrectness()) )
376 if( !strlen($answer->getAnswertext()) && !strlen($answer->getImageFile()) )
400 include_once
"./Modules/Test/classes/class.ilObjTest.php";
406 $this->
getProcessLocker()->executeUserSolutionUpdateLockOperation(
function() use (&$entered_values, $active_id,
$pass, $authorized) {
412 foreach($solutionSubmit as $answerIndex => $answerValue)
422 include_once (
"./Modules/Test/classes/class.ilObjAssessmentFolder.php");
430 include_once (
"./Modules/Test/classes/class.ilObjAssessmentFolder.php");
462 throw new ilTestException(
'return details not implemented for '.__METHOD__);
467 $found_values =
array();
477 $found_values[(int)
$data[
'value1']] = (
int)
$data[
'value2'];
487 return array(self::ANSWER_TYPE_SINGLE_LINE, self::ANSWER_TYPE_MULTI_LINE);
508 self::ANSWER_TYPE_SINGLE_LINE => $lng->
txt(
'answers_singleline'),
509 self::ANSWER_TYPE_MULTI_LINE => $lng->
txt(
'answers_multiline')
516 self::OPTION_LABEL_RIGHT_WRONG,
517 self::OPTION_LABEL_PLUS_MINUS,
518 self::OPTION_LABEL_APPLICABLE_OR_NOT,
519 self::OPTION_LABEL_ADEQUATE_OR_NOT,
520 self::OPTION_LABEL_CUSTOM
527 self::OPTION_LABEL_RIGHT_WRONG => $lng->
txt(
'option_label_right_wrong'),
528 self::OPTION_LABEL_PLUS_MINUS => $lng->
txt(
'option_label_plus_minus'),
529 self::OPTION_LABEL_APPLICABLE_OR_NOT => $lng->
txt(
'option_label_applicable_or_not'),
530 self::OPTION_LABEL_ADEQUATE_OR_NOT => $lng->
txt(
'option_label_adequate_or_not'),
531 self::OPTION_LABEL_CUSTOM => $lng->
txt(
'option_label_custom')
545 case self::OPTION_LABEL_RIGHT_WRONG:
546 return $lng->
txt(
'option_label_right');
548 case self::OPTION_LABEL_PLUS_MINUS:
549 return $lng->
txt(
'option_label_plus');
551 case self::OPTION_LABEL_APPLICABLE_OR_NOT:
552 return $lng->
txt(
'option_label_applicable');
554 case self::OPTION_LABEL_ADEQUATE_OR_NOT:
555 return $lng->
txt(
'option_label_adequate');
557 case self::OPTION_LABEL_CUSTOM:
566 case self::OPTION_LABEL_RIGHT_WRONG:
567 return $lng->
txt(
'option_label_wrong');
569 case self::OPTION_LABEL_PLUS_MINUS:
570 return $lng->
txt(
'option_label_minus');
572 case self::OPTION_LABEL_APPLICABLE_OR_NOT:
573 return $lng->
txt(
'option_label_not_applicable');
575 case self::OPTION_LABEL_ADEQUATE_OR_NOT:
576 return $lng->
txt(
'option_label_not_adequate');
578 case self::OPTION_LABEL_CUSTOM:
586 $lng->
txt(
'kprim_instruction_text'),
594 return $labelValue == self::OPTION_LABEL_CUSTOM;
599 return self::THUMB_PREFIX;
608 if (strlen($answer->getImageFile()))
624 switch (strtoupper($path_info[
'extension']))
646 if( !isset(
$files[$answer->getPosition()]) )
659 if( !file_exists($imagePath) )
681 if( file_exists($answer->getImageFsPath()) )
686 if( file_exists($answer->getThumbFsPath()) )
691 $answer->setImageFile(null);
696 $solutionSubmit =
array();
697 foreach(
$_POST as $key => $value)
701 if(preg_match(
"/^kprim_choice_result_(\d+)/", $key, $matches))
705 $solutionSubmit[$matches[1]] = $value;
709 return $solutionSubmit;
716 foreach($this->
getAnswers() as $key => $answer)
718 if( !isset($found_values[$answer->getPosition()]) )
723 if( $found_values[$answer->getPosition()] == $answer->getCorrectness() )
729 if( $numCorrect >= self::NUM_REQUIRED_ANSWERS )
744 include_once
"./Modules/Test/classes/class.ilObjTest.php";
746 if(($mc_scoring == 0) && (count($found_values) == 0))
762 $this_id = $this->
getId();
766 include_once (
"./Modules/TestQuestionPool/classes/class.assQuestion.php");
770 if( (
int)$testObjId > 0 )
772 $clone->setObjId($testObjId);
799 $clone->copyPageOfQuestion($this_id);
801 $clone->copyXHTMLMediaObjectsOfQuestion($this_id);
803 $clone->cloneAnswerImages($this_id, $thisObjId, $clone->getId(), $clone->getObjId());
805 $clone->onDuplicate($thisObjId, $this_id, $clone->getObjId(), $clone->getId());
818 include_once (
"./Modules/TestQuestionPool/classes/class.assQuestion.php");
821 $sourceParentId = $this->
getObjId();
827 $clone->setObjId($targetParentId);
829 if ($targetQuestionTitle)
831 $clone->setTitle($targetQuestionTitle);
836 $clone->copyPageOfQuestion($sourceQuestionId);
838 $clone->copyXHTMLMediaObjectsOfQuestion($sourceQuestionId);
840 $clone->cloneAnswerImages($sourceQuestionId, $sourceParentId, $clone->getId(), $clone->getObjId());
842 $clone->onCopy($sourceParentId, $sourceQuestionId, $targetParentId, $clone->getId());
859 include_once (
"./Modules/TestQuestionPool/classes/class.assQuestion.php");
862 $source_questionpool_id = $this->
getObjId();
863 $clone->setObjId($target_questionpool_id);
874 $clone->cloneAnswerImages(
$original_id, $source_questionpool_id, $clone->getId(), $clone->getObjId());
876 $clone->onCopy($source_questionpool_id,
$original_id, $clone->getObjId(), $clone->getId());
883 parent::beforeSyncWithOriginal($origQuestionId, $dupQuestionId, $origParentObjId, $dupParentObjId);
885 $question = self::_instanciateQuestion($origQuestionId);
887 foreach(
$question->getAnswers() as $answer)
889 $question->removeAnswerImage($answer->getPosition());
895 parent::afterSyncWithOriginal($origQuestionId, $dupQuestionId, $origParentObjId, $dupParentObjId);
897 $this->cloneAnswerImages($dupQuestionId, $dupParentObjId, $origQuestionId, $origParentObjId);
900 protected function cloneAnswerImages($sourceQuestionId, $sourceParentId, $targetQuestionId, $targetParentId)
905 $sourcePath = $this->
buildImagePath($sourceQuestionId, $sourceParentId);
906 $targetPath = $this->
buildImagePath($targetQuestionId, $targetParentId);
914 if(!file_exists($targetPath))
921 if(!copy($sourcePath . $filename, $targetPath . $filename))
923 $ilLog->warning(sprintf(
924 "Could not clone source image '%s' to '%s' (srcQuestionId: %s|tgtQuestionId: %s|srcParentObjId: %s|tgtParentObjId: %s)",
925 $sourcePath . $filename, $targetPath . $filename,
926 $sourceQuestionId, $targetQuestionId, $sourceParentId, $targetParentId
931 if(file_exists($sourcePath . $this->
getThumbPrefix() . $filename))
935 $ilLog->warning(sprintf(
936 "Could not clone thumbnail source image '%s' to '%s' (srcQuestionId: %s|tgtQuestionId: %s|srcParentObjId: %s|tgtParentObjId: %s)",
938 $sourceQuestionId, $targetQuestionId, $sourceParentId, $targetParentId
948 $combinedText = parent::getRTETextWithMediaObjects();
952 $combinedText .= $answer->getAnswertext();
955 return $combinedText;
975 $this->lng->loadLanguageModule(
'assessment');
977 require_once
'./Services/RTE/classes/class.ilRTE.php';
989 'onenotcorrect' => $this->
formatSAQuestion($this->feedbackOBJ->getGenericFeedbackTestPresentation($this->getId(),
false)),
990 'allcorrect' => $this->
formatSAQuestion($this->feedbackOBJ->getGenericFeedbackTestPresentation($this->getId(),
true))
1001 foreach( $this->
getAnswers() as $key => $answer )
1003 if( strlen((
string)$answer->getImageFile()) )
1009 'answertext' => (
string) $this->
formatSAQuestion($answer->getAnswertext()),
1010 'correctness' => (
bool) $answer->getCorrectness(),
1011 'order' => (int)$answer->getPosition(),
1012 'image' => (
string)$answer->getImageFile(),
1014 $this->feedbackOBJ->getSpecificAnswerFeedbackExportPresentation($this->getId(), $key)
1028 $result[
'mobs'] =
$mobs;
1030 return json_encode($result);
1037 return self::NUM_REQUIRED_ANSWERS - self::PARTIAL_SCORING_NUM_CORRECT_ANSWERS;
1045 return 'feedback_correct_kprim';
1057 return $numExistingSolutionRecords >= 4;
1065 parent::setExportDetailsXLS(
$worksheet, $startrow, $active_id,
$pass);
1072 $worksheet->setCell($startrow + $i, 0, $answer->getAnswertext());
1074 $correctness = FALSE;
1075 foreach($solution as $solutionvalue)
1077 if(
$id == $solutionvalue[
'value1'])
1079 $correctness = $solutionvalue[
'value2'];
1083 $worksheet->setCell($startrow + $i, 1, $correctness);
1087 return $startrow + $i + 1;
1092 if( $position < 0 || $position >= (self::NUM_REQUIRED_ANSWERS - 1) )
1097 for($i = 0, $max = count($this->answers); $i < $max; $i++)
1099 if( $i == $position )
1101 $movingAnswer = $this->answers[$i];
1102 $targetAnswer = $this->answers[ $i + 1 ];
1104 $movingAnswer->setPosition( $position + 1 );
1105 $targetAnswer->setPosition( $position );
1107 $this->answers[ $i + 1 ] = $movingAnswer;
1108 $this->answers[$i] = $targetAnswer;
1115 if( $position <= 0 || $position > (self::NUM_REQUIRED_ANSWERS - 1) )
1120 for($i = 0, $max = count($this->answers); $i < $max; $i++)
1122 if( $i == $position )
1124 $movingAnswer = $this->answers[$i];
1125 $targetAnswer = $this->answers[ $i - 1 ];
1127 $movingAnswer->setPosition( $position - 1 );
1128 $targetAnswer->setPosition( $position );
1130 $this->answers[ $i - 1 ] = $movingAnswer;
1131 $this->answers[$i] = $targetAnswer;
getValidOptionLabelsTranslated(ilLanguage $lng)
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.
getId()
Gets the id of the assQuestion object.
setImageFsDir($imageFsDir)
static _getOriginalId($question_id)
Returns the original id of a question.
formatSAQuestion($a_q)
Format self assessment question.
isValidAnswerType($answerType)
reworkWorkingData($active_id, $pass, $obligationsAnswered, $authorized)
{}
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...
buildHashedImageFilename($plain_image_filename, $unique=false)
saveAnswerSpecificDataToDb()
Saves the answer specific records into a question types answer table.
getRTETextWithMediaObjects()
setScorePartialSolutionEnabled($scorePartialSolutionEnabled)
getPoints()
Returns the maximum available points for the question.
static isObligationPossible($questionId)
const OPTION_LABEL_RIGHT_WRONG
isCustomOptionLabel($labelValue)
Abstract basic class which is to be extended by the concrete assessment question type classes...
__construct($title='', $comment='', $author='', $owner=-1, $question='')
const OPTION_LABEL_ADEQUATE_OR_NOT
$GLOBALS['loaded']
Global hash that tracks already loaded includes.
setId($id=-1)
Sets the id of the assQuestion object.
const NUM_REQUIRED_ANSWERS
getImagePathWeb()
Returns the web image path for web accessable images of a question.
const PARTIAL_SCORING_NUM_CORRECT_ANSWERS
removeAnswerImage($position)
getSolutionMaxPass($active_id)
Returns the maximum pass a users question solution.
lmMigrateQuestionTypeSpecificContent(ilAssSelfAssessmentMigrator $migrator)
getSpecificFeedbackSetting()
migrateToLmContent($content)
moveAnswerDown($position)
Add rich text string
The name of the decorator.
copyObject($target_questionpool_id, $title="")
Copies an assMultipleChoice object.
getSpecificFeedbackAllCorrectOptionLabel()
getMaximumPoints()
Returns the maximum points, a learner can reach answering the question.
setEstimatedWorkingTimeFromDurationString($durationString)
Sets the estimated working time of a question from a given datetime string.
setNrOfTries($a_nr_of_tries)
setAdditionalContentEditingMode($additinalContentEditingMode)
setter for additional content editing mode for this question
setCustomTrueOptionLabel($customTrueOptionLabel)
isValidOptionLabel($optionLabel)
loadAnswerData($questionId)
getTrueOptionLabelTranslation(ilLanguage $lng, $optionLabel)
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...
getObjId()
Get the object id of the container object.
beforeSyncWithOriginal($origQuestionId, $dupQuestionId, $origParentObjId, $dupParentObjId)
addAnswer(ilAssKprimChoiceAnswer $answer)
Base Exception for all Exceptions relating to Modules/Test.
setOptionLabel($optionLabel)
static _getLogLanguage()
retrieve the log language for assessment logging
const ANSWER_TYPE_MULTI_LINE
isScorePartialSolutionEnabled()
setAuthor($author="")
Sets the authors name of the assQuestion object.
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.
isSingleLineAnswerType($answerType)
getAnswerTypeSelectOptions(ilLanguage $lng)
saveCurrentSolution($active_id, $pass, $value1, $value2, $authorized=true, $tstamp=null)
static moveUploadedFile($a_file, $a_name, $a_target, $a_raise_errors=true, $a_mode="move_uploaded")
move uploaded file
duplicate($for_test=true, $title="", $author="", $owner="", $testObjId=null)
isShuffleAnswersEnabled()
createNewOriginalFromThisDuplicate($targetParentId, $targetQuestionTitle="")
setShuffleAnswersEnabled($shuffleAnswersEnabled)
Interface ilObjAnswerScoringAdjustable.
const OPTION_LABEL_APPLICABLE_OR_NOT
saveWorkingData($active_id, $pass=NULL, $authorized=true)
Saves the learners input of the question to the database.
getCustomFalseOptionLabel()
handleFileUploads($answers, $files)
getQuestion()
Gets the question string of the question object.
isAnswered($active_id, $pass=null)
setExportDetailsXLS($worksheet, $startrow, $active_id, $pass)
{}
calculateReachedPoints($active_id, $pass=NULL, $authorizedSolution=true, $returndetails=FALSE)
Returns the points, a learner has reached answering the question.
Create styles array
The data for the language used.
setPoints($a_points)
Sets the maximum available points for the question.
saveQuestionDataToDb($original_id="")
setCustomFalseOptionLabel($customFalseOptionLabel)
getFalseOptionLabelTranslation(ilLanguage $lng, $optionLabel)
const OPTION_LABEL_CUSTOM
calculateReachedPointsForSolution($found_values, $active_id=0)
setQuestion($question="")
Sets the question string of the question object.
const FEEDBACK_SETTING_ALL
static convertImage($a_from, $a_to, $a_target_format="", $a_geometry="", $a_background_color="")
convert image
Interface ilObjQuestionScoringAdjustable.
removeCurrentSolution($active_id, $pass, $authorized=true)
setSpecificFeedbackSetting($specificFeedbackSetting)
static _getMCScoring($active_id)
Gets the scoring type for multiple choice questions.
buildImagePath($questionId, $parentObjectId)
setOriginalId($original_id)
generateThumbForFile($path, $file)
setLastChange($lastChange)
getCurrentSolutionResultSet($active_id, $pass, $authorized=true)
Get a restulset for the current user solution for a this question by active_id and pass...
getCustomTrueOptionLabel()
getSolutionValues($active_id, $pass=NULL, $authorized=true)
Loads solutions of a given user from the database an returns it.
getTitle()
Gets the title string of the assQuestion object.
handleFileUpload(ilAssKprimChoiceAnswer $answer, $fileData)
saveAdditionalQuestionDataToDb()
Saves a record to the question types additional data table.
if(!file_exists("$old.txt")) if($old===$new) if(file_exists("$new.txt")) $file
$scorePartialSolutionEnabled
txt($a_topic, $a_default_lang_fallback_mod="")
gets the text for a given topic if the topic is not in the list, the topic itself with "-" will be re...
const OPTION_LABEL_PLUS_MINUS
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.
setAnswerType($answerType)
getInstructionTextTranslation(ilLanguage $lng, $optionLabel)
const ANSWER_TYPE_SINGLE_LINE
toJSON()
Returns a JSON representation of the question.
setOwner($owner="")
Sets the creator/owner ID of the assQuestion object.
afterSyncWithOriginal($origQuestionId, $dupQuestionId, $origParentObjId, $dupParentObjId)