ilTestRandomQuestionSetStagingPoolBuilder Class Reference

Collaboration diagram for ilTestRandomQuestionSetStagingPoolBuilder:

Public Member Functions
	__construct (private readonly ilDBInterface $db, private readonly TestLogger $logger, private readonly ilObjTest $test_obj)
	rebuild (ilTestRandomQuestionSetSourcePoolDefinitionList $source_pool_definition_list)
	reset ()

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)
	applyMappedTaxonomiesKeys (ilTestRandomQuestionSetSourcePoolDefinitionList $source_pool_definition_list, ilQuestionPoolDuplicatedTaxonomiesKeysMap $taxonomies_keys_map, int $source_pool_id)

Detailed Description

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

Constructor & Destructor Documentation

__construct()

ilTestRandomQuestionSetStagingPoolBuilder::__construct	(	private readonly ilDBInterface	$db,
		private readonly TestLogger	$logger,
		private readonly ilObjTest	$test_obj
	)

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

      {
    }

Member Function Documentation

applyMappedTaxonomiesKeys()

ilTestRandomQuestionSetStagingPoolBuilder::applyMappedTaxonomiesKeys ( ilTestRandomQuestionSetSourcePoolDefinitionList  $source_pool_definition_list, ilQuestionPoolDuplicatedTaxonomiesKeysMap  $taxonomies_keys_map, int  $source_pool_id  )

private

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

     : void {
        foreach ($source_pool_definition_list as $definition) {
            if ($definition->getPoolId() === $source_pool_id) {
                $definition->mapTaxonomyFilter($taxonomies_keys_map);
            }
        }
    }

Referenced by build(), and buildCheap().

Here is the caller graph for this function:

build()

ilTestRandomQuestionSetStagingPoolBuilder::build ( ilTestRandomQuestionSetSourcePoolDefinitionList  $sourcePoolDefinitionList )

private

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

    {
        $involvedSourcePoolIds = $sourcePoolDefinitionList->getInvolvedSourcePoolIds();
 
        foreach ($involvedSourcePoolIds as $sourcePoolId) {
            $questionIdMapping = $this->stageQuestionsFromSourcePool($sourcePoolId);
 
            $taxonomiesKeysMap = $this->mirrorSourcePoolTaxonomies($sourcePoolId, $questionIdMapping);
 
            $this->applyMappedTaxonomiesKeys($sourcePoolDefinitionList, $taxonomiesKeysMap, $sourcePoolId);
        }
    }

References applyMappedTaxonomiesKeys(), ilTestRandomQuestionSetSourcePoolDefinitionList\getInvolvedSourcePoolIds(), mirrorSourcePoolTaxonomies(), and stageQuestionsFromSourcePool().

Here is the call graph for this function:

buildCheap()

ilTestRandomQuestionSetStagingPoolBuilder::buildCheap ( ilTestRandomQuestionSetSourcePoolDefinitionList  $sourcePoolDefinitionList )

private

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

    {
        // TODO-RND2017: refactor using assQuestionList and wrap with assQuestionListCollection for unioning
 
        $questionIdMappingPerPool = [];
 
        // 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)) {
                $filterItems = null;
                foreach ($taxFilter as $taxId => $nodeIds) {
                    $taxItems = [];
                    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);
        }
    }

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

Referenced by rebuild().

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 231 of file class.ilTestRandomQuestionSetStagingPoolBuilder.php.

                                                                                  : ilQuestionPoolDuplicatedTaxonomiesKeysMap
    {
        $duplicator = new ilQuestionPoolTaxonomiesDuplicator();
 
        $duplicator->setSourceObjId($sourcePoolId);
        $duplicator->setSourceObjType('qpl');
        $duplicator->setTargetObjId($this->test_obj->getId());
        $duplicator->setTargetObjType($this->test_obj->getType());
        $duplicator->setQuestionIdMapping($questionIdMapping);
 
        $duplicator->duplicate($duplicator->getAllTaxonomiesForSourceObject());
 
        return $duplicator->getDuplicatedTaxonomiesKeysMap();
    }

Referenced by build(), and buildCheap().

Here is the caller graph for this function:

rebuild()

ilTestRandomQuestionSetStagingPoolBuilder::rebuild

(

ilTestRandomQuestionSetSourcePoolDefinitionList

$source_pool_definition_list

)

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

                                                                                                         : void
    {
        $this->reset();
        $this->buildCheap($source_pool_definition_list);
    }

References buildCheap(), and reset().

Here is the call graph for this function:

removeMirroredTaxonomies()

ilTestRandomQuestionSetStagingPoolBuilder::removeMirroredTaxonomies ( )

private

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

    {
        $taxonomyIds = ilObjTaxonomy::getUsageOfObject($this->test_obj->getId());
 
        foreach ($taxonomyIds as $taxId) {
            $taxonomy = new ilObjTaxonomy($taxId);
            $taxonomy->delete();
        }
    }

References ilObjTaxonomy\getUsageOfObject().

Referenced by reset().

Here is the call graph for this function:

Here is the caller graph for this function:

removeStagedQuestions()

ilTestRandomQuestionSetStagingPoolBuilder::removeStagedQuestions ( )

private

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

    {
        $query = 'SELECT * FROM tst_rnd_cpy WHERE tst_fi = %s';
        $res = $this->db->queryF(
            $query,
            ['integer'],
            [$this->test_obj->getTestId()]
        );
 
        while ($row = $this->db->fetchAssoc($res)) {
            try {
                $question = assQuestion::instantiateQuestion($row['qst_fi']);
            } catch (InvalidArgumentException $ex) {
                $this->logger->warning(
                    "could not delete staged random question (ref={$this->test_obj->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, ['integer'], [$this->test_obj->getTestId()]);
    }

References $res, assQuestion\instantiateQuestion(), and ILIAS\Repository\logger().

Referenced by reset().

Here is the call graph for this function:

Here is the caller graph for this function:

reset()

ilTestRandomQuestionSetStagingPoolBuilder::reset

(

)

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

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

References removeMirroredTaxonomies(), and removeStagedQuestions().

Referenced by rebuild().

Here is the call graph for this function:

Here is the caller graph for this function:

stageQuestionsFromSourcePool()

ilTestRandomQuestionSetStagingPoolBuilder::stageQuestionsFromSourcePool (   $sourcePoolId )

private

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

                                                                : array
    {
        $questionIdMapping = [];
 
        $query = 'SELECT question_id FROM qpl_questions WHERE obj_fi = %s AND complete = %s AND original_id IS NULL';
        $res = $this->db->queryF($query, ['integer', 'text'], [$sourcePoolId, 1]);
 
        while ($row = $this->db->fetchAssoc($res)) {
            $question = assQuestion::instantiateQuestion($row['question_id']);
            $duplicateId = $question->duplicate(true, '', '', -1, $this->test_obj->getId());
 
            $nextId = $this->db->nextId('tst_rnd_cpy');
            $this->db->insert('tst_rnd_cpy', [
                'copy_id' => ['integer', $nextId],
                'tst_fi' => ['integer', $this->test_obj->getTestId()],
                'qst_fi' => ['integer', $duplicateId],
                'qpl_fi' => ['integer', $sourcePoolId]
            ]);
 
            $questionIdMapping[ $row['question_id'] ] = $duplicateId;
        }
 
        return $questionIdMapping;
    }

References $res, and assQuestion\instantiateQuestion().

Referenced by build().

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 193 of file class.ilTestRandomQuestionSetStagingPoolBuilder.php.

    {
        $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, ['integer', 'text'], [$sourcePoolId, 1]);
 
        while ($row = $this->db->fetchAssoc($res)) {
            if (!isset($questionIdMappingPerPool[$sourcePoolId])) {
                $questionIdMappingPerPool[$sourcePoolId] = [];
            }
            if (!isset($questionIdMappingPerPool[$sourcePoolId][ $row['question_id'] ])) {
                $question = assQuestion::instantiateQuestion($row['question_id']);
                $duplicateId = $question->duplicate(true, '', '', -1, $this->test_obj->getId());
 
                $nextId = $this->db->nextId('tst_rnd_cpy');
                $this->db->insert('tst_rnd_cpy', [
                    'copy_id' => ['integer', $nextId],
                    'tst_fi' => ['integer', $this->test_obj->getTestId()],
                    'qst_fi' => ['integer', $duplicateId],
                    'qpl_fi' => ['integer', $sourcePoolId]
                ]);
 
                $questionIdMappingPerPool[$sourcePoolId][ $row['question_id'] ] = $duplicateId;
            }
        }
 
        return $questionIdMappingPerPool;
    }

References $res, and assQuestion\instantiateQuestion().

Referenced by buildCheap().

Here is the call graph for this function:

Here is the caller graph for this function:

---

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

• components/ILIAS/Test/classes/class.ilTestRandomQuestionSetStagingPoolBuilder.php