ILIAS  trunk Revision v11.0_alpha-3011-gc6b235a2e85
ilHelpDataSet 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 ilHelpDataSet:
+ Collaboration diagram for ilHelpDataSet:

Public Member Functions

 __construct ()
 
 getSupportedVersions ()
 
 readData (string $a_entity, string $a_version, array $a_ids)
 Read data from DB. More...
 
 importRecord (string $a_entity, array $a_types, array $a_rec, ilImportMapping $a_mapping, string $a_schema_version)
 Needs to be overwritten for import use case. More...
 
- Public Member Functions inherited from ilDataSet
 __construct ()
 
 init (string $a_entity, string $a_schema_version)
 Init. More...
 
 getSupportedVersions ()
 
 readData (string $a_entity, string $a_version, array $a_ids)
 Read data from DB. More...
 
 initByExporter (ilXmlExporter $xml_exporter)
 
 setImportDirectory (string $a_val)
 
 getImportDirectory ()
 
 setDSPrefix (string $a_val)
 
 getDSPrefix ()
 
 getDSPrefixString ()
 
 getDirectDataFromQuery (string $a_query, bool $a_convert_to_leading_upper=true, bool $a_set=true)
 Get data from query.This is a standard procedure, all db field names are directly mapped to abstract fields. More...
 
 convertToLeadingUpper (string $a_str)
 Make xyz_abc a XyzAbc string. More...
 
 getXmlRepresentation (string $a_entity, string $a_schema_version, ?array $a_ids, string $a_field="", bool $a_omit_header=false, bool $a_omit_types=false)
 Get xml representation <dataset install_id="123" install_url="..."> <types entity="table_name" version="4.0.1"> <ftype name="field_1" type="text" > <ftype name="field_2" type="date" > <ftype name="field_3" type="integer" > </types> <types ...> ... </types> <set entity="table_name"> <rec> <field_1>content</field_1> <field_2>my_date</field_2> <field_3>my_number</field_3> </rec> ... </set> </dataset> More...
 
 addRecordsXml (ilXmlWriter $a_writer, array $a_prefixes, string $a_entity, string $a_schema_version, array $a_ids, ?string $a_field="")
 
 afterXmlRecordWriting (string $a_entity, string $a_version, array $a_set)
 
 getNamespaces (array &$namespaces, string $a_entity, string $a_schema_version)
 
 getXmlRecord (string $a_entity, string $a_version, array $a_set)
 Get xml record for version. More...
 
 getXmlTypes (string $a_entity, string $a_version)
 Get xml types. More...
 
 getXMLEntityName (string $a_entity, string $a_version)
 Get entity name for xml (may be overwritten) More...
 
 getXMLEntityTag (string $a_entity, string $a_schema_version)
 Get entity tag. More...
 
 setImport (ilSurveyImporter $a_val)
 
 getImport ()
 
 setCurrentInstallationId (string $a_val)
 
 getCurrentInstallationId ()
 
 importRecord (string $a_entity, array $a_types, array $a_rec, ilImportMapping $a_mapping, string $a_schema_version)
 Needs to be overwritten for import use case. More...
 
 getCollection (array $record, string $entity, string $schema_version, string $field, string $value)
 
 getContainerExportConfig (array $record, string $entity, string $schema_version, string $field, string $value)
 

Protected Member Functions

 getXmlNamespace (string $a_entity, string $a_schema_version)
 
 getTypes (string $a_entity, string $a_version)
 Get (abstract) types for (abstract) field names. More...
 
- Protected Member Functions inherited from ilDataSet
 getTypes (string $a_entity, string $a_version)
 Get (abstract) types for (abstract) field names. More...
 
 getXmlNamespace (string $a_entity, string $a_schema_version)
 
 getExportDirInContainer (string $exp_dir)
 
 getIRSSContainerExportConfig (StorableResource $source_container, string $source_path, string $target_path="")
 
 getDependencies (string $a_entity, string $a_version, ?array $a_rec=null, ?array $a_ids=null)
 
 createObjectExportId (string $a_type, string $a_id)
 Build ilias export id. More...
 
 parseObjectExportId (string $a_id, ?string $a_fallback_id=null)
 Parse export id. More...
 
 stripTags (array $rec, array $omit_keys=[])
 

Protected Attributes

ILIAS Help Tooltips TooltipsManager $help_tooltips
 
ILIAS Help Map MapManager $help_map
 
- Protected Attributes inherited from ilDataSet
ILIAS ResourceStorage Services $irss
 
string $current_installation_id = ""
 
array $data = []
 
ilDBInterface $db
 
ilLogger $ds_log
 
string $import_directory = ""
 
string $entity = ""
 
string $schema_version = ""
 
string $component_export_dir = ""
 
string $ds_prefix = "ds"
 
string $version = ""
 
ilSurveyImporter $import
 
ilExport $export
 

Additional Inherited Members

- Data Fields inherited from ilDataSet
const DATASET_NS = 'http://www.ilias.de/Services/DataSet/ds/4_3'
 
const DATASET_NS_PREFIX = 'ds'
 
const EXPORT_NO_INST_ID = 1
 
const EXPORT_ID_ILIAS_LOCAL = 2
 
const EXPORT_ID_ILIAS_LOCAL_INVALID = 3
 
const EXPORT_ID_ILIAS_REMOTE = 4
 
const EXPORT_ID_ILIAS_REMOTE_INVALID = 5
 
const EXPORT_ID = 6
 
const EXPORT_ID_INVALID = 7
 
int $dircnt = 0
 

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 Help system data set class

Author
Alexander Killing killi.nosp@m.ng@l.nosp@m.eifos.nosp@m..de

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

Constructor & Destructor Documentation

◆ __construct()

ilHelpDataSet::__construct ( )

Reimplemented from ilDataSet.

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

30 {
31 global $DIC;
32
33 $help_domain = $DIC->help()->internal()->domain();
34
36
37 $this->help_map = $help_domain->map();
38 $this->help_tooltips = $help_domain->tooltips();
39 }
__construct(Container $dic, ilPlugin $plugin)
@inheritDoc
global $DIC
Definition: shib_login.php:26

References $DIC, and ILIAS\GlobalScreen\Provider\__construct().

+ Here is the call graph for this function:

Member Function Documentation

◆ getSupportedVersions()

ilHelpDataSet::getSupportedVersions ( )

Reimplemented from ilDataSet.

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

41 : array
42 {
43 return array("10.0", "4.3.0");
44 }

◆ getTypes()

ilHelpDataSet::getTypes ( string  $a_entity,
string  $a_version 
)
protected

Get (abstract) types for (abstract) field names.

Please note that the abstract fields/types only depend on the version! Not on a choosen representation!

Returns
array types array, e.g. array("field_1" => "text", "field_2" => "integer", ...)

Reimplemented from ilDataSet.

Definition at line 51 of file class.ilHelpDataSet.php.

51 : array
52 {
53 if ($a_entity === "help_map") {
54 switch ($a_version) {
55 case "4.3.0":
56 return array(
57 "Chap" => "integer",
58 "Component" => "text",
59 "ScreenId" => "text",
60 "ScreenSubId" => "text",
61 "Perm" => "text"
62 );
63 case "10.0":
64 return array(
65 "Chap" => "integer",
66 "Component" => "text",
67 "ScreenId" => "text",
68 "ScreenSubId" => "text",
69 "Perm" => "text",
70 "FullId" => "text"
71 );
72 }
73 }
74
75 if ($a_entity === "help_tooltip") {
76 switch ($a_version) {
77 case "4.3.0":
78 case "10.0":
79 return array(
80 "Id" => "integer",
81 "TtText" => "text",
82 "TtId" => "text",
83 "Comp" => "text",
84 "Lang" => "text"
85 );
86 }
87 }
88 return [];
89 }

◆ getXmlNamespace()

ilHelpDataSet::getXmlNamespace ( string  $a_entity,
string  $a_schema_version 
)
protected

Reimplemented from ilDataSet.

Definition at line 46 of file class.ilHelpDataSet.php.

46 : string
47 {
48 return "https://www.ilias.de/xml/Services/Help/" . $a_entity;
49 }

◆ importRecord()

ilHelpDataSet::importRecord ( string  $a_entity,
array  $a_types,
array  $a_rec,
ilImportMapping  $a_mapping,
string  $a_schema_version 
)

Needs to be overwritten for import use case.

Reimplemented from ilDataSet.

Definition at line 123 of file class.ilHelpDataSet.php.

129 : void {
130 $a_rec = $this->stripTags($a_rec);
131 switch ($a_entity) {
132 case "help_map":
133
134 // without module ID we do nothing
135 $module_id = $a_mapping->getMapping('components/ILIAS/Help', 'help_module', 0);
136 $t = $a_mapping->getAllMappings();
137 if ($module_id) {
138 $new_chap = $a_mapping->getMapping(
139 'components/ILIAS/Help',
140 'help_chap',
141 $a_rec["Chap"]
142 );
143
144 // new import (5.1): get chapter from learning module import mapping
145 if ((int) $new_chap === 0) {
146 $new_chap = $a_mapping->getMapping(
147 'components/ILIAS/LearningModule',
148 'lm_tree',
149 $a_rec["Chap"]
150 );
151 }
152
153 if ($new_chap > 0) {
154 $this->help_map->saveMappingEntry(
155 $new_chap,
156 $a_rec["Component"],
157 $a_rec["ScreenId"],
158 $a_rec["ScreenSubId"],
159 $a_rec["Perm"],
160 $module_id,
161 $a_rec["FullId"] ?? ""
162 );
163 }
164 }
165 break;
166
167 case "help_tooltip":
168
169 // without module ID we do nothing
170 $module_id = $a_mapping->getMapping('components/ILIAS/Help', 'help_module', 0);
171 if ($module_id) {
172 $this->help_tooltips->addTooltip($a_rec["TtId"], $a_rec["TtText"], $module_id);
173 }
174 break;
175 }
176 }
stripTags(array $rec, array $omit_keys=[])
getMapping(string $a_comp, string $a_entity, string $a_old_id)

References ilImportMapping\getAllMappings(), and ilImportMapping\getMapping().

+ Here is the call graph for this function:

◆ readData()

ilHelpDataSet::readData ( string  $a_entity,
string  $a_version,
array  $a_ids 
)

Read data from DB.

This should result in the abstract field structure of the version set in the constructor.

Reimplemented from ilDataSet.

Definition at line 91 of file class.ilHelpDataSet.php.

91 : void
92 {
94
95 if ($a_entity === "help_map") {
96 switch ($a_version) {
97 case "4.3.0":
98 $this->getDirectDataFromQuery("SELECT chap, component, screen_id, screen_sub_id, perm " .
99 " FROM help_map " .
100 "WHERE " .
101 $ilDB->in("chap", $a_ids, false, "integer"));
102 break;
103 case "10.0":
104 $this->getDirectDataFromQuery("SELECT chap, component, screen_id, screen_sub_id, perm, full_id " .
105 " FROM help_map " .
106 "WHERE " .
107 $ilDB->in("chap", $a_ids, false, "integer"));
108 break;
109 }
110 }
111
112 if ($a_entity === "help_tooltip") {
113 switch ($a_version) {
114 case "4.3.0":
115 case "10.0":
116 $this->getDirectDataFromQuery("SELECT id, tt_text, tt_id, comp, lang FROM help_tooltip " .
117 " WHERE module_id = " . $ilDB->quote(0, "integer"));
118 break;
119 }
120 }
121 }
getDirectDataFromQuery(string $a_query, bool $a_convert_to_leading_upper=true, bool $a_set=true)
Get data from query.This is a standard procedure, all db field names are directly mapped to abstract ...
ilDBInterface $db

References ilDataSet\$db, $ilDB, and ilDataSet\getDirectDataFromQuery().

+ Here is the call graph for this function:

Field Documentation

◆ $help_map

ILIAS Help Map MapManager ilHelpDataSet::$help_map
protected

Definition at line 27 of file class.ilHelpDataSet.php.

◆ $help_tooltips

ILIAS Help Tooltips TooltipsManager ilHelpDataSet::$help_tooltips
protected

Definition at line 26 of file class.ilHelpDataSet.php.


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