Inheritance diagram for ilTestRandomQuestionSetBuilder:

Collaboration diagram for ilTestRandomQuestionSetBuilder:

Public Member Functions
	checkBuildable ()

	performBuild (ilTestSession $test_session)

	getSrcPoolDefListRelatedQuestCombinationCollection (ilTestRandomQuestionSetSourcePoolDefinitionList $source_pool_definition_list)

	getSrcPoolDefRelatedQuestCollection (ilTestRandomQuestionSetSourcePoolDefinition $definition)

	getSrcPoolDefListRelatedQuestUniqueCollection (ilTestRandomQuestionSetSourcePoolDefinitionList $source_pool_definition_list)

	getCheckMessages ()

	getSrcPoolDefListRelatedQuestCombinationCollection (ilTestRandomQuestionSetSourcePoolDefinitionList $source_pool_definition_list)

	getSrcPoolDefListRelatedQuestUniqueCollection (ilTestRandomQuestionSetSourcePoolDefinitionList $source_pool_definition_list)

	getSrcPoolDefRelatedQuestCollection (ilTestRandomQuestionSetSourcePoolDefinition $definition)

Static Public Member Functions
static	getInstance (ilDBInterface $db, ilLanguage $lng, TestLogger $logger, ilObjTest $test_obj, ilTestRandomQuestionSetConfig $question_set_config, ilTestRandomQuestionSetSourcePoolDefinitionList $source_pool_definition_list, ilTestRandomQuestionSetStagingPoolQuestionList $staging_pool_question_list)

Protected Member Functions
	__construct (protected ilDBInterface $db, protected ilLanguage $lng, protected TestLogger $logger, protected ilObjTest $test_obj, protected ilTestRandomQuestionSetConfig $question_set_config, protected ilTestRandomQuestionSetSourcePoolDefinitionList $source_pool_definition_list, protected ilTestRandomQuestionSetStagingPoolQuestionList $staging_pool_question_list)

	storeQuestionSet (ilTestSession $test_session, $question_set)

	fetchQuestionsFromStageRandomly (ilTestRandomQuestionSetQuestionCollection $question_stage, $required_question_amount)

	handleQuestionOrdering (ilTestRandomQuestionSetQuestionCollection $question_set)

Protected Attributes
	$check_messages = []

Private Member Functions
	getQuestionIdsForSourcePoolDefinitionIds (ilTestRandomQuestionSetSourcePoolDefinition $definition)

	buildSetQuestionCollection (ilTestRandomQuestionSetSourcePoolDefinition $definition, $question_ids)

	hasTaxonomyFilter (ilTestRandomQuestionSetSourcePoolDefinition $definition)

	hasTypeFilter (ilTestRandomQuestionSetSourcePoolDefinition $definition)

	storeQuestion (ilTestSession $test_session, ilTestRandomQuestionSetQuestion $set_question)

Detailed Description

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

Constructor & Destructor Documentation

◆ __construct()

ilTestRandomQuestionSetBuilder::__construct	(	protected ilDBInterface	$db,
		protected ilLanguage	$lng,
		protected TestLogger	$logger,
		protected ilObjTest	$test_obj,
		protected ilTestRandomQuestionSetConfig	$question_set_config,
		protected ilTestRandomQuestionSetSourcePoolDefinitionList	$source_pool_definition_list,
		protected ilTestRandomQuestionSetStagingPoolQuestionList	$staging_pool_question_list
	)

protected

Definition at line 33 of file class.ilTestRandomQuestionSetBuilder.php.

      {
        $this->staging_pool_question_list->setTestObjId($this->test_obj->getId());
        $this->staging_pool_question_list->setTestId($this->test_obj->getTestId());
    }

Member Function Documentation

◆ buildSetQuestionCollection()

ilTestRandomQuestionSetBuilder::buildSetQuestionCollection	(	ilTestRandomQuestionSetSourcePoolDefinition	$definition,
			$question_ids
	)

private

Definition at line 117 of file class.ilTestRandomQuestionSetBuilder.php.

                                                                                                                       : ilTestRandomQuestionSetQuestionCollection
    {
        $set_question_collection = new ilTestRandomQuestionSetQuestionCollection();
 
        foreach ($question_ids as $question_id) {
            $set_question = new ilTestRandomQuestionSetQuestion();
 
            $set_question->setQuestionId($question_id);
            $set_question->setSourcePoolDefinitionId($definition->getId());
 
            $set_question_collection->addQuestion($set_question);
        }
 
        return $set_question_collection;
    }

References ilTestRandomQuestionSetSourcePoolDefinition\getId().

Referenced by getSrcPoolDefRelatedQuestCollection().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ checkBuildable()

ilTestRandomQuestionSetBuilder::checkBuildable ( )

abstract

Reimplemented in ilTestRandomQuestionSetBuilderWithAmountPerPool, and ilTestRandomQuestionSetBuilderWithAmountPerTest.

◆ fetchQuestionsFromStageRandomly()

ilTestRandomQuestionSetBuilder::fetchQuestionsFromStageRandomly	(	ilTestRandomQuestionSetQuestionCollection	$question_stage,
			$required_question_amount
	)

protected

Definition at line 180 of file class.ilTestRandomQuestionSetBuilder.php.

                                                                                                                                            : ilTestRandomQuestionSetQuestionCollection
    {
        $question_set = $question_stage->getRandomQuestionCollection($required_question_amount);
 
        return $question_set;
    }

References ilTestRandomQuestionSetQuestionCollection\getRandomQuestionCollection().

Referenced by ilTestRandomQuestionSetBuilderWithAmountPerTest\performBuild().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getCheckMessages()

ilTestRandomQuestionSetBuilder::getCheckMessages ( )

Returns: array

Definition at line 232 of file class.ilTestRandomQuestionSetBuilder.php.

                                      : array
    {
        return $this->check_messages;
    }

References $check_messages.

◆ getInstance()

static ilTestRandomQuestionSetBuilder::getInstance	(	ilDBInterface	$db,
		ilLanguage	$lng,
		TestLogger	$logger,
		ilObjTest	$test_obj,
		ilTestRandomQuestionSetConfig	$question_set_config,
		ilTestRandomQuestionSetSourcePoolDefinitionList	$source_pool_definition_list,
		ilTestRandomQuestionSetStagingPoolQuestionList	$staging_pool_question_list
	)

staticfinal

Definition at line 196 of file class.ilTestRandomQuestionSetBuilder.php.

      {
        if ($question_set_config->isQuestionAmountConfigurationModePerPool()) {
            return new ilTestRandomQuestionSetBuilderWithAmountPerPool(
                $db,
                $lng,
                $logger,
                $test_obj,
                $question_set_config,
                $source_pool_definition_list,
                $staging_pool_question_list
            );
        }
 
        return new ilTestRandomQuestionSetBuilderWithAmountPerTest(
            $db,
            $lng,
            $logger,
            $test_obj,
            $question_set_config,
            $source_pool_definition_list,
            $staging_pool_question_list
        );
    }

References $lng, ILIAS\TestQuestionPool\ExportImport\Foundation\Export\$logger, and ilTestRandomQuestionSetConfig\isQuestionAmountConfigurationModePerPool().

Referenced by ilTestPlayerAbstractGUI\generateRandomTestPassForActiveUser(), and ilTestRandomQuestionSetConfig\isQuestionSetBuildable().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getQuestionIdsForSourcePoolDefinitionIds()

ilTestRandomQuestionSetBuilder::getQuestionIdsForSourcePoolDefinitionIds ( ilTestRandomQuestionSetSourcePoolDefinition $definition )

private

Definition at line 86 of file class.ilTestRandomQuestionSetBuilder.php.

                                                                                                                      : array
    {
        $this->staging_pool_question_list->resetQuestionList();
 
        $this->staging_pool_question_list->setPoolId($definition->getPoolId());
 
        if ($this->hasTaxonomyFilter($definition)) {
            foreach ($definition->getMappedTaxonomyFilter() as $tax_id => $node_ids) {
                $tax_id = (int) $tax_id;
                if ($tax_id < 1) {
                    continue;
                }
                $this->staging_pool_question_list->addTaxonomyFilter($tax_id, $node_ids);
            }
        }
 
        if (count($definition->getLifecycleFilter())) {
            $this->staging_pool_question_list->setLifecycleFilter($definition->getLifecycleFilter());
        }
 
        // fau: taxFilter/typeFilter - use type filter
        if ($this->hasTypeFilter($definition)) {
            $this->staging_pool_question_list->setTypeFilter($definition->getTypeFilter());
        }
        // fau.
 
        $this->staging_pool_question_list->loadQuestions();
 
        return $this->staging_pool_question_list->getQuestions();
    }

References ilTestRandomQuestionSetSourcePoolDefinition\getLifecycleFilter(), ilTestRandomQuestionSetSourcePoolDefinition\getMappedTaxonomyFilter(), ilTestRandomQuestionSetSourcePoolDefinition\getPoolId(), ilTestRandomQuestionSetSourcePoolDefinition\getTypeFilter(), hasTaxonomyFilter(), hasTypeFilter(), and ILIAS\Repository\int().

Referenced by getSrcPoolDefRelatedQuestCollection().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSrcPoolDefListRelatedQuestCombinationCollection()

ilTestRandomQuestionSetBuilder::getSrcPoolDefListRelatedQuestCombinationCollection ( ilTestRandomQuestionSetSourcePoolDefinitionList $source_pool_definition_list )

Parameters

ilTestRandomQuestionSetSourcePoolDefinitionList $source_pool_definition_list

Returns: ilTestRandomQuestionSetQuestionCollection

Implements ilTestRandomSourcePoolDefinitionQuestionCollectionProvider.

Definition at line 50 of file class.ilTestRandomQuestionSetBuilder.php.

                                                                                                                                                    : ilTestRandomQuestionSetQuestionCollection
    {
        $question_stage = new ilTestRandomQuestionSetQuestionCollection();
 
        foreach ($source_pool_definition_list as $definition) {
            $questions = $this->getSrcPoolDefRelatedQuestCollection($definition);
            $question_stage->mergeQuestionCollection($questions);
        }
 
        return $question_stage;
    }

References getSrcPoolDefRelatedQuestCollection().

Referenced by getSrcPoolDefListRelatedQuestUniqueCollection().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSrcPoolDefListRelatedQuestUniqueCollection()

ilTestRandomQuestionSetBuilder::getSrcPoolDefListRelatedQuestUniqueCollection ( ilTestRandomQuestionSetSourcePoolDefinitionList $source_pool_definition_list )

Parameters

ilTestRandomQuestionSetSourcePoolDefinitionList $source_pool_definition_list

Returns: ilTestRandomQuestionSetQuestionCollection

Implements ilTestRandomSourcePoolDefinitionQuestionCollectionProvider.

Definition at line 79 of file class.ilTestRandomQuestionSetBuilder.php.

                                                                                                                                               : ilTestRandomQuestionSetQuestionCollection
    {
        $combination_collection = $this->getSrcPoolDefListRelatedQuestCombinationCollection($source_pool_definition_list);
        return $combination_collection->getUniqueQuestionCollection();
    }

References getSrcPoolDefListRelatedQuestCombinationCollection().

Referenced by ilTestRandomQuestionSetBuilderWithAmountPerTest\checkBuildable(), and ilTestRandomQuestionSetBuilderWithAmountPerTest\performBuild().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSrcPoolDefRelatedQuestCollection()

ilTestRandomQuestionSetBuilder::getSrcPoolDefRelatedQuestCollection ( ilTestRandomQuestionSetSourcePoolDefinition $definition )

Parameters

ilTestRandomQuestionSetSourcePoolDefinition $definition

Returns: ilTestRandomQuestionSetQuestionCollection

Implements ilTestRandomSourcePoolDefinitionQuestionCollectionProvider.

Definition at line 66 of file class.ilTestRandomQuestionSetBuilder.php.

                                                                                                                : ilTestRandomQuestionSetQuestionCollection
    {
        $question_ids = $this->getQuestionIdsForSourcePoolDefinitionIds($definition);
        $question_stage = $this->buildSetQuestionCollection($definition, $question_ids);
 
        return $question_stage;
    }

References buildSetQuestionCollection(), and getQuestionIdsForSourcePoolDefinitionIds().

Referenced by getSrcPoolDefListRelatedQuestCombinationCollection().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ handleQuestionOrdering()

ilTestRandomQuestionSetBuilder::handleQuestionOrdering ( ilTestRandomQuestionSetQuestionCollection $question_set )

protected

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

    {
        if ($this->test_obj->getShuffleQuestions()) {
            $question_set->shuffleQuestions();
        }
    }

References ilTestRandomQuestionSetQuestionCollection\shuffleQuestions().

Referenced by ilTestRandomQuestionSetBuilderWithAmountPerTest\performBuild().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ hasTaxonomyFilter()

ilTestRandomQuestionSetBuilder::hasTaxonomyFilter ( ilTestRandomQuestionSetSourcePoolDefinition $definition )

private

Definition at line 133 of file class.ilTestRandomQuestionSetBuilder.php.

                                                                                               : bool
    {
        if (!count($definition->getMappedTaxonomyFilter())) {
            return false;
        }
        return true;
    }

References ilTestRandomQuestionSetSourcePoolDefinition\getMappedTaxonomyFilter().

Referenced by getQuestionIdsForSourcePoolDefinitionIds().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ hasTypeFilter()

ilTestRandomQuestionSetBuilder::hasTypeFilter ( ilTestRandomQuestionSetSourcePoolDefinition $definition )

private

Definition at line 142 of file class.ilTestRandomQuestionSetBuilder.php.

                                                                                           : bool
    {
        if (count($definition->getTypeFilter())) {
            return true;
        }
 
        return false;
    }

References ilTestRandomQuestionSetSourcePoolDefinition\getTypeFilter().

Referenced by getQuestionIdsForSourcePoolDefinitionIds().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ performBuild()

ilTestRandomQuestionSetBuilder::performBuild ( ilTestSession $test_session )

abstract

Reimplemented in ilTestRandomQuestionSetBuilderWithAmountPerTest.

◆ storeQuestion()

ilTestRandomQuestionSetBuilder::storeQuestion	(	ilTestSession	$test_session,
		ilTestRandomQuestionSetQuestion	$set_question
	)

private

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

    {
        $next_id = $this->db->nextId('tst_test_rnd_qst');
 
        $this->db->insert('tst_test_rnd_qst', [
            'test_random_question_id' => ['integer', $next_id],
            'active_fi' => ['integer', $test_session->getActiveId()],
            'question_fi' => ['integer', $set_question->getQuestionId()],
            'sequence' => ['integer', $set_question->getSequencePosition()],
            'pass' => ['integer', $test_session->getPass()],
            'tstamp' => ['integer', time()],
            'src_pool_def_fi' => ['integer', $set_question->getSourcePoolDefinitionId()]
        ]);
    }

References ilTestSession\getActiveId(), ilTestSession\getPass(), ilTestRandomQuestionSetQuestion\getQuestionId(), ilTestRandomQuestionSetQuestion\getSequencePosition(), and ilTestRandomQuestionSetQuestion\getSourcePoolDefinitionId().

Referenced by storeQuestionSet().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ storeQuestionSet()

ilTestRandomQuestionSetBuilder::storeQuestionSet	(	ilTestSession	$test_session,
			$question_set
	)

protected

Definition at line 152 of file class.ilTestRandomQuestionSetBuilder.php.

    {
        $position = 0;
 
        foreach ($question_set->getQuestions() as $set_question) {
            /* @var ilTestRandomQuestionSetQuestion $set_question */
 
            $set_question->setSequencePosition($position++);
 
            $this->storeQuestion($test_session, $set_question);
        }
    }