class.assTextSubset.php

Go to the documentation of this file.

<?php

/* Copyright (c) 1998-2010 ILIAS open source, Extended GPL, see docs/LICENSE */

include_once "./Modules/TestQuestionPool/classes/class.assQuestion.php";
include_once "./Modules/Test/classes/inc.AssessmentConstants.php";

class assTextSubset extends assQuestion
{
        var $answers;
        
        var $correctanswers;

        var $text_rating;

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

        function isComplete()
        {
                if (strlen($this->title) and ($this->author) and ($this->question) and (count($this->answers) >= $this->correctanswers) and ($this->getMaximumPoints() > 0))
                {
                        return true;
                }
                        else
                {
                        return false;
                }
        }

        function saveToDb($original_id = "")
        {
                global $ilDB;

                $this->saveQuestionDataToDb($original_id);
                
                // save additional data
                $affectedRows = $ilDB->manipulateF("DELETE FROM " . $this->getAdditionalTableName() . " WHERE question_fi = %s", 
                        array("integer"),
                        array($this->getId())
                );

                $affectedRows = $ilDB->manipulateF("INSERT INTO " . $this->getAdditionalTableName() . " (question_fi, textgap_rating, correctanswers) VALUES (%s, %s, %s)", 
                        array("integer", "text", "integer"),
                        array(
                                $this->getId(),
                                $this->getTextRating(),
                                $this->getCorrectAnswers()
                        )
                );

                $affectedRows = $ilDB->manipulateF("DELETE FROM qpl_a_textsubset WHERE question_fi = %s",
                        array('integer'),
                        array($this->getId())
                );

                foreach ($this->answers as $key => $value)
                {
                        $answer_obj = $this->answers[$key];
                        $next_id = $ilDB->nextId('qpl_a_textsubset');
                        $query = $ilDB->manipulateF("INSERT INTO qpl_a_textsubset (answer_id, question_fi, answertext, points, aorder, tstamp) VALUES (%s, %s, %s, %s, %s, %s)",
                                array('integer', 'integer', 'text', 'float', 'integer', 'integer'),
                                array(
                                        $next_id,
                                        $this->getId(),
                                        $answer_obj->getAnswertext(),
                                        $answer_obj->getPoints(),
                                        $answer_obj->getOrder(),
                                        time()
                                )
                        );
                }

                parent::saveToDb($original_id);
        }

        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->setNrOfTries($data['nr_of_tries']);
                        $this->setTitle($data["title"]);
                        $this->setComment($data["description"]);
                        $this->setOriginalId($data["original_id"]);
                        $this->setAuthor($data["author"]);
                        $this->setPoints($data["points"]);
                        $this->setOwner($data["owner"]);
                        include_once("./Services/RTE/classes/class.ilRTE.php");
                        $this->setQuestion(ilRTE::_replaceMediaObjectImageSrc($data["question_text"], 1));
                        $this->setCorrectAnswers($data["correctanswers"]);
                        $this->setTextRating($data["textgap_rating"]);
                        $this->setEstimatedWorkingTime(substr($data["working_time"], 0, 2), substr($data["working_time"], 3, 2), substr($data["working_time"], 6, 2));
                }


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

                parent::loadFromDb($question_id);
        }

        function addAnswer($answertext, $points, $order)
        {
                include_once "./Modules/TestQuestionPool/classes/class.assAnswerBinaryStateImage.php";
                if (array_key_exists($order, $this->answers))
                {
                        // insert answer
                        $answer = new ASS_AnswerBinaryStateImage($answertext, $points, $order);
                        $newchoices = array();
                        for ($i = 0; $i < $order; $i++)
                        {
                                array_push($newchoices, $this->answers[$i]);
                        }
                        array_push($newchoices, $answer);
                        for ($i = $order; $i < count($this->answers); $i++)
                        {
                                $changed = $this->answers[$i];
                                $changed->setOrder($i+1);
                                array_push($newchoices, $changed);
                        }
                        $this->answers = $newchoices;
                }
                else
                {
                        // add answer
                        array_push($this->answers, new ASS_AnswerBinaryStateImage($answertext, $points, count($this->answers)));
                }
        }
        
        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();
                
                if( (int)$testObjId > 0 )
                {
                        $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 generic feedback
                $clone->duplicateGenericFeedback($this_id);

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

                return $clone->id;
        }

        function copyObject($target_questionpool, $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 = $this->getObjId();
                $clone->setObjId($target_questionpool);
                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 generic feedback
                $clone->duplicateGenericFeedback($original_id);
                $clone->onCopy($this->getObjId(), $this->getId());

                return $clone->id;
        }
        
        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 deleteAnswer($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 = array();
                foreach ($this->answers as $answer)
                {
                        if ($answer->getPoints() > 0)
                        {
                                array_push($points, $answer->getPoints());
                        }
                }
                rsort($points, SORT_NUMERIC);
                $maxpoints = 0;
                for ($counter = 0; $counter < $this->getCorrectAnswers(); $counter++)
                {
                        $maxpoints += $points[$counter];
                }
                return $maxpoints;
        }
        
        function &getAvailableAnswers()
        {
                $available_answers = array();
                foreach ($this->answers as $answer)
                {
                        array_push($available_answers, $answer->getAnswertext());
                }
                return $available_answers;
        }

        function isAnswerCorrect($answers, $answer)
        {
                include_once "./Services/Utilities/classes/class.ilStr.php";
                $result = 0;
                $textrating = $this->getTextRating();
                foreach ($answers as $key => $value)
                {
                        switch ($textrating)
                        {
                                case TEXTGAP_RATING_CASEINSENSITIVE:
                                        if (strcmp(ilStr::strToLower($value), ilStr::strToLower($answer)) == 0 && $this->answers[$key]->getPoints() > 0) return $key;
                                        break;
                                case TEXTGAP_RATING_CASESENSITIVE:
                                        if (strcmp($value, $answer) == 0 && $this->answers[$key]->getPoints() > 0) return $key;
                                        break;
                                case TEXTGAP_RATING_LEVENSHTEIN1:
                                        if (levenshtein($value, $answer) <= 1 && $this->answers[$key]->getPoints() > 0) return $key;
                                        break;
                                case TEXTGAP_RATING_LEVENSHTEIN2:
                                        if (levenshtein($value, $answer) <= 2 && $this->answers[$key]->getPoints() > 0) return $key;
                                        break;
                                case TEXTGAP_RATING_LEVENSHTEIN3:
                                        if (levenshtein($value, $answer) <= 3 && $this->answers[$key]->getPoints() > 0) return $key;
                                        break;
                                case TEXTGAP_RATING_LEVENSHTEIN4:
                                        if (levenshtein($value, $answer) <= 4 && $this->answers[$key]->getPoints() > 0) return $key;
                                        break;
                                case TEXTGAP_RATING_LEVENSHTEIN5:
                                        if (levenshtein($value, $answer) <= 5 && $this->answers[$key]->getPoints() > 0) return $key;
                                        break;
                        }
                }
                return FALSE;
        }

        function getTextRating()
        {
                return $this->text_rating;
        }
        
        function setTextRating($a_text_rating)
        {
                switch ($a_text_rating)
                {
                        case TEXTGAP_RATING_CASEINSENSITIVE:
                        case TEXTGAP_RATING_CASESENSITIVE:
                        case TEXTGAP_RATING_LEVENSHTEIN1:
                        case TEXTGAP_RATING_LEVENSHTEIN2:
                        case TEXTGAP_RATING_LEVENSHTEIN3:
                        case TEXTGAP_RATING_LEVENSHTEIN4:
                        case TEXTGAP_RATING_LEVENSHTEIN5:
                                $this->text_rating = $a_text_rating;
                                break;
                        default:
                                $this->text_rating = TEXTGAP_RATING_CASEINSENSITIVE;
                                break;
                }
        }
        
        public function calculateReachedPoints($active_id, $pass = NULL, $returndetails = FALSE)
        {
                if( $returndetails )
                {
                        throw new ilTestException('return details not implemented for '.__METHOD__);
                }
                
                global $ilDB;
                
                $available_answers =& $this->getAvailableAnswers();
                $found_counter = 0;
                
                if (is_null($pass))
                {
                        $pass = $this->getSolutionMaxPass($active_id);
                }
                $result = $ilDB->queryF("SELECT * FROM tst_solutions WHERE active_fi = %s AND question_fi = %s AND pass = %s",
                        array('integer','integer','integer'),
                        array($active_id, $this->getId(), $pass)
                );
                while ($data = $ilDB->fetchAssoc($result))
                {
                        $enteredtext = $data["value1"];
                        $index = $this->isAnswerCorrect($available_answers, $enteredtext);
                        if ($index !== FALSE)
                        {
                                unset($available_answers[$index]);
                                $points += $this->answers[$index]->getPoints();
                        }
                }

                return $points;
        }
        
        function setCorrectAnswers($a_correct_answers)
        {
                $this->correctanswers = $a_correct_answers;
        }
        
        function getCorrectAnswers()
        {
                return $this->correctanswers;
        }
        
        public function saveWorkingData($active_id, $pass = NULL)
        {
                global $ilDB;
                global $ilUser;

                if (is_null($pass))
                {
                        include_once "./Modules/Test/classes/class.ilObjTest.php";
                        $pass = ilObjTest::_getPass($active_id);
                }
                $entered_values = 0;
                
                $affectedRows = $ilDB->manipulateF("DELETE FROM tst_solutions WHERE active_fi = %s AND question_fi = %s AND pass = %s",
                        array('integer','integer','integer'),
                        array($active_id, $this->getId(), $pass)
                );
                foreach ($_POST as $key => $value)
                {
                        if (preg_match("/^TEXTSUBSET_(\d+)/", $key, $matches))
                        {
                                if (strlen($value))
                                {
                                        $next_id = $ilDB->nextId('tst_solutions');
                                        $affectedRows = $ilDB->insert("tst_solutions", array(
                                                "solution_id" => array("integer", $next_id),
                                                "active_fi" => array("integer", $active_id),
                                                "question_fi" => array("integer", $this->getId()),
                                                "value1" => array("clob", trim($value)),
                                                "value2" => array("clob", null),
                                                "pass" => array("integer", $pass),
                                                "tstamp" => array("integer", time())
                                        ));
                                        $entered_values++;
                                }
                        }
                }
                if ($entered_values)
                {
                        include_once ("./Modules/Test/classes/class.ilObjAssessmentFolder.php");
                        if (ilObjAssessmentFolder::_enabledAssessmentLogging())
                        {
                                $this->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())
                        {
                                $this->logAction($this->lng->txtlng("assessment", "log_user_not_entered_values", ilObjAssessmentFolder::_getLogLanguage()), $active_id, $this->getId());
                        }
                }
                
                return true;
        }

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

        function getQuestionType()
        {
                return "assTextSubset";
        }
        
        function &joinAnswers()
        {
                $join = array();
                foreach ($this->answers as $answer)
                {
                        if (!is_array($join[$answer->getPoints() . ""]))
                        {
                                $join[$answer->getPoints() . ""] = array();
                        }
                        array_push($join[$answer->getPoints() . ""], $answer->getAnswertext());
                }
                return $join;
        }
        
        function getMaxTextboxWidth()
        {
                $maxwidth = 0;
                foreach ($this->answers as $answer)
                {
                        $len = strlen($answer->getAnswertext());
                        if ($len > $maxwidth) $maxwidth = $len;
                }
                return $maxwidth + 3;
        }

        function getAdditionalTableName()
        {
                return "qpl_qst_textsubset";
        }

        function getAnswerTableName()
        {
                return "qpl_a_textsubset";
        }

        function getRTETextWithMediaObjects()
        {
                return parent::getRTETextWithMediaObjects();
        }

        public function setExportDetailsXLS(&$worksheet, $startrow, $active_id, $pass, &$format_title, &$format_bold)
        {
                include_once ("./Services/Excel/classes/class.ilExcelUtils.php");
                $solutions = $this->getSolutionValues($active_id, $pass);
                $worksheet->writeString($startrow, 0, ilExcelUtils::_convert_text($this->lng->txt($this->getQuestionType())), $format_title);
                $worksheet->writeString($startrow, 1, ilExcelUtils::_convert_text($this->getTitle()), $format_title);
                $i = 1;
                foreach ($solutions as $solution)
                {
                        $worksheet->write($startrow + $i, 0, ilExcelUtils::_convert_text($solution["value1"]));
                        $i++;
                }
                return $startrow + $i + 1;
        }
        
        public function getAnswers()
        {
                return $this->answers;
        }

        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['matching_method'] = (string) $this->getTextRating();
                $result['feedback'] = array(
                        "onenotcorrect" => ilRTE::_replaceMediaObjectImageSrc($this->getFeedbackGeneric(0), 0),
                        "allcorrect" => ilRTE::_replaceMediaObjectImageSrc($this->getFeedbackGeneric(1), 0)
                        );

                $answers = array();
                foreach ($this->getAnswers() as $key => $answer_obj)
                {
                        array_push($answers, array(
                                "answertext" => (string) $answer_obj->getAnswertext(),
                                "points" => (float)$answer_obj->getPoints(),
                                "order" => (int)$answer_obj->getOrder()
                        ));
                }
                $result['correct_answers'] = $answers;

                $answers = array();
                for($loop = 1; $loop <= (int) $this->getCorrectAnswers(); $loop++)
                {
                        array_push($answers, array(
                                "answernr" => $loop
                        ));
                }
                $result['answers'] = $answers;

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

?>