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)
	mirrorSourcePoolTaxonomies ($sourcePoolId, $questionIdMapping)
	cleanupTestSettings ()

Detailed Description

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

Constructor & Destructor Documentation

__construct()

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

Definition at line 26 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 89 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 128 of file class.ilTestRandomQuestionSetStagingPoolBuilder.php.

References array, 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();
            
            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
                );
            } 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
                );
            }
        }
        
        // 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:

cleanupTestSettings()

ilTestRandomQuestionSetStagingPoolBuilder::cleanupTestSettings ( )

private

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

References array.

Referenced by reset().

    {
        $this->testOBJ->setResultFilterTaxIds(array());
        $this->testOBJ->saveToDb(true);
    }

Here is the caller graph for this function:

mirrorSourcePoolTaxonomies()

ilTestRandomQuestionSetStagingPoolBuilder::mirrorSourcePoolTaxonomies (   $sourcePoolId,   $questionIdMapping  )

private

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

Referenced by build(), and buildCheap().

    {
        $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 34 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 54 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 64 of file class.ilTestRandomQuestionSetStagingPoolBuilder.php.

References $GLOBALS, $query, $res, $row, assQuestion\_instanciateQuestion(), and array.

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)) {
            $question = assQuestion::_instanciateQuestion($row['qst_fi']);

            if ($question instanceof assQuestion) {
                $question->delete($row['qst_fi']);
            } else {
                $GLOBALS['ilLog']->warning(
                    "could not delete staged random question (ref={$this->testOBJ->getRefId()} / qst={$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 45 of file class.ilTestRandomQuestionSetStagingPoolBuilder.php.

References cleanupTestSettings(), removeMirroredTaxonomies(), and removeStagedQuestions().

Referenced by rebuild().

    {
        $this->removeMirroredTaxonomies();

        $this->removeStagedQuestions();
        
        $this->cleanupTestSettings();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

stageQuestionsFromSourcePool()

ilTestRandomQuestionSetStagingPoolBuilder::stageQuestionsFromSourcePool (   $sourcePoolId )

private

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

References $query, $res, $row, assQuestion\_instanciateQuestion(), and array.

Referenced by build().

    {
        $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::_instanciateQuestion($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  )

private

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

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

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');
        }
        $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, 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)
                ));
                
                $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 19 of file class.ilTestRandomQuestionSetStagingPoolBuilder.php.

Referenced by __construct().

$testOBJ

ilTestRandomQuestionSetStagingPoolBuilder::$testOBJ = null

Definition at line 24 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