ilTestImporter Class Reference

Importer class for files. More...

Inheritance diagram for ilTestImporter:

Collaboration diagram for ilTestImporter:

Public Member Functions
	__construct ()
	importXmlRepresentation (string $a_entity, string $a_id, string $a_xml, ilImportMapping $a_mapping)
	Import XML. More...
	addTexonomyAndQuestionsMapping (array $question_id_mapping, int $new_obj_id, ilImportMapping $mapping)
	finalProcessing (ilImportMapping $a_mapping)
	Final processing. More...
	importRandomQuestionSetConfig (ilObjTest $test_obj, $xmlFile, $a_mapping)
Public Member Functions inherited from ilXmlImporter
	__construct ()
	setImport (ilImport $a_val)
	getImport ()
	init ()
	setInstallId (string $a_val)
	getInstallId ()
	setInstallUrl (string $a_val)
	getInstallUrl ()
	setSchemaVersion (string $a_val)
	getSchemaVersion ()
	setImportDirectory (string $a_val)
	getImportDirectory ()
	setSkipEntities (array $a_val)
	getSkipEntities ()
	exportedFromSameInstallation ()
	importXmlRepresentation (string $a_entity, string $a_id, string $a_xml, ilImportMapping $a_mapping)
	finalProcessing (ilImportMapping $a_mapping)
	afterContainerImportProcessing (ilImportMapping $mapping)

Static Public Attributes
static	$finallyProcessedTestsRegistry = []

Protected Member Functions
	finalRandomTestTaxonomyProcessing (ilImportMapping $mapping, string $oldTstObjId, string $newTstObjId, ilObjTest $test_obj)
	getNewMappedTaxonomyFilter (ilImportMapping $mapping, array $mappedFilter)
	parseXmlFileNames ()
	Create qti and xml file name. More...
	importQuestionSkillAssignments (ilImportMapping $mapping, ilObjTest $test_obj, $xmlFile)
	importSkillLevelThresholds (ilImportMapping $mapping, ilAssQuestionSkillAssignmentList $assignmentList, ilObjTest $test_obj, $xmlFile)

Private Member Functions
	getImportDirectoryContainer ()
	getImportPackageName ()

Private Attributes
ilLogger	$log
ilDBInterface	$db
ResourceStorage	$irss

Additional Inherited Members
Protected Attributes inherited from ilXmlImporter
array	$skip_entities = array()
ilImport	$imp
string	$install_id
string	$install_url
string	$schema_version
string	$import_directory

Detailed Description

Importer class for files.

Author

Stefan Meyer meyer.nosp@m.@lei.nosp@m.fos.c.nosp@m.om

Version

$Id$

Definition at line 30 of file class.ilTestImporter.php.

Constructor & Destructor Documentation

__construct()

ilTestImporter::__construct

(

)

Definition at line 41 of file class.ilTestImporter.php.

References $DIC, and ILIAS\MetaData\Repository\Validation\Data\__construct().

    {
        global $DIC;
        $this->log = $DIC['ilLog'];
        $this->db = $DIC['ilDB'];
        $this->irss = $DIC['resource_storage'];

        parent::__construct();
    }

Here is the call graph for this function:

Member Function Documentation

addTexonomyAndQuestionsMapping()

ilTestImporter::addTexonomyAndQuestionsMapping	(	array	$question_id_mapping,
		int	$new_obj_id,
		ilImportMapping	$mapping
	)

Definition at line 144 of file class.ilTestImporter.php.

References ilImportMapping\addMapping().

Referenced by importXmlRepresentation().

                                                                                                                         : ilImportMapping
    {
        foreach ($question_id_mapping as $oldQuestionId => $newQuestionId) {
            $mapping->addMapping(
                "Services/Taxonomy",
                "tax_item",
                "tst:quest:$oldQuestionId",
                (string) $newQuestionId
            );

            $mapping->addMapping(
                "Services/Taxonomy",
                "tax_item_obj_id",
                "tst:quest:$oldQuestionId",
                (string) $new_obj_id
            );

            $mapping->addMapping(
                "Modules/Test",
                "quest",
                (string) $oldQuestionId,
                (string) $newQuestionId
            );
        }

        return $mapping;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

finalProcessing()

ilTestImporter::finalProcessing

(

ilImportMapping

$a_mapping

)

Final processing.

Parameters

ilImportMapping

$a_mapping

Returns

void

Definition at line 177 of file class.ilTestImporter.php.

References finalRandomTestTaxonomyProcessing(), ilObjectFactory\getInstanceByObjId(), and ilImportMapping\getMappingsOfEntity().

                                                               : void
    {
        $maps = $a_mapping->getMappingsOfEntity("Modules/Test", "tst");

        foreach ($maps as $old => $new) {
            if ($old == "new_id" || (int) $old <= 0) {
                continue;
            }

            if (isset(self::$finallyProcessedTestsRegistry[$new])) {
                continue;
            }

            $test_obj = ilObjectFactory::getInstanceByObjId((int) $new, false);
            if ($test_obj->isRandomTest()) {
                $this->finalRandomTestTaxonomyProcessing($a_mapping, (string) $old, $new, $test_obj);
            }

            self::$finallyProcessedTestsRegistry[$new] = true;
        }
    }

Here is the call graph for this function:

finalRandomTestTaxonomyProcessing()

ilTestImporter::finalRandomTestTaxonomyProcessing ( ilImportMapping  $mapping, string  $oldTstObjId, string  $newTstObjId, ilObjTest  $test_obj  )

protected

Definition at line 199 of file class.ilTestImporter.php.

References ilImportMapping\getMapping(), getNewMappedTaxonomyFilter(), and ilObjTaxonomy\saveUsage().

Referenced by finalProcessing().

     : void {
        $new_tax_ids = $mapping->getMapping(
            'Services/Taxonomy',
            'tax_usage_of_obj',
            $oldTstObjId
        );

        if ($new_tax_ids !== null) {
            $tax_ids = explode(":", $new_tax_ids);

            foreach ($tax_ids as $tid) {
                ilObjTaxonomy::saveUsage((int) $tid, (int) $newTstObjId);
            }
        }

        $srcPoolDefFactory = new ilTestRandomQuestionSetSourcePoolDefinitionFactory(
            $this->db,
            $test_obj
        );

        $srcPoolDefList = new ilTestRandomQuestionSetSourcePoolDefinitionList(
            $this->db,
            $test_obj,
            $srcPoolDefFactory
        );

        $srcPoolDefList->loadDefinitions();

        foreach ($srcPoolDefList as $definition) {
            // #21330
            if (!is_array($definition->getMappedTaxonomyFilter()) || 0 === count($definition->getMappedTaxonomyFilter())) {
                continue;
            }

            $definition->setMappedTaxonomyFilter(
                $this->getNewMappedTaxonomyFilter(
                    $mapping,
                    $definition->getMappedTaxonomyFilter()
                )
            );
            $definition->saveToDb();
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getImportDirectoryContainer()

ilTestImporter::getImportDirectoryContainer ( )

private

Definition at line 304 of file class.ilTestImporter.php.

References ilXmlImporter\getImportDirectory().

Referenced by importXmlRepresentation().

                                                  : string
    {
        $dir = $this->getImportDirectory();
        $dir = dirname($dir);
        return $dir;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getImportPackageName()

ilTestImporter::getImportPackageName ( )

private

Definition at line 311 of file class.ilTestImporter.php.

References ilXmlImporter\getImportDirectory().

Referenced by importXmlRepresentation().

                                           : string
    {
        $dir = $this->getImportDirectory();
        $name = basename($dir);
        return $name;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getNewMappedTaxonomyFilter()

ilTestImporter::getNewMappedTaxonomyFilter ( ilImportMapping  $mapping, array  $mappedFilter  )

protected

Parameters

ilImportMapping	$mapping
array	$mappedFilter

Returns

array

Definition at line 253 of file class.ilTestImporter.php.

References ilImportMapping\getMapping().

Referenced by finalRandomTestTaxonomyProcessing().

                                                                                                : array
    {
        $newMappedFilter = [];

        foreach ($mappedFilter as $taxId => $taxNodes) {
            $newTaxId = $mapping->getMapping(
                'Services/Taxonomy',
                'tax',
                (string) $taxId
            );

            if (!$newTaxId) {
                continue;
            }

            $newMappedFilter[$newTaxId] = [];

            foreach ($taxNodes as $taxNodeId) {
                $newTaxNodeId = $mapping->getMapping(
                    'Services/Taxonomy',
                    'tax_tree',
                    (string) $taxNodeId
                );

                if (!$newTaxNodeId) {
                    continue;
                }

                $newMappedFilter[$newTaxId][] = $newTaxNodeId;
            }
        }

        return $newMappedFilter;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

importQuestionSkillAssignments()

ilTestImporter::importQuestionSkillAssignments ( ilImportMapping  $mapping, ilObjTest  $test_obj,   $xmlFile  )

protected

Parameters

ilImportMapping	$mappingRegistry
ilObjTest	$test_obj
string	$xmlfile

Returns

ilAssQuestionSkillAssignmentList

Definition at line 333 of file class.ilTestImporter.php.

References ilObject\getId(), ilXmlImporter\getInstallId(), ilObject\getObjectProperties(), and ilAssQuestionSkillAssignmentImportFails\registerFailedImports().

Referenced by importXmlRepresentation().

                                                                                                              : ilAssQuestionSkillAssignmentList
    {
        $parser = new ilAssQuestionSkillAssignmentXmlParser($xmlFile);
        $parser->startParsing();

        $importer = new ilAssQuestionSkillAssignmentImporter();
        $importer->setTargetParentObjId($test_obj->getId());
        $importer->setImportInstallationId((int) $this->getInstallId());
        $importer->setImportMappingRegistry($mapping);
        $importer->setImportMappingComponent('Modules/Test');
        $importer->setImportAssignmentList($parser->getAssignmentList());

        $importer->import();

        if ($importer->getFailedImportAssignmentList()->assignmentsExist()) {
            $qsaImportFails = new ilAssQuestionSkillAssignmentImportFails($test_obj->getId());
            $qsaImportFails->registerFailedImports($importer->getFailedImportAssignmentList());

            $test_obj->getObjectProperties()->storePropertyIsOnline(
                $test_obj->getObjectProperties()->getPropertyIsOnline()->withOffline()
            );
        }

        return $importer->getSuccessImportAssignmentList();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

importRandomQuestionSetConfig()

ilTestImporter::importRandomQuestionSetConfig	(	ilObjTest	$test_obj,
			$xmlFile,
			$a_mapping
	)

Definition at line 318 of file class.ilTestImporter.php.

Referenced by importXmlRepresentation().

    {
        $test_obj->questions = [];
        $parser = new ilObjTestXMLParser($xmlFile);
        $parser->setTestOBJ($test_obj);
        $parser->setImportMapping($a_mapping);
        $parser->startParsing();
    }

Here is the caller graph for this function:

importSkillLevelThresholds()

ilTestImporter::importSkillLevelThresholds ( ilImportMapping  $mapping, ilAssQuestionSkillAssignmentList  $assignmentList, ilObjTest  $test_obj,   $xmlFile  )

protected

Parameters

ilImportMapping	$mapping
ilAssQuestionSkillAssignmentList	$assignmentList
ilObjTest	$test_obj
	$xmlFile

Definition at line 365 of file class.ilTestImporter.php.

References ilObject\getId(), ilXmlImporter\getInstallId(), ilObjTest\getTestId(), ilTestSkillLevelThresholdImportFails\registerFailedImports(), and ilObject\setOfflineStatus().

Referenced by importXmlRepresentation().

    {
        $parser = new ilTestSkillLevelThresholdXmlParser($xmlFile);
        $parser->initSkillLevelThresholdImportList();
        $parser->startParsing();

        $importer = new ilTestSkillLevelThresholdImporter($this->db);
        $importer->setTargetTestId($test_obj->getTestId());
        $importer->setImportInstallationId((int) $this->getInstallId());
        $importer->setImportMappingRegistry($mapping);
        $importer->setImportedQuestionSkillAssignmentList($assignmentList);
        $importer->setImportThresholdList($parser->getSkillLevelThresholdImportList());
        $importer->import();

        if ($importer->getFailedThresholdImportSkillList()->skillsExist()) {
            $sltImportFails = new ilTestSkillLevelThresholdImportFails($test_obj->getId());
            $sltImportFails->registerFailedImports($importer->getFailedThresholdImportSkillList());

            $test_obj->setOfflineStatus(true);
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

importXmlRepresentation()

ilTestImporter::importXmlRepresentation	(	string	$a_entity,
		string	$a_id,
		string	$a_xml,
		ilImportMapping	$a_mapping
	)

Import XML.

Parameters

string	$a_entity
string	$a_id
string	$a_xml
ilImportMapping	$a_mapping

Returns

void

Exceptions

ilDatabaseException
ilObjectNotFoundException
ilSaxParserException

Definition at line 62 of file class.ilTestImporter.php.

References $results, ilObjTest\_setImportDirectory(), ilImportMapping\addMapping(), addTexonomyAndQuestionsMapping(), ilSession\get(), ilImportMapping\getAllMappings(), ilXmlImporter\getImportDirectory(), getImportDirectoryContainer(), getImportPackageName(), ilObjectFactory\getInstanceByObjId(), ilImportMapping\getMapping(), ilImportMapping\getMappingsOfEntity(), ilQTIParser\IL_MO_PARSE_QTI, importQuestionSkillAssignments(), importRandomQuestionSetConfig(), importSkillLevelThresholds(), ILIAS\Repository\int(), parseXmlFileNames(), ilSession\set(), and ilQTIParser\setTestObject().

                                                                                                                      : void
    {
        ilObjTest::_setImportDirectory($this->getImportDirectoryContainer());

        if ($new_id = (int) $a_mapping->getMapping('Services/Container', 'objs', $a_id)) {
            // container content
            $new_obj = ilObjectFactory::getInstanceByObjId($new_id, false);
            ilSession::set('tst_import_subdir', $this->getImportPackageName());
            $new_obj->saveToDb(); // this generates test id first time
            $question_parent_obj_id = $new_obj->getId();
        } else {
            // single object
            $new_id = (int) $a_mapping->getMapping('Modules/Test', 'tst', 'new_id');
            $new_obj = ilObjectFactory::getInstanceByObjId($new_id, false);

            $question_parent_obj_id = (int) (ilSession::get('tst_import_qst_parent') ?? $new_obj->getId());
        }

        $new_obj->loadFromDb();

        list($xml_file, $qti_file) = $this->parseXmlFileNames();

        if (!@file_exists($xml_file)) {
            $this->log->write(__METHOD__ . ': Cannot find xml definition: ' . $xml_file);
            return;
        }
        if (!@file_exists($qti_file)) {
            $this->log->write(__METHOD__ . ': Cannot find xml definition: ' . $qti_file);
            return;
        }

        /* @var ilObjTest $new_obj */

        // FIXME: Copied from ilObjTestGUI::importVerifiedFileObject
        // TODO: move all logic to ilObjTest::importVerifiedFile and call
        // this method from ilObjTestGUI and ilTestImporter
        $new_obj->getMarkSchema()->flush();

        $idents = ilSession::get('tst_import_idents');

        // start parsing of QTI files
        $qtiParser = new ilQTIParser(
            $qti_file,
            ilQTIParser::IL_MO_PARSE_QTI,
            $question_parent_obj_id,
            $idents,
            $a_mapping->getAllMappings()
        );
        $qtiParser->setTestObject($new_obj);
        $qtiParser->startParsing();
        $new_obj = $qtiParser->getTestObject();

        // import page data
        $questionPageParser = new ilQuestionPageParser($new_obj, $xml_file, basename($this->getImportDirectory()));
        $questionPageParser->setQuestionMapping($qtiParser->getImportMapping());
        $questionPageParser->startParsing();

        $a_mapping = $this->addTexonomyAndQuestionsMapping($qtiParser->getQuestionIdMapping(), $new_obj->getId(), $a_mapping);

        if ($new_obj->isRandomTest()) {
            $this->importRandomQuestionSetConfig($new_obj, $xml_file, $a_mapping);
        }

        $results_file_path = ilSession::get("tst_import_results_file");
        // import test results
        if ($results_file_path !== null && file_exists($results_file_path)) {
            $results = new ilTestResultsImportParser($results_file_path, $new_obj, $this->db, $this->log, $this->irss);
            $results->setQuestionIdMapping($a_mapping->getMappingsOfEntity('Modules/Test', 'quest'));
            $results->setSrcPoolDefIdMapping($a_mapping->getMappingsOfEntity('Modules/Test', 'rnd_src_pool_def'));
            $results->startParsing();
        }

        $new_obj->saveToDb(); // this creates test_fi
        $new_obj->update(); // this saves ilObject data

        // import skill assignments
        $importedAssignmentList = $this->importQuestionSkillAssignments($a_mapping, $new_obj, $xml_file);
        $this->importSkillLevelThresholds($a_mapping, $importedAssignmentList, $new_obj, $xml_file);

        $a_mapping->addMapping("Modules/Test", "tst", (string) $a_id, (string) $new_obj->getId());
    }

Here is the call graph for this function:

parseXmlFileNames()

ilTestImporter::parseXmlFileNames ( )

protected

Create qti and xml file name.

Returns

array

Definition at line 292 of file class.ilTestImporter.php.

References ilXmlImporter\getImportDirectory().

Referenced by importXmlRepresentation().

                                          : array
    {
        $this->log->write(__METHOD__ . ': ' . $this->getImportDirectory());

        $basename = basename($this->getImportDirectory());

        $xml = $this->getImportDirectory() . '/' . $basename . '.xml';
        $qti = $this->getImportDirectory() . '/' . preg_replace('/test|tst/', 'qti', $basename) . '.xml';

        return [$xml,$qti];
    }

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

$db

ilDBInterface ilTestImporter::$db

private

Definition at line 38 of file class.ilTestImporter.php.

$finallyProcessedTestsRegistry

ilTestImporter::$finallyProcessedTestsRegistry = []

static

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

$irss

ResourceStorage ilTestImporter::$irss

private

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

$log

ilLogger ilTestImporter::$log

private

Definition at line 37 of file class.ilTestImporter.php.

---

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

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