ilTestRandomQuestionSetBuilder Class Reference

Inheritance diagram for ilTestRandomQuestionSetBuilder:

Collaboration diagram for ilTestRandomQuestionSetBuilder:

Public Member Functions
	checkBuildable ()
	performBuild (ilTestSession $testSession)
	getSrcPoolDefListRelatedQuestCombinationCollection (ilTestRandomQuestionSetSourcePoolDefinitionList $sourcePoolDefinitionList)
	getSrcPoolDefRelatedQuestCollection (ilTestRandomQuestionSetSourcePoolDefinition $definition)
	getSrcPoolDefListRelatedQuestUniqueCollection (ilTestRandomQuestionSetSourcePoolDefinitionList $sourcePoolDefinitionList)
	getCheckMessages ()

Static Public Member Functions
static	getInstance (ilDBInterface $db, ilLanguage $lng, TestLogger $logger, ilObjTest $testOBJ, ilTestRandomQuestionSetConfig $questionSetConfig, ilTestRandomQuestionSetSourcePoolDefinitionList $sourcePoolDefinitionList, ilTestRandomQuestionSetStagingPoolQuestionList $stagingPoolQuestionList)

Protected Member Functions
	__construct (protected ilDBInterface $db, protected ilLanguage $lng, protected TestLogger $logger, protected ilObjTest $testOBJ, protected ilTestRandomQuestionSetConfig $questionSetConfig, protected ilTestRandomQuestionSetSourcePoolDefinitionList $sourcePoolDefinitionList, protected ilTestRandomQuestionSetStagingPoolQuestionList $stagingPoolQuestionList)
	storeQuestionSet (ilTestSession $test_session, ilTestRandomQuestionSetQuestionCollection $question_set)
	fetchQuestionsFromStageRandomly (ilTestRandomQuestionSetQuestionCollection $questionStage, int $requiredQuestionAmount)
	handleQuestionOrdering (ilTestRandomQuestionSetQuestionCollection $question_set)

Protected Attributes
	$checkMessages = []

Private Member Functions
	getQuestionIdsForSourcePoolDefinitionIds (ilTestRandomQuestionSetSourcePoolDefinition $definition)
	buildSetQuestionCollection (ilTestRandomQuestionSetSourcePoolDefinition $definition, array $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  $testOBJ, protected ilTestRandomQuestionSetConfig  $questionSetConfig, protected ilTestRandomQuestionSetSourcePoolDefinitionList  $sourcePoolDefinitionList, protected ilTestRandomQuestionSetStagingPoolQuestionList  $stagingPoolQuestionList  )

protected

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

References checkBuildable(), and performBuild().

      {
        $this->stagingPoolQuestionList->setTestObjId($this->testOBJ->getId());
        $this->stagingPoolQuestionList->setTestId($this->testOBJ->getTestId());
    }

Here is the call graph for this function:

Member Function Documentation

buildSetQuestionCollection()

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

private

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

References ilTestRandomQuestionSetSourcePoolDefinition\getId().

Referenced by getSrcPoolDefRelatedQuestCollection().

     : 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;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

checkBuildable()

ilTestRandomQuestionSetBuilder::checkBuildable ( )

abstract

Referenced by __construct().

Here is the caller graph for this function:

fetchQuestionsFromStageRandomly()

ilTestRandomQuestionSetBuilder::fetchQuestionsFromStageRandomly ( ilTestRandomQuestionSetQuestionCollection  $questionStage, int  $requiredQuestionAmount  )

protected

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

References ilTestRandomQuestionSetQuestionCollection\getRandomQuestionCollection().

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

     : ilTestRandomQuestionSetQuestionCollection {
        return $questionStage->getRandomQuestionCollection($requiredQuestionAmount);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getCheckMessages()

ilTestRandomQuestionSetBuilder::getCheckMessages

(

)

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

References $checkMessages.

                                      : array
    {
        return $this->checkMessages;
    }

getInstance()

static ilTestRandomQuestionSetBuilder::getInstance ( ilDBInterface  $db, ilLanguage  $lng, TestLogger  $logger, ilObjTest  $testOBJ, ilTestRandomQuestionSetConfig  $questionSetConfig, ilTestRandomQuestionSetSourcePoolDefinitionList  $sourcePoolDefinitionList, ilTestRandomQuestionSetStagingPoolQuestionList  $stagingPoolQuestionList  )

staticfinal

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

References ilTestRandomQuestionSetConfig\isQuestionAmountConfigurationModePerPool().

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

      {
        if ($questionSetConfig->isQuestionAmountConfigurationModePerPool()) {
            return new ilTestRandomQuestionSetBuilderWithAmountPerPool(
                $db,
                $lng,
                $logger,
                $testOBJ,
                $questionSetConfig,
                $sourcePoolDefinitionList,
                $stagingPoolQuestionList
            );
        }

        return new ilTestRandomQuestionSetBuilderWithAmountPerTest(
            $db,
            $lng,
            $logger,
            $testOBJ,
            $questionSetConfig,
            $sourcePoolDefinitionList,
            $stagingPoolQuestionList
        );
    }

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 78 of file class.ilTestRandomQuestionSetBuilder.php.

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

Referenced by getSrcPoolDefRelatedQuestCollection().

     : array {
        $this->stagingPoolQuestionList->resetQuestionList();
        $this->stagingPoolQuestionList->setPoolId($definition->getPoolId());

        if ($this->hasTaxonomyFilter($definition)) {
            foreach ($definition->getMappedTaxonomyFilter() as $tax_id => $node_ids) {
                $this->stagingPoolQuestionList->addTaxonomyFilter($tax_id, $node_ids);
            }
        }

        if ($definition->getLifecycleFilter() !== []) {
            $this->stagingPoolQuestionList->setLifecycleFilter($definition->getLifecycleFilter());
        }

        if ($this->hasTypeFilter($definition)) {
            $this->stagingPoolQuestionList->setTypeFilter($definition->getTypeFilter());
        }

        $this->stagingPoolQuestionList->loadQuestions();
        return $this->stagingPoolQuestionList->getQuestions();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getSrcPoolDefListRelatedQuestCombinationCollection()

ilTestRandomQuestionSetBuilder::getSrcPoolDefListRelatedQuestCombinationCollection

(

ilTestRandomQuestionSetSourcePoolDefinitionList

$sourcePoolDefinitionList

)

Parameters

ilTestRandomQuestionSetSourcePoolDefinitionList

$sourcePoolDefinitionList

Returns

ilTestRandomQuestionSetQuestionCollection

Implements ilTestRandomSourcePoolDefinitionQuestionCollectionProvider.

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

References getSrcPoolDefRelatedQuestCollection().

Referenced by getSrcPoolDefListRelatedQuestUniqueCollection().

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

        return $question_stage;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getSrcPoolDefListRelatedQuestUniqueCollection()

ilTestRandomQuestionSetBuilder::getSrcPoolDefListRelatedQuestUniqueCollection

(

ilTestRandomQuestionSetSourcePoolDefinitionList

$sourcePoolDefinitionList

)

Parameters

ilTestRandomQuestionSetSourcePoolDefinitionList

$sourcePoolDefinitionList

Returns

ilTestRandomQuestionSetQuestionCollection

Implements ilTestRandomSourcePoolDefinitionQuestionCollectionProvider.

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

References getSrcPoolDefListRelatedQuestCombinationCollection().

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

     : ilTestRandomQuestionSetQuestionCollection {
        return $this->getSrcPoolDefListRelatedQuestCombinationCollection($sourcePoolDefinitionList)
            ->getUniqueQuestionCollection();
    }

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 62 of file class.ilTestRandomQuestionSetBuilder.php.

References buildSetQuestionCollection(), and getQuestionIdsForSourcePoolDefinitionIds().

Referenced by getSrcPoolDefListRelatedQuestCombinationCollection(), and ilTestRandomQuestionSetBuilderWithAmountPerPool\performBuild().

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

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 172 of file class.ilTestRandomQuestionSetBuilder.php.

References ilTestRandomQuestionSetQuestionCollection\shuffleQuestions().

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

     : void {
        if ($this->testOBJ->getShuffleQuestions()) {
            $question_set->shuffleQuestions();
        }
    }

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 118 of file class.ilTestRandomQuestionSetBuilder.php.

References ilTestRandomQuestionSetSourcePoolDefinition\getMappedTaxonomyFilter().

Referenced by getQuestionIdsForSourcePoolDefinitionIds().

     : bool {
        if ($definition->getMappedTaxonomyFilter() === []) {
            return false;
        }
        return true;
    }

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 127 of file class.ilTestRandomQuestionSetBuilder.php.

References ilTestRandomQuestionSetSourcePoolDefinition\getTypeFilter().

Referenced by getQuestionIdsForSourcePoolDefinitionIds().

     : bool {
        if ($definition->getTypeFilter() === []) {
            return false;
        }

        return true;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

performBuild()

ilTestRandomQuestionSetBuilder::performBuild ( ilTestSession  $testSession )

abstract

Referenced by __construct().

Here is the caller graph for this function:

storeQuestion()

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

private

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

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

Referenced by storeQuestionSet().

     : void {
        $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()]
        ]);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

storeQuestionSet()

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

protected

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

References ilTestRandomQuestionSetQuestionCollection\getQuestions(), and storeQuestion().

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

     : void {
        $position = 0;
        foreach ($question_set->getQuestions() as $set_question) {
            $set_question->setSequencePosition($position++);
            $this->storeQuestion($test_session, $set_question);
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

$checkMessages

ilTestRandomQuestionSetBuilder::$checkMessages = []

protected

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

Referenced by getCheckMessages().

---

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

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