class.assKprimChoice.php

Go to the documentation of this file.

<?php
/* Copyright (c) 1998-2013 ILIAS open source, Extended GPL, see docs/LICENSE */

require_once 'Modules/TestQuestionPool/classes/class.assQuestion.php';
require_once 'Modules/TestQuestionPool/interfaces/interface.ilObjQuestionScoringAdjustable.php';
require_once 'Modules/TestQuestionPool/interfaces/interface.ilObjAnswerScoringAdjustable.php';
require_once 'Modules/TestQuestionPool/interfaces/interface.ilAssSpecificFeedbackOptionLabelProvider.php';

class assKprimChoice extends assQuestion implements ilObjQuestionScoringAdjustable, ilObjAnswerScoringAdjustable, ilAssSpecificFeedbackOptionLabelProvider
{
    const NUM_REQUIRED_ANSWERS = 4;
    
    const PARTIAL_SCORING_NUM_CORRECT_ANSWERS = 3;
    
    const ANSWER_TYPE_SINGLE_LINE = 'singleLine';
    const ANSWER_TYPE_MULTI_LINE = 'multiLine';
    
    const OPTION_LABEL_RIGHT_WRONG = 'right_wrong';
    const OPTION_LABEL_PLUS_MINUS = 'plus_minus';
    const OPTION_LABEL_APPLICABLE_OR_NOT = 'applicable_or_not';
    const OPTION_LABEL_ADEQUATE_OR_NOT = 'adequate_or_not';
    const OPTION_LABEL_CUSTOM = 'customlabel';
    
    const DEFAULT_THUMB_SIZE = 150;
    const THUMB_PREFIX = 'thumb.';

    private $shuffleAnswersEnabled;
    
    private $answerType;
    
    private $thumbSize;

    private $scorePartialSolutionEnabled;
    
    private $optionLabel;
    
    private $customTrueOptionLabel;
    
    private $customFalseOptionLabel;

    private $specificFeedbackSetting;
    
    private $answers;
    
    public function __construct($title = '', $comment = '', $author = '', $owner = -1, $question = '')
    {
        parent::__construct($title, $comment, $author, $owner, $question);

        $this->shuffleAnswersEnabled = true;
        $this->answerType = self::ANSWER_TYPE_SINGLE_LINE;
        $this->thumbSize = self::DEFAULT_THUMB_SIZE;
        $this->scorePartialSolutionEnabled = true;
        $this->optionLabel = self::OPTION_LABEL_RIGHT_WRONG;
        $this->customTrueOptionLabel = '';
        $this->customFalseOptionLabel = '';
        
        require_once 'Modules/TestQuestionPool/classes/feedback/class.ilAssConfigurableMultiOptionQuestionFeedback.php';
        $this->specificFeedbackSetting = ilAssConfigurableMultiOptionQuestionFeedback::FEEDBACK_SETTING_ALL;
        
        $this->answers = array();
        
        $this->setPoints('');
    }
    
    public function getQuestionType()
    {
        return 'assKprimChoice';
    }
    
    public function getAdditionalTableName()
    {
        return "qpl_qst_kprim";
    }

    public function getAnswerTableName()
    {
        return "qpl_a_kprim";
    }

    public function setShuffleAnswersEnabled($shuffleAnswersEnabled)
    {
        $this->shuffleAnswersEnabled = $shuffleAnswersEnabled;
    }

    public function isShuffleAnswersEnabled()
    {
        return $this->shuffleAnswersEnabled;
    }

    public function setAnswerType($answerType)
    {
        $this->answerType = $answerType;
    }

    public function getAnswerType()
    {
        return $this->answerType;
    }

    public function setThumbSize($thumbSize)
    {
        $this->thumbSize = $thumbSize;
    }

    public function getThumbSize()
    {
        return $this->thumbSize;
    }

    public function setScorePartialSolutionEnabled($scorePartialSolutionEnabled)
    {
        $this->scorePartialSolutionEnabled = $scorePartialSolutionEnabled;
    }

    public function isScorePartialSolutionEnabled()
    {
        return $this->scorePartialSolutionEnabled;
    }

    public function setOptionLabel($optionLabel)
    {
        $this->optionLabel = $optionLabel;
    }

    public function getOptionLabel()
    {
        return $this->optionLabel;
    }

    public function setCustomTrueOptionLabel($customTrueOptionLabel)
    {
        $this->customTrueOptionLabel = $customTrueOptionLabel;
    }

    public function getCustomTrueOptionLabel()
    {
        return $this->customTrueOptionLabel;
    }

    public function setCustomFalseOptionLabel($customFalseOptionLabel)
    {
        $this->customFalseOptionLabel = $customFalseOptionLabel;
    }

    public function getCustomFalseOptionLabel()
    {
        return $this->customFalseOptionLabel;
    }

    public function setSpecificFeedbackSetting($specificFeedbackSetting)
    {
        $this->specificFeedbackSetting = $specificFeedbackSetting;
    }

    public function getSpecificFeedbackSetting()
    {
        return $this->specificFeedbackSetting;
    }

    public function setAnswers($answers)
    {
        $this->answers = $answers;
    }

    public function getAnswers()
    {
        return $this->answers;
    }
    
    public function getAnswer($position)
    {
        foreach ($this->getAnswers() as $answer) {
            if ($answer->getPosition() == $position) {
                return $answer;
            }
        }
        
        return null;
    }
    
    public function addAnswer(ilAssKprimChoiceAnswer $answer)
    {
        $this->answers[] = $answer;
    }
    
    public function loadFromDb($questionId)
    {
        $res = $this->db->queryF($this->buildQuestionDataQuery(), array('integer'), array($questionId));
        
        while ($data = $this->db->fetchAssoc($res)) {
            $this->setId($questionId);

            $this->setOriginalId($data['original_id']);

            $this->setObjId($data['obj_fi']);

            $this->setTitle($data['title']);
            $this->setNrOfTries($data['nr_of_tries']);
            $this->setComment($data['description']);
            $this->setAuthor($data['author']);
            $this->setPoints($data['points']);
            $this->setOwner($data['owner']);
            $this->setEstimatedWorkingTimeFromDurationString($data['working_time']);
            $this->setLastChange($data['tstamp']);
            require_once 'Services/RTE/classes/class.ilRTE.php';
            $this->setQuestion(ilRTE::_replaceMediaObjectImageSrc($data['question_text'], 1));

            $this->setShuffleAnswersEnabled((bool) $data['shuffle_answers']);
            
            if ($this->isValidAnswerType($data['answer_type'])) {
                $this->setAnswerType($data['answer_type']);
            }
            
            if (is_numeric($data['thumb_size'])) {
                $this->setThumbSize((int) $data['thumb_size']);
            }
            
            if ($this->isValidOptionLabel($data['opt_label'])) {
                $this->setOptionLabel($data['opt_label']);
            }
            
            $this->setCustomTrueOptionLabel($data['custom_true']);
            $this->setCustomFalseOptionLabel($data['custom_false']);
            
            if ($data['score_partsol'] !== null) {
                $this->setScorePartialSolutionEnabled((bool) $data['score_partsol']);
            }

            if (isset($data['feedback_setting'])) {
                $this->setSpecificFeedbackSetting((int) $data['feedback_setting']);
            }
            
            try {
                $this->setAdditionalContentEditingMode($data['add_cont_edit_mode']);
            } catch (ilTestQuestionPoolException $e) {
            }
        }

        $this->loadAnswerData($questionId);

        parent::loadFromDb($questionId);
    }
    
    private function loadAnswerData($questionId)
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];

        $res = $this->db->queryF(
            "SELECT * FROM {$this->getAnswerTableName()} WHERE question_fi = %s ORDER BY position ASC",
            array('integer'),
            array($questionId)
        );

        require_once 'Modules/TestQuestionPool/classes/class.ilAssKprimChoiceAnswer.php';
        require_once 'Services/RTE/classes/class.ilRTE.php';

        while ($data = $ilDB->fetchAssoc($res)) {
            $answer = new ilAssKprimChoiceAnswer();

            $answer->setPosition($data['position']);
            
            $answer->setAnswertext(ilRTE::_replaceMediaObjectImageSrc($data['answertext'], 1));
            
            $answer->setImageFile($data['imagefile']);
            $answer->setThumbPrefix($this->getThumbPrefix());
            $answer->setImageFsDir($this->getImagePath());
            $answer->setImageWebDir($this->getImagePathWeb());
            
            $answer->setCorrectness($data['correctness']);

            $this->answers[$answer->getPosition()] = $answer;
        }
        
        for ($i = count($this->answers); $i < self::NUM_REQUIRED_ANSWERS; $i++) {
            $answer = new ilAssKprimChoiceAnswer();
            
            $answer->setPosition($i);

            $this->answers[$answer->getPosition()] = $answer;
        }
    }

    public function saveToDb($originalId = '')
    {
        $this->saveQuestionDataToDb($originalId);
        
        $this->saveAdditionalQuestionDataToDb();
        $this->saveAnswerSpecificDataToDb();

        parent::saveToDb($originalId);
    }

    public function saveAdditionalQuestionDataToDb()
    {
        $this->db->replace(
            $this->getAdditionalTableName(),
            array(
                'question_fi' => array('integer', $this->getId())
            ),
            array(
                'shuffle_answers' => array('integer', (int) $this->isShuffleAnswersEnabled()),
                'answer_type' => array('text', $this->getAnswerType()),
                'thumb_size' => array('integer', (int) $this->getThumbSize()),
                'opt_label' => array('text', $this->getOptionLabel()),
                'custom_true' => array('text', $this->getCustomTrueOptionLabel()),
                'custom_false' => array('text', $this->getCustomFalseOptionLabel()),
                'score_partsol' => array('integer', (int) $this->isScorePartialSolutionEnabled()),
                'feedback_setting' => array('integer', (int) $this->getSpecificFeedbackSetting())
            )
        );
    }

    public function saveAnswerSpecificDataToDb()
    {
        foreach ($this->getAnswers() as $answer) {
            $this->db->replace(
                $this->getAnswerTableName(),
                array(
                    'question_fi' => array('integer', (int) $this->getId()),
                    'position' => array('integer', (int) $answer->getPosition())
                ),
                array(
                    'answertext' => array('text', $answer->getAnswertext()),
                    'imagefile' => array('text', $answer->getImageFile()),
                    'correctness' => array('integer', (int) $answer->getCorrectness())
                )
            );
        }
        
        $this->rebuildThumbnails();
    }
    
    public function isComplete()
    {
        foreach (array($this->title, $this->author, $this->question) as $text) {
            if (!strlen($text)) {
                return false;
            }
        }
        
        if ($this->getMaximumPoints() <= 0) {
            return false;
        }

        foreach ($this->getAnswers() as $answer) {
            /* @var ilAssKprimChoiceAnswer $answer */
            
            if (is_null($answer->getCorrectness())) {
                return false;
            }
            
            if (!strlen($answer->getAnswertext()) && !strlen($answer->getImageFile())) {
                return false;
            }
        }

        return true;
    }

    public function saveWorkingData($active_id, $pass = null, $authorized = true)
    {
        $ilDB = $GLOBALS['DIC']['ilDB'];

        if (is_null($pass)) {
            include_once "./Modules/Test/classes/class.ilObjTest.php";
            $pass = ilObjTest::_getPass($active_id);
        }

        $entered_values = 0;

        $this->getProcessLocker()->executeUserSolutionUpdateLockOperation(function () use (&$entered_values, $active_id, $pass, $authorized) {
            $this->removeCurrentSolution($active_id, $pass, $authorized);

            $solutionSubmit = $this->getSolutionSubmit();

            foreach ($solutionSubmit as $answerIndex => $answerValue) {
                $this->saveCurrentSolution($active_id, $pass, (int) $answerIndex, (int) $answerValue, $authorized);
                $entered_values++;
            }
        });

        if ($entered_values) {
            include_once("./Modules/Test/classes/class.ilObjAssessmentFolder.php");
            if (ilObjAssessmentFolder::_enabledAssessmentLogging()) {
                assQuestion::logAction($this->lng->txtlng("assessment", "log_user_entered_values", ilObjAssessmentFolder::_getLogLanguage()), $active_id, $this->getId());
            }
        } else {
            include_once("./Modules/Test/classes/class.ilObjAssessmentFolder.php");
            if (ilObjAssessmentFolder::_enabledAssessmentLogging()) {
                assQuestion::logAction($this->lng->txtlng("assessment", "log_user_not_entered_values", ilObjAssessmentFolder::_getLogLanguage()), $active_id, $this->getId());
            }
        }

        return true;
    }

    public function calculateReachedPoints($active_id, $pass = null, $authorizedSolution = true, $returndetails = false)
    {
        if ($returndetails) {
            throw new ilTestException('return details not implemented for ' . __METHOD__);
        }

        global $DIC;
        $ilDB = $DIC['ilDB'];

        $found_values = array();
        if (is_null($pass)) {
            $pass = $this->getSolutionMaxPass($active_id);
        }
        
        $result = $this->getCurrentSolutionResultSet($active_id, $pass, $authorizedSolution);

        while ($data = $ilDB->fetchAssoc($result)) {
            $found_values[(int) $data['value1']] = (int) $data['value2'];
        }

        $points = $this->calculateReachedPointsForSolution($found_values, $active_id);

        return $points;
    }
    
    public function getValidAnswerTypes()
    {
        return array(self::ANSWER_TYPE_SINGLE_LINE, self::ANSWER_TYPE_MULTI_LINE);
    }
    
    public function isValidAnswerType($answerType)
    {
        $validTypes = $this->getValidAnswerTypes();
        return in_array($answerType, $validTypes);
    }
    
    public function isSingleLineAnswerType($answerType)
    {
        return $answerType == assKprimChoice::ANSWER_TYPE_SINGLE_LINE;
    }

    public function getAnswerTypeSelectOptions(ilLanguage $lng)
    {
        return array(
            self::ANSWER_TYPE_SINGLE_LINE => $lng->txt('answers_singleline'),
            self::ANSWER_TYPE_MULTI_LINE => $lng->txt('answers_multiline')
        );
    }

    public function getValidOptionLabels()
    {
        return array(
            self::OPTION_LABEL_RIGHT_WRONG,
            self::OPTION_LABEL_PLUS_MINUS,
            self::OPTION_LABEL_APPLICABLE_OR_NOT,
            self::OPTION_LABEL_ADEQUATE_OR_NOT,
            self::OPTION_LABEL_CUSTOM
        );
    }

    public function getValidOptionLabelsTranslated(ilLanguage $lng)
    {
        return array(
            self::OPTION_LABEL_RIGHT_WRONG => $lng->txt('option_label_right_wrong'),
            self::OPTION_LABEL_PLUS_MINUS => $lng->txt('option_label_plus_minus'),
            self::OPTION_LABEL_APPLICABLE_OR_NOT => $lng->txt('option_label_applicable_or_not'),
            self::OPTION_LABEL_ADEQUATE_OR_NOT => $lng->txt('option_label_adequate_or_not'),
            self::OPTION_LABEL_CUSTOM => $lng->txt('option_label_custom')
        );
    }
    
    public function isValidOptionLabel($optionLabel)
    {
        $validLabels = $this->getValidOptionLabels();
        return in_array($optionLabel, $validLabels);
    }

    public function getTrueOptionLabelTranslation(ilLanguage $lng, $optionLabel)
    {
        switch ($optionLabel) {
            case self::OPTION_LABEL_RIGHT_WRONG:
                return $lng->txt('option_label_right');

            case self::OPTION_LABEL_PLUS_MINUS:
                return $lng->txt('option_label_plus');

            case self::OPTION_LABEL_APPLICABLE_OR_NOT:
                return $lng->txt('option_label_applicable');

            case self::OPTION_LABEL_ADEQUATE_OR_NOT:
                return $lng->txt('option_label_adequate');

            case self::OPTION_LABEL_CUSTOM:
                return $this->getCustomTrueOptionLabel();
        }
    }

    public function getFalseOptionLabelTranslation(ilLanguage $lng, $optionLabel)
    {
        switch ($optionLabel) {
            case self::OPTION_LABEL_RIGHT_WRONG:
                return $lng->txt('option_label_wrong');

            case self::OPTION_LABEL_PLUS_MINUS:
                return $lng->txt('option_label_minus');

            case self::OPTION_LABEL_APPLICABLE_OR_NOT:
                return $lng->txt('option_label_not_applicable');

            case self::OPTION_LABEL_ADEQUATE_OR_NOT:
                return $lng->txt('option_label_not_adequate');

            case self::OPTION_LABEL_CUSTOM:
                return $this->getCustomFalseOptionLabel();
        }
    }
    
    public function getInstructionTextTranslation(ilLanguage $lng, $optionLabel)
    {
        return sprintf(
            $lng->txt('kprim_instruction_text'),
            $this->getTrueOptionLabelTranslation($lng, $optionLabel),
            $this->getFalseOptionLabelTranslation($lng, $optionLabel)
        );
    }
    
    public function isCustomOptionLabel($labelValue)
    {
        return $labelValue == self::OPTION_LABEL_CUSTOM;
    }

    public function getThumbPrefix()
    {
        return self::THUMB_PREFIX;
    }

    public function rebuildThumbnails()
    {
        if ($this->isSingleLineAnswerType($this->getAnswerType()) && $this->getThumbSize()) {
            foreach ($this->getAnswers() as $answer) {
                if (strlen($answer->getImageFile())) {
                    $this->generateThumbForFile($answer->getImageFsDir(), $answer->getImageFile());
                }
            }
        }
    }
    
    protected function generateThumbForFile($path, $file)
    {
        $filename = $path . $file;
        if (@file_exists($filename)) {
            $thumbpath = $path . $this->getThumbPrefix() . $file;
            $path_info = @pathinfo($filename);
            $ext = "";
            switch (strtoupper($path_info['extension'])) {
                case 'PNG':
                    $ext = 'PNG';
                    break;
                case 'GIF':
                    $ext = 'GIF';
                    break;
                default:
                    $ext = 'JPEG';
                    break;
            }
            ilUtil::convertImage($filename, $thumbpath, $ext, $this->getThumbSize());
        }
    }

    public function handleFileUploads($answers, $files)
    {
        foreach ($answers as $answer) {
            /* @var ilAssKprimChoiceAnswer $answer */
            
            if (!isset($files[$answer->getPosition()])) {
                continue;
            }
            
            $this->handleFileUpload($answer, $files[$answer->getPosition()]);
        }
    }
    
    private function handleFileUpload(ilAssKprimChoiceAnswer $answer, $fileData)
    {
        $imagePath = $this->getImagePath();

        if (!file_exists($imagePath)) {
            ilUtil::makeDirParents($imagePath);
        }
        
        $filename = $this->buildHashedImageFilename($fileData['name'], true);

        $answer->setImageFsDir($imagePath);
        $answer->setImageFile($filename);

        if (!ilUtil::moveUploadedFile($fileData['tmp_name'], $fileData['name'], $answer->getImageFsPath())) {
            return 2;
        }
        
        return 0;
    }
    
    public function removeAnswerImage($position)
    {
        $answer = $this->getAnswer($position);
        
        if (file_exists($answer->getImageFsPath())) {
            ilUtil::delDir($answer->getImageFsPath());
        }
        
        if (file_exists($answer->getThumbFsPath())) {
            ilUtil::delDir($answer->getThumbFsPath());
        }

        $answer->setImageFile(null);
    }

    protected function getSolutionSubmit()
    {
        $solutionSubmit = array();
        foreach ($_POST as $key => $value) {
            $matches = null;
            
            if (preg_match("/^kprim_choice_result_(\d+)/", $key, $matches)) {
                if (strlen($value)) {
                    $solutionSubmit[$matches[1]] = $value;
                }
            }
        }
        return $solutionSubmit;
    }

    protected function calculateReachedPointsForSolution($found_values, $active_id = 0)
    {
        $numCorrect = 0;
        
        foreach ($this->getAnswers() as $key => $answer) {
            if (!isset($found_values[$answer->getPosition()])) {
                continue;
            }
            
            if ($found_values[$answer->getPosition()] == $answer->getCorrectness()) {
                $numCorrect++;
            }
        }
        
        if ($numCorrect >= self::NUM_REQUIRED_ANSWERS) {
            $points = $this->getPoints();
        } elseif ($this->isScorePartialSolutionEnabled() && $numCorrect >= self::PARTIAL_SCORING_NUM_CORRECT_ANSWERS) {
            $points = $this->getPoints() / 2;
        } else {
            $points = 0;
        }
        
        if ($active_id) {
            include_once "./Modules/Test/classes/class.ilObjTest.php";
            $mc_scoring = ilObjTest::_getMCScoring($active_id);
            if (($mc_scoring == 0) && (count($found_values) == 0)) {
                $points = 0;
            }
        }
        return $points;
    }
    
    public function duplicate($for_test = true, $title = "", $author = "", $owner = "", $testObjId = null)
    {
        if ($this->id <= 0) {
            // The question has not been saved. It cannot be duplicated
            return;
        }
        // duplicate the question in database
        $this_id = $this->getId();
        $thisObjId = $this->getObjId();

        $clone = $this;
        include_once("./Modules/TestQuestionPool/classes/class.assQuestion.php");
        $original_id = assQuestion::_getOriginalId($this->id);
        $clone->id = -1;

        if ((int) $testObjId > 0) {
            $clone->setObjId($testObjId);
        }

        if ($title) {
            $clone->setTitle($title);
        }

        if ($author) {
            $clone->setAuthor($author);
        }
        if ($owner) {
            $clone->setOwner($owner);
        }

        if ($for_test) {
            $clone->saveToDb($original_id);
        } else {
            $clone->saveToDb();
        }

        // copy question page content
        $clone->copyPageOfQuestion($this_id);
        // copy XHTML media objects
        $clone->copyXHTMLMediaObjectsOfQuestion($this_id);
        // duplicate the images
        $clone->cloneAnswerImages($this_id, $thisObjId, $clone->getId(), $clone->getObjId());

        $clone->onDuplicate($thisObjId, $this_id, $clone->getObjId(), $clone->getId());

        return $clone->id;
    }

    public function createNewOriginalFromThisDuplicate($targetParentId, $targetQuestionTitle = "")
    {
        if ($this->id <= 0) {
            // The question has not been saved. It cannot be duplicated
            return;
        }

        include_once("./Modules/TestQuestionPool/classes/class.assQuestion.php");

        $sourceQuestionId = $this->id;
        $sourceParentId = $this->getObjId();

        // duplicate the question in database
        $clone = $this;
        $clone->id = -1;

        $clone->setObjId($targetParentId);

        if ($targetQuestionTitle) {
            $clone->setTitle($targetQuestionTitle);
        }

        $clone->saveToDb();
        // copy question page content
        $clone->copyPageOfQuestion($sourceQuestionId);
        // copy XHTML media objects
        $clone->copyXHTMLMediaObjectsOfQuestion($sourceQuestionId);
        // duplicate the image
        $clone->cloneAnswerImages($sourceQuestionId, $sourceParentId, $clone->getId(), $clone->getObjId());

        $clone->onCopy($sourceParentId, $sourceQuestionId, $targetParentId, $clone->getId());

        return $clone->id;
    }

    public function copyObject($target_questionpool_id, $title = "")
    {
        if ($this->id <= 0) {
            // The question has not been saved. It cannot be duplicated
            return;
        }
        // duplicate the question in database
        $clone = $this;
        include_once("./Modules/TestQuestionPool/classes/class.assQuestion.php");
        $original_id = assQuestion::_getOriginalId($this->id);
        $clone->id = -1;
        $source_questionpool_id = $this->getObjId();
        $clone->setObjId($target_questionpool_id);
        if ($title) {
            $clone->setTitle($title);
        }
        $clone->saveToDb();
        // copy question page content
        $clone->copyPageOfQuestion($original_id);
        // copy XHTML media objects
        $clone->copyXHTMLMediaObjectsOfQuestion($original_id);
        // duplicate the image
        $clone->cloneAnswerImages($original_id, $source_questionpool_id, $clone->getId(), $clone->getObjId());

        $clone->onCopy($source_questionpool_id, $original_id, $clone->getObjId(), $clone->getId());

        return $clone->id;
    }

    protected function beforeSyncWithOriginal($origQuestionId, $dupQuestionId, $origParentObjId, $dupParentObjId)
    {
        parent::beforeSyncWithOriginal($origQuestionId, $dupQuestionId, $origParentObjId, $dupParentObjId);
        
        $question = self::_instanciateQuestion($origQuestionId);

        foreach ($question->getAnswers() as $answer) {
            $question->removeAnswerImage($answer->getPosition());
        }
    }

    protected function afterSyncWithOriginal($origQuestionId, $dupQuestionId, $origParentObjId, $dupParentObjId)
    {
        parent::afterSyncWithOriginal($origQuestionId, $dupQuestionId, $origParentObjId, $dupParentObjId);
        
        $this->cloneAnswerImages($dupQuestionId, $dupParentObjId, $origQuestionId, $origParentObjId);
    }

    protected function cloneAnswerImages($sourceQuestionId, $sourceParentId, $targetQuestionId, $targetParentId)
    {
        global $DIC;
        $ilLog = $DIC['ilLog'];

        $sourcePath = $this->buildImagePath($sourceQuestionId, $sourceParentId);
        $targetPath = $this->buildImagePath($targetQuestionId, $targetParentId);

        foreach ($this->getAnswers() as $answer) {
            $filename = $answer->getImageFile();
            
            if (strlen($filename)) {
                if (!file_exists($targetPath)) {
                    ilUtil::makeDirParents($targetPath);
                }

                if (file_exists($sourcePath . $filename)) {
                    if (!copy($sourcePath . $filename, $targetPath . $filename)) {
                        $ilLog->warning(sprintf(
                            "Could not clone source image '%s' to '%s' (srcQuestionId: %s|tgtQuestionId: %s|srcParentObjId: %s|tgtParentObjId: %s)",
                            $sourcePath . $filename,
                            $targetPath . $filename,
                            $sourceQuestionId,
                            $targetQuestionId,
                            $sourceParentId,
                            $targetParentId
                        ));
                    }
                }

                if (file_exists($sourcePath . $this->getThumbPrefix() . $filename)) {
                    if (!copy($sourcePath . $this->getThumbPrefix() . $filename, $targetPath . $this->getThumbPrefix() . $filename)) {
                        $ilLog->warning(sprintf(
                            "Could not clone thumbnail source image '%s' to '%s' (srcQuestionId: %s|tgtQuestionId: %s|srcParentObjId: %s|tgtParentObjId: %s)",
                            $sourcePath . $this->getThumbPrefix() . $filename,
                            $targetPath . $this->getThumbPrefix() . $filename,
                            $sourceQuestionId,
                            $targetQuestionId,
                            $sourceParentId,
                            $targetParentId
                        ));
                    }
                }
            }
        }
    }

    protected function getRTETextWithMediaObjects()
    {
        $combinedText = parent::getRTETextWithMediaObjects();
        
        foreach ($this->getAnswers() as $answer) {
            $combinedText .= $answer->getAnswertext();
        }
        
        return $combinedText;
    }
    
    protected function lmMigrateQuestionTypeSpecificContent(ilAssSelfAssessmentMigrator $migrator)
    {
        foreach ($this->getAnswers() as $answer) {
            /* @var ilAssKprimChoiceAnswer $answer */
            $answer->setAnswertext($migrator->migrateToLmContent($answer->getAnswertext()));
        }
    }

    public function toJSON()
    {
        $this->lng->loadLanguageModule('assessment');

        require_once './Services/RTE/classes/class.ilRTE.php';
        $result = array();
        $result['id'] = (int) $this->getId();
        $result['type'] = (string) $this->getQuestionType();
        $result['title'] = (string) $this->getTitle();
        $result['question'] = $this->formatSAQuestion($this->getQuestion());
        $result['instruction'] = $this->getInstructionTextTranslation(
            $this->lng,
            $this->getOptionLabel()
        );
        $result['nr_of_tries'] = (int) $this->getNrOfTries();
        $result['shuffle'] = (bool) $this->isShuffleAnswersEnabled();
        $result['feedback'] = array(
            'onenotcorrect' => $this->formatSAQuestion($this->feedbackOBJ->getGenericFeedbackTestPresentation($this->getId(), false)),
            'allcorrect' => $this->formatSAQuestion($this->feedbackOBJ->getGenericFeedbackTestPresentation($this->getId(), true))
        );

        $result['trueOptionLabel'] = $this->getTrueOptionLabelTranslation($this->lng, $this->getOptionLabel());
        $result['falseOptionLabel'] = $this->getFalseOptionLabelTranslation($this->lng, $this->getOptionLabel());
        
        $result['num_allowed_failures'] = $this->getNumAllowedFailures();
        
        $answers = array();
        $has_image = false;
        
        foreach ($this->getAnswers() as $key => $answer) {
            if (strlen((string) $answer->getImageFile())) {
                $has_image = true;
            }

            $answers[] = array(
                'answertext' => (string) $this->formatSAQuestion($answer->getAnswertext()),
                'correctness' => (bool) $answer->getCorrectness(),
                'order' => (int) $answer->getPosition(),
                'image' => (string) $answer->getImageFile(),
                'feedback' => $this->formatSAQuestion(
                    $this->feedbackOBJ->getSpecificAnswerFeedbackExportPresentation($this->getId(), 0, $key)
                )
            );
        }
        
        $result['answers'] = $answers;

        if ($has_image) {
            $result['path'] = $this->getImagePathWeb();
            $result['thumb'] = $this->getThumbSize();
        }

        $mobs = ilObjMediaObject::_getMobsOfObject("qpl:html", $this->getId());
        $result['mobs'] = $mobs;

        return json_encode($result);
    }
    
    private function getNumAllowedFailures()
    {
        if ($this->isScorePartialSolutionEnabled()) {
            return self::NUM_REQUIRED_ANSWERS - self::PARTIAL_SCORING_NUM_CORRECT_ANSWERS;
        }
        
        return 0;
    }
    
    public function getSpecificFeedbackAllCorrectOptionLabel()
    {
        return 'feedback_correct_kprim';
    }
    
    public static function isObligationPossible($questionId)
    {
        return true;
    }
    
    public function isAnswered($active_id, $pass = null)
    {
        $numExistingSolutionRecords = assQuestion::getNumExistingSolutionRecords($active_id, $pass, $this->getId());

        return $numExistingSolutionRecords >= 4;
    }

    public function setExportDetailsXLS($worksheet, $startrow, $active_id, $pass)
    {
        parent::setExportDetailsXLS($worksheet, $startrow, $active_id, $pass);

        $solution = $this->getSolutionValues($active_id, $pass);
        
        $i = 1;
        foreach ($this->getAnswers() as $id => $answer) {
            $worksheet->setCell($startrow + $i, 0, $answer->getAnswertext());
            $worksheet->setBold($worksheet->getColumnCoord(0) . ($startrow + $i));
            $correctness = false;
            foreach ($solution as $solutionvalue) {
                if ($id == $solutionvalue['value1']) {
                    $correctness = $solutionvalue['value2'];
                    break;
                }
            }
            $worksheet->setCell($startrow + $i, 1, $correctness);
            $i++;
        }

        return $startrow + $i + 1;
    }
    
    public function moveAnswerDown($position)
    {
        if ($position < 0 || $position >= (self::NUM_REQUIRED_ANSWERS - 1)) {
            return false;
        }
        
        for ($i = 0, $max = count($this->answers); $i < $max; $i++) {
            if ($i == $position) {
                $movingAnswer = $this->answers[$i];
                $targetAnswer = $this->answers[ $i + 1 ];

                $movingAnswer->setPosition($position + 1);
                $targetAnswer->setPosition($position);

                $this->answers[ $i + 1 ] = $movingAnswer;
                $this->answers[$i] = $targetAnswer;
            }
        }
    }
    
    public function moveAnswerUp($position)
    {
        if ($position <= 0 || $position > (self::NUM_REQUIRED_ANSWERS - 1)) {
            return false;
        }
        
        for ($i = 0, $max = count($this->answers); $i < $max; $i++) {
            if ($i == $position) {
                $movingAnswer = $this->answers[$i];
                $targetAnswer = $this->answers[ $i - 1 ];

                $movingAnswer->setPosition($position - 1);
                $targetAnswer->setPosition($position);

                $this->answers[ $i - 1 ] = $movingAnswer;
                $this->answers[$i] = $targetAnswer;
            }
        }
        
        return true;
    }
}