ILIAS  release_8 Revision v8.19-1-g4e8f2f9140c
•All Data Structures Namespaces Files Functions Variables Modules Pages
Public Member Functions
assMultipleChoiceExport 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 assMultipleChoiceExport:
+ Collaboration diagram for assMultipleChoiceExport:

Public Member Functions

 toXML ($a_include_header=true, $a_include_binary=true, $a_shuffle=false, $test_output=false, $force_image_references=false)
 Returns a QTI xml representation of the question Returns a QTI xml representation of the question and sets the internal domxml variable with the DOM XML representation of the QTI xml representation public. More...
 
- Public Member Functions inherited from assQuestionExport
 __construct ($a_object)
 assQuestionExport constructor More...
 
 exportFeedbackOnly ($a_xml_writer)
 
 toXML ($a_include_header=true, $a_include_binary=true, $a_shuffle=false, $test_output=false, $force_image_references=false)
 Returns a QTI xml representation of the question Returns a QTI xml representation of the question and sets the internal domxml variable with the DOM XML representation of the QTI xml representation. More...
 

Additional Inherited Members

- Data Fields inherited from assQuestionExport
 $object
 
const ITEM_SOLUTIONHINT = 'solutionhint'
 
- Protected Member Functions inherited from assQuestionExport
 addAnswerSpecificFeedback (ilXmlWriter $a_xml_writer, $answers)
 
 addGenericFeedback (ilXmlWriter $a_xml_writer)
 
 addQtiMetaDataField (ilXmlWriter $a_xml_writer, $fieldLabel, $fieldValue)
 adds a qti meta data field with given name and value to the passed xml writer (xml writer must be in context of opened "qtimetadata" tag) More...
 
 addAdditionalContentEditingModeInformation (ilXmlWriter $a_xml_writer)
 adds a qti meta data field for ilias specific information of "additional content editing mode" (xml writer must be in context of opened "qtimetadata" tag) More...
 
 addGeneralMetadata (ilXmlWriter $xmlwriter)
 
 addSolutionHints (ilXmlWriter $writer)
 

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 exports

assMultipleChoiceExport is a class for multiple choice question exports

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 27 of file class.assMultipleChoiceExport.php.

Member Function Documentation

◆ toXML()

assMultipleChoiceExport::toXML (   $a_include_header = true,
  $a_include_binary = true,
  $a_shuffle = false,
  $test_output = false,
  $force_image_references = false 
)

Returns a QTI xml representation of the question Returns a QTI xml representation of the question and sets the internal domxml variable with the DOM XML representation of the QTI xml representation public.

Definition at line 35 of file class.assMultipleChoiceExport.php.

References $DIC, $index, $xml, assQuestionExport\addAdditionalContentEditingModeInformation(), assQuestionExport\addGeneralMetadata(), assQuestionExport\addQtiMetaDataField(), assQuestionExport\addSolutionHints(), IL_INST_ID, MULTIPLE_CHOICE_QUESTION_IDENTIFIER, and ILIAS\Repository\object().

35  : string
36  {
37  global $DIC;
38  $ilias = $DIC['ilias'];
39 
40  include_once("./Services/Xml/classes/class.ilXmlWriter.php");
41  $a_xml_writer = new ilXmlWriter();
42  // set xml header
43  $a_xml_writer->xmlHeader();
44  $a_xml_writer->xmlStartTag("questestinterop");
45  $attrs = array(
46  "ident" => "il_" . IL_INST_ID . "_qst_" . $this->object->getId(),
47  "title" => $this->object->getTitle(),
48  "maxattempts" => $this->object->getNrOfTries()
49  );
50  $a_xml_writer->xmlStartTag("item", $attrs);
51  // add question description
52  $a_xml_writer->xmlElement("qticomment", null, $this->object->getComment());
53  $a_xml_writer->xmlStartTag("itemmetadata");
54  $a_xml_writer->xmlStartTag("qtimetadata");
55  $a_xml_writer->xmlStartTag("qtimetadatafield");
56  $a_xml_writer->xmlElement("fieldlabel", null, "ILIAS_VERSION");
57  $a_xml_writer->xmlElement("fieldentry", null, $ilias->getSetting("ilias_version"));
58  $a_xml_writer->xmlEndTag("qtimetadatafield");
59  $a_xml_writer->xmlStartTag("qtimetadatafield");
60  $a_xml_writer->xmlElement("fieldlabel", null, "QUESTIONTYPE");
61  $a_xml_writer->xmlElement("fieldentry", null, MULTIPLE_CHOICE_QUESTION_IDENTIFIER);
62  $a_xml_writer->xmlEndTag("qtimetadatafield");
63  $a_xml_writer->xmlStartTag("qtimetadatafield");
64  $a_xml_writer->xmlElement("fieldlabel", null, "AUTHOR");
65  $a_xml_writer->xmlElement("fieldentry", null, $this->object->getAuthor());
66  $a_xml_writer->xmlEndTag("qtimetadatafield");
67 
68  // additional content editing information
69  $this->addAdditionalContentEditingModeInformation($a_xml_writer);
70  $this->addGeneralMetadata($a_xml_writer);
71 
72  $a_xml_writer->xmlStartTag("qtimetadatafield");
73  $a_xml_writer->xmlElement("fieldlabel", null, "thumb_size");
74  $a_xml_writer->xmlElement("fieldentry", null, $this->object->getThumbSize());
75  $a_xml_writer->xmlEndTag("qtimetadatafield");
76 
77  $a_xml_writer->xmlStartTag("qtimetadatafield");
78  $a_xml_writer->xmlElement("fieldlabel", null, "feedback_setting");
79  $a_xml_writer->xmlElement("fieldentry", null, $this->object->getSpecificFeedbackSetting());
80  $a_xml_writer->xmlEndTag("qtimetadatafield");
81 
82  $this->addQtiMetaDataField($a_xml_writer, 'singleline', $this->object->isSingleline() ? 1 : 0);
83 
84  $a_xml_writer->xmlEndTag("qtimetadata");
85  $a_xml_writer->xmlEndTag("itemmetadata");
86 
87  // PART I: qti presentation
88  $attrs = array(
89  "label" => $this->object->getTitle()
90  );
91  $a_xml_writer->xmlStartTag("presentation", $attrs);
92  // add flow to presentation
93  $a_xml_writer->xmlStartTag("flow");
94  // add material with question text to presentation
95  $this->object->addQTIMaterial($a_xml_writer, $this->object->getQuestion());
96  // add answers to presentation
97  $attrs = array(
98  "ident" => "MCMR",
99  "rcardinality" => "Multiple"
100  );
101  $a_xml_writer->xmlStartTag("response_lid", $attrs);
102  $solution = $this->object->getSuggestedSolution(0);
103  if ($solution !== null && count($solution)) {
104  if (preg_match("/il_(\d*?)_(\w+)_(\d+)/", $solution["internal_link"], $matches)) {
105  $a_xml_writer->xmlStartTag("material");
106  $intlink = "il_" . IL_INST_ID . "_" . $matches[2] . "_" . $matches[3];
107  if (strcmp($matches[1], "") != 0) {
108  $intlink = $solution["internal_link"];
109  }
110  $attrs = array(
111  "label" => "suggested_solution"
112  );
113  $a_xml_writer->xmlElement("mattext", $attrs, $intlink);
114  $a_xml_writer->xmlEndTag("material");
115  }
116  }
117  // shuffle output and max choice
118  $attrs = array('shuffle' => $this->object->getShuffle() ? 'Yes' : 'No');
119  if ($this->object->getSelectionLimit()) {
120  $attrs['minnumber'] = '0';
121  $attrs['maxnumber'] = (string) $this->object->getSelectionLimit();
122  }
123  $a_xml_writer->xmlStartTag("render_choice", $attrs);
124  $answers = &$this->object->getAnswers();
125  $akeys = array_keys($answers);
126  if ($this->object->getShuffle() && $a_shuffle) {
127  $akeys = shuffle($akeys);
128  }
129  // add answers
130  foreach ($akeys as $index) {
131  $answer = $answers[$index];
132  $attrs = array(
133  "ident" => $index
134  );
135  $a_xml_writer->xmlStartTag("response_label", $attrs);
136 
137  if (strlen($answer->getImage())) {
138  $this->object->addQTIMaterial($a_xml_writer, $answer->getAnswertext(), false, false);
139  $imagetype = "image/jpeg";
140  if (preg_match("/.*\.(png|gif)$/", $answer->getImage(), $matches)) {
141  $imagetype = "image/" . $matches[1];
142  }
143  if ($force_image_references) {
144  $attrs = array(
145  "imagtype" => $imagetype,
146  "label" => $answer->getImage(),
147  "uri" => $this->object->getImagePathWeb() . $answer->getImage()
148  );
149  $a_xml_writer->xmlElement("matimage", $attrs);
150  } else {
151  $imagepath = $this->object->getImagePath() . $answer->getImage();
152  $fh = @fopen($imagepath, "rb");
153  if ($fh != false) {
154  $imagefile = fread($fh, filesize($imagepath));
155  fclose($fh);
156  $base64 = base64_encode($imagefile);
157  $attrs = array(
158  "imagtype" => $imagetype,
159  "label" => $answer->getImage(),
160  "embedded" => "base64"
161  );
162  $a_xml_writer->xmlElement("matimage", $attrs, $base64, false, false);
163  }
164  }
165  $a_xml_writer->xmlEndTag("material");
166  } else {
167  $this->object->addQTIMaterial($a_xml_writer, $answer->getAnswertext());
168  }
169  $a_xml_writer->xmlEndTag("response_label");
170  }
171  $a_xml_writer->xmlEndTag("render_choice");
172  $a_xml_writer->xmlEndTag("response_lid");
173  $a_xml_writer->xmlEndTag("flow");
174  $a_xml_writer->xmlEndTag("presentation");
175 
176  // PART II: qti resprocessing
177  $a_xml_writer->xmlStartTag("resprocessing");
178  $a_xml_writer->xmlStartTag("outcomes");
179  $a_xml_writer->xmlStartTag("decvar");
180  $a_xml_writer->xmlEndTag("decvar");
181  $a_xml_writer->xmlEndTag("outcomes");
182  // add response conditions
183  foreach ($answers as $index => $answer) {
184  $attrs = array(
185  "continue" => "Yes"
186  );
187  $a_xml_writer->xmlStartTag("respcondition", $attrs);
188  // qti conditionvar
189  $a_xml_writer->xmlStartTag("conditionvar");
190  $attrs = array(
191  "respident" => "MCMR"
192  );
193  $a_xml_writer->xmlElement("varequal", $attrs, $index);
194  $a_xml_writer->xmlEndTag("conditionvar");
195  // qti setvar
196  $attrs = array(
197  "action" => "Add"
198  );
199  $a_xml_writer->xmlElement("setvar", $attrs, $answer->getPoints());
200  // qti displayfeedback
201  $linkrefid = "response_$index";
202  $attrs = array(
203  "feedbacktype" => "Response",
204  "linkrefid" => $linkrefid
205  );
206  $a_xml_writer->xmlElement("displayfeedback", $attrs);
207  $a_xml_writer->xmlEndTag("respcondition");
208  $attrs = array(
209  "continue" => "Yes"
210  );
211  $a_xml_writer->xmlStartTag("respcondition", $attrs);
212 
213  // qti conditionvar
214  $a_xml_writer->xmlStartTag("conditionvar");
215  $attrs = array(
216  "respident" => "MCMR"
217  );
218  $a_xml_writer->xmlStartTag("not");
219  $a_xml_writer->xmlElement("varequal", $attrs, $index);
220  $a_xml_writer->xmlEndTag("not");
221  $a_xml_writer->xmlEndTag("conditionvar");
222  // qti setvar
223  $attrs = array(
224  "action" => "Add"
225  );
226  $a_xml_writer->xmlElement("setvar", $attrs, $answer->getPointsUnchecked());
227  $a_xml_writer->xmlEndTag("respcondition");
228  }
229  $feedback_allcorrect = $this->object->feedbackOBJ->getGenericFeedbackExportPresentation(
230  $this->object->getId(),
231  true
232  );
233  if (strlen($feedback_allcorrect)) {
234  $attrs = array(
235  "continue" => "Yes"
236  );
237  $a_xml_writer->xmlStartTag("respcondition", $attrs);
238  // qti conditionvar
239  $a_xml_writer->xmlStartTag("conditionvar");
240  foreach ($answers as $index => $answer) {
241  if ($answer->getPointsChecked() < $answer->getPointsUnchecked()) {
242  $a_xml_writer->xmlStartTag("not");
243  }
244  $attrs = array(
245  "respident" => "MCMR"
246  );
247  $a_xml_writer->xmlElement("varequal", $attrs, $index);
248  if ($answer->getPointsChecked() < $answer->getPointsUnchecked()) {
249  $a_xml_writer->xmlEndTag("not");
250  }
251  }
252  $a_xml_writer->xmlEndTag("conditionvar");
253  // qti displayfeedback
254  $attrs = array(
255  "feedbacktype" => "Response",
256  "linkrefid" => "response_allcorrect"
257  );
258  $a_xml_writer->xmlElement("displayfeedback", $attrs);
259  $a_xml_writer->xmlEndTag("respcondition");
260  }
261  $feedback_onenotcorrect = $this->object->feedbackOBJ->getGenericFeedbackExportPresentation(
262  $this->object->getId(),
263  false
264  );
265  if (strlen($feedback_onenotcorrect)) {
266  $attrs = array(
267  "continue" => "Yes"
268  );
269  $a_xml_writer->xmlStartTag("respcondition", $attrs);
270  // qti conditionvar
271  $a_xml_writer->xmlStartTag("conditionvar");
272  foreach ($answers as $index => $answer) {
273  if ($index > 0) {
274  $a_xml_writer->xmlStartTag("or");
275  }
276  if ($answer->getPointsChecked() >= $answer->getPointsUnchecked()) {
277  $a_xml_writer->xmlStartTag("not");
278  }
279  $attrs = array(
280  "respident" => "MCMR"
281  );
282  $a_xml_writer->xmlElement("varequal", $attrs, $index);
283  if ($answer->getPointsChecked() >= $answer->getPointsUnchecked()) {
284  $a_xml_writer->xmlEndTag("not");
285  }
286  if ($index > 0) {
287  $a_xml_writer->xmlEndTag("or");
288  }
289  }
290  $a_xml_writer->xmlEndTag("conditionvar");
291  // qti displayfeedback
292  $attrs = array(
293  "feedbacktype" => "Response",
294  "linkrefid" => "response_onenotcorrect"
295  );
296  $a_xml_writer->xmlElement("displayfeedback", $attrs);
297  $a_xml_writer->xmlEndTag("respcondition");
298  }
299  $a_xml_writer->xmlEndTag("resprocessing");
300 
301  // PART III: qti itemfeedback
302  foreach ($answers as $index => $answer) {
303  $linkrefid = "response_$index";
304  $attrs = array(
305  "ident" => $linkrefid,
306  "view" => "All"
307  );
308  $a_xml_writer->xmlStartTag("itemfeedback", $attrs);
309  // qti flow_mat
310  $a_xml_writer->xmlStartTag("flow_mat");
311  $fb = $this->object->feedbackOBJ->getSpecificAnswerFeedbackExportPresentation(
312  $this->object->getId(),
313  0,
314  $index
315  );
316  $this->object->addQTIMaterial($a_xml_writer, $fb);
317  $a_xml_writer->xmlEndTag("flow_mat");
318  $a_xml_writer->xmlEndTag("itemfeedback");
319  }
320  if (strlen($feedback_allcorrect)) {
321  $attrs = array(
322  "ident" => "response_allcorrect",
323  "view" => "All"
324  );
325  $a_xml_writer->xmlStartTag("itemfeedback", $attrs);
326  // qti flow_mat
327  $a_xml_writer->xmlStartTag("flow_mat");
328  $this->object->addQTIMaterial($a_xml_writer, $feedback_allcorrect);
329  $a_xml_writer->xmlEndTag("flow_mat");
330  $a_xml_writer->xmlEndTag("itemfeedback");
331  }
332  if (strlen($feedback_onenotcorrect)) {
333  $attrs = array(
334  "ident" => "response_onenotcorrect",
335  "view" => "All"
336  );
337  $a_xml_writer->xmlStartTag("itemfeedback", $attrs);
338  // qti flow_mat
339  $a_xml_writer->xmlStartTag("flow_mat");
340  $this->object->addQTIMaterial($a_xml_writer, $feedback_onenotcorrect);
341  $a_xml_writer->xmlEndTag("flow_mat");
342  $a_xml_writer->xmlEndTag("itemfeedback");
343  }
344 
345  $a_xml_writer = $this->addSolutionHints($a_xml_writer);
346 
347  $a_xml_writer->xmlEndTag("item");
348  $a_xml_writer->xmlEndTag("questestinterop");
349 
350  $xml = $a_xml_writer->xmlDumpMem(false);
351  if (!$a_include_header) {
352  $pos = strpos($xml, "?>");
353  $xml = substr($xml, $pos + 2);
354  }
355  return $xml;
356  }
MULTIPLE_CHOICE_QUESTION_IDENTIFIER
const MULTIPLE_CHOICE_QUESTION_IDENTIFIER
Definition: inc.AssessmentConstants.php:45
IL_INST_ID
const IL_INST_ID
Definition: constants.php:40
ilXmlWriter
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
Definition: class.ilXmlWriter.php:30
assQuestionExport\addGeneralMetadata
addGeneralMetadata(ilXmlWriter $xmlwriter)
Definition: class.assQuestionExport.php:217
$index
$index
Definition: metadata.php:145
assQuestionExport\addQtiMetaDataField
addQtiMetaDataField(ilXmlWriter $a_xml_writer, $fieldLabel, $fieldValue)
adds a qti meta data field with given name and value to the passed xml writer (xml writer must be in ...
Definition: class.assQuestionExport.php:189
$DIC
global $DIC
Definition: feed.php:28
$xml
$xml
Definition: metadata.php:351
assQuestionExport\addAdditionalContentEditingModeInformation
addAdditionalContentEditingModeInformation(ilXmlWriter $a_xml_writer)
adds a qti meta data field for ilias specific information of "additional content editing mode" (xml w...
Definition: class.assQuestionExport.php:205
assQuestionExport\addSolutionHints
addSolutionHints(ilXmlWriter $writer)
Definition: class.assQuestionExport.php:236
+ Here is the call graph for this function:
The documentation for this class was generated from the following file: