ILIAS  trunk Revision v11.0_alpha-1749-g1a06bdef097
All Data Structures Namespaces Files Functions Variables Enumerations Enumerator Modules Pages
ilSurveyDataSet 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 ilSurveyDataSet:
+ Collaboration diagram for ilSurveyDataSet:

Public Member Functions

 getSupportedVersions ()
 
 readData (string $a_entity, string $a_version, array $a_ids)
 
 importRecord (string $a_entity, array $a_types, array $a_rec, ilImportMapping $a_mapping, string $a_schema_version)
 
- 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 ...> ... 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 field types for entity. More...
 
 getDependencies (string $a_entity, string $a_version, ?array $a_rec=null, ?array $a_ids=null)
 Determine the dependent sets of data. 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=[])
 

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
 
- 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
 

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 Survey Data set class

Currently most of the survey export is still done "old school".

The dataset part implements mostly the 360 extension:

  • svy_quest_skill: question to skill assignment
  • svy_skill_threshold: skill threshold values
Author
Alexander Killing killi.nosp@m.ng@l.nosp@m.eifos.nosp@m..de

Definition at line 31 of file class.ilSurveyDataSet.php.

Member Function Documentation

◆ getDependencies()

ilSurveyDataSet::getDependencies ( string  $a_entity,
string  $a_version,
?array  $a_rec = null,
?array  $a_ids = null 
)
protected

Determine the dependent sets of data.

Definition at line 104 of file class.ilSurveyDataSet.php.

References ilDataSet\$db, and $ilDB.

109  : array {
110  $ilDB = $this->db;
111 
112  /*switch ($a_entity)
113  {
114  case "svy_quest_skill":
115  $deps["svy_skill_treshold"]["ids"][] = $a_ids;
116  return $deps;
117  }*/
118 
119  return [];
120  }
ilDBInterface $db

◆ getSupportedVersions()

ilSurveyDataSet::getSupportedVersions ( )

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

33  : array
34  {
35  return array("5.1.0");
36  }

◆ getTypes()

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

Get field types for entity.

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

46  : array
47  {
48  if ($a_entity === "svy_quest_skill") {
49  switch ($a_version) {
50  case "5.1.0":
51  return array(
52  "QId" => "integer",
53  "SurveyId" => "integer",
54  "BaseSkillId" => "integer",
55  "TrefId" => "integer"
56  );
57  }
58  }
59  if ($a_entity === "svy_skill_threshold") {
60  switch ($a_version) {
61  case "5.1.0":
62  return array(
63  "SurveyId" => "integer",
64  "BaseSkillId" => "integer",
65  "TrefId" => "integer",
66  "LevelId" => "integer",
67  "Treshold" => "integer"
68  );
69  }
70  }
71  return array();
72  }

◆ getXmlNamespace()

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

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

38  : string
39  {
40  return "https://www.ilias.de/xml/Modules/Survey/" . $a_entity;
41  }

◆ importRecord()

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

Definition at line 122 of file class.ilSurveyDataSet.php.

References ilBasicSkill\getCommonSkillIdForImportId(), ilDataSet\getCurrentInstallationId(), ilDataSet\getImport(), ilBasicSkill\getLevelIdForImportIdMatchSkill(), ilImportMapping\getMapping(), and ilDataSet\stripTags().

128  : void {
129  $a_rec = $this->stripTags($a_rec);
130  switch ($a_entity) {
131  case "svy_quest_skill":
132  $skill_data = ilBasicSkill::getCommonSkillIdForImportId($this->getCurrentInstallationId(), $a_rec["BaseSkillId"], $a_rec["TrefId"]);
133  $q_id = $a_mapping->getMapping("components/ILIAS/Survey", "svy_q", $a_rec["QId"]);
134  if ($q_id > 0 && count($skill_data) > 0) {
135  $skill_survey = new ilSurveySkill($this->getImport()->getSurvey());
136  $skill_survey->addQuestionSkillAssignment($q_id, $skill_data[0]["skill_id"], $skill_data[0]["tref_id"]);
137  }
138  break;
139 
140  case "svy_skill_threshold":
141  $l = ilBasicSkill::getLevelIdForImportIdMatchSkill($this->getCurrentInstallationId(), $a_rec["LevelId"], $a_rec["BaseSkillId"], $a_rec["TrefId"]);
142  if (count($l) > 0) {
143  $skill_thres = new ilSurveySkillThresholds($this->getImport()->getSurvey());
144  $skill_thres->writeThreshold($l[0]["skill_id"], $l[0]["tref_id"], $l[0]["level_id"], $a_rec["Threshold"]);
145  }
146  break;
147  }
148  }
static getCommonSkillIdForImportId(int $a_source_inst_id, int $a_skill_import_id, int $a_tref_import_id=0)
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
getMapping(string $a_comp, string $a_entity, string $a_old_id)
getCurrentInstallationId()
static getLevelIdForImportIdMatchSkill(int $a_source_inst_id, int $a_level_import_id, int $a_skill_import_id, int $a_tref_import_id=0)
stripTags(array $rec, array $omit_keys=[])
+ Here is the call graph for this function:

◆ readData()

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

Definition at line 74 of file class.ilSurveyDataSet.php.

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

74  : void
75  {
76  $ilDB = $this->db;
77 
78  $this->data = array();
79 
80  if ($a_entity === "svy_quest_skill") {
81  switch ($a_version) {
82  case "5.1.0":
83  $this->getDirectDataFromQuery("SELECT * " .
84  " FROM svy_quest_skill WHERE " .
85  $ilDB->in("survey_id", $a_ids, false, "integer"));
86  break;
87  }
88  }
89 
90  if ($a_entity === "svy_skill_threshold") {
91  switch ($a_version) {
92  case "5.1.0":
93  $this->getDirectDataFromQuery("SELECT * " .
94  " FROM svy_skill_threshold WHERE " .
95  $ilDB->in("survey_id", $a_ids, false, "integer"));
96  break;
97  }
98  }
99  }
ilDBInterface $db
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 ...
+ Here is the call graph for this function:

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