ilLOTestAssignments Class Reference

Settings for LO courses. More...

Collaboration diagram for ilLOTestAssignments:

Public Member Functions
	__construct ($a_container_id)
	Constructor. More...
	getContainerId ()
	getSettings ()
	get objective settings More...
	getAssignments ()
	Get assignments. More...
	getAssignmentsByType ($a_type)
	getTests ()
	Get all assigned tests. More...
	getTestByObjective ($a_objective_id, $a_type)
	isSeparateTest ($a_test_ref_id)
	getTypeByTest ($a_test_ref_id)
	Get test type by test id. More...
	getAssignmentByObjective ($a_objective_id, $a_type)
	Get assignment by objective. More...
	toXml (ilXmlWriter $writer, $a_objective_id)
	to xml More...

Static Public Member Functions
static	getInstance ($a_container_id)
	Get instance by container id. More...
static	lookupContainerForTest ($a_test_ref_id)
static	deleteByContainer ($a_container_id)
	Delete assignments by container id (obj_id of course) type $ilDB. More...
static	lookupObjectivesForTest ($a_test_ref_id)
	Get all objectives that are assigned to given test. More...

Protected Member Functions
	readTestAssignments ()
	Read assignments type $ilDB. More...

Private Attributes
	$container_id = 0
	$assignments = array()
	$settings = null

Static Private Attributes
static	$instances = array()

Detailed Description

Settings for LO courses.

Author

Stefan Meyer smeye.nosp@m.r.il.nosp@m.ias@g.nosp@m.mx.d.nosp@m.e

Version

$Id$

Definition at line 10 of file class.ilLOTestAssignments.php.

Constructor & Destructor Documentation

__construct()

ilLOTestAssignments::__construct

(

$a_container_id

)

Constructor.

Parameters

type

$a_container_id

Definition at line 24 of file class.ilLOTestAssignments.php.

References ilLOSettings\getInstanceByObjId(), readTestAssignments(), and settings().

    {
        $this->container_id = $a_container_id;
        
        include_once './Modules/Course/classes/Objectives/class.ilLOSettings.php';
        $this->settings = ilLOSettings::getInstanceByObjId($a_container_id);
        $this->readTestAssignments();
    }

Here is the call graph for this function:

Member Function Documentation

deleteByContainer()

static ilLOTestAssignments::deleteByContainer (   $a_container_id )

static

Delete assignments by container id (obj_id of course) type $ilDB.

Parameters

type

$a_container_id

Definition at line 91 of file class.ilLOTestAssignments.php.

References $ilDB, and $query.

    {
        global $ilDB;
        
        $query = 'DELETE FROM loc_tst_assignments ' .
                'WHERE container_id = ' . $ilDB->quote($a_container_id, 'integer');
        $ilDB->manipulate($query);
    }

getAssignmentByObjective()

ilLOTestAssignments::getAssignmentByObjective	(		$a_objective_id,
			$a_type
	)

Get assignment by objective.

Parameters

type	$a_objective_id
	type	initial or final

Returns

ilLOTestAssignment

Definition at line 212 of file class.ilLOTestAssignments.php.

References $a_type.

Referenced by getTestByObjective().

    {
        foreach ($this->assignments as $assignment) {
            if (
                ($assignment->getObjectiveId() == $a_objective_id) &&
                ($assignment->getAssignmentType() == $a_type)
            ) {
                return $assignment;
            }
        }
        return false;
    }

Here is the caller graph for this function:

getAssignments()

ilLOTestAssignments::getAssignments

(

)

Get assignments.

Returns

ilLOTestAssignment[]

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

References $assignments.

Referenced by toXml().

    {
        return $this->assignments;
    }

Here is the caller graph for this function:

getAssignmentsByType()

ilLOTestAssignments::getAssignmentsByType

(

$a_type

)

Definition at line 100 of file class.ilLOTestAssignments.php.

References $a_type, and array.

    {
        $by_type = array();
        foreach ($this->assignments as $assignment) {
            if ($assignment->getAssignmentType() == $a_type) {
                $by_type[] = $assignment;
            }
        }
        return $by_type;
    }

getContainerId()

ilLOTestAssignments::getContainerId

(

)

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

References $container_id.

Referenced by readTestAssignments().

    {
        return $this->container_id;
    }

Here is the caller graph for this function:

getInstance()

static ilLOTestAssignments::getInstance (   $a_container_id )

static

Get instance by container id.

Parameters

type

$a_container_id

Returns

ilLOTestAssignments

Definition at line 38 of file class.ilLOTestAssignments.php.

Referenced by ilLOTestQuestionAdapter\__construct(), ilLOEditorStatus\__construct(), ilCourseObjectiveMaterials\_getAssignableMaterials(), ilLOMemberTestResultTableGUI\createTestResultLink(), ilLOEditorGUI\deleteAssignments(), ilLOTestAssignmentForm\getAssignableTests(), ilTestLearningObjectivesStatusGUI\getUsersObjectivesStatus(), ilCourseObjective\ilClone(), ilLOTestAssignmentForm\initForm(), ilContainerObjectiveGUI\initTestAssignments(), ilLOUtils\lookupObjectiveRequiredPercentage(), ilLOTestQuestionAdapter\lookupRelevantObjectiveIdsForTest(), ilCourseObjectivesTableGUI\parse(), ilContainerObjectiveGUI\parseLOUserResults(), ilLOTestAssignmentTableGUI\parseMultipleAssignments(), ilPortfolioPageGUI\parseObjectives(), ilCourseObjectiveResult\reset(), ilContainerObjectiveGUI\showMaterials(), and ilCourseObjective\toXml().

    {
        if (self::$instances[$a_container_id]) {
            return self::$instances[$a_container_id];
        }
        return self::$instances[$a_container_id] = new self($a_container_id);
    }

Here is the caller graph for this function:

getSettings()

ilLOTestAssignments::getSettings

(

)

get objective settings

Returns

ilLOSettings

Definition at line 72 of file class.ilLOTestAssignments.php.

References $settings.

Referenced by getTestByObjective(), getTests(), getTypeByTest(), and isSeparateTest().

    {
        return $this->settings;
    }

Here is the caller graph for this function:

getTestByObjective()

ilLOTestAssignments::getTestByObjective	(		$a_objective_id,
			$a_type
	)

Parameters

type	$a_objective_id
type	$a_type

Returns

int

Definition at line 136 of file class.ilLOTestAssignments.php.

References $a_type, getAssignmentByObjective(), getSettings(), ilLOSettings\TYPE_TEST_INITIAL, and ilLOSettings\TYPE_TEST_QUALIFIED.

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

Here is the call graph for this function:

getTests()

ilLOTestAssignments::getTests

(

)

Get all assigned tests.

Returns

type

Definition at line 115 of file class.ilLOTestAssignments.php.

References array, and getSettings().

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

Here is the call graph for this function:

getTypeByTest()

ilLOTestAssignments::getTypeByTest

(

$a_test_ref_id

)

Get test type by test id.

Parameters

type

$a_test_ref_id

Definition at line 178 of file class.ilLOTestAssignments.php.

References getSettings(), ilLOSettings\TYPE_TEST_INITIAL, ilLOSettings\TYPE_TEST_QUALIFIED, and ilLOSettings\TYPE_TEST_UNDEFINED.

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

Here is the call graph for this function:

isSeparateTest()

ilLOTestAssignments::isSeparateTest

(

$a_test_ref_id

)

Definition at line 159 of file class.ilLOTestAssignments.php.

References getSettings().

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

Here is the call graph for this function:

lookupContainerForTest()

static ilLOTestAssignments::lookupContainerForTest (   $a_test_ref_id )

static

Parameters

type

$a_test_ref_id

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

References $ilDB, $query, $res, $row, and ilDBConstants\FETCHMODE_OBJECT.

Referenced by ilLOSettings\isObjectiveTest().

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

Here is the caller graph for this function:

lookupObjectivesForTest()

static ilLOTestAssignments::lookupObjectivesForTest (   $a_test_ref_id )

static

Get all objectives that are assigned to given test.

Parameters

int

$a_test_ref_id

Returns

array

Definition at line 273 of file class.ilLOTestAssignments.php.

References $ilDB, $query, $res, $row, array, and ilDBConstants\FETCHMODE_OBJECT.

Referenced by ilTestLP\resetCustomLPDataForUserIds().

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

Here is the caller graph for this function:

readTestAssignments()

ilLOTestAssignments::readTestAssignments ( )

protected

Read assignments type $ilDB.

Definition at line 229 of file class.ilLOTestAssignments.php.

References $ilDB, $query, $res, $row, ilDBConstants\FETCHMODE_OBJECT, and getContainerId().

Referenced by __construct().

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

Here is the call graph for this function:

Here is the caller graph for this function:

toXml()

ilLOTestAssignments::toXml	(	ilXmlWriter	$writer,
			$a_objective_id
	)

to xml

Parameters

ilXmlWriter

$writer

Definition at line 248 of file class.ilLOTestAssignments.php.

References array, getAssignments(), ilLOXmlWriter\TYPE_TST_PO, and ilXmlWriter\xmlElement().

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

Here is the call graph for this function:

Field Documentation

$assignments

ilLOTestAssignments::$assignments = array()

private

Definition at line 15 of file class.ilLOTestAssignments.php.

Referenced by getAssignments().

$container_id

ilLOTestAssignments::$container_id = 0

private

Definition at line 14 of file class.ilLOTestAssignments.php.

Referenced by getContainerId().

$instances

ilLOTestAssignments::$instances = array()

staticprivate

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

$settings

ilLOTestAssignments::$settings = null

private

Definition at line 17 of file class.ilLOTestAssignments.php.

Referenced by getSettings().

---

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

• Modules/Course/classes/Objectives/class.ilLOTestAssignments.php