ilTestRandomQuestionSetStagingPoolBuilder Class Reference

Collaboration diagram for ilTestRandomQuestionSetStagingPoolBuilder:

Public Member Functions
	__construct (ilDBInterface $db, ilObjTest $testOBJ)
	rebuild (ilTestRandomQuestionSetSourcePoolDefinitionList $sourcePoolDefinitionList)
	reset ()

Data Fields
	$db = null
	$testOBJ = null

Private Member Functions
	removeMirroredTaxonomies ()
	removeStagedQuestions ()
	build (ilTestRandomQuestionSetSourcePoolDefinitionList $sourcePoolDefinitionList)
	stageQuestionsFromSourcePool ($sourcePoolId)
	buildCheap (ilTestRandomQuestionSetSourcePoolDefinitionList $sourcePoolDefinitionList)
	stageQuestionsFromSourcePoolCheap ($sourcePoolId, $questionIdMappingPerPool, $filterIds=null, $typeFilter=null, $lifecycleFilter=null)
	mirrorSourcePoolTaxonomies ($sourcePoolId, $questionIdMapping)

Detailed Description

Definition at line 25 of file class.ilTestRandomQuestionSetStagingPoolBuilder.php.

Constructor & Destructor Documentation

__construct()

ilTestRandomQuestionSetStagingPoolBuilder::__construct	(	ilDBInterface	$db,
		ilObjTest	$testOBJ
	)

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

References $db, and $testOBJ.

    {
        $this->db = $db;
        $this->testOBJ = $testOBJ;
    }

Member Function Documentation

build()

ilTestRandomQuestionSetStagingPoolBuilder::build ( ilTestRandomQuestionSetSourcePoolDefinitionList  $sourcePoolDefinitionList )

private

Definition at line 98 of file class.ilTestRandomQuestionSetStagingPoolBuilder.php.

References mirrorSourcePoolTaxonomies(), and stageQuestionsFromSourcePool().

    {
        $involvedSourcePoolIds = $sourcePoolDefinitionList->getInvolvedSourcePoolIds();

        foreach ($involvedSourcePoolIds as $sourcePoolId) {
            $questionIdMapping = $this->stageQuestionsFromSourcePool($sourcePoolId);

            $taxonomiesKeysMap = $this->mirrorSourcePoolTaxonomies($sourcePoolId, $questionIdMapping);

            $this->applyMappedTaxonomiesKeys($sourcePoolDefinitionList, $taxonomiesKeysMap, $sourcePoolId);
        }
    }

Here is the call graph for this function:

buildCheap()

ilTestRandomQuestionSetStagingPoolBuilder::buildCheap ( ilTestRandomQuestionSetSourcePoolDefinitionList  $sourcePoolDefinitionList )

private

Definition at line 137 of file class.ilTestRandomQuestionSetStagingPoolBuilder.php.

References ilObjTaxonomy\getSubTreeItems(), mirrorSourcePoolTaxonomies(), and stageQuestionsFromSourcePoolCheap().

Referenced by rebuild().

    {
        // TODO-RND2017: refactor using assQuestionList and wrap with assQuestionListCollection for unioning

        $questionIdMappingPerPool = array();

        // select questions to be copied by the definitions
        // note: a question pool may appear many times in this list

        /* @var ilTestRandomQuestionSetSourcePoolDefinition $definition */
        foreach ($sourcePoolDefinitionList as $definition) {
            $taxFilter = $definition->getOriginalTaxonomyFilter();
            $typeFilter = $definition->getTypeFilter();
            $lifecycleFilter = $definition->getLifecycleFilter();

            if (!empty($taxFilter)) {
                require_once 'Services/Taxonomy/classes/class.ilObjTaxonomy.php';

                $filterItems = null;
                foreach ($taxFilter as $taxId => $nodeIds) {
                    $taxItems = array();
                    foreach ($nodeIds as $nodeId) {
                        $nodeItems = ilObjTaxonomy::getSubTreeItems(
                            'qpl',
                            $definition->getPoolId(),
                            'quest',
                            $taxId,
                            $nodeId
                        );

                        foreach ($nodeItems as $nodeItem) {
                            $taxItems[] = $nodeItem['item_id'];
                        }
                    }

                    $filterItems = isset($filterItems) ? array_intersect($filterItems, array_unique($taxItems)) : array_unique($taxItems);
                }

                // stage only the questions applying to the tax/type filter
                // and save the duplication map for later use

                $questionIdMappingPerPool = $this->stageQuestionsFromSourcePoolCheap(
                    $definition->getPoolId(),
                    $questionIdMappingPerPool,
                    array_values($filterItems),
                    $typeFilter,
                    $lifecycleFilter
                );
            } else {
                // stage only the questions applying to the tax/type filter
                // and save the duplication map for later use

                $questionIdMappingPerPool = $this->stageQuestionsFromSourcePoolCheap(
                    $definition->getPoolId(),
                    $questionIdMappingPerPool,
                    null,
                    $typeFilter,
                    $lifecycleFilter
                );
            }
        }

        // copy the taxonomies to the test and map them
        foreach ($questionIdMappingPerPool as $sourcePoolId => $questionIdMapping) {
            $taxonomiesKeysMap = $this->mirrorSourcePoolTaxonomies($sourcePoolId, $questionIdMapping);
            $this->applyMappedTaxonomiesKeys($sourcePoolDefinitionList, $taxonomiesKeysMap, $sourcePoolId);
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

mirrorSourcePoolTaxonomies()

ilTestRandomQuestionSetStagingPoolBuilder::mirrorSourcePoolTaxonomies (   $sourcePoolId,   $questionIdMapping  )

private

Definition at line 244 of file class.ilTestRandomQuestionSetStagingPoolBuilder.php.

Referenced by build(), and buildCheap().

                                                                                  : ilQuestionPoolDuplicatedTaxonomiesKeysMap
    {
        $duplicator = new ilQuestionPoolTaxonomiesDuplicator();

        $duplicator->setSourceObjId($sourcePoolId);
        $duplicator->setSourceObjType('qpl');
        $duplicator->setTargetObjId($this->testOBJ->getId());
        $duplicator->setTargetObjType($this->testOBJ->getType());
        $duplicator->setQuestionIdMapping($questionIdMapping);

        $duplicator->duplicate($duplicator->getAllTaxonomiesForSourceObject());

        return $duplicator->getDuplicatedTaxonomiesKeysMap();
    }

Here is the caller graph for this function:

rebuild()

ilTestRandomQuestionSetStagingPoolBuilder::rebuild

(

ilTestRandomQuestionSetSourcePoolDefinitionList

$sourcePoolDefinitionList

)

Definition at line 45 of file class.ilTestRandomQuestionSetStagingPoolBuilder.php.

References buildCheap(), and reset().

    {
        $this->reset();

        // fau: taxFilter/typeFilter - copy only the needed questions, and copy every question only once
        // TODO-RND2017: remove non cheap methods and rename cheap ones
        #$this->build($sourcePoolDefinitionList);
        $this->buildCheap($sourcePoolDefinitionList);
        // fau.
    }

Here is the call graph for this function:

removeMirroredTaxonomies()

ilTestRandomQuestionSetStagingPoolBuilder::removeMirroredTaxonomies ( )

private

Definition at line 62 of file class.ilTestRandomQuestionSetStagingPoolBuilder.php.

References ilObjTaxonomy\getUsageOfObject().

Referenced by reset().

    {
        $taxonomyIds = ilObjTaxonomy::getUsageOfObject($this->testOBJ->getId());

        foreach ($taxonomyIds as $taxId) {
            $taxonomy = new ilObjTaxonomy($taxId);
            $taxonomy->delete();
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

removeStagedQuestions()

ilTestRandomQuestionSetStagingPoolBuilder::removeStagedQuestions ( )

private

Definition at line 72 of file class.ilTestRandomQuestionSetStagingPoolBuilder.php.

References $DIC, $query, $res, and assQuestion\instantiateQuestion().

Referenced by reset().

    {
        $query = 'SELECT * FROM tst_rnd_cpy WHERE tst_fi = %s';
        $res = $this->db->queryF(
            $query,
            array('integer'),
            array($this->testOBJ->getTestId())
        );

        while ($row = $this->db->fetchAssoc($res)) {
            try {
                $question = assQuestion::instantiateQuestion($row['qst_fi']);
            } catch (InvalidArgumentException $ex) {
                global $DIC; /* @var ILIAS\DI\Container $DIC */
                $DIC['ilLog']->warning(
                    "could not delete staged random question (ref={$this->testOBJ->getRefId()} / qst={$row['qst_fi']})"
                );
                return;
            }
            $question->delete($row['qst_fi']);
        }

        $query = "DELETE FROM tst_rnd_cpy WHERE tst_fi = %s";
        $this->db->manipulateF($query, array('integer'), array($this->testOBJ->getTestId()));
    }

Here is the call graph for this function:

Here is the caller graph for this function:

reset()

ilTestRandomQuestionSetStagingPoolBuilder::reset

(

)

Definition at line 56 of file class.ilTestRandomQuestionSetStagingPoolBuilder.php.

References removeMirroredTaxonomies(), and removeStagedQuestions().

Referenced by rebuild().

    {
        $this->removeMirroredTaxonomies();
        $this->removeStagedQuestions();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

stageQuestionsFromSourcePool()

ilTestRandomQuestionSetStagingPoolBuilder::stageQuestionsFromSourcePool (   $sourcePoolId )

private

Definition at line 111 of file class.ilTestRandomQuestionSetStagingPoolBuilder.php.

References $query, $res, and assQuestion\instantiateQuestion().

Referenced by build().

                                                                : array
    {
        $questionIdMapping = array();

        $query = 'SELECT question_id FROM qpl_questions WHERE obj_fi = %s AND complete = %s AND original_id IS NULL';
        $res = $this->db->queryF($query, array('integer', 'text'), array($sourcePoolId, 1));

        while ($row = $this->db->fetchAssoc($res)) {
            $question = assQuestion::instantiateQuestion($row['question_id']);
            $duplicateId = $question->duplicate(true, null, null, null, $this->testOBJ->getId());

            $nextId = $this->db->nextId('tst_rnd_cpy');
            $this->db->insert('tst_rnd_cpy', array(
                'copy_id' => array('integer', $nextId),
                'tst_fi' => array('integer', $this->testOBJ->getTestId()),
                'qst_fi' => array('integer', $duplicateId),
                'qpl_fi' => array('integer', $sourcePoolId)
            ));

            $questionIdMapping[ $row['question_id'] ] = $duplicateId;
        }

        return $questionIdMapping;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

stageQuestionsFromSourcePoolCheap()

ilTestRandomQuestionSetStagingPoolBuilder::stageQuestionsFromSourcePoolCheap (   $sourcePoolId,   $questionIdMappingPerPool,   $filterIds = null,   $typeFilter = null,   $lifecycleFilter = null  )

private

Definition at line 206 of file class.ilTestRandomQuestionSetStagingPoolBuilder.php.

References $query, $res, and assQuestion\_instantiateQuestion().

Referenced by buildCheap().

    {
        $query = 'SELECT question_id FROM qpl_questions WHERE obj_fi = %s AND complete = %s AND original_id IS NULL';
        if (!empty($filterIds)) {
            $query .= ' AND ' . $this->db->in('question_id', $filterIds, false, 'integer');
        }
        if (!empty($typeFilter)) {
            $query .= ' AND ' . $this->db->in('question_type_fi', $typeFilter, false, 'integer');
        }
        if (!empty($lifecycleFilter)) {
            $query .= ' AND ' . $this->db->in('lifecycle', $lifecycleFilter, false, 'text');
        }
        $res = $this->db->queryF($query, array('integer', 'text'), array($sourcePoolId, 1));

        while ($row = $this->db->fetchAssoc($res)) {
            if (!isset($questionIdMappingPerPool[$sourcePoolId])) {
                $questionIdMappingPerPool[$sourcePoolId] = array();
            }
            if (!isset($questionIdMappingPerPool[$sourcePoolId][ $row['question_id'] ])) {
                $question = assQuestion::_instantiateQuestion($row['question_id']);
                $duplicateId = $question->duplicate(true, '', '', '', $this->testOBJ->getId());

                $nextId = $this->db->nextId('tst_rnd_cpy');
                $this->db->insert('tst_rnd_cpy', array(
                    'copy_id' => array('integer', $nextId),
                    'tst_fi' => array('integer', $this->testOBJ->getTestId()),
                    'qst_fi' => array('integer', $duplicateId),
                    'qpl_fi' => array('integer', $sourcePoolId)
                ));

                $questionIdMappingPerPool[$sourcePoolId][ $row['question_id'] ] = $duplicateId;
            }
        }

        return $questionIdMappingPerPool;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

$db

ilTestRandomQuestionSetStagingPoolBuilder::$db = null

Definition at line 30 of file class.ilTestRandomQuestionSetStagingPoolBuilder.php.

Referenced by __construct().

$testOBJ

ilTestRandomQuestionSetStagingPoolBuilder::$testOBJ = null

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

Referenced by __construct().

---

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

• Modules/Test/classes/class.ilTestRandomQuestionSetStagingPoolBuilder.php