Inheritance diagram for ilTestRandomQuestionSetBuilder:

Collaboration diagram for ilTestRandomQuestionSetBuilder:

Public Member Functions
	checkBuildable ()

	performBuild (ilTestSession $testSession)

Static Public Member Functions
static	getInstance (ilDB $db, ilObjTest $testOBJ, ilTestRandomQuestionSetConfig $questionSetConfig, ilTestRandomQuestionSetSourcePoolDefinitionList $sourcePoolDefinitionList, ilTestRandomQuestionSetStagingPoolQuestionList $stagingPoolQuestionList)

Protected Member Functions
	__construct (ilDB $db, ilObjTest $testOBJ, ilTestRandomQuestionSetConfig $questionSetConfig, ilTestRandomQuestionSetSourcePoolDefinitionList $sourcePoolDefinitionList, ilTestRandomQuestionSetStagingPoolQuestionList $stagingPoolQuestionList)

	getQuestionStageForSourcePoolDefinition (ilTestRandomQuestionSetSourcePoolDefinition $definition)

	storeQuestionSet (ilTestSession $testSession, $questionSet)

	fetchQuestionsFromStageRandomly (ilTestRandomQuestionSetQuestionCollection $questionStage, $requiredQuestionAmount)

	handleQuestionOrdering (ilTestRandomQuestionSetQuestionCollection $questionSet)

Protected Attributes
	$db = null

	$testOBJ = null

	$questionSetConfig = null

	$sourcePoolDefinitionList = null

	$stagingPoolQuestionList = null

Private Member Functions
	getQuestionIdsForSourcePoolDefinitionIds (ilTestRandomQuestionSetSourcePoolDefinition $definition)

	buildSetQuestionCollection (ilTestRandomQuestionSetSourcePoolDefinition $definition, $questionIds)

	hasTaxonomyFilter (ilTestRandomQuestionSetSourcePoolDefinition $definition)

	storeQuestion (ilTestSession $testSession, ilTestRandomQuestionSetQuestion $setQuestion)

Detailed Description

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

Constructor & Destructor Documentation

◆ __construct()

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

protected

Parameters

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

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

        {
                $this->db = $db;
                $this->testOBJ = $testOBJ;
                $this->questionSetConfig = $questionSetConfig;
                $this->sourcePoolDefinitionList = $sourcePoolDefinitionList;
                $this->stagingPoolQuestionList = $stagingPoolQuestionList;
        }

References $db, $questionSetConfig, $sourcePoolDefinitionList, $stagingPoolQuestionList, and $testOBJ.

Member Function Documentation

◆ buildSetQuestionCollection()

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

private

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

        {
                $setQuestionCollection = new ilTestRandomQuestionSetQuestionCollection();
 
                foreach($questionIds as $questionId)
                {
                        $setQuestion = new ilTestRandomQuestionSetQuestion();
 
                        $setQuestion->setQuestionId($questionId);
                        $setQuestion->setSourcePoolDefinitionId($definition->getId());
 
                        $setQuestionCollection->addQuestion($setQuestion);
                }
 
                return $setQuestionCollection;
        }

References ilTestRandomQuestionSetSourcePoolDefinition\getId().

Referenced by getQuestionStageForSourcePoolDefinition().

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

protected

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

        {
                $questionSet = $questionStage->getRandomQuestionCollection($requiredQuestionAmount);
 
                return $questionSet;
        }

References ilTestRandomQuestionSetQuestionCollection\getRandomQuestionCollection().

Referenced by ilTestRandomQuestionSetBuilderWithAmountPerTest\performBuild().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getInstance()

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

staticfinal

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

        {
                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
                );
        }

References $db, $questionSetConfig, $sourcePoolDefinitionList, $stagingPoolQuestionList, and $testOBJ.

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

Here is the caller graph for this function:

◆ getQuestionIdsForSourcePoolDefinitionIds()

ilTestRandomQuestionSetBuilder::getQuestionIdsForSourcePoolDefinitionIds ( ilTestRandomQuestionSetSourcePoolDefinition $definition )

private

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

        {
                $this->stagingPoolQuestionList->resetQuestionList();
 
                $this->stagingPoolQuestionList->setTestObjId( $this->testOBJ->getId() );
                $this->stagingPoolQuestionList->setTestId( $this->testOBJ->getTestId() );
                $this->stagingPoolQuestionList->setPoolId( $definition->getPoolId() );
 
                if( $this->hasTaxonomyFilter($definition) )
                {
                        $this->stagingPoolQuestionList->addTaxonomyFilter(
                                $definition->getMappedFilterTaxId(), array($definition->getMappedFilterTaxNodeId())
                        );
                }
 
                $this->stagingPoolQuestionList->loadQuestions();
 
                return $this->stagingPoolQuestionList->getQuestions();
        }

References ilTestRandomQuestionSetSourcePoolDefinition\getMappedFilterTaxId(), ilTestRandomQuestionSetSourcePoolDefinition\getMappedFilterTaxNodeId(), ilTestRandomQuestionSetSourcePoolDefinition\getPoolId(), and hasTaxonomyFilter().

Referenced by getQuestionStageForSourcePoolDefinition().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getQuestionStageForSourcePoolDefinition()

ilTestRandomQuestionSetBuilder::getQuestionStageForSourcePoolDefinition ( ilTestRandomQuestionSetSourcePoolDefinition $definition )

protected

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

        {
                $questionIds = $this->getQuestionIdsForSourcePoolDefinitionIds($definition);
                $questionStage = $this->buildSetQuestionCollection($definition, $questionIds);
 
                return $questionStage;
        }

References buildSetQuestionCollection(), and getQuestionIdsForSourcePoolDefinitionIds().

Here is the call graph for this function:

◆ handleQuestionOrdering()

ilTestRandomQuestionSetBuilder::handleQuestionOrdering ( ilTestRandomQuestionSetQuestionCollection $questionSet )

protected

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

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

        {
                if( !(int)$definition->getMappedFilterTaxId() )
                {
                        return false;
                }
 
                if( !(int)$definition->getMappedFilterTaxNodeId() )
                {
                        return false;
                }
 
                return true;
        }

References ilTestRandomQuestionSetSourcePoolDefinition\getMappedFilterTaxId(), and ilTestRandomQuestionSetSourcePoolDefinition\getMappedFilterTaxNodeId().

Referenced by getQuestionIdsForSourcePoolDefinitionIds().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ performBuild()

ilTestRandomQuestionSetBuilder::performBuild ( ilTestSession $testSession )

abstract

Reimplemented in ilTestRandomQuestionSetBuilderWithAmountPerTest.

◆ storeQuestion()

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

private

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

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

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	$testSession,
			$questionSet
	)

protected

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

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