Public Member Functions | Data Fields

assNumeric Class Reference

Class for numeric questions. More...

Inheritance diagram for assNumeric:
Collaboration diagram for assNumeric:

Public Member Functions

 assNumeric ($title="", $comment="", $author="", $owner=-1, $question="")
 assNumeric constructor
 isComplete ()
 Returns true, if a numeric question is complete for use.
 fromXML (&$item, &$questionpool_id, &$tst_id, &$tst_object, &$question_counter, &$import_mapping)
 Creates a question from a QTI file.
 to_xml ($a_include_header=true, $a_include_binary=true, $a_shuffle=false, $test_output=false, $force_image_references=false)
 Returns a QTI xml representation of the question.
 saveToDb ($original_id="")
 Saves a assNumeric object to a database.
 loadFromDb ($question_id)
 Loads a assNumeric object from a database.
 setQuestion ($question="")
 Sets the numeric question.
 addRange ($lowerlimit=0.0, $upperlimit=0.0, $points=0.0, $order=0)
 Adds a range to the numeric question.
 duplicate ($for_test=true, $title="", $author="", $owner="")
 Duplicates an assNumericQuestion.
 copyObject ($target_questionpool, $title="")
 Copies an assNumeric object.
 getQuestion ()
 Gets the numeric question text.
 getRangeCount ()
 Returns the number of ranges.
 getRange ($index=0)
 Returns a range.
 deleteRange ($index=0)
 Deletes a range.
 flushRanges ()
 Deletes all ranges.
 getMaximumPoints ()
 Returns the maximum points, a learner can reach answering the question.
 getBestRange ()
 Returns the range with the maximum points, a learner can reach answering the question.
 calculateReachedPoints ($active_id, $pass=NULL)
 Returns the points, a learner has reached answering the question.
 saveWorkingData ($active_id, $pass=NULL)
 Saves the learners input of the question to the database.
 syncWithOriginal ()
 getQuestionType ()
 Returns the question type of the question.
 getMaxChars ()
 Returns the maximum number of characters for the numeric input field.
 setMaxChars ($maxchars)
 Sets the maximum number of characters for the numeric input field.
 getAdditionalTableName ()
 Returns the name of the additional question data table in the database.

Data Fields

 $question
 $ranges
 $maxchars

Detailed Description

Class for numeric questions.

assNumeric is a class for numeric questions. To solve a numeric question, a learner has to enter a numerical value in a defined range

Author:
Helmut Schottmüller <helmut.schottmueller@mac.com>
Nina Gharib <nina@wgserve.de>
Version:
Id:
class.assNumeric.php 14646 2007-09-04 10:03:31Z hschottm

class.assNumeric.php Assessment

Definition at line 38 of file class.assNumeric.php.


Member Function Documentation

assNumeric::addRange ( lowerlimit = 0.0,
upperlimit = 0.0,
points = 0.0,
order = 0 
)

Adds a range to the numeric question.

Adds a range to the numeric question. An assNumericRange object will be created and assigned to the array $this->ranges

Parameters:
double $lowerlimit The lower limit of the range
double $upperlimit The upper limit of the range
double $points The points for entering a number in the correct range
integer $order The display order of the range public
See also:
$ranges
assNumericalRange

Definition at line 594 of file class.assNumeric.php.

References $key, and assQuestion::$points.

Referenced by fromXML().

        {
                $found = -1;
                foreach ($this->ranges as $key => $range)
                {
                        if ($range->getOrder() == $order)
                        {
                                $found = $order;
                        }
                }
                include_once "./assessment/classes/class.assNumericRange.php";
                if ($found >= 0)
                {
                        // insert range
                        $range = new assNumericRange($lowerlimit, $upperlimit, $points, $found);
                        array_push($this->ranges, $range);
                        for ($i = $found + 1; $i < count($this->ranges); $i++)
                        {
                                $this->ranges[$i] = $this->ranges[$i-1];
                        }
                        $this->ranges[$found] = $range;
                }
                else
                {
                        // append range
                        $range = new assNumericRange($lowerlimit, $upperlimit, $points, count($this->ranges));
                        array_push($this->ranges, $range);
                }
        }

Here is the caller graph for this function:

assNumeric::assNumeric ( title = "",
comment = "",
author = "",
owner = -1,
question = "" 
)

assNumeric constructor

The constructor takes possible arguments an creates an instance of the assNumeric object.

Parameters:
string $title A title string to describe the question
string $comment A comment string to describe the question
string $author A string containing the name of the questions author
integer $owner A numerical ID to identify the owner/creator
string $question The question string of the numeric question public
See also:
assQuestion:assQuestion()

Definition at line 80 of file class.assNumeric.php.

References assQuestion::$author, assQuestion::$comment, assQuestion::$owner, $question, assQuestion::$title, and assQuestion::assQuestion().

        {
                $this->assQuestion($title, $comment, $author, $owner);
                $this->question = $question;
                $this->ranges = array();
                $this->maxchars = 6;
        }

Here is the call graph for this function:

assNumeric::calculateReachedPoints ( active_id,
pass = NULL 
)

Returns the points, a learner has reached answering the question.

Returns the points, a learner has reached answering the question The points are calculated from the given answers including checks for all special scoring options in the test container.

Parameters:
integer $user_id The database ID of the learner
integer $test_id The database Id of the test containing the question public

Definition at line 857 of file class.assNumeric.php.

References $data, $key, assQuestion::$points, $query, $result, assQuestion::getId(), and assQuestion::getSolutionMaxPass().

        {
                global $ilDB;
                
                $found_values = array();
                if (is_null($pass))
                {
                        $pass = $this->getSolutionMaxPass($active_id);
                }
                $query = sprintf("SELECT * FROM tst_solutions WHERE active_fi = %s AND question_fi = %s AND pass = %s",
                        $ilDB->quote($active_id . ""),
                        $ilDB->quote($this->getId() . ""),
                        $ilDB->quote($pass . "")
                );
                $result = $ilDB->query($query);
                $data = $result->fetchRow(DB_FETCHMODE_ASSOC);
                
                $enteredvalue = $data["value1"];
                if (!is_numeric($enteredvalue)) return 0;
                $points = 0;
                foreach ($this->ranges as $key => $range)
                {
                        if ($points == 0)
                        {
                                if ($range->contains($enteredvalue))
                                {
                                        $points = $range->getPoints();
                                }
                        }
                }

                $points = parent::calculateReachedPoints($active_id, $pass = NULL, $points);
                return $points;
        }

Here is the call graph for this function:

assNumeric::copyObject ( target_questionpool,
title = "" 
)

Copies an assNumeric object.

Copies an assNumeric object

public

Definition at line 687 of file class.assNumeric.php.

References assQuestion::$title, assQuestion::_getOriginalId(), and assQuestion::getObjId().

        {
                if ($this->id <= 0)
                {
                        // The question has not been saved. It cannot be duplicated
                        return;
                }
                // duplicate the question in database
                $clone = $this;
                include_once ("./assessment/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);

                return $clone->id;
        }

Here is the call graph for this function:

assNumeric::deleteRange ( index = 0  ) 

Deletes a range.

Deletes a range with a given index. The index of the first range is 0, the index of the second range is 1 and so on.

Parameters:
integer $index A nonnegative index of the n-th range public
See also:
$ranges

Definition at line 773 of file class.assNumeric.php.

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

assNumeric::duplicate ( for_test = true,
title = "",
author = "",
owner = "" 
)

Duplicates an assNumericQuestion.

Duplicates an assNumericQuestion

public

Definition at line 636 of file class.assNumeric.php.

References assQuestion::$author, assQuestion::$owner, assQuestion::$title, assQuestion::_getOriginalId(), and assQuestion::getId().

Referenced by fromXML().

        {
                if ($this->id <= 0)
                {
                        // The question has not been saved. It cannot be duplicated
                        return;
                }
                // duplicate the question in database
                $this_id = $this->getId();
                $clone = $this;
                include_once ("./assessment/classes/class.assQuestion.php");
                $original_id = assQuestion::_getOriginalId($this->id);
                $clone->id = -1;
                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);

                return $clone->id;
        }

Here is the call graph for this function:

Here is the caller graph for this function:

assNumeric::flushRanges (  ) 

Deletes all ranges.

Deletes all ranges

public

See also:
$ranges

Definition at line 797 of file class.assNumeric.php.

        {
                $this->ranges = array();
        }

assNumeric::fromXML ( &$  item,
&$  questionpool_id,
&$  tst_id,
&$  tst_object,
&$  question_counter,
&$  import_mapping 
)

Creates a question from a QTI file.

Receives parameters from a QTI parser and creates a valid ILIAS question object

Parameters:
object $item The QTI item object
integer $questionpool_id The id of the parent questionpool
integer $tst_id The id of the parent test if the question is part of a test
object $tst_object A reference to the parent test object
integer $question_counter A reference to a question counter to count the questions of an imported question pool
array $import_mapping An array containing references to included ILIAS objects public

Definition at line 127 of file class.assNumeric.php.

References $_SESSION, $maxchars, assQuestion::$points, ilObjQuestionPool::_getImportDirectory(), ilObjTest::_getImportDirectory(), ilRTE::_replaceMediaObjectImageSrc(), ilObjMediaObject::_saveTempFileAsMediaObject(), ilObjMediaObject::_saveUsage(), addRange(), duplicate(), getContent(), assQuestion::getId(), getQuestion(), assQuestion::QTIMaterialToString(), saveToDb(), assQuestion::setAuthor(), assQuestion::setComment(), assQuestion::setEstimatedWorkingTime(), setMaxChars(), assQuestion::setObjId(), assQuestion::setOwner(), setQuestion(), assQuestion::setSuggestedSolution(), and assQuestion::setTitle().

        {
                global $ilUser;

                // empty session variable for imported xhtml mobs
                unset($_SESSION["import_mob_xhtml"]);
                $presentation = $item->getPresentation(); 
                $duration = $item->getDuration();
                $now = getdate();
                $maxchars = 0;
                $points = 0;
                $upperlimit = 0;
                $lowerlimit = 0;
                $created = sprintf("%04d%02d%02d%02d%02d%02d", $now['year'], $now['mon'], $now['mday'], $now['hours'], $now['minutes'], $now['seconds']);
                foreach ($presentation->order as $entry)
                {
                        switch ($entry["type"])
                        {
                                case "response":
                                        $response = $presentation->response[$entry["index"]];
                                        $rendertype = $response->getRenderType(); 
                                        switch (strtolower(get_class($rendertype)))
                                        {
                                                case "ilqtirenderfib":
                                                        $maxchars = $rendertype->getMaxchars();
                                                        break;
                                        }
                                        break;
                        }
                }

                foreach ($item->resprocessing as $resprocessing)
                {
                        foreach ($resprocessing->respcondition as $respcondition)
                        {
                                $conditionvar = $respcondition->getConditionvar();
                                foreach ($conditionvar->order as $order)
                                {
                                        switch ($order["field"])
                                        {
                                                case "varlte":
                                                        $upperlimit = $conditionvar->varlte[$order["index"]]->getContent();
                                                        break;
                                                case "vargte":
                                                        $lowerlimit = $conditionvar->vargte[$order["index"]]->getContent();
                                                        break;
                                        }
                                }
                                foreach ($respcondition->setvar as $setvar)
                                {
                                        $points = $setvar->getContent();
                                }
                        }
                }
                
                $this->setTitle($item->getTitle());
                $this->setComment($item->getComment());
                $this->setAuthor($item->getAuthor());
                $this->setOwner($ilUser->getId());
                $this->setQuestion($this->QTIMaterialToString($item->getQuestiontext()));
                $this->setObjId($questionpool_id);
                $this->setEstimatedWorkingTime($duration["h"], $duration["m"], $duration["s"]);
                $this->setMaxChars($maxchars);
                $this->addRange($lowerlimit, $upperlimit, $points);
                $this->saveToDb();
                if (count($item->suggested_solutions))
                {
                        foreach ($item->suggested_solutions as $suggested_solution)
                        {
                                $this->setSuggestedSolution($suggested_solution["solution"]->getContent(), $suggested_solution["gap_index"], true);
                        }
                        $this->saveToDb();
                }
                // handle the import of media objects in XHTML code
                if (is_array($_SESSION["import_mob_xhtml"]))
                {
                        include_once "./content/classes/Media/class.ilObjMediaObject.php";
                        include_once "./Services/RTE/classes/class.ilRTE.php";
                        foreach ($_SESSION["import_mob_xhtml"] as $mob)
                        {
                                if ($tst_id > 0)
                                {
                                        include_once "./assessment/classes/class.ilObjTest.php";
                                        $importfile = ilObjTest::_getImportDirectory() . "/" . $_SESSION["tst_import_subdir"] . "/" . $mob["uri"];
                                }
                                else
                                {
                                        include_once "./assessment/classes/class.ilObjQuestionPool.php";
                                        $importfile = ilObjQuestionPool::_getImportDirectory() . "/" . $_SESSION["qpl_import_subdir"] . "/" . $mob["uri"];
                                }
                                $media_object =& ilObjMediaObject::_saveTempFileAsMediaObject(basename($importfile), $importfile, FALSE);
                                ilObjMediaObject::_saveUsage($media_object->getId(), "qpl:html", $this->getId());
                                $this->setQuestion(ilRTE::_replaceMediaObjectImageSrc(str_replace("src=\"" . $mob["mob"] . "\"", "src=\"" . "il_" . IL_INST_ID . "_mob_" . $media_object->getId() . "\"", $this->getQuestion()), 1));
                        }
                        $this->saveToDb();
                }
                if ($tst_id > 0)
                {
                        $q_1_id = $this->getId();
                        $question_id = $this->duplicate(true);
                        $tst_object->questions[$question_counter++] = $question_id;
                        $import_mapping[$item->getIdent()] = array("pool" => $q_1_id, "test" => $question_id);
                }
                else
                {
                        $import_mapping[$item->getIdent()] = array("pool" => $this->getId(), "test" => 0);
                }
                //$ilLog->write(strftime("%D %T") . ": finished import multiple choice question (single response)");
        }

Here is the call graph for this function:

assNumeric::getAdditionalTableName (  ) 

Returns the name of the additional question data table in the database.

Returns the name of the additional question data table in the database

Returns:
string The additional table name public

Reimplemented from assQuestion.

Definition at line 1079 of file class.assNumeric.php.

        {
                return "qpl_question_numeric";
        }

assNumeric::getBestRange (  ) 

Returns the range with the maximum points, a learner can reach answering the question.

Returns the range with the maximum points, a learner can reach answering the question

public

See also:
$points

Definition at line 831 of file class.assNumeric.php.

References $key.

        {
                $max = 0;
                $bestrange = NULL;
                foreach ($this->ranges as $key => $range) 
                {
                        if ($range->getPoints() > $max)
                        {
                                $max = $range->getPoints();
                                $bestrange = $range;
                        }
                }
                return $bestrange;
        }

assNumeric::getMaxChars (  ) 

Returns the maximum number of characters for the numeric input field.

Returns the maximum number of characters for the numeric input field

Returns:
integer The maximum number of characters public

Definition at line 1053 of file class.assNumeric.php.

Referenced by saveToDb(), and to_xml().

        {
                return $this->maxchars;
        }

Here is the caller graph for this function:

assNumeric::getMaximumPoints (  ) 

Returns the maximum points, a learner can reach answering the question.

Returns the maximum points, a learner can reach answering the question

public

See also:
$points

Reimplemented from assQuestion.

Definition at line 810 of file class.assNumeric.php.

References $key.

Referenced by isComplete(), saveToDb(), and syncWithOriginal().

        {
                $max = 0;
                foreach ($this->ranges as $key => $range) 
                {
                        if ($range->getPoints() > $max)
                        {
                                $max = $range->getPoints();
                        }
                }
                return $max;
        }

Here is the caller graph for this function:

assNumeric::getQuestion (  ) 

Gets the numeric question text.

Gets the question string of the assNumeric object

Returns:
string The question string of the assNumeric object public
See also:
$question

Definition at line 724 of file class.assNumeric.php.

Referenced by fromXML(), and to_xml().

        {
                return $this->question;
        }

Here is the caller graph for this function:

assNumeric::getQuestionType (  ) 

Returns the question type of the question.

Returns the question type of the question

Returns:
integer The question type of the question public

Definition at line 1040 of file class.assNumeric.php.

Referenced by saveToDb().

        {
                return 9;
        }

Here is the caller graph for this function:

assNumeric::getRange ( index = 0  ) 

Returns a range.

Returns a range with a given index. The index of the first range is 0, the index of the second range is 1 and so on.

Parameters:
integer $index A nonnegative index of the n-th range
Returns:
object assNumericelRange-Object containing the range public
See also:
$ranges

Definition at line 754 of file class.assNumeric.php.

        {
                if ($index < 0) return NULL;
                if (count($this->ranges) < 1) return NULL;
                if ($index >= count($this->ranges)) return NULL;

                return $this->ranges[$index];
        }

assNumeric::getRangeCount (  ) 

Returns the number of ranges.

Returns the number of ranges

Returns:
integer The number of ranges of the numeric question public
See also:
$ranges

Definition at line 738 of file class.assNumeric.php.

        {
                return count($this->ranges);
        }

assNumeric::isComplete (  ) 

Returns true, if a numeric question is complete for use.

Returns true, if a numeric question is complete for use

Returns:
boolean True, if the numeric question is complete for use, otherwise false public

Reimplemented from assQuestion.

Definition at line 102 of file class.assNumeric.php.

References getMaximumPoints().

Referenced by saveToDb(), and syncWithOriginal().

        {
                if (($this->title) and ($this->author) and ($this->question) and (count($this->ranges)) and ($this->getMaximumPoints() > 0))
                {
                        return true;
                }
                        else
                {
                        return false;
                }
        }

Here is the call graph for this function:

Here is the caller graph for this function:

assNumeric::loadFromDb ( question_id  ) 

Loads a assNumeric object from a database.

Loads a assNumeric object from a database (experimental)

Parameters:
object $db A pear DB object
integer $question_id A unique key which defines the multiple choice test in the database public

Reimplemented from assQuestion.

Definition at line 519 of file class.assNumeric.php.

References $data, $query, $result, ilRTE::_replaceMediaObjectImageSrc(), and assQuestion::setEstimatedWorkingTime().

        {
                global $ilDB;
                
    $query = sprintf("SELECT qpl_questions.*, qpl_question_numeric.* FROM qpl_questions, qpl_question_numeric WHERE question_id = %s AND qpl_questions.question_id = qpl_question_numeric.question_fi",
                        $ilDB->quote($question_id)
                );
                $result = $ilDB->query($query);
                if (strcmp(strtolower(get_class($result)), db_result) == 0)
                {
                        if ($result->numRows() == 1)
                        {
                                $data = $result->fetchRow(DB_FETCHMODE_OBJECT);
                                $this->id = $question_id;
                                $this->title = $data->title;
                                $this->comment = $data->comment;
                                $this->solution_hint = $data->solution_hint;
                                $this->original_id = $data->original_id;
                                $this->obj_id = $data->obj_fi;
                                $this->author = $data->author;
                                $this->owner = $data->owner;
                                $this->points = $data->points;
                                include_once("./Services/RTE/classes/class.ilRTE.php");
                                $this->question = ilRTE::_replaceMediaObjectImageSrc($data->question_text, 1);
                                $this->maxchars = $data->maxNumOfChars;
                                $this->setEstimatedWorkingTime(substr($data->working_time, 0, 2), substr($data->working_time, 3, 2), substr($data->working_time, 6, 2));
                        }

                        $query = sprintf("SELECT * FROM qpl_numeric_range WHERE question_fi = %s ORDER BY aorder ASC",
                                $ilDB->quote($question_id)
                        );

                        $result = $ilDB->query($query);

                        include_once "./assessment/classes/class.assNumericRange.php";
                        if (strcmp(strtolower(get_class($result)), db_result) == 0)
                        {
                                while ($data = $result->fetchRow(DB_FETCHMODE_ASSOC))
                                {
                                        array_push($this->ranges, new assNumericRange($data["lowerlimit"], $data["upperlimit"], $data["points"], $data["aorder"]));
                                }
                        }
                }
                parent::loadFromDb($question_id);
        }

Here is the call graph for this function:

assNumeric::saveToDb ( original_id = ""  ) 

Saves a assNumeric object to a database.

Saves a assNumeric object to a database (experimental)

Parameters:
object $db A pear DB object public

Reimplemented from assQuestion.

Definition at line 397 of file class.assNumeric.php.

References $key, $query, $result, ilRTE::_cleanupMediaObjectUsage(), ilRTE::_replaceMediaObjectImageSrc(), assQuestion::createPageObject(), assQuestion::getEstimatedWorkingTime(), assQuestion::getId(), getMaxChars(), getMaximumPoints(), getQuestionType(), assQuestion::getTestId(), assQuestion::insertIntoTest(), and isComplete().

Referenced by fromXML().

        {
                global $ilDB;

                $complete = 0;
                if ($this->isComplete())
                {
                        $complete = 1;
                }
                $estw_time = $this->getEstimatedWorkingTime();
                $estw_time = sprintf("%02d:%02d:%02d", $estw_time['h'], $estw_time['m'], $estw_time['s']);

                if ($original_id)
                {
                        $original_id = $ilDB->quote($original_id);
                }
                else
                {
                        $original_id = "NULL";
                }

                // cleanup RTE images which are not inserted into the question text
                include_once("./Services/RTE/classes/class.ilRTE.php");
                ilRTE::_cleanupMediaObjectUsage($this->question, "qpl:html",
                        $this->getId());

                if ($this->id == -1)
                {
                        // Neuen Datensatz schreiben
                        $now = getdate();
                        $question_type = $this->getQuestionType();
                        $created = sprintf("%04d%02d%02d%02d%02d%02d", $now['year'], $now['mon'], $now['mday'], $now['hours'], $now['minutes'], $now['seconds']);
                        $query = sprintf("INSERT INTO qpl_questions (question_id, question_type_fi, obj_fi, title, comment, author, owner, question_text, points, working_time, complete, created, original_id, TIMESTAMP) VALUES (NULL, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, NULL)",
                                $ilDB->quote($question_type),
                                $ilDB->quote($this->obj_id),
                                $ilDB->quote($this->title),
                                $ilDB->quote($this->comment),
                                $ilDB->quote($this->author),
                                $ilDB->quote($this->owner),
                                $ilDB->quote(ilRTE::_replaceMediaObjectImageSrc($this->question, 0)),
                                $ilDB->quote($this->getMaximumPoints() . ""),
                                $ilDB->quote($estw_time),
                                $ilDB->quote("$complete"),
                                $ilDB->quote($created),
                                $original_id
                        );
                        $result = $ilDB->query($query);
                        
                        if ($result == DB_OK)
                        {
                                $this->id = $ilDB->getLastInsertId();
                                $query = sprintf("INSERT INTO qpl_question_numeric (question_fi, maxNumOfChars) VALUES (%s, %s)",
                                        $ilDB->quote($this->id . ""),
                                        $ilDB->quote($this->getMaxChars() . "")
                                );
                                $ilDB->query($query);

                                // create page object of question
                                $this->createPageObject();

                                if ($this->getTestId() > 0)
                                {
                                $this->insertIntoTest($this->getTestId());
                                }
                        }
                }
                else
                {
                        // Vorhandenen Datensatz aktualisieren
                        $query = sprintf("UPDATE qpl_questions SET obj_fi = %s, title = %s, comment = %s, author = %s, question_text = %s, points = %s, working_time=%s, complete = %s WHERE question_id = %s",
                                $ilDB->quote($this->obj_id. ""),
                                $ilDB->quote($this->title),
                                $ilDB->quote($this->comment),
                                $ilDB->quote($this->author),
                                $ilDB->quote(ilRTE::_replaceMediaObjectImageSrc($this->question, 0)),
                                $ilDB->quote($this->getMaximumPoints() . ""),
                                $ilDB->quote($estw_time),
                                $ilDB->quote("$complete"),
                                $ilDB->quote($this->id)
                        );
                        $result = $ilDB->query($query);
                        $query = sprintf("UPDATE qpl_question_numeric SET maxNumOfChars = %s WHERE question_fi = %s",
                                $ilDB->quote($this->getMaxChars() . ""),
                                $ilDB->quote($this->id . "")
                        );
                        $result = $ilDB->query($query);
                }
                if ($result == DB_OK)
                {
                        // Write Ranges to the database
                        
                        // 1. delete old ranges
                        $query = sprintf("DELETE FROM qpl_numeric_range WHERE question_fi = %s",
                                $ilDB->quote($this->id)
                        );
                        $result = $ilDB->query($query);

                        // 2. write ranges
                        foreach ($this->ranges as $key => $range)
                        {
                                $query = sprintf("INSERT INTO qpl_numeric_range (range_id, question_fi, lowerlimit, upperlimit, points, aorder, lastchange) VALUES (NULL, %s, %s, %s, %s, %s, NULL)",
                                $ilDB->quote($this->id),
                                $ilDB->quote($range->getLowerLimit()),
                                $ilDB->quote($range->getUpperLimit() . ""),
                                $ilDB->quote($range->getPoints() . ""),
                                $ilDB->quote($range->getOrder() . "")
                                );
                                $answer_result = $ilDB->query($query);
                        }
                }
                parent::saveToDb($original_id);
        }

Here is the call graph for this function:

Here is the caller graph for this function:

assNumeric::saveWorkingData ( active_id,
pass = NULL 
)

Saves the learners input of the question to the database.

Saves the learners input of the question to the database

Parameters:
integer $test_id The database id of the test containing this question
Returns:
boolean Indicates the save status (true if saved successful, false otherwise) public
See also:
$ranges

Reimplemented from assQuestion.

Definition at line 902 of file class.assNumeric.php.

References $_POST, $query, $result, $row, ilObjAssessmentFolder::_enabledAssessmentLogging(), ilObjAssessmentFolder::_getLogLanguage(), ilObjTest::_getPass(), assQuestion::getId(), and assQuestion::logAction().

        {
                global $ilDB;
                global $ilUser;

                include_once "./assessment/classes/class.ilObjTest.php";
                $actualpass = ilObjTest::_getPass($active_id);
                $entered_values = 0;
                $numeric_result = str_replace(",",".",$_POST["numeric_result"]);
                $query = sprintf("SELECT * FROM tst_solutions WHERE active_fi = %s AND question_fi = %s AND pass = %s",
                        $ilDB->quote($active_id . ""),
                        $ilDB->quote($this->getId() . ""),
                        $ilDB->quote($actualpass . "")
                );
                $result = $ilDB->query($query);
                $row = $result->fetchRow(DB_FETCHMODE_OBJECT);
                $update = $row->solution_id;
                if ($update)
                {
                        if (strlen($numeric_result))
                        {
                                $query = sprintf("UPDATE tst_solutions SET value1 = %s WHERE solution_id = %s",
                                        $ilDB->quote(trim($numeric_result)),
                                        $ilDB->quote($update)
                                );
                                $result = $ilDB->query($query);
                                $entered_values++;
                        }
                        else
                        {
                                $query = sprintf("DELETE FROM tst_solutions WHERE solution_id = %s",
                                        $ilDB->quote($update)
                                );
                                $result = $ilDB->query($query);
                        }
                }
                else
                {
                        if (strlen($numeric_result))
                        {
                                $query = sprintf("INSERT INTO tst_solutions (solution_id, active_fi, question_fi, value1, value2, pass, TIMESTAMP) VALUES (NULL, %s, %s, %s, NULL, %s, NULL)",
                                        $ilDB->quote($active_id),
                                        $ilDB->quote($this->getId()),
                                        $ilDB->quote(trim($numeric_result)),
                                        $ilDB->quote($actualpass . "")
                                );
                                $result = $ilDB->query($query);
                                $entered_values++;
                        }
                }
                if ($entered_values)
                {
                        include_once ("./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 ("./classes/class.ilObjAssessmentFolder.php");
                        if (ilObjAssessmentFolder::_enabledAssessmentLogging())
                        {
                                $this->logAction($this->lng->txtlng("assessment", "log_user_not_entered_values", ilObjAssessmentFolder::_getLogLanguage()), $active_id, $this->getId());
                        }
                }
    parent::saveWorkingData($active_id, $pass);
                return true;
        }

Here is the call graph for this function:

assNumeric::setMaxChars ( maxchars  ) 

Sets the maximum number of characters for the numeric input field.

Sets the maximum number of characters for the numeric input field

Parameters:
integer $maxchars The maximum number of characters public

Definition at line 1066 of file class.assNumeric.php.

References $maxchars.

Referenced by fromXML().

        {
                $this->maxchars = $maxchars;
        }

Here is the caller graph for this function:

assNumeric::setQuestion ( question = ""  ) 

Sets the numeric question.

Sets the question string of the assNumeric object

Parameters:
string $question A string containing the numeric question public
See also:
$question

Definition at line 575 of file class.assNumeric.php.

References $question.

Referenced by fromXML().

        {
                $this->question = $question;
        }

Here is the caller graph for this function:

assNumeric::syncWithOriginal (  ) 

Reimplemented from assQuestion.

Definition at line 972 of file class.assNumeric.php.

References $key, $query, $result, assQuestion::getEstimatedWorkingTime(), getMaximumPoints(), and isComplete().

        {
                global $ilDB;
                
                if ($this->original_id)
                {
                        $complete = 0;
                        if ($this->isComplete())
                        {
                                $complete = 1;
                        }
        
                        $estw_time = $this->getEstimatedWorkingTime();
                        $estw_time = sprintf("%02d:%02d:%02d", $estw_time['h'], $estw_time['m'], $estw_time['s']);
        
                        $query = sprintf("UPDATE qpl_questions SET obj_fi = %s, title = %s, comment = %s, author = %s, question_text = %s, points = %s, working_time=%s, complete = %s WHERE question_id = %s",
                                $ilDB->quote($this->obj_id. ""),
                                $ilDB->quote($this->title. ""),
                                $ilDB->quote($this->comment. ""),
                                $ilDB->quote($this->author. ""),
                                $ilDB->quote($this->question. ""),
                                $ilDB->quote($this->getMaximumPoints() . ""),
                                $ilDB->quote($estw_time. ""),
                                $ilDB->quote($complete. ""),
                                $ilDB->quote($this->original_id. "")
                        );
                        $result = $ilDB->query($query);
                        $query = sprintf("UPDATE qpl_question_numeric SET maxNumOfChars = %s WHERE question_fi = %s",
                                $ilDB->quote($this->getMaxChars() . ""),
                                $ilDB->quote($this->original_id . "")
                        );
                        $result = $ilDB->query($query);

                        if ($result == DB_OK)
                        {
                                // Write Ranges to the database
                                
                                // 1. delete old ranges
                                $query = sprintf("DELETE FROM qpl_numeric_range WHERE question_fi = %s",
                                        $ilDB->quote($this->original_id)
                                );
                                $result = $ilDB->query($query);
        
                                // 2. write ranges
                                foreach ($this->ranges as $key => $range)
                                {
                                        $query = sprintf("INSERT INTO qpl_numeric_range (range_id, question_fi, lowerlimit, upperlimit, points, aorder, lastchange) VALUES (NULL, %s, %s, %s, %s, %s, NULL)",
                                        $ilDB->quote($this->original_id),
                                        $ilDB->quote($range->getLowerLimit()),
                                        $ilDB->quote($range->getUpperLimit() . ""),
                                        $ilDB->quote($range->getPoints() . ""),
                                        $ilDB->quote($range->getOrder() . "")
                                        );
                                        $answer_result = $ilDB->query($query);
                                }
                        }
                        parent::syncWithOriginal();
                }
        }

Here is the call graph for this function:

assNumeric::to_xml ( a_include_header = true,
a_include_binary = true,
a_shuffle = false,
test_output = false,
force_image_references = false 
)

Returns a QTI xml representation of the question.

Returns a QTI xml representation of the question and sets the internal domxml variable with the DOM XML representation of the QTI xml representation

Returns:
string The QTI xml representation of the question public

Definition at line 246 of file class.assNumeric.php.

References $pos, assQuestion::addQTIMaterial(), assQuestion::getAuthor(), assQuestion::getComment(), assQuestion::getEstimatedWorkingTime(), getMaxChars(), getQuestion(), assQuestion::getSuggestedSolution(), and assQuestion::getTitle().

        {
                include_once("./classes/class.ilXmlWriter.php");
                $a_xml_writer = new ilXmlWriter;
                // set xml header
                $a_xml_writer->xmlHeader();
                $a_xml_writer->xmlStartTag("questestinterop");
                $attrs = array(
                        "ident" => "il_".IL_INST_ID."_qst_".$this->getId(),
                        "title" => $this->getTitle()
                );
                $a_xml_writer->xmlStartTag("item", $attrs);
                // add question description
                $a_xml_writer->xmlElement("qticomment", NULL, $this->getComment());
                // add estimated working time
                $workingtime = $this->getEstimatedWorkingTime();
                $duration = sprintf("P0Y0M0DT%dH%dM%dS", $workingtime["h"], $workingtime["m"], $workingtime["s"]);
                $a_xml_writer->xmlElement("duration", NULL, $duration);
                // add ILIAS specific metadata
                $a_xml_writer->xmlStartTag("itemmetadata");
                $a_xml_writer->xmlStartTag("qtimetadata");
                $a_xml_writer->xmlStartTag("qtimetadatafield");
                $a_xml_writer->xmlElement("fieldlabel", NULL, "ILIAS_VERSION");
                $a_xml_writer->xmlElement("fieldentry", NULL, $this->ilias->getSetting("ilias_version"));
                $a_xml_writer->xmlEndTag("qtimetadatafield");
                $a_xml_writer->xmlStartTag("qtimetadatafield");
                $a_xml_writer->xmlElement("fieldlabel", NULL, "QUESTIONTYPE");
                $a_xml_writer->xmlElement("fieldentry", NULL, NUMERIC_QUESTION_IDENTIFIER);
                $a_xml_writer->xmlEndTag("qtimetadatafield");
                $a_xml_writer->xmlStartTag("qtimetadatafield");
                $a_xml_writer->xmlElement("fieldlabel", NULL, "AUTHOR");
                $a_xml_writer->xmlElement("fieldentry", NULL, $this->getAuthor());
                $a_xml_writer->xmlEndTag("qtimetadatafield");
                $a_xml_writer->xmlEndTag("qtimetadata");
                $a_xml_writer->xmlEndTag("itemmetadata");

                // PART I: qti presentation
                $attrs = array(
                        "label" => $this->getTitle()
                );
                $a_xml_writer->xmlStartTag("presentation", $attrs);
                // add flow to presentation
                $a_xml_writer->xmlStartTag("flow");
                // add material with question text to presentation
                $this->addQTIMaterial($a_xml_writer, $this->getQuestion());
                // add answers to presentation
                $attrs = array(
                        "ident" => "NUM",
                        "rcardinality" => "Single",
                        "numtype" => "Decimal"
                );
                $a_xml_writer->xmlStartTag("response_num", $attrs);
                $solution = $this->getSuggestedSolution(0);
                if (count($solution))
                {
                        if (preg_match("/il_(\d*?)_(\w+)_(\d+)/", $solution["internal_link"], $matches))
                        {
                                $a_xml_writer->xmlStartTag("material");
                                $intlink = "il_" . IL_INST_ID . "_" . $matches[2] . "_" . $matches[3];
                                if (strcmp($matches[1], "") != 0)
                                {
                                        $intlink = $solution["internal_link"];
                                }
                                $attrs = array(
                                        "label" => "suggested_solution"
                                );
                                $a_xml_writer->xmlElement("mattext", $attrs, $intlink);
                                $a_xml_writer->xmlEndTag("material");
                        }
                }
                // shuffle output
                $attrs = array(
                        "fibtype" => "Decimal",
                        "maxchars" => $this->getMaxChars()
                );
                $a_xml_writer->xmlStartTag("render_fib", $attrs);
                $a_xml_writer->xmlEndTag("render_fib");
                $a_xml_writer->xmlEndTag("response_num");
                $a_xml_writer->xmlEndTag("flow");
                $a_xml_writer->xmlEndTag("presentation");
                
                // PART II: qti resprocessing
                $a_xml_writer->xmlStartTag("resprocessing");
                $a_xml_writer->xmlStartTag("outcomes");
                $a_xml_writer->xmlStartTag("decvar");
                $a_xml_writer->xmlEndTag("decvar");
                $a_xml_writer->xmlEndTag("outcomes");
                // add response conditions
                foreach ($this->ranges as $index => $range)
                {
                        $a_xml_writer->xmlStartTag("respcondition");
                        // qti conditionvar
                        $a_xml_writer->xmlStartTag("conditionvar");
                        $attrs = array(
                                "respident" => "NUM"
                        );
                        $a_xml_writer->xmlElement("vargte", $attrs, $range->getLowerLimit());
                        $a_xml_writer->xmlElement("varlte", $attrs, $range->getUpperLimit());
                        $a_xml_writer->xmlEndTag("conditionvar");
                        // qti setvar
                        $attrs = array(
                                "action" => "Add"
                        );
                        $a_xml_writer->xmlElement("setvar", $attrs, $range->getPoints());
                        // qti displayfeedback
                        $attrs = array(
                                "feedbacktype" => "Response",
                                "linkrefid" => "Correct"
                        );
                        $a_xml_writer->xmlElement("displayfeedback", $attrs);
                        $a_xml_writer->xmlEndTag("respcondition");
                }
                $a_xml_writer->xmlEndTag("resprocessing");

                // PART III: qti itemfeedback
                foreach ($this->ranges as $index => $range)
                {
                        $attrs = array(
                                "ident" => "Correct",
                                "view" => "All"
                        );
                        $a_xml_writer->xmlStartTag("itemfeedback", $attrs);
                        // qti flow_mat
                        $a_xml_writer->xmlStartTag("flow_mat");
                        $a_xml_writer->xmlStartTag("material");
                        $a_xml_writer->xmlElement("mattext");
                        $a_xml_writer->xmlEndTag("material");
                        $a_xml_writer->xmlEndTag("flow_mat");
                        $a_xml_writer->xmlEndTag("itemfeedback");
                }
                
                $a_xml_writer->xmlEndTag("item");
                $a_xml_writer->xmlEndTag("questestinterop");

                $xml = $a_xml_writer->xmlDumpMem(FALSE);
                if (!$a_include_header)
                {
                        $pos = strpos($xml, "?>");
                        $xml = substr($xml, $pos + 2);
                }
                return $xml;
        }

Here is the call graph for this function:


Field Documentation

assNumeric::$maxchars

Definition at line 65 of file class.assNumeric.php.

Referenced by fromXML(), and setMaxChars().

assNumeric::$question

Definition at line 47 of file class.assNumeric.php.

Referenced by assNumeric(), and setQuestion().

assNumeric::$ranges

Definition at line 56 of file class.assNumeric.php.


The documentation for this class was generated from the following file: