Class for ordering questions. More...
Inheritance diagram for ASS_OrderingQuestion:
Collaboration diagram for ASS_OrderingQuestion:
Public Member Functions | |
| ASS_OrderingQuestion ($title="", $comment="", $author="", $owner=-1, $question="", $points=0.0, $ordering_type=OQ_TERMS) | |
| ASS_OrderingQuestion constructor. | |
| isComplete () | |
| Returns true, if a ordering question is complete for use. | |
| from_xml ($xml_text) | |
| Imports a question from XML. | |
| to_xml ($a_include_header=true, $a_include_binary=true, $a_shuffle=false, $test_output=false) | |
| Returns a QTI xml representation of the question. | |
| saveToDb ($original_id="") | |
| Saves a ASS_OrderingQuestion object to a database. | |
| loadFromDb ($question_id) | |
| Loads a ASS_OrderingQuestion object from a database. | |
| duplicate ($for_test=true, $title="", $author="", $owner="") | |
| Duplicates an ASS_OrderingQuestion. | |
| duplicateImages ($question_id) | |
| set_question ($question="") | |
| Sets the ordering question text. | |
| set_ordering_type ($ordering_type=OQ_TERMS) | |
| Sets the ordering question type. | |
| get_question () | |
| Returns the question text. | |
| get_ordering_type () | |
| Returns the ordering question type. | |
| add_answer ($answertext="", $points=0.0, $order=0, $solution_order=0) | |
| Adds an answer for an ordering question. | |
| get_answer ($index=0) | |
| Returns an ordering answer. | |
| delete_answer ($index=0) | |
| Deletes an answer. | |
| flush_answers () | |
| Deletes all answers. | |
| get_answer_count () | |
| Returns the number of answers. | |
| get_points () | |
| Gets the points. | |
| set_points ($points=0.0) | |
| Sets the points. | |
| get_max_solution_order () | |
| Returns the maximum solution order. | |
| getReachedPoints ($user_id, $test_id) | |
| Returns the points, a learner has reached answering the question. | |
| getReachedInformation ($user_id, $test_id) | |
| Returns the evaluation data, a learner has entered to answer the question. | |
| getMaximumPoints () | |
| Returns the maximum points, a learner can reach answering the question. | |
| set_image_file ($image_filename, $image_tempfilename="") | |
| Sets the image file. | |
| checkSaveData () | |
| Checks the data to be saved for consistency. | |
| saveWorkingData ($test_id, $limit_to=LIMIT_NO_LIMIT) | |
| Saves the learners input of the question to the database. | |
| syncWithOriginal () | |
| pc_array_shuffle ($array) | |
| createRandomSolution ($test_id, $user_id) | |
| getQuestionType () | |
| Returns the question type of the question. | |
Data Fields | |
| $question | |
| $answers | |
| $ordering_type | |
| $points | |
Detailed Description
Class for ordering questions.
ASS_OrderingQuestion is a class for ordering questions.
- Version:
- Id:
- class.assOrderingQuestion.php 8266 2005-08-04 07:10:58Z hschottm
class.assOrderingQuestion.php Assessment
Definition at line 42 of file class.assOrderingQuestion.php.
Member Function Documentation
| ASS_OrderingQuestion::add_answer | ( | $ | answertext = "", |
|
| $ | points = 0.0, |
|||
| $ | order = 0, |
|||
| $ | solution_order = 0 | |||
| ) |
Adds an answer for an ordering question.
Adds an answer for an ordering choice question. The students have to fill in an order for the answer. The answer is an ASS_AnswerOrdering object that will be created and assigned to the array $this->answers.
- Parameters:
-
string $answertext The answer text double $points The points for selecting the answer (even negative points can be used) integer $order A possible display order of the answer integer $solution_order An unique integer value representing the correct order of that answer in the solution of a question public
- See also:
- $answers
- ASS_AnswerOrdering
Definition at line 928 of file class.assOrderingQuestion.php.
References $points.
Referenced by from_xml().
{
$found = -1;
foreach ($this->answers as $key => $value)
{
if ($value->get_order() == $order)
{
$found = $order;
}
}
if ($found >= 0)
{
// Antwort einf�gen
$answer = new ASS_AnswerOrdering($answertext, $points, $found, $solution_order);
array_push($this->answers, $answer);
for ($i = $found + 1; $i < count($this->answers); $i++)
{
$this->answers[$i] = $this->answers[$i-1];
}
$this->answers[$found] = $answer;
}
else
{
// Anwort anh�ngen
$answer = new ASS_AnswerOrdering($answertext, $points,
count($this->answers), $solution_order);
array_push($this->answers, $answer);
}
}
Here is the caller graph for this function:
| ASS_OrderingQuestion::ASS_OrderingQuestion | ( | $ | title = "", |
|
| $ | comment = "", |
|||
| $ | author = "", |
|||
| $ | owner = -1, |
|||
| $ | question = "", |
|||
| $ | points = 0.0, |
|||
| $ | ordering_type = OQ_TERMS | |||
| ) |
ASS_OrderingQuestion constructor.
The constructor takes possible arguments an creates an instance of the ASS_OrderingQuestion 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 ordering test points double The points for solving the ordering question public
Definition at line 96 of file class.assOrderingQuestion.php.
References ASS_Question::$author, ASS_Question::$comment, $ordering_type, ASS_Question::$owner, $points, $question, ASS_Question::$title, and ASS_Question::ASS_Question().
{
$this->ASS_Question($title, $comment, $author, $owner);
$this->answers = array();
$this->question = $question;
$this->points = $points;
$this->ordering_type = $ordering_type;
}
Here is the call graph for this function:
| ASS_OrderingQuestion::checkSaveData | ( | ) |
Checks the data to be saved for consistency.
Checks the data to be saved for consistency
- Returns:
- boolean True, if the check was ok, False otherwise public
- See also:
- $answers
Definition at line 1254 of file class.assOrderingQuestion.php.
References $_POST, $result, and sendInfo().
Referenced by saveWorkingData().
{
$result = true;
$order_values = array();
foreach ($_POST as $key => $value)
{
if (preg_match("/^order_(\d+)/", $key, $matches))
{
if (strcmp($value, "") != 0)
{
array_push($order_values, $value);
}
}
}
$check_order = array_flip($order_values);
if (count($check_order) != count($order_values))
{
// duplicate order values!!!
$result = false;
sendInfo($this->lng->txt("duplicate_order_values_entered"));
}
return $result;
}
Here is the call graph for this function:
Here is the caller graph for this function:
| ASS_OrderingQuestion::createRandomSolution | ( | $ | test_id, | |
| $ | user_id | |||
| ) |
Reimplemented from ASS_Question.
Definition at line 1399 of file class.assOrderingQuestion.php.
References $ilUser, $query, $result, ASS_Question::$test_id, $user_id, ASS_Question::getId(), and pc_array_shuffle().
{
global $ilDB;
global $ilUser;
$db =& $ilDB->db;
$query = sprintf("DELETE FROM tst_solutions WHERE user_fi = %s AND test_fi = %s AND question_fi = %s",
$db->quote($user_id),
$db->quote($test_id),
$db->quote($this->getId())
);
$result = $db->query($query);
$orders = range(1, count($this->answers));
$orders = $this->pc_array_shuffle($orders);
foreach ($this->answers as $key => $value)
{
$query = sprintf("INSERT INTO tst_solutions (solution_id, user_fi, test_fi, question_fi, value1, value2, TIMESTAMP) VALUES (NULL, %s, %s, %s, %s, %s, NULL)",
$db->quote($user_id),
$db->quote($test_id),
$db->quote($this->getId()),
$db->quote($key),
$db->quote(array_pop($orders))
);
$result = $db->query($query);
}
}
Here is the call graph for this function:
| ASS_OrderingQuestion::delete_answer | ( | $ | index = 0 |
) |
Deletes an answer.
Deletes an answer with a given index. The index of the first answer is 0, the index of the second answer is 1 and so on.
- Parameters:
-
integer $index A nonnegative index of the n-th answer public
- See also:
- $answers
Definition at line 992 of file class.assOrderingQuestion.php.
{
if ($index < 0)
{
return;
}
if (count($this->answers) < 1)
{
return;
}
if ($index >= count($this->answers))
{
return;
}
unset($this->answers[$index]);
$this->answers = array_values($this->answers);
for ($i = 0; $i < count($this->answers); $i++)
{
if ($this->answers[$i]->get_order() > $index)
{
$this->answers[$i]->set_order($i);
}
}
}
| ASS_OrderingQuestion::duplicate | ( | $ | for_test = true, |
|
| $ | title = "", |
|||
| $ | author = "", |
|||
| $ | owner = "" | |||
| ) |
Duplicates an ASS_OrderingQuestion.
Duplicates an ASS_OrderingQuestion
public
Definition at line 794 of file class.assOrderingQuestion.php.
References ASS_Question::$author, ASS_Question::$owner, ASS_Question::$title, and ASS_Question::_getOriginalId().
{
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 = ASS_Question::_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($original_id);
// duplicate the image
$clone->duplicateImages($original_id);
return $clone->id;
}
Here is the call graph for this function:
| ASS_OrderingQuestion::duplicateImages | ( | $ | question_id | ) |
Definition at line 835 of file class.assOrderingQuestion.php.
References get_ordering_type(), ASS_Question::getImagePath(), and ilUtil::makeDirParents().
{
if ($this->get_ordering_type() == OQ_PICTURES)
{
$imagepath = $this->getImagePath();
$imagepath_original = str_replace("/$this->id/images", "/$question_id/images", $imagepath);
if (!file_exists($imagepath)) {
ilUtil::makeDirParents($imagepath);
}
foreach ($this->answers as $answer)
{
$filename = $answer->get_answertext();
if (!copy($imagepath_original . $filename, $imagepath . $filename)) {
print "image could not be duplicated!!!! ";
}
if (!copy($imagepath_original . $filename . ".thumb.jpg", $imagepath . $filename . ".thumb.jpg")) {
print "image thumbnail could not be duplicated!!!! ";
}
}
}
}
Here is the call graph for this function:
| ASS_OrderingQuestion::flush_answers | ( | ) |
Deletes all answers.
Deletes all answers
public
- See also:
- $answers
Definition at line 1025 of file class.assOrderingQuestion.php.
{
$this->answers = array();
}
| ASS_OrderingQuestion::from_xml | ( | $ | xml_text | ) |
Imports a question from XML.
Sets the attributes of the question from the XML text passed as argument
- Returns:
- boolean True, if the import succeeds, false otherwise public
Definition at line 142 of file class.assOrderingQuestion.php.
References ASS_Question::$comment, $ilErr, $image, $result, ASS_Question::$shuffle, ilQTIUtils::_getRespcondition(), add_answer(), ilUtil::convertImage(), domxml_open_mem(), get_ordering_type(), ASS_Question::getId(), ASS_Question::getImagePath(), ilUtil::makeDirParents(), saveToDb(), set_ordering_type(), set_question(), ASS_Question::setAuthor(), ASS_Question::setComment(), ASS_Question::setEstimatedWorkingTime(), ASS_Question::setShuffle(), ASS_Question::setSuggestedSolution(), and ASS_Question::setTitle().
{
$result = false;
if (!empty($this->domxml))
{
$this->domxml->free();
}
$xml_text = preg_replace("/>\s*?</", "><", $xml_text);
$this->domxml = domxml_open_mem($xml_text);
if (!empty($this->domxml))
{
$root = $this->domxml->document_element();
$item = $root->first_child();
$this->setTitle($item->get_attribute("title"));
$this->gaps = array();
$itemnodes = $item->child_nodes();
$materials = array();
$images = array();
$shuffle = "";
foreach ($itemnodes as $index => $node)
{
switch ($node->node_name())
{
case "qticomment":
$comment = $node->get_content();
if (strpos($comment, "ILIAS Version=") !== false)
{
}
elseif (strpos($comment, "Questiontype=") !== false)
{
}
elseif (strpos($comment, "Author=") !== false)
{
$comment = str_replace("Author=", "", $comment);
$this->setAuthor($comment);
}
else
{
$this->setComment($comment);
}
break;
case "itemmetadata":
$md_array = array();
$metanodes = $node->child_nodes();
foreach ($metanodes as $metanode)
{
switch ($metanode->node_name())
{
case "qtimetadata":
$metafields = $metanode->child_nodes();
foreach ($metafields as $metafield)
{
switch ($metafield->node_name())
{
case "qtimetadatafield":
$metafieldlist = $metafield->child_nodes();
$md = array("label" => "", "entry" => "");
foreach ($metafieldlist as $attr)
{
switch ($attr->node_name())
{
case "fieldlabel":
$md["label"] = $attr->get_content();
break;
case "fieldentry":
$md["entry"] = $attr->get_content();
break;
}
}
array_push($md_array, $md);
break;
}
}
break;
}
}
foreach ($md_array as $md)
{
switch ($md["label"])
{
case "ILIAS_VERSION":
break;
case "QUESTIONTYPE":
break;
case "AUTHOR":
$this->setAuthor($md["entry"]);
break;
}
}
break;
case "duration":
$iso8601period = $node->get_content();
if (preg_match("/P(\d+)Y(\d+)M(\d+)DT(\d+)H(\d+)M(\d+)S/", $iso8601period, $matches))
{
$this->setEstimatedWorkingTime($matches[4], $matches[5], $matches[6]);
}
break;
case "presentation":
$flow = $node->first_child();
$flownodes = $flow->child_nodes();
foreach ($flownodes as $idx => $flownode)
{
if (strcmp($flownode->node_name(), "material") == 0)
{
$mattext = $flownode->first_child();
$this->set_question($mattext->get_content());
}
elseif (strcmp($flownode->node_name(), "response_lid") == 0)
{
$ident = $flownode->get_attribute("ident");
if (strcmp($ident, "OQT") == 0)
{
$this->set_ordering_type(OQ_TERMS);
}
elseif (strcmp($ident, "OQP") == 0)
{
$this->set_ordering_type(OQ_PICTURES);
}
$subnodes = $flownode->child_nodes();
foreach ($subnodes as $node_type)
{
switch ($node_type->node_name())
{
case "material":
$matlabel = $node_type->get_attribute("label");
if (strcmp($matlabel, "suggested_solution") == 0)
{
$mattype = $node_type->first_child();
if (strcmp($mattype->node_name(), "mattext") == 0)
{
$suggested_solution = $mattype->get_content();
if ($suggested_solution)
{
if ($this->getId() < 1)
{
$this->saveToDb();
}
$this->setSuggestedSolution($suggested_solution, 0, true);
}
}
}
break;
case "render_choice":
$render_choice = $node_type;
$shuffle = $render_choice->get_attribute("shuffle");
$shuf = 0;
if (strcmp(strtolower($shuffle), "yes") == 0)
{
$shuf = 1;
}
$this->setShuffle($shuf);
$labels = $render_choice->child_nodes();
foreach ($labels as $lidx => $response_label)
{
$material = $response_label->first_child();
if ($this->get_ordering_type() == OQ_PICTURES)
{
$matimage = $material->first_child();
$filename = $matimage->get_attribute("label");
$image = base64_decode($matimage->get_content());
$images["$filename"] = $image;
$materials[$response_label->get_attribute("ident")] = $filename;
}
else
{
$mattext = $material->first_child();
$materials[$response_label->get_attribute("ident")] = $mattext->get_content();
}
}
}
}
}
}
break;
case "resprocessing":
$resproc_nodes = $node->child_nodes();
foreach ($resproc_nodes as $index => $respcondition)
{
if (strcmp($respcondition->node_name(), "respcondition") == 0)
{
$respcondition_array =& ilQTIUtils::_getRespcondition($respcondition);
$this->add_answer($materials[$respcondition_array["conditionvar"]["value"]], $respcondition_array["setvar"]["points"], count($this->answers), $respcondition_array["conditionvar"]["index"]);
}
}
break;
}
}
if (count($images))
{
$this->saveToDb();
foreach ($images as $filename => $image)
{
if ($filename)
{
$imagepath = $this->getImagePath();
if (!file_exists($imagepath))
{
ilUtil::makeDirParents($imagepath);
}
$imagepath .= $filename;
$fh = fopen($imagepath, "wb");
if ($fh == false)
{
global $ilErr;
$ilErr->raiseError($this->lng->txt("error_save_image_file") . ": $php_errormsg", $ilErr->MESSAGE);
return;
}
$imagefile = fwrite($fh, $image);
fclose($fh);
// create thumbnail file
$thumbpath = $imagepath . "." . "thumb.jpg";
ilUtil::convertImage($imagepath, $thumbpath, "JPEG", 100);
}
}
}
$result = true;
}
return $result;
}
Here is the call graph for this function:
| ASS_OrderingQuestion::get_answer | ( | $ | index = 0 |
) |
Returns an ordering answer.
Returns an ordering answer with a given index. The index of the first answer is 0, the index of the second answer is 1 and so on.
- Parameters:
-
integer $index A nonnegative index of the n-th answer
- Returns:
- object ASS_AnswerOrdering-Object public
- See also:
- $answers
Definition at line 974 of file class.assOrderingQuestion.php.
{
if ($index < 0) return NULL;
if (count($this->answers) < 1) return NULL;
if ($index >= count($this->answers)) return NULL;
return $this->answers[$index];
}
| ASS_OrderingQuestion::get_answer_count | ( | ) |
Returns the number of answers.
Returns the number of answers
- Returns:
- integer The number of answers of the ordering question public
- See also:
- $answers
Definition at line 1039 of file class.assOrderingQuestion.php.
{
return count($this->answers);
}
| ASS_OrderingQuestion::get_max_solution_order | ( | ) |
Returns the maximum solution order.
Returns the maximum solution order of all ordering answers
- Returns:
- integer The maximum solution order of all ordering answers public
- See also:
- $points
Definition at line 1081 of file class.assOrderingQuestion.php.
{
if (count($this->answers) == 0)
{
$max = 0;
}
else
{
$max = $this->answers[0]->get_solution_order();
}
foreach ($this->answers as $key => $value)
{
if ($value->get_solution_order() > $max)
{
$max = $value->get_solution_order();
}
}
return $max;
}
| ASS_OrderingQuestion::get_ordering_type | ( | ) |
Returns the ordering question type.
Returns the ordering question type
- Returns:
- integer The ordering question type public
- See also:
- $ordering_type
Definition at line 908 of file class.assOrderingQuestion.php.
Referenced by duplicateImages(), from_xml(), and to_xml().
{
return $this->ordering_type;
}
Here is the caller graph for this function:
| ASS_OrderingQuestion::get_points | ( | ) |
Gets the points.
Gets the points for entering the correct order of the ASS_OrderingQuestion object
- Returns:
- double The points for entering the correct order of the ordering question public
- See also:
- $points
Definition at line 1053 of file class.assOrderingQuestion.php.
{
return $this->points;
}
| ASS_OrderingQuestion::get_question | ( | ) |
Returns the question text.
Returns the question text
- Returns:
- string The question text string public
- See also:
- $question
Definition at line 894 of file class.assOrderingQuestion.php.
Referenced by to_xml().
{
return $this->question;
}
Here is the caller graph for this function:
| ASS_OrderingQuestion::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 ASS_Question.
Definition at line 1190 of file class.assOrderingQuestion.php.
References $points.
| ASS_OrderingQuestion::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 1436 of file class.assOrderingQuestion.php.
Referenced by saveToDb().
{
return 5;
}
Here is the caller graph for this function:
| ASS_OrderingQuestion::getReachedInformation | ( | $ | user_id, | |
| $ | test_id | |||
| ) |
Returns the evaluation data, a learner has entered to answer the question.
Returns the evaluation data, a learner has entered to answer the question
- 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 1160 of file class.assOrderingQuestion.php.
References $data, $query, $result, ASS_Question::$test_id, $user_id, and ASS_Question::getId().
{
$found_value1 = array();
$found_value2 = array();
$query = sprintf("SELECT * FROM tst_solutions WHERE user_fi = %s AND test_fi = %s AND question_fi = %s",
$this->ilias->db->quote($user_id),
$this->ilias->db->quote($test_id),
$this->ilias->db->quote($this->getId())
);
$result = $this->ilias->db->query($query);
$user_result = array();
while ($data = $result->fetchRow(DB_FETCHMODE_OBJECT))
{
$solution = array(
"answer_id" => $data->value1,
"order" => $data->value2
);
$user_result[$data->value1] = $solution;
}
return $user_result;
}
Here is the call graph for this function:
| ASS_OrderingQuestion::getReachedPoints | ( | $ | user_id, | |
| $ | test_id | |||
| ) |
Returns the points, a learner has reached answering the question.
Returns the points, a learner has reached answering the question
- Parameters:
-
integer $user_id The database ID of the learner integer $test_id The database Id of the test containing the question public
Reimplemented from ASS_Question.
Definition at line 1110 of file class.assOrderingQuestion.php.
References $data, $points, $query, $result, ASS_Question::$test_id, $user_id, and ASS_Question::getId().
{
$found_value1 = array();
$found_value2 = array();
$query = sprintf("SELECT * FROM tst_solutions WHERE user_fi = %s AND test_fi = %s AND question_fi = %s",
$this->ilias->db->quote($user_id),
$this->ilias->db->quote($test_id),
$this->ilias->db->quote($this->getId())
);
$result = $this->ilias->db->query($query);
$user_order = array();
while ($data = $result->fetchRow(DB_FETCHMODE_OBJECT))
{
if ((strcmp($data->value1, "") != 0) && (strcmp($data->value2, "") != 0))
{
$user_order[$data->value2] = $data->value1;
}
}
ksort($user_order);
$user_order = array_values($user_order);
$answer_order = array();
foreach ($this->answers as $key => $answer)
{
$answer_order[$answer->get_solution_order()] = $key;
}
ksort($answer_order);
$answer_order = array_values($answer_order);
$points = 0;
foreach ($answer_order as $index => $answer_id)
{
if (strcmp($user_order[$index], "") != 0)
{
if ($answer_id == $user_order[$index])
{
$points += $this->answers[$answer_id]->get_points();
}
}
}
return $points;
}
Here is the call graph for this function:
| ASS_OrderingQuestion::isComplete | ( | ) |
Returns true, if a ordering question is complete for use.
Returns true, if a ordering question is complete for use
- Returns:
- boolean True, if the ordering question is complete for use, otherwise false public
Reimplemented from ASS_Question.
Definition at line 121 of file class.assOrderingQuestion.php.
Referenced by saveToDb(), and syncWithOriginal().
{
if (($this->title) and ($this->author) and ($this->question) and (count($this->answers)))
{
return true;
}
else
{
return false;
}
}
Here is the caller graph for this function:
| ASS_OrderingQuestion::loadFromDb | ( | $ | question_id | ) |
Loads a ASS_OrderingQuestion object from a database.
Loads a ASS_OrderingQuestion 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 ASS_Question.
Definition at line 744 of file class.assOrderingQuestion.php.
References $data, ASS_Question::$ilias, $query, $result, and ASS_Question::setEstimatedWorkingTime().
{
global $ilias;
$db =& $ilias->db;
$query = sprintf("SELECT * FROM qpl_questions WHERE question_id = %s",
$db->quote($question_id)
);
$result = $db->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->obj_id = $data->obj_fi;
$this->comment = $data->comment;
$this->original_id = $data->original_id;
$this->author = $data->author;
$this->owner = $data->owner;
$this->question = $data->question_text;
$this->solution_hint = $data->solution_hint;
$this->ordering_type = $data->ordering_type;
$this->points = $data->points;
$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_answers WHERE question_fi = %s ORDER BY aorder ASC",
$db->quote($question_id)
);
$result = $db->query($query);
if (strcmp(strtolower(get_class($result)), db_result) == 0)
{
while ($data = $result->fetchRow(DB_FETCHMODE_OBJECT))
{
array_push($this->answers, new ASS_AnswerOrdering($data->answertext, $data->points, $data->aorder, $data->solution_order));
}
}
}
parent::loadFromDb($question_id);
}
Here is the call graph for this function:
| ASS_OrderingQuestion::pc_array_shuffle | ( | $ | array | ) |
Definition at line 1382 of file class.assOrderingQuestion.php.
Referenced by createRandomSolution().
{
mt_srand((double)microtime()*1000000);
$i = count($array);
while(--$i)
{
$j = mt_rand(0, $i);
if ($i != $j)
{
// swap elements
$tmp = $array[$j];
$array[$j] = $array[$i];
$array[$i] = $tmp;
}
}
return $array;
}
Here is the caller graph for this function:
| ASS_OrderingQuestion::saveToDb | ( | $ | original_id = "" |
) |
Saves a ASS_OrderingQuestion object to a database.
Saves a ASS_OrderingQuestion object to a database (experimental)
- Parameters:
-
object $db A pear DB object public
Reimplemented from ASS_Question.
Definition at line 633 of file class.assOrderingQuestion.php.
References ASS_Question::$ilias, $query, $result, ASS_Question::createPageObject(), ASS_Question::getEstimatedWorkingTime(), getQuestionType(), ASS_Question::getTestId(), ASS_Question::insertIntoTest(), and isComplete().
Referenced by from_xml().
{
global $ilias;
$db =& $ilias->db;
$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 = $db->quote($original_id);
}
else
{
$original_id = "NULL";
}
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, working_time, ordering_type, points, complete, created, original_id, TIMESTAMP) VALUES (NULL, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, NULL)",
$db->quote($question_type . ""),
$db->quote($this->obj_id . ""),
$db->quote($this->title . ""),
$db->quote($this->comment . ""),
$db->quote($this->author . ""),
$db->quote($this->owner . ""),
$db->quote($this->question . ""),
$db->quote($estw_time . ""),
$db->quote($this->ordering_type . ""),
$db->quote($this->points . ""),
$db->quote($complete . ""),
$db->quote($created . ""),
$original_id
);
$result = $db->query($query);
if ($result == DB_OK)
{
$this->id = $this->ilias->db->getLastInsertId();
// create page object of question
$this->createPageObject();
// Falls die Frage in einen Test eingef�gt werden soll, auch diese Verbindung erstellen
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, working_time = %s, ordering_type = %s, points = %s, complete = %s WHERE question_id = %s",
$db->quote($this->obj_id. ""),
$db->quote($this->title . ""),
$db->quote($this->comment . ""),
$db->quote($this->author . ""),
$db->quote($this->question . ""),
$db->quote($estw_time . ""),
$db->quote($this->ordering_type . ""),
$db->quote($this->points . ""),
$db->quote($complete . ""),
$db->quote($this->id . "")
);
$result = $db->query($query);
}
if ($result == DB_OK)
{
// Antworten schreiben
// alte Antworten l�schen
$query = sprintf("DELETE FROM qpl_answers WHERE question_fi = %s",
$db->quote($this->id)
);
$result = $db->query($query);
// Anworten wegschreiben
foreach ($this->answers as $key => $value)
{
$answer_obj = $this->answers[$key];
$query = sprintf("INSERT INTO qpl_answers (answer_id, question_fi, answertext, points, aorder, solution_order, TIMESTAMP) VALUES (NULL, %s, %s, %s, %s, %s, NULL)",
$db->quote($this->id),
$db->quote($answer_obj->get_answertext() . ""),
$db->quote($answer_obj->get_points() . ""),
$db->quote($answer_obj->get_order() . ""),
$db->quote($answer_obj->get_solution_order() . "")
);
$answer_result = $db->query($query);
}
}
parent::saveToDb($original_id);
}
Here is the call graph for this function:
Here is the caller graph for this function:
| ASS_OrderingQuestion::saveWorkingData | ( | $ | test_id, | |
| $ | limit_to = LIMIT_NO_LIMIT | |||
| ) |
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:
- $answers
Definition at line 1288 of file class.assOrderingQuestion.php.
References $_POST, $ilUser, $query, $result, ASS_Question::$test_id, checkSaveData(), and ASS_Question::getId().
{
global $ilDB;
global $ilUser;
$saveWorkingDataResult = $this->checkSaveData();
if ($saveWorkingDataResult)
{
$db =& $ilDB->db;
$query = sprintf("DELETE FROM tst_solutions WHERE user_fi = %s AND test_fi = %s AND question_fi = %s",
$db->quote($ilUser->id),
$db->quote($test_id),
$db->quote($this->getId())
);
$result = $db->query($query);
foreach ($_POST as $key => $value)
{
if (preg_match("/^order_(\d+)/", $key, $matches))
{
if (!(preg_match("/initial_value_\d+/", $value)))
{
$query = sprintf("INSERT INTO tst_solutions (solution_id, user_fi, test_fi, question_fi, value1, value2, TIMESTAMP) VALUES (NULL, %s, %s, %s, %s, %s, NULL)",
$db->quote($ilUser->id),
$db->quote($test_id),
$db->quote($this->getId()),
$db->quote($matches[1]),
$db->quote($value)
);
$result = $db->query($query);
}
}
}
// parent::saveWorkingData($limit_to);
}
return $saveWorkingDataResult;
}
Here is the call graph for this function:
| ASS_OrderingQuestion::set_image_file | ( | $ | image_filename, | |
| $ | image_tempfilename = "" | |||
| ) |
Sets the image file.
Sets the image file and uploads the image to the object's image directory.
- Parameters:
-
string $image_filename Name of the original image file string $image_tempfilename Name of the temporary uploaded image file
- Returns:
- integer An errorcode if the image upload fails, 0 otherwise public
Definition at line 1210 of file class.assOrderingQuestion.php.
References $result, ilUtil::convertImage(), ASS_Question::getImagePath(), ilObjMediaObject::getMimeType(), ilUtil::makeDirParents(), and ilUtil::moveUploadedFile().
{
$result = 0;
if (!empty($image_tempfilename))
{
$image_filename = str_replace(" ", "_", $image_filename);
$imagepath = $this->getImagePath();
if (!file_exists($imagepath))
{
ilUtil::makeDirParents($imagepath);
}
if (!ilUtil::moveUploadedFile($image_tempfilename,$image_filename, $imagepath.$image_filename))
{
$result = 2;
}
else
{
require_once "./content/classes/Media/class.ilObjMediaObject.php";
$mimetype = ilObjMediaObject::getMimeType($imagepath . $image_filename);
if (!preg_match("/^image/", $mimetype))
{
unlink($imagepath . $image_filename);
$result = 1;
}
else
{
// create thumbnail file
$thumbpath = $imagepath . $image_filename . "." . "thumb.jpg";
ilUtil::convertImage($imagepath.$image_filename, $thumbpath, "JPEG", 100);
}
}
}
return $result;
}
Here is the call graph for this function:
| ASS_OrderingQuestion::set_ordering_type | ( | $ | ordering_type = OQ_TERMS |
) |
Sets the ordering question type.
Sets the ordering question type
- Parameters:
-
integer $ordering_type The question ordering type public
- See also:
- $ordering_type
Definition at line 880 of file class.assOrderingQuestion.php.
References $ordering_type.
Referenced by from_xml().
{
$this->ordering_type = $ordering_type;
}
Here is the caller graph for this function:
| ASS_OrderingQuestion::set_points | ( | $ | points = 0.0 |
) |
Sets the points.
Sets the points for entering the correct order of the ASS_OrderingQuestion object
- Parameters:
-
points double The points for entering the correct order of the ordering question public
- See also:
- $points
Definition at line 1067 of file class.assOrderingQuestion.php.
References $points.
{
$this->points = $points;
}
| ASS_OrderingQuestion::set_question | ( | $ | question = "" |
) |
Sets the ordering question text.
Sets the ordering question text
- Parameters:
-
string $question The question text public
- See also:
- $question
Definition at line 866 of file class.assOrderingQuestion.php.
References $question.
Referenced by from_xml().
{
$this->question = $question;
}
Here is the caller graph for this function:
| ASS_OrderingQuestion::syncWithOriginal | ( | ) |
Reimplemented from ASS_Question.
Definition at line 1327 of file class.assOrderingQuestion.php.
References ASS_Question::$ilias, $query, $result, ASS_Question::getEstimatedWorkingTime(), and isComplete().
{
global $ilias;
if ($this->original_id)
{
$complete = 0;
if ($this->isComplete())
{
$complete = 1;
}
$db = & $ilias->db;
$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, working_time = %s, ordering_type = %s, points = %s, complete = %s WHERE question_id = %s",
$db->quote($this->obj_id. ""),
$db->quote($this->title . ""),
$db->quote($this->comment . ""),
$db->quote($this->author . ""),
$db->quote($this->question . ""),
$db->quote($estw_time . ""),
$db->quote($this->ordering_type . ""),
$db->quote($this->points . ""),
$db->quote($complete . ""),
$db->quote($this->original_id . "")
);
$result = $db->query($query);
if ($result == DB_OK)
{
// write ansers
// delete old answers
$query = sprintf("DELETE FROM qpl_answers WHERE question_fi = %s",
$db->quote($this->original_id)
);
$result = $db->query($query);
foreach ($this->answers as $key => $value)
{
$answer_obj = $this->answers[$key];
$query = sprintf("INSERT INTO qpl_answers (answer_id, question_fi, answertext, points, aorder, solution_order, TIMESTAMP) VALUES (NULL, %s, %s, %s, %s, %s, NULL)",
$db->quote($this->original_id . ""),
$db->quote($answer_obj->get_answertext() . ""),
$db->quote($answer_obj->get_points() . ""),
$db->quote($answer_obj->get_order() . ""),
$db->quote($answer_obj->get_solution_order() . "")
);
$answer_result = $db->query($query);
}
}
parent::syncWithOriginal();
}
}
Here is the call graph for this function:
| ASS_OrderingQuestion::to_xml | ( | $ | a_include_header = true, |
|
| $ | a_include_binary = true, |
|||
| $ | a_shuffle = false, |
|||
| $ | test_output = 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 371 of file class.assOrderingQuestion.php.
References $pos, $xml, domxml_open_mem(), get_ordering_type(), get_question(), ASS_Question::getAuthor(), ASS_Question::getComment(), ASS_Question::getEstimatedWorkingTime(), ASS_Question::getImagePath(), ASS_Question::getOutputType(), ASS_Question::getShuffle(), ASS_Question::getSuggestedSolution(), ASS_Question::getTitle(), and ASS_Question::pcArrayShuffle().
{
if (!empty($this->domxml))
{
$this->domxml->free();
}
$xml_header = "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<questestinterop></questestinterop>\n";
$this->domxml = domxml_open_mem($xml_header);
$root = $this->domxml->document_element();
// qti ident
$qtiIdent = $this->domxml->create_element("item");
$qtiIdent->set_attribute("ident", "il_".IL_INST_ID."_qst_".$this->getId());
$qtiIdent->set_attribute("title", $this->getTitle());
$root->append_child($qtiIdent);
// add question description
$qtiComment = $this->domxml->create_element("qticomment");
$qtiCommentText = $this->domxml->create_text_node($this->getComment());
$qtiComment->append_child($qtiCommentText);
$qtiIdent->append_child($qtiComment);
// add estimated working time
$qtiDuration = $this->domxml->create_element("duration");
$workingtime = $this->getEstimatedWorkingTime();
$qtiDurationText = $this->domxml->create_text_node(sprintf("P0Y0M0DT%dH%dM%dS", $workingtime["h"], $workingtime["m"], $workingtime["s"]));
$qtiDuration->append_child($qtiDurationText);
$qtiIdent->append_child($qtiDuration);
// add ILIAS specific metadata
$qtiItemmetadata = $this->domxml->create_element("itemmetadata");
$qtiMetadata = $this->domxml->create_element("qtimetadata");
$qtiMetadatafield = $this->domxml->create_element("qtimetadatafield");
$qtiFieldlabel = $this->domxml->create_element("fieldlabel");
$qtiFieldlabelText = $this->domxml->create_text_node("ILIAS_VERSION");
$qtiFieldlabel->append_child($qtiFieldlabelText);
$qtiFieldentry = $this->domxml->create_element("fieldentry");
$qtiFieldentryText = $this->domxml->create_text_node($this->ilias->getSetting("ilias_version"));
$qtiFieldentry->append_child($qtiFieldentryText);
$qtiMetadatafield->append_child($qtiFieldlabel);
$qtiMetadatafield->append_child($qtiFieldentry);
$qtiMetadata->append_child($qtiMetadatafield);
$qtiMetadatafield = $this->domxml->create_element("qtimetadatafield");
$qtiFieldlabel = $this->domxml->create_element("fieldlabel");
$qtiFieldlabelText = $this->domxml->create_text_node("QUESTIONTYPE");
$qtiFieldlabel->append_child($qtiFieldlabelText);
$qtiFieldentry = $this->domxml->create_element("fieldentry");
$qtiFieldentryText = $this->domxml->create_text_node(ORDERING_QUESTION_IDENTIFIER);
$qtiFieldentry->append_child($qtiFieldentryText);
$qtiMetadatafield->append_child($qtiFieldlabel);
$qtiMetadatafield->append_child($qtiFieldentry);
$qtiMetadata->append_child($qtiMetadatafield);
$qtiMetadatafield = $this->domxml->create_element("qtimetadatafield");
$qtiFieldlabel = $this->domxml->create_element("fieldlabel");
$qtiFieldlabelText = $this->domxml->create_text_node("AUTHOR");
$qtiFieldlabel->append_child($qtiFieldlabelText);
$qtiFieldentry = $this->domxml->create_element("fieldentry");
$qtiFieldentryText = $this->domxml->create_text_node($this->getAuthor());
$qtiFieldentry->append_child($qtiFieldentryText);
$qtiMetadatafield->append_child($qtiFieldlabel);
$qtiMetadatafield->append_child($qtiFieldentry);
$qtiMetadata->append_child($qtiMetadatafield);
$qtiItemmetadata->append_child($qtiMetadata);
$qtiIdent->append_child($qtiItemmetadata);
// PART I: qti presentation
$qtiPresentation = $this->domxml->create_element("presentation");
$qtiPresentation->set_attribute("label", $this->getTitle());
// add flow to presentation
$qtiFlow = $this->domxml->create_element("flow");
// add material with question text to presentation
$qtiMaterial = $this->domxml->create_element("material");
$qtiMatText = $this->domxml->create_element("mattext");
$qtiMatTextText = $this->domxml->create_text_node($this->get_question());
$qtiMatText->append_child($qtiMatTextText);
$qtiMaterial->append_child($qtiMatText);
$qtiFlow->append_child($qtiMaterial);
// add answers to presentation
$qtiResponseLid = $this->domxml->create_element("response_lid");
if ($this->get_ordering_type() == OQ_PICTURES)
{
$qtiResponseLid->set_attribute("ident", "OQP");
$qtiResponseLid->set_attribute("rcardinality", "Ordered");
if ($this->getOutputType() == OUTPUT_JAVASCRIPT)
{
$qtiResponseLid->set_attribute("output", "javascript");
}
}
else
{
$qtiResponseLid->set_attribute("ident", "OQT");
$qtiResponseLid->set_attribute("rcardinality", "Ordered");
if ($this->getOutputType() == OUTPUT_JAVASCRIPT)
{
$qtiResponseLid->set_attribute("output", "javascript");
}
}
$solution = $this->getSuggestedSolution(0);
if (count($solution))
{
if (preg_match("/il_(\d*?)_(\w+)_(\d+)/", $solution["internal_link"], $matches))
{
$qtiMaterial = $this->domxml->create_element("material");
$qtiMaterial->set_attribute("label", "suggested_solution");
$qtiMatText = $this->domxml->create_element("mattext");
$intlink = "il_" . IL_INST_ID . "_" . $matches[2] . "_" . $matches[3];
if (strcmp($matches[1], "") != 0)
{
$intlink = $solution["internal_link"];
}
$qtiMatTextText = $this->domxml->create_text_node($intlink);
$qtiMatText->append_child($qtiMatTextText);
$qtiMaterial->append_child($qtiMatText);
$qtiResponseLid->append_child($qtiMaterial);
}
}
$qtiRenderChoice = $this->domxml->create_element("render_choice");
// shuffle output
if ($this->getShuffle())
{
$qtiRenderChoice->set_attribute("shuffle", "Yes");
}
else
{
$qtiRenderChoice->set_attribute("shuffle", "No");
}
// shuffle
$akeys = array_keys($this->answers);
if ($this->getshuffle() && $a_shuffle)
{
$akeys = $this->pcArrayShuffle($akeys);
}
// add answers
foreach ($akeys as $index)
{
$answer = $this->answers[$index];
$qtiResponseLabel = $this->domxml->create_element("response_label");
$qtiResponseLabel->set_attribute("ident", $index);
$qtiMaterial = $this->domxml->create_element("material");
if ($this->get_ordering_type() == OQ_PICTURES)
{
$qtiMatImage = $this->domxml->create_element("matimage");
$qtiMatImage->set_attribute("imagtype", "image/jpeg");
$qtiMatImage->set_attribute("label", $answer->get_answertext());
$qtiMatImage->set_attribute("embedded", "base64");
$imagepath = $this->getImagePath() . $answer->get_answertext();
$fh = fopen($imagepath, "rb");
if ($fh == false)
{
//global $ilErr;
//$ilErr->raiseError($this->lng->txt("error_open_image_file"), $ilErr->MESSAGE);
//return;
}
else
{
$imagefile = fread($fh, filesize($imagepath));
fclose($fh);
$base64 = base64_encode($imagefile);
$qtiBase64Data = $this->domxml->create_text_node($base64);
$qtiMatImage->append_child($qtiBase64Data);
$qtiMaterial->append_child($qtiMatImage);
}
}
else
{
$qtiMatText = $this->domxml->create_element("mattext");
$qtiMatTextText = $this->domxml->create_text_node($answer->get_answertext());
$qtiMatText->append_child($qtiMatTextText);
$qtiMaterial->append_child($qtiMatText);
}
$qtiResponseLabel->append_child($qtiMaterial);
$qtiRenderChoice->append_child($qtiResponseLabel);
}
$qtiResponseLid->append_child($qtiRenderChoice);
$qtiFlow->append_child($qtiResponseLid);
$qtiPresentation->append_child($qtiFlow);
$qtiIdent->append_child($qtiPresentation);
// PART II: qti resprocessing
$qtiResprocessing = $this->domxml->create_element("resprocessing");
$qtiOutcomes = $this->domxml->create_element("outcomes");
$qtiDecvar = $this->domxml->create_element("decvar");
$qtiOutcomes->append_child($qtiDecvar);
$qtiResprocessing->append_child($qtiOutcomes);
// add response conditions
foreach ($this->answers as $index => $answer)
{
$qtiRespcondition = $this->domxml->create_element("respcondition");
$qtiRespcondition->set_attribute("continue", "Yes");
// qti conditionvar
$qtiConditionvar = $this->domxml->create_element("conditionvar");
$qtiVarequal = $this->domxml->create_element("varequal");
if ($this->get_ordering_type() == OQ_PICTURES)
{
$qtiVarequal->set_attribute("respident", "OQP");
}
else
{
$qtiVarequal->set_attribute("respident", "OQT");
}
$qtiVarequal->set_attribute("index", $answer->get_solution_order());
$qtiVarequalText = $this->domxml->create_text_node($index);
$qtiVarequal->append_child($qtiVarequalText);
$qtiConditionvar->append_child($qtiVarequal);
// qti setvar
$qtiSetvar = $this->domxml->create_element("setvar");
$qtiSetvar->set_attribute("action", "Add");
$qtiSetvarText = $this->domxml->create_text_node($answer->get_points());
$qtiSetvar->append_child($qtiSetvarText);
// qti displayfeedback
$qtiDisplayfeedback = $this->domxml->create_element("displayfeedback");
$qtiDisplayfeedback->set_attribute("feedbacktype", "Response");
$qtiDisplayfeedback->set_attribute("linkrefid", "link_$index");
$qtiRespcondition->append_child($qtiConditionvar);
$qtiRespcondition->append_child($qtiSetvar);
$qtiRespcondition->append_child($qtiDisplayfeedback);
$qtiResprocessing->append_child($qtiRespcondition);
}
$qtiIdent->append_child($qtiResprocessing);
// PART III: qti itemfeedback
foreach ($this->answers as $index => $answer)
{
$qtiItemfeedback = $this->domxml->create_element("itemfeedback");
$qtiItemfeedback->set_attribute("ident", "link_$index");
$qtiItemfeedback->set_attribute("view", "All");
// qti flow_mat
$qtiFlowmat = $this->domxml->create_element("flow_mat");
$qtiMaterial = $this->domxml->create_element("material");
$qtiMattext = $this->domxml->create_element("mattext");
// Insert response text for right/wrong answers here!!!
$qtiMattextText = $this->domxml->create_text_node("");
$qtiMattext->append_child($qtiMattextText);
$qtiMaterial->append_child($qtiMattext);
$qtiFlowmat->append_child($qtiMaterial);
$qtiItemfeedback->append_child($qtiFlowmat);
$qtiIdent->append_child($qtiItemfeedback);
}
$xml = $this->domxml->dump_mem(true);
if (!$a_include_header)
{
$pos = strpos($xml, "?>");
$xml = substr($xml, $pos + 2);
}
//echo htmlentities($xml);
return $xml;
}
Here is the call graph for this function:
Field Documentation
| ASS_OrderingQuestion::$answers |
Definition at line 60 of file class.assOrderingQuestion.php.
| ASS_OrderingQuestion::$ordering_type |
Definition at line 70 of file class.assOrderingQuestion.php.
Referenced by ASS_OrderingQuestion(), and set_ordering_type().
| ASS_OrderingQuestion::$points |
Definition at line 81 of file class.assOrderingQuestion.php.
Referenced by add_answer(), ASS_OrderingQuestion(), getMaximumPoints(), getReachedPoints(), and set_points().
| ASS_OrderingQuestion::$question |
Definition at line 51 of file class.assOrderingQuestion.php.
Referenced by ASS_OrderingQuestion(), and set_question().
The documentation for this class was generated from the following file:
- assessment/classes/class.assOrderingQuestion.php
