ilTestQuestionPoolImporter Class Reference

This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V. More...

Inheritance diagram for ilTestQuestionPoolImporter:

Collaboration diagram for ilTestQuestionPoolImporter:

Public Member Functions
	importXmlRepresentation (string $a_entity, string $a_id, string $a_xml, ilImportMapping $a_mapping)
	Import XML. More...
	finalProcessing (ilImportMapping $a_mapping)
	Final processing. More...
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)

Protected Member Functions
	parseXmlFileNames ()
	Create qti and xml file name. More...
	importQuestionSkillAssignments ($xmlFile, ilImportMapping $mappingRegistry, $targetParentObjId)

Private Member Functions
	getImportDirectoryContainer ()
	getImportPackageName ()

Private Attributes
	$poolOBJ

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

This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V.

ILIAS is licensed with the GPL-3.0, see https://www.gnu.org/licenses/gpl-3.0.en.html You should have received a copy of said license along with the source code, too.

If this is not the case or you just want to try ILIAS, you'll find us at: https://www.ilias.de https://github.com/ILIAS-eLearning Importer class for question pools

Author

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

Version

$Id$

Definition at line 29 of file class.ilTestQuestionPoolImporter.php.

Member Function Documentation

finalProcessing()

ilTestQuestionPoolImporter::finalProcessing

(

ilImportMapping

$a_mapping

)

Final processing.

Parameters

ilImportMapping

$a_mapping

Returns

void

Definition at line 155 of file class.ilTestQuestionPoolImporter.php.

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

                                                               : void
    {
        //echo "<pre>".print_r($a_mapping, true)."</pre>"; exit;
        // get all glossaries of the import
        include_once("./Services/Taxonomy/classes/class.ilObjTaxonomy.php");
        $maps = $a_mapping->getMappingsOfEntity("Modules/TestQuestionPool", "qpl");
        foreach ($maps as $old => $new) {
            if ($old != "new_id" && (int) $old > 0) {
                // get all new taxonomys of this object
                $new_tax_ids = $a_mapping->getMapping("Services/Taxonomy", "tax_usage_of_obj", $old);
                if ($new_tax_ids !== false) {
                    $tax_ids = explode(":", $new_tax_ids);
                    foreach ($tax_ids as $tid) {
                        ilObjTaxonomy::saveUsage((int) $tid, $new);
                    }
                }

                $taxMappings = $a_mapping->getMappingsOfEntity('Services/Taxonomy', 'tax');
                foreach ($taxMappings as $oldTaxId => $newTaxId) {
                    if ($oldTaxId == $this->poolOBJ->getNavTaxonomyId()) {
                        $this->poolOBJ->setNavTaxonomyId($newTaxId);
                        $this->poolOBJ->saveToDb();
                        break;
                    }
                }
            }
        }
    }

Here is the call graph for this function:

getImportDirectoryContainer()

ilTestQuestionPoolImporter::getImportDirectoryContainer ( )

private

Definition at line 201 of file class.ilTestQuestionPoolImporter.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()

ilTestQuestionPoolImporter::getImportPackageName ( )

private

Definition at line 208 of file class.ilTestQuestionPoolImporter.php.

References $name, and 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:

importQuestionSkillAssignments()

ilTestQuestionPoolImporter::importQuestionSkillAssignments (   $xmlFile, ilImportMapping  $mappingRegistry,   $targetParentObjId  )

protected

Definition at line 215 of file class.ilTestQuestionPoolImporter.php.

References ilXmlImporter\getInstallId().

Referenced by importXmlRepresentation().

                                                                                                                     : void
    {
        require_once 'Modules/TestQuestionPool/classes/questions/class.ilAssQuestionSkillAssignmentXmlParser.php';
        $parser = new ilAssQuestionSkillAssignmentXmlParser($xmlFile);
        $parser->startParsing();

        require_once 'Modules/TestQuestionPool/classes/questions/class.ilAssQuestionSkillAssignmentImporter.php';
        $importer = new ilAssQuestionSkillAssignmentImporter();
        $importer->setTargetParentObjId($targetParentObjId);
        $importer->setImportInstallationId($this->getInstallId());
        $importer->setImportMappingRegistry($mappingRegistry);
        $importer->setImportMappingComponent('Modules/TestQuestionPool');
        $importer->setImportAssignmentList($parser->getAssignmentList());

        $importer->import();

        if ($importer->getFailedImportAssignmentList()->assignmentsExist()) {
            require_once 'Modules/TestQuestionPool/classes/questions/class.ilAssQuestionSkillAssignmentImportFails.php';
            $qsaImportFails = new ilAssQuestionSkillAssignmentImportFails($targetParentObjId);
            $qsaImportFails->registerFailedImports($importer->getFailedImportAssignmentList());

            $this->poolOBJ->setOnline(false);
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

importXmlRepresentation()

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

Import XML.

Parameters

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

References $DIC, ilObjQuestionPool\_setImportDirectory(), ilImportMapping\addMapping(), ilSession\clear(), ilSession\get(), ilXmlImporter\getImportDirectory(), getImportDirectoryContainer(), getImportPackageName(), ilObjectFactory\getInstanceByObjId(), ilImportMapping\getMapping(), ilQTIParser\IL_MO_PARSE_QTI, importQuestionSkillAssignments(), parseXmlFileNames(), ilSession\set(), and ilQTIParser\startParsing().

                                                                                                                      : void
    {
        /* @var ilObjQuestionPool $newObj */

        include_once "./Modules/TestQuestionPool/classes/class.ilObjQuestionPool.php";
        ilObjQuestionPool::_setImportDirectory($this->getImportDirectoryContainer());

        // Container import => pool object already created
        if ($new_id = $a_mapping->getMapping('Services/Container', 'objs', $a_id)) {
            $newObj = ilObjectFactory::getInstanceByObjId($new_id, false);
            $newObj->setOnline(true); // sets Question pools to always online

            ilSession::set('qpl_import_subdir', $this->getImportPackageName());
        } elseif ($new_id = $a_mapping->getMapping('Modules/TestQuestionPool', 'qpl', "new_id")) {
            $newObj = ilObjectFactory::getInstanceByObjId($new_id, false);
        } else {
            // Shouldn't happen
            global $DIC; /* @var ILIAS\DI\Container $DIC */
            $DIC['ilLog']->write(__METHOD__ . ': non container and no tax mapping, perhaps old qpl export');
            return;
        }



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

        global $DIC; /* @var ILIAS\DI\Container $DIC */
        if (!@file_exists($xml_file)) {
            $DIC['ilLog']->write(__METHOD__ . ': Cannot find xml definition: ' . $xml_file);
            return;
        }
        if (!@file_exists($qti_file)) {
            $DIC['ilLog']->write(__METHOD__ . ': Cannot find qti definition: ' . $qti_file);
            return;
        }

        $this->poolOBJ = $newObj;

        $newObj->fromXML($xml_file);

        // set another question pool name (if possible)
        if (isset($_POST["qpl_new"]) && strlen($_POST["qpl_new"])) {
            $newObj->setTitle($_POST["qpl_new"]);
        }

        $newObj->update();
        $newObj->saveToDb();

        // FIXME: Copied from ilObjQuestionPoolGUI::importVerifiedFileObject
        // TODO: move all logic to ilObjQuestionPoolGUI::importVerifiedFile and call
        // this method from ilObjQuestionPoolGUI and ilTestImporter

        global $DIC; /* @var ILIAS\DI\Container $DIC */
        $DIC['ilLog']->write(__METHOD__ . ': xml file: ' . $xml_file . ", qti file:" . $qti_file);

        if (ilSession::get("qpl_import_idents") !== null) {
            $idents = ilSession::get("qpl_import_idents");
            ilSession::clear("qpl_import_idents");
        } else {
            $idents = null;
        }

        // start parsing of QTI files
        include_once "./Services/QTI/classes/class.ilQTIParser.php";
        $qtiParser = new ilQTIParser($qti_file, ilQTIParser::IL_MO_PARSE_QTI, $newObj->getId(), $idents);
        $qtiParser->startParsing();

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

            foreach ($qtiParser->getImportMapping() as $k => $v) {
                $oldQuestionId = substr($k, strpos($k, 'qst_') + strlen('qst_'));
                $newQuestionId = $v['pool']; // yes, this is the new question id ^^

                $a_mapping->addMapping(
                    "Services/Taxonomy",
                    "tax_item",
                    "qpl:quest:$oldQuestionId",
                    $newQuestionId
                );

                $a_mapping->addMapping(
                    "Services/Taxonomy",
                    "tax_item_obj_id",
                    "qpl:quest:$oldQuestionId",
                    $newObj->getId()
                );

                $a_mapping->addMapping(
                    "Modules/TestQuestionPool",
                    "quest",
                    $oldQuestionId,
                    $newQuestionId
                );
            }
        }

        $this->importQuestionSkillAssignments($xml_file, $a_mapping, $newObj->getId());

        $a_mapping->addMapping("Modules/TestQuestionPool", "qpl", $a_id, $newObj->getId());

        ilObjQuestionPool::_setImportDirectory(null);

        $newObj->saveToDb();
    }

Here is the call graph for this function:

parseXmlFileNames()

ilTestQuestionPoolImporter::parseXmlFileNames ( )

protected

Create qti and xml file name.

Returns

array

Definition at line 188 of file class.ilTestQuestionPoolImporter.php.

References $DIC, $xml, and ilXmlImporter\getImportDirectory().

Referenced by importXmlRepresentation().

                                          : array
    {
        global $DIC; /* @var ILIAS\DI\Container $DIC */
        $DIC['ilLog']->write(__METHOD__ . ': ' . $this->getImportDirectory());

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

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

        return array($xml,$qti);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

$poolOBJ

ilTestQuestionPoolImporter::$poolOBJ

private

Definition at line 34 of file class.ilTestQuestionPoolImporter.php.

---

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

• Modules/TestQuestionPool/classes/class.ilTestQuestionPoolImporter.php