Collaboration diagram for ilAssQuestionUserSolutionAdopter:

Public Member Functions
	__construct (private ilDBInterface $db, ilSetting $ass_settings)

	getUserId ()

	setUserId (int $user_id)

	getActiveId ()

	setActiveId (int $active_id)

	getTargetPass ()

	setTargetPass (int $target_pass)

	getQuestionIds ()

	setQuestionIds (array $question_ids)

	perform ()

Protected Member Functions
	adoptQuestionAnswer (int $question_id)

	resetTargetSolution (int $question_id)

	resetTargetResult (int $question_id)

	adoptSourceSolution (int $question_id)

	adoptSourceResult (int $question_id, int $source_pass)

	getPreparedDeleteSolutionRecordsStatement ()

	getPreparedSelectSolutionRecordsStatement ()

	getPreparedInsertSolutionRecordStatement ()

	getPreparedDeleteResultRecordStatement ()

	getPreparedSelectResultRecordStatement ()

	getPreparedInsertResultRecordStatement ()

Protected Attributes
int	$active_id = null

int	$target_pass = null

array	$question_ids = []

Static Protected Attributes
static ilDBStatement	$prepared_delete_solution_records_statement = null

static ilDBStatement	$prepared_select_solution_records_statement = null

static ilDBStatement	$prepared_insert_solution_record_statement = null

static ilDBStatement	$prepared_delete_result_record_statement = null

static ilDBStatement	$prepared_select_result_record_statement = null

static ilDBStatement	$prepared_insert_result_record_statement = null

Private Attributes
ilAssQuestionProcessLockerFactory	$process_locker_factory

int	$user_id = null

Detailed Description

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

Constructor & Destructor Documentation

◆ __construct()

ilAssQuestionUserSolutionAdopter::__construct	(	private ilDBInterface	$db,
		ilSetting	$ass_settings
	)

Definition at line 46 of file class.ilAssQuestionUserSolutionAdopter.php.

      {
        $this->process_locker_factory = new ilAssQuestionProcessLockerFactory($ass_settings, $db);
    }

Member Function Documentation

◆ adoptQuestionAnswer()

ilAssQuestionUserSolutionAdopter::adoptQuestionAnswer ( int $question_id )

protected

Definition at line 110 of file class.ilAssQuestionUserSolutionAdopter.php.

                                                            : void
    {
        $this->resetTargetSolution($question_id);
        $this->resetTargetResult($question_id);
 
        $source_pass = $this->adoptSourceSolution($question_id);
 
        if ($source_pass !== null) {
            $this->adoptSourceResult($question_id, $source_pass);
        }
    }

References adoptSourceResult(), adoptSourceSolution(), resetTargetResult(), and resetTargetSolution().

Referenced by perform().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ adoptSourceResult()

ilAssQuestionUserSolutionAdopter::adoptSourceResult	(	int	$question_id,
		int	$source_pass
	)

protected

Definition at line 165 of file class.ilAssQuestionUserSolutionAdopter.php.

                                                                            : void
    {
        $res = $this->db->execute(
            $this->getPreparedSelectResultRecordStatement(),
            [$this->getActiveId(), $question_id, $source_pass]
        );
 
        $row = $this->db->fetchAssoc($res);
 
        $result_id = $this->db->nextId('tst_test_result');
 
        $this->db->execute($this->getPreparedInsertResultRecordStatement(), [
            $result_id, $this->getActiveId(), $question_id, $this->getTargetPass(), time(),
            $row['points'], $row['manual'], $row['answered']
        ]);
    }

References $res, getActiveId(), getPreparedInsertResultRecordStatement(), getPreparedSelectResultRecordStatement(), and getTargetPass().

Referenced by adoptQuestionAnswer().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ adoptSourceSolution()

ilAssQuestionUserSolutionAdopter::adoptSourceSolution ( int $question_id )

protected

Definition at line 138 of file class.ilAssQuestionUserSolutionAdopter.php.

                                                            : ?int
    {
        $res = $this->db->execute(
            $this->getPreparedSelectSolutionRecordsStatement(),
            [$this->getActiveId(), $question_id, $this->getTargetPass()]
        );
 
        $source_pass = null;
 
        while ($row = $this->db->fetchAssoc($res)) {
            if ($source_pass === null) {
                $source_pass = $row['pass'];
            } elseif ($row['pass'] < $source_pass) {
                break;
            }
 
            $solution_id = $this->db->nextId('tst_solutions');
 
            $this->db->execute($this->getPreparedInsertSolutionRecordStatement(), [
                $solution_id, $this->getActiveId(), $question_id, $this->getTargetPass(), time(),
                $row['points'], $row['value1'], $row['value2']
            ]);
        }
 
        return $source_pass;
    }

References $res, getActiveId(), getPreparedInsertSolutionRecordStatement(), getPreparedSelectSolutionRecordsStatement(), and getTargetPass().

Referenced by adoptQuestionAnswer().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getActiveId()

ilAssQuestionUserSolutionAdopter::getActiveId ( )

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

                                 : ?int
    {
        return $this->active_id;
    }

References $active_id.

Referenced by adoptSourceResult(), adoptSourceSolution(), resetTargetResult(), and resetTargetSolution().

Here is the caller graph for this function:

◆ getPreparedDeleteResultRecordStatement()

ilAssQuestionUserSolutionAdopter::getPreparedDeleteResultRecordStatement ( )

protected

Definition at line 231 of file class.ilAssQuestionUserSolutionAdopter.php.

                                                               : ilDBStatement
    {
        if (self::$prepared_delete_result_record_statement === null) {
            self::$prepared_delete_result_record_statement = $this->db->prepareManip(
                "DELETE FROM tst_test_result WHERE active_fi = ? AND question_fi = ? AND pass = ?",
                ['integer', 'integer', 'integer']
            );
        }
 
        return self::$prepared_delete_result_record_statement;
    }

References $prepared_delete_result_record_statement.

Referenced by resetTargetResult().

Here is the caller graph for this function:

◆ getPreparedDeleteSolutionRecordsStatement()

ilAssQuestionUserSolutionAdopter::getPreparedDeleteSolutionRecordsStatement ( )

protected

Definition at line 182 of file class.ilAssQuestionUserSolutionAdopter.php.

                                                                  : ilDBStatement
    {
        if (self::$prepared_delete_solution_records_statement === null) {
            self::$prepared_delete_solution_records_statement = $this->db->prepareManip(
                "DELETE FROM tst_solutions WHERE active_fi = ? AND question_fi = ? AND pass = ?",
                ['integer', 'integer', 'integer']
            );
        }
 
        return self::$prepared_delete_solution_records_statement;
    }

References $prepared_delete_solution_records_statement.

Referenced by resetTargetSolution().

Here is the caller graph for this function:

◆ getPreparedInsertResultRecordStatement()

ilAssQuestionUserSolutionAdopter::getPreparedInsertResultRecordStatement ( )

protected

Definition at line 260 of file class.ilAssQuestionUserSolutionAdopter.php.

                                                               : ilDBStatement
    {
        if (self::$prepared_insert_result_record_statement === null) {
            $query = "
                                INSERT INTO tst_test_result (
                                        test_result_id, active_fi, question_fi, pass, tstamp,
                                        points, manual, answered
                                ) VALUES (
                                        ?, ?, ?, ?, ?, ?, ?, ?
                                )
                        ";
 
            self::$prepared_insert_result_record_statement = $this->db->prepareManip(
                $query,
                ['integer', 'integer', 'integer', 'integer', 'integer', 'integer', 'integer', 'integer']
            );
        }
 
        return self::$prepared_insert_result_record_statement;
    }

References $prepared_insert_result_record_statement.

Referenced by adoptSourceResult().

Here is the caller graph for this function:

◆ getPreparedInsertSolutionRecordStatement()

ilAssQuestionUserSolutionAdopter::getPreparedInsertSolutionRecordStatement ( )

protected

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

                                                                 : ilDBStatement
    {
        if (self::$prepared_insert_solution_record_statement === null) {
            $query = "
                                INSERT INTO tst_solutions (
                                        solution_id, active_fi, question_fi, pass, tstamp, points, value1, value2
                                ) VALUES (
                                        ?, ?, ?, ?, ?, ?, ?, ?
                                )
                        ";
 
            self::$prepared_insert_solution_record_statement = $this->db->prepareManip(
                $query,
                ['integer', 'integer', 'integer', 'integer', 'integer', 'integer', 'text', 'text']
            );
        }
 
        return self::$prepared_insert_solution_record_statement;
    }

References $prepared_insert_solution_record_statement.

Referenced by adoptSourceSolution().

Here is the caller graph for this function:

◆ getPreparedSelectResultRecordStatement()

ilAssQuestionUserSolutionAdopter::getPreparedSelectResultRecordStatement ( )

protected

Definition at line 243 of file class.ilAssQuestionUserSolutionAdopter.php.

                                                               : ilDBStatement
    {
        if (self::$prepared_select_result_record_statement === null) {
            $query = "
                                SELECT points, manual, answered FROM tst_test_result
                                WHERE active_fi = ? AND question_fi = ? AND pass = ?
                        ";
 
            self::$prepared_select_result_record_statement = $this->db->prepare(
                $query,
                ['integer', 'integer', 'integer']
            );
        }
 
        return self::$prepared_select_result_record_statement;
    }

References $prepared_select_result_record_statement.

Referenced by adoptSourceResult().

Here is the caller graph for this function:

◆ getPreparedSelectSolutionRecordsStatement()

ilAssQuestionUserSolutionAdopter::getPreparedSelectSolutionRecordsStatement ( )

protected

Definition at line 194 of file class.ilAssQuestionUserSolutionAdopter.php.

                                                                  : ilDBStatement
    {
        if (self::$prepared_select_solution_records_statement === null) {
            $query = "
                                SELECT pass, points, value1, value2 FROM tst_solutions
                                WHERE active_fi = ? AND question_fi = ? AND pass < ? ORDER BY pass DESC
                        ";
 
            self::$prepared_select_solution_records_statement = $this->db->prepare(
                $query,
                ['integer', 'integer', 'integer']
            );
        }
 
        return self::$prepared_select_solution_records_statement;
    }

References $prepared_select_solution_records_statement.

Referenced by adoptSourceSolution().

Here is the caller graph for this function:

◆ getQuestionIds()

ilAssQuestionUserSolutionAdopter::getQuestionIds ( )

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

                                    : array
    {
        return $this->question_ids;
    }

References $question_ids.

Referenced by perform().

Here is the caller graph for this function:

◆ getTargetPass()

ilAssQuestionUserSolutionAdopter::getTargetPass ( )

Definition at line 73 of file class.ilAssQuestionUserSolutionAdopter.php.

                                   : ?int
    {
        return $this->target_pass;
    }

References $target_pass.

Referenced by adoptSourceResult(), adoptSourceSolution(), resetTargetResult(), and resetTargetSolution().

Here is the caller graph for this function:

◆ getUserId()

ilAssQuestionUserSolutionAdopter::getUserId ( )

Definition at line 53 of file class.ilAssQuestionUserSolutionAdopter.php.

                               : ?int
    {
        return $this->user_id;
    }

References $user_id.

Referenced by perform().

Here is the caller graph for this function:

◆ perform()

ilAssQuestionUserSolutionAdopter::perform ( )

Definition at line 96 of file class.ilAssQuestionUserSolutionAdopter.php.

                             : void
    {
        $this->process_locker_factory->setUserId($this->getUserId());
 
        foreach ($this->getQuestionIds() as $question_id) {
            $this->process_locker_factory->setQuestionId($question_id);
            $processLocker = $this->process_locker_factory->getLocker();
 
            $processLocker->executeUserTestResultUpdateLockOperation(function () use ($question_id) {
                $this->adoptQuestionAnswer($question_id);
            });
        }
    }

References adoptQuestionAnswer(), getQuestionIds(), and getUserId().

Here is the call graph for this function:

◆ resetTargetResult()

ilAssQuestionUserSolutionAdopter::resetTargetResult ( int $question_id )

protected

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

                                                          : void
    {
        $this->db->execute(
            $this->getPreparedDeleteResultRecordStatement(),
            [$this->getActiveId(), $question_id, $this->getTargetPass()]
        );
    }

References getActiveId(), getPreparedDeleteResultRecordStatement(), and getTargetPass().

Referenced by adoptQuestionAnswer().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ resetTargetSolution()

ilAssQuestionUserSolutionAdopter::resetTargetSolution ( int $question_id )

protected

Definition at line 122 of file class.ilAssQuestionUserSolutionAdopter.php.

                                                            : void
    {
        $this->db->execute(
            $this->getPreparedDeleteSolutionRecordsStatement(),
            [$this->getActiveId(), $question_id, $this->getTargetPass()]
        );
    }

References getActiveId(), getPreparedDeleteSolutionRecordsStatement(), and getTargetPass().

Referenced by adoptQuestionAnswer().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setActiveId()

ilAssQuestionUserSolutionAdopter::setActiveId ( int $active_id )

Definition at line 68 of file class.ilAssQuestionUserSolutionAdopter.php.

                                               : void
    {
        $this->active_id = $active_id;
    }

References $active_id.

◆ setQuestionIds()

ilAssQuestionUserSolutionAdopter::setQuestionIds ( array $question_ids )

Parameters

array<int> $question_ids

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

                                                       : void
    {
        $this->question_ids = $question_ids;
    }

References $question_ids.

◆ setTargetPass()

ilAssQuestionUserSolutionAdopter::setTargetPass ( int $target_pass )

Definition at line 78 of file class.ilAssQuestionUserSolutionAdopter.php.

                                                   : void
    {
        $this->target_pass = $target_pass;
    }

References $target_pass.

◆ setUserId()

ilAssQuestionUserSolutionAdopter::setUserId ( int $user_id )

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

                                           : void
    {
        $this->user_id = $user_id;
    }

References $user_id.

Field Documentation

◆ $active_id

int ilAssQuestionUserSolutionAdopter::$active_id = null

protected

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

Referenced by getActiveId(), and setActiveId().

◆ $prepared_delete_result_record_statement

ilDBStatement ilAssQuestionUserSolutionAdopter::$prepared_delete_result_record_statement = null

staticprotected

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

Referenced by getPreparedDeleteResultRecordStatement().

◆ $prepared_delete_solution_records_statement

ilDBStatement ilAssQuestionUserSolutionAdopter::$prepared_delete_solution_records_statement = null

staticprotected

Definition at line 29 of file class.ilAssQuestionUserSolutionAdopter.php.

Referenced by getPreparedDeleteSolutionRecordsStatement().

◆ $prepared_insert_result_record_statement

ilDBStatement ilAssQuestionUserSolutionAdopter::$prepared_insert_result_record_statement = null

staticprotected

Definition at line 34 of file class.ilAssQuestionUserSolutionAdopter.php.

Referenced by getPreparedInsertResultRecordStatement().

◆ $prepared_insert_solution_record_statement

ilDBStatement ilAssQuestionUserSolutionAdopter::$prepared_insert_solution_record_statement = null

staticprotected

Definition at line 31 of file class.ilAssQuestionUserSolutionAdopter.php.

Referenced by getPreparedInsertSolutionRecordStatement().

◆ $prepared_select_result_record_statement

ilDBStatement ilAssQuestionUserSolutionAdopter::$prepared_select_result_record_statement = null

staticprotected

Definition at line 33 of file class.ilAssQuestionUserSolutionAdopter.php.

Referenced by getPreparedSelectResultRecordStatement().

◆ $prepared_select_solution_records_statement

ilDBStatement ilAssQuestionUserSolutionAdopter::$prepared_select_solution_records_statement = null

staticprotected

Definition at line 30 of file class.ilAssQuestionUserSolutionAdopter.php.

Referenced by getPreparedSelectSolutionRecordsStatement().

◆ $process_locker_factory

ilAssQuestionProcessLockerFactory ilAssQuestionUserSolutionAdopter::$process_locker_factory

private

Definition at line 36 of file class.ilAssQuestionUserSolutionAdopter.php.

◆ $question_ids

array ilAssQuestionUserSolutionAdopter::$question_ids = []

protected

Definition at line 44 of file class.ilAssQuestionUserSolutionAdopter.php.

Referenced by getQuestionIds(), and setQuestionIds().

◆ $target_pass

int ilAssQuestionUserSolutionAdopter::$target_pass = null

protected

Definition at line 39 of file class.ilAssQuestionUserSolutionAdopter.php.

Referenced by getTargetPass(), and setTargetPass().

◆ $user_id

int ilAssQuestionUserSolutionAdopter::$user_id = null

private

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

Referenced by getUserId(), and setUserId().

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

components/ILIAS/TestQuestionPool/classes/class.ilAssQuestionUserSolutionAdopter.php

Public Member Functions

Protected Member Functions

Protected Attributes

Static Protected Attributes

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ adoptQuestionAnswer()

◆ adoptSourceResult()

◆ adoptSourceSolution()

◆ getActiveId()

◆ getPreparedDeleteResultRecordStatement()

◆ getPreparedDeleteSolutionRecordsStatement()

◆ getPreparedInsertResultRecordStatement()

◆ getPreparedInsertSolutionRecordStatement()

◆ getPreparedSelectResultRecordStatement()

◆ getPreparedSelectSolutionRecordsStatement()

◆ getQuestionIds()

◆ getTargetPass()

◆ getUserId()

◆ perform()

◆ resetTargetResult()

◆ resetTargetSolution()

◆ setActiveId()

◆ setQuestionIds()

◆ setTargetPass()

◆ setUserId()

Field Documentation

◆ $active_id

◆ $prepared_delete_result_record_statement

◆ $prepared_delete_solution_records_statement

◆ $prepared_insert_result_record_statement

◆ $prepared_insert_solution_record_statement

◆ $prepared_select_result_record_statement

◆ $prepared_select_solution_records_statement

◆ $process_locker_factory

◆ $question_ids

◆ $target_pass

◆ $user_id