Test results to XML class. More...

Inheritance diagram for ilTestResultsToXML:

Collaboration diagram for ilTestResultsToXML:

Public Member Functions
	__construct ($test_id, $anonymized=false)

	isIncludeRandomTestQuestionsEnabled ()

	setIncludeRandomTestQuestionsEnabled ($includeRandomTestQuestionsEnabled)

	getXML ()

	xmlDumpMem ($format=true)
	Returns xml document from memory. More...

	xmlDumpFile ($file, $format=true)
	Dumps xml document from memory into a file. More...

Public Member Functions inherited from ilXmlWriter
	__construct ($version="1.0", $outEnc="utf-8", $inEnc="utf-8")
	constructor More...

	_ilXmlWriter ()
	destructor @access public More...

	xmlSetDtdDef ($dtdDef)
	Sets dtd definition. More...

	xmlSetStSheet ($stSheet)
	Sets stylesheet. More...

	xmlSetGenCmt ($genCmt)
	Sets generated comment. More...

	xmlEncodeData ($data)
	Encodes text from input encoding into output encoding. More...

	xmlFormatData ($data)
	Indents text for better reading. More...

	xmlFormatElement ($array)
	Callback function for xmlFormatData; do not invoke directly. More...

	xmlHeader ()
	Writes xml header @access public. More...

	xmlStartTag ($tag, $attrs=null, $empty=false, $encode=true, $escape=true)
	Writes a starttag. More...

	xmlEndTag ($tag)
	Writes an endtag. More...

	xmlComment ($comment)
	Writes a comment. More...

	xmlData ($data, $encode=true, $escape=true)
	Writes data. More...

	xmlElement ($tag, $attrs=null, $data=null, $encode=true, $escape=true)
	Writes a basic element (no children, just textual content) More...

	xmlDumpFile ($file, $format=true)
	Dumps xml document from memory into a file. More...

	xmlDumpMem ($format=true)
	Returns xml document from memory. More...

	appendXML ($a_str)
	append xml string to document More...

	xmlClear ()
	clears xmlStr @access public More...

Protected Member Functions
	exportActiveIDs ()

	exportPassResult ()

	exportResultCache ()

	exportTestSequence ()

	exportTestSolutions ()

	exportRandomTestQuestions ()

	exportTestResults ()

	exportTestTimes ()

Protected Attributes
	$includeRandomTestQuestionsEnabled = false

Private Attributes
	$test_id = 0

	$anonymized = false

	$active_ids

Additional Inherited Members
Static Public Member Functions inherited from ilXmlWriter
static	_xmlEscapeData ($data)
	Escapes reserved characters. More...

Data Fields inherited from ilXmlWriter
	$xmlStr

	$version

	$outEnc

	$inEnc

	$dtdDef = ""

	$stSheet = ""

	$genCmt = "Generated by ILIAS XmlWriter"

Detailed Description

Test results to XML class.

Author: Helmut Schottmüller ilias.nosp@m.@aur.nosp@m.ealis.nosp@m..de

Version: $Id$

Definition at line 13 of file class.ilTestResultsToXML.php.

Constructor & Destructor Documentation

◆ __construct()

ilTestResultsToXML::__construct	(	$test_id,
		$anonymized = `false`
	)

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

    {
        parent::__construct();
        $this->test_id = $test_id;
        $this->anonymized = $anonymized;
    }

References $anonymized, and $test_id.

Member Function Documentation

◆ exportActiveIDs()

ilTestResultsToXML::exportActiveIDs ( )

protected

Definition at line 44 of file class.ilTestResultsToXML.php.

    {
        global $ilDB, $ilSetting;
 
        include_once "./Modules/Test/classes/class.ilObjTestAccess.php";
        $assessmentSetting = new ilSetting("assessment");
        $user_criteria = $assessmentSetting->get("user_criteria");
        if (strlen($user_criteria) == 0) {
            $user_criteria = 'usr_id';
        }
        
        if ($this->anonymized) {
            $result = $ilDB->queryF(
                "SELECT * FROM tst_active WHERE test_fi = %s",
                array('integer'),
                array($this->test_id)
            );
        } else {
            $result = $ilDB->queryF(
                "SELECT tst_active.*, usr_data." . $user_criteria . " FROM tst_active, usr_data WHERE tst_active.test_fi = %s AND tst_active.user_fi = usr_data.usr_id",
                array('integer'),
                array($this->test_id)
            );
        }
        $this->xmlStartTag("tst_active", null);
        while ($row = $ilDB->fetchAssoc($result)) {
            $attrs = array(
                'active_id' => $row['active_id'],
                'user_fi' => $row['user_fi'],
                'anonymous_id' => $row['anonymous_id'],
                'test_fi' => $row['test_fi'],
                'lastindex' => $row['lastindex'],
                'tries' => $row['tries'],
                'last_started_pass' => $row['last_started_pass'],
                'last_finished_pass' => $row['last_finished_pass'],
                'submitted' => $row['submitted'],
                'submittimestamp' => $row['submittimestamp'],
                'tstamp' => $row['tstamp']
            );
            $attrs['fullname'] = ilObjTestAccess::_getParticipantData($row['active_id']);
            if (!$this->anonymized) {
                $attrs['user_criteria'] = $user_criteria;
                $attrs[$user_criteria] = $row[$user_criteria];
            }
            array_push($this->active_ids, $row['active_id']);
            $this->xmlElement("row", $attrs);
        }
        $this->xmlEndTag("tst_active");
    }

References $ilDB, $ilSetting, $result, $row, ilObjTestAccess\_getParticipantData(), ilXmlWriter\xmlElement(), ilXmlWriter\xmlEndTag(), and ilXmlWriter\xmlStartTag().

Referenced by getXML().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ exportPassResult()

ilTestResultsToXML::exportPassResult ( )

protected

Definition at line 94 of file class.ilTestResultsToXML.php.

    {
        global $ilDB;
        
        $query = "SELECT * FROM tst_pass_result WHERE " . $ilDB->in('active_fi', $this->active_ids, false, 'integer') . " ORDER BY active_fi, pass";
        $result = $ilDB->query($query);
        $this->xmlStartTag("tst_pass_result", null);
        while ($row = $ilDB->fetchAssoc($result)) {
            $attrs = array(
                'active_fi' => $row['active_fi'],
                'pass' => $row['pass'],
                'points' => $row['points'],
                'maxpoints' => $row['maxpoints'],
                'questioncount' => $row['questioncount'],
                'answeredquestions' => $row['answeredquestions'],
                'workingtime' => $row['workingtime'],
                'tstamp' => $row['tstamp']
            );
            $this->xmlElement("row", $attrs);
        }
        $this->xmlEndTag("tst_pass_result");
    }

References $ilDB, $query, $result, $row, ilXmlWriter\xmlElement(), ilXmlWriter\xmlEndTag(), and ilXmlWriter\xmlStartTag().

Referenced by getXML().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ exportRandomTestQuestions()

ilTestResultsToXML::exportRandomTestQuestions ( )

protected

Definition at line 185 of file class.ilTestResultsToXML.php.

    {
        global $ilDB;
 
        $result = $ilDB->query("
                          SELECT * FROM tst_test_rnd_qst
                          WHERE {$ilDB->in('active_fi', $this->active_ids, false, 'integer')}
                          ORDER BY test_random_question_id
                ");
 
        $this->xmlStartTag('tst_test_rnd_qst', null);
        while ($row = $ilDB->fetchAssoc($result)) {
            $attrs = array();
 
            foreach ($row as $field => $value) {
                $attrs[$field] = $value;
            }
 
            $this->xmlElement('row', $attrs);
        }
        $this->xmlEndTag('tst_test_rnd_qst');
    }

References $ilDB, $result, $row, ilXmlWriter\xmlElement(), ilXmlWriter\xmlEndTag(), and ilXmlWriter\xmlStartTag().

Referenced by getXML().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ exportResultCache()

ilTestResultsToXML::exportResultCache ( )

protected

Definition at line 117 of file class.ilTestResultsToXML.php.

    {
        global $ilDB;
        
        $query = "SELECT * FROM tst_result_cache WHERE " . $ilDB->in('active_fi', $this->active_ids, false, 'integer') . " ORDER BY active_fi";
        $result = $ilDB->query($query);
        $this->xmlStartTag("tst_result_cache", null);
        while ($row = $ilDB->fetchAssoc($result)) {
            $attrs = array(
                'active_fi' => $row['active_fi'],
                'pass' => $row['pass'],
                'max_points' => $row['max_points'],
                'reached_points' => $row['reached_points'],
                'mark_short' => $row['mark_short'],
                'mark_official' => $row['mark_official'],
                'passed' => $row['passed'],
                'failed' => $row['failed'],
                'tstamp' => $row['tstamp']
            );
            $this->xmlElement("row", $attrs);
        }
        $this->xmlEndTag("tst_result_cache");
    }

References $ilDB, $query, $result, $row, ilXmlWriter\xmlElement(), ilXmlWriter\xmlEndTag(), and ilXmlWriter\xmlStartTag().

Referenced by getXML().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ exportTestResults()

ilTestResultsToXML::exportTestResults ( )

protected

Definition at line 209 of file class.ilTestResultsToXML.php.

    {
        global $ilDB;
        
        $query = "SELECT * FROM tst_test_result WHERE " . $ilDB->in('active_fi', $this->active_ids, false, 'integer') . " ORDER BY active_fi";
        $result = $ilDB->query($query);
        $this->xmlStartTag("tst_test_result", null);
        while ($row = $ilDB->fetchAssoc($result)) {
            $attrs = array(
                'test_result_id' => $row['test_result_id'],
                'active_fi' => $row['active_fi'],
                'question_fi' => $row['question_fi'],
                'points' => $row['points'],
                'pass' => $row['pass'],
                'manual' => $row['manual'],
                'tstamp' => $row['tstamp']
            );
            $this->xmlElement("row", $attrs);
        }
        $this->xmlEndTag("tst_test_result");
    }

References $ilDB, $query, $result, $row, ilXmlWriter\xmlElement(), ilXmlWriter\xmlEndTag(), and ilXmlWriter\xmlStartTag().

Referenced by getXML().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ exportTestSequence()

ilTestResultsToXML::exportTestSequence ( )

protected

Definition at line 141 of file class.ilTestResultsToXML.php.

    {
        global $ilDB;
        
        $query = "SELECT * FROM tst_sequence WHERE " . $ilDB->in('active_fi', $this->active_ids, false, 'integer') . " ORDER BY active_fi, pass";
        $result = $ilDB->query($query);
        $this->xmlStartTag("tst_sequence", null);
        while ($row = $ilDB->fetchAssoc($result)) {
            $attrs = array(
                'active_fi' => $row['active_fi'],
                'pass' => $row['pass'],
                'sequence' => $row['sequence'],
                'postponed' => $row['postponed'],
                'hidden' => $row['hidden'],
                'tstamp' => $row['tstamp']
            );
            $this->xmlElement("row", $attrs);
        }
        $this->xmlEndTag("tst_sequence");
    }

References $ilDB, $query, $result, $row, ilXmlWriter\xmlElement(), ilXmlWriter\xmlEndTag(), and ilXmlWriter\xmlStartTag().

Referenced by getXML().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ exportTestSolutions()

ilTestResultsToXML::exportTestSolutions ( )

protected

Definition at line 162 of file class.ilTestResultsToXML.php.

    {
        global $ilDB;
        
        $query = "SELECT * FROM tst_solutions WHERE " . $ilDB->in('active_fi', $this->active_ids, false, 'integer') . " ORDER BY solution_id";
        $result = $ilDB->query($query);
        $this->xmlStartTag("tst_solutions", null);
        while ($row = $ilDB->fetchAssoc($result)) {
            $attrs = array(
                'solution_id' => $row['solution_id'],
                'active_fi' => $row['active_fi'],
                'question_fi' => $row['question_fi'],
                'points' => $row['points'],
                'pass' => $row['pass'],
                'value1' => $row['value1'],
                'value2' => $row['value2'],
                'tstamp' => $row['tstamp']
            );
            $this->xmlElement("row", $attrs);
        }
        $this->xmlEndTag("tst_solutions");
    }

References $ilDB, $query, $result, $row, ilXmlWriter\xmlElement(), ilXmlWriter\xmlEndTag(), and ilXmlWriter\xmlStartTag().

Referenced by getXML().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ exportTestTimes()

ilTestResultsToXML::exportTestTimes ( )

protected

Definition at line 231 of file class.ilTestResultsToXML.php.

    {
        global $ilDB;
        
        $query = "SELECT * FROM tst_times WHERE " . $ilDB->in('active_fi', $this->active_ids, false, 'integer') . " ORDER BY active_fi";
        $result = $ilDB->query($query);
        $this->xmlStartTag("tst_times", null);
        while ($row = $ilDB->fetchAssoc($result)) {
            $attrs = array(
                'times_id' => $row['times_id'],
                'active_fi' => $row['active_fi'],
                'started' => $row['started'],
                'finished' => $row['finished'],
                'pass' => $row['pass'],
                'tstamp' => $row['tstamp']
            );
            $this->xmlElement("row", $attrs);
        }
        $this->xmlEndTag("tst_times");
    }

References $ilDB, $query, $result, $row, ilXmlWriter\xmlElement(), ilXmlWriter\xmlEndTag(), and ilXmlWriter\xmlStartTag().

Referenced by getXML().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getXML()

ilTestResultsToXML::getXML ( )

Definition at line 252 of file class.ilTestResultsToXML.php.

    {
        $this->active_ids = array();
        $this->xmlHeader();
        $attrs = array("version" => "4.1.0");
        $this->xmlStartTag("results", $attrs);
        $this->exportActiveIDs();
 
        if ($this->isIncludeRandomTestQuestionsEnabled()) {
            $this->exportRandomTestQuestions();
        }
        
        $this->exportPassResult();
        $this->exportResultCache();
        $this->exportTestSequence();
        $this->exportTestSolutions();
        $this->exportTestResults();
        $this->exportTestTimes();
        $this->xmlEndTag("results");
    }

References exportActiveIDs(), exportPassResult(), exportRandomTestQuestions(), exportResultCache(), exportTestResults(), exportTestSequence(), exportTestSolutions(), exportTestTimes(), isIncludeRandomTestQuestionsEnabled(), ilXmlWriter\xmlEndTag(), ilXmlWriter\xmlHeader(), and ilXmlWriter\xmlStartTag().

Referenced by xmlDumpFile(), and xmlDumpMem().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isIncludeRandomTestQuestionsEnabled()

ilTestResultsToXML::isIncludeRandomTestQuestionsEnabled ( )

Returns: boolean

Definition at line 31 of file class.ilTestResultsToXML.php.

    {
        return $this->includeRandomTestQuestionsEnabled;
    }

References $includeRandomTestQuestionsEnabled.

Referenced by getXML().

Here is the caller graph for this function:

◆ setIncludeRandomTestQuestionsEnabled()

ilTestResultsToXML::setIncludeRandomTestQuestionsEnabled ( $includeRandomTestQuestionsEnabled )

Parameters

boolean $includeRandomTestQuestionsEnabled

Definition at line 39 of file class.ilTestResultsToXML.php.

    {
        $this->includeRandomTestQuestionsEnabled = $includeRandomTestQuestionsEnabled;
    }

References $includeRandomTestQuestionsEnabled.

◆ xmlDumpFile()

ilTestResultsToXML::xmlDumpFile	(	$file,
		$format = `true`
	)

Dumps xml document from memory into a file.

Parameters

string	file name (full path)
boolean	indent text (TRUE) or not (FALSE) @access public

Reimplemented from ilXmlWriter.

Definition at line 279 of file class.ilTestResultsToXML.php.

    {
        $this->getXML();
        return parent::xmlDumpFile($file, $format);
    }

References $file, $format, and getXML().

Here is the call graph for this function:

◆ xmlDumpMem()

ilTestResultsToXML::xmlDumpMem ( $format = true )

Returns xml document from memory.

Parameters

boolean indent text (TRUE) or not (FALSE)

Returns: string xml document @access public

Reimplemented from ilXmlWriter.

Definition at line 273 of file class.ilTestResultsToXML.php.

    {
        $this->getXML();
        return parent::xmlDumpMem($format);
    }

References $format, and getXML().

Here is the call graph for this function:

Field Documentation

◆ $active_ids

ilTestResultsToXML::$active_ids

private

Definition at line 17 of file class.ilTestResultsToXML.php.

◆ $anonymized

ilTestResultsToXML::$anonymized = false

private

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

Referenced by __construct().

◆ $includeRandomTestQuestionsEnabled

ilTestResultsToXML::$includeRandomTestQuestionsEnabled = false

protected

Definition at line 19 of file class.ilTestResultsToXML.php.

Referenced by isIncludeRandomTestQuestionsEnabled(), and setIncludeRandomTestQuestionsEnabled().

◆ $test_id

ilTestResultsToXML::$test_id = 0

private

Definition at line 15 of file class.ilTestResultsToXML.php.

Referenced by __construct().

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

Modules/Test/classes/class.ilTestResultsToXML.php

Public Member Functions

Protected Member Functions

Protected Attributes

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ exportActiveIDs()

◆ exportPassResult()

◆ exportRandomTestQuestions()

◆ exportResultCache()

◆ exportTestResults()

◆ exportTestSequence()

◆ exportTestSolutions()

◆ exportTestTimes()

◆ getXML()

◆ isIncludeRandomTestQuestionsEnabled()

◆ setIncludeRandomTestQuestionsEnabled()

◆ xmlDumpFile()

◆ xmlDumpMem()

Field Documentation

◆ $active_ids

◆ $anonymized

◆ $includeRandomTestQuestionsEnabled

◆ $test_id