ILIAS\Tracking\View\DataRetrieval\DataRetrieval Class Reference

Inheritance diagram for ILIAS\Tracking\View\DataRetrieval\DataRetrieval:

Collaboration diagram for ILIAS\Tracking\View\DataRetrieval\DataRetrieval:

Public Member Functions
	__construct (protected ilDBInterface $db, protected InfoFactoryInterface $info_factory)
	retrieveViewInfo (FilterInterface $filter)

Protected Member Functions
	collectLPDataWithIlTryQuery (array $user_obj_id_mappings, bool $only_data_of_objects_with_lp_enabled=true)
	isPercentageAvailable (int $lp_mode)

Protected Attributes
const	KEY_OBJ_ID = "obj_id"
const	KEY_USR_ID = "usr_id"
const	KEY_OBJ_TITLE = "title"
const	KEY_OBJ_DESCRIPTION = "description"
const	KEY_OBJ_TYPE = "type"
const	KEY_LP_STATUS = "status"
const	KEY_LP_MODE = "lp_mode"
const	KEY_LP_SPENT_SECONDS = "spent_seconds"
const	KEY_LP_VISITS = "visits"
const	KEY_LP_READ_COUNT = "read_count"
const	KEY_LP_PERCENTAGE = "percentage"
const	KEY_LP_STATUS_CHANGED = "status_changed"

Detailed Description

Definition at line 36 of file DataRetrieval.php.

Constructor & Destructor Documentation

__construct()

ILIAS\Tracking\View\DataRetrieval\DataRetrieval::__construct	(	protected ilDBInterface	$db,
		protected InfoFactoryInterface	$info_factory
	)

Definition at line 51 of file DataRetrieval.php.

      {
    }

Member Function Documentation

collectLPDataWithIlTryQuery()

ILIAS\Tracking\View\DataRetrieval\DataRetrieval::collectLPDataWithIlTryQuery ( array  $user_obj_id_mappings, bool  $only_data_of_objects_with_lp_enabled = true  )

protected

Definition at line 126 of file DataRetrieval.php.

References $data, ilTrQuery\getObjectivesStatusForUser(), ilTrQuery\getObjectsStatusForUser(), ilTrQuery\getSCOsStatusForUser(), ilTrQuery\getSubItemsStatusForUser(), ilLPObjSettings\LP_MODE_COLLECTION_MANUAL, ilLPObjSettings\LP_MODE_COLLECTION_MOBS, ilLPObjSettings\LP_MODE_COLLECTION_TLT, ilLPObjSettings\LP_MODE_DEACTIVATED, ilLPObjSettings\LP_MODE_OBJECTIVES, ilLPObjSettings\LP_MODE_SCORM, and ilLPObjSettings\LP_MODE_UNDEFINED.

Referenced by ILIAS\Tracking\View\DataRetrieval\DataRetrieval\retrieveViewInfo().

     : array {
        $data = [];
        foreach ($user_obj_id_mappings as $usr_id => $mode_mapping) {
            foreach ($mode_mapping as $lp_mode => $obj_ids) {
                $obj_ids = array_flip($obj_ids);
                $new_data = [];
                switch ($lp_mode) {
                    case ilLPObjSettings::LP_MODE_SCORM:
                        $new_data = ilTrQuery::getSCOsStatusForUser(
                            $usr_id,
                            0,
                            $obj_ids
                        );
                        break;
                    case ilLPObjSettings::LP_MODE_OBJECTIVES:
                        $new_data = ilTrQuery::getObjectivesStatusForUser(
                            $usr_id,
                            0,
                            $obj_ids
                        );
                        break;
                    case ilLPObjSettings::LP_MODE_COLLECTION_MANUAL:
                    case ilLPObjSettings::LP_MODE_COLLECTION_TLT:
                    case ilLPObjSettings::LP_MODE_COLLECTION_MOBS:
                        if ($usr_id) {
                            $data = ilTrQuery::getSubItemsStatusForUser(
                                $usr_id,
                                0,
                                $obj_ids
                            );
                        }
                        break;
                    case ilLPObjSettings::LP_MODE_UNDEFINED:
                    case ilLPObjSettings::LP_MODE_DEACTIVATED:
                        if ($only_data_of_objects_with_lp_enabled) {
                            break;
                        }
                        // no break
                    default:
                        $new_data = ilTrQuery::getObjectsStatusForUser(
                            $usr_id,
                            $obj_ids
                        );
                        break;
                }
                foreach ($new_data as $new) {
                    $new[self::KEY_LP_MODE] = $lp_mode;
                    $new[self::KEY_USR_ID] = $usr_id;
                    $data[] = $new;
                }
            }
        }
        return $data;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

isPercentageAvailable()

ILIAS\Tracking\View\DataRetrieval\DataRetrieval::isPercentageAvailable ( int  $lp_mode )

protected

Definition at line 184 of file DataRetrieval.php.

References ilLPObjSettings\LP_MODE_CMIX_COMPL_OR_PASSED_WITH_FAILED, ilLPObjSettings\LP_MODE_CMIX_COMPL_WITH_FAILED, ilLPObjSettings\LP_MODE_CMIX_COMPLETED, ilLPObjSettings\LP_MODE_CMIX_COMPLETED_OR_PASSED, ilLPObjSettings\LP_MODE_CMIX_PASSED, ilLPObjSettings\LP_MODE_CMIX_PASSED_WITH_FAILED, ilLPObjSettings\LP_MODE_COLLECTION, ilLPObjSettings\LP_MODE_LTI_OUTCOME, ilLPObjSettings\LP_MODE_SCORM, ilLPObjSettings\LP_MODE_TEST_PASSED, ilLPObjSettings\LP_MODE_TLT, ilLPObjSettings\LP_MODE_VISITED_PAGES, and ilLPObjSettings\LP_MODE_VISITS.

Referenced by ILIAS\Tracking\View\DataRetrieval\DataRetrieval\retrieveViewInfo().

     : bool {
        if (in_array(
            $lp_mode,
            [
                ilLPObjSettings::LP_MODE_TLT,
                ilLPObjSettings::LP_MODE_VISITS,
                ilLPObjSettings::LP_MODE_SCORM,
                ilLPObjSettings::LP_MODE_LTI_OUTCOME,
                ilLPObjSettings::LP_MODE_CMIX_COMPLETED,
                ilLPObjSettings::LP_MODE_CMIX_COMPL_WITH_FAILED,
                ilLPObjSettings::LP_MODE_CMIX_PASSED,
                ilLPObjSettings::LP_MODE_CMIX_PASSED_WITH_FAILED,
                ilLPObjSettings::LP_MODE_CMIX_COMPLETED_OR_PASSED,
                ilLPObjSettings::LP_MODE_CMIX_COMPL_OR_PASSED_WITH_FAILED,
                ilLPObjSettings::LP_MODE_VISITED_PAGES,
                ilLPObjSettings::LP_MODE_TEST_PASSED,
                ilLPObjSettings::LP_MODE_COLLECTION
            ]
        )) {
            return true;
        }
        return false;
    }

Here is the caller graph for this function:

retrieveViewInfo()

ILIAS\Tracking\View\DataRetrieval\DataRetrieval::retrieveViewInfo

(

FilterInterface

$filter

)

Implements ILIAS\Tracking\View\DataRetrieval\DataRetrievalInterface.

Definition at line 57 of file DataRetrieval.php.

References $data, ilObject\_lookupDescription(), ILIAS\Tracking\View\DataRetrieval\DataRetrieval\collectLPDataWithIlTryQuery(), ILIAS\Tracking\View\DataRetrieval\FilterInterface\collectOnlyDataOfObjectsWithLPEnabled(), ilObjectLP\getInstance(), ILIAS\Tracking\View\DataRetrieval\FilterInterface\getObjectIds(), ILIAS\Tracking\View\DataRetrieval\FilterInterface\getUserIds(), IL_CAL_DATETIME, ILIAS\Repository\int(), and ILIAS\Tracking\View\DataRetrieval\DataRetrieval\isPercentageAvailable().

     : ViewInterface {
        $object_ids = $filter->getObjectIds();
        $user_ids = $filter->getUserIds();

        $user_obj_id_mappings = [];
        foreach ($user_ids as $usr_id) {
            foreach ($object_ids as $obj_id) {
                $olp = ilObjectLP::getInstance($obj_id);
                $lp_mode = $olp->getCurrentMode();
                $user_obj_id_mappings[$usr_id][$lp_mode][] = $obj_id;
            }
        }

        $data = $this->collectLPDataWithIlTryQuery(
            $user_obj_id_mappings,
            $filter->collectOnlyDataOfObjectsWithLPEnabled()
        );

        $object_infos = [];
        $lp_infos = [];
        $combined_infos = [];
        foreach ($data as $entry) {
            $obj_id = (int) $entry[self::KEY_OBJ_ID];
            $usr_id = (int) $entry[self::KEY_USR_ID];
            $obj_title = (string) $entry[self::KEY_OBJ_TITLE];
            $percentage = (int) $entry[self::KEY_LP_PERCENTAGE];
            $obj_description = ilObject::_lookupDescription($obj_id);
            $lp_status = (int) $entry[self::KEY_LP_STATUS];
            $obj_type = (string) $entry[self::KEY_OBJ_TYPE];
            $lp_mode = (int) $entry[self::KEY_LP_MODE];
            $spent_seconds = (int) $entry[self::KEY_LP_SPENT_SECONDS];
            $status_changed = new ilDateTime($entry[self::KEY_LP_STATUS_CHANGED], IL_CAL_DATETIME);
            $visits = (int) $entry[self::KEY_LP_VISITS];
            $read_count = (int) $entry[self::KEY_LP_READ_COUNT];
            $lp_info = $this->info_factory->lp(
                $usr_id,
                $obj_id,
                $lp_status,
                $percentage,
                $lp_mode,
                $spent_seconds,
                $status_changed,
                $visits,
                $read_count,
                $this->isPercentageAvailable($lp_mode)
            );
            $object_info = $this->info_factory->objectData(
                $obj_id,
                $obj_title,
                $obj_description,
                $obj_type,
            );
            $lp_infos[] = $lp_info;
            $object_infos[] = $object_info;
            $combined_infos[] = $this->info_factory->combined(
                $lp_info,
                $object_info
            );
        }

        return $this->info_factory->view(
            $this->info_factory->iterator()->objectData(...$object_infos),
            $this->info_factory->iterator()->lp(...$lp_infos),
            $this->info_factory->iterator()->combined(...$combined_infos)
        );
    }

Here is the call graph for this function:

Field Documentation

KEY_LP_MODE

const ILIAS\Tracking\View\DataRetrieval\DataRetrieval::KEY_LP_MODE = "lp_mode"

protected

Definition at line 44 of file DataRetrieval.php.

KEY_LP_PERCENTAGE

const ILIAS\Tracking\View\DataRetrieval\DataRetrieval::KEY_LP_PERCENTAGE = "percentage"

protected

Definition at line 48 of file DataRetrieval.php.

KEY_LP_READ_COUNT

const ILIAS\Tracking\View\DataRetrieval\DataRetrieval::KEY_LP_READ_COUNT = "read_count"

protected

Definition at line 47 of file DataRetrieval.php.

KEY_LP_SPENT_SECONDS

const ILIAS\Tracking\View\DataRetrieval\DataRetrieval::KEY_LP_SPENT_SECONDS = "spent_seconds"

protected

Definition at line 45 of file DataRetrieval.php.

KEY_LP_STATUS

const ILIAS\Tracking\View\DataRetrieval\DataRetrieval::KEY_LP_STATUS = "status"

protected

Definition at line 43 of file DataRetrieval.php.

KEY_LP_STATUS_CHANGED

const ILIAS\Tracking\View\DataRetrieval\DataRetrieval::KEY_LP_STATUS_CHANGED = "status_changed"

protected

Definition at line 49 of file DataRetrieval.php.

KEY_LP_VISITS

const ILIAS\Tracking\View\DataRetrieval\DataRetrieval::KEY_LP_VISITS = "visits"

protected

Definition at line 46 of file DataRetrieval.php.

KEY_OBJ_DESCRIPTION

const ILIAS\Tracking\View\DataRetrieval\DataRetrieval::KEY_OBJ_DESCRIPTION = "description"

protected

Definition at line 41 of file DataRetrieval.php.

KEY_OBJ_ID

const ILIAS\Tracking\View\DataRetrieval\DataRetrieval::KEY_OBJ_ID = "obj_id"

protected

Definition at line 38 of file DataRetrieval.php.

KEY_OBJ_TITLE

const ILIAS\Tracking\View\DataRetrieval\DataRetrieval::KEY_OBJ_TITLE = "title"

protected

Definition at line 40 of file DataRetrieval.php.

KEY_OBJ_TYPE

const ILIAS\Tracking\View\DataRetrieval\DataRetrieval::KEY_OBJ_TYPE = "type"

protected

Definition at line 42 of file DataRetrieval.php.

KEY_USR_ID

const ILIAS\Tracking\View\DataRetrieval\DataRetrieval::KEY_USR_ID = "usr_id"

protected

Definition at line 39 of file DataRetrieval.php.

---

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

• components/ILIAS/Tracking/classes/View/DataRetrieval/DataRetrieval.php