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

Inheritance diagram for ilObjAssessmentFolder:

Collaboration diagram for ilObjAssessmentFolder:

Public Member Functions
	__construct (int $a_id=0, bool $a_call_by_reference=true)

	_enableAssessmentLogging (bool $a_enable)

	_setLogLanguage (string $a_language)

	_setForbiddenQuestionTypes (array $typeIds)
	Sets the forbidden questiontypes for ILIAS. More...

	_setManualScoring (array $type_ids)
	Set the manual scoring settings. More...

	getNrOfLogEntries (int $test_obj_id)
	Returns the number of log entries for a given test id. More...

	deleteLogEntries (array $a_array)
	Deletes the log entries for a given array of test object IDs. More...

	getAssessmentProcessLockMode ()

	setAssessmentProcessLockMode (string $lockMode)

	getSkillTriggeringNumAnswersBarrier ()

	setSkillTriggeringNumAnswersBarrier (int $skillTriggeringNumAnswersBarrier)

	setExportEssayQuestionsWithHtml (bool $value)

	getExportEssayQuestionsWithHtml ()

	fetchScoringAdjustableTypes (array $allQuestionTypes)

Public Member Functions inherited from ilObject
	__construct (int $id=0, bool $reference=true)

	withReferences ()
	determines whether objects are referenced or not (got ref ids or not) More...

	processAutoRating ()

	read ()

	getId ()

	setId (int $id)

	setRefId (int $ref_id)

	getRefId ()

	getType ()

	setType (string $type)

	getPresentationTitle ()
	get presentation title Normally same as title Overwritten for sessions More...

	getTitle ()

	getUntranslatedTitle ()
	Get untranslated object title WebDAV needs to access the untranslated title of an object. More...

	setTitle (string $title)

	getDescription ()

	setDescription (string $desc)

	getLongDescription ()
	get object long description (stored in object_description) More...

	getImportId ()

	setImportId (string $import_id)

	setOfflineStatus (bool $status)

	getOfflineStatus ()

	supportsOfflineHandling ()

	getOwner ()

	getOwnerName ()
	get full name of object owner More...

	setOwner (int $usr_id)

	getCreateDate ()
	Get create date in YYYY-MM-DD HH-MM-SS format. More...

	getLastUpdateDate ()
	Get last update date in YYYY-MM-DD HH-MM-SS format. More...

	create ()
	note: title, description and type should be set when this function is called More...

	update ()

	MDUpdateListener (string $element)
	Metadata update listener. More...

	createMetaData ()

	updateMetaData ()

	deleteMetaData ()

	updateOwner ()
	update owner of object in db More...

	putInTree (int $parent_ref_id)
	maybe this method should be in tree object!? More...

	setPermissions (int $parent_ref_id)

	setParentRolePermissions (int $parent_ref_id)
	Initialize the permissions of parent roles (local roles of categories, global roles...) This method is overwritten in e.g. More...

	createReference ()
	creates reference for object More...

	countReferences ()

	delete ()
	delete object or referenced object (in the case of a referenced object, object data is only deleted if last reference is deleted) This function removes an object entirely from system!! More...

	initDefaultRoles ()
	init default roles settings Purpose of this function is to create a local role folder and local roles, that are needed depending on the object type. More...

	applyDidacticTemplate (int $tpl_id)

	getXMLZip ()

	getHTMLDirectory ()

	appendCopyInfo (int $target_id, int $copy_id)
	Prepend Copy info if object with same name exists in that container. More...

	cloneDependencies (int $target_id, int $copy_id)
	Clone object dependencies. More...

	cloneMetaData (ilObject $target_obj)
	Copy meta data. More...

	selfOrParentWithRatingEnabled ()

	getPossibleSubObjects (bool $filter=true)
	get all possible sub objects of this type the object can decide which types of sub objects are possible jut in time overwrite if the decision distinguish from standard model More...

Static Public Member Functions
static	getSkillTriggerAnswerNumberBarrier ()

static	_enabledAssessmentLogging ()

static	_getForbiddenQuestionTypes ()
	Returns the forbidden questiontypes for ILIAS. More...

static	_getLogLanguage ()

static	_mananuallyScoreableQuestionTypesExists ()
	Returns the fact wether manually scoreable question types exist or not. More...

static	_getManualScoring ()
	Retrieve the manual scoring settings. More...

static	_getManualScoringTypes ()
	Retrieve the manual scoring settings as type strings. More...

static	getScoringAdjustableQuestions ()

static	setScoringAdjustableQuestions (array $type_ids)

static	getScoringAdjustmentEnabled ()

static	setScoringAdjustmentEnabled (bool $active)

static	_addLog ( $user_id, $object_id, $logtext, $question_id=0, $original_id=0, $test_only=false, $test_ref_id=0)
	Add an assessment log entry. More...

static	getLog (int $ts_from, int $ts_to, int $test_id, bool $test_only=false)
	Retrieve assessment log datasets from the database. More...

static	_getLog (int $ts_from, int $ts_to, int $test_id, bool $test_only=false)
	Retrieve assessment log datasets from the database. More...

static	isAdditionalQuestionContentEditingModePageObjectEnabled ()
	Returns the fact wether content editing with ilias page editor is enabled for questions or not. More...

static	getValidAssessmentProcessLockModes ()

Static Public Member Functions inherited from ilObject
static	_lookupObjIdByImportId (string $import_id)
	Get (latest) object id for an import id. More...

static	_lookupImportId (int $obj_id)

static	_lookupOwnerName (int $owner_id)
	Lookup owner name for owner id. More...

static	_getIdForImportId (string $import_id)

static	_getAllReferences (int $id)
	get all reference ids for object ID More...

static	_lookupTitle (int $obj_id)

static	lookupOfflineStatus (int $obj_id)
	Lookup offline status using objectDataCache. More...

static	_lookupOwner (int $obj_id)
	Lookup owner user ID for object ID. More...

static	_getIdsForTitle (string $title, string $type='', bool $partial_match=false)

static	_lookupDescription (int $obj_id)

static	_lookupLastUpdate (int $obj_id, bool $formatted=false)

static	_getLastUpdateOfObjects (array $obj_ids)

static	_lookupObjId (int $ref_id)

static	_setDeletedDate (int $ref_id, int $deleted_by)

static	setDeletedDates (array $ref_ids, int $user_id)

static	_resetDeletedDate (int $ref_id)

static	_lookupDeletedDate (int $ref_id)

static	_writeTitle (int $obj_id, string $title)
	write title to db (static) More...

static	_writeDescription (int $obj_id, string $desc)
	write description to db (static) More...

static	_writeImportId (int $obj_id, string $import_id)
	write import id to db (static) More...

static	_lookupType (int $id, bool $reference=false)

static	_isInTrash (int $ref_id)

static	_hasUntrashedReference (int $obj_id)
	checks whether an object has at least one reference that is not in trash More...

static	_lookupObjectId (int $ref_id)

static	_getObjectsDataForType (string $type, bool $omit_trash=false)
	get all objects of a certain type More...

static	_exists (int $id, bool $reference=false, ?string $type=null)
	checks if an object exists in object_data More...

static	_getObjectsByType (string $obj_type="", int $owner=null)

static	_prepareCloneSelection (array $ref_ids, string $new_type, bool $show_path=true)
	Prepare copy wizard object selection. More...

static	_getIcon (int $obj_id=0, string $size="big", string $type="", bool $offline=false)
	Get icon for repository item. More...

static	collectDeletionDependencies (array &$deps, int $ref_id, int $obj_id, string $type, int $depth=0)
	Collect deletion dependencies. More...

static	getDeletionDependencies (int $obj_id)
	Get deletion dependencies. More...

static	getLongDescriptions (array $obj_ids)

static	getAllOwnedRepositoryObjects (int $user_id)

static	fixMissingTitles ($type, array &$obj_title_map)
	Try to fix missing object titles. More...

static	_lookupCreationDate (int $obj_id)

static	_getObjectTypeIdByTitle (string $type, \ilDBInterface $ilDB=null)

Data Fields
const	ADDITIONAL_QUESTION_CONTENT_EDITING_MODE_PAGE_OBJECT_DISABLED = 0

const	ADDITIONAL_QUESTION_CONTENT_EDITING_MODE_PAGE_OBJECT_ENABLED = 1

const	ASS_PROC_LOCK_MODE_NONE = 'none'

const	ASS_PROC_LOCK_MODE_FILE = 'file'

const	ASS_PROC_LOCK_MODE_DB = 'db'

const	DEFAULT_SKL_TRIG_NUM_ANSWERS_BARRIER = 1

ilSetting	$setting

Data Fields inherited from ilObject
const	TITLE_LENGTH = 255

const	DESC_LENGTH = 128

const	LONG_DESC_LENGTH = 4000

const	TABLE_OBJECT_DATA = "object_data"

array	$objectList

string	$untranslatedTitle

Private Member Functions
	questionSupportsScoringAdjustment (assQuestionGUI $question_object)

Private Attributes
const	SETTINGS_KEY_SKL_TRIG_NUM_ANSWERS_BARRIER = 'ass_skl_trig_num_answ_barrier'

Additional Inherited Members
Protected Member Functions inherited from ilObject
	doMDUpdateListener (string $a_element)

	beforeMDUpdateListener (string $a_element)

	doCreateMetaData ()

	beforeCreateMetaData ()

	doUpdateMetaData ()

	beforeUpdateMetaData ()

	doDeleteMetaData ()

	beforeDeleteMetaData ()

	handleAutoRating ()

	hasAutoRating ()

Protected Attributes inherited from ilObject
ilLogger	$obj_log

ILIAS	$ilias

ilObjectDefinition	$obj_definition

ilDBInterface	$db

ilLogger	$log

ilErrorHandling	$error

ilTree	$tree

ilAppEventHandler	$app_event_handler

ilRbacAdmin	$rbac_admin

ilRbacReview	$rbac_review

ilObjUser	$user

ilLanguage	$lng

int	$id

bool	$referenced

bool	$call_by_reference

int	$max_title = self::TITLE_LENGTH

int	$max_desc = self::DESC_LENGTH

bool	$add_dots = true

int	$ref_id = null

string	$type = ""

string	$title = ""

bool	$offline = false

string	$desc = ""

string	$long_desc = ""

int	$owner = 0

string	$create_date = ""

string	$last_update = ""

string	$import_id = ""

bool	$register = false

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 Class ilObjAssessmentFolder

Author: Helmut Schottmüller hscho.nosp@m.ttm@.nosp@m.gmx.d.nosp@m.e; Björn Heyser bheys.nosp@m.er@d.nosp@m.ataba.nosp@m.y.de

Definition at line 27 of file class.ilObjAssessmentFolder.php.

Constructor & Destructor Documentation

◆ __construct()

ilObjAssessmentFolder::__construct	(	int	$id = `0`,
		bool	$reference = `true`
	)

Parameters

int	$id	reference_id or object_id
bool	$reference	bool treat the id as reference_id (true) or object_id (false)

Reimplemented from ilObject.

Definition at line 41 of file class.ilObjAssessmentFolder.php.

    {
        $this->setting = new ilSetting('assessment');
        $this->type = 'assf';
        parent::__construct($a_id, $a_call_by_reference);
    }

References ILIAS\GlobalScreen\Provider\__construct().

Here is the call graph for this function:

Member Function Documentation

◆ _addLog()

static ilObjAssessmentFolder::_addLog	(	$user_id,
		$object_id,
		$logtext,
		$question_id = `0`,
		$original_id = `0`,
		$test_only = `false`,
		$test_ref_id = `0`
	)

static

Add an assessment log entry.

Parameters

int	$user_id	The user id of the acting user
int	$object_id	The database id of the modified test object
string	$logtext	The textual description for the log entry
int	$question_id	The database id of a modified question (optional)
int	$original_id	The database id of the original of a modified question (optional)
bool	$test_only
int	$test_ref_id

Definition at line 230 of file class.ilObjAssessmentFolder.php.

     : void {
        global $DIC;
        $ilUser = $DIC['ilUser'];
        $ilDB = $DIC['ilDB'];
 
        $db_question_id = 0;
        if (is_numeric($question_id)) {
            $db_question_id = (int) $question_id;
        }
 
        $db_original_id = 0;
        if (is_numeric($original_id)) {
            $db_original_id = (int) $original_id;
        }
 
        $db_test_ref_id = 0;
        if (is_numeric($test_ref_id)) {
            $db_test_ref_id = (int) $test_ref_id;
        }
 
        $only = ($test_only === true) ? 1 : 0;
        $next_id = $ilDB->nextId('ass_log');
        $affectedRows = $ilDB->manipulateF(
            "INSERT INTO ass_log (ass_log_id, user_fi, obj_fi, logtext, question_fi, original_fi, test_only, ref_id, tstamp) VALUES (%s, %s, %s, %s, %s, %s, %s, %s, %s)",
            ['integer', 'integer', 'integer', 'text', 'integer', 'integer', 'text', 'integer', 'integer'],
            [
                $next_id,
                $user_id,
                $object_id,
                $logtext,
                $db_question_id,
                $db_original_id,
                $only,
                $db_test_ref_id,
                time()
            ]
        );
    }

References ILIAS\Repository\int().

Referenced by ilObjTest\logAction(), assQuestion\logAction(), ilTestPasswordChecker\logWrongEnteredPassword(), and ilTestPassFinishTasks\updateLearningProgressAfterPassFinishedIsWritten().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _enableAssessmentLogging()

ilObjAssessmentFolder::_enableAssessmentLogging ( bool $a_enable )

Definition at line 58 of file class.ilObjAssessmentFolder.php.

                                                            : void
    {
        $setting = new ilSetting('assessment');
 
        $setting->set('assessment_logging', (string) ((int) $a_enable));
    }

References $setting, and ilSetting\set().

Here is the call graph for this function:

◆ _enabledAssessmentLogging()

static ilObjAssessmentFolder::_enabledAssessmentLogging ( )

static

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

                                                      : bool
    {
        $setting = new ilSetting('assessment');
 
        return (bool) $setting->get('assessment_logging', '0');
    }

References $setting, and ilSetting\get().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _getForbiddenQuestionTypes()

static ilObjAssessmentFolder::_getForbiddenQuestionTypes ( )

static

Returns the forbidden questiontypes for ILIAS.

Returns: int[]

Definition at line 83 of file class.ilObjAssessmentFolder.php.

                                                       : array
    {
        $setting = new ilSetting('assessment');
        $types = $setting->get('forbidden_questiontypes', '');
        $result = [];
 
        if ($types === '') {
            $result = [];
        } else {
            $result = unserialize($types, ['allowed_classes' => false]);
        }
 
        return array_filter(array_map('intval', $result));
    }

References $setting, and ilSetting\get().

Referenced by ilObjQuestionPool\_getQuestionTypes().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _getLog()

static ilObjAssessmentFolder::_getLog	(	int	$ts_from,
		int	$ts_to,
		int	$test_id,
		bool	$test_only = `false`
	)

static

Retrieve assessment log datasets from the database.

Parameters

int	$ts_from	Timestamp of the starting date/time period
int	$ts_to	Timestamp of the ending date/time period
integer	$test_id	Database id of the ILIAS test object

Returns: array<string, mixed>[] Array containing the datasets between $ts_from and $ts_to for the test with the id $test_id

Definition at line 336 of file class.ilObjAssessmentFolder.php.

                                                                                                   : array
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $log = [];
        if ($test_only === true) {
            $result = $ilDB->queryF(
                "SELECT * FROM ass_log WHERE obj_fi = %s AND tstamp > %s AND tstamp < %s AND test_only = %s ORDER BY tstamp",
                ['integer', 'integer', 'integer', 'text'],
                [$test_id, $ts_from, $ts_to, 1]
            );
        } else {
            $result = $ilDB->queryF(
                "SELECT * FROM ass_log WHERE obj_fi = %s AND tstamp > %s AND tstamp < %s ORDER BY tstamp",
                ['integer', 'integer', 'integer'],
                [$test_id, $ts_from, $ts_to]
            );
        }
        while ($row = $ilDB->fetchAssoc($result)) {
            if (!array_key_exists($row["tstamp"], $log)) {
                $log[$row["tstamp"]] = [];
            }
            $type_href = "";
            if (array_key_exists("ref_id", $row) && $row["ref_id"] > 0) {
                $type = ilObject::_lookupType((int) $row['ref_id'], true);
                switch ($type) {
                    case "tst":
                        $type_href = sprintf("goto.php?target=tst_%s&amp;client_id=" . CLIENT_ID, $row["ref_id"]);
                        break;
                    case "cat":
                        $type_href = sprintf("goto.php?target=cat_%s&amp;client_id=" . CLIENT_ID, $row["ref_id"]);
                        break;
                }
            }
            $row["href"] = $type_href;
            $log[$row["tstamp"]][] = $row;
        }
        krsort($log);
        // flatten array
        $log_array = [];
        foreach ($log as $key => $value) {
            foreach ($value as $index => $row) {
                $log_array[] = $row;
            }
        }
        return $log_array;
    }

References $DIC, $ilDB, $index, ILIAS\LTI\ToolProvider\$key, $log, $type, ilObject\_lookupType(), and CLIENT_ID.

Referenced by ilObjTestGUI\historyObject().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _getLogLanguage()

static ilObjAssessmentFolder::_getLogLanguage ( )

static

Definition at line 114 of file class.ilObjAssessmentFolder.php.

                                            : string
    {
        $setting = new ilSetting('assessment');
 
        $lang = $setting->get('assessment_log_language', '');
        if ($lang === '') {
            $lang = 'en';
        }
 
        return $lang;
    }

References $lang, $setting, and ilSetting\get().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _getManualScoring()

static ilObjAssessmentFolder::_getManualScoring ( )

static

Retrieve the manual scoring settings.

Returns: int[]

Definition at line 139 of file class.ilObjAssessmentFolder.php.

                                              : array
    {
        $setting = new ilSetting('assessment');
 
        $types = $setting->get('assessment_manual_scoring', '');
        return array_filter(array_map('intval', explode(',', $types)));
    }

References $setting, and ilSetting\get().

Referenced by ilTestService\getManScoringQuestionGuiList(), ilTestServiceGUI\getPassListOfAnswersWithScoring(), ilObjTest\getTestParticipantsForManualScoring(), ilTestManScoringParticipantsBySelectedQuestionAndPassTableGUI\initFilter(), and ilTestTabsManager\setupTabsGuiConfig().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _getManualScoringTypes()

static ilObjAssessmentFolder::_getManualScoringTypes ( )

static

Retrieve the manual scoring settings as type strings.

Returns: string[]

Definition at line 151 of file class.ilObjAssessmentFolder.php.

                                                   : array
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $setting = new ilSetting('assessment');
        $typeIds = array_filter(array_map('intval', explode(',', $setting->get('assessment_manual_scoring', ''))));
        $manualScoringTypes = [];
 
        $result = $ilDB->query('SELECT question_type_id, type_tag FROM qpl_qst_type');
        while ($row = $ilDB->fetchAssoc($result)) {
            if (in_array((int) $row['question_type_id'], $typeIds, true)) {
                $manualScoringTypes[] = $row['type_tag'];
            }
        }
        return array_filter($manualScoringTypes);
    }

References $DIC, $ilDB, $setting, and ilSetting\get().

Referenced by assQuestion\_needsManualScoring().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _mananuallyScoreableQuestionTypesExists()

static ilObjAssessmentFolder::_mananuallyScoreableQuestionTypesExists ( )

static

Returns the fact wether manually scoreable question types exist or not.

Definition at line 130 of file class.ilObjAssessmentFolder.php.

                                                                    : bool
    {
        return count(self::_getManualScoring()) > 0;
    }

Referenced by ilTestScoringGUI\executeCommand().

Here is the caller graph for this function:

◆ _setForbiddenQuestionTypes()

ilObjAssessmentFolder::_setForbiddenQuestionTypes ( array $typeIds )

Sets the forbidden questiontypes for ILIAS.

Parameters

int[] $typeIds An array containing the database ID's of the forbidden question types

Definition at line 102 of file class.ilObjAssessmentFolder.php.

                                                              : void
    {
        $setting = new ilSetting('assessment');
 
        $types = '';
        if ($typeIds !== []) {
            $types = serialize(array_map('intval', $typeIds));
        }
 
        $setting->set('forbidden_questiontypes', $types);
    }

References $setting, and ilSetting\set().

Here is the call graph for this function:

◆ _setLogLanguage()

ilObjAssessmentFolder::_setLogLanguage ( string $a_language )

Definition at line 65 of file class.ilObjAssessmentFolder.php.

                                                       : void
    {
        $setting = new ilSetting('assessment');
 
        $setting->set('assessment_log_language', $a_language);
    }

References $setting, and ilSetting\set().

Here is the call graph for this function:

◆ _setManualScoring()

ilObjAssessmentFolder::_setManualScoring ( array $type_ids )

Set the manual scoring settings.

Parameters

int[] $type_ids An array containing the database ids of the question types which could be scored manually

Definition at line 173 of file class.ilObjAssessmentFolder.php.

                                                      : void
    {
        $setting = new ilSetting('assessment');
        if ($type_ids === []) {
            $setting->delete('assessment_manual_scoring');
        } else {
            $setting->set('assessment_manual_scoring', implode(',', $type_ids));
        }
    }

References $setting, ilSetting\delete(), and ilSetting\set().

Here is the call graph for this function:

◆ deleteLogEntries()

ilObjAssessmentFolder::deleteLogEntries ( array $a_array )

Deletes the log entries for a given array of test object IDs.

Parameters

int[] $a_array An array containing the object IDs of the tests

Definition at line 412 of file class.ilObjAssessmentFolder.php.

                                                    : void
    {
        global $DIC;
        $ilDB = $DIC->database();
        $ilUser = $DIC->user();
 
        foreach ($a_array as $object_id) {
            $affectedRows = $ilDB->manipulateF(
                "DELETE FROM ass_log WHERE obj_fi = %s",
                ['integer'],
                [$object_id]
            );
            self::_addLog($ilUser->getId(), $object_id, $this->lng->txt("assessment_log_deleted"));
        }
    }

References $DIC, $ilDB, and $ilUser.

◆ fetchScoringAdjustableTypes()

ilObjAssessmentFolder::fetchScoringAdjustableTypes ( array $allQuestionTypes )

Parameters

array<string,array{question_type_id int, type_tag: string, plugin: int, plugin_name: string|null}> $allQuestionTypes

Returns: array<string, array{question_type_id: int, type_tag: string, plugin: int, plugin_name: string|null}>

Exceptions

ilTestQuestionPoolInvalidArgumentException

Definition at line 494 of file class.ilObjAssessmentFolder.php.

                                                                        : array
    {
        $scoringAdjustableQuestionTypes = [];
 
        foreach ($allQuestionTypes as $type => $typeData) {
            $questionGui = assQuestionGUI::_getQuestionGUI($typeData['type_tag']);
 
            if ($this->questionSupportsScoringAdjustment($questionGui)) {
                $scoringAdjustableQuestionTypes[$type] = $typeData;
            }
        }
 
        return $scoringAdjustableQuestionTypes;
    }

References $type, and assQuestionGUI\_getQuestionGUI().

Here is the call graph for this function:

◆ getAssessmentProcessLockMode()

ilObjAssessmentFolder::getAssessmentProcessLockMode ( )

Definition at line 444 of file class.ilObjAssessmentFolder.php.

                                                  : string
    {
        return $this->setting->get('ass_process_lock_mode', self::ASS_PROC_LOCK_MODE_NONE);
    }

◆ getExportEssayQuestionsWithHtml()

ilObjAssessmentFolder::getExportEssayQuestionsWithHtml ( )

Definition at line 484 of file class.ilObjAssessmentFolder.php.

                                                     : bool
    {
        return (bool) $this->setting->get('export_essay_qst_with_html', '0');
    }

◆ getLog()

static ilObjAssessmentFolder::getLog	(	int	$ts_from,
		int	$ts_to,
		int	$test_id,
		bool	$test_only = `false`
	)

static

Retrieve assessment log datasets from the database.

Parameters

int	$ts_from	Timestamp of the starting date/time period
int	$ts_to	Timestamp of the ending date/time period
int	$test_id	Database id of the ILIAS test object

Returns: array<string, mixed>[] Array containing the datasets between $ts_from and $ts_to for the test with the id $test_id

Definition at line 284 of file class.ilObjAssessmentFolder.php.

                                                                                                  : array
    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $log = [];
        if ($test_only === true) {
            $result = $ilDB->queryF(
                "SELECT * FROM ass_log WHERE obj_fi = %s AND tstamp > %s AND tstamp < %s AND test_only = %s ORDER BY tstamp",
                ['integer', 'integer', 'integer', 'text'],
                [
                    $test_id,
                    $ts_from,
                    $ts_to,
                    1
                ]
            );
        } else {
            $result = $ilDB->queryF(
                "SELECT * FROM ass_log WHERE obj_fi = %s AND tstamp > %s AND tstamp < %s ORDER BY tstamp",
                ['integer', 'integer', 'integer'],
                [
                    $test_id,
                    $ts_from,
                    $ts_to
                ]
            );
        }
        while ($row = $ilDB->fetchAssoc($result)) {
            if (!array_key_exists($row["tstamp"], $log)) {
                $log[$row["tstamp"]] = [];
            }
            $log[$row["tstamp"]][] = $row;
        }
        krsort($log);
        // flatten array
        $log_array = [];
        foreach ($log as $key => $value) {
            foreach ($value as $index => $row) {
                $log_array[] = $row;
            }
        }
        return $log_array;
    }

References $DIC, $ilDB, $index, ILIAS\LTI\ToolProvider\$key, and $log.

Referenced by ilObjAssessmentFolderGUI\exportLogObject().

Here is the caller graph for this function:

◆ getNrOfLogEntries()

ilObjAssessmentFolder::getNrOfLogEntries ( int $test_obj_id )

Returns the number of log entries for a given test id.

Parameters

int $test_obj_id Database id of the ILIAS test object

Returns: int The number of log entries for the test object

Definition at line 390 of file class.ilObjAssessmentFolder.php.

                                                       : int
    {
        global $DIC;
        $ilDB = $DIC->database();
 
        $result = $ilDB->queryF(
            "SELECT COUNT(obj_fi) logcount FROM ass_log WHERE obj_fi = %s",
            ['integer'],
            [$test_obj_id]
        );
        if ($result->numRows()) {
            $row = $ilDB->fetchAssoc($result);
            return (int) $row["logcount"];
        }
 
        return 0;
    }

References $DIC, and $ilDB.

◆ getScoringAdjustableQuestions()

static ilObjAssessmentFolder::getScoringAdjustableQuestions ( )

static

Returns: int[]

Definition at line 186 of file class.ilObjAssessmentFolder.php.

                                                          : array
    {
        $setting = new ilSetting('assessment');
 
        $types = $setting->get('assessment_scoring_adjustment', '');
        return array_filter(array_map('intval', explode(',', $types)));
    }

References $setting, and ilSetting\get().

Here is the call graph for this function:

◆ getScoringAdjustmentEnabled()

static ilObjAssessmentFolder::getScoringAdjustmentEnabled ( )

static

Definition at line 208 of file class.ilObjAssessmentFolder.php.

                                                        : bool
    {
        $setting = new ilSetting('assessment');
        return (bool) $setting->get('assessment_adjustments_enabled', '0');
    }

References $setting, and ilSetting\get().

Here is the call graph for this function:

◆ getSkillTriggerAnswerNumberBarrier()

static ilObjAssessmentFolder::getSkillTriggerAnswerNumberBarrier ( )

static

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

                                                               : int
    {
        $assSettings = new ilSetting('assessment');
 
        return (int) $assSettings->get(
            self::SETTINGS_KEY_SKL_TRIG_NUM_ANSWERS_BARRIER,
            (string) self::DEFAULT_SKL_TRIG_NUM_ANSWERS_BARRIER
        );
    }

Referenced by ilTestInfoScreenToolbarGUI\getSkillAssignBarrierInfo(), and ilAssQuestionSkillAssignmentList\hasSkillsAssignedLowerThanBarrier().

Here is the caller graph for this function:

◆ getSkillTriggeringNumAnswersBarrier()

ilObjAssessmentFolder::getSkillTriggeringNumAnswersBarrier ( )

Definition at line 466 of file class.ilObjAssessmentFolder.php.

                                                         : string
    {
        return $this->setting->get(
            'ass_skl_trig_num_answ_barrier',
            (string) self::DEFAULT_SKL_TRIG_NUM_ANSWERS_BARRIER
        );
    }

◆ getValidAssessmentProcessLockModes()

static ilObjAssessmentFolder::getValidAssessmentProcessLockModes ( )

static

Returns: string[]

Definition at line 457 of file class.ilObjAssessmentFolder.php.

                                                               : array
    {
        return [
            self::ASS_PROC_LOCK_MODE_NONE,
            self::ASS_PROC_LOCK_MODE_FILE,
            self::ASS_PROC_LOCK_MODE_DB
        ];
    }

Referenced by ilObjAssessmentFolderGUI\saveSettingsObject().

Here is the caller graph for this function:

◆ isAdditionalQuestionContentEditingModePageObjectEnabled()

static ilObjAssessmentFolder::isAdditionalQuestionContentEditingModePageObjectEnabled ( )

static

Returns the fact wether content editing with ilias page editor is enabled for questions or not.

Definition at line 431 of file class.ilObjAssessmentFolder.php.

                                                                                    : bool
    {
        global $DIC;
        $ilSetting = $DIC->settings();
 
        $isPageEditorEnabled = $ilSetting->get(
            'enable_tst_page_edit',
            (string) self::ADDITIONAL_QUESTION_CONTENT_EDITING_MODE_PAGE_OBJECT_DISABLED
        );
 
        return (bool) $isPageEditorEnabled;
    }

References $DIC, and $ilSetting.

Referenced by ilTestExpressPageObjectGUI\addQuestion(), ilObjTestGUI\addQuestionObject(), ilObjQuestionPoolGUI\buildCreateQuestionForm(), ilObjQuestionPoolGUI\createQuestionFormObject(), ilObjQuestionPoolGUI\createQuestionForTestObject(), ilObjTestGUI\createQuestionObject(), ilObjQuestionPoolGUI\createQuestionObject(), ilPCQuestionGUI\edit(), ilTestExpressPageObjectGUI\handleToolbarCommand(), and ilPCQuestionGUI\insert().

Here is the caller graph for this function:

◆ questionSupportsScoringAdjustment()

ilObjAssessmentFolder::questionSupportsScoringAdjustment ( assQuestionGUI $question_object )

private

Definition at line 509 of file class.ilObjAssessmentFolder.php.

                                                                                       : bool
    {
        return (
            $question_object instanceof ilGuiQuestionScoringAdjustable ||
            $question_object instanceof ilGuiAnswerScoringAdjustable
        ) && (
            $question_object->object instanceof ilObjQuestionScoringAdjustable ||
            $question_object->object instanceof ilObjAnswerScoringAdjustable
        );
    }

◆ setAssessmentProcessLockMode()

ilObjAssessmentFolder::setAssessmentProcessLockMode ( string $lockMode )

Definition at line 449 of file class.ilObjAssessmentFolder.php.

                                                                  : void
    {
        $this->setting->set('ass_process_lock_mode', $lockMode);
    }

◆ setExportEssayQuestionsWithHtml()

ilObjAssessmentFolder::setExportEssayQuestionsWithHtml ( bool $value )

Definition at line 479 of file class.ilObjAssessmentFolder.php.

                                                                : void
    {
        $this->setting->set('export_essay_qst_with_html', (string) ((int) $value));
    }

◆ setScoringAdjustableQuestions()

static ilObjAssessmentFolder::setScoringAdjustableQuestions ( array $type_ids )

static

Parameters

int[] $type_ids

Returns: void

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

                                                                         : void
    {
        $setting = new ilSetting('assessment');
        if ($type_ids === []) {
            $setting->delete('assessment_scoring_adjustment');
        } else {
            $setting->set('assessment_scoring_adjustment', implode(',', $type_ids));
        }
    }

References $setting, ilSetting\delete(), and ilSetting\set().

Here is the call graph for this function:

◆ setScoringAdjustmentEnabled()

static ilObjAssessmentFolder::setScoringAdjustmentEnabled ( bool $active )

static

Definition at line 214 of file class.ilObjAssessmentFolder.php.

                                                                    : void
    {
        $setting = new ilSetting('assessment');
        $setting->set('assessment_adjustments_enabled', (string) ((int) $active));
    }

References $setting, and ilSetting\set().

Here is the call graph for this function:

◆ setSkillTriggeringNumAnswersBarrier()

ilObjAssessmentFolder::setSkillTriggeringNumAnswersBarrier ( int $skillTriggeringNumAnswersBarrier )

Definition at line 474 of file class.ilObjAssessmentFolder.php.

                                                                                              : void
    {
        $this->setting->set('ass_skl_trig_num_answ_barrier', (string) $skillTriggeringNumAnswersBarrier);
    }