This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V. More...

Collaboration diagram for ilLOTestRun:

Public Member Functions
	__construct (int $a_crs_id, int $a_user_id, int $a_test_id, int $a_objective_id)

	getContainerId ()

	getUserId ()

	getTestId ()

	getObjectiveId ()

	getMaxPoints ()

	setMaxPoints (int $a_points)

	getQuestions ()

	clearQuestions ()

	addQuestion (int $a_id)

	questionExists (int $a_question_id)

	setQuestionResult (int $a_qst_id, float $a_points)

	getResult ()

	delete ()

	create ()

	update ()

	read ()

Static Public Member Functions
static	lookupRunExistsForObjective (int $a_test_id, int $a_objective_id, int $a_user_id)

static	deleteRuns (int $a_container_id, int $a_user_id)

static	deleteRun (int $a_container_id, int $a_user_id, int $a_test_id)

static	lookupObjectives (int $a_container_id, int $a_user_id, int $a_test_id)

static	getRun (int $a_container_id, int $a_user_id, int $a_test_id)

Protected Attributes
int	$container_id = 0

int	$user_id = 0

int	$test_id = 0

int	$objective_id = 0

int	$max_points = 0

array	$questions = array()

ilDBInterface	$db

Detailed Description

This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V.

ILIAS is licensed with the GPL-3.0, see https://www.gnu.org/licenses/gpl-3.0.en.html You should have received a copy of said license along with the source code, too.

If this is not the case or you just want to try ILIAS, you'll find us at: https://www.ilias.de https://github.com/ILIAS-eLearning Stores current objective, questions and max points

Author: Stefan Meyer smeye.nosp@m.r.il.nosp@m.ias@g.nosp@m.mx.d.nosp@m.e

Version: $Id$

Definition at line 23 of file class.ilLOTestRun.php.

Constructor & Destructor Documentation

◆ __construct()

ilLOTestRun::__construct	(	int	$a_crs_id,
		int	$a_user_id,
		int	$a_test_id,
		int	$a_objective_id
	)

Definition at line 34 of file class.ilLOTestRun.php.

References $DIC, and read().

     {
         global $DIC;
 
         $this->db = $DIC->database();
 
         $this->container_id = $a_crs_id;
         $this->user_id = $a_user_id;
         $this->test_id = $a_test_id;
         $this->objective_id = $a_objective_id;
 
         $this->read();
     }

Here is the call graph for this function:

Member Function Documentation

◆ addQuestion()

ilLOTestRun::addQuestion ( int $a_id )

Definition at line 165 of file class.ilLOTestRun.php.

                                           : void
     {
         $this->questions[$a_id] = 0;
     }

◆ clearQuestions()

ilLOTestRun::clearQuestions ( )

Definition at line 160 of file class.ilLOTestRun.php.

                                     : void
     {
         $this->questions = array();
     }

◆ create()

ilLOTestRun::create ( )

Definition at line 209 of file class.ilLOTestRun.php.

References getContainerId(), getMaxPoints(), getObjectiveId(), getQuestions(), getTestId(), and getUserId().

Referenced by ilLOTestQuestionAdapter\notifyTestStart().

                             : void
     {
         $query = 'INSERT INTO loc_tst_run ' .
             '(container_id, user_id, test_id, objective_id,max_points,questions) ' .
             'VALUES( ' .
             $this->db->quote($this->getContainerId(), 'integer') . ', ' .
             $this->db->quote($this->getUserId(), 'integer') . ', ' .
             $this->db->quote($this->getTestId(), 'integer') . ', ' .
             $this->db->quote($this->getObjectiveId(), 'integer') . ', ' .
             $this->db->quote($this->getMaxPoints(), 'integer') . ', ' .
             $this->db->quote(serialize($this->getQuestions()), 'text') . ' ' .
             ')';
         $this->db->manipulate($query);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ delete()

ilLOTestRun::delete ( )

Definition at line 199 of file class.ilLOTestRun.php.

References getContainerId(), getObjectiveId(), getTestId(), and getUserId().

                             : void
     {
         $query = 'DELETE FROM loc_tst_run ' .
             'WHERE container_id = ' . $this->db->quote($this->getContainerId(), 'integer') . ' ' .
             'AND user_id = ' . $this->db->quote($this->getUserId(), 'integer') . ' ' .
             'AND test_id = ' . $this->db->quote($this->getTestId(), 'integer') . ' ' .
             'AND objective_id = ' . $this->db->quote($this->getObjectiveId(), 'integer');
         $this->db->manipulate($query);
     }

Here is the call graph for this function:

◆ deleteRun()

static ilLOTestRun::deleteRun	(	int	$a_container_id,
		int	$a_user_id,
		int	$a_test_id
	)

static

Definition at line 75 of file class.ilLOTestRun.php.

References $DIC, and $ilDB.

Referenced by ilLOTestQuestionAdapter\notifyTestStart().

                                                                                          : void
     {
         global $DIC;
 
         $ilDB = $DIC->database();
         $query = 'DELETE FROM loc_tst_run ' .
             'WHERE container_id = ' . $ilDB->quote($a_container_id, 'integer') . ' ' .
             'AND user_id = ' . $ilDB->quote($a_user_id, 'integer') . ' ' .
             'AND test_id = ' . $ilDB->quote($a_test_id, 'integer') . ' ';
         $ilDB->manipulate($query);
     }

Here is the caller graph for this function:

◆ deleteRuns()

static ilLOTestRun::deleteRuns	(	int	$a_container_id,
		int	$a_user_id
	)

static

Definition at line 64 of file class.ilLOTestRun.php.

References $DIC, and $ilDB.

Referenced by ilObjCourseGUI\resetObject().

                                                                           : void
     {
         global $DIC;
 
         $ilDB = $DIC['ilDB'];
         $query = 'DELETE FROM loc_tst_run ' .
             'WHERE container_id = ' . $ilDB->quote($a_container_id, 'integer') . ' ' .
             'AND user_id = ' . $ilDB->quote($a_user_id, 'integer') . ' ';
         $ilDB->manipulate($query);
     }

Here is the caller graph for this function:

◆ getContainerId()

ilLOTestRun::getContainerId ( )

Definition at line 125 of file class.ilLOTestRun.php.

References $container_id.

Referenced by create(), delete(), and read().

                                     : int
     {
         return $this->container_id;
     }

Here is the caller graph for this function:

◆ getMaxPoints()

ilLOTestRun::getMaxPoints ( )

Definition at line 145 of file class.ilLOTestRun.php.

References $max_points.

Referenced by create(), getResult(), and update().

                                   : int
     {
         return $this->max_points;
     }

Here is the caller graph for this function:

◆ getObjectiveId()

ilLOTestRun::getObjectiveId ( )

Definition at line 140 of file class.ilLOTestRun.php.

References $objective_id.

Referenced by create(), delete(), ILIAS\Test\Results\Presentation\TitlesBuilder\getObjectiveTitle(), read(), and update().

                                     : int
     {
         return $this->objective_id;
     }

Here is the caller graph for this function:

◆ getQuestions()

ilLOTestRun::getQuestions ( )

Definition at line 155 of file class.ilLOTestRun.php.

References $questions.

Referenced by create(), and update().

                                   : array
     {
         return $this->questions;
     }

Here is the caller graph for this function:

◆ getResult()

ilLOTestRun::getResult ( )

Definition at line 180 of file class.ilLOTestRun.php.

References getMaxPoints().

                                : array
     {
         $sum_points = 0;
         foreach ($this->questions as $points) {
             $sum_points += $points;
         }
 
         $percentage =
             ($this->getMaxPoints() > 0) ?
                 round(($sum_points / $this->getMaxPoints() * 100), 0) :
                 100;
 
         return array(
             'max' => $this->getMaxPoints(),
             'reached' => $sum_points,
             'percentage' => $percentage
         );
     }

Here is the call graph for this function:

◆ getRun()

static ilLOTestRun::getRun	(	int	$a_container_id,
		int	$a_user_id,
		int	$a_test_id
	)

static

Returns: []

Definition at line 107 of file class.ilLOTestRun.php.

References $DIC, $ilDB, $res, and ilDBConstants\FETCHMODE_OBJECT.

Referenced by ILIAS\Test\Results\Presentation\TitlesBuilder\initObjectives(), and ilLOTestQuestionAdapter\initTestRun().

                                                                                       : array
     {
         global $DIC;
 
         $ilDB = $DIC->database();
         $query = 'SELECT objective_id FROM loc_tst_run ' .
             'WHERE container_id = ' . $ilDB->quote($a_container_id, 'integer') . ' ' .
             'AND user_id = ' . $ilDB->quote($a_user_id, 'integer') . ' ' .
             'AND test_id = ' . $ilDB->quote($a_test_id, 'integer') . ' ';
         $res = $ilDB->query($query);
 
         $run = array();
         while ($row = $res->fetchRow(ilDBConstants::FETCHMODE_OBJECT)) {
             $run[] = new ilLOTestRun($a_container_id, $a_user_id, $a_test_id, $row->objective_id);
         }
         return $run;
     }

Here is the caller graph for this function:

◆ getTestId()

ilLOTestRun::getTestId ( )

Definition at line 135 of file class.ilLOTestRun.php.

References $test_id.

Referenced by create(), delete(), read(), and update().

                                : int
     {
         return $this->test_id;
     }

Here is the caller graph for this function:

◆ getUserId()

ilLOTestRun::getUserId ( )

Definition at line 130 of file class.ilLOTestRun.php.

References $user_id.

Referenced by create(), delete(), read(), and update().

                                : int
     {
         return $this->user_id;
     }

Here is the caller graph for this function:

◆ lookupObjectives()

static ilLOTestRun::lookupObjectives	(	int	$a_container_id,
		int	$a_user_id,
		int	$a_test_id
	)

static

Definition at line 87 of file class.ilLOTestRun.php.

References $DIC, $ilDB, $objectives, $res, and ilDBConstants\FETCHMODE_OBJECT.

                                                                                                 : array
     {
         global $DIC;
 
         $ilDB = $DIC->database();
         $query = 'SELECT objective_id FROM loc_tst_run ' .
             'WHERE container_id = ' . $ilDB->quote($a_container_id, 'integer') . ' ' .
             'AND user_id = ' . $ilDB->quote($a_user_id, 'integer') . ' ' .
             'AND test_id = ' . $ilDB->quote($a_test_id, 'integer');
         $res = $ilDB->query($query);
         $objectives = array();
         while ($row = $res->fetchRow(ilDBConstants::FETCHMODE_OBJECT)) {
             $objectives[] = $row->objective_id;
         }
         return $objectives;
     }

◆ lookupRunExistsForObjective()

static ilLOTestRun::lookupRunExistsForObjective	(	int	$a_test_id,
		int	$a_objective_id,
		int	$a_user_id
	)

static

Definition at line 48 of file class.ilLOTestRun.php.

References $DIC, $ilDB, $res, and ilDBConstants\FETCHMODE_OBJECT.

                                                                                                            : bool
     {
         global $DIC;
 
         $ilDB = $DIC->database();
         $query = 'SELECT * FROM loc_tst_run ' .
             'WHERE test_id = ' . $ilDB->quote($a_test_id, 'integer') . ' ' .
             'AND objective_id = ' . $ilDB->quote($a_objective_id, 'integer') . ' ' .
             'AND user_id = ' . $ilDB->quote($a_user_id, 'integer');
         $res = $ilDB->query($query);
         while ($row = $res->fetchRow(ilDBConstants::FETCHMODE_OBJECT)) {
             return true;
         }
         return false;
     }

◆ questionExists()

ilLOTestRun::questionExists ( int $a_question_id )

Definition at line 170 of file class.ilLOTestRun.php.

                                                       : bool
     {
         return array_key_exists($a_question_id, $this->questions);
     }

◆ read()

ilLOTestRun::read ( )

Definition at line 236 of file class.ilLOTestRun.php.

References $res, ilDBConstants\FETCHMODE_OBJECT, getContainerId(), getObjectiveId(), getTestId(), and getUserId().

Referenced by __construct().

                           : void
     {
         $query = 'SELECT * FROM loc_tst_run ' .
             'WHERE container_id = ' . $this->db->quote($this->getContainerId(), 'integer') . ' ' .
             'AND user_id = ' . $this->db->quote($this->getUserId(), 'integer') . ' ' .
             'AND test_id = ' . $this->db->quote($this->getTestId(), 'integer') . ' ' .
             'AND objective_id = ' . $this->db->quote($this->getObjectiveId(), 'integer');
         $res = $this->db->query($query);
         while ($row = $res->fetchRow(ilDBConstants::FETCHMODE_OBJECT)) {
             $this->max_points = $row->max_points;
             if ($row->questions) {
                 $this->questions = unserialize($row->questions);
             }
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setMaxPoints()

ilLOTestRun::setMaxPoints ( int $a_points )

Definition at line 150 of file class.ilLOTestRun.php.

                                                : void
     {
         $this->max_points = $a_points;
     }

◆ setQuestionResult()

ilLOTestRun::setQuestionResult	(	int	$a_qst_id,
		float	$a_points
	)

Definition at line 175 of file class.ilLOTestRun.php.

                                                                      : void
     {
         $this->questions[$a_qst_id] = $a_points;
     }

◆ update()

ilLOTestRun::update ( )

Definition at line 224 of file class.ilLOTestRun.php.

References getMaxPoints(), getObjectiveId(), getQuestions(), getTestId(), and getUserId().

                             : void
     {
         $query = 'UPDATE loc_tst_run SET ' .
             'max_points = ' . $this->db->quote($this->getMaxPoints(), 'integer') . ', ' .
             'questions = ' . $this->db->quote(serialize($this->getQuestions()), 'text') . ' ' .
             'WHERE container_id = ' . $this->db->quote($this->container_id, 'integer') . ' ' .
             'AND user_id = ' . $this->db->quote($this->getUserId(), 'integer') . ' ' .
             'AND test_id = ' . $this->db->quote($this->getTestId(), 'integer') . ' ' .
             'AND objective_id = ' . $this->db->quote($this->getObjectiveId(), 'integer') . ' ';
         $this->db->manipulate($query);
     }

Here is the call graph for this function:

Field Documentation

◆ $container_id

int ilLOTestRun::$container_id = 0

protected

Definition at line 25 of file class.ilLOTestRun.php.

Referenced by getContainerId().

◆ $db

ilDBInterface ilLOTestRun::$db

protected

Definition at line 32 of file class.ilLOTestRun.php.

◆ $max_points

int ilLOTestRun::$max_points = 0

protected

Definition at line 29 of file class.ilLOTestRun.php.

Referenced by getMaxPoints().

◆ $objective_id

int ilLOTestRun::$objective_id = 0

protected

Definition at line 28 of file class.ilLOTestRun.php.

Referenced by getObjectiveId().

◆ $questions

array ilLOTestRun::$questions = array()

protected

Definition at line 30 of file class.ilLOTestRun.php.

Referenced by getQuestions().

◆ $test_id

int ilLOTestRun::$test_id = 0

protected

Definition at line 27 of file class.ilLOTestRun.php.

Referenced by getTestId().

◆ $user_id

int ilLOTestRun::$user_id = 0

protected

Definition at line 26 of file class.ilLOTestRun.php.

Referenced by getUserId().

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

components/ILIAS/Course/classes/Objectives/class.ilLOTestRun.php

Public Member Functions

Static Public Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ addQuestion()

◆ clearQuestions()

◆ create()

◆ delete()

◆ deleteRun()

◆ deleteRuns()

◆ getContainerId()

◆ getMaxPoints()

◆ getObjectiveId()

◆ getQuestions()

◆ getResult()

◆ getRun()

◆ getTestId()

◆ getUserId()

◆ lookupObjectives()

◆ lookupRunExistsForObjective()

◆ questionExists()

◆ read()

◆ setMaxPoints()

◆ setQuestionResult()

◆ update()

Field Documentation

◆ $container_id

◆ $db

◆ $max_points

◆ $objective_id

◆ $questions

◆ $test_id

◆ $user_id