ilTestService Class Reference

Service class for tests. More...

Collaboration diagram for ilTestService:

Public Member Functions
	__construct (ilObjTest $a_object)
	@access public More...
	getPassOverviewData ($active_id, $short=false)
	@access public @global ilObjUser $ilUser More...
	getManScoringQuestionGuiList ($activeId, $pass)
	Returns the list of answers of a users test pass and offers a scoring option. More...
	buildVirtualSequence (ilTestSession $testSession)
	getVirtualSequenceUserResults (ilTestVirtualSequence $virtualSequence)
	getQuestionSummaryData (ilTestSequenceSummaryProvider $testSequence, $obligationsFilterEnabled)

Static Public Member Functions
static	isManScoringDone ($activeId)
	reads the flag wether manscoring is done for the given test active or not from the global settings (scope: assessment / key: manscoring_done_<activeId>) More...
static	setManScoringDone ($activeId, $manScoringDone)
	stores the flag wether manscoring is done for the given test active or not within the global settings (scope: assessment / key: manscoring_done_<activeId>) More...

Protected Attributes
	$object = null

Detailed Description

Service class for tests.

Author

Björn Heyser bheys.nosp@m.er@d.nosp@m.ataba.nosp@m.y.de

Version

$Id$

Definition at line 12 of file class.ilTestService.php.

Constructor & Destructor Documentation

__construct()

ilTestService::__construct

(

ilObjTest

$a_object

)

@access public

Parameters

ilObjTest

$a_object

Definition at line 24 of file class.ilTestService.php.

    {
        $this->object = $a_object;
    }

Member Function Documentation

buildVirtualSequence()

ilTestService::buildVirtualSequence

(

ilTestSession

$testSession

)

Definition at line 180 of file class.ilTestService.php.

    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
        $lng = $DIC['lng'];
        $refinery = $DIC['refinery'];
        $ilPluginAdmin = $DIC['ilPluginAdmin'];
 
        require_once 'Modules/Test/classes/class.ilTestVirtualSequence.php';
        $testSequenceFactory = new ilTestSequenceFactory($ilDB, $lng, $refinery, $ilPluginAdmin, $this->object);
 
        if ($this->object->isRandomTest()) {
            require_once 'Modules/Test/classes/class.ilTestVirtualSequenceRandomQuestionSet.php';
            $virtualSequence = new ilTestVirtualSequenceRandomQuestionSet($ilDB, $this->object, $testSequenceFactory);
        } else {
            require_once 'Modules/Test/classes/class.ilTestVirtualSequence.php';
            $virtualSequence = new ilTestVirtualSequence($ilDB, $this->object, $testSequenceFactory);
        }
 
        $virtualSequence->setActiveId($testSession->getActiveId());
 
        $virtualSequence->init();
 
        return $virtualSequence;
    }

References $DIC, $ilDB, $lng, and ilTestSession\getActiveId().

Here is the call graph for this function:

getManScoringQuestionGuiList()

ilTestService::getManScoringQuestionGuiList	(		$activeId,
			$pass
	)

Returns the list of answers of a users test pass and offers a scoring option.

@access public

Parameters

integer	$active_id	Active ID of the active user
integer	$pass	Test pass

Returns

string HTML code of the list of answers

Definition at line 120 of file class.ilTestService.php.

    {
        include_once "./Modules/Test/classes/class.ilObjAssessmentFolder.php";
        $manScoringQuestionTypes = ilObjAssessmentFolder::_getManualScoring();
 
        $testResultData = $this->object->getTestResult($activeId, $pass);
 
        $manScoringQuestionGuiList = array();
 
        foreach ($testResultData as $questionData) {
            if (!isset($questionData['qid'])) {
                continue;
            }
 
            if (!isset($questionData['type'])) {
                throw new ilTestException('no question type given!');
            }
 
            $questionGUI = $this->object->createQuestionGUI("", $questionData['qid']);
 
            if (!in_array($questionGUI->object->getQuestionTypeID(), $manScoringQuestionTypes)) {
                continue;
            }
 
            $manScoringQuestionGuiList[ $questionData['qid'] ] = $questionGUI;
        }
 
        return $manScoringQuestionGuiList;
    }

References $pass, and ilObjAssessmentFolder\_getManualScoring().

Here is the call graph for this function:

getPassOverviewData()

ilTestService::getPassOverviewData	(		$active_id,
			$short = false
	)

@access public @global ilObjUser $ilUser

Parameters

integer	$active_id
boolean	$short

Returns

array $passOverwiewData

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

    {
        $passOverwiewData = array();
 
        global $DIC;
        $ilUser = $DIC['ilUser'];
 
        $scoredPass = $this->object->_getResultPass($active_id);
        $lastPass = ilObjTest::_getPass($active_id);
 
        $testPercentage = 0;
        $testReachedPoints = 0;
        $testMaxPoints = 0;
 
        for ($pass = 0; $pass <= $lastPass; $pass++) {
            $passFinishDate = ilObjTest::lookupPassResultsUpdateTimestamp($active_id, $pass);
 
            if ($passFinishDate <= 0) {
                continue;
            }
 
            if (!$short) {
                $resultData = &$this->object->getTestResult($active_id, $pass);
 
                if (!$resultData["pass"]["total_max_points"]) {
                    $passPercentage = 0;
                } else {
                    $passPercentage = ($resultData["pass"]["total_reached_points"] / $resultData["pass"]["total_max_points"]) * 100;
                }
 
                $passMaxPoints = $resultData["pass"]["total_max_points"];
                $passReachedPoints = $resultData["pass"]["total_reached_points"];
 
                $passAnsweredQuestions = $this->object->getAnsweredQuestionCount($active_id, $pass);
                $passTotalQuestions = count($resultData) - 2;
 
                if ($pass == $scoredPass) {
                    $isScoredPass = true;
 
                    if (!$resultData["test"]["total_max_points"]) {
                        $testPercentage = 0;
                    } else {
                        $testPercentage = ($resultData["test"]["total_reached_points"] / $resultData["test"]["total_max_points"]) * 100;
                    }
 
                    $testMaxPoints = $resultData["test"]["total_max_points"];
                    $testReachedPoints = $resultData["test"]["total_reached_points"];
 
                    $passOverwiewData['test'] = array(
                        'active_id' => $active_id,
                        'scored_pass' => $scoredPass,
                        'max_points' => $testMaxPoints,
                        'reached_points' => $testReachedPoints,
                        'percentage' => $testPercentage
                    );
                } else {
                    $isScoredPass = false;
                }
 
                $passOverwiewData['passes'][] = array(
                    'active_id' => $active_id,
                    'pass' => $pass,
                    'finishdate' => $passFinishDate,
                    'max_points' => $passMaxPoints,
                    'reached_points' => $passReachedPoints,
                    'percentage' => $passPercentage,
                    'answered_questions' => $passAnsweredQuestions,
                    'total_questions' => $passTotalQuestions,
                    'is_scored_pass' => $isScoredPass
                );
            }
        }
 
        return $passOverwiewData;
    }

References $DIC, $ilUser, $pass, ilObjTest\_getPass(), and ilObjTest\lookupPassResultsUpdateTimestamp().

Here is the call graph for this function:

getQuestionSummaryData()

ilTestService::getQuestionSummaryData	(	ilTestSequenceSummaryProvider	$testSequence,
			$obligationsFilterEnabled
	)

Parameters

ilTestSequenceSummaryProvider	$testSequence
bool	$obligationsFilter

Returns

array

Definition at line 246 of file class.ilTestService.php.

    {
        $result_array = $testSequence->getSequenceSummary($obligationsFilterEnabled);
 
        $marked_questions = array();
 
        if ($this->object->getShowMarker()) {
            include_once "./Modules/Test/classes/class.ilObjTest.php";
            $marked_questions = ilObjTest::_getSolvedQuestions($testSequence->getActiveId());
        }
 
        $data = array();
        $firstQuestion = true;
 
        foreach ($result_array as $key => $value) {
            $disableLink = (
                $this->object->isFollowupQuestionAnswerFixationEnabled()
                && !$value['presented'] && !$firstQuestion
            );
 
            $description = "";
            if ($this->object->getListOfQuestionsDescription()) {
                $description = $value["description"];
            }
 
            $points = "";
            if (!$this->object->getTitleOutput()) {
                $points = $value["points"];
            }
 
            $marked = false;
            if (count($marked_questions)) {
                if (array_key_exists($value["qid"], $marked_questions)) {
                    $obj = $marked_questions[$value["qid"]];
                    if ($obj["solved"] == 1) {
                        $marked = true;
                    }
                }
            }
 
            // fau: testNav - add number parameter for getQuestionTitle()
            $data[] = array(
                'order' => $value["nr"],
                'title' => $this->object->getQuestionTitle($value["title"], $value["nr"]),
                'description' => $description,
                'disabled' => $disableLink,
                'worked_through' => $value["worked_through"],
                'postponed' => $value["postponed"],
                'points' => $points,
                'marked' => $marked,
                'sequence' => $value["sequence"],
                'obligatory' => $value['obligatory'],
                'isAnswered' => $value['isAnswered']
            );
 
            $firstQuestion = false;
            // fau.
        }
 
        return $data;
    }

References $data, ilObjTest\_getSolvedQuestions(), ilTestSequenceSummaryProvider\getActiveId(), and ilTestSequenceSummaryProvider\getSequenceSummary().

Here is the call graph for this function:

getVirtualSequenceUserResults()

ilTestService::getVirtualSequenceUserResults

(

ilTestVirtualSequence

$virtualSequence

)

Definition at line 206 of file class.ilTestService.php.

    {
        $resultsByPass = array();
 
        foreach ($virtualSequence->getUniquePasses() as $pass) {
            $results = $this->object->getTestResult(
                $virtualSequence->getActiveId(),
                $pass,
                false,
                true,
                true
            );
 
            $resultsByPass[$pass] = $results;
        }
 
        $virtualPassResults = array();
 
        foreach ($virtualSequence->getQuestionsPassMap() as $questionId => $pass) {
            foreach ($resultsByPass[$pass] as $key => $questionResult) {
                if ($key === 'test' || $key === 'pass') {
                    continue;
                }
 
                if ($questionResult['qid'] == $questionId) {
                    $questionResult['pass'] = $pass;
                    $virtualPassResults[$questionId] = $questionResult;
                    break;
                }
            }
        }
 
        return $virtualPassResults;
    }

References $pass, $results, ilTestVirtualSequence\getActiveId(), ilTestVirtualSequence\getQuestionsPassMap(), and ilTestVirtualSequence\getUniquePasses().

Here is the call graph for this function:

isManScoringDone()

static ilTestService::isManScoringDone (   $activeId )

static

reads the flag wether manscoring is done for the given test active or not from the global settings (scope: assessment / key: manscoring_done_<activeId>)

@access public

Parameters

integer

$activeId

Returns

boolean $manScoringDone

Definition at line 159 of file class.ilTestService.php.

    {
        $assessmentSetting = new ilSetting("assessment");
        return $assessmentSetting->get("manscoring_done_" . $activeId, false);
    }

Referenced by ilObjTest\getManualFeedback().

Here is the caller graph for this function:

setManScoringDone()

static ilTestService::setManScoringDone (   $activeId,   $manScoringDone  )

static

stores the flag wether manscoring is done for the given test active or not within the global settings (scope: assessment / key: manscoring_done_<activeId>)

@access public

Parameters

integer	$activeId
boolean	$manScoringDone

Definition at line 174 of file class.ilTestService.php.

    {
        $assessmentSetting = new ilSetting("assessment");
        $assessmentSetting->set("manscoring_done_" . $activeId, (bool) $manScoringDone);
    }

Referenced by ilTestScoringGUI\saveManScoringParticipantScreen().

Here is the caller graph for this function:

Field Documentation

$object

ilTestService::$object = null

protected

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

---

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

• Modules/Test/classes/class.ilTestService.php