Class ilObjSCORMTracking.
More...
|
static | storeJsApi () |
|
static | storeJsApiCmi (int $user_id, int $obj_id, object $data) |
|
static | syncGlobalStatus (int $userId, int $packageId, int $refId, object $data, ?int $new_global_status) |
|
static | _insertTrackData (int $a_sahs_id, string $a_lval, string $a_rval, int $a_obj_id) |
|
static | _getCompleted (object $scorm_item_id, int $a_obj_id) |
| like necessary because of Oracle More...
|
|
static | _getCollectionStatus (?array $a_scos, int $a_obj_id, int $a_user_id) |
|
static | _countCompleted (?array $a_scos, int $a_obj_id, int $a_user_id) |
|
static | lookupLastAccessTimes (int $a_obj_id) |
| Lookup last acccess time for all users of a scorm module. More...
|
|
static | _getTrackedUsers (int $a_obj_id) |
| Get all tracked users. More...
|
|
static | _getFailed (object $scorm_item_id, int $a_obj_id) |
| like necessary because of Oracle More...
|
|
static | _getCountCompletedPerUser (array $a_scorm_item_ids, int $a_obj_id) |
| Get users who have status completed or passed. More...
|
|
static | _getProgressInfo (array $sco_item_ids, int $a_obj_id) |
| Get info about. More...
|
|
static | _getInProgress ($scorm_item_id, int $a_obj_id, ?array $a_blocked_user_ids=null) |
|
static | scorm12PlayerUnload () |
|
static | checkIfAllowed (int $packageId, int $userId, int $hash) |
|
static | _syncReadEvent (int $a_obj_id, int $a_user_id, string $a_type, int $a_ref_id) |
|
◆ _countCompleted()
static ilObjSCORMTracking::_countCompleted |
( |
?array |
$a_scos, |
|
|
int |
$a_obj_id, |
|
|
int |
$a_user_id |
|
) |
| |
|
static |
Definition at line 346 of file class.ilObjSCORMTracking.php.
References $DIC, $ilDB, and $res.
Referenced by ilLPStatusSCORM\determinePercentage().
349 $ilDB = $DIC->database();
352 if (is_array($a_scos)) {
353 $in =
$ilDB->in(
'sco_id', $a_scos,
false,
'integer');
356 'SELECT sco_id, rvalue FROM scorm_tracking 361 array(
'integer',
'text',
'integer'),
362 array($a_obj_id,
'cmi.core.lesson_status', $a_user_id)
366 if ($rec[
"rvalue"] ===
"completed" || $rec[
"rvalue"] ===
"passed") {
◆ _getCollectionStatus()
static ilObjSCORMTracking::_getCollectionStatus |
( |
?array |
$a_scos, |
|
|
int |
$a_obj_id, |
|
|
int |
$a_user_id |
|
) |
| |
|
static |
Definition at line 301 of file class.ilObjSCORMTracking.php.
References $DIC, $ilDB, and $res.
Referenced by ilLPStatusSCORM\determineStatus().
304 $ilDB = $DIC->database();
306 $status =
"not_attempted";
308 if (is_array($a_scos)) {
309 $in =
$ilDB->in(
'sco_id', $a_scos,
false,
'integer');
312 'SELECT sco_id, rvalue FROM scorm_tracking 317 array(
'integer',
'text',
'integer'),
318 array($a_obj_id,
'cmi.core.lesson_status', $a_user_id)
325 if ($rec[
"rvalue"] ===
"failed") {
328 if ($rec[
"rvalue"] !==
"completed" && $rec[
"rvalue"] !==
"passed") {
334 $status =
"in_progress";
336 if ($completed && $cnt == count($a_scos)) {
337 $status =
"completed";
◆ _getCompleted()
static ilObjSCORMTracking::_getCompleted |
( |
object |
$scorm_item_id, |
|
|
int |
$a_obj_id |
|
) |
| |
|
static |
like necessary because of Oracle
- Returns
- mixed[]
Definition at line 256 of file class.ilObjSCORMTracking.php.
References $DIC, $ilDB, and $res.
259 $ilDB = $DIC->database();
263 if (is_array($scorm_item_id)) {
264 $in =
$ilDB->in(
'sco_id', $scorm_item_id,
false,
'integer');
267 'SELECT DISTINCT(user_id) FROM scorm_tracking 271 AND (' .
$ilDB->like(
'rvalue',
'clob',
'completed') .
' OR ' .
$ilDB->like(
276 array(
'integer',
'text'),
277 array($a_obj_id,
'cmi.core.lesson_status')
281 'SELECT DISTINCT(user_id) FROM scorm_tracking 285 AND (' .
$ilDB->like(
'rvalue',
'clob',
'completed') .
' OR ' .
$ilDB->like(
290 array(
'integer',
'integer',
'text'),
291 array($scorm_item_id, $a_obj_id,
'cmi.core.lesson_status')
295 while ($row =
$ilDB->fetchObject(
$res)) {
296 $user_ids[] = $row->user_id;
◆ _getCountCompletedPerUser()
static ilObjSCORMTracking::_getCountCompletedPerUser |
( |
array |
$a_scorm_item_ids, |
|
|
int |
$a_obj_id |
|
) |
| |
|
static |
Get users who have status completed or passed.
- Returns
- array<int|string, mixed>
Definition at line 467 of file class.ilObjSCORMTracking.php.
References $DIC, $ilDB, and $res.
Referenced by ilLPStatusSCORM\_getStatusInfo().
470 $ilDB = $DIC->database();
473 $in =
$ilDB->in(
'sco_id', $a_scorm_item_ids,
false,
'integer');
479 SELECT user_id, COUNT(user_id) completed FROM scorm_tracking 483 AND (' .
$ilDB->like(
'rvalue',
'clob',
'completed') .
' OR ' .
$ilDB->like(
'rvalue',
'clob',
'passed') .
') 485 array(
'integer',
'text'),
486 array($a_obj_id,
'cmi.core.lesson_status')
488 while ($row =
$ilDB->fetchObject(
$res)) {
489 $users[$row->user_id] = $row->completed;
◆ _getFailed()
static ilObjSCORMTracking::_getFailed |
( |
object |
$scorm_item_id, |
|
|
int |
$a_obj_id |
|
) |
| |
|
static |
like necessary because of Oracle
- Returns
- mixed[]
Definition at line 425 of file class.ilObjSCORMTracking.php.
References $DIC, $ilDB, and $res.
428 $ilDB = $DIC->database();
431 if (is_array($scorm_item_id)) {
432 $in =
$ilDB->in(
'sco_id', $scorm_item_id,
false,
'integer');
436 SELECT DISTINCT(user_id) FROM scorm_tracking 440 AND ' .
$ilDB->like(
'rvalue',
'clob',
'failed') .
' ',
441 array(
'integer',
'text'),
442 array($a_obj_id,
'cmi.core.lesson_status')
447 SELECT DISTINCT(user_id) FROM scorm_tracking 451 AND ' .
$ilDB->like(
'rvalue',
'clob',
'failed') .
' ',
452 array(
'integer',
'integer',
'text'),
453 array($scorm_item_id, $a_obj_id,
'cmi.core.lesson_status')
457 while ($row =
$ilDB->fetchObject(
$res)) {
458 $user_ids[] = $row->user_id;
◆ _getInProgress()
static ilObjSCORMTracking::_getInProgress |
( |
|
$scorm_item_id, |
|
|
int |
$a_obj_id, |
|
|
?array |
$a_blocked_user_ids = null |
|
) |
| |
|
static |
- Parameters
-
array | int | $scorm_item_id | |
- Returns
- array<int|string, mixed[]>
Definition at line 542 of file class.ilObjSCORMTracking.php.
References $DIC, $ilDB, and $res.
Referenced by _getProgressInfo().
545 $ilDB = $DIC->database();
547 if (is_array($scorm_item_id)) {
548 $in =
$ilDB->in(
'sco_id', $scorm_item_id,
false,
'integer');
551 'SELECT user_id,sco_id FROM scorm_tracking 554 GROUP BY user_id, sco_id',
560 'SELECT user_id,sco_id FROM scorm_tracking 563 array(
'integer',
'integer'),
564 array($scorm_item_id, $a_obj_id)
568 $in_progress = array();
570 while ($row =
$ilDB->fetchObject(
$res)) {
572 if (!($a_blocked_user_ids &&
573 isset($a_blocked_user_ids[$row->sco_id]) &&
574 is_array($a_blocked_user_ids[$row->sco_id]) &&
575 in_array($row->user_id, $a_blocked_user_ids[$row->sco_id]))) {
576 $in_progress[$row->sco_id][] = $row->user_id;
◆ _getProgressInfo()
static ilObjSCORMTracking::_getProgressInfo |
( |
array |
$sco_item_ids, |
|
|
int |
$a_obj_id |
|
) |
| |
|
static |
Get info about.
- Returns
- array<string, mixed[]>
Definition at line 498 of file class.ilObjSCORMTracking.php.
References $DIC, $ilDB, $res, and _getInProgress().
Referenced by ilLPStatusSCORM\_getStatusInfo().
501 $ilDB = $DIC->database();
503 $in =
$ilDB->in(
'sco_id', $sco_item_ids,
false,
'integer');
507 SELECT * FROM scorm_tracking 511 array(
'integer',
'text'),
512 array($a_obj_id,
'cmi.core.lesson_status')
515 $info[
'completed'] = array();
516 $info[
'failed'] = array();
519 while ($row =
$ilDB->fetchObject(
$res)) {
520 switch ($row->rvalue) {
523 $info[
'completed'][$row->sco_id][] = $row->user_id;
524 $user_ids[$row->sco_id][] = $row->user_id;
528 $info[
'failed'][$row->sco_id][] = $row->user_id;
529 $user_ids[$row->sco_id][] = $row->user_id;
static _getInProgress($scorm_item_id, int $a_obj_id, ?array $a_blocked_user_ids=null)
◆ _getTrackedUsers()
static ilObjSCORMTracking::_getTrackedUsers |
( |
int |
$a_obj_id | ) |
|
|
static |
◆ _insertTrackData()
static ilObjSCORMTracking::_insertTrackData |
( |
int |
$a_sahs_id, |
|
|
string |
$a_lval, |
|
|
string |
$a_rval, |
|
|
int |
$a_obj_id |
|
) |
| |
|
static |
Definition at line 231 of file class.ilObjSCORMTracking.php.
References $DIC, $ilDB, $ilUser, ilLPStatusWrapper\_updateStatus(), and ilUtil\now().
Referenced by ilSCORMItem\insertTrackData().
234 $ilDB = $DIC->database();
237 $ilDB->insert(
'scorm_tracking', array(
238 'obj_id' => array(
'integer', $a_obj_id),
239 'user_id' => array(
'integer',
$ilUser->getId()),
240 'sco_id' => array(
'integer', $a_sahs_id),
241 'lvalue' => array(
'text', $a_lval),
242 'rvalue' => array(
'clob', $a_rval),
246 if ($a_lval ===
"cmi.core.lesson_status") {
static now()
Return current timestamp in Y-m-d H:i:s format.
static _updateStatus(int $a_obj_id, int $a_usr_id, ?object $a_obj=null, bool $a_percentage=false, bool $a_force_raise=false)
◆ _syncReadEvent()
static ilObjSCORMTracking::_syncReadEvent |
( |
int |
$a_obj_id, |
|
|
int |
$a_user_id, |
|
|
string |
$a_type, |
|
|
int |
$a_ref_id |
|
) |
| |
|
static |
Definition at line 632 of file class.ilObjSCORMTracking.php.
References $DIC, $ilDB, ilChangeEvent\_recordReadEvent(), ilLoggerFactory\getLogger(), and ILIAS\Repository\int().
Referenced by scorm12PlayerUnload().
635 $ilDB = $DIC->database();
637 $val_set =
$ilDB->queryF(
638 'SELECT package_attempts, total_time_sec, sco_total_time_sec, time_from_lms FROM sahs_user, sahs_lm ' 639 .
'WHERE sahs_user.obj_id = %s AND sahs_user.user_id = %s AND sahs_user.obj_id = sahs_lm.id',
640 array(
'integer',
'integer'),
641 array($a_obj_id, $a_user_id)
644 $val_rec =
$ilDB->fetchAssoc($val_set);
646 if ($val_rec[
"package_attempts"] == null) {
647 $val_rec[
"package_attempts"] =
"";
649 $attempts = $val_rec[
"package_attempts"];
651 $time = (
int) $val_rec[
"sco_total_time_sec"];
655 $sco_set =
$ilDB->queryF(
657 SELECT sco_id, rvalue FROM scorm_tracking 662 array(
'integer',
'integer',
'text',
'integer'),
663 array($a_obj_id, $a_user_id,
'cmi.core.total_time', 0)
666 while ($sco_rec =
$ilDB->fetchAssoc($sco_set)) {
667 $tarr = explode(
":", $sco_rec[
"rvalue"]);
668 $sec = (
int) $tarr[2] + (
int) $tarr[1] * 60 +
669 (
int) substr($tarr[0], strlen($tarr[0]) - 3) * 60 * 60;
static getLogger(string $a_component_id)
Get component logger.
static _recordReadEvent(string $a_type, int $a_ref_id, int $obj_id, int $usr_id, bool $isCatchupWriteEvents=true, $a_ext_rc=null, $a_ext_time=null)
◆ checkIfAllowed()
static ilObjSCORMTracking::checkIfAllowed |
( |
int |
$packageId, |
|
|
int |
$userId, |
|
|
int |
$hash |
|
) |
| |
|
static |
Definition at line 616 of file class.ilObjSCORMTracking.php.
References $DIC, $ilDB, and $res.
619 $ilDB = $DIC->database();
621 'select hash from sahs_user where obj_id=%s AND user_id=%s AND hash_end>%s',
622 array(
'integer',
'integer',
'timestamp'),
623 array(
$packageId, $userId, date(
'Y-m-d H:i:s'))
626 if (! ($rowtmp && $rowtmp[
'hash'] == $hash)) {
◆ lookupLastAccessTimes()
static ilObjSCORMTracking::lookupLastAccessTimes |
( |
int |
$a_obj_id | ) |
|
|
static |
◆ scorm12PlayerUnload()
static ilObjSCORMTracking::scorm12PlayerUnload |
( |
| ) |
|
|
static |
Definition at line 582 of file class.ilObjSCORMTracking.php.
References $DIC, $GLOBALS, $ilDB, $ref_id, and _syncReadEvent().
585 $ilDB = $DIC->database();
586 $user_id = $DIC->http()->wrapper()->query()->retrieve(
'p', $DIC->refinery()->kindlyTo()->int());
587 $ref_id = $DIC->http()->wrapper()->query()->retrieve(
'ref_id', $DIC->refinery()->kindlyTo()->int());
588 $obj_id = $DIC->http()->wrapper()->query()->retrieve(
'package_id', $DIC->refinery()->kindlyTo()->int());
590 $GLOBALS[
'DIC'][
'ilLog']->write(__METHOD__ .
' no valid obj_id');
593 if ($DIC->http()->wrapper()->query()->has(
'last_visited')) {
594 $last_visited = $DIC->http()->wrapper()->query()->retrieve(
'last_visited', $DIC->refinery()->kindlyTo()->string());
599 mktime((
int) date(
'H'), (
int) date(
'i') + 5, (
int) date(
's'), (
int) date(
'm'), (
int) date(
'd'), (
int) date(
'Y'))
603 SET last_visited = %s, hash_end =%s, last_access = %s 604 WHERE obj_id = %s AND user_id = %s',
605 array(
'text',
'timestamp',
'timestamp',
'integer',
'integer'),
606 array($last_visited, $endDate, date(
'Y-m-d H:i:s'), $obj_id, $user_id)
612 header(
'Content-Type: text/plain; charset=UTF-8');
if(!defined('PATH_SEPARATOR')) $GLOBALS['_PEAR_default_error_mode']
static _syncReadEvent(int $a_obj_id, int $a_user_id, string $a_type, int $a_ref_id)
◆ storeJsApi()
static ilObjSCORMTracking::storeJsApi |
( |
| ) |
|
|
static |
Definition at line 28 of file class.ilObjSCORMTracking.php.
References $data, $DIC, $refId, and ILIAS\Repository\int().
31 $obj_id = $DIC->http()->wrapper()->query()->retrieve(
'package_id', $DIC->refinery()->kindlyTo()->int());
32 $refId = $DIC->http()->wrapper()->query()->retrieve(
'ref_id', $DIC->refinery()->kindlyTo()->int());
33 $in = file_get_contents(
"php://input");
34 $data = json_decode($in);
37 header(
'Content-Type: text/plain; charset=UTF-8');
39 $rval = self::storeJsApiCmi($user_id, $obj_id,
$data);
41 print(
"storeJsApiCmi failed");
43 $rval = self::syncGlobalStatus($user_id, $obj_id,
$refId,
$data,
$data->now_global_status);
45 print(
"syncGlobalStatus failed");
◆ storeJsApiCmi()
static ilObjSCORMTracking::storeJsApiCmi |
( |
int |
$user_id, |
|
|
int |
$obj_id, |
|
|
object |
$data |
|
) |
| |
|
static |
Definition at line 53 of file class.ilObjSCORMTracking.php.
References $DIC, $ilDB, ilSCORMObject\_lookupPresentableItems(), ilLoggerFactory\getLogger(), ilLTIAppEventListener\handleOutcomeWithoutLP(), and ilUtil\now().
57 $ilDB = $DIC->database();
59 $b_updateStatus =
false;
69 foreach (
$data->cmi as $value) {
70 $aa_data[] = array(
"sco_id" => (
int) $value[0],
78 $ilLog->write(
"ScormAicc: storeJsApi: Error: No valid obj_id given.");
80 foreach ($aa_data as $a_data) {
83 SELECT rvalue FROM scorm_tracking 88 array(
'integer',
'integer',
'text',
'integer'),
89 array($user_id, $a_data[
"sco_id"], $a_data[
"left"], $obj_id)
91 if ($rec =
$ilDB->fetchAssoc($set)) {
92 if ($a_data[
"left"] ===
'cmi.core.lesson_status' && $a_data[
"right"] != $rec[
"rvalue"]) {
93 $b_updateStatus =
true;
98 'rvalue' => array(
'clob', $a_data[
"right"]),
102 'user_id' => array(
'integer', $user_id),
103 'sco_id' => array(
'integer', $a_data[
"sco_id"]),
104 'lvalue' => array(
'text', $a_data[
"left"]),
105 'obj_id' => array(
'integer', $obj_id)
108 $ilLog->debug(
"ScormAicc: storeJsApi Updated - L:" . $a_data[
"left"] .
",R:" .
109 $a_data[
"right"] .
" for obj_id:" . $obj_id .
",sco_id:" . $a_data[
"sco_id"] .
",user_id:" . $user_id);
111 if ($a_data[
"left"] ===
'cmi.core.lesson_status') {
112 $b_updateStatus =
true;
114 $ilDB->insert(
'scorm_tracking', array(
115 'obj_id' => array(
'integer', $obj_id),
116 'user_id' => array(
'integer', $user_id),
117 'sco_id' => array(
'integer', $a_data[
"sco_id"]),
118 'lvalue' => array(
'text', $a_data[
"left"]),
119 'rvalue' => array(
'clob', $a_data[
"right"]),
122 $ilLog->debug(
"ScormAicc: storeJsApi Inserted - L:" . $a_data[
"left"] .
",R:" .
123 $a_data[
"right"] .
" for obj_id:" . $obj_id .
",sco_id:" . $a_data[
"sco_id"] .
",user_id:" . $user_id);
125 if ($a_data[
"left"] ===
'cmi.core.score.max') {
126 $i_score_max = $a_data[
"right"];
128 if ($a_data[
"left"] ===
'cmi.core.score.raw') {
129 $i_score_raw = $a_data[
"right"];
133 if ($i_score_max > 0 && $i_score_raw > 0) {
138 ($i_score_raw / $i_score_max) * 100
static getLogger(string $a_component_id)
Get component logger.
static _lookupPresentableItems(int $a_slm_id)
Count number of presentable SCOs/Assets of SCORM learning module.
static now()
Return current timestamp in Y-m-d H:i:s format.
static handleOutcomeWithoutLP(int $a_obj_id, int $a_usr_id, ?float $a_percentage)
◆ syncGlobalStatus()
static ilObjSCORMTracking::syncGlobalStatus |
( |
int |
$userId, |
|
|
int |
$packageId, |
|
|
int |
$refId, |
|
|
object |
$data, |
|
|
?int |
$new_global_status |
|
) |
| |
|
static |
Definition at line 153 of file class.ilObjSCORMTracking.php.
References $DIC, $ilDB, ilChangeEvent\_recordReadEvent(), ilLoggerFactory\getLogger(), ILIAS\Repository\int(), and ilLPStatus\writeStatus().
156 $ilDB = $DIC->database();
158 $saved_global_status =
$data->saved_global_status;
159 $ilLog->write(
"saved_global_status=" . $saved_global_status);
162 if (!isset(
$data->packageAttempts)) {
163 $val_set =
$ilDB->queryF(
164 'SELECT package_attempts FROM sahs_user WHERE obj_id = %s AND user_id = %s',
165 array(
'integer',
'integer'),
168 $val_rec =
$ilDB->fetchAssoc($val_set);
169 $attempts = $val_rec[
"package_attempts"];
171 $attempts =
$data->packageAttempts;
173 if ($attempts == null) {
178 $totalTime = (
int)
$data->totalTimeCentisec;
179 $totalTime = round($totalTime / 100);
181 'UPDATE sahs_user SET last_visited=%s, last_access = %s, sco_total_time_sec=%s, status=%s, percentage_completed=%s, package_attempts=%s WHERE obj_id = %s AND user_id = %s',
182 array(
'text',
'timestamp',
'integer',
'integer',
'integer',
'integer',
'integer',
'integer'),
183 array(
$data->last_visited,
187 $data->percentageCompleted,
196 $ilObjDataCache = $DIC[
'ilObjDataCache'];
223 if ($new_global_status != null) {
static getLogger(string $a_component_id)
Get component logger.
static _recordReadEvent(string $a_type, int $a_ref_id, int $obj_id, int $usr_id, bool $isCatchupWriteEvents=true, $a_ext_rc=null, $a_ext_time=null)
static writeStatus(int $a_obj_id, int $a_user_id, int $a_status, int $a_percentage=0, bool $a_force_per=false, ?int &$a_old_status=self::LP_STATUS_NOT_ATTEMPTED_NUM)
Write status for user and object.
The documentation for this class was generated from the following file: