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

Inheritance diagram for assOrderingQuestionImport:

Collaboration diagram for assOrderingQuestionImport:

Public Member Functions
	fromXML (string $importdirectory, int $user_id, ilQTIItem $item, int $questionpool_id, ?int $tst_id, ?ilObject &$tst_object, int &$question_counter, array $import_mapping)

Public Member Functions inherited from assQuestionImport
	getQuestionId ()

	getFeedbackGeneric ($item)

	fromXML (string $importdirectory, int $user_id, ilQTIItem $item, int $questionpool_id, ?int $tst_id, ?ilObject &$tst_object, int &$question_counter, array $import_mapping)

	importSuggestedSolutions (int $question_id, array $solution_from_import)

	QTIMaterialToString (ilQTIMaterial $a_material)
	Reads an QTI material tag and creates a text or XHTML string. More...

Data Fields
	$object

Data Fields inherited from assQuestionImport
	$object

Protected Member Functions
	handleUploadedFile (array $answer)

	ensureImagePathExists ()

Protected Member Functions inherited from assQuestionImport
	fetchIndexFromFeedbackIdent ($feedbackIdent, $prefix='response_')

	getFeedbackAnswerSpecific (ilQTIItem $item, $prefix='response_')

	addGeneralMetadata (ilQTIItem $item)

	fetchLifecycle (ilQTIItem $item)

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

	findSolutionTypeByValue (string $value)

	getSuggestedSolutionsRepo ()

	deduceThumbSizeFromImportValue (?int $size)

	addQuestionToParentObjectAndBuildMappingEntry (int $questionpool_id, ?int $tst_id, int &$question_counter, ?ilObjTest &$tst_object)

Additional Inherited Members
Protected Attributes inherited from assQuestionImport
SuggestedSolutionsDatabaseRepository	$suggestedsolution_repo = null

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 ordering question imports

assOrderingQuestionImport is a class for ordering 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.assOrderingQuestionImport.php.

Member Function Documentation

◆ ensureImagePathExists()

assOrderingQuestionImport::ensureImagePathExists ( )

protected

Definition at line 337 of file class.assOrderingQuestionImport.php.

    {
        if (!file_exists($this->object->getImagePath())) {
            ilFileUtils::makeDirParents($this->object->getImagePath());
        }
    }

References ilFileUtils\makeDirParents(), and ILIAS\Repository\object().

Here is the call graph for this function:

◆ fromXML()

assOrderingQuestionImport::fromXML	(	string	$importdirectory,
		int	$user_id,
		ilQTIItem	$item,
		int	$questionpool_id,
		?int	$tst_id,
		?ilObject &	$tst_object,
		int &	$question_counter,
		array	$import_mapping
	)

Reimplemented from assQuestionImport.

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

     : array {
        // empty session variable for imported xhtml mobs
        ilSession::clear('import_mob_xhtml');
 
        $presentation = $item->getPresentation();
        $shuffle = 0;
        $foundimage = false;
        $answers = [];
        $type = assOrderingQuestion::OQ_TERMS;
 
        foreach ($presentation->order as $entry) {
            switch ($entry['type']) {
                case 'response':
                    $response = $presentation->response[$entry["index"]];
                    $type = $response->getIdent();
                    if ($response->getIdent() === 'OQP') {
                        $type = assOrderingQuestion::OQ_PICTURES;
                    } elseif ($response->getIdent() === 'OQNP') {
                        $type = assOrderingQuestion::OQ_NESTED_PICTURES;
                    } elseif ($response->getIdent() === 'OQNT') {
                        $type = assOrderingQuestion::OQ_NESTED_TERMS;
                    } elseif ($response->getIdent() === 'OQT') {
                        $type = assOrderingQuestion::OQ_TERMS;
                    }
 
                    $rendertype = $response->getRenderType();
                    switch (get_class($rendertype)) {
                        case ilQTIRenderChoice::class:
                            $shuffle = $rendertype->getShuffle();
                            $answerorder = 0;
                            foreach ($rendertype->response_labels as $response_label) {
                                $ident = $response_label->getIdent();
                                $answertext = '';
                                $answerimage = [];
                                $answerdepth = 0;
                                foreach ($response_label->material as $mat) {
                                    for ($m = 0; $m < $mat->getMaterialCount(); $m++) {
                                        $foundmat = $mat->getMaterial($m);
 
                                        if ($foundmat['material']->getLabel() === 'answerdepth') {
                                            $answerdepth = $foundmat['material']->getContent();
                                        }
                                        if ($foundmat['type'] === 'mattext'
                                            && $foundmat['material']->getLabel() !== 'answerdepth') {
                                            $answertext .= $foundmat['material']->getContent();
                                        }
                                        if ($foundmat['type'] === 'matimage'
                                            && $foundmat['material']->getLabel() !== 'answerdepth') {
                                            $foundimage = true;
                                            $answerimage = [
                                                'imagetype' => $foundmat['material']->getImageType(),
                                                'label' => $foundmat['material']->getLabel(),
                                                'content' => $foundmat['material']->getContent()
                                            ];
                                        }
                                    }
                                }
                                $answers[$answerorder] = [
                                    'ident' => $ident,
                                    'answertext' => $answertext,
                                    'answerimage' => $answerimage,
                                    'points' => 0,
                                    'answerorder' => $answerorder,
                                    'answerdepth' => $answerdepth,
                                    'correctness' => '',
                                    'action' => ''
                                ];
                                $answerorder++;
                            }
                            break;
                    }
                    break;
            }
        }
 
        $feedbacksgeneric = [];
        foreach ($item->resprocessing as $resprocessing) {
            foreach ($resprocessing->respcondition as $respcondition) {
                $ident = '';
                $correctness = 1;
                $conditionvar = $respcondition->getConditionvar();
                foreach ($conditionvar->order as $order) {
                    switch ($order['field']) {
                        case "arr_not":
                            $correctness = 0;
                            break;
                        case "varequal":
                            $ident = $conditionvar->varequal[$order['index']]->getContent();
                            $orderindex = $conditionvar->varequal[$order['index']]->getIndex();
                            break;
                    }
                }
                foreach ($respcondition->setvar as $setvar) {
                    if ($ident !== '') {
                        $answers[$ident]['solutionorder'] = $orderindex;
                        $answers[$ident]['action'] = $setvar->getAction();
                        $answers[$ident]['points'] = $setvar->getContent();
                    }
                }
                if (!is_array($respcondition->displayfeedback)) {
                    continue;
                }
 
                foreach ($respcondition->displayfeedback as $feedbackpointer) {
                    if ($feedbackpointer->getLinkrefid() === '') {
                        continue;
                    }
 
                    foreach ($item->itemfeedback as $ifb) {
                        if ($ifb->getIdent() === 'response_allcorrect') {
                            // found a feedback for the identifier
                            foreach ($ifb->material as $material) {
                                $feedbacksgeneric[1] = $material;
                            }
                            foreach ($ifb->flow_mat as $fmat) {
                                foreach ($fmat->material as $material) {
                                    $feedbacksgeneric[1] = $material;
                                }
                            }
                            continue;
                        }
 
                        if ($ifb->getIdent() === 'response_onenotcorrect') {
                            // found a feedback for the identifier
                            foreach ($ifb->material as $material) {
                                $feedbacksgeneric[0] = $material;
                            }
                            foreach ($ifb->flow_mat as $fmat) {
                                foreach ($fmat->material as $material) {
                                    $feedbacksgeneric[0] = $material;
                                }
                            }
                        }
                    }
                }
            }
        }
 
        $itemfeedbacks = $this->getFeedbackAnswerSpecific($item, 'link_');
 
        $this->addGeneralMetadata($item);
        $this->object->setTitle($item->getTitle());
        $this->object->setNrOfTries((int) $item->getMaxattempts());
        $this->object->setComment($item->getComment());
        $this->object->setAuthor($item->getAuthor());
        $this->object->setOwner($user_id);
        $this->object->setQuestion($this->QTIMaterialToString($item->getQuestiontext()));
        $this->object->setOrderingType($type);
        $this->object->setObjId($questionpool_id);
        $this->object->setThumbSize(
            $this->deduceThumbSizeFromImportValue((int) $item->getMetadataEntry('thumb_geometry'))
        );
        $this->object->setElementHeight($item->getMetadataEntry('element_height')
            ? (int) $item->getMetadataEntry('element_height')
            : null);
        $this->object->setShuffle($shuffle);
        $this->object->setPoints(0);
        $this->object->saveQuestionDataToDb();
        $points = 0;
        $solanswers = [];
 
        foreach ($answers as $answer) {
            if (isset($answer['solutionorder'])) {
                $solanswers[$answer['solutionorder']] = $answer;
            }
        }
        ksort($solanswers);
        $position = 0;
        $element_list = $this->object->getOrderingElementList();
        foreach ($solanswers as $answer) {
            $points += $answer['points'];
 
            $element = new ilAssOrderingElement();
 
            if ($element->isExportIdent($answer['ident'])) {
                $element->setExportIdent($answer['ident']);
            } else {
                $element = $element->withPosition($position++);
                if (isset($answer['answerdepth'])) {
                    $element = $element->withIndentation((int) $answer['answerdepth']);
                }
            }
 
            if ($this->object->isImageOrderingType()) {
                $filename = $this->handleUploadedfile($answer);
                if ($filename !== null) {
                    $element = $element->withContent($filename);
                }
            } else {
                $element = $element->withContent($answer['answertext']);
            }
 
            $element_list->addElement($element);
        }
        $this->object->setOrderingElementList($element_list);
        $points = ($item->getMetadataEntry('points') > 0) ? $item->getMetadataEntry('points') : $points;
        $this->object->setPoints($points);
        // additional content editing mode information
        $this->object->setAdditionalContentEditingMode(
            $this->fetchAdditionalContentEditingModeInformation($item)
        );
        $this->object->saveToDb();
        $this->importSuggestedSolutions($this->object->getId(), $item->suggested_solutions);
        foreach ($feedbacksgeneric as $correctness => $material) {
            $m = $this->QTIMaterialToString($material);
            $feedbacksgeneric[$correctness] = $m;
        }
        $questiontext = $this->object->getQuestion();
 
        // handle the import of media objects in XHTML code
        if (is_array(ilSession::get('import_mob_xhtml'))) {
            foreach (ilSession::get('import_mob_xhtml') as $mob) {
                $importfile = $importdirectory . DIRECTORY_SEPARATOR . $mob['uri'];
 
                global $DIC; /* @var ILIAS\DI\Container $DIC */
                $DIC['ilLog']->write(__METHOD__ . ': import mob from dir: ' . $importfile);
 
                $media_object = ilObjMediaObject::_saveTempFileAsMediaObject(basename($importfile), $importfile, false);
                ilObjMediaObject::_saveUsage($media_object->getId(), "qpl:html", $this->object->getId());
                $questiontext = str_replace("src=\"" . $mob["mob"] . "\"", "src=\"" . "il_" . IL_INST_ID . "_mob_" . $media_object->getId() . "\"", $questiontext);
                foreach ($this->object->getOrderingElementList() as $element) {
                    $element->setContent(str_replace("src=\"" . $mob["mob"] . "\"", "src=\"" . "il_" . IL_INST_ID . "_mob_" . $media_object->getId() . "\"", $element->getContent()));
                }
                foreach ($feedbacksgeneric as $correctness => $material) {
                    $feedbacksgeneric[$correctness] = str_replace("src=\"" . $mob["mob"] . "\"", "src=\"" . "il_" . IL_INST_ID . "_mob_" . $media_object->getId() . "\"", $material);
                }
                foreach ($itemfeedbacks as $ident => $material) {
                    $itemfeedbacks[$ident] = str_replace("src=\"" . $mob["mob"] . "\"", "src=\"" . "il_" . IL_INST_ID . "_mob_" . $media_object->getId() . "\"", $material);
                }
            }
        }
        $this->object->setQuestion(ilRTE::_replaceMediaObjectImageSrc($questiontext, 1));
        foreach ($this->object->getOrderingElementList() as $element) {
            $element->setContent(ilRTE::_replaceMediaObjectImageSrc($element->getContent(), 1));
        }
        foreach ($feedbacksgeneric as $correctness => $material) {
            $this->object->feedbackOBJ->importGenericFeedback(
                $this->object->getId(),
                $correctness,
                ilRTE::_replaceMediaObjectImageSrc($material, 1)
            );
        }
        foreach ($itemfeedbacks as $ident => $material) {
            $index = $this->fetchIndexFromFeedbackIdent($ident, 'link_');
 
            $this->object->feedbackOBJ->importSpecificAnswerFeedback(
                $this->object->getId(),
                0,
                $index,
                ilRTE::_replaceMediaObjectImageSrc($material, 1)
            );
        }
        $this->object->saveToDb();
        $import_mapping[$item->getIdent()] = $this->addQuestionToParentObjectAndBuildMappingEntry(
            $questionpool_id,
            $tst_id,
            $question_counter,
            $tst_object
        );
        return $import_mapping;
    }

References $response, ILIAS\Test\Questions\Presentation\getLabel, assOrderingQuestion\OQ_NESTED_PICTURES, assOrderingQuestion\OQ_NESTED_TERMS, assOrderingQuestion\OQ_PICTURES, and assOrderingQuestion\OQ_TERMS.

◆ handleUploadedFile()

assOrderingQuestionImport::handleUploadedFile ( array $answer )

protected

Definition at line 306 of file class.assOrderingQuestionImport.php.

                                                        : ?string
    {
        $image = base64_decode($answer["answerimage"]["content"] ?? '');
        $image_file_name = $answer['answerimage']['label'] ?? '';
        $tmp_path = ilFileUtils::ilTempnam();
 
        $file_handle = fopen($tmp_path, "wb");
        if ($file_handle === false) {
            return null;
        }
        fwrite($file_handle, $image);
        fclose($file_handle);
 
        $filename_path_parts = explode(".", $image_file_name);
        $suffix = strtolower(array_pop($filename_path_parts));
        if (!in_array($suffix, assOrderingQuestion::VALID_UPLOAD_SUFFIXES)) {
            return null;
        }
 
        $this->ensureImagePathExists();
        $target_filename = $this->object->buildHashedImageFilename($image_file_name, true);
        $target_filepath = $this->object->getImagePath() . $target_filename;
        if (rename($tmp_path, $target_filepath)) {
            $thumb_path = $this->object->getImagePath() . $this->object->getThumbPrefix() . $target_filename;
            ilShellUtil::convertImage($target_filepath, $thumb_path, "JPEG", $this->object->getThumbSize());
            return $target_filename;
        }
 
        return null;
    }