Public Member Functions | Data Fields

assMatchingQuestion Class Reference
[Modules/TestQuestionPool]

Class for matching questions. More...

Inheritance diagram for assMatchingQuestion:
Collaboration diagram for assMatchingQuestion:

Public Member Functions

 assMatchingQuestion ($title="", $comment="", $author="", $owner=-1, $question="", $matching_type=MT_TERMS_DEFINITIONS)
 assMatchingQuestion constructor
 isComplete ()
 Returns true, if a matching question is complete for use.
 saveToDb ($original_id="")
 Saves a assMatchingQuestion object to a database.
 loadFromDb ($question_id)
 Loads a assMatchingQuestion object from a database.
 addMatchingPair ($answertext, $points, $answerorder, $matchingtext, $matchingorder)
 Adds an answer to the question.
 duplicate ($for_test=true, $title="", $author="", $owner="")
 Duplicates an assMatchingQuestion.
 copyObject ($target_questionpool, $title="")
 Copies an assMatchingQuestion.
 duplicateImages ($question_id)
 copyImages ($question_id, $source_questionpool)
 setMatchingType ($matching_type=MT_TERMS_DEFINITIONS)
 Sets the matching question type.
 get_matching_type ()
 Returns the matching question type.
 getMatchingType ()
 add_matchingpair ($term="", $picture_or_definition="", $points=0.0, $term_id=0, $picture_or_definition_id=0)
 Adds an matching pair for an matching question.
 get_matchingpair ($index=0)
 Returns a matching pair.
 getMatchingPair ($index=0)
 Returns a matching pair.
 delete_matchingpair ($index=0)
 Deletes a matching pair.
 flush_matchingpairs ()
 Deletes all matching pairs.
 get_matchingpair_count ()
 Returns the number of matching pairs.
 calculateReachedPoints ($active_id, $pass=NULL)
 Returns the points, a learner has reached answering the question.
 getMaximumPoints ()
 Returns the maximum points, a learner can reach answering the question.
 setImageFile ($image_filename, $image_tempfilename="")
 Sets the image file.
 checkSaveData ()
 Checks the data to be saved for consistency.
 saveWorkingData ($active_id, $pass=NULL)
 Saves the learners input of the question to the database.
 get_random_id ()
 pc_array_shuffle ($array)
 setShuffle ($shuffle)
 Sets the shuffle flag.
 getQuestionType ()
 Returns the question type of the question.
 getAdditionalTableName ()
 Returns the name of the additional question data table in the database.
 getAnswerTableName ()
 Returns the name of the answer table in the database.
 getRTETextWithMediaObjects ()
 Collects all text in the question which could contain media objects which were created with the Rich Text Editor.
getMatchingPairs ()
 Returns the matchingpairs array.
 supportsJavascriptOutput ()
 Returns true if the question type supports JavaScript output.

Data Fields

 $matchingpairs
 $matching_type

Detailed Description

Class for matching questions.

assMatchingQuestion is a class for matching questions.

Author:
Helmut Schottmüller <helmut.schottmueller@mac.com>
Version:
Id:
class.assMatchingQuestion.php 17639 2008-10-09 08:03:56Z hschottm

Definition at line 36 of file class.assMatchingQuestion.php.


Member Function Documentation

assMatchingQuestion::add_matchingpair ( term = "",
picture_or_definition = "",
points = 0.0,
term_id = 0,
picture_or_definition_id = 0 
)

Adds an matching pair for an matching question.

Adds an matching pair for an matching choice question. The students have to fill in an order for the matching pair. The matching pair is an ASS_AnswerMatching object that will be created and assigned to the array $this->matchingpairs.

Parameters:
string $answertext The answer text
string $matchingtext The matching text of the answer text
double $points The points for selecting the matching pair (even negative points can be used)
integer $order A possible display order of the matching pair public
See also:
$matchingpairs
ASS_AnswerMatching

Definition at line 484 of file class.assMatchingQuestion.php.

References assQuestion::$points, and get_random_id().

        {
                // append answer
                if ($term_id == 0)
                {
                        $term_id = $this->get_random_id();
                }

                if ($picture_or_definition_id == 0)
                {
                        $picture_or_definition_id = $this->get_random_id();
                }
                include_once "./Modules/TestQuestionPool/classes/class.assAnswerMatching.php";
                $matchingpair = new ASS_AnswerMatching($term, $points, $term_id, $picture_or_definition, $picture_or_definition_id);
                array_push($this->matchingpairs, $matchingpair);
        }

Here is the call graph for this function:

assMatchingQuestion::addMatchingPair ( answertext,
points,
answerorder,
matchingtext,
matchingorder 
)

Adds an answer to the question.

Adds an answer to the question

public

Definition at line 287 of file class.assMatchingQuestion.php.

References assQuestion::$points.

        {
                include_once "./Modules/TestQuestionPool/classes/class.assAnswerMatching.php";
                array_push($this->matchingpairs, new ASS_AnswerMatching($answertext, $points, $answerorder, $matchingtext, $matchingorder));
        }

assMatchingQuestion::assMatchingQuestion ( title = "",
comment = "",
author = "",
owner = -1,
question = "",
matching_type = MT_TERMS_DEFINITIONS 
)

assMatchingQuestion constructor

The constructor takes possible arguments an creates an instance of the assMatchingQuestion 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 matching question public

Definition at line 69 of file class.assMatchingQuestion.php.

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

        {
                $this->assQuestion($title, $comment, $author, $owner, $question);
                $this->matchingpairs = array();
                $this->matching_type = $matching_type;
        }

Here is the call graph for this function:

assMatchingQuestion::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 617 of file class.assMatchingQuestion.php.

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

        {
                global $ilDB;
                
                $found_value1 = array();
                $found_value2 = 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);
                while ($data = $result->fetchRow(DB_FETCHMODE_OBJECT))
                {
                        if (strcmp($data->value1, "") != 0)
                        {
                                array_push($found_value1, $data->value1);
                                array_push($found_value2, $data->value2);
                        }
                }
                $points = 0;
                foreach ($found_value2 as $key => $value)
                {
                        foreach ($this->matchingpairs as $answer_key => $answer_value)
                        {
                                if (($answer_value->getDefinitionId() == $value) and ($answer_value->getTermId() == $found_value1[$key]))
                                {
                                        $points += $answer_value->getPoints();
                                }
                        }
                }

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

Here is the call graph for this function:

assMatchingQuestion::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 733 of file class.assMatchingQuestion.php.

References ilUtil::sendInfo().

Referenced by saveWorkingData().

        {
                $result = true;
                $matching_values = array();
                foreach ($_POST as $key => $value)
                {
                        if (preg_match("/^sel_matching_(\d+)/", $key, $matches))
                        {
                                if ((strcmp($value, "") != 0) && ($value != -1))
                                {
                                        array_push($matching_values, $value);
                                }
                        }
                }
                $check_matching = array_flip($matching_values);
                if (count($check_matching) != count($matching_values))
                {
                        // duplicate matching values!!!
                        $result = false;
                        ilUtil::sendInfo($this->lng->txt("duplicate_matching_values_selected"), TRUE);
                }
                return $result;
        }

Here is the call graph for this function:

Here is the caller graph for this function:

assMatchingQuestion::copyImages ( question_id,
source_questionpool 
)

Definition at line 411 of file class.assMatchingQuestion.php.

References $filename, get_matching_type(), assQuestion::getImagePath(), and ilUtil::makeDirParents().

        {
                if ($this->get_matching_type() == MT_TERMS_PICTURES)
                {
                        $imagepath = $this->getImagePath();
                        $imagepath_original = str_replace("/$this->id/images", "/$question_id/images", $imagepath);
                        $imagepath_original = str_replace("/$this->obj_id/", "/$source_questionpool/", $imagepath_original);
                        if (!file_exists($imagepath))
                        {
                                ilUtil::makeDirParents($imagepath);
                        }
                        foreach ($this->matchingpairs as $answer)
                        {
                                $filename = $answer->getPicture();
                                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:

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

Copies an assMatchingQuestion.

Copies an assMatchingQuestion

public

Definition at line 354 of file class.assMatchingQuestion.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 ("./Modules/TestQuestionPool/classes/class.assQuestion.php");
                $original_id = assQuestion::_getOriginalId($this->id);
                $clone->id = -1;
                if ($title)
                {
                        $clone->setTitle($title);
                }
                $source_questionpool = $this->getObjId();
                $clone->setObjId($target_questionpool);
                $clone->saveToDb();

                // copy question page content
                $clone->copyPageOfQuestion($original_id);
                // copy XHTML media objects
                $clone->copyXHTMLMediaObjectsOfQuestion($original_id);
                // duplicate the generic feedback
                $clone->duplicateFeedbackGeneric($original_id);

                // duplicate the image
                $clone->copyImages($original_id, $source_questionpool);
                return $clone->id;
        }

Here is the call graph for this function:

assMatchingQuestion::delete_matchingpair ( index = 0  ) 

Deletes a matching pair.

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

Parameters:
integer $index A nonnegative index of the n-th matching pair public
See also:
$matchingpairs

Definition at line 561 of file class.assMatchingQuestion.php.

        {
                if ($index < 0)
                {
                        return;
                }
                if (count($this->matchingpairs) < 1)
                {
                        return;
                }
                if ($index >= count($this->matchingpairs))
                {
                        return;
                }
                unset($this->matchingpairs[$index]);
                $this->matchingpairs = array_values($this->matchingpairs);
        }

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

Duplicates an assMatchingQuestion.

Duplicates an assMatchingQuestion

public

Definition at line 301 of file class.assMatchingQuestion.php.

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

        {
                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 ("./Modules/TestQuestionPool/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);
                // duplicate the generic feedback
                $clone->duplicateFeedbackGeneric($this_id);

                // duplicate the image
                $clone->duplicateImages($this_id);
                return $clone->id;
        }

Here is the call graph for this function:

assMatchingQuestion::duplicateImages ( question_id  ) 

Definition at line 386 of file class.assMatchingQuestion.php.

References $filename, get_matching_type(), assQuestion::getImagePath(), and ilUtil::makeDirParents().

        {
                if ($this->get_matching_type() == MT_TERMS_PICTURES)
                {
                        $imagepath = $this->getImagePath();
                        $imagepath_original = str_replace("/$this->id/images", "/$question_id/images", $imagepath);
                        if (!file_exists($imagepath))
                        {
                                ilUtil::makeDirParents($imagepath);
                        }
                        foreach ($this->matchingpairs as $answer)
                        {
                                $filename = $answer->getPicture();
                                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:

assMatchingQuestion::flush_matchingpairs (  ) 

Deletes all matching pairs.

Deletes all matching pairs

public

See also:
$matchingpairs

Definition at line 587 of file class.assMatchingQuestion.php.

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

assMatchingQuestion::get_matching_type (  ) 

Returns the matching question type.

Returns the matching question type

Returns:
integer The matching question type public
See also:
$matching_type

Definition at line 460 of file class.assMatchingQuestion.php.

Referenced by copyImages(), and duplicateImages().

        {
                return $this->matching_type;
        }

Here is the caller graph for this function:

assMatchingQuestion::get_matchingpair ( index = 0  ) 

Returns a matching pair.

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

Parameters:
integer $index A nonnegative index of the n-th matching pair
Returns:
object ASS_AnswerMatching-Object public
See also:
$matchingpairs

Definition at line 518 of file class.assMatchingQuestion.php.

References getMatchingPair().

        {
                return $this->getMatchingPair($index);
        }

Here is the call graph for this function:

assMatchingQuestion::get_matchingpair_count (  ) 

Returns the number of matching pairs.

Returns the number of matching pairs

Returns:
integer The number of matching pairs of the matching question public
See also:
$matchingpairs

Definition at line 601 of file class.assMatchingQuestion.php.

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

assMatchingQuestion::get_random_id (  ) 

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

Referenced by add_matchingpair().

        {
                mt_srand((double)microtime()*1000000);
                $random_number = mt_rand(1, 100000);
                $found = FALSE;
                while ($found)
                {
                        $found = FALSE;
                        foreach ($this->matchingpairs as $key => $value)
                        {
                                if (($value->getTermId() == $random_number) || ($value->getDefinitionId() == $random_number))
                                {
                                        $found = TRUE;
                                        $random_number++;
                                }
                        }
                }
                return $random_number;
        }

Here is the caller graph for this function:

assMatchingQuestion::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 914 of file class.assMatchingQuestion.php.

        {
                return "qpl_question_matching";
        }

assMatchingQuestion::getAnswerTableName (  ) 

Returns the name of the answer table in the database.

Returns the name of the answer table in the database

Returns:
string The answer table name public

Reimplemented from assQuestion.

Definition at line 927 of file class.assMatchingQuestion.php.

        {
                return "qpl_answer_matching";
        }

assMatchingQuestion::getMatchingPair ( index = 0  ) 

Returns a matching pair.

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

Parameters:
integer $index A nonnegative index of the n-th matching pair
Returns:
object ASS_AnswerMatching-Object public
See also:
$matchingpairs

Definition at line 534 of file class.assMatchingQuestion.php.

Referenced by get_matchingpair().

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

Here is the caller graph for this function:

& assMatchingQuestion::getMatchingPairs (  ) 

Returns the matchingpairs array.

Definition at line 944 of file class.assMatchingQuestion.php.

        {
                return $this->matchingpairs;
        }

assMatchingQuestion::getMatchingType (  ) 

Definition at line 465 of file class.assMatchingQuestion.php.

        {
                return $this->matching_type;
        }

assMatchingQuestion::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 665 of file class.assMatchingQuestion.php.

References assQuestion::$points.

Referenced by isComplete(), and saveToDb().

        {
                $points = 0;
                foreach ($this->matchingpairs as $key => $value)
                {
                        if ($value->getPoints() > 0)
                        {
                                $points += $value->getPoints();
                        }
                }
                return $points;
        }

Here is the caller graph for this function:

assMatchingQuestion::getQuestionType (  ) 

Returns the question type of the question.

Returns the question type of the question

Returns:
integer The question type of the question public

Reimplemented from assQuestion.

Definition at line 901 of file class.assMatchingQuestion.php.

        {
                return "assMatchingQuestion";
        }

assMatchingQuestion::getRTETextWithMediaObjects (  ) 

Collects all text in the question which could contain media objects which were created with the Rich Text Editor.

Reimplemented from assQuestion.

Definition at line 936 of file class.assMatchingQuestion.php.

assMatchingQuestion::isComplete (  ) 

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

Returns true, if a matching question is complete for use

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

Reimplemented from assQuestion.

Definition at line 91 of file class.assMatchingQuestion.php.

References getMaximumPoints().

Referenced by saveToDb().

        {
                if (($this->title) and ($this->author) and ($this->question) and (count($this->matchingpairs)) 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:

assMatchingQuestion::loadFromDb ( question_id  ) 

Loads a assMatchingQuestion object from a database.

Loads a assMatchingQuestion 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 235 of file class.assMatchingQuestion.php.

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

        {
                global $ilDB;

    $query = sprintf("SELECT qpl_questions.*, qpl_question_matching.* FROM qpl_questions, qpl_question_matching WHERE question_id = %s AND qpl_questions.question_id = qpl_question_matching.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->author = $data->author;
                                $this->solution_hint = $data->solution_hint;
                                $this->obj_id = $data->obj_fi;
                                $this->original_id = $data->original_id;
                                $this->owner = $data->owner;
                                $this->matching_type = $data->matching_type;
                                include_once("./Services/RTE/classes/class.ilRTE.php");
                                $this->question = ilRTE::_replaceMediaObjectImageSrc($data->question_text, 1);
                                $this->points = $data->points;
                                $this->shuffle = $data->shuffle;
                                $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_answer_matching WHERE question_fi = %s ORDER BY answer_id ASC",
                                $ilDB->quote($question_id)
                        );
                        $result = $ilDB->query($query);
                        include_once "./Modules/TestQuestionPool/classes/class.assAnswerMatching.php";
                        if (strcmp(strtolower(get_class($result)), db_result) == 0)
                        {
                                while ($data = $result->fetchRow(DB_FETCHMODE_OBJECT))
                                {
                                        array_push($this->matchingpairs, new ASS_AnswerMatching($data->answertext, $data->points, $data->aorder, $data->matchingtext, $data->matching_order));
                                }
                        }
                }
                parent::loadFromDb($question_id);
        }

Here is the call graph for this function:

assMatchingQuestion::pc_array_shuffle ( array  ) 

Definition at line 851 of file class.assMatchingQuestion.php.

                                          {
                $i = count($array);
                mt_srand((double)microtime()*1000000);
                while(--$i) 
                {
                        $j = mt_rand(0, $i);
                        if ($i != $j) 
                        {
                                // swap elements
                                $tmp = $array[$j];
                                $array[$j] = $array[$i];
                                $array[$i] = $tmp;
                        }
                }
                return $array;
        }

assMatchingQuestion::saveToDb ( original_id = ""  ) 

Saves a assMatchingQuestion object to a database.

Saves a assMatchingQuestion object to a database (experimental)

Parameters:
object $db A pear DB object public

Reimplemented from assQuestion.

Definition at line 111 of file class.assMatchingQuestion.php.

References ilRTE::_replaceMediaObjectImageSrc(), assQuestion::createPageObject(), assQuestion::getEstimatedWorkingTime(), getMaximumPoints(), assQuestion::getQuestionTypeID(), assQuestion::getTestId(), assQuestion::insertIntoTest(), and isComplete().

        {
                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");
                if ($this->id == -1)
                {
                        // Neuen Datensatz schreiben
                        $now = getdate();
                        $question_type = $this->getQuestionTypeID();
                        $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, points, 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($estw_time. ""),
                                $ilDB->quote($this->getMaximumPoints() . ""),
                                $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_matching (question_fi, shuffle, matching_type) VALUES (%s, %s, %s)",
                                        $ilDB->quote($this->id . ""),
                                        $ilDB->quote($this->shuffle . ""),
                                        $ilDB->quote($this->matching_type. "")
                                );
                                $ilDB->query($query);

                                // 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, points = %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($estw_time. ""),
                                $ilDB->quote($this->getMaximumPoints() . ""),
                                $ilDB->quote($complete. ""),
                                $ilDB->quote($this->id. "")
                        );
                        $result = $ilDB->query($query);
                        $query = sprintf("UPDATE qpl_question_matching SET shuffle = %s, matching_type = %s WHERE question_fi = %s",
                                $ilDB->quote($this->shuffle . ""),
                                $ilDB->quote($this->matching_type. ""),
                                $ilDB->quote($this->id . "")
                        );
                        $result = $ilDB->query($query);
                }

                if ($result == DB_OK)
                {
                        // Antworten schreiben
                        // alte Antworten löschen
                        $query = sprintf("DELETE FROM qpl_answer_matching WHERE question_fi = %s",
                                $ilDB->quote($this->id)
                        );
                        $result = $ilDB->query($query);

                        // Anworten wegschreiben
                        foreach ($this->matchingpairs as $key => $value)
                        {
                                $matching_obj = $this->matchingpairs[$key];
                                $query = sprintf("INSERT INTO qpl_answer_matching (answer_id, question_fi, answertext, points, aorder, matchingtext, matching_order) VALUES (NULL, %s, %s, %s, %s, %s, %s)",
                                        $ilDB->quote($this->id),
                                        $ilDB->quote($matching_obj->getTerm() . ""),
                                        $ilDB->quote($matching_obj->getPoints() . ""),
                                        $ilDB->quote($matching_obj->getTermId() . ""),
                                        $ilDB->quote($matching_obj->getDefinition() . ""),
                                        $ilDB->quote($matching_obj->getDefinitionId() . "")
                                );
                                $matching_result = $ilDB->query($query);
                        }
                }
                parent::saveToDb($original_id);
        }

Here is the call graph for this function:

assMatchingQuestion::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:
$answers

Reimplemented from assQuestion.

Definition at line 767 of file class.assMatchingQuestion.php.

References ilObjAssessmentFolder::_enabledAssessmentLogging(), ilObjAssessmentFolder::_getLogLanguage(), ilObjTest::_getPass(), checkSaveData(), assQuestion::getId(), and assQuestion::logAction().

        {
                global $ilDB;
                global $ilUser;
                
                $saveWorkingDataResult = $this->checkSaveData();
                $entered_values = 0;
                if ($saveWorkingDataResult)
                {
                        if (is_null($pass))
                        {
                                include_once "./Modules/Test/classes/class.ilObjTest.php";
                                $pass = ilObjTest::_getPass($active_id);
                        }
                        
                        $query = sprintf("DELETE 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);
                        foreach ($_POST as $key => $value)
                        {
                                if (preg_match("/^sel_matching_(\d+)/", $key, $matches))
                                {
                                        if (!(preg_match("/initial_value_\d+/", $value)))
                                        {
                                                if ($value > -1) // -1 is the unselected value in the non javascript version
                                                {
                                                        $entered_values++;
                                                        $query = sprintf("INSERT INTO tst_solutions (solution_id, active_fi, question_fi, value1, value2, pass, TIMESTAMP) VALUES (NULL, %s, %s, %s, %s, %s, NULL)",
                                                                $ilDB->quote($active_id),
                                                                $ilDB->quote($this->getId()),
                                                                $ilDB->quote(trim($value)),
                                                                $ilDB->quote(trim($matches[1])),
                                                                $ilDB->quote($pass . "")
                                                        );
                                                        $result = $ilDB->query($query);
                                                }
                                        }
                                }
                        }
                        $saveWorkingDataResult = true;
                }
                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 $saveWorkingDataResult;
        }

Here is the call graph for this function:

assMatchingQuestion::setImageFile ( 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 688 of file class.assMatchingQuestion.php.

References ilUtil::convertImage(), assQuestion::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 (!move_uploaded_file($image_tempfilename, $imagepath . $image_filename))
                        if (!ilUtil::moveUploadedFile($image_tempfilename, $image_filename, $imagepath.$image_filename))
                        {
                                $result = 2;
                        }
                        else
                        {
                                include_once "./Services/MediaObjects/classes/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:

assMatchingQuestion::setMatchingType ( matching_type = MT_TERMS_DEFINITIONS  ) 

Sets the matching question type.

Sets the matching question type

Parameters:
integer $matching_type The question matching type public
See also:
$matching_type

Definition at line 446 of file class.assMatchingQuestion.php.

References $matching_type.

        {
                $this->matching_type = $matching_type;
        }

assMatchingQuestion::setShuffle ( shuffle  ) 

Sets the shuffle flag.

Sets the shuffle flag

Parameters:
boolean $shuffle A flag indicating whether the answers are shuffled or not public
See also:
$shuffle

Reimplemented from assQuestion.

Definition at line 877 of file class.assMatchingQuestion.php.

References assQuestion::$shuffle.

        {
                switch ($shuffle)
                {
                        case 0:
                        case 1:
                        case 2:
                        case 3:
                                $this->shuffle = $shuffle;
                                break;
                        default:
                                $this->shuffle = 1;
                                break;
                }
        }

assMatchingQuestion::supportsJavascriptOutput (  ) 

Returns true if the question type supports JavaScript output.

Returns true if the question type supports JavaScript output

Returns:
boolean TRUE if the question type supports JavaScript output, FALSE otherwise public

Reimplemented from assQuestion.

Definition at line 957 of file class.assMatchingQuestion.php.

        {
                return TRUE;
        }


Field Documentation

assMatchingQuestion::$matching_type

Definition at line 55 of file class.assMatchingQuestion.php.

Referenced by assMatchingQuestion(), and setMatchingType().

assMatchingQuestion::$matchingpairs

Definition at line 45 of file class.assMatchingQuestion.php.


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