Inheritance diagram for ilExport:

Collaboration diagram for ilExport:

Public Member Functions
	__construct ()
	Default constructor. More...

	_getExportFiles ($a_obj_id, $a_export_types="", $a_obj_type="")
	Get Export Files for a repository object. More...

	_createExportDirectory ($a_obj_id, $a_export_type="xml", $a_obj_type="")
	Create export directory. More...

	_generateIndexFile ($a_filename, $a_obj_id, $a_files, $a_type="")
	Generates an index.html file including links to all xml files included (for container exports) More...

	exportObject ($a_type, $a_id, $a_target_release)
	Export an ILIAS object (the object type must be known by objDefinition) More...

	exportEntity ($a_entity, $a_id, $a_target_release, $a_component, $a_title, $a_export_dir, $a_type_for_file="")
	Export an ILIAS entity. More...

	processExporter ($a_comp, $a_class, $a_entity, $a_target_release, $a_id)
	Process exporter. More...

Static Public Member Functions
static	_getValidExportSubItems ($a_ref_id)
	Get a list of subitems of a repository resource, that implement the export. More...

static	_getLastExportFileDate ($a_obj_id, $a_type="", $a_obj_type="")
	Get date of last export file. More...

static	_getLastExportFileInformation ($a_obj_id, $a_type="", $a_obj_type="")
	Get last export file information. More...

static	_getExportDirectory ($a_obj_id, $a_type="xml", $a_obj_type="", $a_entity="")
	Get export directory for an repository object. More...

Static Public Attributes
static	$new_file_structure = array('cat','exc','crs','sess','file','grp','frm', 'usr', 'catr', 'crsr')

static	$export_implementer = array("tst", "lm", "glo")

Detailed Description

Definition at line 13 of file class.ilExport.php.

Constructor & Destructor Documentation

◆ __construct()

ilExport::__construct ( )

Default constructor.

Returns

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

        {
                
        }

Member Function Documentation

◆ _createExportDirectory()

ilExport::_createExportDirectory	(	$a_obj_id,
		$a_export_type = `"xml"`,
		$a_obj_type = `""`
	)

Create export directory.

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

        {
                global $ilErr;
                
                if ($a_obj_type == "")
                {
                        $a_obj_type = ilObject::_lookupType($a_obj_id);
                }
 
                $edir = ilExport::_getExportDirectory($a_obj_id,$a_export_type,$a_obj_type);
                ilUtil::makeDirParents($edir);
                return true;
        }

References $ilErr, _getExportDirectory(), ilObject\_lookupType(), and ilUtil\makeDirParents().

Referenced by ilObjBlogGUI\buildExportFile(), ilPortfolioHTMLExport\buildExportFile(), ilWikiHTMLExport\buildExportFile(), ilObjGlossary\createExportDirectory(), ilObjFileBasedLMGUI\exportHTML(), exportObject(), ilExportContainer\exportObject(), and ilOrgUnitExporter\sendAndCreateSimpleExportFile().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _generateIndexFile()

ilExport::_generateIndexFile	(	$a_filename,
		$a_obj_id,
		$a_files,
		$a_type = `""`
	)

Generates an index.html file including links to all xml files included (for container exports)

Definition at line 217 of file class.ilExport.php.

        {
                global $lng;
                
                $lng->loadLanguageModule("export");
                
                if ($a_type == "")
                {
                        $a_type = ilObject::_lookupType($a_obj_id);
                }
                $a_tpl = new ilTemplate("tpl.main.html", true, true);
                $location_stylesheet = ilUtil::getStyleSheetLocation();
                $a_tpl->setVariable("LOCATION_STYLESHEET",$location_stylesheet);
                $a_tpl->getStandardTemplate();
                $a_tpl->setTitle(ilObject::_lookupTitle($a_obj_id));
                $a_tpl->setDescription($lng->txt("export_export_date").": ".
                        date('Y-m-d H:i:s', time())." (".date_default_timezone_get().")");
                $f_tpl = new ilTemplate("tpl.export_list.html", true, true, "Services/Export");
                foreach ($a_files as $file)
                {
                        $f_tpl->setCurrentBlock("file_row");
                        $f_tpl->setVariable("TITLE", $file["title"]);
                        $f_tpl->setVariable("TYPE", $lng->txt("obj_".$file["type"]));
                        $f_tpl->setVariable("FILE", $file["file"]);
                        $f_tpl->parseCurrentBlock();
                }
                $a_tpl->setContent($f_tpl->get());
                $index_content = $a_tpl->get("DEFAULT", false, false, false, true, false, false);
 
                $f = fopen ($a_filename, "w");
                fwrite($f, $index_content);
                fclose($f);
        }

References $file, $lng, ilObject\_lookupTitle(), ilObject\_lookupType(), and ilUtil\getStyleSheetLocation().

Referenced by ilCourseArchives\addXML().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _getExportDirectory()

static ilExport::_getExportDirectory	(	$a_obj_id,
		$a_type = `"xml"`,
		$a_obj_type = `""`,
		$a_entity = `""`
	)

static

Get export directory for an repository object.

Parameters

int	$a_obj_id	object id
string	$a_type	export type ("xml", "html", ...), default "xml"
string	$a_obj_type	object type (optional, if not given, type is looked up)

Returns: string export directory

Definition at line 99 of file class.ilExport.php.

        {
                global $objDefinition;
                
                $ent = ($a_entity == "")
                        ? ""
                        : "_".$a_entity;
 
                
                if ($a_obj_type == "")
                {
                        $a_obj_type = ilObject::_lookupType($a_obj_id);
                }
                
                if(in_array($a_obj_type, self::$new_file_structure))
                {
                        include_once './Services/FileSystem/classes/class.ilFileSystemStorage.php';
                        $dir = ilUtil::getDataDir().DIRECTORY_SEPARATOR;
                        $dir .= 'il'.$objDefinition->getClassName($a_obj_type).$ent.DIRECTORY_SEPARATOR;
                        $dir .= ilFileSystemStorage::_createPathFromId($a_obj_id, $a_obj_type).DIRECTORY_SEPARATOR;
                        $dir .= ($a_type == 'xml' ? 'export' : 'export_'.$a_type);
                        return $dir;
                }
 
                include_once './Services/Export/classes/class.ilImportExportFactory.php';
                $exporter_class = ilImportExportFactory::getExporterClass($a_obj_type);
                $export_dir = call_user_func(array($exporter_class,'lookupExportDirectory'),$a_obj_type,$a_obj_id,$a_type,$a_entity);
 
                $GLOBALS['ilLog']->write(__METHOD__.': Export dir is '.$export_dir);
                return $export_dir;
        }

References $GLOBALS, ilFileSystemStorage\_createPathFromId(), ilObject\_lookupType(), and ilUtil\getDataDir().

Referenced by ilCourseArchives\__addZipFiles(), _createExportDirectory(), _getExportFiles(), ilExportContainer\addSubitems(), ilObjBlogGUI\buildExportFile(), ilPortfolioHTMLExport\buildExportFile(), ilWikiHTMLExport\buildExportFile(), ilExportGUI\delete(), ilExportGUI\download(), ilObjFileBasedLMGUI\exportHTML(), exportObject(), ilExportContainer\exportObject(), ilObjUser\exportPersonalData(), ilObjGlossary\getExportDirectory(), ilObjUser\getPersonalDataExportFile(), ilOrgUnitExporter\sendAndCreateSimpleExportFile(), and ilObjUser\sendPersonalDataFile().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _getExportFiles()

ilExport::_getExportFiles	(	$a_obj_id,
		$a_export_types = `""`,
		$a_obj_type = `""`
	)

Get Export Files for a repository object.

Definition at line 134 of file class.ilExport.php.

        {
                $GLOBALS['ilLog']->write(__METHOD__);
 
                if ($a_obj_type == "")
                {
                        $a_obj_type = ilObject::_lookupType($a_obj_id);
                }
 
                if ($a_export_types == "")
                {
                        $a_export_types = array("xml");
                }
                if (!is_array($a_export_types))
                {
                        $a_export_types = array($a_export_types);
                }
 
                // initialize array
                $file = array();
                
                $types = $a_export_types;
 
                foreach($types as $type)
                {
                        $dir = ilExport::_getExportDirectory($a_obj_id, $type, $a_obj_type);
                        
                        // quit if import dir not available
                        if (!@is_dir($dir) or
                                !is_writeable($dir))
                        {
                                continue;
                        }
 
                        // open directory
                        $h_dir = dir($dir);
 
                        // get files and save the in the array
                        while ($entry = $h_dir->read())
                        {
                                if ($entry != "." and
                                        $entry != ".." and
                                        substr($entry, -4) == ".zip" and
                                        ereg("^[0-9]{10}_{2}[0-9]+_{2}(".$a_obj_type."_)*[0-9]+\.zip\$", $entry))
                                {
                                        $ts = substr($entry, 0, strpos($entry, "__"));
                                        $file[$entry.$type] = array("type" => $type, "file" => $entry,
                                                "size" => filesize($dir."/".$entry),
                                                "timestamp" => $ts);
                                }
                        }
        
                        // close import directory
                        $h_dir->close();
                }
 
                // sort files
                ksort ($file);
                reset ($file);
                return $file;
        }

References $file, $GLOBALS, _getExportDirectory(), and ilObject\_lookupType().

Referenced by _getLastExportFileDate(), _getLastExportFileInformation(), ilObjGlossary\getExportFiles(), and ilExportTableGUI\getExportFiles().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _getLastExportFileDate()

static ilExport::_getLastExportFileDate	(	$a_obj_id,
		$a_type = `""`,
		$a_obj_type = `""`
	)

static

Get date of last export file.

Parameters

int	$a_obj_id	object id
string	$a_type	export type ("xml", "html", ...), default "xml"
string	$a_obj_type	object type (optional, if not given, type is looked up)

Definition at line 61 of file class.ilExport.php.

        {
                $files = ilExport::_getExportFiles($a_obj_id, $a_type, $a_obj_type);
                if (is_array($files))
                {
                        $files = ilUtil::sortArray($files, "timestamp", "desc");
                        return $files[0]["timestamp"];
                }
                return false;
        }

References _getExportFiles(), and ilUtil\sortArray().

Referenced by _getValidExportSubItems().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _getLastExportFileInformation()

static ilExport::_getLastExportFileInformation	(	$a_obj_id,
		$a_type = `""`,
		$a_obj_type = `""`
	)

static

Get last export file information.

Parameters

int	$a_obj_id	object id
string	$a_type	export type ("xml", "html", ...), default "xml"
string	$a_obj_type	object type (optional, if not given, type is looked up)

Definition at line 79 of file class.ilExport.php.

        {
                $files = ilExport::_getExportFiles($a_obj_id, $a_type, $a_obj_type);
                if (is_array($files))
                {
                        $files = ilUtil::sortArray($files, "timestamp", "desc");
                        return $files[0];
                }
                return false;
        }

References _getExportFiles(), and ilUtil\sortArray().

Referenced by ilCourseArchives\__addZipFiles().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _getValidExportSubItems()

static ilExport::_getValidExportSubItems ( $a_ref_id )

static

Get a list of subitems of a repository resource, that implement the export.

Includes also information on last export file.

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

        {
                global $tree;
                
                $valid_items = array();
                $sub_items = $tree->getSubTree($tree->getNodeData($a_ref_id));
                foreach ($sub_items as $sub_item)
                {
                        if (in_array($sub_item["type"], self::$export_implementer))
                        {
                                $valid_items[] = array("type" => $sub_item["type"],
                                        "title" => $sub_item["title"], "ref_id" => $sub_item["child"],
                                        "obj_id" => $sub_item["obj_id"],
                                        "timestamp" =>
                                        ilExport::_getLastExportFileDate($sub_item["obj_id"], "xml", $sub_item["type"]));
                        }
                }
                return $valid_items;
        }

References _getLastExportFileDate().

Referenced by ilSubItemSelectionTableGUI\ilSubItemSelectionTableGUI().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ exportEntity()

ilExport::exportEntity	(	$a_entity,
		$a_id,
		$a_target_release,
		$a_component,
		$a_title,
		$a_export_dir,
		$a_type_for_file = `""`
	)

Export an ILIAS entity.

Parameters

string	$a_entity	entity type, e.g. "sty"
mixed	$a_id	entity id
string	$a_target_release	target release
string	$a_component	component that exports (e.g. "Services/Style")

Returns: array success and info array

Definition at line 353 of file class.ilExport.php.

        {
                global $objDefinition, $tpl;
                
                if ($a_type_for_file == "")
                {
                        $a_type_for_file = $a_entity;
                }
                
                $comp = $a_component;
                $c = explode("/", $comp);
                $class = "il".$c[1]."Exporter";
                
                // manifest writer
                include_once "./Services/Xml/classes/class.ilXmlWriter.php";
                $this->manifest_writer = new ilXmlWriter();
                $this->manifest_writer->xmlHeader();
                $this->manifest_writer->xmlStartTag(
                        'Manifest',
                        array(
                                "MainEntity" => $a_entity, 
                                "Title" => $a_title, 
                                "TargetRelease" => $a_target_release,
                                "InstallationId" => IL_INST_ID, 
                                "InstallationUrl" => ILIAS_HTTP_PATH));
 
                $export_dir = $a_export_dir;
                $ts = time();
                
                // determine file name and subdirectory
                $sub_dir = $ts.'__'.IL_INST_ID.'__'.$a_type_for_file.'_'.$a_id;
                $new_file = $sub_dir.'.zip';
                
                $this->export_run_dir = $export_dir."/".$sub_dir;
                ilUtil::makeDirParents($this->export_run_dir);
 
                $this->cnt = array();
                
                $success = $this->processExporter($comp, $class, $a_entity, $a_target_release, $a_id);
 
                $this->manifest_writer->xmlEndTag('Manifest');
 
                $this->manifest_writer->xmlDumpFile($this->export_run_dir."/manifest.xml", false);
 
                // zip the file
                ilUtil::zip($this->export_run_dir, $export_dir."/".$new_file);
                ilUtil::delDir($this->export_run_dir);
 
                return array(
                        "success" => $success,
                        "file" => $new_file,
                        "directory" => $export_dir
                        );
        }

References $success, $tpl, ilUtil\delDir(), ilUtil\makeDirParents(), processExporter(), and ilUtil\zip().

Here is the call graph for this function:

◆ exportObject()

ilExport::exportObject	(	$a_type,
		$a_id,
		$a_target_release
	)

Export an ILIAS object (the object type must be known by objDefinition)

Parameters

string	$a_type	repository object type
int	$a_id	id of object or entity that shoudl be exported
string	$a_target_release	target release

Returns: array success and info array

Reimplemented in ilExportContainer.

Definition at line 279 of file class.ilExport.php.

        {
                global $objDefinition, $tpl;
                                
                $comp = $objDefinition->getComponentForType($a_type);
                $c = explode("/", $comp);
                $class = "il".$c[1]."Exporter";
                
                // manifest writer
                include_once "./Services/Xml/classes/class.ilXmlWriter.php";
                $this->manifest_writer = new ilXmlWriter();
                $this->manifest_writer->xmlHeader();
                $this->manifest_writer->xmlStartTag(
                        'Manifest',
                        array(
                                "MainEntity" => $a_type, 
                                "Title" => ilObject::_lookupTitle($a_id), 
                                "TargetRelease" => $a_target_release,
                                "InstallationId" => IL_INST_ID, 
                                "InstallationUrl" => ILIAS_HTTP_PATH));
 
                // get export class
                ilExport::_createExportDirectory($a_id, "xml", $a_type);
                $export_dir = ilExport::_getExportDirectory($a_id, "xml", $a_type);
                $ts = time();
                
                // Workaround for test assessment
                $sub_dir = $ts.'__'.IL_INST_ID.'__'.$a_type.'_'.$a_id;
                $new_file = $sub_dir.'.zip';
                
                $this->export_run_dir = $export_dir."/".$sub_dir;
                ilUtil::makeDirParents($this->export_run_dir);
 
                $this->cnt = array();
                
                $success = $this->processExporter($comp, $class, $a_type, $a_target_release, $a_id);
 
                $this->manifest_writer->xmlEndTag('Manifest');
 
                $this->manifest_writer->xmlDumpFile($this->export_run_dir."/manifest.xml", false);
 
                // zip the file
                ilUtil::zip($this->export_run_dir, $export_dir."/".$new_file);
                ilUtil::delDir($this->export_run_dir);
 
                // Store info about export
                if($success)
                {
                        include_once './Services/Export/classes/class.ilExportFileInfo.php';
                        $exp = new ilExportFileInfo($a_id);
                        $exp->setVersion($a_target_release);
                        $exp->setCreationDate(new ilDateTime($ts,IL_CAL_UNIX));
                        $exp->setExportType('xml');
                        $exp->setFilename($new_file);
                        $exp->create();
                }
 
                return array(
                        "success" => $success,
                        "file" => $new_file,
                        "directory" => $export_dir
                        );
        }

References $success, $tpl, _createExportDirectory(), _getExportDirectory(), ilObject\_lookupTitle(), ilUtil\delDir(), IL_CAL_UNIX, ilUtil\makeDirParents(), processExporter(), and ilUtil\zip().

Here is the call graph for this function:

◆ processExporter()

ilExport::processExporter	(	$a_comp,
		$a_class,
		$a_entity,
		$a_target_release,
		$a_id
	)

Process exporter.

Parameters

return

Definition at line 415 of file class.ilExport.php.

        {
                $success = true;
 
                if (!is_array($a_id))
                {
                        if ($a_id == "")
                        {
                                return;
                        }
                        $a_id = array($a_id);
                }
 
                // get exporter object
                $export_class_file = "./".$a_comp."/classes/class.".$a_class.".php";
//echo "1-".$export_class_file."-"; exit;
                if (!is_file($export_class_file))
                {
echo "1-not found:".$export_class_file."-"; exit;
                        return false;
                }
                include_once($export_class_file);
                $exp = new $a_class();
                if (!isset($this->cnt[$a_comp]))
                {
                        $this->cnt[$a_comp] = 1;
                }
                else
                {
                        $this->cnt[$a_comp]++;
                }
                $set_dir_relative = $a_comp."/set_".$this->cnt[$a_comp];
                $set_dir_absolute = $this->export_run_dir."/".$set_dir_relative;
                ilUtil::makeDirParents($set_dir_absolute);
                $exp->init();
 
                $sv = $exp->determineSchemaVersion($a_entity, $a_target_release);
 
                // process head dependencies
                $sequence = $exp->getXmlExportHeadDependencies($a_entity, $a_target_release, $a_id);
                foreach ($sequence as $s)
                {
                        $comp = explode("/", $s["component"]);
                        $exp_class = "il".$comp[1]."Exporter";
                        $s = $this->processExporter($s["component"], $exp_class,
                                $s["entity"], $a_target_release, $s["ids"]);
                        if (!$s)
                        {
                                $success = false;
                        }
                }
 
                // write export.xml file
                $export_writer = new ilXmlWriter();
                $export_writer->xmlHeader();
 
                $attribs = array("InstallationId" => IL_INST_ID,
                        "InstallationUrl" => ILIAS_HTTP_PATH,
                        "Entity" => $a_entity, "SchemaVersion" => $sv["schema_version"], "TargetRelease" => $a_target_release,
                        "xmlns:xsi" => "http://www.w3.org/2001/XMLSchema-instance",
                        "xmlns:exp" => "http://www.ilias.de/Services/Export/exp/4_1",
                        "xsi:schemaLocation" => "http://www.ilias.de/Services/Export/exp/4_1 ".ILIAS_HTTP_PATH."/xml/ilias_export_4_1.xsd"
                        );
                if ($sv["namespace"] != "" && $sv["xsd_file"] != "")
                {
                        $attribs["xsi:schemaLocation"].= " ".$sv["namespace"]." ".
                                ILIAS_HTTP_PATH."/xml/".$sv["xsd_file"];
                        $attribs["xmlns"] = $sv["namespace"];
                }
                if ($sv["uses_dataset"])
                {
                        $attribs["xsi:schemaLocation"].= " ".
                                "http://www.ilias.de/Services/DataSet/ds/4_3 ".ILIAS_HTTP_PATH."/xml/ilias_ds_4_3.xsd";
                        $attribs["xmlns:ds"] = "http://www.ilias.de/Services/DataSet/ds/4_3";
                }
 
 
                $export_writer->xmlStartTag('exp:Export', $attribs);
 
                $dir_cnt = 1;
                foreach ($a_id as $id)
                {
                        $exp->setExportDirectories($set_dir_relative."/expDir_".$dir_cnt,
                                $set_dir_absolute."/expDir_".$dir_cnt);
                        $export_writer->xmlStartTag('exp:ExportItem', array("Id" => $id));
                        //$xml = $exp->getXmlRepresentation($a_entity, $a_target_release, $id);
                        $xml = $exp->getXmlRepresentation($a_entity, $sv["schema_version"], $id);
                        $export_writer->appendXml($xml);
                        $export_writer->xmlEndTag('exp:ExportItem');
                        $dir_cnt++;
                }
                
                $export_writer->xmlEndTag('exp:Export');
                $export_writer->xmlDumpFile($set_dir_absolute."/export.xml", false);
                
                $this->manifest_writer->xmlElement("ExportFile",
                        array("Component" => $a_comp, "Path" => $set_dir_relative."/export.xml"));
 
                // process tail dependencies
                $sequence = $exp->getXmlExportTailDependencies($a_entity, $a_target_release, $a_id);
                foreach ($sequence as $s)
                {
                        $comp = explode("/", $s["component"]);
                        $exp_class = "il".$comp[1]."Exporter";
                        $s = $this->processExporter($s["component"], $exp_class,
                                $s["entity"], $a_target_release, $s["ids"]);
                        if (!$s)
                        {
                                $success = false;
                        }
                }
 
                return $success;
        }

References $success, exit, ilUtil\makeDirParents(), and processExporter().

Referenced by exportEntity(), exportObject(), and processExporter().

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

◆ $export_implementer

ilExport::$export_implementer = array("tst", "lm", "glo")

static

Definition at line 18 of file class.ilExport.php.

◆ $new_file_structure

ilExport::$new_file_structure = array('cat','exc','crs','sess','file','grp','frm', 'usr', 'catr', 'crsr')

static

Definition at line 15 of file class.ilExport.php.

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

Services/Export/classes/class.ilExport.php

Public Member Functions

Static Public Member Functions

Static Public Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ _createExportDirectory()

◆ _generateIndexFile()

◆ _getExportDirectory()

◆ _getExportFiles()

◆ _getLastExportFileDate()

◆ _getLastExportFileInformation()

◆ _getValidExportSubItems()

◆ exportEntity()

◆ exportObject()

◆ processExporter()

Field Documentation

◆ $export_implementer

◆ $new_file_structure