ILIAS  release_6 Revision v6.24-5-g0c8bfefb3b8
All Data Structures Namespaces Files Functions Variables Modules Pages
ilLPStatusCmiXapiAbstract Class Reference
+ Inheritance diagram for ilLPStatusCmiXapiAbstract:
+ Collaboration diagram for ilLPStatusCmiXapiAbstract:

Public Member Functions

 getCmixUserResult ($objId, $usrId)
 
 determineStatus ($a_obj_id, $a_usr_id, $a_obj=null)
 
 determinePercentage ($a_obj_id, $a_usr_id, $a_obj=null)
 
- 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 _getNotAttempted ($a_obj_id)
 
static _getInProgress ($a_obj_id)
 
static _getCompleted ($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, &$a_old_status=self::LP_STATUS_NOT_ATTEMPTED_NUM)
 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, $a_image_only=true)
 

Protected Member Functions

 ensureObject ($objId, $object=null)
 
 resultSatisfyCompleted (ilCmiXapiResult $result)
 
 resultSatisfyFailed (ilCmiXapiResult $result)
 

Static Protected Member Functions

static _resultSatisfyCompleted (ilCmiXapiResult $result, $a_obj_id)
 
static _resultSatisfyFailed (ilCmiXapiResult $result, $a_obj_id)
 
- Static Protected Member Functions inherited from ilLPStatus
static raiseEvent ($a_obj_id, $a_usr_id, $a_status, $a_old_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...
 

Protected Attributes

 $cmixUserResult = array()
 
- Protected Attributes inherited from ilLPStatus
 $obj_id = null
 
 $db = null
 

Static Private Member Functions

static getUserIdsByLpStatusNum ($objId, $lpStatusNum)
 
static loadStatusInfo ($a_obj_id)
 

Static Private Attributes

static $statusInfoCache = array()
 

Additional Inherited Members

- Data Fields inherited from ilLPStatus
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
 

Detailed Description

Definition at line 14 of file class.ilLPStatusCmiXapiAbstract.php.

Member Function Documentation

◆ _getCompleted()

static ilLPStatusCmiXapiAbstract::_getCompleted (   $a_obj_id)
static

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

References ilLPStatus\LP_STATUS_COMPLETED_NUM.

74  {
75  return self::getUserIdsByLpStatusNum(
76  $a_obj_id,
78  );
79  }
const LP_STATUS_COMPLETED_NUM

◆ _getFailed()

static ilLPStatusCmiXapiAbstract::_getFailed (   $a_obj_id)
static

Definition at line 81 of file class.ilLPStatusCmiXapiAbstract.php.

References ilLPStatus\LP_STATUS_FAILED_NUM.

82  {
83  return self::getUserIdsByLpStatusNum(
84  $a_obj_id,
86  );
87  }
const LP_STATUS_FAILED_NUM

◆ _getInProgress()

static ilLPStatusCmiXapiAbstract::_getInProgress (   $a_obj_id)
static

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

References ilLPStatus\LP_STATUS_IN_PROGRESS_NUM.

66  {
67  return self::getUserIdsByLpStatusNum(
68  $a_obj_id,
70  );
71  }
const LP_STATUS_IN_PROGRESS_NUM

◆ _getNotAttempted()

static ilLPStatusCmiXapiAbstract::_getNotAttempted (   $a_obj_id)
static

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

References ilLPStatus\LP_STATUS_NOT_ATTEMPTED_NUM.

58  {
59  return self::getUserIdsByLpStatusNum(
60  $a_obj_id,
62  );
63  }
const LP_STATUS_NOT_ATTEMPTED_NUM

◆ _getStatusInfo()

static ilLPStatusCmiXapiAbstract::_getStatusInfo (   $a_obj_id)
static

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

96  {
97  if (self::$statusInfoCache[$a_obj_id] === null) {
98  self::$statusInfoCache[$a_obj_id] = self::loadStatusInfo($a_obj_id);
99  }
100 
101  return self::$statusInfoCache[$a_obj_id];
102  }

◆ _resultSatisfyCompleted()

static ilLPStatusCmiXapiAbstract::_resultSatisfyCompleted ( ilCmiXapiResult  $result,
  $a_obj_id 
)
staticprotected
Parameters
ilObjCmiXapi$object
ilCmiXapiResult$result
Returns
bool

Definition at line 182 of file class.ilLPStatusCmiXapiAbstract.php.

References resultSatisfyFailed().

183  {
184  $lpStatusDetermination = new static($a_obj_id);
185  return $lpStatusDetermination->resultSatisfyCompleted($result);
186  }
+ Here is the call graph for this function:

◆ _resultSatisfyFailed()

static ilLPStatusCmiXapiAbstract::_resultSatisfyFailed ( ilCmiXapiResult  $result,
  $a_obj_id 
)
staticprotected
Parameters
ilObjCmiXapi$object
ilCmiXapiResult$result
Returns
bool

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

200  {
201  $lpStatusDetermination = new static($a_obj_id);
202  return $lpStatusDetermination->resultSatisfyFailed($result);
203  }

◆ determinePercentage()

ilLPStatusCmiXapiAbstract::determinePercentage (   $a_obj_id,
  $a_usr_id,
  $a_obj = null 
)

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

References $result, getCmixUserResult(), and resultSatisfyCompleted().

161  {
162  $cmixResult = $this->getCmixUserResult($a_obj_id, $a_usr_id);
163 
164  if ($cmixResult instanceof ilCmiXapiResult) {
165  return 100 * (float) $cmixResult->getScore();
166  }
167 
168  return 0;
169  }
+ Here is the call graph for this function:

◆ determineStatus()

ilLPStatusCmiXapiAbstract::determineStatus (   $a_obj_id,
  $a_usr_id,
  $a_obj = null 
)

Definition at line 137 of file class.ilLPStatusCmiXapiAbstract.php.

References $cmixUserResult, ilCmiXapiUser\exists(), getCmixUserResult(), resultSatisfyCompleted(), and resultSatisfyFailed().

138  {
139  $cmixUserResult = $this->getCmixUserResult($a_obj_id, $a_usr_id);
140 
141  if ($cmixUserResult instanceof ilCmiXapiResult) {
143  return self::LP_STATUS_COMPLETED_NUM;
144  }
145 
146  if ($this->resultSatisfyFailed($cmixUserResult)) {
147  return self::LP_STATUS_FAILED_NUM;
148  }
149 
150  return self::LP_STATUS_IN_PROGRESS_NUM;
151  }
152 
153  if (ilCmiXapiUser::exists($a_obj_id, $a_usr_id)) {
154  return self::LP_STATUS_IN_PROGRESS_NUM;
155  }
156 
157  return self::LP_STATUS_NOT_ATTEMPTED_NUM;
158  }
resultSatisfyCompleted(ilCmiXapiResult $result)
static exists($objId, $usrId, $privacyIdent=999)
resultSatisfyFailed(ilCmiXapiResult $result)
+ Here is the call graph for this function:

◆ ensureObject()

ilLPStatusCmiXapiAbstract::ensureObject (   $objId,
  $object = null 
)
protected
Parameters
$objId
$object
Returns
ilObjCmiXapi

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

References $objId, and ilObjectFactory\getInstanceByObjId().

49  {
50  if (!($object instanceof ilObjCmiXapi)) {
52  }
53 
54  return $object;
55  }
$objId
Definition: xapitoken.php:41
static getInstanceByObjId($a_obj_id, $stop_on_error=true)
get an instance of an Ilias object by object id
+ Here is the call graph for this function:

◆ getCmixUserResult()

ilLPStatusCmiXapiAbstract::getCmixUserResult (   $objId,
  $usrId 
)
Parameters
$objId
$usrId
Returns
ilCmiXapiResult

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

References $cmixUserResult, Vendor\Package\$e, $objId, and ilCmiXapiResult\getInstanceByObjIdAndUsrId().

Referenced by determinePercentage(), and determineStatus().

26  {
27  if (!isset($this->cmixUserResult[$objId])) {
28  $this->cmixUserResult[$objId] = array();
29  }
30 
31  if (!isset($this->cmixUserResult[$objId][$usrId])) {
32  try {
34  $this->cmixUserResult[$objId][$usrId] = $cmixUserResult;
35  } catch (ilCmiXapiException $e) {
36  $this->cmixUserResult[$objId][$usrId] = null;
37  }
38  }
39 
40  return $this->cmixUserResult[$objId][$usrId];
41  }
$objId
Definition: xapitoken.php:41
static getInstanceByObjIdAndUsrId($objId, $usrId)
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ getUserIdsByLpStatusNum()

static ilLPStatusCmiXapiAbstract::getUserIdsByLpStatusNum (   $objId,
  $lpStatusNum 
)
staticprivate

Definition at line 89 of file class.ilLPStatusCmiXapiAbstract.php.

References $objId.

90  {
91  $statusInfo = self::_getStatusInfo($objId);
92  return $statusInfo[$lpStatusNum];
93  }
$objId
Definition: xapitoken.php:41

◆ loadStatusInfo()

static ilLPStatusCmiXapiAbstract::loadStatusInfo (   $a_obj_id)
staticprivate

Definition at line 104 of file class.ilLPStatusCmiXapiAbstract.php.

References ilCmiXapiResult\getResultsForObject(), ilCmiXapiUser\getUsersForObject(), ilLPStatus\LP_STATUS_COMPLETED_NUM, ilLPStatus\LP_STATUS_FAILED_NUM, ilLPStatus\LP_STATUS_IN_PROGRESS_NUM, and ilLPStatus\LP_STATUS_NOT_ATTEMPTED_NUM.

105  {
106  $statusInfo = [
111  ];
112 
113  $cmixUsers = ilCmiXapiUser::getUsersForObject($a_obj_id);
114  $userResults = ilCmiXapiResult::getResultsForObject($a_obj_id);
115 
116  foreach ($cmixUsers as $cmixUser) {
118 
119  if (isset($userResults[$cmixUser->getUsrId()])) {
120  $userResult = $userResults[$cmixUser->getUsrId()];
121 
122  if (self::_resultSatisfyCompleted($userResult, $a_obj_id)) {
124  }
125 
126  if (self::_resultSatisfyFailed($userResult, $a_obj_id)) {
128  }
129  }
130 
131  $statusInfo[$status][] = $cmixUser->getUsrId();
132  }
133 
134  return $statusInfo;
135  }
const LP_STATUS_COMPLETED_NUM
static getResultsForObject($objId)
static getUsersForObject($objId, $asUsrId=false)
const LP_STATUS_IN_PROGRESS_NUM
const LP_STATUS_NOT_ATTEMPTED_NUM
const LP_STATUS_FAILED_NUM
+ Here is the call graph for this function:

◆ resultSatisfyCompleted()

ilLPStatusCmiXapiAbstract::resultSatisfyCompleted ( ilCmiXapiResult  $result)
abstractprotected
Parameters
ilCmiXapiResult$result
Returns
bool

Referenced by determinePercentage(), and determineStatus().

+ Here is the caller graph for this function:

◆ resultSatisfyFailed()

ilLPStatusCmiXapiAbstract::resultSatisfyFailed ( ilCmiXapiResult  $result)
abstractprotected
Parameters
ilCmiXapiResult$result
Returns
bool

Referenced by _resultSatisfyCompleted(), and determineStatus().

+ Here is the caller graph for this function:

Field Documentation

◆ $cmixUserResult

ilLPStatusCmiXapiAbstract::$cmixUserResult = array()
protected

Definition at line 16 of file class.ilLPStatusCmiXapiAbstract.php.

Referenced by determineStatus(), and getCmixUserResult().

◆ $statusInfoCache

ilLPStatusCmiXapiAbstract::$statusInfoCache = array()
staticprivate

Definition at line 18 of file class.ilLPStatusCmiXapiAbstract.php.


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