class.ilTestRandomQuestionSetConfigGUI.php

Go to the documentation of this file.

<?php
/* Copyright (c) 1998-2013 ILIAS open source, Extended GPL, see docs/LICENSE */
 
require_once 'Modules/Test/classes/class.ilTestRandomQuestionSetConfig.php';
require_once 'Modules/Test/classes/class.ilTestRandomQuestionSetSourcePoolDefinitionList.php';
require_once 'Modules/Test/classes/class.ilTestRandomQuestionSetSourcePoolDefinitionFactory.php';
require_once 'Modules/Test/classes/class.ilTestRandomQuestionSetStagingPoolBuilder.php';
require_once 'Modules/Test/classes/class.ilTestRandomQuestionSetConfigStateMessageHandler.php';
 
require_once 'Services/Taxonomy/classes/class.ilObjTaxonomy.php';
 
class ilTestRandomQuestionSetConfigGUI
{
        const CMD_SHOW_GENERAL_CONFIG_FORM              = 'showGeneralConfigForm';
        const CMD_SAVE_GENERAL_CONFIG_FORM              = 'saveGeneralConfigForm';
        const CMD_SHOW_SRC_POOL_DEF_LIST                = 'showSourcePoolDefinitionList';
        const CMD_SAVE_SRC_POOL_DEF_LIST                = 'saveSourcePoolDefinitionList';
        const CMD_DELETE_SINGLE_SRC_POOL_DEF            = 'deleteSingleSourcePoolDefinition';
        const CMD_DELETE_MULTI_SRC_POOL_DEFS            = 'deleteMultipleSourcePoolDefinitions';
        const CMD_SHOW_CREATE_SRC_POOL_DEF_FORM         = 'showCreateSourcePoolDefinitionForm';
        const CMD_SAVE_CREATE_SRC_POOL_DEF_FORM         = 'saveCreateSourcePoolDefinitionForm';
        const CMD_SAVE_AND_NEW_CREATE_SRC_POOL_DEF_FORM = 'saveCreateAndNewSourcePoolDefinitionForm';
        const CMD_SHOW_EDIT_SRC_POOL_DEF_FORM           = 'showEditSourcePoolDefinitionForm';
        const CMD_SAVE_EDIT_SRC_POOL_DEF_FORM           = 'saveEditSourcePoolDefinitionForm';
        const CMD_BUILD_QUESTION_STAGE                                  = 'buildQuestionStage';
        const CMD_SELECT_DERIVATION_TARGET                              = 'selectPoolDerivationTarget';
        const CMD_DERIVE_NEW_POOLS                                              = 'deriveNewPools';
        
        const HTTP_PARAM_AFTER_REBUILD_QUESTION_STAGE_CMD = 'afterRebuildQuestionStageCmd';
        public $ctrl = null;
        
        public $access = null;
        
        public $tabs = null;
        
        public $lng = null;
        
        public $tpl = null;
        
        public $db = null;
        
        public $tree = null;
 
        public $pluginAdmin = null;
        
        public $objDefinition = null;
 
        public $testOBJ = null;
        
        protected $questionSetConfig = null;
 
        protected $sourcePoolDefinitionFactory = null;
 
        protected $sourcePoolDefinitionList= null;
 
        protected $stagingPool = null;
 
        protected $configStateMessageHandler;
        
        public function __construct(
                ilCtrl $ctrl, ilAccessHandler $access, ilTabsGUI $tabs, ilLanguage $lng,
                ilTemplate $tpl, ilDBInterface $db, ilTree $tree, ilPluginAdmin $pluginAdmin, ilObjTest $testOBJ
        )
        {
                $this->ctrl = $ctrl;
                $this->access = $access;
                $this->tabs = $tabs;
                $this->lng = $lng;
                $this->tpl = $tpl;
                $this->db = $db;
                $this->tree = $tree;
                $this->pluginAdmin = $pluginAdmin;
                $this->objDefinition = $GLOBALS['DIC']['objDefinition'];
                $this->testOBJ = $testOBJ;
 
                $this->questionSetConfig = new ilTestRandomQuestionSetConfig(
                        $this->tree, $this->db, $this->pluginAdmin, $this->testOBJ
                );
 
                $this->sourcePoolDefinitionFactory = new ilTestRandomQuestionSetSourcePoolDefinitionFactory(
                        $this->db, $this->testOBJ
                );
 
                $this->sourcePoolDefinitionList = new ilTestRandomQuestionSetSourcePoolDefinitionList(
                        $this->db, $this->testOBJ, $this->sourcePoolDefinitionFactory
                );
 
                $this->stagingPool = new ilTestRandomQuestionSetStagingPoolBuilder(
                        $this->db, $this->testOBJ
                );
                
                $this->configStateMessageHandler = new ilTestRandomQuestionSetConfigStateMessageHandler(
                        $this->lng, $this->ctrl
                );
 
                $this->configStateMessageHandler->setTargetGUI($this);
                $this->configStateMessageHandler->setQuestionSetConfig($this->questionSetConfig);
                $this->configStateMessageHandler->setParticipantDataExists($this->testOBJ->participantDataExist());
        }
        
        public function executeCommand()
        {
                if (!$this->access->checkAccess("write", "", $this->testOBJ->getRefId()))
                {
                        ilUtil::sendFailure($this->lng->txt("cannot_edit_test"), true);
                        $this->ctrl->redirectByClass('ilObjTestGUI', "infoScreen");
                }
 
                if( $this->isAvoidManipulationRedirectRequired() )
                {
                        ilUtil::sendFailure($this->lng->txt("tst_msg_cannot_modify_random_question_set_conf_due_to_part"), true);
                        $this->ctrl->redirect($this);
                }
 
                $this->handleTabs();
 
                $nextClass = $this->ctrl->getNextClass();
                
                switch($nextClass)
                {
                        case 'iltestrandomquestionsetpooldefinitionformgui':
                                $this->questionSetConfig->loadFromDb();
                                $poolId = $this->fetchQuestionPoolIdParameter();
                                $sourcePoolDefinition = $this->getSourcePoolDefinitionByAvailableQuestionPoolId($poolId);
                                $availableTaxonomyIds = ilObjTaxonomy::getUsageOfObject($sourcePoolDefinition->getPoolId());
                                $form = $this->buildCreateSourcePoolDefinitionFormGUI();
                                $form->build($sourcePoolDefinition, $availableTaxonomyIds);
 
                                $this->ctrl->forwardCommand($form);
                                break;
                                
                        default:
                                
                                $cmd = $this->ctrl->getCmd(self::CMD_SHOW_GENERAL_CONFIG_FORM).'Cmd';
                                
                                $this->$cmd();
                }
        }
 
        private function isAvoidManipulationRedirectRequired()
        {
                if( !$this->isFrozenConfigRequired() )
                {
                        return false;
                }
 
                if( !$this->isManipulationCommand() )
                {
                        return false;
                }
 
                return true;
        }
        
        private function isFrozenConfigRequired()
        {
                if( $this->testOBJ->participantDataExist() )
                {
                        return true;
                }
                
                $this->sourcePoolDefinitionList->loadDefinitions();
                
                if( $this->sourcePoolDefinitionList->hasLostPool() )
                {
                        return true;
                }
                
                return false;
        }
 
        private function isManipulationCommand()
        {
                switch( $this->ctrl->getCmd(self::CMD_SHOW_GENERAL_CONFIG_FORM) )
                {
                        case self::CMD_SAVE_GENERAL_CONFIG_FORM:
                        case self::CMD_SAVE_SRC_POOL_DEF_LIST:
                        case self::CMD_DELETE_SINGLE_SRC_POOL_DEF:
                        case self::CMD_DELETE_MULTI_SRC_POOL_DEFS:
                        case self::CMD_SAVE_CREATE_SRC_POOL_DEF_FORM:
                        case self::CMD_SAVE_EDIT_SRC_POOL_DEF_FORM:
                        case self::CMD_SAVE_AND_NEW_CREATE_SRC_POOL_DEF_FORM:
                        case self::CMD_BUILD_QUESTION_STAGE:
 
                                return true;
                }
 
                return false;
        }
        
        private function handleTabs()
        {
                $this->tabs->activateTab('assQuestions');
                
                $this->tabs->addSubTab(
                                'tstRandQuestSetGeneralConfig',
                                $this->lng->txt('tst_rnd_quest_cfg_tab_general'),
                                $this->ctrl->getLinkTarget($this, self::CMD_SHOW_GENERAL_CONFIG_FORM)
                );
                
                $this->tabs->addSubTab(
                                'tstRandQuestSetPoolConfig',
                                $this->lng->txt('tst_rnd_quest_cfg_tab_pool'),
                                $this->ctrl->getLinkTarget($this, self::CMD_SHOW_SRC_POOL_DEF_LIST)
                );
                
                switch( $this->ctrl->getCmd(self::CMD_SHOW_GENERAL_CONFIG_FORM) )
                {
                        case self::CMD_SHOW_GENERAL_CONFIG_FORM:
                        case self::CMD_SAVE_GENERAL_CONFIG_FORM:
                                
                                $this->tabs->activateSubTab('tstRandQuestSetGeneralConfig');
                                break;
 
                        case self::CMD_SHOW_SRC_POOL_DEF_LIST:
                        case self::CMD_SAVE_SRC_POOL_DEF_LIST:
                        case self::CMD_DELETE_SINGLE_SRC_POOL_DEF:
                        case self::CMD_DELETE_MULTI_SRC_POOL_DEFS:
                        case self::CMD_SHOW_CREATE_SRC_POOL_DEF_FORM:
                        case self::CMD_SAVE_CREATE_SRC_POOL_DEF_FORM:
                        case self::CMD_SHOW_EDIT_SRC_POOL_DEF_FORM:
                        case self::CMD_SAVE_EDIT_SRC_POOL_DEF_FORM:
 
                                $this->tabs->activateSubTab('tstRandQuestSetPoolConfig');
                                break;
                        
                        default: $this->tabs->activateSubTab('nonTab');
                }
        }
        
        private function buildQuestionStageCmd()
        {
                $this->sourcePoolDefinitionList->loadDefinitions();
                $this->stagingPool->rebuild( $this->sourcePoolDefinitionList );
                $this->sourcePoolDefinitionList->saveDefinitions();
 
                $this->questionSetConfig->loadFromDb();
                $this->questionSetConfig->setLastQuestionSyncTimestamp(time());
                $this->questionSetConfig->saveToDb();
 
                $this->testOBJ->saveCompleteStatus( $this->questionSetConfig );
                
                ilUtil::sendSuccess($this->lng->txt("tst_msg_random_question_set_synced"), true);
                $this->ctrl->redirect($this, $this->fetchAfterRebuildQuestionStageCmdParameter());
        }
        
        private function fetchAfterRebuildQuestionStageCmdParameter()
        {
                if( !isset($_GET[self::HTTP_PARAM_AFTER_REBUILD_QUESTION_STAGE_CMD]) )
                {
                        return self::CMD_SHOW_GENERAL_CONFIG_FORM;
                }
                
                if( !strlen($_GET[self::HTTP_PARAM_AFTER_REBUILD_QUESTION_STAGE_CMD]) )
                {
                        return self::CMD_SHOW_GENERAL_CONFIG_FORM;
                }
 
                return $_GET[self::HTTP_PARAM_AFTER_REBUILD_QUESTION_STAGE_CMD];
        }
 
        private function showGeneralConfigFormCmd(ilTestRandomQuestionSetGeneralConfigFormGUI $form = null)
        {
                if($form === null)
                {
                        $this->questionSetConfig->loadFromDb();
                        $form = $this->buildGeneralConfigFormGUI();
                }
                
                $this->tpl->setContent( $this->ctrl->getHTML($form) );
 
                $this->configStateMessageHandler->setContext(
                        ilTestRandomQuestionSetConfigStateMessageHandler::CONTEXT_GENERAL_CONFIG
                );
                
                $this->configStateMessageHandler->setLostPools(
                        $this->sourcePoolDefinitionList->getLostPools()
                );
                
                $this->configStateMessageHandler->handle();
        }
 
        private function saveGeneralConfigFormCmd()
        {
                $this->questionSetConfig->loadFromDb();
 
                $form = $this->buildGeneralConfigFormGUI();
 
                $errors = !$form->checkInput(); // ALWAYS CALL BEFORE setValuesByPost()
                $form->setValuesByPost(); // NEVER CALL THIS BEFORE checkInput()
 
                if($errors)
                {
                        return $this->showGeneralConfigFormCmd($form);
                }
                
                $form->save();
 
                $this->sourcePoolDefinitionList->loadDefinitions();
                $this->stagingPool->rebuild( $this->sourcePoolDefinitionList );
                $this->sourcePoolDefinitionList->saveDefinitions();
 
                $this->questionSetConfig->setLastQuestionSyncTimestamp(time());
                $this->questionSetConfig->saveToDb();
 
                $this->testOBJ->saveCompleteStatus( $this->questionSetConfig );
 
                ilUtil::sendSuccess($this->lng->txt("tst_msg_random_question_set_config_modified"), true);
                $this->ctrl->redirect($this, self::CMD_SHOW_GENERAL_CONFIG_FORM);
        }
 
        private function buildGeneralConfigFormGUI()
        {
                require_once 'Modules/Test/classes/forms/class.ilTestRandomQuestionSetGeneralConfigFormGUI.php';
 
                $form = new ilTestRandomQuestionSetGeneralConfigFormGUI(
                        $this->ctrl, $this->lng, $this->testOBJ, $this, $this->questionSetConfig
                );
 
                $form->setEditModeEnabled(!$this->isFrozenConfigRequired());
 
                $form->build();
 
                return $form;
        }
 
        private function showSourcePoolDefinitionListCmd()
        {
                $this->questionSetConfig->loadFromDb();
                $this->sourcePoolDefinitionList->loadDefinitions();
 
                $content = '';
 
                if( !$this->isFrozenConfigRequired() )
                {
                        $toolbar = $this->buildSourcePoolDefinitionListToolbarGUI();
                        $content .= $this->ctrl->getHTML($toolbar);
                }
 
                $table = $this->buildSourcePoolDefinitionListTableGUI();
                $table->init( $this->sourcePoolDefinitionList);
                $content .= $this->ctrl->getHTML($table);
                
                if( !$this->sourcePoolDefinitionList->areAllUsedPoolsAvailable() )
                {
                        $table = $this->buildNonAvailablePoolsTableGUI();
                        $table->init($this->sourcePoolDefinitionList);
                        $content .= $this->ctrl->getHTML($table);
                }
                
                $this->tpl->setContent($content);
 
                $this->configStateMessageHandler->setContext(
                        ilTestRandomQuestionSetConfigStateMessageHandler::CONTEXT_POOL_SELECTION
                );
 
                $this->configStateMessageHandler->setLostPools(
                        $this->sourcePoolDefinitionList->getLostPools()
                );
 
                $this->configStateMessageHandler->handle();
        }
 
        private function saveSourcePoolDefinitionListCmd()
        {
                $this->questionSetConfig->loadFromDb();
 
                $table = $this->buildSourcePoolDefinitionListTableGUI();
 
                $this->sourcePoolDefinitionList->loadDefinitions();
 
                $table->applySubmit($this->sourcePoolDefinitionList);
 
                $this->sourcePoolDefinitionList->reindexPositions();
                $this->sourcePoolDefinitionList->saveDefinitions();
 
                $this->stagingPool->rebuild( $this->sourcePoolDefinitionList );
                $this->sourcePoolDefinitionList->saveDefinitions();
 
                $this->questionSetConfig->setLastQuestionSyncTimestamp(time());
                $this->questionSetConfig->saveToDb();
 
                $this->testOBJ->saveCompleteStatus( $this->questionSetConfig );
 
                ilUtil::sendSuccess($this->lng->txt("tst_msg_random_question_set_config_modified"), true);
                $this->ctrl->redirect($this, self::CMD_SHOW_SRC_POOL_DEF_LIST);
        }
 
        private function buildSourcePoolDefinitionListToolbarGUI()
        {
                require_once 'Modules/Test/classes/toolbars/class.ilTestRandomQuestionSetSourcePoolDefinitionListToolbarGUI.php';
 
                $toolbar = new ilTestRandomQuestionSetSourcePoolDefinitionListToolbarGUI(
                        $this->ctrl, $this->lng, $this, $this->questionSetConfig
                );
 
                $toolbar->build();
 
                return $toolbar;
        }
 
        private function buildSourcePoolDefinitionListTableGUI()
        {
                require_once 'Modules/Test/classes/tables/class.ilTestRandomQuestionSetSourcePoolDefinitionListTableGUI.php';
 
                $table = new ilTestRandomQuestionSetSourcePoolDefinitionListTableGUI(
                        $this->ctrl, $this->lng, $this, self::CMD_SHOW_SRC_POOL_DEF_LIST
                );
 
                if( !$this->isFrozenConfigRequired() )
                {
                        $table->setDefinitionEditModeEnabled(true);
                }
 
                $table->setQuestionAmountColumnEnabled(
                        $this->questionSetConfig->isQuestionAmountConfigurationModePerPool()
                );
 
                require_once 'Modules/Test/classes/class.ilTestTaxonomyFilterLabelTranslater.php';
                $translater = new ilTestTaxonomyFilterLabelTranslater($this->db);
                $translater->loadLabels($this->sourcePoolDefinitionList);
                $table->setTaxonomyFilterLabelTranslater($translater);
 
                $table->build();
 
                return $table;
        }
        
        private function buildNonAvailablePoolsTableGUI()
        {
                require_once 'Modules/Test/classes/tables/class.ilTestRandomQuestionSetNonAvailablePoolsTableGUI.php';
                
                $table = new ilTestRandomQuestionSetNonAvailablePoolsTableGUI(
                        $this->ctrl, $this->lng, $this, self::CMD_SHOW_SRC_POOL_DEF_LIST
                );
                
                $table->build();
                
                return $table;
        }
 
        private function deleteSingleSourcePoolDefinitionCmd()
        {
                $definitionId = $this->fetchSingleSourcePoolDefinitionIdParameter();
                $this->deleteSourcePoolDefinitions( array($definitionId) );
 
                ilUtil::sendSuccess($this->lng->txt("tst_msg_source_pool_definitions_deleted"), true);
                $this->ctrl->redirect($this, self::CMD_SHOW_SRC_POOL_DEF_LIST);
        }
 
        private function deleteMultipleSourcePoolDefinitionsCmd()
        {
                $definitionIds = $this->fetchMultiSourcePoolDefinitionIdsParameter();
                $this->deleteSourcePoolDefinitions( $definitionIds );
 
                ilUtil::sendSuccess($this->lng->txt("tst_msg_source_pool_definitions_deleted"), true);
                $this->ctrl->redirect($this, self::CMD_SHOW_SRC_POOL_DEF_LIST);
        }
 
        private function deleteSourcePoolDefinitions($definitionIds)
        {
                foreach($definitionIds as $definitionId)
                {
                        $definition = $this->sourcePoolDefinitionFactory->getSourcePoolDefinitionByDefinitionId($definitionId);
                        $definition->deleteFromDb();
                }
 
                $this->sourcePoolDefinitionList->loadDefinitions();
                $this->sourcePoolDefinitionList->reindexPositions();
                $this->sourcePoolDefinitionList->saveDefinitions();
 
                $this->sourcePoolDefinitionList->loadDefinitions();
                $this->stagingPool->rebuild( $this->sourcePoolDefinitionList );
                $this->sourcePoolDefinitionList->saveDefinitions();
                
                // Bugfix for mantis: 0015082
                $this->questionSetConfig->loadFromDb();
                $this->questionSetConfig->setLastQuestionSyncTimestamp(time());
                $this->questionSetConfig->saveToDb();
 
                $this->testOBJ->saveCompleteStatus( $this->questionSetConfig );
        }
 
        private function showCreateSourcePoolDefinitionFormCmd(ilTestRandomQuestionSetPoolDefinitionFormGUI $form = null)
        {
                $this->questionSetConfig->loadFromDb();
 
                $poolId = $this->fetchQuestionPoolIdParameter();
 
                $sourcePoolDefinition = $this->getSourcePoolDefinitionByAvailableQuestionPoolId($poolId);
                $availableTaxonomyIds = ilObjTaxonomy::getUsageOfObject($sourcePoolDefinition->getPoolId());
 
                if($form === null)
                {
                        $form = $this->buildCreateSourcePoolDefinitionFormGUI();
                        $form->build($sourcePoolDefinition, $availableTaxonomyIds);
                }
 
                $this->tpl->setContent( $this->ctrl->getHTML($form) );
        }
        
        private function saveCreateAndNewSourcePoolDefinitionFormCmd()
        {
                $this->saveCreateSourcePoolDefinitionFormCmd(true);
        }
 
        private function saveCreateSourcePoolDefinitionFormCmd($redirect_back_to_form = false)
        {
                $this->questionSetConfig->loadFromDb();
 
                $poolId = $this->fetchQuestionPoolIdParameter();
                $sourcePoolDefinition = $this->getSourcePoolDefinitionByAvailableQuestionPoolId($poolId);
                $availableTaxonomyIds = ilObjTaxonomy::getUsageOfObject($sourcePoolDefinition->getPoolId());
 
                $form = $this->buildCreateSourcePoolDefinitionFormGUI();
                $form->build($sourcePoolDefinition, $availableTaxonomyIds);
 
                $errors = !$form->checkInput(); // ALWAYS CALL BEFORE setValuesByPost()
                $form->setValuesByPost(); // NEVER CALL THIS BEFORE checkInput()
 
                if($errors)
                {
                        return $this->showCreateSourcePoolDefinitionFormCmd($form);
                }
 
                $form->applySubmit( $sourcePoolDefinition, $availableTaxonomyIds );
 
                $this->sourcePoolDefinitionList->loadDefinitions();
                $sourcePoolDefinition->setSequencePosition( $this->sourcePoolDefinitionList->getNextPosition() );
                $sourcePoolDefinition->saveToDb();
                $this->sourcePoolDefinitionList->addDefinition($sourcePoolDefinition);
 
                $this->stagingPool->rebuild( $this->sourcePoolDefinitionList );
                $this->sourcePoolDefinitionList->saveDefinitions();
 
                $this->questionSetConfig->setLastQuestionSyncTimestamp(time());
                $this->questionSetConfig->saveToDb();
 
                $this->testOBJ->saveCompleteStatus( $this->questionSetConfig );
 
                if($redirect_back_to_form)
                {
                        ilUtil::sendSuccess($this->lng->txt("tst_msg_random_qsc_modified_add_new_rule"), true);
                        $this->ctrl->setParameter($this, 'src_pool_def_id', $sourcePoolDefinition->getId());
                        $this->ctrl->setParameter($this, 'quest_pool_id', $sourcePoolDefinition->getPoolId());
                        $this->ctrl->redirect($this, self::CMD_SHOW_CREATE_SRC_POOL_DEF_FORM);
                }
                else
                {
                        ilUtil::sendSuccess($this->lng->txt("tst_msg_random_question_set_config_modified"), true);
                        $this->ctrl->redirect($this, self::CMD_SHOW_SRC_POOL_DEF_LIST);
                }
        }
 
        private function buildCreateSourcePoolDefinitionFormGUI()
        {
                require_once 'Modules/Test/classes/forms/class.ilTestRandomQuestionSetPoolDefinitionFormGUI.php';
 
                $form = new ilTestRandomQuestionSetPoolDefinitionFormGUI(
                        $this->ctrl, $this->lng, $this->testOBJ, $this, $this->questionSetConfig
                );
 
                $form->setSaveCommand(self::CMD_SAVE_CREATE_SRC_POOL_DEF_FORM);
                $form->setSaveAndNewCommand(self::CMD_SAVE_AND_NEW_CREATE_SRC_POOL_DEF_FORM);
 
                return $form;
        }
 
        private function showEditSourcePoolDefinitionFormCmd(ilTestRandomQuestionSetPoolDefinitionFormGUI $form = null)
        {
                $this->questionSetConfig->loadFromDb();
 
                $defId = $this->fetchSingleSourcePoolDefinitionIdParameter();
                $sourcePoolDefinition = $this->sourcePoolDefinitionFactory->getSourcePoolDefinitionByDefinitionId($defId);
                $availableTaxonomyIds = ilObjTaxonomy::getUsageOfObject($sourcePoolDefinition->getPoolId());
 
                if($form === null)
                {
                        $form = $this->buildEditSourcePoolDefinitionFormGUI();
                        $form->build($sourcePoolDefinition, $availableTaxonomyIds);
                }
 
                $this->tpl->setContent( $this->ctrl->getHTML($form) );
        }
 
        private function saveEditSourcePoolDefinitionFormCmd()
        {
                $this->questionSetConfig->loadFromDb();
 
                $defId = $this->fetchSingleSourcePoolDefinitionIdParameter();
                $sourcePoolDefinition = $this->sourcePoolDefinitionFactory->getSourcePoolDefinitionByDefinitionId($defId);
                $availableTaxonomyIds = ilObjTaxonomy::getUsageOfObject($sourcePoolDefinition->getPoolId());
 
                $form = $this->buildEditSourcePoolDefinitionFormGUI();
                $form->build($sourcePoolDefinition, $availableTaxonomyIds);
 
                $errors = !$form->checkInput(); // ALWAYS CALL BEFORE setValuesByPost()
                $form->setValuesByPost(); // NEVER CALL THIS BEFORE checkInput()
 
                if($errors)
                {
                        return $this->showSourcePoolDefinitionListCmd($form);
                }
 
                $form->applySubmit($sourcePoolDefinition, $availableTaxonomyIds);
 
                $sourcePoolDefinition->saveToDb();
 
                $this->sourcePoolDefinitionList->loadDefinitions();
                $this->stagingPool->rebuild( $this->sourcePoolDefinitionList );
 
                $this->questionSetConfig->setLastQuestionSyncTimestamp(time());
                $this->questionSetConfig->saveToDb();
 
                $this->testOBJ->saveCompleteStatus( $this->questionSetConfig );
 
                ilUtil::sendSuccess($this->lng->txt("tst_msg_random_question_set_config_modified"), true);
                $this->ctrl->redirect($this, self::CMD_SHOW_SRC_POOL_DEF_LIST);
        }
 
        private function buildEditSourcePoolDefinitionFormGUI()
        {
                require_once 'Modules/Test/classes/forms/class.ilTestRandomQuestionSetPoolDefinitionFormGUI.php';
 
                $form = new ilTestRandomQuestionSetPoolDefinitionFormGUI(
                        $this->ctrl, $this->lng, $this->testOBJ, $this, $this->questionSetConfig
                );
 
                $form->setSaveCommand(self::CMD_SAVE_EDIT_SRC_POOL_DEF_FORM);
 
                return $form;
        }
 
        private function fetchQuestionPoolIdParameter()
        {
                if( isset($_POST['quest_pool_id']) && (int)$_POST['quest_pool_id'] )
                {
                        return (int)$_POST['quest_pool_id'];
                }
 
                if( isset($_GET['quest_pool_id']) && (int)$_GET['quest_pool_id'] )
                {
                        return (int)$_GET['quest_pool_id'];
                }
 
                require_once 'Modules/Test/exceptions/class.ilTestMissingQuestionPoolIdParameterException.php';
                throw new ilTestMissingQuestionPoolIdParameterException();
        }
 
        private function fetchSingleSourcePoolDefinitionIdParameter()
        {
                if( isset($_POST['src_pool_def_id']) && (int)$_POST['src_pool_def_id'] )
                {
                        return (int)$_POST['src_pool_def_id'];
                }
 
                if( isset($_GET['src_pool_def_id']) && (int)$_GET['src_pool_def_id'] )
                {
                        return (int)$_GET['src_pool_def_id'];
                }
 
                require_once 'Modules/Test/exceptions/class.ilTestMissingSourcePoolDefinitionParameterException.php';
                throw new ilTestMissingSourcePoolDefinitionParameterException();
        }
 
        private function fetchMultiSourcePoolDefinitionIdsParameter()
        {
                if( !isset($_POST['src_pool_def_ids']) || !is_array($_POST['src_pool_def_ids']) )
                {
                        require_once 'Modules/Test/exceptions/class.ilTestMissingSourcePoolDefinitionParameterException.php';
                        throw new ilTestMissingSourcePoolDefinitionParameterException();
                }
 
                $definitionIds = array();
 
                foreach($_POST['src_pool_def_ids'] as $definitionId)
                {
                        $definitionId = (int)$definitionId;
 
                        if( !$definitionId )
                        {
                                require_once 'Modules/Test/exceptions/class.ilTestMissingSourcePoolDefinitionParameterException.php';
                                throw new ilTestMissingSourcePoolDefinitionParameterException();
                        }
 
                        $definitionIds[] = $definitionId;
                }
 
                return $definitionIds;
        }
 
        private function getSourcePoolDefinitionByAvailableQuestionPoolId($poolId)
        {
                $availablePools = $this->testOBJ->getAvailableQuestionpools(
                        true, $this->questionSetConfig->arePoolsWithHomogeneousScoredQuestionsRequired(), false, true, true
                );
 
                if( isset($availablePools[$poolId]) )
                {
                        $originalPoolData = $availablePools[$poolId];
 
                        $originalPoolData['qpl_path'] = $this->questionSetConfig->getQuestionPoolPathString($poolId);
 
                        return $this->sourcePoolDefinitionFactory->getSourcePoolDefinitionByOriginalPoolData($originalPoolData);
                }
 
                require_once 'Modules/Test/exceptions/class.ilTestQuestionPoolNotAvailableAsSourcePoolException.php';
                throw new ilTestQuestionPoolNotAvailableAsSourcePoolException();
        }
        
        protected function fetchPoolIdsParameter()
        {
                if( isset($_POST['derive_pool_ids']) && is_array($_POST['derive_pool_ids']) )
                {
                        $poolIds = array();
                        
                        foreach($_POST['derive_pool_ids'] as $poolId)
                        {
                                $poolIds[] = (int)$poolId;
                        }
                }
                elseif( isset($_GET['derive_pool_ids']) && preg_match('/^\d+(\:\d+)*$/', $_GET['derive_pool_ids']))
                {
                        $poolIds = explode(':', $_GET['derive_pool_ids']);
                }
                elseif( isset($_GET['derive_pool_id']) && (int)$_GET['derive_pool_id'])
                {
                        $poolIds = array( (int)$_GET['derive_pool_id'] );
                }
                
                return $poolIds;
        }
        
        protected function fetchTargetRefParameter()
        {
                if( isset($_GET['target_ref']) && (int)$_GET['target_ref'] )
                {
                        return (int)$_GET['target_ref'];
                }
                
                return null;
        }
        
        private function selectPoolDerivationTargetCmd()
        {
                $this->ctrl->setParameter($this, 'derive_pool_ids', implode(':', $this->fetchPoolIdsParameter()));
 
                require_once 'Services/Repository/classes/class.ilRepositorySelectorExplorerGUI.php';
                $explorer = new ilRepositorySelectorExplorerGUI(
                        $this, self::CMD_SHOW_SRC_POOL_DEF_LIST, $this, self::CMD_DERIVE_NEW_POOLS, 'target_ref'
                );
                $explorer->setClickableTypes($this->objDefinition->getExplorerContainerTypes());
                $explorer->setSelectableTypes(array());
                
                ilUtil::sendInfo($this->lng->txt('tst_please_select_target_for_pool_derives'));
                
                $this->tpl->setContent($this->ctrl->getHTML($explorer));
        }
        
        private function deriveNewPoolsCmd()
        {
                $poolIds = $this->fetchPoolIdsParameter();
                $targetRef = $this->fetchTargetRefParameter();
                
                if( count($poolIds) )
                {
                        $this->sourcePoolDefinitionList->loadDefinitions();
                        
                        require_once 'Modules/Test/classes/class.ilTestRandomQuestionSetPoolDeriver.php';
                        
                        foreach($poolIds as $poolId)
                        {
                                $lostPool = $this->sourcePoolDefinitionList->getLostPool($poolId);
                                
                                $deriver = new ilTestRandomQuestionSetPoolDeriver($this->db, $this->pluginAdmin, $this->testOBJ);
                                $deriver->setSourcePoolDefinitionList($this->sourcePoolDefinitionList);
                                $deriver->setTargetContainerRef($targetRef);
                                $deriver->setOwnerId($GLOBALS['DIC']['ilUser']->getId());
                                $newPool = $deriver->derive($lostPool);
                                
                                $srcPoolDefinition = $this->sourcePoolDefinitionList->getDefinitionBySourcePoolId($newPool->getId());
                                $srcPoolDefinition->setPoolTitle($newPool->getTitle());
                                $srcPoolDefinition->setPoolPath($this->questionSetConfig->getQuestionPoolPathString($newPool->getId()));
                                $srcPoolDefinition->saveToDb();
                                
                                ilTestRandomQuestionSetStagingPoolQuestionList::updateSourceQuestionPoolId(
                                        $this->testOBJ->getTestId(), $lostPool->getId(), $newPool->getId()
                                );
                        }
                        
                        ilUtil::sendSuccess($this->lng->txt('tst_non_available_pool_newly_derived'), true);
                }
                
                $this->ctrl->redirect($this, self::CMD_SHOW_SRC_POOL_DEF_LIST);
        }
}