ILIAS  release_8 Revision v8.24
Public Member Functions
assMultipleChoiceImport Class Reference
Modules/TestQuestionPool

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

+ Inheritance diagram for assMultipleChoiceImport:
+ Collaboration diagram for assMultipleChoiceImport:

Public Member Functions

 fromXML (&$item, $questionpool_id, &$tst_id, &$tst_object, &$question_counter, $import_mapping)
 Creates a question from a QTI file. More...
 
- Public Member Functions inherited from assQuestionImport
 __construct ($a_object)
 assQuestionImport constructor More...
 
 getQuestionId ()
 
 getFeedbackGeneric ($item)
 
 fromXML (&$item, $questionpool_id, &$tst_id, &$tst_object, &$question_counter, $import_mapping)
 Creates a question from a QTI file. More...
 
 importSuggestedSolution (int $question_id, string $value="", int $subquestion_index=0)
 

Additional Inherited Members

- Data Fields inherited from assQuestionImport
 $object
 
- Protected Member Functions inherited from assQuestionImport
 fetchIndexFromFeedbackIdent ($feedbackIdent, $prefix='response_')
 
 getFeedbackAnswerSpecific (ilQTIItem $item, $prefix='response_')
 
 addGeneralMetadata (ilQTIItem $item)
 
 fetchLifecycle (ilQTIItem $item)
 
 getQplImportArchivDirectory ()
 returns the full path to extracted qpl import archiv (qpl import dir + qpl archiv subdir) More...
 
 getTstImportArchivDirectory ()
 returns the full path to extracted tst import archiv (tst import dir + tst archiv subdir) More...
 
 processNonAbstractedImageReferences ($text, $sourceNic)
 
 fetchAdditionalContentEditingModeInformation ($qtiItem)
 fetches the "additional content editing mode" information from qti item and falls back to ADDITIONAL_CONTENT_EDITING_MODE_RTE when no or invalid information is given More...
 
 deduceThumbSizeFromImportValue (?int $size)
 

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 Class for multiple choice question imports

assMultipleChoiceImport is a class for multiple choice question imports

Author
Helmut Schottmüller helmu.nosp@m.t.sc.nosp@m.hottm.nosp@m.uell.nosp@m.er@ma.nosp@m.c.co.nosp@m.m
Version
$Id$

Definition at line 28 of file class.assMultipleChoiceImport.php.

Member Function Documentation

◆ fromXML()

assMultipleChoiceImport::fromXML ( &  $item,
  $questionpool_id,
&  $tst_id,
&  $tst_object,
&  $question_counter,
  $import_mapping 
)

Creates a question from a QTI file.

Receives parameters from a QTI parser and creates a valid ILIAS question object

Parameters
ilQtiItem$itemThe QTI item object
integer$questionpool_idThe id of the parent questionpool
integer$tst_idThe id of the parent test if the question is part of a test
object$tst_objectA reference to the parent test object
integer$question_counterA reference to a question counter to count the questions of an imported question pool
array$import_mappingAn array containing references to included ILIAS objects @access public

Reimplemented from assQuestionImport.

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

43 : array
44 {
45 global $DIC;
46 $ilUser = $DIC['ilUser'];
47 // empty session variable for imported xhtml mobs
48 ilSession::clear('import_mob_xhtml');
49
50 $presentation = $item->getPresentation();
51 $shuffle = 0;
52 $selectionLimit = null;
53 $now = getdate();
54 $created = sprintf("%04d%02d%02d%02d%02d%02d", $now['year'], $now['mon'], $now['mday'], $now['hours'], $now['minutes'], $now['seconds']);
55 $answers = array();
56 foreach ($presentation->order as $entry) {
57 switch ($entry["type"]) {
58 case "response":
59 $response = $presentation->response[$entry["index"]];
60 $rendertype = $response->getRenderType();
61 switch (strtolower(get_class($response->getRenderType()))) {
62 case "ilqtirenderchoice":
63 $shuffle = $rendertype->getShuffle();
64 if ($rendertype->getMaxnumber()) {
65 $selectionLimit = $rendertype->getMaxnumber();
66 }
67 $answerorder = 0;
68 $foundimage = false;
69 foreach ($rendertype->response_labels as $response_label) {
70 $ident = $response_label->getIdent();
71 $answertext = "";
72 $answerimage = array();
73 foreach ($response_label->material as $mat) {
74 $embedded = false;
75 for ($m = 0; $m < $mat->getMaterialCount(); $m++) {
76 $foundmat = $mat->getMaterial($m);
77 if (strcmp($foundmat["type"], "mattext") == 0) {
78 }
79 if (strcmp($foundmat["type"], "matimage") == 0) {
80 if (strlen($foundmat["material"]->getEmbedded())) {
81 $embedded = true;
82 }
83 }
84 }
85 if ($embedded) {
86 for ($m = 0; $m < $mat->getMaterialCount(); $m++) {
87 $foundmat = $mat->getMaterial($m);
88 if (strcmp($foundmat["type"], "mattext") == 0) {
89 $answertext .= $foundmat["material"]->getContent();
90 }
91 if (strcmp($foundmat["type"], "matimage") == 0) {
92 $foundimage = true;
93 $answerimage = array(
94 "imagetype" => $foundmat["material"]->getImageType(),
95 "label" => $foundmat["material"]->getLabel(),
96 "content" => $foundmat["material"]->getContent()
97 );
98 }
99 }
100 } else {
101 $answertext = $this->object->QTIMaterialToString($mat);
102 }
103 }
104 $answers[$ident] = array(
105 "answertext" => $answertext,
106 "imagefile" => $answerimage,
107 "points" => 0,
108 "answerorder" => $answerorder++,
109 "points_unchecked" => 0,
110 "action" => ""
111 );
112 }
113 break;
114 }
115 break;
116 }
117 }
118 $responses = array();
119 $feedbacks = array();
120 $feedbacksgeneric = array();
121 foreach ($item->resprocessing as $resprocessing) {
122 foreach ($resprocessing->respcondition as $respcondition) {
123 $ident = "";
124 $correctness = 1;
125 $conditionvar = $respcondition->getConditionvar();
126 foreach ($conditionvar->order as $order) {
127 switch ($order["field"]) {
128 case "arr_not":
129 $correctness = 0;
130 break;
131 case "varequal":
132 $ident = $conditionvar->varequal[$order["index"]]->getContent();
133 break;
134 }
135 }
136 foreach ($respcondition->setvar as $setvar) {
137 if (strcmp($ident, "") != 0) {
138 if ($correctness) {
139 $answers[$ident]["action"] = $setvar->getAction();
140 $answers[$ident]["points"] = $setvar->getContent();
141 if (count($respcondition->displayfeedback)) {
142 foreach ($respcondition->displayfeedback as $feedbackpointer) {
143 if (strlen($feedbackpointer->getLinkrefid())) {
144 foreach ($item->itemfeedback as $ifb) {
145 if (strcmp($ifb->getIdent(), "response_allcorrect") == 0) {
146 // found a feedback for the identifier
147 if (count($ifb->material)) {
148 foreach ($ifb->material as $material) {
149 $feedbacksgeneric[1] = $material;
150 }
151 }
152 if ((count($ifb->flow_mat) > 0)) {
153 foreach ($ifb->flow_mat as $fmat) {
154 if (count($fmat->material)) {
155 foreach ($fmat->material as $material) {
156 $feedbacksgeneric[1] = $material;
157 }
158 }
159 }
160 }
161 } elseif (strcmp($ifb->getIdent(), "response_onenotcorrect") == 0) {
162 // found a feedback for the identifier
163 if (count($ifb->material)) {
164 foreach ($ifb->material as $material) {
165 $feedbacksgeneric[0] = $material;
166 }
167 }
168 if ((count($ifb->flow_mat) > 0)) {
169 foreach ($ifb->flow_mat as $fmat) {
170 if (count($fmat->material)) {
171 foreach ($fmat->material as $material) {
172 $feedbacksgeneric[0] = $material;
173 }
174 }
175 }
176 }
177 }
178 if (strcmp($ifb->getIdent(), $feedbackpointer->getLinkrefid()) == 0) {
179 // found a feedback for the identifier
180 if (count($ifb->material)) {
181 foreach ($ifb->material as $material) {
182 $feedbacks[$ident] = $material;
183 }
184 }
185 if ((count($ifb->flow_mat) > 0)) {
186 foreach ($ifb->flow_mat as $fmat) {
187 if (count($fmat->material)) {
188 foreach ($fmat->material as $material) {
189 $feedbacks[$ident] = $material;
190 }
191 }
192 }
193 }
194 }
195 }
196 }
197 }
198 }
199 } else {
200 $answers[$ident]["action"] = $setvar->getAction();
201 $answers[$ident]["points_unchecked"] = $setvar->getContent();
202 }
203 }
204 }
205 }
206 }
207 $this->addGeneralMetadata($item);
208 $this->object->setTitle($item->getTitle());
209 $this->object->setNrOfTries((int) $item->getMaxattempts());
210 $this->object->setComment($item->getComment());
211 $this->object->setAuthor($item->getAuthor());
212 $this->object->setOwner($ilUser->getId());
213 $this->object->setQuestion($this->object->QTIMaterialToString($item->getQuestiontext()));
214 $this->object->setObjId($questionpool_id);
215 $this->object->setShuffle($shuffle);
216 $this->object->setSelectionLimit($selectionLimit);
217 $this->object->setThumbSize(
218 $this->deduceThumbSizeFromImportValue((int) $item->getMetadataEntry('thumb_size'))
219 );
220
221 foreach ($answers as $answer) {
222 if ($item->getMetadataEntry('singleline') || (is_array($answer["imagefile"]) && count($answer["imagefile"]) > 0)) {
223 $this->object->setIsSingleline(true);
224 }
225 $this->object->addAnswer($answer["answertext"], $answer["points"], $answer["points_unchecked"], $answer["answerorder"], $answer["imagefile"]["label"] ?? '');
226 }
227 // additional content editing mode information
228 $this->object->setAdditionalContentEditingMode(
229 $this->fetchAdditionalContentEditingModeInformation($item)
230 );
231 $this->object->saveToDb();
232 foreach ($answers as $answer) {
233 if (is_array($answer["imagefile"]) && (count($answer["imagefile"]) > 0)) {
234 $image = base64_decode($answer["imagefile"]["content"]);
235 $imagepath = $this->object->getImagePath();
236 if (!file_exists($imagepath)) {
237 ilFileUtils::makeDirParents($imagepath);
238 }
239 $imagepath .= $answer["imagefile"]["label"];
240 $fh = fopen($imagepath, "wb");
241 if ($fh == false) {
242 } else {
243 $imagefile = fwrite($fh, $image);
244 fclose($fh);
245 }
246 }
247 }
248
249 $feedbackSetting = $item->getMetadataEntry('feedback_setting');
250 if (!is_null($feedbackSetting)) {
251 $this->object->feedbackOBJ->saveSpecificFeedbackSetting($this->object->getId(), $feedbackSetting);
252 }
253
254 // handle the import of media objects in XHTML code
255 foreach ($feedbacks as $ident => $material) {
256 $m = $this->object->QTIMaterialToString($material);
257 $feedbacks[$ident] = $m;
258 }
259 foreach ($feedbacksgeneric as $correctness => $material) {
260 $m = $this->object->QTIMaterialToString($material);
261 $feedbacksgeneric[$correctness] = $m;
262 }
263 $questiontext = $this->object->getQuestion();
264 $answers = &$this->object->getAnswers();
265 if (is_array(ilSession::get("import_mob_xhtml"))) {
266 foreach (ilSession::get("import_mob_xhtml") as $mob) {
267 if ($tst_id > 0) {
268 $importfile = $this->getTstImportArchivDirectory() . '/' . $mob["uri"];
269 } else {
270 $importfile = $this->getQplImportArchivDirectory() . '/' . $mob["uri"];
271 }
272
273 global $DIC; /* @var ILIAS\DI\Container $DIC */
274 $DIC['ilLog']->write(__METHOD__ . ': import mob from dir: ' . $importfile);
275
276 $media_object = ilObjMediaObject::_saveTempFileAsMediaObject(basename($importfile), $importfile, false);
277 ilObjMediaObject::_saveUsage($media_object->getId(), "qpl:html", $this->object->getId());
278 $questiontext = str_replace("src=\"" . $mob["mob"] . "\"", "src=\"" . "il_" . IL_INST_ID . "_mob_" . $media_object->getId() . "\"", $questiontext);
279 foreach ($answers as $key => $value) {
280 $answer_obj = &$answers[$key];
281 $answer_obj->setAnswertext(str_replace("src=\"" . $mob["mob"] . "\"", "src=\"" . "il_" . IL_INST_ID . "_mob_" . $media_object->getId() . "\"", $answer_obj->getAnswertext()));
282 }
283 foreach ($feedbacks as $ident => $material) {
284 $feedbacks[$ident] = str_replace("src=\"" . $mob["mob"] . "\"", "src=\"" . "il_" . IL_INST_ID . "_mob_" . $media_object->getId() . "\"", $material);
285 }
286 foreach ($feedbacksgeneric as $correctness => $material) {
287 $feedbacksgeneric[$correctness] = str_replace("src=\"" . $mob["mob"] . "\"", "src=\"" . "il_" . IL_INST_ID . "_mob_" . $media_object->getId() . "\"", $material);
288 }
289 }
290 }
291 $this->object->setQuestion(ilRTE::_replaceMediaObjectImageSrc($questiontext, 1));
292 foreach ($answers as $key => $value) {
293 $answer_obj = &$answers[$key];
294 $answer_obj->setAnswertext(ilRTE::_replaceMediaObjectImageSrc($answer_obj->getAnswertext(), 1));
295 }
296 foreach ($feedbacks as $ident => $material) {
297 $this->object->feedbackOBJ->importSpecificAnswerFeedback(
298 $this->object->getId(),
299 0,
300 $ident,
301 ilRTE::_replaceMediaObjectImageSrc($material, 1)
302 );
303 }
304 foreach ($feedbacksgeneric as $correctness => $material) {
305 $this->object->feedbackOBJ->importGenericFeedback(
306 $this->object->getId(),
307 $correctness,
308 ilRTE::_replaceMediaObjectImageSrc($material, 1)
309 );
310 }
311 $this->object->saveToDb();
312 if (count($item->suggested_solutions)) {
313 foreach ($item->suggested_solutions as $suggested_solution) {
314 $this->object->setSuggestedSolution($suggested_solution["solution"]->getContent(), $suggested_solution["gap_index"], true);
315 }
316 $this->object->saveToDb();
317 }
318 if ($tst_id > 0) {
319 $q_1_id = $this->object->getId();
320 $question_id = $this->object->duplicate(true, "", "", "", $tst_id);
321 $tst_object->questions[$question_counter++] = $question_id;
322 $import_mapping[$item->getIdent()] = array("pool" => $q_1_id, "test" => $question_id);
323 } else {
324 $import_mapping[$item->getIdent()] = array("pool" => $this->object->getId(), "test" => 0);
325 }
326 return $import_mapping;
327 }
assQuestionImport\fetchAdditionalContentEditingModeInformation
fetchAdditionalContentEditingModeInformation($qtiItem)
fetches the "additional content editing mode" information from qti item and falls back to ADDITIONAL_...
Definition: class.assQuestionImport.php:276
assQuestionImport\getTstImportArchivDirectory
getTstImportArchivDirectory()
returns the full path to extracted tst import archiv (tst import dir + tst archiv subdir)
Definition: class.assQuestionImport.php:236
assQuestionImport\addGeneralMetadata
addGeneralMetadata(ilQTIItem $item)
Definition: class.assQuestionImport.php:187
assQuestionImport\deduceThumbSizeFromImportValue
deduceThumbSizeFromImportValue(?int $size)
Definition: class.assQuestionImport.php:306
assQuestionImport\getQplImportArchivDirectory
getQplImportArchivDirectory()
returns the full path to extracted qpl import archiv (qpl import dir + qpl archiv subdir)
Definition: class.assQuestionImport.php:228
ilFileUtils\makeDirParents
static makeDirParents(string $a_dir)
Create a new directory and all parent directories.
Definition: class.ilFileUtils.php:298
ilObjMediaObject\_saveTempFileAsMediaObject
static _saveTempFileAsMediaObject(string $name, string $tmp_name, bool $upload=true)
Create new media object and update page in db and return new media object.
Definition: class.ilObjMediaObject.php:1344
ilObjMediaObject\_saveUsage
static _saveUsage(int $a_mob_id, string $a_type, int $a_id, int $a_usage_hist_nr=0, string $a_lang="-")
Save usage of mob within another container (e.g.
Definition: class.ilObjMediaObject.php:852
ilRTE\_replaceMediaObjectImageSrc
static _replaceMediaObjectImageSrc(string $a_text, int $a_direction=0, string $nic='')
Replaces image source from mob image urls with the mob id or replaces mob id with the correct image s...
Definition: class.ilRTE.php:177
ilSession\get
static get(string $a_var)
Definition: class.ilSession.php:459
ilSession\clear
static clear(string $a_var)
Definition: class.ilSession.php:472
IL_INST_ID
const IL_INST_ID
Definition: constants.php:40
$DIC
global $DIC
Definition: feed.php:28
$ilUser
$ilUser
Definition: imgupload.php:34
ILIAS\LTI\ToolProvider\$key
string $key
Consumer key/client ID value.
Definition: System.php:193
ILIAS\LTI\ToolProvider\$created
int $created
Timestamp for when the object was created.
Definition: System.php:151
$response
$response
Definition: proxy_ylocal.php:39

References ILIAS\LTI\ToolProvider\$created, $DIC, $ilUser, ILIAS\LTI\ToolProvider\$key, $response, ilRTE\_replaceMediaObjectImageSrc(), ilObjMediaObject\_saveTempFileAsMediaObject(), ilObjMediaObject\_saveUsage(), assQuestionImport\addGeneralMetadata(), ilSession\clear(), assQuestionImport\deduceThumbSizeFromImportValue(), assQuestionImport\fetchAdditionalContentEditingModeInformation(), ilSession\get(), ILIAS\UI\Implementation\Component\Input\ViewControl\getContent(), assQuestionImport\getQplImportArchivDirectory(), assQuestionImport\getTstImportArchivDirectory(), IL_INST_ID, ilFileUtils\makeDirParents(), and ILIAS\Repository\object().

+ Here is the call graph for this function:
The documentation for this class was generated from the following file: