ilTestResultsToXML Class Reference

Inheritance diagram for ilTestResultsToXML:

Collaboration diagram for ilTestResultsToXML:

Public Member Functions
	__construct (private int $test_id, private ilDBInterface $db, private bool $anonymized=false)
	isIncludeRandomTestQuestionsEnabled ()
	setIncludeRandomTestQuestionsEnabled (bool $include_random_test_questions_enabled)
	getXML ()
	xmlDumpMem (bool $format=true)
	xmlDumpFile (string $file, bool $format=true)
Public Member Functions inherited from ilXmlWriter
	__construct (string $version="1.0", string $outEnc="utf-8", string $inEnc="utf-8")
	xmlSetDtdDef (string $dtdDef)
	Sets dtd definition. More...
	xmlSetGenCmt (string $genCmt)
	Sets generated comment. More...
	xmlFormatData (string $data)
	Indents text for better reading. More...
	xmlHeader ()
	Writes xml header. More...
	xmlStartTag (string $tag, ?array $attrs=null, bool $empty=false, bool $encode=true, bool $escape=true)
	Writes a starttag. More...
	xmlEndTag (string $tag)
	Writes an endtag. More...
	xmlData (string $data, bool $encode=true, bool $escape=true)
	Writes data. More...
	xmlElement (string $tag, $attrs=null, $data=null, $encode=true, $escape=true)
	Writes a basic element (no children, just textual content) More...
	xmlDumpFile (string $file, bool $format=true)
	Dumps xml document from memory into a file. More...
	xmlDumpMem (bool $format=true)
	Returns xml document from memory. More...
	appendXML (string $a_str)
	append xml string to document More...
	xmlClear ()
	clears xmlStr More...

Protected Member Functions
	exportActiveIDs ()
	exportPassResult ()
	exportResultCache ()
	exportTestSequence ()
	exportTestSolutions ()
	exportRandomTestQuestions ()
	exportTestResults ()
	exportTestTimes ()

Protected Attributes
bool	$include_random_test_questions_enabled = false

Private Attributes
	$active_ids

Detailed Description

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

Constructor & Destructor Documentation

__construct()

ilTestResultsToXML::__construct	(	private int	$test_id,
		private ilDBInterface	$db,
		private bool	$anonymized = false
	)

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

References ILIAS\GlobalScreen\Provider\__construct().

      {
        parent::__construct();
    }

Here is the call graph for this function:

Member Function Documentation

exportActiveIDs()

ilTestResultsToXML::exportActiveIDs ( )

protected

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

References ilObjTestAccess\_getParticipantData(), null, ilXmlWriter\xmlElement(), ilXmlWriter\xmlEndTag(), and ilXmlWriter\xmlStartTag().

Referenced by getXML().

                                        : void
    {
        $assessment_setting = new ilSetting('assessment');
        $user_criteria = $assessment_setting->get('user_criteria');
        if ($user_criteria === null || $user_criteria === '') {
            $user_criteria = 'usr_id';
        }

        if ($this->anonymized) {
            $result = $this->db->queryF(
                'SELECT * FROM tst_active WHERE test_fi = %s',
                ['integer'],
                [$this->test_id]
            );
        } else {
            $result = $this->db->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',
                ['integer'],
                [$this->test_id]
            );
        }
        $this->xmlStartTag('tst_active', null);
        while ($row = $this->db->fetchAssoc($result)) {
            $attrs = [
                '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 92 of file class.ilTestResultsToXML.php.

References null, ilXmlWriter\xmlElement(), ilXmlWriter\xmlEndTag(), and ilXmlWriter\xmlStartTag().

Referenced by getXML().

                                         : void
    {
        $query = 'SELECT * FROM tst_pass_result WHERE ' . $this->db->in('active_fi', $this->active_ids, false, 'integer') . ' ORDER BY active_fi, pass';
        $result = $this->db->query($query);
        $this->xmlStartTag('tst_pass_result', null);
        while ($row = $this->db->fetchAssoc($result)) {
            $attrs = [
                '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 175 of file class.ilTestResultsToXML.php.

References null, ilXmlWriter\xmlElement(), ilXmlWriter\xmlEndTag(), and ilXmlWriter\xmlStartTag().

Referenced by getXML().

                                                  : void
    {
        $result = $this->db->query("
                          SELECT * FROM tst_test_rnd_qst
                          WHERE {$this->db->in('active_fi', $this->active_ids, false, 'integer')}
                          ORDER BY test_random_question_id
                ");

        $this->xmlStartTag('tst_test_rnd_qst', null);
        while ($row = $this->db->fetchAssoc($result)) {
            $attrs = [];

            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 113 of file class.ilTestResultsToXML.php.

References null, ilXmlWriter\xmlElement(), ilXmlWriter\xmlEndTag(), and ilXmlWriter\xmlStartTag().

Referenced by getXML().

                                          : void
    {
        $query = 'SELECT * FROM tst_result_cache WHERE ' . $this->db->in('active_fi', $this->active_ids, false, 'integer') . ' ORDER BY active_fi';
        $result = $this->db->query($query);
        $this->xmlStartTag('tst_result_cache', null);
        while ($row = $this->db->fetchAssoc($result)) {
            $attrs = [
                '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 197 of file class.ilTestResultsToXML.php.

References null, ilXmlWriter\xmlElement(), ilXmlWriter\xmlEndTag(), and ilXmlWriter\xmlStartTag().

Referenced by getXML().

                                          : void
    {
        $query = 'SELECT * FROM tst_test_result WHERE ' . $this->db->in('active_fi', $this->active_ids, false, 'integer') . ' ORDER BY active_fi';
        $result = $this->db->query($query);
        $this->xmlStartTag('tst_test_result', null);
        while ($row = $this->db->fetchAssoc($result)) {
            $attrs = [
                '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 135 of file class.ilTestResultsToXML.php.

References null, ilXmlWriter\xmlElement(), ilXmlWriter\xmlEndTag(), and ilXmlWriter\xmlStartTag().

Referenced by getXML().

                                           : void
    {
        $query = 'SELECT * FROM tst_sequence WHERE ' . $this->db->in('active_fi', $this->active_ids, false, 'integer') . ' ORDER BY active_fi, pass';
        $result = $this->db->query($query);
        $this->xmlStartTag('tst_sequence', null);
        while ($row = $this->db->fetchAssoc($result)) {
            $attrs = [
                '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 154 of file class.ilTestResultsToXML.php.

References null, ilXmlWriter\xmlElement(), ilXmlWriter\xmlEndTag(), and ilXmlWriter\xmlStartTag().

Referenced by getXML().

                                            : void
    {
        $query = 'SELECT * FROM tst_solutions WHERE ' . $this->db->in('active_fi', $this->active_ids, false, 'integer') . ' ORDER BY solution_id';
        $result = $this->db->query($query);
        $this->xmlStartTag('tst_solutions', null);
        while ($row = $this->db->fetchAssoc($result)) {
            $attrs = [
                '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 217 of file class.ilTestResultsToXML.php.

References null, ilXmlWriter\xmlElement(), ilXmlWriter\xmlEndTag(), and ilXmlWriter\xmlStartTag().

Referenced by getXML().

                                        : void
    {
        $query = 'SELECT * FROM tst_times WHERE ' . $this->db->in('active_fi', $this->active_ids, false, 'integer') . ' ORDER BY active_fi';
        $result = $this->db->query($query);
        $this->xmlStartTag('tst_times', null);
        while ($row = $this->db->fetchAssoc($result)) {
            $attrs = [
                '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 236 of file class.ilTestResultsToXML.php.

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

Referenced by xmlDumpFile(), and xmlDumpMem().

                            : void
    {
        $this->active_ids = [];
        $this->xmlHeader();
        $attrs = ['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

(

)

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

References $include_random_test_questions_enabled.

Referenced by getXML().

                                                         : bool
    {
        return $this->include_random_test_questions_enabled;
    }

Here is the caller graph for this function:

setIncludeRandomTestQuestionsEnabled()

ilTestResultsToXML::setIncludeRandomTestQuestionsEnabled

(

bool

$include_random_test_questions_enabled

)

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

References $include_random_test_questions_enabled.

                                                                                                     : void
    {
        $this->include_random_test_questions_enabled = $include_random_test_questions_enabled;
    }

xmlDumpFile()

ilTestResultsToXML::xmlDumpFile	(	string	$file,
		bool	$format = true
	)

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

References getXML().

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

Here is the call graph for this function:

xmlDumpMem()

ilTestResultsToXML::xmlDumpMem

(

bool

$format = true

)

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

References getXML().

                                                   : string
    {
        $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 23 of file class.ilTestResultsToXML.php.

$include_random_test_questions_enabled

bool ilTestResultsToXML::$include_random_test_questions_enabled = false

protected

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

Referenced by isIncludeRandomTestQuestionsEnabled(), and setIncludeRandomTestQuestionsEnabled().

---

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

• components/ILIAS/Test/classes/class.ilTestResultsToXML.php