ILIAS  release_7 Revision v7.30-3-g800a261c036
Public Member Functions | Data Fields
assOrderingQuestionExport Class Reference
Modules/TestQuestionPool

Class for ordering question exports. More...

+ Inheritance diagram for assOrderingQuestionExport:
+ Collaboration diagram for assOrderingQuestionExport:

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

Data Fields

 $object
 
- Data Fields inherited from assQuestionExport
 $object
 
const ITEM_SOLUTIONHINT = 'solutionhint'
 

Additional Inherited Members

- 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

Class for ordering question exports.

assOrderingQuestionExport is a class for ordering 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 15 of file class.assOrderingQuestionExport.php.

Member Function Documentation

◆ toXML()

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

Returns
string The QTI xml representation of the question @access public

Reimplemented from assQuestionExport.

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

32 {
33 global $DIC;
34 $ilDB = $DIC['ilDB'];
35 $ilUser = $DIC['ilUser'];
36 $ilias = $DIC['ilias'];
37
38 include_once("./Services/Xml/classes/class.ilXmlWriter.php");
39 $a_xml_writer = new ilXmlWriter;
40 // set xml header
41 $a_xml_writer->xmlHeader();
42 $a_xml_writer->xmlStartTag("questestinterop");
43 $attrs = array(
44 "ident" => "il_" . IL_INST_ID . "_qst_" . $this->object->getId(),
45 "title" => $this->object->getTitle(),
46 "maxattempts" => $this->object->getNrOfTries()
47 );
48 $a_xml_writer->xmlStartTag("item", $attrs);
49 // add question description
50 $a_xml_writer->xmlElement("qticomment", null, $this->object->getComment());
51 // add estimated working time
52 $workingtime = $this->object->getEstimatedWorkingTime();
53 $duration = sprintf("P0Y0M0DT%dH%dM%dS", $workingtime["h"], $workingtime["m"], $workingtime["s"]);
54 $a_xml_writer->xmlElement("duration", null, $duration);
55 // add ILIAS specific metadata
56 $a_xml_writer->xmlStartTag("itemmetadata");
57 $a_xml_writer->xmlStartTag("qtimetadata");
58 $a_xml_writer->xmlStartTag("qtimetadatafield");
59 $a_xml_writer->xmlElement("fieldlabel", null, "ILIAS_VERSION");
60 $a_xml_writer->xmlElement("fieldentry", null, $ilias->getSetting("ilias_version"));
61 $a_xml_writer->xmlEndTag("qtimetadatafield");
62 $a_xml_writer->xmlStartTag("qtimetadatafield");
63 $a_xml_writer->xmlElement("fieldlabel", null, "QUESTIONTYPE");
64 $a_xml_writer->xmlElement("fieldentry", null, ORDERING_QUESTION_IDENTIFIER);
65 $a_xml_writer->xmlEndTag("qtimetadatafield");
66 $a_xml_writer->xmlStartTag("qtimetadatafield");
67 $a_xml_writer->xmlElement("fieldlabel", null, "AUTHOR");
68 $a_xml_writer->xmlElement("fieldentry", null, $this->object->getAuthor());
69 $a_xml_writer->xmlEndTag("qtimetadatafield");
70
71 // additional content editing information
72 $this->addAdditionalContentEditingModeInformation($a_xml_writer);
73 $this->addGeneralMetadata($a_xml_writer);
74
75 $a_xml_writer->xmlStartTag("qtimetadatafield");
76 $a_xml_writer->xmlElement("fieldlabel", null, "thumb_geometry");
77 $a_xml_writer->xmlElement("fieldentry", null, $this->object->getThumbGeometry());
78 $a_xml_writer->xmlEndTag("qtimetadatafield");
79 $a_xml_writer->xmlStartTag("qtimetadatafield");
80 $a_xml_writer->xmlElement("fieldlabel", null, "element_height");
81 $a_xml_writer->xmlElement("fieldentry", null, $this->object->getElementHeight());
82 $a_xml_writer->xmlEndTag("qtimetadatafield");
83 $a_xml_writer->xmlStartTag("qtimetadatafield");
84 $a_xml_writer->xmlElement("fieldlabel", null, "points");
85 $a_xml_writer->xmlElement("fieldentry", null, $this->object->getPoints());
86 $a_xml_writer->xmlEndTag("qtimetadatafield");
87 $a_xml_writer->xmlEndTag("qtimetadata");
88 $a_xml_writer->xmlEndTag("itemmetadata");
89
90 // PART I: qti presentation
91 $attrs = array(
92 "label" => $this->object->getTitle()
93 );
94 $a_xml_writer->xmlStartTag("presentation", $attrs);
95 // add flow to presentation
96 $a_xml_writer->xmlStartTag("flow");
97 // add material with question text to presentation
98 $this->object->addQTIMaterial($a_xml_writer, $this->object->getQuestion());
99 // add answers to presentation
100 $attrs = array();
101
102 if ($this->object->getOrderingType() == OQ_PICTURES) {
103 $ordering_type = 'OQP';
104 } elseif ($this->object->getOrderingType() == OQ_NESTED_PICTURES) {
105 $ordering_type = 'OQNP';
106 } elseif ($this->object->getOrderingType() == OQ_NESTED_TERMS) {
107 $ordering_type = 'OQNT';
108 } elseif ($this->object->getOrderingType() == OQ_TERMS) {
109 $ordering_type = 'OQT';
110 }
111
112 $attrs = array(
113 "ident" => $ordering_type,
114 "rcardinality" => "Ordered"
115 );
116
117 if ($this->object->getOutputType() == OUTPUT_JAVASCRIPT) {
118 $attrs["output"] = "javascript";
119 }
120 $a_xml_writer->xmlStartTag("response_lid", $attrs);
121 $solution = $this->object->getSuggestedSolution(0);
122 if (count($solution)) {
123 if (preg_match("/il_(\d*?)_(\w+)_(\d+)/", $solution["internal_link"], $matches)) {
124 $a_xml_writer->xmlStartTag("material");
125 $intlink = "il_" . IL_INST_ID . "_" . $matches[2] . "_" . $matches[3];
126 if (strcmp($matches[1], "") != 0) {
127 $intlink = $solution["internal_link"];
128 }
129 $attrs = array(
130 "label" => "suggested_solution"
131 );
132 $a_xml_writer->xmlElement("mattext", $attrs, $intlink);
133 $a_xml_writer->xmlEndTag("material");
134 }
135 }
136 // shuffle output
137 $attrs = array();
138 if ($this->object->getShuffle()) {
139 $attrs = array(
140 "shuffle" => "Yes"
141 );
142 } else {
143 $attrs = array(
144 "shuffle" => "No"
145 );
146 }
147 $a_xml_writer->xmlStartTag("render_choice", $attrs);
148
149 // add answers
150 foreach ($this->object->getOrderingElementList() as $element) {
151 $attrs = array(
152 'ident' => $element->getExportIdent()
153 );
154 $a_xml_writer->xmlStartTag("response_label", $attrs);
155 if ($this->object->getOrderingType() == OQ_PICTURES
156 || $this->object->getOrderingType() == OQ_NESTED_PICTURES) {
157 $imagetype = "image/jpeg";
158
159 $a_xml_writer->xmlStartTag("material");
160 if ($force_image_references) {
161 $attrs = array(
162 "imagtype" => $imagetype,
163 "label" => $element->getContent(),
164 "uri" => $this->object->getImagePathWeb() . $element->getContent()
165 );
166 $a_xml_writer->xmlElement("matimage", $attrs);
167 } else {
168 $imagepath = $this->object->getImagePath() . $element->getContent();
169 $fh = @fopen($imagepath, "rb");
170 if ($fh != false) {
171 $imagefile = fread($fh, filesize($imagepath));
172 fclose($fh);
173 $base64 = base64_encode($imagefile);
174
175 if (preg_match("/.*\.(png|gif)$/", $element->getContent(), $matches)) {
176 $imagetype = "image/" . $matches[1];
177 }
178 $attrs = array(
179 "imagtype" => $imagetype,
180 "label" => $element->getContent(),
181 "embedded" => "base64"
182 );
183 $a_xml_writer->xmlElement("matimage", $attrs, $base64, false, false);
184 }
185 }
186 $a_xml_writer->xmlEndTag("material");
187 } elseif ($this->object->getOrderingType() == OQ_TERMS
188 || $this->object->getOrderingType() == OQ_NESTED_TERMS) {
189 $a_xml_writer->xmlStartTag("material");
190 $this->object->addQTIMaterial($a_xml_writer, $element->getContent(), true, false);
191 $a_xml_writer->xmlEndTag("material");
192 $a_xml_writer->xmlStartTag("material");
193 $attrs = array("label" => "answerdepth");
194 $a_xml_writer->xmlElement("mattext", $attrs, $element->getIndentation());
195 $a_xml_writer->xmlEndTag("material");
196 }
197 $a_xml_writer->xmlEndTag("response_label");
198 }
199 $a_xml_writer->xmlEndTag("render_choice");
200 $a_xml_writer->xmlEndTag("response_lid");
201 $a_xml_writer->xmlEndTag("flow");
202 $a_xml_writer->xmlEndTag("presentation");
203
204 // PART II: qti resprocessing
205 $a_xml_writer->xmlStartTag("resprocessing");
206 $a_xml_writer->xmlStartTag("outcomes");
207 $a_xml_writer->xmlStartTag("decvar");
208 $a_xml_writer->xmlEndTag("decvar");
209 $a_xml_writer->xmlEndTag("outcomes");
210 // add response conditions
211 foreach ($this->object->getOrderingElementList() as $element) {
212 $attrs = array(
213 "continue" => "Yes"
214 );
215 $a_xml_writer->xmlStartTag("respcondition", $attrs);
216 // qti conditionvar
217 $a_xml_writer->xmlStartTag("conditionvar");
218 $attrs = array();
219
220 if ($this->object->getOrderingType() == OQ_PICTURES) {
221 $ordering_type = 'OQP';
222 } elseif ($this->object->getOrderingType() == OQ_NESTED_PICTURES) {
223 $ordering_type = 'OQNP';
224 } elseif ($this->object->getOrderingType() == OQ_NESTED_TERMS) {
225 $ordering_type = 'OQNT';
226 } elseif ($this->object->getOrderingType() == OQ_TERMS) {
227 $ordering_type = 'OQT';
228 }
229
230 $attrs = array("respident" => $ordering_type);
231
232 $attrs["index"] = $element->getPosition();
233 $a_xml_writer->xmlElement("varequal", $attrs, $element->getPosition());
234 $a_xml_writer->xmlEndTag("conditionvar");
235 // qti setvar
236 $attrs = array(
237 "action" => "Add"
238 );
239 $points = $this->object->getPoints() / $this->object->getOrderingElementList()->countElements();
240 $a_xml_writer->xmlElement("setvar", $attrs, $points);
241 // qti displayfeedback
242 $attrs = array(
243 "feedbacktype" => "Response",
244 "linkrefid" => "link_" . $element->getPosition()
245 );
246 $a_xml_writer->xmlElement("displayfeedback", $attrs);
247 $a_xml_writer->xmlEndTag("respcondition");
248 }
249
250 $feedback_allcorrect = $this->object->feedbackOBJ->getGenericFeedbackExportPresentation(
251 $this->object->getId(),
252 true
253 );
254 if (strlen($feedback_allcorrect)) {
255 $attrs = array(
256 "continue" => "Yes"
257 );
258 $a_xml_writer->xmlStartTag("respcondition", $attrs);
259 // qti conditionvar
260 $a_xml_writer->xmlStartTag("conditionvar");
261
262 foreach ($this->object->getOrderingElementList() as $element) {
263 $attrs = array();
264
265 if ($this->object->getOrderingType() == OQ_PICTURES) {
266 $ordering_type = 'OQP';
267 } elseif ($this->object->getOrderingType() == OQ_NESTED_PICTURES) {
268 $ordering_type = 'OQNP';
269 } elseif ($this->object->getOrderingType() == OQ_NESTED_TERMS) {
270 $ordering_type = 'OQNT';
271 } elseif ($this->object->getOrderingType() == OQ_TERMS) {
272 $ordering_type = 'OQT';
273 }
274
275 $attrs = array("respident" => $ordering_type);
276
277 $attrs["index"] = $element->getPosition();
278 $a_xml_writer->xmlElement("varequal", $attrs, $element->getPosition());
279 }
280
281 $a_xml_writer->xmlEndTag("conditionvar");
282 // qti displayfeedback
283 $attrs = array(
284 "feedbacktype" => "Response",
285 "linkrefid" => "response_allcorrect"
286 );
287 $a_xml_writer->xmlElement("displayfeedback", $attrs);
288 $a_xml_writer->xmlEndTag("respcondition");
289 }
290
291 $feedback_onenotcorrect = $this->object->feedbackOBJ->getGenericFeedbackExportPresentation(
292 $this->object->getId(),
293 false
294 );
295 if (strlen($feedback_onenotcorrect)) {
296 $attrs = array(
297 "continue" => "Yes"
298 );
299 $a_xml_writer->xmlStartTag("respcondition", $attrs);
300 // qti conditionvar
301 $a_xml_writer->xmlStartTag("conditionvar");
302 $a_xml_writer->xmlStartTag("not");
303
304 foreach ($this->object->getOrderingElementList() as $element) {
305 $attrs = array();
306 if ($this->object->getOrderingType() == OQ_PICTURES) {
307 $ordering_type = 'OQP';
308 } elseif ($this->object->getOrderingType() == OQ_NESTED_PICTURES) {
309 $ordering_type = 'OQNP';
310 } elseif ($this->object->getOrderingType() == OQ_NESTED_TERMS) {
311 $ordering_type = 'OQNT';
312 } elseif ($this->object->getOrderingType() == OQ_TERMS) {
313 $ordering_type = 'OQT';
314 }
315
316 $attrs = array("respident" => $ordering_type);
317
318 $attrs["index"] = $element->getPosition();
319 $a_xml_writer->xmlElement("varequal", $attrs, $element->getPosition());
320 }
321
322 $a_xml_writer->xmlEndTag("not");
323 $a_xml_writer->xmlEndTag("conditionvar");
324 // qti displayfeedback
325 $attrs = array(
326 "feedbacktype" => "Response",
327 "linkrefid" => "response_onenotcorrect"
328 );
329 $a_xml_writer->xmlElement("displayfeedback", $attrs);
330 $a_xml_writer->xmlEndTag("respcondition");
331 }
332
333 $a_xml_writer->xmlEndTag("resprocessing");
334
335 // PART III: qti itemfeedback
336 foreach ($this->object->getOrderingElementList() as $element) {
337 $attrs = array(
338 "ident" => "link_" . $element->getPosition(),
339 "view" => "All"
340 );
341 $a_xml_writer->xmlStartTag("itemfeedback", $attrs);
342 // qti flow_mat
343 $a_xml_writer->xmlStartTag("flow_mat");
344 $a_xml_writer->xmlStartTag("material");
345 $a_xml_writer->xmlElement("mattext", null, $this->object->feedbackOBJ->getSpecificAnswerFeedbackExportPresentation(
346 $this->object->getId(),
347 0,
348 $element->getPosition()
349 ));
350 $a_xml_writer->xmlEndTag("material");
351 $a_xml_writer->xmlEndTag("flow_mat");
352 $a_xml_writer->xmlEndTag("itemfeedback");
353 }
354
355 if (strlen($feedback_allcorrect)) {
356 $attrs = array(
357 "ident" => "response_allcorrect",
358 "view" => "All"
359 );
360 $a_xml_writer->xmlStartTag("itemfeedback", $attrs);
361 // qti flow_mat
362 $a_xml_writer->xmlStartTag("flow_mat");
363 $this->object->addQTIMaterial($a_xml_writer, $feedback_allcorrect);
364 $a_xml_writer->xmlEndTag("flow_mat");
365 $a_xml_writer->xmlEndTag("itemfeedback");
366 }
367 if (strlen($feedback_onenotcorrect)) {
368 $attrs = array(
369 "ident" => "response_onenotcorrect",
370 "view" => "All"
371 );
372 $a_xml_writer->xmlStartTag("itemfeedback", $attrs);
373 // qti flow_mat
374 $a_xml_writer->xmlStartTag("flow_mat");
375 $this->object->addQTIMaterial($a_xml_writer, $feedback_onenotcorrect);
376 $a_xml_writer->xmlEndTag("flow_mat");
377 $a_xml_writer->xmlEndTag("itemfeedback");
378 }
379
380 $a_xml_writer = $this->addSolutionHints($a_xml_writer);
381
382 $a_xml_writer->xmlEndTag("item");
383 $a_xml_writer->xmlEndTag("questestinterop");
384
385 $xml = $a_xml_writer->xmlDumpMem(false);
386 if (!$a_include_header) {
387 $pos = strpos($xml, "?>");
388 $xml = substr($xml, $pos + 2);
389 }
390 return $xml;
391 }
assQuestionExport\addGeneralMetadata
addGeneralMetadata(ilXmlWriter $xmlwriter)
Definition: class.assQuestionExport.php:206
assQuestionExport\addSolutionHints
addSolutionHints(ilXmlWriter $writer)
Definition: class.assQuestionExport.php:225
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:194
ilXmlWriter
XML writer class.
Definition: class.ilXmlWriter.php:18
ilXmlWriter\xmlHeader
xmlHeader()
Writes xml header @access public.
Definition: class.ilXmlWriter.php:275
IL_INST_ID
const IL_INST_ID
Definition: constants.php:38
$DIC
global $DIC
Definition: goto.php:24
$ilUser
$ilUser
Definition: imgupload.php:18
OQ_NESTED_PICTURES
const OQ_NESTED_PICTURES
Definition: inc.AssessmentConstants.php:79
OUTPUT_JAVASCRIPT
const OUTPUT_JAVASCRIPT
Definition: inc.AssessmentConstants.php:19
OQ_TERMS
const OQ_TERMS
Definition: inc.AssessmentConstants.php:78
OQ_NESTED_TERMS
const OQ_NESTED_TERMS
Definition: inc.AssessmentConstants.php:80
OQ_PICTURES
const OQ_PICTURES
Ordering question constants.
Definition: inc.AssessmentConstants.php:77
ORDERING_QUESTION_IDENTIFIER
const ORDERING_QUESTION_IDENTIFIER
Definition: inc.AssessmentConstants.php:32
$xml
$xml
Definition: metadata.php:332
$ilDB
global $ilDB
Definition: storeScorm2004.php:19

References $DIC, $ilDB, $ilUser, $xml, assQuestionExport\addAdditionalContentEditingModeInformation(), assQuestionExport\addGeneralMetadata(), assQuestionExport\addSolutionHints(), IL_INST_ID, OQ_NESTED_PICTURES, OQ_NESTED_TERMS, OQ_PICTURES, OQ_TERMS, ORDERING_QUESTION_IDENTIFIER, OUTPUT_JAVASCRIPT, and ilXmlWriter\xmlHeader().

+ Here is the call graph for this function:

Field Documentation

◆ $object

assOrderingQuestionExport::$object

Definition at line 20 of file class.assOrderingQuestionExport.php.

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