class.ilLOTestAssignments.php

Go to the documentation of this file.

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

class ilLOTestAssignments
{
    private static $instances = array();
    
    private $container_id = 0;
    private $assignments = array();
    
    private $settings = null;
    
    
    public function __construct($a_container_id)
    {
        $this->container_id = $a_container_id;
        
        include_once './Modules/Course/classes/Objectives/class.ilLOSettings.php';
        $this->settings = ilLOSettings::getInstanceByObjId($a_container_id);
        $this->readTestAssignments();
    }
    
    public static function getInstance($a_container_id)
    {
        if (self::$instances[$a_container_id]) {
            return self::$instances[$a_container_id];
        }
        return self::$instances[$a_container_id] = new self($a_container_id);
    }
    
    public static function lookupContainerForTest($a_test_ref_id)
    {
        global $DIC;

        $ilDB = $DIC['ilDB'];
        
        $query = 'SELECT container_id FROM loc_tst_assignments ' .
                'WHERE tst_ref_id = ' . $ilDB->quote($a_test_ref_id, 'integer');
        $res = $ilDB->query($query);
        while ($row = $res->fetchRow(ilDBConstants::FETCHMODE_OBJECT)) {
            return $row->container_id;
        }
        return 0;
    }
    
    public function getContainerId()
    {
        return $this->container_id;
    }
    
    public function getSettings()
    {
        return $this->settings;
    }
    
    public function getAssignments()
    {
        return $this->assignments;
    }

    public static function deleteByContainer($a_container_id)
    {
        global $DIC;

        $ilDB = $DIC['ilDB'];
        
        $query = 'DELETE FROM loc_tst_assignments ' .
                'WHERE container_id = ' . $ilDB->quote($a_container_id, 'integer');
        $ilDB->manipulate($query);
    }
    
    public function getAssignmentsByType($a_type)
    {
        $by_type = array();
        foreach ($this->assignments as $assignment) {
            if ($assignment->getAssignmentType() == $a_type) {
                $by_type[] = $assignment;
            }
        }
        return $by_type;
    }
    
    public function getTests()
    {
        $tests = array();
        if ($this->getSettings()->getInitialTest()) {
            $tests[] = $this->getSettings()->getInitialTest();
        }
        if ($this->getSettings()->getQualifiedTest()) {
            $tests[] = $this->getSettings()->getQualifiedTest();
        }
        foreach ($this->assignments as $assignment) {
            $tests[] = $assignment->getTestRefId();
        }
        return $tests;
    }

    public function getTestByObjective($a_objective_id, $a_type)
    {
        switch ($a_type) {
            case ilLOSettings::TYPE_TEST_INITIAL:
                if (!$this->getSettings()->hasSeparateInitialTests()) {
                    return $this->getSettings()->getInitialTest();
                }
                break;
                
            case ilLOSettings::TYPE_TEST_QUALIFIED:
                if (!$this->getSettings()->hasSeparateQualifiedTests()) {
                    return $this->getSettings()->getQualifiedTest();
                }
                break;
        }
                
        $assignment = $this->getAssignmentByObjective($a_objective_id, $a_type);
        if ($assignment) {
            return $assignment->getTestRefId();
        }
        return 0;
    }
    
    public function isSeparateTest($a_test_ref_id)
    {
        if (!$this->getSettings()->hasSeparateInitialTests()) {
            if ($this->getSettings()->getInitialTest() == $a_test_ref_id) {
                return false;
            }
        }
        if (!$this->getSettings()->hasSeparateQualifiedTests()) {
            if ($this->getSettings()->getQualifiedTest() == $a_test_ref_id) {
                return false;
            }
        }
        return true;
    }
    
    public function getTypeByTest($a_test_ref_id)
    {
        if ($this->getSettings()->worksWithInitialTest() && !$this->getSettings()->hasSeparateInitialTests()) {
            if ($this->getSettings()->getInitialTest() == $a_test_ref_id) {
                return ilLOSettings::TYPE_TEST_INITIAL;
            }
        } elseif ($this->getSettings()->worksWithInitialTest()) {
            foreach ($this->assignments as $assignment) {
                if ($assignment->getTestRefId() == $a_test_ref_id) {
                    return ilLOSettings::TYPE_TEST_INITIAL;
                }
            }
        }
        if (!$this->getSettings()->hasSeparateQualifiedTests()) {
            if ($this->getSettings()->getQualifiedTest() == $a_test_ref_id) {
                return ilLOSettings::TYPE_TEST_QUALIFIED;
            }
        } else {
            foreach ($this->assignments as $assignment) {
                if ($assignment->getTestRefId() == $a_test_ref_id) {
                    return ilLOSettings::TYPE_TEST_QUALIFIED;
                }
            }
        }
        return ilLOSettings::TYPE_TEST_UNDEFINED;
    }
    
    
    public function getAssignmentByObjective($a_objective_id, $a_type)
    {
        foreach ($this->assignments as $assignment) {
            if (
                ($assignment->getObjectiveId() == $a_objective_id) &&
                ($assignment->getAssignmentType() == $a_type)
            ) {
                return $assignment;
            }
        }
        return false;
    }
    
    protected function readTestAssignments()
    {
        global $DIC;

        $ilDB = $DIC['ilDB'];

        $query = 'SELECT assignment_id FROM loc_tst_assignments ' .
                'WHERE container_id = ' . $ilDB->quote($this->getContainerId(), 'integer');
        $res = $ilDB->query($query);
        while ($row = $res->fetchRow(ilDBConstants::FETCHMODE_OBJECT)) {
            include_once './Modules/Course/classes/Objectives/class.ilLOTestAssignment.php';
            $assignment = new ilLOTestAssignment($row->assignment_id);
            
            $this->assignments[] = $assignment;
        }
    }
    
    public function toXml(ilXmlWriter $writer, $a_objective_id)
    {
        foreach ($this->getAssignments() as $assignment) {
            if ($assignment->getObjectiveId() != $a_objective_id) {
                continue;
            }
            
            include_once './Modules/Course/classes/Objectives/class.ilLOXmlWriter.php';
            $writer->xmlElement(
                'Test',
                array(
                    'type' => ilLOXmlWriter::TYPE_TST_PO,
                    'refId' => $assignment->getTestRefId(),
                    'testType' => $assignment->getAssignmentType()
                )
            );
        }
    }
    
    
    public static function lookupObjectivesForTest($a_test_ref_id)
    {
        global $DIC;

        $ilDB = $DIC['ilDB'];
        
        $objectives = array();
        
        $query = 'SELECT objective_id FROM loc_tst_assignments ' .
                'WHERE tst_ref_id = ' . $ilDB->quote($a_test_ref_id, 'integer');
        $res = $ilDB->query($query);
        while ($row = $res->fetchRow(ilDBConstants::FETCHMODE_OBJECT)) {
            $objectives[] = $row->objective_id;
        }
        return $objectives;
    }
}