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 95 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 190 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 119 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 216 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 144 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 166 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 239 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 261 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 289 of file class.ilTestResultsToXML.php.

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

References $file, 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 283 of file class.ilTestResultsToXML.php.

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

References 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