Inheritance diagram for ilLPStatusTestPassed:

Collaboration diagram for ilLPStatusTestPassed:

Public Member Functions
	__construct ($a_obj_id)

	determineStatus ($a_obj_id, $a_user_id, $a_obj=null)
	Determine status. More...

	determinePercentage ($a_obj_id, $a_user_id, $a_obj=null)
	Determine percentage. More...

Public Member Functions inherited from ilLPStatus
	__construct ($a_obj_id)

	_updateStatus ($a_obj_id, $a_usr_id, $a_obj=null, $a_percentage=false, $a_force_raise=false)
	New status handling (st: status, nr: accesses, p: percentage, t: time spent, m: mark) More...

	determinePercentage ($a_obj_id, $a_usr_id, $a_obj=null)
	Determine percentage. More...

	determineStatus ($a_obj_id, $a_usr_id, $a_obj=null)
	Determine status. More...

	refreshStatus ($a_obj_id, $a_users=null)
	Refresh status. More...

Static Public Member Functions
static	_getInProgress ($a_obj_id)

static	_getCompleted ($a_obj_id)

static	_getNotAttempted ($a_obj_id)

static	_getFailed ($a_obj_id)

static	_getStatusInfo ($a_obj_id)

Static Public Member Functions inherited from ilLPStatus
static	_getCountNotAttempted ($a_obj_id)

static	_getNotAttempted ($a_obj_id)

static	_getCountInProgress ($a_obj_id)

static	_getInProgress ($a_obj_id)

static	_getCountCompleted ($a_obj_id)

static	_getCompleted ($a_obj_id)

static	_getFailed ($a_obj_id)

static	_getCountFailed ()

static	_getStatusInfo ($a_obj_id)

static	_getTypicalLearningTime ($a_obj_id)

static	checkStatusForObject ($a_obj_id, $a_users=false)
	This function checks whether the status for a given number of users is dirty and must be recalculated. More...

static	writeStatus ($a_obj_id, $a_user_id, $a_status, $a_percentage=false, $a_force_per=false)
	Write status for user and object. More...

static	setInProgressIfNotAttempted ($a_obj_id, $a_user_id)
	This function shoudl be clalled for normal "read events". More...

static	setAllDirty ()
	Sets all status to dirty. More...

static	setDirty ($a_obj_id)
	Sets status of an object to dirty. More...

static	_lookupStatus ($a_obj_id, $a_user_id, $a_create=true)
	Lookup status. More...

static	_lookupPercentage ($a_obj_id, $a_user_id)
	Lookup percentage. More...

static	_hasUserCompleted ($a_obj_id, $a_user_id)
	Lookup user object completion. More...

static	_lookupStatusChanged ($a_obj_id, $a_user_id)
	Lookup status changed. More...

static	_lookupCompletedForObject ($a_obj_id, $a_user_ids=null)
	Get completed users for object. More...

static	_lookupFailedForObject ($a_obj_id, $a_user_ids=null)
	Get failed users for object. More...

static	_lookupInProgressForObject ($a_obj_id, $a_user_ids=null)
	Get in progress users for object. More...

static	preloadListGUIData ($a_obj_ids)

static	getListGUIStatus ($a_obj_id)

Protected Member Functions
	determineStatusForScoreLastPassTests ($is_finished, $passed)

	determineLpStatus ($passed)

Static Private Member Functions
static	getUserIdsByResultArrayStatus ($objId, $resultArrayStatus)

Additional Inherited Members
Data Fields inherited from ilLPStatus
	$obj_id = null

	$db = null

const	LP_STATUS_NOT_ATTEMPTED = 'trac_no_attempted'

const	LP_STATUS_IN_PROGRESS = 'trac_in_progress'

const	LP_STATUS_COMPLETED = 'trac_completed'

const	LP_STATUS_FAILED = 'trac_failed'

const	LP_STATUS_NOT_ATTEMPTED_NUM = 0

const	LP_STATUS_IN_PROGRESS_NUM = 1

const	LP_STATUS_COMPLETED_NUM = 2

const	LP_STATUS_FAILED_NUM = 3

const	LP_STATUS_REGISTERED = 'trac_registered'

const	LP_STATUS_NOT_REGISTERED = 'trac_not_registered'

const	LP_STATUS_PARTICIPATED = 'trac_participated'

const	LP_STATUS_NOT_PARTICIPATED = 'trac_not_participated'

Static Public Attributes inherited from ilLPStatus
static	$list_gui_cache

Static Protected Member Functions inherited from ilLPStatus
static	raiseEvent ($a_obj_id, $a_usr_id, $a_status, $a_percentage)

static	_lookupStatusForObject ($a_obj_id, $a_status, $a_user_ids=null)
	Get users with given status for object. More...

static	validateLPForObjects ($a_user_id, $a_obj_ids, $a_parent_ref_id)
	Process given objects for lp-relevance. More...

static	checkLPModesForObjects ($a_obj_ids, array &$a_coll_obj_ids)
	Process lp modes for given objects. More...

static	getLPStatusForObjects ($a_user_id, $a_obj_ids)
	Get LP status for given objects (and user) More...

Detailed Description

Definition at line 35 of file class.ilLPStatusTestPassed.php.

Constructor & Destructor Documentation

◆ __construct()

ilLPStatusTestPassed::__construct ( $a_obj_id )

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

References $ilDB.

         {
                 global $ilDB;
 
                 parent::__construct($a_obj_id);
                 $this->db = $ilDB;
         }

Member Function Documentation

◆ _getCompleted()

static ilLPStatusTestPassed::_getCompleted ( $a_obj_id )

static

Definition at line 57 of file class.ilLPStatusTestPassed.php.

References $ilBench.

         {
                 global $ilBench;
 
                 $ilBench->start('LearningProgress','9183_LPStatusTestPassed_completed');
                 $userIds = self::getUserIdsByResultArrayStatus($a_obj_id, 'passed');
                 $ilBench->stop('LearningProgress','9183_LPStatusTestPassed_completed');
 
                 return $userIds;
         }

◆ _getFailed()

static ilLPStatusTestPassed::_getFailed ( $a_obj_id )

static

Definition at line 73 of file class.ilLPStatusTestPassed.php.

         {
                 return self::getUserIdsByResultArrayStatus($a_obj_id, 'failed');
         }

◆ _getInProgress()

static ilLPStatusTestPassed::_getInProgress ( $a_obj_id )

static

Definition at line 46 of file class.ilLPStatusTestPassed.php.

References $ilBench.

         {
                 global $ilBench;
                 
                 $ilBench->start('LearningProgress','9182_LPStatusTestPassed_inProgress');
                 $userIds = self::getUserIdsByResultArrayStatus($a_obj_id, 'in_progress');
                 $ilBench->stop('LearningProgress','9182_LPStatusTestPassed_inProgress');
                 
                 return $userIds;
         }

◆ _getNotAttempted()

static ilLPStatusTestPassed::_getNotAttempted ( $a_obj_id )

static

Definition at line 68 of file class.ilLPStatusTestPassed.php.

         {
                 return self::getUserIdsByResultArrayStatus($a_obj_id, 'not_attempted');
         }

◆ _getStatusInfo()

static ilLPStatusTestPassed::_getStatusInfo ( $a_obj_id )

static

Definition at line 95 of file class.ilLPStatusTestPassed.php.

References ilObjTestAccess\_getPassedUsers().

         {
                 include_once './Modules/Test/classes/class.ilObjTestAccess.php';
                 $status_info['results'] = ilObjTestAccess::_getPassedUsers($a_obj_id);
                 return $status_info;
         }

Here is the call graph for this function:

◆ determineLpStatus()

ilLPStatusTestPassed::determineLpStatus ( $passed )

protected

Parameters

$passed

Returns: int

Definition at line 216 of file class.ilLPStatusTestPassed.php.

Referenced by determineStatus(), and determineStatusForScoreLastPassTests().

         {
                 $status = self::LP_STATUS_FAILED_NUM;
 
                 if ($passed)
                 {
                         $status = self::LP_STATUS_COMPLETED_NUM;
                 }
 
                 return $status;
         }

Here is the caller graph for this function:

◆ determinePercentage()

ilLPStatusTestPassed::determinePercentage	(	$a_obj_id,
		$a_user_id,
		$a_obj = `null`
	)

Determine percentage.

Parameters

integer	object id
integer	user id
object	object (optional depends on object type)

Returns: integer percentage

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

References $ilDB.

         {
                 global $ilDB;
                 
                 $set = $ilDB->query("SELECT tst_result_cache.*, tst_active.user_fi FROM ".
                                          "tst_result_cache JOIN tst_active ON (tst_active.active_id = tst_result_cache.active_fi)".
                                          " JOIN tst_tests ON (tst_tests.test_id = tst_active.test_fi) ".
                                          " WHERE tst_tests.obj_fi = ".$ilDB->quote($a_obj_id, "integer").
                                          " AND tst_active.user_fi = ".$ilDB->quote($a_user_id, "integer"));
                 $per = 0;
                 if ($rec = $ilDB->fetchAssoc($set))
                 {       
                         if ($rec["max_points"] > 0)
                         {
                                 $per = min(100, 100 / $rec["max_points"] * $rec["reached_points"]);
                         }
                         else
                         {
                                 // According to mantis #12305
                                 $per = 0;
                         }
                 }
                 return (int) $per;
         }

◆ determineStatus()

ilLPStatusTestPassed::determineStatus	(	$a_obj_id,
		$a_user_id,
		$a_obj = `null`
	)

Determine status.

Behaviour of "old" 4.0 learning progress:

Setting "Multiple Pass Scoring": Score the last pass

Test not started: No entry
First question opened: Icon/Text: Failed, Score 0%
First question answered (correct, points enough for passing): Icon/Text: Completed, Score 66%
No change after successfully finishing the pass. (100%)
2nd Pass, first question opened: Still Completed/Completed
First question answered (incorrect, success possible): Icon/Text Failed, Score 33%
Second question answered (correct): Icon/Text completed
3rd pass, like 2nd, but two times wrong answer: Icon/Text: Failed

Setting "Multiple Pass Scoring": Score the best pass

Test not started: No entry
First question opened: Icon/Text: Failed, Score 0%
First question answered (correct, points enough for passing): Icon/Text: Completed, Score 66%
No change after successfully finishing the pass. (100%)
2nd Pass, first question opened: Still Completed/Completed
First question answered (incorrect, success possible): Still Completed/Completed

Due to this behaviour in 4.0 we do not have a "in progress" status. During the test the status is "failed" unless the score is enough to pass the test, which makes the learning progress status "completed".

Parameters

integer	object id
integer	user id
object	object (optional depends on object type)

Returns: integer status

Definition at line 134 of file class.ilLPStatusTestPassed.php.

References $ilDB, $res, ilObjTestAccess\_isPassed(), determineLpStatus(), determineStatusForScoreLastPassTests(), SCORE_BEST_PASS, and SCORE_LAST_PASS.

         {
                 global $ilDB;
 
                 $status = self::LP_STATUS_NOT_ATTEMPTED_NUM;
                 require_once 'Modules/Test/classes/class.ilObjTestAccess.php';
                 $res = $ilDB->query("
                         SELECT tst_active.active_id, tst_active.tries, count(tst_sequence.active_fi) " . $ilDB->quoteIdentifier("sequences") . ", tst_active.last_finished_pass,
                                 CASE WHEN
                                         (tst_tests.nr_of_tries - 1) = tst_active.last_finished_pass
                                 THEN '1'
                                 ELSE '0'
                                 END is_last_pass
                         FROM tst_active
                         LEFT JOIN tst_sequence
                         ON tst_sequence.active_fi = tst_active.active_id
                         LEFT JOIN tst_tests
                         ON tst_tests.test_id = tst_active.test_fi
                         WHERE tst_active.user_fi = {$ilDB->quote($a_user_id, "integer")}
                         AND tst_active.test_fi = {$ilDB->quote(ilObjTestAccess::_getTestIDFromObjectID($a_obj_id))}
                         GROUP BY tst_active.active_id, tst_active.tries, is_last_pass
                 ");
 
                 if ($rec = $ilDB->fetchAssoc($res))
                 {
                         if( $rec['sequences'] > 0 )
                         {
                                 require_once 'Modules/Test/classes/class.ilObjTest.php';
 
                                 $test_obj       = new ilObjTest($a_obj_id, false);
                                 $is_passed      = ilObjTestAccess::_isPassed($a_user_id, $a_obj_id);
 
                                 if($test_obj->getPassScoring() == SCORE_LAST_PASS)
                                 {
                                         $is_finished    = false;
                                         if($rec['last_finished_pass'] != null && $rec['sequences'] - 1 == $rec['last_finished_pass'])
                                         {
                                                 $is_finished = true;
                                         }
                                         $status = $this->determineStatusForScoreLastPassTests($is_finished, $is_passed);
                                 }
                                 else if($test_obj->getPassScoring() == SCORE_BEST_PASS)
                                 {
                                         $status = self::LP_STATUS_IN_PROGRESS_NUM;
                                         
                                         if($rec['last_finished_pass'] != null)
                                         {
                                                 $status = $this->determineLpStatus($is_passed);
                                         }
                                         
                                         if( !$rec['is_last_pass'] && $status == self::LP_STATUS_FAILED_NUM )
                                         {
                                                 $status = self::LP_STATUS_IN_PROGRESS_NUM;
                                         }
                                 }
                         }
                 }
 
                 return $status;
         }

Here is the call graph for this function:

◆ determineStatusForScoreLastPassTests()

ilLPStatusTestPassed::determineStatusForScoreLastPassTests	(	$is_finished,
		$passed
	)

protected

Parameters

$is_finished
$passed

Returns: int

Definition at line 200 of file class.ilLPStatusTestPassed.php.

References determineLpStatus().

Referenced by determineStatus().

         {
                 $status = self::LP_STATUS_IN_PROGRESS_NUM;
 
                 if($is_finished)
                 {
                         $status = $this->determineLpStatus($passed);
                 }
 
                 return $status;
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getUserIdsByResultArrayStatus()

static ilLPStatusTestPassed::getUserIdsByResultArrayStatus	(	$objId,
		$resultArrayStatus
	)

staticprivate

Definition at line 78 of file class.ilLPStatusTestPassed.php.

References ilLPStatusWrapper\_getStatusInfo(), and array.

         {
                 $status_info = ilLPStatusWrapper::_getStatusInfo($objId);
                 
                 $user_ids = array();
                 
                 foreach($status_info['results'] as $user_data)
                 {
                         if($user_data[$resultArrayStatus])
                         {
                                 $user_ids[] = $user_data['user_id'];
                         }
                 }
                 
                 return $user_ids;
         }

Here is the call graph for this function:

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

Services/Tracking/classes/status/class.ilLPStatusTestPassed.php

Public Member Functions

Static Public Member Functions

Protected Member Functions

Static Private Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ _getCompleted()

◆ _getFailed()

◆ _getInProgress()

◆ _getNotAttempted()

◆ _getStatusInfo()

◆ determineLpStatus()

◆ determinePercentage()

◆ determineStatus()

◆ determineStatusForScoreLastPassTests()

◆ getUserIdsByResultArrayStatus()