assQuestionImport Class Reference

Class for question imports. More...

Inheritance diagram for assQuestionImport:

Collaboration diagram for assQuestionImport:

Public Member Functions
	__construct ($a_object)
	assQuestionImport constructor More...
	getFeedbackGeneric ($item)
	fromXML (&$item, $questionpool_id, &$tst_id, &$tst_object, &$question_counter, &$import_mapping)
	Creates a question from a QTI file. More...

Data Fields
	$object

Protected Member Functions
	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_DEFAULT when no or invalid information is given More...

Detailed Description

Class for question imports.

assQuestionImport is a basis class 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 15 of file class.assQuestionImport.php.

Constructor & Destructor Documentation

__construct()

assQuestionImport::__construct

(

$a_object

)

assQuestionImport constructor

Parameters

object

$a_object

The question object public

Definition at line 32 of file class.assQuestionImport.php.

    {
        $this->object = $a_object;
    }

Member Function Documentation

addGeneralMetadata()

assQuestionImport::addGeneralMetadata ( ilQTIItem  $item )

protected

Parameters

ilQTIItem

$item

Definition at line 172 of file class.assQuestionImport.php.

References fetchLifecycle(), and ilQTIItem\getMetadataEntry().

Referenced by assLongMenuImport\fromXML(), assKprimChoiceImport\fromXML(), assErrorTextImport\fromXML(), assFlashQuestionImport\fromXML(), assFileUploadImport\fromXML(), assOrderingHorizontalImport\fromXML(), assSingleChoiceImport\fromXML(), assMultipleChoiceImport\fromXML(), assClozeTestImport\fromXML(), assTextSubsetImport\fromXML(), assFormulaQuestionImport\fromXML(), assJavaAppletImport\fromXML(), assNumericImport\fromXML(), assImagemapQuestionImport\fromXML(), assTextQuestionImport\fromXML(), assOrderingQuestionImport\fromXML(), and assMatchingQuestionImport\fromXML().

    {
        if ($item->getMetadataEntry('externalID')) {
            $this->object->setExternalId($item->getMetadataEntry('externalID'));
        } else {
            $this->object->setExternalId($item->getMetadataEntry('externalId'));
        }

        $this->object->setLifecycle($this->fetchLifecycle($item));
    }

Here is the call graph for this function:

Here is the caller graph for this function:

fetchAdditionalContentEditingModeInformation()

assQuestionImport::fetchAdditionalContentEditingModeInformation (   $qtiItem )

finalprotected

fetches the "additional content editing mode" information from qti item and falls back to ADDITIONAL_CONTENT_EDITING_MODE_DEFAULT when no or invalid information is given

protected

Parameters

type

$qtiItem

Returns

string $additionalContentEditingMode

Definition at line 262 of file class.assQuestionImport.php.

References assQuestion\ADDITIONAL_CONTENT_EDITING_MODE_DEFAULT.

Referenced by assLongMenuImport\fromXML(), assKprimChoiceImport\fromXML(), assErrorTextImport\fromXML(), assFlashQuestionImport\fromXML(), assFileUploadImport\fromXML(), assOrderingHorizontalImport\fromXML(), assSingleChoiceImport\fromXML(), assMultipleChoiceImport\fromXML(), assClozeTestImport\fromXML(), assTextSubsetImport\fromXML(), assFormulaQuestionImport\fromXML(), assJavaAppletImport\fromXML(), assNumericImport\fromXML(), assImagemapQuestionImport\fromXML(), assTextQuestionImport\fromXML(), assOrderingQuestionImport\fromXML(), and assMatchingQuestionImport\fromXML().

    {
        $additionalContentEditingMode = $qtiItem->getMetadataEntry('additional_cont_edit_mode');
        
        if (!$this->object->isValidAdditionalContentEditingMode($additionalContentEditingMode)) {
            $additionalContentEditingMode = assQuestion::ADDITIONAL_CONTENT_EDITING_MODE_DEFAULT;
        }
        
        return $additionalContentEditingMode;
    }

Here is the caller graph for this function:

fetchIndexFromFeedbackIdent()

assQuestionImport::fetchIndexFromFeedbackIdent (   $feedbackIdent,   $prefix = 'response_'  )

protected

Parameters

	$feedbackIdent
string	$prefix

Returns

int

Definition at line 96 of file class.assQuestionImport.php.

Referenced by assErrorTextImport\fromXML(), assOrderingHorizontalImport\fromXML(), assOrderingQuestionImport\fromXML(), and assTextQuestionImport\fromXML().

    {
        return (int) str_replace($prefix, '', $feedbackIdent);
    }

Here is the caller graph for this function:

fetchLifecycle()

assQuestionImport::fetchLifecycle ( ilQTIItem  $item )

protected

Parameters

ilQTIItem

$item

Returns

ilAssQuestionLifecycle

Definition at line 187 of file class.assQuestionImport.php.

References Vendor\Package\$e, ilAssQuestionLifecycle\getDraftInstance(), ilAssQuestionLifecycle\getInstance(), and ilQTIItem\getMetadataEntry().

Referenced by addGeneralMetadata().

    {
        try {
            $lifecycle = ilAssQuestionLifecycle::getInstance(
                $item->getMetadataEntry('ilias_lifecycle')
            );
        } catch (ilTestQuestionPoolInvalidArgumentException $e) {
            try {
                $lomLifecycle = new ilAssQuestionLomLifecycle(
                    $item->getMetadataEntry('lifecycle')
                );
                
                $lifecycle = ilAssQuestionLifecycle::getInstance(
                    $lomLifecycle->getMappedIliasLifecycleIdentifer()
                );
            } catch (ilTestQuestionPoolInvalidArgumentException $e) {
                $lifecycle = ilAssQuestionLifecycle::getDraftInstance();
            }
        }
        
        return $lifecycle;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

fromXML()

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

object	$item	The QTI item object
integer	$questionpool_id	The id of the parent questionpool
integer	$tst_id	The id of the parent test if the question is part of a test
object	$tst_object	A reference to the parent test object
integer	$question_counter	A reference to a question counter to count the questions of an imported question pool
array	$import_mapping	An array containing references to included ILIAS objects public

Definition at line 165 of file class.assQuestionImport.php.

    {
    }

getFeedbackAnswerSpecific()

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

protected

Parameters

ilQTIItem	$item
string	$prefix

Returns

array

Definition at line 106 of file class.assQuestionImport.php.

Referenced by assErrorTextImport\fromXML(), assOrderingHorizontalImport\fromXML(), assOrderingQuestionImport\fromXML(), assTextQuestionImport\fromXML(), and assMatchingQuestionImport\fromXML().

    {
        $feedbacks = array();
        
        foreach ($item->itemfeedback as $ifb) {
            if ($ifb->getIdent() == 'response_allcorrect' || $ifb->getIdent() == 'response_onenotcorrect') {
                continue;
            }
            
            if ($ifb->getIdent() == $prefix . 'allcorrect' || $ifb->getIdent() == $prefix . 'onenotcorrect') {
                continue;
            }
            
            if (substr($ifb->getIdent(), 0, strlen($prefix)) != $prefix) {
                continue;
            }

            $ident = $ifb->getIdent();
            
            // found a feedback for the identifier
            
            if (count($ifb->material)) {
                foreach ($ifb->material as $material) {
                    $feedbacks[$ident] = $material;
                }
            }
            
            if ((count($ifb->flow_mat) > 0)) {
                foreach ($ifb->flow_mat as $fmat) {
                    if (count($fmat->material)) {
                        foreach ($fmat->material as $material) {
                            $feedbacks[$ident] = $material;
                        }
                    }
                }
            }
        }
        
        foreach ($feedbacks as $ident => $material) {
            $m = $this->object->QTIMaterialToString($material);
            $feedbacks[$ident] = $m;
        }
        
        return $feedbacks;
    }

Here is the caller graph for this function:

getFeedbackGeneric()

assQuestionImport::getFeedbackGeneric

(

$item

)

Definition at line 37 of file class.assQuestionImport.php.

Referenced by assErrorTextImport\fromXML(), assFileUploadImport\fromXML(), assFlashQuestionImport\fromXML(), assFormulaQuestionImport\fromXML(), and assOrderingHorizontalImport\fromXML().

    {
        $feedbacksgeneric = array();
        foreach ($item->resprocessing as $resprocessing) {
            foreach ($resprocessing->respcondition as $respcondition) {
                foreach ($respcondition->displayfeedback as $feedbackpointer) {
                    if (strlen($feedbackpointer->getLinkrefid())) {
                        foreach ($item->itemfeedback as $ifb) {
                            if (strcmp($ifb->getIdent(), "response_allcorrect") == 0) {
                                // found a feedback for the identifier
                                if (count($ifb->material)) {
                                    foreach ($ifb->material as $material) {
                                        $feedbacksgeneric[1] = $material;
                                    }
                                }
                                if ((count($ifb->flow_mat) > 0)) {
                                    foreach ($ifb->flow_mat as $fmat) {
                                        if (count($fmat->material)) {
                                            foreach ($fmat->material as $material) {
                                                $feedbacksgeneric[1] = $material;
                                            }
                                        }
                                    }
                                }
                            } elseif (strcmp($ifb->getIdent(), "response_onenotcorrect") == 0) {
                                // found a feedback for the identifier
                                if (count($ifb->material)) {
                                    foreach ($ifb->material as $material) {
                                        $feedbacksgeneric[0] = $material;
                                    }
                                }
                                if ((count($ifb->flow_mat) > 0)) {
                                    foreach ($ifb->flow_mat as $fmat) {
                                        if (count($fmat->material)) {
                                            foreach ($fmat->material as $material) {
                                                $feedbacksgeneric[0] = $material;
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
        // handle the import of media objects in XHTML code
        foreach ($feedbacksgeneric as $correctness => $material) {
            $m = $this->object->QTIMaterialToString($material);
            $feedbacksgeneric[$correctness] = $m;
        }
        return $feedbacksgeneric;
    }

Here is the caller graph for this function:

getQplImportArchivDirectory()

assQuestionImport::getQplImportArchivDirectory ( )

protected

returns the full path to extracted qpl import archiv (qpl import dir + qpl archiv subdir)

Definition at line 213 of file class.assQuestionImport.php.

References $_SESSION, and ilObjQuestionPool\_getImportDirectory().

Referenced by assLongMenuImport\fromXML(), assKprimChoiceImport\fromXML(), assFlashQuestionImport\fromXML(), assErrorTextImport\fromXML(), assFileUploadImport\fromXML(), assTextSubsetImport\fromXML(), assNumericImport\fromXML(), assMultipleChoiceImport\fromXML(), assClozeTestImport\fromXML(), assImagemapQuestionImport\fromXML(), assSingleChoiceImport\fromXML(), assOrderingHorizontalImport\fromXML(), assJavaAppletImport\fromXML(), assOrderingQuestionImport\fromXML(), assTextQuestionImport\fromXML(), and assMatchingQuestionImport\fromXML().

    {
        include_once "./Modules/TestQuestionPool/classes/class.ilObjQuestionPool.php";
        return ilObjQuestionPool::_getImportDirectory() . '/' . $_SESSION["qpl_import_subdir"];
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getTstImportArchivDirectory()

assQuestionImport::getTstImportArchivDirectory ( )

protected

returns the full path to extracted tst import archiv (tst import dir + tst archiv subdir)

Definition at line 222 of file class.assQuestionImport.php.

References $_SESSION, and ilObjTest\_getImportDirectory().

Referenced by assLongMenuImport\fromXML(), assKprimChoiceImport\fromXML(), assFlashQuestionImport\fromXML(), assErrorTextImport\fromXML(), assFileUploadImport\fromXML(), assTextSubsetImport\fromXML(), assNumericImport\fromXML(), assMultipleChoiceImport\fromXML(), assClozeTestImport\fromXML(), assImagemapQuestionImport\fromXML(), assSingleChoiceImport\fromXML(), assOrderingHorizontalImport\fromXML(), assJavaAppletImport\fromXML(), assOrderingQuestionImport\fromXML(), assTextQuestionImport\fromXML(), and assMatchingQuestionImport\fromXML().

    {
        include_once "./Modules/Test/classes/class.ilObjTest.php";
        return ilObjTest::_getImportDirectory() . '/' . $_SESSION["tst_import_subdir"];
    }

Here is the call graph for this function:

Here is the caller graph for this function:

processNonAbstractedImageReferences()

assQuestionImport::processNonAbstractedImageReferences (   $text,   $sourceNic  )

protected

Definition at line 228 of file class.assQuestionImport.php.

References $_SESSION, $i, and ilRTE\_replaceMediaObjectImageSrc().

Referenced by assClozeTestImport\fromXML().

    {
        $reg = '/<img.*src=".*\\/mm_(\\d+)\\/(.*?)".*>/m';
        $matches = null;
        
        if (preg_match_all($reg, $text, $matches)) {
            for ($i = 0, $max = count($matches[1]); $i < $max; $i++) {
                $mobSrcId = $matches[1][$i];
                $mobSrcName = $matches[2][$i];
                $mobSrcLabel = 'il_' . $sourceNic . '_mob_' . $mobSrcId;

                if (!is_array($_SESSION["import_mob_xhtml"])) {
                    $_SESSION["import_mob_xhtml"] = array();
                }

                $_SESSION["import_mob_xhtml"][] = array(
                    "mob" => $mobSrcLabel, "uri" => 'objects/' . $mobSrcLabel . '/' . $mobSrcName
                );
            }
        }

        include_once "./Services/RTE/classes/class.ilRTE.php";
        return ilRTE::_replaceMediaObjectImageSrc($text, 0, $sourceNic);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

$object

assQuestionImport::$object

Definition at line 24 of file class.assQuestionImport.php.

---

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

• Modules/TestQuestionPool/classes/import/qti12/class.assQuestionImport.php