ilLOTestAssignments Class Reference

This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V. More...

Collaboration diagram for ilLOTestAssignments:

Public Member Functions
	__construct (int $a_container_id)
	getContainerId ()
	getSettings ()
	getAssignments ()
	Get assignments. More...
	getAssignmentsByType (int $a_type)
	Get assignments by type. More...
	getTests ()
	getTestByObjective (int $a_objective_id, int $a_type)
	isSeparateTest (int $a_test_ref_id)
	getTypeByTest (int $a_test_ref_id)
	getAssignmentByObjective (int $a_objective_id, int $a_type)
	toXml (ilXmlWriter $writer, int $a_objective_id)

Static Public Member Functions
static	getInstance (int $a_container_id)
static	lookupContainerForTest (int $a_test_ref_id)
static	deleteByContainer (int $a_container_id)
static	lookupObjectivesForTest (int $a_test_ref_id)

Protected Member Functions
	readTestAssignments ()

Protected Attributes
ilDBInterface	$db

Private Attributes
int	$container_id = 0
array	$assignments = []
ilLOSettings	$settings

Static Private Attributes
static array	$instances = []

Detailed Description

This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V.

ILIAS is licensed with the GPL-3.0, see https://www.gnu.org/licenses/gpl-3.0.en.html You should have received a copy of said license along with the source code, too.

If this is not the case or you just want to try ILIAS, you'll find us at: https://www.ilias.de https://github.com/ILIAS-eLearning Settings for LO courses

Author

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

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

Constructor & Destructor Documentation

__construct()

ilLOTestAssignments::__construct

(

int

$a_container_id

)

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

References $DIC, ilLOSettings\getInstanceByObjId(), readTestAssignments(), and ILIAS\Repository\settings().

    {
        global $DIC;

        $this->db = $DIC->database();

        $this->container_id = $a_container_id;
        $this->settings = ilLOSettings::getInstanceByObjId($a_container_id);
        $this->readTestAssignments();
    }

Here is the call graph for this function:

Member Function Documentation

deleteByContainer()

static ilLOTestAssignments::deleteByContainer ( int  $a_container_id )

static

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

References $DIC, $ilDB, and $query.

                                                                 : void
    {
        global $DIC;

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

getAssignmentByObjective()

ilLOTestAssignments::getAssignmentByObjective	(	int	$a_objective_id,
		int	$a_type
	)

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

Referenced by getTestByObjective().

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

Here is the caller graph for this function:

getAssignments()

ilLOTestAssignments::getAssignments

(

)

Get assignments.

Returns

ilLOTestAssignment[]

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

References $assignments.

Referenced by toXml().

                                    : array
    {
        return $this->assignments;
    }

Here is the caller graph for this function:

getAssignmentsByType()

ilLOTestAssignments::getAssignmentsByType

(

int

$a_type

)

Get assignments by type.

Returns

ilLOTestAssignment[]

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

                                                     : 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 71 of file class.ilLOTestAssignments.php.

References $container_id.

Referenced by readTestAssignments().

                                    : int
    {
        return $this->container_id;
    }

Here is the caller graph for this function:

getInstance()

static ilLOTestAssignments::getInstance ( int  $a_container_id )

static

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

Referenced by ilLOTestQuestionAdapter\__construct(), ilLOEditorStatus\__construct(), ilCourseObjectiveMaterials\_getAssignableMaterials(), ilLOMemberTestResultTableGUI\createTestResultLink(), ilLOEditorGUI\deleteAssignments(), ilLOTestAssignmentForm\getAssignableTests(), ilPortfolioPageGUI\getCoursesOfUser(), ilTestLearningObjectivesStatusGUI\getUsersObjectivesStatus(), ilCourseObjective\ilClone(), ilLOTestAssignmentForm\initForm(), ilLOUtils\lookupMaxAttempts(), ilLOUtils\lookupObjectiveRequiredPercentage(), ilLOTestQuestionAdapter\lookupRelevantObjectiveIdsForTest(), ilCourseObjectivesTableGUI\parse(), ilLOTestAssignmentTableGUI\parseMultipleAssignments(), ilCourseObjectiveResult\reset(), ilTestLP\resetCustomLPDataForUserIds(), and ilCourseObjective\toXml().

                                                           : self
    {
        if (isset(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

(

)

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

References $settings.

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

                                 : ilLOSettings
    {
        return $this->settings;
    }

Here is the caller graph for this function:

getTestByObjective()

ilLOTestAssignments::getTestByObjective	(	int	$a_objective_id,
		int	$a_type
	)

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

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

Referenced by ilLOTestQuestionAdapter\lookupRelevantObjectiveIdsForTest().

                                                                        : int
    {
        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:

Here is the caller graph for this function:

getTests()

ilLOTestAssignments::getTests

(

)

Returns

int[]

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

References getSettings().

                              : array
    {
        $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

(

int

$a_test_ref_id

)

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

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

Referenced by ilLOTestQuestionAdapter\lookupRelevantObjectiveIdsForTest().

                                                     : int
    {
        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:

Here is the caller graph for this function:

isSeparateTest()

ilLOTestAssignments::isSeparateTest

(

int

$a_test_ref_id

)

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

References getSettings().

                                                      : bool
    {
        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 ( int  $a_test_ref_id )

static

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

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

Referenced by ilLOSettings\isObjectiveTest(), and ilTestLP\resetCustomLPDataForUserIds().

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

Here is the caller graph for this function:

lookupObjectivesForTest()

static ilLOTestAssignments::lookupObjectivesForTest ( int  $a_test_ref_id )

static

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

References $DIC, $ilDB, $objectives, $query, $res, and ilDBConstants\FETCHMODE_OBJECT.

Referenced by ilTestLP\resetCustomLPDataForUserIds().

                                                                      : array
    {
        global $DIC;

        $ilDB = $DIC->database();
        $objectives = [];
        $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

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

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

Referenced by __construct().

                                            : void
    {
        $query = 'SELECT assignment_id FROM loc_tst_assignments ' .
            'WHERE container_id = ' . $this->db->quote($this->getContainerId(), 'integer');
        $res = $this->db->query($query);
        while ($row = $res->fetchRow(ilDBConstants::FETCHMODE_OBJECT)) {
            $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,
		int	$a_objective_id
	)

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

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

                                                                   : void
    {
        foreach ($this->getAssignments() as $assignment) {
            if ($assignment->getObjectiveId() != $a_objective_id) {
                continue;
            }
            $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

array ilLOTestAssignments::$assignments = []

private

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

Referenced by getAssignments().

$container_id

int ilLOTestAssignments::$container_id = 0

private

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

Referenced by getContainerId().

$db

ilDBInterface ilLOTestAssignments::$db

protected

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

$instances

array ilLOTestAssignments::$instances = []

staticprivate

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

$settings

ilLOSettings ilLOTestAssignments::$settings

private

Definition at line 33 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