class.ilTestDynamicQuestionSet.php

Go to the documentation of this file.

<?php
/* Copyright (c) 1998-2013 ILIAS open source, Extended GPL, see docs/LICENSE */

require_once 'Modules/TestQuestionPool/classes/class.ilAssQuestionList.php';

class ilTestDynamicQuestionSet
{
    private $db = null;
    
    private $lng = null;
    
    private $pluginAdmin = null;
    
    private $testOBJ = null;
    
    private $completeQuestionList = null;
    
    private $selectionQuestionList = null;
    
    private $filteredQuestionList = null;
    
    private $actualQuestionSequence = array();
    
    public function __construct(ilDBInterface $db, ilLanguage $lng, ilPluginAdmin $pluginAdmin, ilObjTest $testOBJ)
    {
        $this->db = $db;
        $this->lng = $lng;
        $this->pluginAdmin = $pluginAdmin;
        $this->testOBJ = $testOBJ;
    }
    
    
    public function load(ilObjTestDynamicQuestionSetConfig $dynamicQuestionSetConfig, ilTestDynamicQuestionSetFilterSelection $filterSelection)
    {
        $this->completeQuestionList = $this->initCompleteQuestionList(
            $dynamicQuestionSetConfig,
            $filterSelection->getAnswerStatusActiveId()
        );
        
        $this->selectionQuestionList = $this->initSelectionQuestionList(
            $dynamicQuestionSetConfig,
            $filterSelection
        );
        
        $this->filteredQuestionList = $this->initFilteredQuestionList(
            $dynamicQuestionSetConfig,
            $filterSelection
        );
        
        $this->actualQuestionSequence = $this->initActualQuestionSequence(
            $dynamicQuestionSetConfig,
            $this->filteredQuestionList
        );
    }
    

    private function initCompleteQuestionList(ilObjTestDynamicQuestionSetConfig $dynamicQuestionSetConfig, $answerStatusActiveId)
    {
        $questionList = $this->buildQuestionList(
            $dynamicQuestionSetConfig->getSourceQuestionPoolId(),
            $answerStatusActiveId
        );
        
        $questionList->load();
        
        return $questionList;
    }
    
    private function initFilteredQuestionList(ilObjTestDynamicQuestionSetConfig $dynamicQuestionSetConfig, ilTestDynamicQuestionSetFilterSelection $filterSelection)
    {
        $questionList = $this->buildQuestionList(
            $dynamicQuestionSetConfig->getSourceQuestionPoolId(),
            $filterSelection->getAnswerStatusActiveId()
        );

        if ($dynamicQuestionSetConfig->isAnswerStatusFilterEnabled()) {
            $questionList->setAnswerStatusFilter($filterSelection->getAnswerStatusSelection());
        }

        if ($dynamicQuestionSetConfig->isTaxonomyFilterEnabled()) {
            require_once 'Services/Taxonomy/classes/class.ilObjTaxonomy.php';
            
            $questionList->setAvailableTaxonomyIds(ilObjTaxonomy::getUsageOfObject(
                $dynamicQuestionSetConfig->getSourceQuestionPoolId()
            ));
            
            foreach ($filterSelection->getTaxonomySelection() as $taxId => $taxNodes) {
                $questionList->addTaxonomyFilter(
                    $taxId,
                    $taxNodes,
                    $this->testOBJ->getId(),
                    $this->testOBJ->getType()
                );
            }
        } elseif ($dynamicQuestionSetConfig->getOrderingTaxonomyId()) {
            $questionList->setAvailableTaxonomyIds(array(
                $dynamicQuestionSetConfig->getOrderingTaxonomyId()
            ));
        }
        
        $questionList->setForcedQuestionIds($filterSelection->getForcedQuestionIds());
        
        $questionList->load();
        
        return $questionList;
    }
    
    public function initSelectionQuestionList(ilObjTestDynamicQuestionSetConfig $dynamicQuestionSetConfig, ilTestDynamicQuestionSetFilterSelection $filterSelection)
    {
        $questionList = $this->buildQuestionList(
            $dynamicQuestionSetConfig->getSourceQuestionPoolId(),
            $filterSelection->getAnswerStatusActiveId()
        );
        
        if ($dynamicQuestionSetConfig->isTaxonomyFilterEnabled()) {
            require_once 'Services/Taxonomy/classes/class.ilObjTaxonomy.php';
            
            $questionList->setAvailableTaxonomyIds(ilObjTaxonomy::getUsageOfObject(
                $dynamicQuestionSetConfig->getSourceQuestionPoolId()
            ));
            
            foreach ($filterSelection->getTaxonomySelection() as $taxId => $taxNodes) {
                $questionList->addTaxonomyFilter(
                    $taxId,
                    $taxNodes,
                    $this->testOBJ->getId(),
                    $this->testOBJ->getType()
                );
            }
        }
        
        $questionList->load();
        
        return $questionList;
    }
    
    private function initActualQuestionSequence(ilObjTestDynamicQuestionSetConfig $dynamicQuestionSetConfig, ilAssQuestionList $questionList)
    {
        if ($dynamicQuestionSetConfig->getOrderingTaxonomyId()) {
            return $this->getQuestionSequenceStructuredByTaxonomy(
                $questionList,
                $dynamicQuestionSetConfig->getOrderingTaxonomyId()
            );
        }
        
        return $this->getQuestionSequenceStructuredByUpdateDate($questionList);
    }

    
    private function getQuestionSequenceStructuredByTaxonomy(ilAssQuestionList $questionList, $orderingTaxId)
    {
        require_once 'Services/Taxonomy/classes/class.ilObjTaxonomy.php';
        $tax = new ilObjTaxonomy($orderingTaxId);
        
        require_once 'Modules/Test/classes/class.ilTestTaxonomyTree.php';
        $tree = new ilTestTaxonomyTree($orderingTaxId);
        $tree->initOrderedTreeIndex($tax);
        
        $questionsByNode = array();
        $nodelessQuestions = array();
        
        foreach ($questionList->getQuestionDataArray() as $qId => $qData) {
            if (isset($qData['taxonomies'][$orderingTaxId]) && count($qData['taxonomies'][$orderingTaxId])) {
                foreach ($qData['taxonomies'][$orderingTaxId] as $nodeId => $itemData) {
                    $nodeOrderingPath = $tree->getNodeOrderingPathString($itemData['node_id']);
                    
                    if (!isset($questionsByNode[ $nodeOrderingPath ])) {
                        $questionsByNode[ $nodeOrderingPath ] = array();
                    }
                    
                    if ($tax->getItemSorting() == ilObjTaxonomy::SORT_MANUAL) {
                        $questionsByNode[ $nodeOrderingPath ][$itemData['order_nr']] = $qId;
                    } else {
                        $questionsByNode[ $nodeOrderingPath ][$qData['title'] . '::' . $qId] = $qId;
                    }
                }
            } else {
                $nodelessQuestions[$qData['tstamp'] . '::' . $qId] = $qId;
            }
        }
        
        foreach ($questionsByNode as $path => $questions) {
            if ($tax->getItemSorting() == ilObjTaxonomy::SORT_MANUAL) {
                ksort($questions, SORT_NUMERIC);
            } else {
                ksort($questions, SORT_STRING);
            }
            
            $questionsByNode[$path] = array_values($questions);
        }

        ksort($questionsByNode, SORT_STRING);
        $sequence = array_values($questionsByNode);
        
        ksort($nodelessQuestions);
        $sequence[] = array_values($nodelessQuestions);
        
        return $sequence;
    }
    
    private function getQuestionSequenceStructuredByUpdateDate(ilAssQuestionList $questionList)
    {
        $sequence = array();
        
        foreach ($questionList->getQuestionDataArray() as $qId => $qData) {
            $sequence[ $qData['tstamp'] . '::' . $qId ] = $qId;
        }
        
        ksort($sequence);
        $sequence = array_values($sequence);
        
        return array($sequence);
    }
    
    
    public function getActualQuestionSequence()
    {
        return $this->actualQuestionSequence;
    }
    
    public function questionExists($questionId)
    {
        $questionData = $this->completeQuestionList->getQuestionDataArray();
        return isset($questionData[$questionId]);
    }
    
    public function getQuestionData($questionId)
    {
        $questionData = $this->completeQuestionList->getQuestionDataArray();
        return $questionData[$questionId];
    }
    
    public function getAllQuestionsData()
    {
        return $this->completeQuestionList->getQuestionDataArray();
    }
    

    public function getCompleteQuestionList()
    {
        return $this->completeQuestionList;
    }
    
    public function getSelectionQuestionList()
    {
        return $this->selectionQuestionList;
    }
    
    public function getFilteredQuestionList()
    {
        return $this->filteredQuestionList;
    }
    
    private function buildQuestionList($sourceQuestionPoolId, $answerStatusActiveId)
    {
        $questionList = new ilAssQuestionList($this->db, $this->lng, $this->pluginAdmin);
        $questionList->setParentObjId($sourceQuestionPoolId);
        $questionList->setAnswerStatusActiveId($answerStatusActiveId);
        return $questionList;
    }
}