ilTestQuestionPoolImporter Class Reference

Importer class for question pools. More...

Inheritance diagram for ilTestQuestionPoolImporter:

Collaboration diagram for ilTestQuestionPoolImporter:

Public Member Functions
	__construct ()
	importXmlRepresentation (string $a_entity, string $a_id, string $a_xml, ilImportMapping $a_mapping)
	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
	importQuestionSkillAssignments ($xmlFile, ilImportMapping $mappingRegistry, $targetParentObjId)

Protected Attributes
readonly RequestDataCollector	$request_data_collector
Protected Attributes inherited from ilXmlImporter
array	$skip_entities = array()
ilImport	$imp
string	$install_id
string	$install_url
string	$schema_version
string	$import_directory

Private Attributes
ilObjQuestionPool	$pool_obj

Detailed Description

Importer class for question pools.

Author

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

Version

$Id$ \

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

Constructor & Destructor Documentation

__construct()

ilTestQuestionPoolImporter::__construct

(

)

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

References ILIAS\GlobalScreen\Provider\__construct().

    {
        parent::__construct();

        $local_dic = QuestionPoolDIC::dic();
        $this->request_data_collector = $local_dic['request_data_collector'];
    }

Here is the call graph for this function:

Member Function Documentation

finalProcessing()

ilTestQuestionPoolImporter::finalProcessing

(

ilImportMapping

$a_mapping

)

Final processing.

Parameters

ilImportMapping

$a_mapping

Returns

void

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

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

                                                               : void
    {
        $maps = $a_mapping->getMappingsOfEntity('components/ILIAS/TestQuestionPool', 'qpl');
        foreach ($maps as $old => $new) {
            if ($old !== 'new_id' && (int) $old > 0) {
                $new_tax_ids = $a_mapping->getMapping('components/ILIAS/Taxonomy', 'tax_usage_of_obj', (string) $old);
                if ($new_tax_ids !== null) {
                    $tax_ids = explode(':', $new_tax_ids);
                    foreach ($tax_ids as $tid) {
                        ilObjTaxonomy::saveUsage((int) $tid, (int) $new);
                    }
                }
            }
        }
    }

Here is the call graph for this function:

importQuestionSkillAssignments()

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

protected

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

References ilXmlImporter\getInstallId().

Referenced by importXmlRepresentation().

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

        $importer = new ilAssQuestionSkillAssignmentImporter();
        $importer->setTargetParentObjId($targetParentObjId);
        $importer->setImportInstallationId($this->getInstallId());
        $importer->setImportMappingRegistry($mappingRegistry);
        $importer->setImportMappingComponent('components/ILIAS/TestQuestionPool');
        $importer->setImportAssignmentList($parser->getAssignmentList());

        $importer->import();

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

            $this->pool_obj->getObjectProperties()->storePropertyIsOnline($this->pool_obj->getObjectProperties()->getPropertyIsOnline()->withOffline());
        }
    }

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
	)

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

References $DIC, ilImportMapping\addMapping(), ILIAS\TestQuestionPool\Import\buildImportDirectoriesFromContainerImport(), ILIAS\TestQuestionPool\Import\buildImportDirectoriesFromImportFile(), ilSession\clear(), ilSession\get(), ilXmlImporter\getImportDirectory(), ilObjectFactory\getInstanceByObjId(), ilImportMapping\getMapping(), ilQTIParser\IL_MO_PARSE_QTI, importQuestionSkillAssignments(), null, and ilQTIParser\startParsing().

     : void {
        global $DIC;
        // Container import => pool object already created
        if (($new_id = $a_mapping->getMapping('components/ILIAS/Container', 'objs', $a_id)) !== null) {
            $new_obj = ilObjectFactory::getInstanceByObjId((int) $new_id, false);
            $new_obj->getObjectProperties()->storePropertyIsOnline($new_obj->getObjectProperties()->getPropertyIsOnline()->withOffline()); // sets Question pools to always online

            $selected_questions = [];
            [$importdir, $xmlfile, $qtifile] = $this->buildImportDirectoriesFromContainerImport(
                $this->getImportDirectory()
            );
        } elseif (($new_id = $a_mapping->getMapping('components/ILIAS/TestQuestionPool', 'qpl', 'new_id')) !== null) {
            $new_obj = ilObjectFactory::getInstanceByObjId((int) $new_id, false);

            $selected_questions = ilSession::get('qpl_import_selected_questions');
            [$subdir, $importdir, $xmlfile, $qtifile] = $this->buildImportDirectoriesFromImportFile(
                ilSession::get('path_to_import_file')
            );
            ilSession::clear('qpl_import_selected_questions');
        } else {
            // Shouldn't happen
            $DIC['ilLog']->write(__METHOD__ . ': non container and no tax mapping, perhaps old qpl export');
            return;
        }

        if (!file_exists($xmlfile)) {
            $DIC['ilLog']->write(__METHOD__ . ': Cannot find xml definition: ' . $xmlfile);
            return;
        }
        if (!file_exists($qtifile)) {
            $DIC['ilLog']->write(__METHOD__ . ': Cannot find qti definition: ' . $qtifile);
            return;
        }

        $this->pool_obj = $new_obj;

        $new_obj->fromXML($xmlfile);

        $qpl_new = $this->request_data_collector->string('qpl_new');

        // set another question pool name (if possible)
        if ($qpl_new !== '') {
            $new_obj->setTitle($qpl_new);
        }

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

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

        $DIC['ilLog']->write(__METHOD__ . ': xml file: ' . $xmlfile . ', qti file:' . $qtifile);

        $qtiParser = new ilQTIParser(
            $importdir,
            $qtifile,
            ilQTIParser::IL_MO_PARSE_QTI,
            $new_obj->getId(),
            $selected_questions
        );
        $qtiParser->startParsing();

        $questionPageParser = new ilQuestionPageParser(
            $new_obj,
            $xmlfile,
            $importdir
        );
        $questionPageParser->setQuestionMapping($qtiParser->getImportMapping());
        $questionPageParser->startParsing();

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

            $a_mapping->addMapping(
                'components/ILIAS/Taxonomy',
                'tax_item',
                "qpl:quest:{$old_question_id}",
                $new_question_id
            );

            $a_mapping->addMapping(
                'components/ILIAS/Taxonomy',
                'tax_item_obj_id',
                "qpl:quest:{$old_question_id}",
                (string) $new_obj->getId()
            );

            $a_mapping->addMapping(
                'components/ILIAS/TestQuestionPool',
                'quest',
                $old_question_id,
                $new_question_id
            );
        }

        $this->importQuestionSkillAssignments($xmlfile, $a_mapping, $new_obj->getId());

        $a_mapping->addMapping('components/ILIAS/TestQuestionPool', 'qpl', $a_id, (string) $new_obj->getId());
        $a_mapping->addMapping(
            'components/ILIAS/MetaData',
            'md',
            $a_id . ':0:qpl',
            $new_obj->getId() . ':0:qpl'
        );


        $new_obj->saveToDb();
    }

Here is the call graph for this function:

Field Documentation

$pool_obj

ilObjQuestionPool ilTestQuestionPoolImporter::$pool_obj

private

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

$request_data_collector

readonly RequestDataCollector ilTestQuestionPoolImporter::$request_data_collector

protected

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

---

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

• components/ILIAS/TestQuestionPool/classes/class.ilTestQuestionPoolImporter.php