class.assImagemapQuestion.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/Test/classes/inc.AssessmentConstants.php';
require_once './Modules/TestQuestionPool/interfaces/interface.ilObjQuestionScoringAdjustable.php';
require_once './Modules/TestQuestionPool/interfaces/interface.ilObjAnswerScoringAdjustable.php';
require_once './Modules/TestQuestionPool/interfaces/interface.iQuestionCondition.php';
require_once './Modules/TestQuestionPool/classes/class.ilUserQuestionResult.php';

class assImagemapQuestion extends assQuestion implements ilObjQuestionScoringAdjustable, ilObjAnswerScoringAdjustable, iQuestionCondition
{
        // hey: prevPassSolutions - wtf is imagemap ^^
        public $currentSolution = array();
        // hey.
        
        const MODE_SINGLE_CHOICE   = 0;
        const MODE_MULTIPLE_CHOICE = 1;

        var $answers;

        var $image_filename;

        var $imagemap_contents;
        
        var $coords;

        protected $is_multiple_choice = false;

        public function __construct(
                $title = "",
                $comment = "",
                $author = "",
                $owner = -1,
                $question = "",
                $image_filename = ""
        )
        {
                parent::__construct($title, $comment, $author, $owner, $question);
                $this->image_filename = $image_filename;
                $this->answers = array();
                $this->coords = array();
        }

        public function setIsMultipleChoice($is_multiple_choice)
        {
                $this->is_multiple_choice = $is_multiple_choice;
        }

        public function getIsMultipleChoice()
        {
                return $this->is_multiple_choice;
        }

        function isComplete()
        {
                if (strlen($this->title) 
                        && ($this->author) 
                        && ($this->question) 
                        && ($this->image_filename) 
                        && (count($this->answers)) 
                        && ($this->getMaximumPoints() > 0)
                )
                {
                        return true;
                }
                return false;
        }

        public function saveToDb($original_id = "")
        {
                $this->saveQuestionDataToDb($original_id);
                $this->saveAdditionalQuestionDataToDb();
                $this->saveAnswerSpecificDataToDb();
                parent::saveToDb($original_id);
        }

        public function saveAnswerSpecificDataToDb()
        {
                global $ilDB;
                $ilDB->manipulateF( "DELETE FROM qpl_a_imagemap WHERE question_fi = %s",
                                                        array( "integer" ),
                                                        array( $this->getId() )
                );

                // Anworten wegschreiben
                foreach ($this->answers as $key => $value)
                {
                        $answer_obj   = $this->answers[$key];
                        $next_id      = $ilDB->nextId( 'qpl_a_imagemap' );
                        $ilDB->manipulateF( "INSERT INTO qpl_a_imagemap (answer_id, question_fi, answertext, points, aorder, coords, area, points_unchecked) VALUES (%s, %s, %s, %s, %s, %s, %s, %s)",
                                                                        array( "integer", "integer", "text", "float", "integer", "text", "text", "float" ),
                                                                        array( $next_id, $this->id, $answer_obj->getAnswertext(
                                                                        ), $answer_obj->getPoints(), $answer_obj->getOrder(
                                                                        ), $answer_obj->getCoords(), $answer_obj->getArea(
                                                                        ), $answer_obj->getPointsUnchecked() )
                        );
                }
        }

        public function saveAdditionalQuestionDataToDb()
        {
                global $ilDB;
                
                $ilDB->manipulateF( "DELETE FROM " . $this->getAdditionalTableName() . " WHERE question_fi = %s",
                                                        array( "integer" ),
                                                        array( $this->getId() )
                );
                
                $ilDB->manipulateF( "INSERT INTO " . $this->getAdditionalTableName(
                                                                                                                                                ) . " (question_fi, image_file, is_multiple_choice) VALUES (%s, %s, %s)",
                                                        array( "integer", "text", 'integer' ),
                                                        array(
                                                                $this->getId(),
                                                                $this->image_filename,
                                                                (int)$this->is_multiple_choice
                                                        )
                );
        }

        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 image
                $clone->duplicateImage($this_id, $thisObjId);
                
                $clone->onDuplicate($thisObjId, $this_id, $clone->getObjId(), $clone->getId());
                
                return $clone->id;
        }

        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->copyImage($original_id, $source_questionpool_id);
                
                $clone->onCopy($source_questionpool_id, $original_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->copyImage($sourceQuestionId, $sourceParentId);

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

                return $clone->id;
        }

        function duplicateImage($question_id, $objectId = null)
        {
                global $ilLog;

                $imagepath = $this->getImagePath();
                $imagepath_original = str_replace("/$this->id/images", "/$question_id/images", $imagepath);
                
                if( (int)$objectId > 0 )
                {
                        $imagepath_original = str_replace("/$this->obj_id/", "/$objectId/", $imagepath_original);
                }

                if(!file_exists($imagepath))
                {
                        ilUtil::makeDirParents($imagepath);
                }
                $filename = $this->getImageFilename();

                // #18755
                if(!file_exists($imagepath_original . $filename))
                {
                        $ilLog->write("Could not find an image map file when trying to duplicate image: " . $imagepath_original . $filename);
                        $imagepath_original = str_replace("/$this->obj_id/", "/$objectId/", $imagepath_original);
                        $ilLog->write("Using fallback source directory:" . $imagepath_original);
                }

                if(!file_exists($imagepath_original . $filename) || !copy($imagepath_original . $filename, $imagepath . $filename))
                {
                        $ilLog->write("Could not duplicate image for image map question: " . $imagepath_original . $filename);
                }
        }

        function copyImage($question_id, $source_questionpool)
        {
                $imagepath = $this->getImagePath();
                $imagepath_original = str_replace("/$this->id/images", "/$question_id/images", $imagepath);
                $imagepath_original = str_replace("/$this->obj_id/", "/$source_questionpool/", $imagepath_original);
                if (!file_exists($imagepath)) 
                {
                        ilUtil::makeDirParents($imagepath);
                }
                $filename = $this->getImageFilename();
                if (!copy($imagepath_original . $filename, $imagepath . $filename)) 
                {
                        print "image could not be copied!!!! ";
                }
        }

        function loadFromDb($question_id)
        {
                global $ilDB;

                $result = $ilDB->queryF("SELECT qpl_questions.*, " . $this->getAdditionalTableName() . ".* FROM qpl_questions LEFT JOIN " . $this->getAdditionalTableName() . " ON " . $this->getAdditionalTableName() . ".question_fi = qpl_questions.question_id WHERE qpl_questions.question_id = %s",
                        array("integer"),
                        array($question_id)
                );
                if ($result->numRows() == 1)
                {
                        $data = $ilDB->fetchAssoc($result);
                        $this->setId($question_id);
                        $this->setObjId($data["obj_fi"]);
                        $this->setTitle($data["title"]);
                        $this->setComment($data["description"]);
                        $this->setOriginalId($data["original_id"]);
                        $this->setNrOfTries($data['nr_of_tries']);
                        $this->setAuthor($data["author"]);
                        $this->setPoints($data["points"]);
                        $this->setOwner($data["owner"]);
                        $this->setIsMultipleChoice($data["is_multiple_choice"] == self::MODE_MULTIPLE_CHOICE);
                        include_once("./Services/RTE/classes/class.ilRTE.php");
                        $this->setQuestion(ilRTE::_replaceMediaObjectImageSrc($data["question_text"], 1));
                        $this->setImageFilename($data["image_file"]);
                        $this->setEstimatedWorkingTime(substr($data["working_time"], 0, 2), substr($data["working_time"], 3, 2), substr($data["working_time"], 6, 2));
                        
                        try
                        {
                                $this->setAdditionalContentEditingMode($data['add_cont_edit_mode']);
                        }
                        catch(ilTestQuestionPoolException $e)
                        {
                        }

                        $result = $ilDB->queryF("SELECT * FROM qpl_a_imagemap WHERE question_fi = %s ORDER BY aorder ASC",
                                array("integer"),
                                array($question_id)
                        );
                        include_once "./Modules/TestQuestionPool/classes/class.assAnswerImagemap.php";
                        if ($result->numRows() > 0)
                        {
                                while ($data = $ilDB->fetchAssoc($result)) 
                                {
                                        array_push($this->answers, new ASS_AnswerImagemap($data["answertext"], $data["points"], $data["aorder"], $data["coords"], $data["area"], $data['question_fi'], $data['points_unchecked']));
                                }
                        }
                }
                parent::loadFromDb($question_id);
        }

        public function uploadImagemap(array $shapes) 
        {
                $added = 0;

                if(count($shapes) > 0)
                {
                        foreach($shapes as $shape)
                        {
                                $this->addAnswer($shape->getAnswertext(), 0.0, count($this->answers), $shape->getCoords(), $shape->getArea());
                                $added++;
                        }
                }

                return $added;
        }

        function getImageFilename()
        {
                return $this->image_filename;
        }

        function setImageFilename($image_filename, $image_tempfilename = "") 
        {
                if (!empty($image_filename)) 
                {
                        $image_filename = str_replace(" ", "_", $image_filename);
                        $this->image_filename = $image_filename;
                }
                if (!empty($image_tempfilename)) 
                {
                        $imagepath = $this->getImagePath();
                        if (!file_exists($imagepath)) 
                        {
                                ilUtil::makeDirParents($imagepath);
                        }
                        if (!ilUtil::moveUploadedFile($image_tempfilename, $image_filename, $imagepath.$image_filename))
                        {
                                $this->ilias->raiseError("The image could not be uploaded!", $this->ilias->error_obj->MESSAGE);
                        }
                        global $ilLog; $ilLog->write("gespeichert: " . $imagepath.$image_filename);
                }
  }

        function get_imagemap_contents($href = "#") {
                $imagemap_contents = "<map name=\"".$this->title."\"> ";
                for ($i = 0; $i < count($this->answers); $i++) {
                        $imagemap_contents .= "<area alt=\"".$this->answers[$i]->getAnswertext()."\" ";
                        $imagemap_contents .= "shape=\"".$this->answers[$i]->getArea()."\" ";
                        $imagemap_contents .= "coords=\"".$this->answers[$i]->getCoords()."\" ";
                        $imagemap_contents .= "href=\"$href&selimage=" . $this->answers[$i]->getOrder() . "\" /> ";
                }
                $imagemap_contents .= "</map>";
                return $imagemap_contents;
        }

        function addAnswer(
                $answertext = "",
                $points = 0.0,
                $order = 0,
                $coords="",
                $area="",
                $points_unchecked = 0.0
        )
        {
                include_once "./Modules/TestQuestionPool/classes/class.assAnswerImagemap.php";
                if (array_key_exists($order, $this->answers)) 
                {
                        // Insert answer
                        $answer = new ASS_AnswerImagemap($answertext, $points, $order, $coords, $area, -1, $points_unchecked);
                        for ($i = count($this->answers) - 1; $i >= $order; $i--) 
                        {
                                $this->answers[$i+1] = $this->answers[$i];
                                $this->answers[$i+1]->setOrder($i+1);
                        }
                        $this->answers[$order] = $answer;
                }
                else 
                {
                        // Append answer
                        $answer = new ASS_AnswerImagemap($answertext, $points, count($this->answers), $coords, $area, -1, $points_unchecked);
                        array_push($this->answers, $answer);
                }
        }

        function getAnswerCount() {
                return count($this->answers);
        }

        function getAnswer($index = 0) {
                if ($index < 0) return NULL;
                if (count($this->answers) < 1) return NULL;
                if ($index >= count($this->answers)) return NULL;
                return $this->answers[$index];
        }

        function &getAnswers() 
        {
                return $this->answers;
        }

        function deleteArea($index = 0) 
        {
                if ($index < 0) return;
                if (count($this->answers) < 1) return;
                if ($index >= count($this->answers)) return;
                unset($this->answers[$index]);
                $this->answers = array_values($this->answers);
                for ($i = 0; $i < count($this->answers); $i++) {
                        if ($this->answers[$i]->getOrder() > $index) {
                                $this->answers[$i]->setOrder($i);
                        }
                }
        }

        function flushAnswers() {
                $this->answers = array();
        }

  function getMaximumPoints() {
                $points = 0;
                foreach ($this->answers as $key => $value) {
                        if($this->is_multiple_choice)
                        {
                                if($value->getPoints() > $value->getPointsUnchecked())
                                {
                                        $points += $value->getPoints();
                                }
                                else
                                {
                                        $points += $value->getPointsUnchecked();
                                }
                        }
                        else
                        {
                                if($value->getPoints() > $points)
                                {
                                        $points = $value->getPoints();
                                }
                        }
                }
                return $points;
  }

        public function calculateReachedPoints($active_id, $pass = NULL, $authorizedSolution = true, $returndetails = FALSE)
        {
                if( $returndetails )
                {
                        throw new ilTestException('return details not implemented for '.__METHOD__);
                }
                
                global $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))
                {
                        if (strcmp($data["value1"], "") != 0)
                        {
                                array_push($found_values, $data["value1"]);
                        }
                }
                
                $points = $this->calculateReachedPointsForSolution($found_values);

                return $points;
        }

        public function calculateReachedPointsFromPreviewSession(ilAssQuestionPreviewSession $previewSession)
        {
                $solutionData = $previewSession->getParticipantsSolution();

                $reachedPoints = $this->calculateReachedPointsForSolution(is_array($solutionData) ? array_values($solutionData) : array());
                $reachedPoints = $this->deductHintPointsFromReachedPoints($previewSession, $reachedPoints);
                
                return $this->ensureNonNegativePoints($reachedPoints);
        }

        public function isAutosaveable()
        {
                return false; // #15217
        }

        public function saveWorkingData($active_id, $pass = NULL, $authorized = true)
        {
                global $ilDB;

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

                $solutionSelectionChanged = false;

                $this->getProcessLocker()->executeUserSolutionUpdateLockOperation(function() use (&$solutionSelectionChanged, $ilDB, $active_id, $pass, $authorized) {

                        if( $authorized )
                        {
                                // remove the dummy record of the intermediate solution
                                $this->deleteDummySolutionRecord($active_id, $pass);
                                
                                // delete the authorized solution and make the intermediate solution authorized (keeping timestamps)
                                $this->removeCurrentSolution($active_id, $pass, true);
                                $this->updateCurrentSolutionsAuthorization($active_id, $pass, true, true);
                                
                                $solutionSelectionChanged = true;
                        }
                        else
                        {
                                $this->forceExistingIntermediateSolution(
                                        $active_id, $pass, $this->is_multiple_choice
                                );
                                
                                if( $this->isReuseSolutionSelectionRequest() )
                                {
                                        $selection = $this->getReuseSolutionSelectionParameter();
                                        
                                        foreach($selection as $selectedIndex)
                                        {
                                                $this->saveCurrentSolution($active_id, $pass, (int)$selectedIndex, null, $authorized);
                                                $solutionSelectionChanged = true;
                                        }
                                }
                                elseif( $this->isRemoveSolutionSelectionRequest() )
                                {
                                        $selection = $this->getRemoveSolutionSelectionParameter();
                                        
                                        $this->deleteSolutionRecordByValues($active_id, $pass, $authorized, array(
                                                'value1' => (int)$selection
                                        ));
                                        
                                        $solutionSelectionChanged = true;
                                }
                                elseif( $this->isAddSolutionSelectionRequest() )
                                {
                                        $selection = $this->getAddSolutionSelectionParameter();

                                        if( $this->is_multiple_choice )
                                        {
                                                $this->deleteSolutionRecordByValues($active_id, $pass, $authorized, array(
                                                        'value1' => (int)$_GET['selImage']
                                                ));
                                        }
                                        else
                                        {
                                                $this->removeCurrentSolution($active_id, $pass, $authorized);
                                        }

                                        $this->saveCurrentSolution($active_id, $pass, $_GET['selImage'], null, $authorized);
                                        
                                        $solutionSelectionChanged = true;
                                }
                        }
                });

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

                return true;
        }

        protected function savePreviewData(ilAssQuestionPreviewSession $previewSession)
        {
                $solution = $previewSession->getParticipantsSolution();

                if( $this->is_multiple_choice && strlen($_GET['remImage']) )
                {
                        unset($solution[(int)$_GET['remImage']]);
                }
                
                if( strlen($_GET['selImage']) )
                {
                        if( !$this->is_multiple_choice )
                        {
                                $solution = array();
                        }
                        
                        $solution[(int)$_GET['selImage']] = (int)$_GET['selImage'];
                }

                $previewSession->setParticipantsSolution($solution);
        }

        protected function reworkWorkingData($active_id, $pass, $obligationsAnswered, $authorized)
        {
                // nothing to rework!
        }

        function syncWithOriginal()
        {
                if ($this->getOriginalId())
                {
                        parent::syncWithOriginal();
                }
        }

        function getQuestionType()
        {
                return "assImagemapQuestion";
        }

        function getAdditionalTableName()
        {
                return "qpl_qst_imagemap";
        }

        function getAnswerTableName()
        {
                return "qpl_a_imagemap";
        }

        function getRTETextWithMediaObjects()
        {
                $text = parent::getRTETextWithMediaObjects();
                foreach ($this->answers as $index => $answer)
                {
                        $text .= $this->feedbackOBJ->getSpecificAnswerFeedbackContent($this->getId(), $index);
                }
                return $text;
        }

        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->getArea() . ": " . $answer->getCoords());
                        $worksheet->setBold($worksheet->getColumnCoord(0) . ($startrow + $i));
                        
                        $cellValue = 0;
                        foreach($solution as $solIndex => $sol)
                        {
                                if( $sol['value1'] == $id )
                                {
                                        $cellValue = 1;
                                        break;
                                }
                        }
                        
                        $worksheet->setCell($startrow + $i, 1, $cellValue);

                        $i++;
                }

                return $startrow + $i + 1;
        }

        public function deleteImage()
        {
                $file = $this->getImagePath() . $this->getImageFilename();
                @unlink($file);
                $this->flushAnswers();
                $this->image_filename = "";
        }

        public function toJSON()
        {
                include_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['nr_of_tries'] = (int) $this->getNrOfTries();
                $result['shuffle'] = (bool) $this->getShuffle();
                $result['is_multiple'] = (bool) $this->getIsMultipleChoice();
                $result['feedback'] = array(
                        'onenotcorrect' => $this->formatSAQuestion($this->feedbackOBJ->getGenericFeedbackTestPresentation($this->getId(), false)),
                        'allcorrect' => $this->formatSAQuestion($this->feedbackOBJ->getGenericFeedbackTestPresentation($this->getId(), true))
                );
                $result['image'] = (string) $this->getImagePathWeb() . $this->getImageFilename();
                
                $answers = array();
                $order = 0;
                foreach ($this->getAnswers() as $key => $answer_obj)
                {
                        array_push($answers, array(
                                "answertext"       => (string)$answer_obj->getAnswertext(),
                                "points"           => (float)$answer_obj->getPoints(),
                                "points_unchecked" => (float)$answer_obj->getPointsUnchecked(),
                                "order"            => (int)$order,
                                "coords"           => $answer_obj->getCoords(),
                                "state"            => $answer_obj->getState(),
                                "area"             => $answer_obj->getArea(),
                                "feedback"         => $this->formatSAQuestion(
                                        $this->feedbackOBJ->getSpecificAnswerFeedbackExportPresentation($this->getId(), $key)
                                )
                        ));
                        $order++;
                }
                $result['answers'] = $answers;

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

        protected function calculateReachedPointsForSolution($found_values)
        {
                $points = 0;
                if(count($found_values) > 0)
                {
                        foreach($this->answers as $key => $answer)
                        {
                                if(in_array($key, $found_values))
                                {
                                        $points += $answer->getPoints();
                                } elseif($this->getIsMultipleChoice())
                                {
                                        $points += $answer->getPointsUnchecked();
                                }
                        }
                        return $points;
                }
                return $points;
        }

        public function getOperators($expression)
        {
                require_once "./Modules/TestQuestionPool/classes/class.ilOperatorsExpressionMapping.php";
                return ilOperatorsExpressionMapping::getOperatorsByExpression($expression);
        }

        public function getExpressionTypes()
        {
                return array(
                        iQuestionCondition::PercentageResultExpression,
                        iQuestionCondition::NumberOfResultExpression,
                        iQuestionCondition::EmptyAnswerExpression,
                        iQuestionCondition::ExclusiveResultExpression
                );
        }

        public function getUserQuestionResult($active_id, $pass)
        {
                global $ilDB;
                $result = new ilUserQuestionResult($this, $active_id, $pass);

                $maxStep = $this->lookupMaxStep($active_id, $pass);

                if( $maxStep !== null )
                {
                        $data = $ilDB->queryF("SELECT value1+1 as value1 FROM tst_solutions WHERE active_fi = %s AND pass = %s AND question_fi = %s AND step = %s",
                                array("integer", "integer", "integer", "integer"),
                                array($active_id, $pass, $this->getId(), $maxStep)
                        );
                }
                else
                {
                        $data = $ilDB->queryF("SELECT value1+1 as value1 FROM tst_solutions WHERE active_fi = %s AND pass = %s AND question_fi = %s AND step IS NULL",
                                array("integer", "integer", "integer"),
                                array($active_id, $pass, $this->getId())
                        );
                }

                while($row = $ilDB->fetchAssoc($data))
                {
                        $result->addKeyValue($row["value1"], $row["value1"]);
                }

                $points = $this->calculateReachedPoints($active_id, $pass);
                $max_points = $this->getMaximumPoints();

                $result->setReachedPercentage(($points/$max_points) * 100);

                return $result;
        }

        public function getAvailableAnswerOptions($index = null)
        {
                if($index !== null)
                {
                        return $this->getAnswer($index);
                }
                else
                {
                        return $this->getAnswers();
                }
        }
        
        // hey: prevPassSolutions - wtf is imagemap ^^
        public function getTestOutputSolutions($activeId, $pass)
        {
                $solution = parent::getTestOutputSolutions($activeId, $pass);
                
                $this->currentSolution = array();
                foreach($solution as $record)
                {
                        $this->currentSolution[] = $record['value1'];
                }
                
                return $solution;
        }
        protected function getAddSolutionSelectionParameter()
        {
                if( !$this->isAddSolutionSelectionRequest() )
                {
                        return null;
                }
                
                return $_GET["selImage"];
        }
        protected function isAddSolutionSelectionRequest()
        {
                if( !isset($_GET["selImage"]) )
                {
                        return false;
                }
                
                if( !strlen($_GET["selImage"]) )
                {
                        return false;
                }
                
                return true;
        }
        protected function getRemoveSolutionSelectionParameter()
        {
                if( !$this->isRemoveSolutionSelectionRequest() )
                {
                        return null;
                }
                
                return $_GET["remImage"];
        }
        protected function isRemoveSolutionSelectionRequest()
        {
                if( !$this->is_multiple_choice )
                {
                        return false;
                }
                
                if( !isset($_GET["remImage"]) )
                {
                        return false;
                }
                
                if( !strlen($_GET["remImage"]) )
                {
                        return false;
                }
                
                return true;
        }
        protected function getReuseSolutionSelectionParameter()
        {
                if( !$this->isReuseSolutionSelectionRequest() )
                {
                        return null;
                }
                
                return assQuestion::explodeKeyValues($_GET["reuseSelection"]);
        }
        protected function isReuseSolutionSelectionRequest()
        {
                if( !$this->getTestPresentationConfig()->isPreviousPassSolutionReuseAllowed() )
                {
                        return false;
                }
                
                if( !isset($_GET["reuseSelection"]) )
                {
                        return false;
                }
                
                if( !strlen($_GET["reuseSelection"]) )
                {
                        return false;
                }
                
                if( !preg_match('/\d(,\d)*/', $_GET["reuseSelection"]) )
                {
                        return false;
                }
                
                return true;
        }
        // hey.
}