class.assOrderingQuestionImport.php

Go to the documentation of this file.

<?php

class assOrderingQuestionImport extends assQuestionImport
{
    public $object;

    public function fromXML(
        string $importdirectory,
        int $user_id,
        ilQTIItem $item,
        int $questionpool_id,
        ?int $tst_id,
        ?ilObject &$tst_object,
        int &$question_counter,
        array $import_mapping
    ): 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;
    }

    protected function handleUploadedFile(array $answer): ?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;
    }

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