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, ilObjTest $testOBJ, ilTestRandomQuestionSetConfig $questionSetConfig, ilTestRandomQuestionSetSourcePoolDefinitionList $sourcePoolDefinitionList, ilTestRandomQuestionSetStagingPoolQuestionList $stagingPoolQuestionList)

Protected Member Functions
	__construct (ilDBInterface $db, ilObjTest $testOBJ, ilTestRandomQuestionSetConfig $questionSetConfig, ilTestRandomQuestionSetSourcePoolDefinitionList $sourcePoolDefinitionList, ilTestRandomQuestionSetStagingPoolQuestionList $stagingPoolQuestionList)
	storeQuestionSet (ilTestSession $testSession, $questionSet)
	fetchQuestionsFromStageRandomly (ilTestRandomQuestionSetQuestionCollection $questionStage, $requiredQuestionAmount)
	handleQuestionOrdering (ilTestRandomQuestionSetQuestionCollection $questionSet)

Protected Attributes
	$db = null
	$testOBJ = null
	$questionSetConfig = null
	$sourcePoolDefinitionList = null
	$stagingPoolQuestionList = null
	$checkMessages = array()

Private Member Functions
	getQuestionIdsForSourcePoolDefinitionIds (ilTestRandomQuestionSetSourcePoolDefinition $definition)
	buildSetQuestionCollection (ilTestRandomQuestionSetSourcePoolDefinition $definition, $questionIds)
	hasTaxonomyFilter (ilTestRandomQuestionSetSourcePoolDefinition $definition)
	hasTypeFilter (ilTestRandomQuestionSetSourcePoolDefinition $definition)
	storeQuestion (ilTestSession $testSession, ilTestRandomQuestionSetQuestion $setQuestion)

Detailed Description

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

Constructor & Destructor Documentation

__construct()

ilTestRandomQuestionSetBuilder::__construct ( ilDBInterface  $db, ilObjTest  $testOBJ, ilTestRandomQuestionSetConfig  $questionSetConfig, ilTestRandomQuestionSetSourcePoolDefinitionList  $sourcePoolDefinitionList, ilTestRandomQuestionSetStagingPoolQuestionList  $stagingPoolQuestionList  )

protected

Parameters

ilDBInterface	$db
ilObjTest	$testOBJ
ilTestRandomQuestionSetConfig	$questionSetConfig
ilTestRandomQuestionSetSourcePoolDefinitionList	$sourcePoolDefinitionList
ilTestRandomQuestionSetStagingPoolQuestionList	$stagingPoolQuestionList

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

References $db, $questionSetConfig, $sourcePoolDefinitionList, $stagingPoolQuestionList, $testOBJ, checkBuildable(), and performBuild().

      {
        $this->db = $db;
        $this->testOBJ = $testOBJ;
        $this->questionSetConfig = $questionSetConfig;
        $this->sourcePoolDefinitionList = $sourcePoolDefinitionList;
        $this->stagingPoolQuestionList = $stagingPoolQuestionList;
        $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,   $questionIds  )

private

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

References ilTestRandomQuestionSetSourcePoolDefinition\getId().

Referenced by getSrcPoolDefRelatedQuestCollection().

                                                                                                                      : ilTestRandomQuestionSetQuestionCollection
    {
        $setQuestionCollection = new ilTestRandomQuestionSetQuestionCollection();

        foreach ($questionIds as $questionId) {
            $setQuestion = new ilTestRandomQuestionSetQuestion();

            $setQuestion->setQuestionId($questionId);
            $setQuestion->setSourcePoolDefinitionId($definition->getId());

            $setQuestionCollection->addQuestion($setQuestion);
        }

        return $setQuestionCollection;
    }

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,   $requiredQuestionAmount  )

protected

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

References ilTestRandomQuestionSetQuestionCollection\getRandomQuestionCollection().

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

                                                                                                                                         : ilTestRandomQuestionSetQuestionCollection
    {
        $questionSet = $questionStage->getRandomQuestionCollection($requiredQuestionAmount);

        return $questionSet;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getCheckMessages()

ilTestRandomQuestionSetBuilder::getCheckMessages

(

)

Returns

array

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

References $checkMessages.

                                      : array
    {
        return $this->checkMessages;
    }

getInstance()

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

staticfinal

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

References ilTestRandomQuestionSetConfig\isQuestionAmountConfigurationModePerPool().

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

      {
        if ($questionSetConfig->isQuestionAmountConfigurationModePerPool()) {
            require_once 'Modules/Test/classes/class.ilTestRandomQuestionSetBuilderWithAmountPerPool.php';

            return new ilTestRandomQuestionSetBuilderWithAmountPerPool(
                $db,
                $testOBJ,
                $questionSetConfig,
                $sourcePoolDefinitionList,
                $stagingPoolQuestionList
            );
        }

        require_once 'Modules/Test/classes/class.ilTestRandomQuestionSetBuilderWithAmountPerTest.php';

        return new ilTestRandomQuestionSetBuilderWithAmountPerTest(
            $db,
            $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 119 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 $taxId => $nodeIds) {
                $this->stagingPoolQuestionList->addTaxonomyFilter($taxId, $nodeIds);
            }
        }

        if (count($definition->getLifecycleFilter())) {
            $this->stagingPoolQuestionList->setLifecycleFilter($definition->getLifecycleFilter());
        }

        // fau: taxFilter/typeFilter - use type filter
        if ($this->hasTypeFilter($definition)) {
            $this->stagingPoolQuestionList->setTypeFilter($definition->getTypeFilter());
        }
        // fau.

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

References getSrcPoolDefRelatedQuestCollection().

Referenced by getSrcPoolDefListRelatedQuestUniqueCollection().

                                                                                                                                                 : ilTestRandomQuestionSetQuestionCollection
    {
        $questionStage = new ilTestRandomQuestionSetQuestionCollection();

        foreach ($sourcePoolDefinitionList as $definition) {
            $questions = $this->getSrcPoolDefRelatedQuestCollection($definition);
            $questionStage->mergeQuestionCollection($questions);
        }

        return $questionStage;
    }

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

References getSrcPoolDefListRelatedQuestCombinationCollection().

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

                                                                                                                                            : ilTestRandomQuestionSetQuestionCollection
    {
        $combinationCollection = $this->getSrcPoolDefListRelatedQuestCombinationCollection($sourcePoolDefinitionList);
        return $combinationCollection->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 99 of file class.ilTestRandomQuestionSetBuilder.php.

References buildSetQuestionCollection(), and getQuestionIdsForSourcePoolDefinitionIds().

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

                                                                                                                : ilTestRandomQuestionSetQuestionCollection
    {
        $questionIds = $this->getQuestionIdsForSourcePoolDefinitionIds($definition);
        $questionStage = $this->buildSetQuestionCollection($definition, $questionIds);

        return $questionStage;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

handleQuestionOrdering()

ilTestRandomQuestionSetBuilder::handleQuestionOrdering ( ilTestRandomQuestionSetQuestionCollection  $questionSet )

protected

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

References ilTestRandomQuestionSetQuestionCollection\shuffleQuestions().

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

    {
        if ($this->testOBJ->getShuffleQuestions()) {
            $questionSet->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 162 of file class.ilTestRandomQuestionSetBuilder.php.

References ilTestRandomQuestionSetSourcePoolDefinition\getMappedTaxonomyFilter().

Referenced by getQuestionIdsForSourcePoolDefinitionIds().

                                                                                               : bool
    {
        if (!count($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 171 of file class.ilTestRandomQuestionSetBuilder.php.

References ilTestRandomQuestionSetSourcePoolDefinition\getTypeFilter().

Referenced by getQuestionIdsForSourcePoolDefinitionIds().

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

        return false;
    }

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(), and ilTestRandomQuestionSetBuilderWithAmountPerPool\checkBuildable().

Here is the caller graph for this function:

storeQuestion()

ilTestRandomQuestionSetBuilder::storeQuestion ( ilTestSession  $testSession, ilTestRandomQuestionSetQuestion  $setQuestion  )

private

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

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

Referenced by storeQuestionSet().

    {
        $nextId = $this->db->nextId('tst_test_rnd_qst');

        $this->db->insert('tst_test_rnd_qst', array(
            'test_random_question_id' => array('integer', $nextId),
            'active_fi' => array('integer', $testSession->getActiveId()),
            'question_fi' => array('integer', $setQuestion->getQuestionId()),
            'sequence' => array('integer', $setQuestion->getSequencePosition()),
            'pass' => array('integer', $testSession->getPass()),
            'tstamp' => array('integer', time()),
            'src_pool_def_fi' => array('integer', $setQuestion->getSourcePoolDefinitionId())
        ));
    }

Here is the call graph for this function:

Here is the caller graph for this function:

storeQuestionSet()

ilTestRandomQuestionSetBuilder::storeQuestionSet ( ilTestSession  $testSession,   $questionSet  )

protected

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

References storeQuestion().

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

    {
        $position = 0;

        foreach ($questionSet->getQuestions() as $setQuestion) {
            /* @var ilTestRandomQuestionSetQuestion $setQuestion */

            $setQuestion->setSequencePosition($position++);

            $this->storeQuestion($testSession, $setQuestion);
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

$checkMessages

ilTestRandomQuestionSetBuilder::$checkMessages = array()

protected

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

Referenced by getCheckMessages().

$db

ilTestRandomQuestionSetBuilder::$db = null

protected

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

Referenced by __construct().

$questionSetConfig

ilTestRandomQuestionSetBuilder::$questionSetConfig = null

protected

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

Referenced by __construct().

$sourcePoolDefinitionList

ilTestRandomQuestionSetBuilder::$sourcePoolDefinitionList = null

protected

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

Referenced by __construct().

$stagingPoolQuestionList

ilTestRandomQuestionSetBuilder::$stagingPoolQuestionList = null

protected

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

Referenced by __construct().

$testOBJ

ilTestRandomQuestionSetBuilder::$testOBJ = null

protected

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

Referenced by __construct().

---

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

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