class.SurveyMultipleChoiceQuestion.php

Go to the documentation of this file.

<?php
 /*
   +----------------------------------------------------------------------------+
   | ILIAS open source                                                          |
   +----------------------------------------------------------------------------+
   | Copyright (c) 1998-2001 ILIAS open source, University of Cologne           |
   |                                                                            |
   | This program is free software; you can redistribute it and/or              |
   | modify it under the terms of the GNU General Public License                |
   | as published by the Free Software Foundation; either version 2             |
   | of the License, or (at your option) any later version.                     |
   |                                                                            |
   | This program is distributed in the hope that it will be useful,            |
   | but WITHOUT ANY WARRANTY; without even the implied warranty of             |
   | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the              |
   | GNU General Public License for more details.                               |
   |                                                                            |
   | You should have received a copy of the GNU General Public License          |
   | along with this program; if not, write to the Free Software                |
   | Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. |
   +----------------------------------------------------------------------------+
*/

include_once "./Modules/SurveyQuestionPool/classes/class.SurveyQuestion.php";

class SurveyMultipleChoiceQuestion extends SurveyQuestion 
{
        var $categories;

        function SurveyMultipleChoiceQuestion(
                $title = "",
                $description = "",
                $author = "",
                $questiontext = "",
                $owner = -1,
                $orientation = 0 
        )
        {
                $this->SurveyQuestion($title, $description, $author, $questiontext, $owner);
                $this->orientation = $orientation;
                include_once "./Modules/SurveyQuestionPool/classes/class.SurveyCategories.php";
                $this->categories = new SurveyCategories();
        }
        
        function _getQuestionDataArray($id)
        {
                global $ilDB;
                
                $result = $ilDB->queryF("SELECT svy_question.*, " . $this->getAdditionalTableName() . ".* FROM svy_question, " . $this->getAdditionalTableName() . " WHERE svy_question.question_id = %s AND svy_question.question_id = " . $this->getAdditionalTableName() . ".question_fi",
                        array('integer'),
                        array($id)
                );
                if ($result->numRows() == 1)
                {
                        return $ilDB->fetchAssoc($result);
                }
                else
                {
                        return array();
                }
        }
        
        function loadFromDb($id) 
        {
                global $ilDB;

                $result = $ilDB->queryF("SELECT svy_question.*, " . $this->getAdditionalTableName() . ".* FROM svy_question LEFT JOIN " . $this->getAdditionalTableName() . " ON " . $this->getAdditionalTableName() . ".question_fi = svy_question.question_id WHERE svy_question.question_id = %s",
                        array('integer'),
                        array($id)
                );
                if ($result->numRows() == 1) 
                {
                        $data = $ilDB->fetchAssoc($result);
                        $this->setId($data["question_id"]);
                        $this->setTitle($data["title"]);
                        $this->label = $data['label'];
                        $this->setDescription($data["description"]);
                        $this->setObjId($data["obj_fi"]);
                        $this->setAuthor($data["author"]);
                        $this->setOwner($data["owner_fi"]);
                        include_once("./Services/RTE/classes/class.ilRTE.php");
                        $this->setQuestiontext(ilRTE::_replaceMediaObjectImageSrc($data["questiontext"], 1));
                        $this->setObligatory($data["obligatory"]);
                        $this->setComplete($data["complete"]);
                        $this->setOriginalId($data["original_id"]);
                        $this->setOrientation($data["orientation"]);
                        $this->use_min_answers = ($data['use_min_answers']) ? true : false;
                        $this->nr_min_answers = $data['nr_min_answers'];
                        $this->nr_max_answers = $data['nr_max_answers'];

                        $this->categories->flushCategories();
                        $result = $ilDB->queryF("SELECT svy_variable.*, svy_category.title, svy_category.neutral FROM svy_variable, svy_category WHERE svy_variable.question_fi = %s AND svy_variable.category_fi = svy_category.category_id ORDER BY sequence ASC",
                                array('integer'),
                                array($id)
                        );
                        if ($result->numRows() > 0) 
                        {
                                while ($data = $ilDB->fetchAssoc($result)) 
                                {
                                        $this->categories->addCategory($data["title"], $data["other"], $data["neutral"], null, ($data['scale']) ? $data['scale'] : ($data['sequence'] + 1));
                                }
                        }
                }
                parent::loadFromDb($id);
        }

        function isComplete()
        {
                if (
                        strlen($this->getTitle()) &&
                        strlen($this->getAuthor()) &&
                        strlen($this->getQuestiontext()) &&
                        $this->categories->getCategoryCount()
                )
                {
                        return 1;
                }
                else
                {
                        return 0;
                }
        }

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

                $affectedRows = parent::saveToDb($original_id);
                if ($affectedRows == 1) 
                {
                        $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, orientation, use_min_answers, nr_min_answers, nr_max_answers) VALUES (%s, %s, %s, %s, %s)",
                                array('integer', 'text', 'integer', 'integer', 'integer'),
                                array(
                                        $this->getId(), 
                                        $this->getOrientation(),
                                        ($this->use_min_answers) ? 1 : 0,
                                        ($this->nr_min_answers > 0) ? $this->nr_min_answers : null,
                                        ($this->nr_max_answers > 0) ? $this->nr_max_answers : null
                                )
                        );

                        // saving material uris in the database
                        $this->saveMaterial();
                        $this->saveCategoriesToDb();
                }
        }

        function saveCategoriesToDb()
        {
                global $ilDB;
                
                $affectedRows = $ilDB->manipulateF("DELETE FROM svy_variable WHERE question_fi = %s",
                        array('integer'),
                        array($this->getId())
                );

                for ($i = 0; $i < $this->categories->getCategoryCount(); $i++)
                {
                        $cat = $this->categories->getCategory($i);
                        $category_id = $this->saveCategoryToDb($cat->title, $cat->neutral);
                        $next_id = $ilDB->nextId('svy_variable');
                        $affectedRows = $ilDB->manipulateF("INSERT INTO svy_variable (variable_id, category_fi, question_fi, value1, other, sequence, scale, tstamp) VALUES (%s, %s, %s, %s, %s, %s, %s, %s)",
                                array('integer','integer','integer','float','integer','integer', 'integer','integer'),
                                array($next_id, $category_id, $this->getId(), ($i + 1), $cat->other, $i, ($cat->scale > 0) ? $cat->scale : null, time())
                        );
                }
                $this->saveCompletionStatus();
        }
        
        function toXML($a_include_header = TRUE, $obligatory_state = "")
        {
                include_once("./Services/Xml/classes/class.ilXmlWriter.php");
                $a_xml_writer = new ilXmlWriter;
                $a_xml_writer->xmlHeader();
                $this->insertXML($a_xml_writer, $a_include_header, $obligatory_state);
                $xml = $a_xml_writer->xmlDumpMem(FALSE);
                if (!$a_include_header)
                {
                        $pos = strpos($xml, "?>");
                        $xml = substr($xml, $pos + 2);
                }
                return $xml;
        }
        
        function insertXML(&$a_xml_writer, $a_include_header = TRUE, $obligatory_state = "")
        {
                $attrs = array(
                        "id" => $this->getId(),
                        "title" => $this->getTitle(),
                        "type" => $this->getQuestiontype(),
                        "obligatory" => $this->getObligatory()
                );
                $a_xml_writer->xmlStartTag("question", $attrs);
                
                $a_xml_writer->xmlElement("description", NULL, $this->getDescription());
                $a_xml_writer->xmlElement("author", NULL, $this->getAuthor());
                if (strlen($this->label))
                {
                        $attrs = array(
                                "label" => $this->label,
                        );
                }
                else
                {
                        $attrs = array();
                }
                $a_xml_writer->xmlStartTag("questiontext", $attrs);
                $this->addMaterialTag($a_xml_writer, $this->getQuestiontext());
                $a_xml_writer->xmlEndTag("questiontext");

                $a_xml_writer->xmlStartTag("responses");

                for ($i = 0; $i < $this->categories->getCategoryCount(); $i++)
                {
                        $attrs = array(
                                "id" => $i
                        );
                        if (strlen($this->categories->getCategory($i)->other)) $attrs['other'] = $this->categories->getCategory($i)->other;
                        if (strlen($this->categories->getCategory($i)->neutral)) $attrs['neutral'] = $this->categories->getCategory($i)->neutral;
                        if (strlen($this->categories->getCategory($i)->label)) $attrs['label'] = $this->categories->getCategory($i)->label;
                        if (strlen($this->categories->getCategory($i)->scale)) $attrs['scale'] = $this->categories->getCategory($i)->scale;
                        $a_xml_writer->xmlStartTag("response_multiple", $attrs);
                        $this->addMaterialTag($a_xml_writer, $this->categories->getCategory($i)->title);
                        $a_xml_writer->xmlEndTag("response_multiple");
                }

                $a_xml_writer->xmlEndTag("responses");

                if (count($this->material))
                {
                        if (preg_match("/il_(\d*?)_(\w+)_(\d+)/", $this->material["internal_link"], $matches))
                        {
                                $attrs = array(
                                        "label" => $this->material["title"]
                                );
                                $a_xml_writer->xmlStartTag("material", $attrs);
                                $intlink = "il_" . IL_INST_ID . "_" . $matches[2] . "_" . $matches[3];
                                if (strcmp($matches[1], "") != 0)
                                {
                                        $intlink = $this->material["internal_link"];
                                }
                                $a_xml_writer->xmlElement("mattext", NULL, $intlink);
                                $a_xml_writer->xmlEndTag("material");
                        }
                }

                $a_xml_writer->xmlStartTag("metadata");
                $a_xml_writer->xmlStartTag("metadatafield");
                $a_xml_writer->xmlElement("fieldlabel", NULL, "orientation");
                $a_xml_writer->xmlElement("fieldentry", NULL, $this->getOrientation());
                $a_xml_writer->xmlEndTag("metadatafield");
                $a_xml_writer->xmlStartTag("metadatafield");
                $a_xml_writer->xmlElement("fieldlabel", NULL, "use_min_answers");
                $a_xml_writer->xmlElement("fieldentry", NULL, $this->use_min_answers);
                $a_xml_writer->xmlEndTag("metadatafield");
                $a_xml_writer->xmlStartTag("metadatafield");
                $a_xml_writer->xmlElement("fieldlabel", NULL, "nr_min_answers");
                $a_xml_writer->xmlElement("fieldentry", NULL, $this->nr_min_answers);
                $a_xml_writer->xmlEndTag("metadatafield");
                $a_xml_writer->xmlStartTag("metadatafield");
                $a_xml_writer->xmlElement("fieldlabel", NULL, "nr_max_answers");
                $a_xml_writer->xmlElement("fieldentry", NULL, $this->nr_max_answers);
                $a_xml_writer->xmlEndTag("metadatafield");
                $a_xml_writer->xmlEndTag("metadata");

                $a_xml_writer->xmlEndTag("question");
        }

        function getQuestionType()
        {
                return "SurveyMultipleChoiceQuestion";
        }

        function getAdditionalTableName()
        {
                return "svy_qst_mc";
        }

        function &getWorkingDataFromUserInput($post_data)
        {
                $entered_value = $post_data[$this->getId() . "_value"];
                $data = array();
                if (is_array($entered_value))
                {
                        foreach ($entered_value as $idx => $value)
                        {
                                array_push($data, array("value" => $value, "textanswer" => $post_data[$this->getId() . '_' . $value . '_other']));
                        }
                }
                for ($i = 0; $i < $this->categories->getCategoryCount(); $i++)
                {
                        $cat = $this->categories->getCategory($i);
                        if ($cat->other)
                        {
                                // #18212
                                if (!is_array($entered_value) || !in_array($i, $entered_value))
                                {
                                        if (strlen($post_data[$this->getId() . "_" . $i . "_other"]))
                                        {
                                                array_push($data, array("value" => $i, "textanswer" => $post_data[$this->getId() . '_' . $i . '_other'], "uncheck" => true));
                                        }
                                }
                        }
                }
                return $data;
        }

        function checkUserInput($post_data, $survey_id)
        {
                $entered_value = $post_data[$this->getId() . "_value"];
                if (!$this->getObligatory($survey_id) && count($entered_value) == 0) return "";

                if ($this->use_min_answers && $this->nr_min_answers > 0 && $this->nr_max_answers > 0 && $this->nr_min_answers == $this->nr_max_answers && count($entered_value) != $this->nr_max_answers)
                {
                        return sprintf($this->lng->txt("err_no_exact_answers"), $this->nr_min_answers);
                }
                if ($this->use_min_answers && $this->nr_min_answers > 0 && count($entered_value) < $this->nr_min_answers)
                {
                        return sprintf($this->lng->txt("err_no_min_answers"), $this->nr_min_answers);
                }
                if ($this->use_min_answers && $this->nr_max_answers > 0 && count($entered_value) > $this->nr_max_answers)
                {
                        return sprintf($this->lng->txt("err_no_max_answers"), $this->nr_max_answers);
                }
                if (!is_array($entered_value))
                {
                        return $this->lng->txt("question_mr_not_checked");
                }
                for ($i = 0; $i < $this->categories->getCategoryCount(); $i++)
                {
                        $cat = $this->categories->getCategory($i);
                        if ($cat->other)
                        {
                                if (in_array($i, $entered_value))
                                {
                                        if (array_key_exists($this->getId() . "_" . $i . "_other", $post_data) && !strlen($post_data[$this->getId() . "_" . $i . "_other"]))
                                        {
                                                return $this->lng->txt("question_mr_no_other_answer");
                                        }
                                }
                                else
                                {
                                        if (strlen($post_data[$this->getId() . "_" . $i . "_other"]))
                                        {
                                                return $this->lng->txt("question_mr_no_other_answer_checked");
                                        }
                                }
                        }
                }
                return "";
        }
        
        public function saveRandomData($active_id)
        {
                global $ilDB;
                // multiple responses
                for ($i = 0; $i < $this->categories->getCategoryCount(); $i++)
                {
                        if (rand(0,1)) 
                        {
                                $cat = $this->categories->getCategory($i);
                                $next_id = $ilDB->nextId('svy_answer');
                                $affectedRows = $ilDB->manipulateF("INSERT INTO svy_answer (answer_id, question_fi, active_fi, value, textanswer, tstamp) VALUES (%s, %s, %s, %s, %s, %s)",
                                        array('integer','integer','integer','float','text','integer'),
                                        array($next_id, $this->getId(), $active_id, $i, ($cat->other) ? "Random Data" : null, time())
                                );
                        }
                }
        }
        
        function saveUserInput($post_data, $active_id, $a_return = false)
        {
                global $ilDB;

                if($a_return)
                {
                        $return_data = array();
                }
                if (is_array($post_data[$this->getId() . "_value"]))
                {
                        foreach ($post_data[$this->getId() . "_value"] as $entered_value)
                        {
                                if (strlen($entered_value) > 0)
                                {
                                        if(!$a_return)
                                        {
                                                $next_id = $ilDB->nextId('svy_answer');
                                                
                                                #20216
                                                $fields = array();
                                                $fields['answer_id'] = array("integer", $next_id);
                                                $fields['question_fi'] = array("integer", $this->getId());
                                                $fields['active_fi'] = array("integer", $active_id);
                                                $fields['value'] = array("float", (strlen($entered_value)) ? $entered_value : NULL);
                                                $fields['textanswer'] = array("clob", ($post_data[$this->getId() . "_" . $entered_value . "_other"]) ? $post_data[$this->getId() . "_" . $entered_value . "_other"] : null);
                                                $fields['tstamp'] = array("integer", time());

                                                $affectedRows = $ilDB->insert("svy_answer", $fields);   
                                        }
                                        else
                                        {
                                                $return_data[] = array("value"=>$entered_value, 
                                                                "textanswer"=>$post_data[$this->getId() . "_" . $entered_value . "_other"]);
                                        }
                                }
                        }
                }
                if($a_return)
                {
                        return $return_data;
                }
        }

        function &getCumulatedResults($survey_id, $nr_of_users, $finished_ids)
        {
                global $ilDB;
                
                $question_id = $this->getId();
                
                $result_array = array();
                $cumulated = array();

                $sql = "SELECT svy_answer.* FROM svy_answer".
                        " JOIN svy_finished ON (svy_finished.finished_id = svy_answer.active_fi)".
                        " WHERE svy_answer.question_fi = ".$ilDB->quote($question_id, "integer").
                        " AND svy_finished.survey_fi = ".$ilDB->quote($survey_id, "integer");           
                if($finished_ids)
                {
                        $sql .= " AND ".$ilDB->in("svy_finished.finished_id", $finished_ids, "", "integer");
                }

                $result = $ilDB->query($sql);           
                $numrows = $result->numRows();
                
                // count the answers for every answer value
                $textanswers = array();
                while ($row = $ilDB->fetchAssoc($result))
                {
                        $cumulated[$row["value"]]++;
                        
                        // add text value to result array
                        if ($row["textanswer"])
                        {
                                $textanswers[$row["value"]][] = $row["textanswer"];
                        }
                }
                // sort textanswers by value
                if (is_array($textanswers))
                {
                        ksort($textanswers, SORT_NUMERIC);
                }
                asort($cumulated, SORT_NUMERIC);
                end($cumulated);
                
                $sql = "SELECT svy_answer.answer_id, svy_answer.question_fi, svy_answer.active_fi".
                        " FROM svy_answer".
                        " JOIN svy_finished ON (svy_finished.finished_id = svy_answer.active_fi)".
                        " WHERE svy_answer.question_fi = ".$ilDB->quote($question_id, "integer").
                        " AND svy_finished.survey_fi = ".$ilDB->quote($survey_id, "integer");           
                if($finished_ids)
                {
                        $sql .= " AND ".$ilDB->in("svy_finished.finished_id", $finished_ids, "", "integer");
                }
                
                $mcmr_result = $ilDB->query($sql);      
                $found = array();
                while ($row = $ilDB->fetchAssoc($mcmr_result))
                {
                        $found[$row["question_fi"] . "_" . $row["active_fi"]] = 1;
                }
                $result_array["USERS_ANSWERED"] = count($found);
                $result_array["USERS_SKIPPED"] = $nr_of_users - count($found);
                $numrows = count($found);

                $result_array["MEDIAN"] = "";
                $result_array["ARITHMETIC_MEAN"] = "";
                if(sizeof($cumulated))
                {
                        $prefix = "";
                        if (strcmp(key($cumulated), "") != 0)
                        {
                                $prefix = (key($cumulated)+1) . " - ";
                        }
                        $category = $this->categories->getCategoryForScale(key($cumulated)+1);
                        $result_array["MODE"] =  $prefix . $category->title;
                        $result_array["MODE_VALUE"] =  key($cumulated)+1;
                        $result_array["MODE_NR_OF_SELECTIONS"] = $cumulated[key($cumulated)];
                }
                $result_array["QUESTION_TYPE"] = "SurveyMultipleChoiceQuestion";
                $maxvalues = 0;
                for ($key = 0; $key < $this->categories->getCategoryCount(); $key++)
                {
                        $cat = $this->categories->getCategory($key);
                        $maxvalues += $cumulated[$cat->scale-1];
                }
                for ($key = 0; $key < $this->categories->getCategoryCount(); $key++)
                {
                        $cat = $this->categories->getCategory($key);
                        $percentage = 0;
                        if ($numrows > 0)
                        {
                                if ($maxvalues > 0)
                                {
                                        $percentage = ($maxvalues > 0) ? (float)((int)$cumulated[$cat->scale-1]/$maxvalues) : 0;
                                }
                        }
                        if(isset($textanswers[$cat->scale-1]))
                        {
                                // #12138
                                $result_array["textanswers"][$key] = $textanswers[$cat->scale-1];
                        }
                        $result_array["variables"][$key] = array("title" => $cat->title, "selected" => (int)$cumulated[$cat->scale-1], "percentage" => $percentage);
                }
                return $result_array;
        }

        function setExportDetailsXLS(&$workbook, &$format_title, &$format_bold, &$eval_data, $export_label)
        {
                include_once ("./Services/Excel/classes/class.ilExcelUtils.php");
                $worksheet =& $workbook->addWorksheet();
                $rowcounter = 0;
                switch ($export_label)
                {
                        case 'label_only':
                                $worksheet->writeString(0, 0, ilExcelUtils::_convert_text($this->lng->txt("label")), $format_bold);
                                $worksheet->writeString(0, 1, ilExcelUtils::_convert_text($this->label));
                                break;
                        case 'title_only':
                                $worksheet->writeString(0, 0, ilExcelUtils::_convert_text($this->lng->txt("title")), $format_bold);
                                $worksheet->writeString(0, 1, ilExcelUtils::_convert_text($this->getTitle()));
                                break;
                        default:
                                $worksheet->writeString(0, 0, ilExcelUtils::_convert_text($this->lng->txt("title")), $format_bold);
                                $worksheet->writeString(0, 1, ilExcelUtils::_convert_text($this->getTitle()));
                                $rowcounter++;
                                $worksheet->writeString($rowcounter, 0, ilExcelUtils::_convert_text($this->lng->txt("label")), $format_bold);
                                $worksheet->writeString($rowcounter, 1, ilExcelUtils::_convert_text($this->label));
                                break;
                }
                $rowcounter++;
                $worksheet->writeString($rowcounter, 0, ilExcelUtils::_convert_text($this->lng->txt("question")), $format_bold);
                $worksheet->writeString($rowcounter, 1, ilExcelUtils::_convert_text($this->getQuestiontext()));
                $rowcounter++;
                $worksheet->writeString($rowcounter, 0, ilExcelUtils::_convert_text($this->lng->txt("question_type")), $format_bold);
                $worksheet->writeString($rowcounter, 1, ilExcelUtils::_convert_text($this->lng->txt($this->getQuestionType())));
                $rowcounter++;
                $worksheet->writeString($rowcounter, 0, ilExcelUtils::_convert_text($this->lng->txt("users_answered")), $format_bold);
                $worksheet->write($rowcounter, 1, $eval_data["USERS_ANSWERED"]);
                $rowcounter++;
                $worksheet->writeString($rowcounter, 0, ilExcelUtils::_convert_text($this->lng->txt("users_skipped")), $format_bold);
                $worksheet->write($rowcounter, 1, $eval_data["USERS_SKIPPED"]);
                $rowcounter++;

                $worksheet->write($rowcounter, 0, ilExcelUtils::_convert_text($this->lng->txt("mode")), $format_bold);
                $worksheet->write($rowcounter++, 1, ilExcelUtils::_convert_text($eval_data["MODE_VALUE"]));
                $worksheet->write($rowcounter, 0, ilExcelUtils::_convert_text($this->lng->txt("mode_text")), $format_bold);
                $worksheet->write($rowcounter++, 1, ilExcelUtils::_convert_text($eval_data["MODE"]));
                $worksheet->write($rowcounter, 0, ilExcelUtils::_convert_text($this->lng->txt("mode_nr_of_selections")), $format_bold);
                $worksheet->write($rowcounter++, 1, ilExcelUtils::_convert_text($eval_data["MODE_NR_OF_SELECTIONS"]));
                $worksheet->write($rowcounter, 0, ilExcelUtils::_convert_text($this->lng->txt("categories")), $format_bold);
                $worksheet->write($rowcounter, 1, ilExcelUtils::_convert_text($this->lng->txt("title")), $format_title);
                $worksheet->write($rowcounter, 2, ilExcelUtils::_convert_text($this->lng->txt("value")), $format_title);
                $worksheet->write($rowcounter, 3, ilExcelUtils::_convert_text($this->lng->txt("category_nr_selected")), $format_title);
                $worksheet->write($rowcounter++, 4, ilExcelUtils::_convert_text($this->lng->txt("svy_fraction_of_selections")), $format_title);
                foreach ($eval_data["variables"] as $key => $value)
                {
                        $worksheet->write($rowcounter, 1, ilExcelUtils::_convert_text($value["title"]));
                        $category = $this->categories->getCategory($key);
                        $worksheet->write($rowcounter, 2, $category->scale);
                        $worksheet->write($rowcounter, 3, ilExcelUtils::_convert_text($value["selected"]));
                        $worksheet->write($rowcounter++, 4, ilExcelUtils::_convert_text($value["percentage"]), $format_percent);
                }
                
                // add text answers to detailed results
                if (is_array($eval_data["textanswers"]))
                {
                        $worksheet->write($rowcounter, 0, ilExcelUtils::_convert_text($this->lng->txt("freetext_answers")), $format_bold);
                        $worksheet->write($rowcounter, 1, ilExcelUtils::_convert_text($this->lng->txt("title")), $format_title);
                        $worksheet->write($rowcounter++, 2, ilExcelUtils::_convert_text($this->lng->txt("answer")), $format_title);
                        
                        foreach ($eval_data["textanswers"] as $key => $answers)
                        {
                                $title = $eval_data["variables"][$key]["title"];
                                foreach ($answers as $answer)
                                {
                                        $worksheet->write($rowcounter, 1, ilExcelUtils::_convert_text($title));
                                        $worksheet->write($rowcounter++, 2, ilExcelUtils::_convert_text($answer));
                                }
                        }
                }                       
        }

        function addUserSpecificResultsExportTitles(&$a_array, $a_use_label = false, $a_substitute = true)
        {
                parent::addUserSpecificResultsExportTitles($a_array, $a_use_label, $a_substitute);
                
                for ($index = 0; $index < $this->categories->getCategoryCount(); $index++)
                {
                        $category = $this->categories->getCategory($index);
                        $title = $category->title;
                        
                        if(!$a_use_label || $a_substitute)
                        {
                                array_push($a_array, $title);
                        }
                        else
                        {
                                array_push($a_array, "");
                        }
                        
                        // optionally add headers for text answers
                        if ($category->other)
                        {
                                if(!$a_use_label || $a_substitute)
                                {
                                        array_push($a_array, $title . " - ". $this->lng->txt("other"));
                                }
                                else
                                {
                                        array_push($a_array, "");
                                }
                        }
                }
        }
        
        function addUserSpecificResultsData(&$a_array, &$resultset)
        {
                if (count($resultset["answers"][$this->getId()]))
                {
                        array_push($a_array, "");
                        for ($index = 0; $index < $this->categories->getCategoryCount(); $index++)
                        {
                                $category = $this->categories->getCategory($index);             
                                $incoming_value = $category->scale ? $category->scale-1 : $index;               
                                
                                $found = 0;
                                $textanswer = "";                               
                                foreach ($resultset["answers"][$this->getId()] as $answerdata)
                                {
                                        if (strcmp($incoming_value, $answerdata["value"]) == 0)
                                        {
                                                $found = $answerdata["value"]+1;
                                                $textanswer = $answerdata["textanswer"];
                                        }
                                }
                                if ($found)
                                {
                                        array_push($a_array, $found);
                                }
                                else
                                {
                                        array_push($a_array, "0");
                                }                               
                                if ($category->other)
                                {
                                        array_push($a_array, $textanswer);
                                }
                        }
                }
                else
                {
                        array_push($a_array, $this->getSkippedValue());
                        for ($index = 0; $index < $this->categories->getCategoryCount(); $index++)
                        {
                                array_push($a_array, "");
                                
                                // add empty text answers for skipped question
                                $category = $this->categories->getCategory($index);
                                if ($category->other)
                                {
                                        array_push($a_array, "");
                                }
                        }
                }
        }

        function &getUserAnswers($survey_id, $finished_ids)
        {
                global $ilDB;
                
                $answers = array();
                
                $sql = "SELECT svy_answer.* FROM svy_answer".
                        " JOIN svy_finished ON (svy_finished.finished_id = svy_answer.active_fi)".
                        " WHERE svy_answer.question_fi = ".$ilDB->quote($this->getId(), "integer").
                        " AND svy_finished.survey_fi = ".$ilDB->quote($survey_id, "integer");           
                if($finished_ids)
                {
                        $sql .= " AND ".$ilDB->in("svy_finished.finished_id", $finished_ids, "", "integer");
                }
                
                $result = $ilDB->query($sql);           
                while ($row = $ilDB->fetchAssoc($result))
                {
                        $category = $this->categories->getCategoryForScale($row["value"]+1);
                        if (!is_array($answers[$row["active_fi"]]))
                        {
                                $answers[$row["active_fi"]] = array();
                        }
                        $title = $row["value"] + 1 . " - " . $category->title;
                        if ($category->other) $title .= ": " . $row["textanswer"];
                        $catindex = $this->categories->getIndex($category);
                        if ($catindex !== null)
                        {
                                $answers[$row["active_fi"]][$catindex] = $title;
                        }
                        else
                        {
                                array_push($answers[$row["active_fi"]], $title);
                        }
                        ksort($answers[$row["active_fi"]], SORT_NUMERIC);
                }
                return $answers;
        }

        function importAdditionalMetadata($a_meta)
        {
                foreach ($a_meta as $key => $value)
                {
                        switch ($value["label"])
                        {
                                case "orientation":
                                        $this->setOrientation($value["entry"]);
                                        break;
                                case "use_min_answers":
                                        $this->use_min_answers = $value["entry"];
                                        break;
                                case "nr_min_answers":
                                        $this->nr_min_answers = $value["entry"];
                                        break;
                                case "nr_max_answers":
                                        $this->nr_max_answers = $value["entry"];
                                        break;
                        }
                }
        }

        function importResponses($a_data)
        {
                foreach ($a_data as $id => $data)
                {
                        $categorytext = "";
                        foreach ($data["material"] as $material)
                        {
                                $categorytext .= $material["text"];
                        }
                        $this->categories->addCategory(
                                $categorytext, 
                                strlen($data['other']) ? $data['other'] : 0, 
                                strlen($data['neutral']) ? $data['neutral'] : 0, 
                                strlen($data['label']) ? $data['label'] : null, 
                                strlen($data['scale']) ? $data['scale'] : null
                        );
                }
        }

        function usableForPrecondition()
        {
                return TRUE;
        }

        function getAvailableRelations()
        {
                return array("=", "<>");
        }

        public function getPreconditionOptions()
        {
                global $lng;
                
                $options = array();
                for ($i = 0; $i < $this->categories->getCategoryCount(); $i++)
                {
                        $category = $this->categories->getCategory($i);                 
                        $options[$category->scale-1] = $category->scale . " - " . $category->title;
                }
                return $options;
        }

        public function getPreconditionSelectValue($default = "", $title, $variable)
        {
                include_once "./Services/Form/classes/class.ilSelectInputGUI.php";
                $step3 = new ilSelectInputGUI($title, $variable);
                $options = $this->getPreconditionOptions();
                $step3->setOptions($options);
                $step3->setValue($default);
                return $step3;
        }

        function getPreconditionValueOutput($value)
        {
                // #18136
                $category = $this->categories->getCategoryForScale($value+1);
                
                // #17895 - see getPreconditionOptions()
                return $category->scale . 
                        " - " . 
                        ((strlen($category->title)) ? $category->title : $this->lng->txt('other_answer'));
        }

        public function getCategories()
        {
                return $this->categories;
        }

}
?>