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

Inheritance diagram for ilContainerImporter:

Collaboration diagram for ilContainerImporter:

Public Member Functions
	init ()

	importXmlRepresentation (string $a_entity, string $a_id, string $a_xml, ilImportMapping $a_mapping)
	Import XML. More...

	finalProcessing (ilImportMapping $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)

Protected Member Functions
	handleOfflineStatus (string $xml, ilImportMapping $mapping)

	isRootNode (int $ref_id, ilImportMapping $mapping)

Protected Attributes
ilLogger	$cont_log

ILIAS Skill Service SkillProfileService	$skill_profile_service

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
string	$structure_xml

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 container xml importer

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

Definition at line 24 of file class.ilContainerImporter.php.

Member Function Documentation

◆ finalProcessing()

ilContainerImporter::finalProcessing ( ilImportMapping $a_mapping )

Definition at line 56 of file class.ilContainerImporter.php.

References $parts, ilContainerXmlParser\$style_map, ilObject\_getAllReferences(), ilPageObject\_writeParentId(), ilParticipants\getDefaultMemberRole(), ilImportMapping\getMapping(), ilImportMapping\getMappingsOfEntity(), handleOfflineStatus(), and ilObjStyleSheet\writeStyleUsage().

                                                                : void
     {
         $this->handleOfflineStatus($this->structure_xml, $a_mapping);
         // pages
         $page_map = $a_mapping->getMappingsOfEntity('Services/COPage', 'pg');
         foreach ($page_map as $old_pg_id => $new_pg_id) {
             $parts = explode(':', $old_pg_id);
             $pg_type = $parts[0];
             $old_obj_id = $parts[1];
             $parts = explode(':', $new_pg_id);
             $new_pg_id = array_pop($parts);
             $new_obj_id = $a_mapping->getMapping('Services/Container', 'objs', $old_obj_id);
             // see bug #22718, this missed a check for the pg type
             if ($new_obj_id > 0 && in_array($pg_type, ["crs", "grp", "fold", "cont"], true)) {
                 ilPageObject::_writeParentId($pg_type, (int) $new_pg_id, (int) $new_obj_id);
                 $this->cont_log->debug('write parent id, type: ' . $pg_type . ", page id: " . $new_pg_id . ", parent id: " . $new_obj_id);
             }
         }
 
         // style
         $sty_map = $a_mapping->getMappingsOfEntity('Services/Style', 'sty');
         foreach ($sty_map as $old_sty_id => $new_sty_id) {
             if (isset(ilContainerXmlParser::$style_map[$old_sty_id])) {
                 foreach (ilContainerXmlParser::$style_map[$old_sty_id] as $obj_id) {
                     ilObjStyleSheet::writeStyleUsage((int) $obj_id, (int) $new_sty_id);
                 }
             }
         }
 
         // skills
         $crs_map = $a_mapping->getMappingsOfEntity('Modules/Course', 'crs');
         $new_crs_obj_id = end($crs_map);
         $new_crs_ref_ids = ilObject::_getAllReferences((int) $new_crs_obj_id);
         $new_crs_ref_id = end($new_crs_ref_ids);
 
         $skl_local_prof_map = $a_mapping->getMappingsOfEntity('Services/Skill', 'skl_local_prof');
         foreach ($skl_local_prof_map as $old_prof_id => $new_prof_id) {
             $this->skill_profile_service->updateRefIdAfterImport((int) $new_prof_id, (int) $new_crs_ref_id);
             $this->skill_profile_service->addRoleToProfile(
                 (int) $new_prof_id,
                 ilParticipants::getDefaultMemberRole((int) $new_crs_ref_id)
             );
         }
     }

Here is the call graph for this function:

◆ handleOfflineStatus()

ilContainerImporter::handleOfflineStatus	(	string	$xml,
		ilImportMapping	$mapping
	)

protected

Definition at line 101 of file class.ilContainerImporter.php.

References $errors, $name, $ref_id, ilObjectFactory\getInstanceByRefId(), ilImportMapping\getMapping(), and isRootNode().

Referenced by finalProcessing().

                                                                                  : void
     {
         $use_internal_errors = libxml_use_internal_errors(true);
         $root = simplexml_load_string($xml);
         libxml_use_internal_errors($use_internal_errors);
         if ($root === false) {
             $errors = '';
             foreach (libxml_get_errors() as $err) {
                 $errors .= $err->code . '<br/>';
             }
             $this->cont_log->error($xml);
             $this->cont_log->error('Cannot parse xml: ' . $errors);
         }
         foreach ($root->xpath('//Item') as $item) {
             $ref_id = 0;
             $offline = null;
             foreach ($item->attributes() as $name => $value) {
                 if ((string) $name === 'Offline') {
                     $offline = $value;
                 }
                 if ((string) $name === 'RefId') {
                     $ref_id = (string) $value;
                 }
             }
             if (is_null($offline)) {
                 $this->cont_log->debug('No offline handling for ref_id: ' . $ref_id);
                 continue;
             }
             $new_ref_id = $mapping->getMapping('Services/Container', 'refs', $ref_id);
             $obj = ilObjectFactory::getInstanceByRefId((int) $new_ref_id, false);
             if (!$obj instanceof ilObject) {
                 $this->cont_log->warning('Cannot create instance for ref_id: ' . $new_ref_id);
                 continue;
             }
             if ($obj->supportsOfflineHandling()) {
                 if ($this->isRootNode($obj->getRefId(), $mapping)) {
                     $obj->setOfflineStatus(true);
                 } else {
                     // use the offline status of the imported XML file and set the offline status for the new container objects accordingly
                     $obj->setOfflineStatus(!((string) $offline === "0"));
                 }
                 $obj->update();
             }
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ importXmlRepresentation()

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

Import XML.

Definition at line 43 of file class.ilContainerImporter.php.

                                                                                                                       : void
     {
         $this->structure_xml = $a_xml;
         $this->cont_log->debug('Import xml: ' . $a_xml);
         $this->cont_log->debug('Using id: ' . $a_id);
 
         $parser = new ilContainerXmlParser($a_mapping, trim($a_xml));
         $parser->parse($a_id);
     }

◆ init()

ilContainerImporter::init ( )

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

References $DIC, and ilLoggerFactory\getLogger().

                           : void
     {
         global $DIC;
 
         $this->cont_log = ilLoggerFactory::getLogger('cont');
         $this->skill_profile_service = $DIC->skills()->profile();
     }

Here is the call graph for this function:

◆ isRootNode()

ilContainerImporter::isRootNode	(	int	$ref_id,
		ilImportMapping	$mapping
	)

protected

Definition at line 147 of file class.ilContainerImporter.php.

References $DIC, and ilImportMapping\getTargetId().

Referenced by handleOfflineStatus().

                                                                         : bool
     {
         global $DIC;
 
         $tree = $DIC->repositoryTree();
         $parent_id = $tree->getParentId($ref_id);
         if ($parent_id) {
             return $parent_id === $mapping->getTargetId();
         }
         return false;
     }