Settings for LO courses. 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

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

Constructor & Destructor Documentation

◆ __construct()

ilLOTestAssignments::__construct ( int $a_container_id )

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

    {
        global $DIC;
 
        $this->db = $DIC->database();
 
        $this->container_id = $a_container_id;
        $this->settings = ilLOSettings::getInstanceByObjId($a_container_id);
        $this->readTestAssignments();
    }

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

Here is the call graph for this function:

Member Function Documentation

◆ deleteByContainer()

static ilLOTestAssignments::deleteByContainer ( int $a_container_id )

static

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

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

References $DIC, and $ilDB.

◆ getAssignmentByObjective()

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

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

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

Referenced by getTestByObjective().

Here is the caller graph for this function:

◆ getAssignments()

ilLOTestAssignments::getAssignments ( )

Get assignments.

Returns: ilLOTestAssignment[]

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

                                    : array
    {
        return $this->assignments;
    }

References $assignments.

Referenced by toXml().

Here is the caller graph for this function:

◆ getAssignmentsByType()

ilLOTestAssignments::getAssignmentsByType ( int $a_type )

Get assignments by type.

Returns: ilLOTestAssignment[]

Definition at line 105 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 72 of file class.ilLOTestAssignments.php.

                                    : int
    {
        return $this->container_id;
    }

References $container_id.

Referenced by readTestAssignments().

Here is the caller graph for this function:

◆ getInstance()

static ilLOTestAssignments::getInstance ( int $a_container_id )

static

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

                                                           : 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);
    }

Referenced by ILIAS\Container\Content\ItemBlock\ItemBlockSequenceGenerator\__construct(), ilLOEditorStatus\__construct(), ilLOTestQuestionAdapter\__construct(), ilCourseObjectiveMaterials\_getAssignableMaterials(), ilLOMemberTestResultTableGUI\createTestResultLink(), ilLOEditorGUI\deleteAssignments(), ilLOTestAssignmentForm\getAssignableTests(), ilTestLearningObjectivesStatusGUI\getUsersObjectivesStatus(), ilCourseObjective\ilClone(), ilLOTestAssignmentForm\initForm(), ilContainerObjectiveGUI\initTestAssignments(), ilLOUtils\lookupMaxAttempts(), ilLOTestQuestionAdapter\lookupRelevantObjectiveIdsForTest(), ilCourseObjectivesTableGUI\parse(), ilContainerObjectiveGUI\parseLOUserResults(), ILIAS\Containter\Content\ObjectiveRenderer\parseLOUserResults(), ilLOTestAssignmentTableGUI\parseMultipleAssignments(), ilCourseObjectiveResult\reset(), ilTestLP\resetCustomLPDataForUserIds(), ilContainerObjectiveGUI\showMaterials(), and ilCourseObjective\toXml().

Here is the caller graph for this function:

◆ getSettings()

ilLOTestAssignments::getSettings ( )

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

                                 : ilLOSettings
    {
        return $this->settings;
    }

References $settings.

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

Here is the caller graph for this function:

◆ getTestByObjective()

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

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

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

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

Referenced by ilLOTestQuestionAdapter\lookupRelevantObjectiveIdsForTest().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getTests()

ilLOTestAssignments::getTests ( )

Returns: int[]

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

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

References getSettings().

Here is the call graph for this function:

◆ getTypeByTest()

ilLOTestAssignments::getTypeByTest ( int $a_test_ref_id )

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

                                                     : 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 && $assignment->getAssignmentType() == ilLOSettings::TYPE_TEST_INITIAL) {
                    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 && $assignment->getAssignmentType() == ilLOSettings::TYPE_TEST_QUALIFIED) {
                    return ilLOSettings::TYPE_TEST_QUALIFIED;
                }
            }
        }
        return ilLOSettings::TYPE_TEST_UNDEFINED;
    }

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

Referenced by ilLOTestQuestionAdapter\lookupRelevantObjectiveIdsForTest().

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

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

References getSettings().

Here is the call graph for this function:

◆ lookupContainerForTest()

static ilLOTestAssignments::lookupContainerForTest ( int $a_test_ref_id )

static

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

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

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

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

Here is the caller graph for this function:

◆ lookupObjectivesForTest()

static ilLOTestAssignments::lookupObjectivesForTest ( int $a_test_ref_id )

static

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

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

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

Referenced by ilTestLP\resetCustomLPDataForUserIds().

Here is the caller graph for this function:

◆ readTestAssignments()

ilLOTestAssignments::readTestAssignments ( )

protected

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

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

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

Referenced by __construct().

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

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