ilAssQuestionPreviewHintTracking Class Reference

Collaboration diagram for ilAssQuestionPreviewHintTracking:

Public Member Functions
	__construct (ilDBInterface $db, ilAssQuestionPreviewSession $previewSession)
	requestsExist ()
	requestsPossible ()
	getNextRequestableHint ()
	storeRequest (ilAssQuestionHint $questionHint)
	isRequested ($hintId)
	getNumExistingRequests ()
	getRequestedHintsList ()
	getRequestStatisticData ()

Private Attributes
	$db
	$previewSession

Detailed Description

Definition at line 11 of file class.ilAssQuestionPreviewHintTracking.php.

Constructor & Destructor Documentation

__construct()

ilAssQuestionPreviewHintTracking::__construct	(	ilDBInterface	$db,
		ilAssQuestionPreviewSession	$previewSession
	)

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

References $db, and $previewSession.

    {
        $this->db = $db;
        $this->previewSession = $previewSession;
    }

Member Function Documentation

getNextRequestableHint()

ilAssQuestionPreviewHintTracking::getNextRequestableHint

(

)

Definition at line 59 of file class.ilAssQuestionPreviewHintTracking.php.

References $query, $res, $row, ilAssQuestionHint\getInstanceById(), and isRequested().

    {
        $query = "
                        SELECT          qht_hint_id
                        
                        FROM            qpl_hints
                        
                        WHERE           qht_question_fi = %s
                        
                        ORDER BY        qht_hint_index ASC
                ";

        $res = $this->db->queryF(
            $query,
            array('integer'),
            array($this->previewSession->getQuestionId())
        );

        while ($row = $this->db->fetchAssoc($res)) {
            if (!$this->isRequested($row['qht_hint_id'])) {
                return ilAssQuestionHint::getInstanceById($row['qht_hint_id']);
            }
        }

        throw new ilTestException(
            "no next hint found for questionId={$this->previewSession->getQuestionId()}, userId={$this->previewSession->getUserId()}"
        );
    }

Here is the call graph for this function:

getNumExistingRequests()

ilAssQuestionPreviewHintTracking::getNumExistingRequests

(

)

Definition at line 98 of file class.ilAssQuestionPreviewHintTracking.php.

    {
        return $this->previewSession->getNumRequestedHints();
    }

getRequestedHintsList()

ilAssQuestionPreviewHintTracking::getRequestedHintsList

(

)

Definition at line 103 of file class.ilAssQuestionPreviewHintTracking.php.

References ilAssQuestionHintList\getListByHintIds().

Referenced by getRequestStatisticData().

    {
        $hintIds = $this->previewSession->getRequestedHints();

        $requestedHintsList = ilAssQuestionHintList::getListByHintIds($hintIds);

        return $requestedHintsList;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getRequestStatisticData()

ilAssQuestionPreviewHintTracking::getRequestStatisticData

(

)

Definition at line 112 of file class.ilAssQuestionPreviewHintTracking.php.

References getRequestedHintsList().

Referenced by assQuestion\deductHintPointsFromReachedPoints().

    {
        $count = 0;
        $points = 0;
        
        foreach ($this->getRequestedHintsList() as $hint) {
            $count++;
            $points += $hint->getPoints();
        }
        
        $requestsStatisticData = new ilAssQuestionHintRequestStatisticData();
        $requestsStatisticData->setRequestsCount($count);
        $requestsStatisticData->setRequestsPoints($points);
        
        return $requestsStatisticData;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

isRequested()

ilAssQuestionPreviewHintTracking::isRequested

(

$hintId

)

Definition at line 93 of file class.ilAssQuestionPreviewHintTracking.php.

Referenced by getNextRequestableHint().

    {
        return $this->previewSession->isHintRequested($hintId);
    }

Here is the caller graph for this function:

requestsExist()

ilAssQuestionPreviewHintTracking::requestsExist

(

)

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

    {
        return (
            $this->previewSession->getNumRequestedHints() > 0
        );
    }

requestsPossible()

ilAssQuestionPreviewHintTracking::requestsPossible

(

)

Definition at line 36 of file class.ilAssQuestionPreviewHintTracking.php.

References $query, $res, and $row.

    {
        $query = "
                        SELECT          COUNT(qht_hint_id) cnt_available
                        FROM            qpl_hints
                        WHERE           qht_question_fi = %s
                ";

        $res = $this->db->queryF(
            $query,
            array('integer'),
            array($this->previewSession->getQuestionId())
        );

        $row = $this->db->fetchAssoc($res);

        if ($row['cnt_available'] > $this->previewSession->getNumRequestedHints()) {
            return true;
        }

        return false;
    }

storeRequest()

ilAssQuestionPreviewHintTracking::storeRequest

(

ilAssQuestionHint

$questionHint

)

Definition at line 88 of file class.ilAssQuestionPreviewHintTracking.php.

References ilAssQuestionHint\getId().

    {
        $this->previewSession->addRequestedHint($questionHint->getId());
    }

Here is the call graph for this function:

Field Documentation

$db

ilAssQuestionPreviewHintTracking::$db

private

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

Referenced by __construct().

$previewSession

ilAssQuestionPreviewHintTracking::$previewSession

private

Definition at line 21 of file class.ilAssQuestionPreviewHintTracking.php.

Referenced by __construct().

---

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

• Modules/TestQuestionPool/classes/class.ilAssQuestionPreviewHintTracking.php