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)

	xmlDumpFile ($file, $format=true)

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

	_ilXmlWriter ()
	destructor 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 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 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.

References $anonymized, and $test_id.

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

Member Function Documentation

◆ exportActiveIDs()

ilTestResultsToXML::exportActiveIDs ( )

protected

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

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

Referenced by getXML().

     {
         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");
     }

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.

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

Referenced by getXML().

     {
         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");
     }

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.

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

Referenced by getXML().

     {
         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');
     }

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.

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

Referenced by getXML().

     {
         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");
     }

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.

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

Referenced by getXML().

     {
         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");
     }

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.

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

Referenced by getXML().

     {
         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");
     }

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.

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

Referenced by getXML().

     {
         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");
     }

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.

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

Referenced by getXML().

     {
         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");
     }

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.

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

Referenced by xmlDumpFile(), and xmlDumpMem().

     {
         $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");
     }

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.

References $includeRandomTestQuestionsEnabled.

Referenced by getXML().

     {
         return $this->includeRandomTestQuestionsEnabled;
     }

Here is the caller graph for this function:

◆ setIncludeRandomTestQuestionsEnabled()

ilTestResultsToXML::setIncludeRandomTestQuestionsEnabled ( $includeRandomTestQuestionsEnabled )

Parameters

boolean $includeRandomTestQuestionsEnabled

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

References $includeRandomTestQuestionsEnabled.

Referenced by ilTestExport\buildExportFileXML().

     {
         $this->includeRandomTestQuestionsEnabled = $includeRandomTestQuestionsEnabled;
     }

Here is the caller graph for this function:

◆ xmlDumpFile()

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

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

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

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

Here is the call graph for this function:

◆ xmlDumpMem()

ilTestResultsToXML::xmlDumpMem ( $format = true )

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

References $format, and getXML().

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

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