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

Collaboration diagram for ilExAssignmentMemberStatus:

Public Member Functions
	__construct (int $a_ass_id, int $a_user_id)

	setNotice (string $a_value)

	getNotice ()

	setReturned (bool $a_value)

	getReturned ()

	setSolved (bool $a_value)

	getSolved ()

	getStatusTime ()

	setSent (bool $a_value)

	getSent ()

	getSentTime ()

	setFeedback (bool $a_value)

	getFeedback ()

	getFeedbackTime ()

	setStatus (string $a_value)

	getStatus ()

	setMark (string $a_value)

	getMark ()

	setComment (string $a_value)

	getComment ()

	update ()

	getStatusIcon ()

Static Public Member Functions
static	lookupAnyExerciseSent (int $a_ass_id)

Protected Member Functions
	setStatusTime (string $a_value)

	setSentTime (string $a_value)

	setFeedbackTime (string $a_value)

	read ()

	getFields ()

	postUpdateReturned ()

	postUpdateStatus ()

Protected Attributes
ILIAS Exercise Assignment DomainService	$ass_domain

ilDBInterface	$db

int	$ass_id = 0

int	$user_id = 0

string	$notice = ""

bool	$returned = false

bool	$solved = false

bool	$sent = false

string	$sent_time = ""

bool	$feedback = false

string	$feedback_time = ""

string	$status = "notgraded"

string	$status_time = ""

string	$mark = ""

string	$comment = ""

bool	$db_exists = false

bool	$returned_update = false

bool	$status_update = 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 Exercise assignment member status

Author: Jörg Lützenkirchen luetz.nosp@m.enki.nosp@m.rchen.nosp@m.@lei.nosp@m.fos.c.nosp@m.om; Alexander Killing killi.nosp@m.ng@l.nosp@m.eifos.nosp@m..de

Definition at line 25 of file class.ilExAssignmentMemberStatus.php.

Constructor & Destructor Documentation

◆ __construct()

ilExAssignmentMemberStatus::__construct	(	int	$a_ass_id,
		int	$a_user_id
	)

Definition at line 47 of file class.ilExAssignmentMemberStatus.php.

    {
        global $DIC;
 
        $this->db = $DIC->database();
        $this->ass_id = $a_ass_id;
        $this->user_id = $a_user_id;
 
        $this->read();
        $this->ass_domain = $DIC->exercise()->internal()->domain()->assignment();
    }

References $DIC, and read().

Here is the call graph for this function:

Member Function Documentation

◆ getComment()

ilExAssignmentMemberStatus::getComment ( )

Definition at line 190 of file class.ilExAssignmentMemberStatus.php.

                                : string
    {
        return $this->comment;
    }

References $comment.

Referenced by getFields().

Here is the caller graph for this function:

◆ getFeedback()

ilExAssignmentMemberStatus::getFeedback ( )

Definition at line 142 of file class.ilExAssignmentMemberStatus.php.

                                 : bool
    {
        return $this->feedback;
    }

References $feedback.

Referenced by getFields().

Here is the caller graph for this function:

◆ getFeedbackTime()

ilExAssignmentMemberStatus::getFeedbackTime ( )

Definition at line 153 of file class.ilExAssignmentMemberStatus.php.

                                     : string
    {
        return $this->feedback_time;
    }

References $feedback_time.

Referenced by getFields().

Here is the caller graph for this function:

◆ getFields()

ilExAssignmentMemberStatus::getFields ( )

protected

Definition at line 221 of file class.ilExAssignmentMemberStatus.php.

                                  : array
    {
        return array(
            "notice" => array("text", $this->getNotice())
            ,"returned" => array("integer", (int) $this->getReturned())
            ,"solved" => array("integer", $this->getSolved())
            ,"status_time" => array("timestamp", $this->getStatusTime())
            ,"sent" => array("integer", $this->getSent())
            ,"sent_time" => array("timestamp", $this->getSentTime())
            ,"feedback_time" => array("timestamp", $this->getFeedbackTime())
            ,"feedback" => array("integer", (int) $this->getFeedback())
            ,"status" => array("text", $this->getStatus())
            ,"mark" => array("text", $this->getMark())
            ,"u_comment" => array("text", $this->getComment())
        );
    }

References getComment(), getFeedback(), getFeedbackTime(), getMark(), getNotice(), getReturned(), getSent(), getSentTime(), getSolved(), getStatus(), and getStatusTime().

Referenced by update().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getMark()

ilExAssignmentMemberStatus::getMark ( )

Definition at line 180 of file class.ilExAssignmentMemberStatus.php.

                             : string
    {
        return $this->mark;
    }

References $mark.

Referenced by getFields().

Here is the caller graph for this function:

◆ getNotice()

ilExAssignmentMemberStatus::getNotice ( )

Definition at line 64 of file class.ilExAssignmentMemberStatus.php.

                               : string
    {
        return $this->notice;
    }

References $notice.

Referenced by getFields().

Here is the caller graph for this function:

◆ getReturned()

ilExAssignmentMemberStatus::getReturned ( )

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

                                 : bool
    {
        return $this->returned;
    }

References $returned.

Referenced by getFields().

Here is the caller graph for this function:

◆ getSent()

ilExAssignmentMemberStatus::getSent ( )

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

                             : bool
    {
        return $this->sent;
    }

References $sent.

Referenced by getFields().

Here is the caller graph for this function:

◆ getSentTime()

ilExAssignmentMemberStatus::getSentTime ( )

Definition at line 129 of file class.ilExAssignmentMemberStatus.php.

                                 : string
    {
        return $this->sent_time;
    }

References $sent_time.

Referenced by getFields().

Here is the caller graph for this function:

◆ getSolved()

ilExAssignmentMemberStatus::getSolved ( )

Deprecated:

Definition at line 94 of file class.ilExAssignmentMemberStatus.php.

                               : bool
    {
        return $this->solved;
    }

References $solved.

Referenced by getFields().

Here is the caller graph for this function:

◆ getStatus()

ilExAssignmentMemberStatus::getStatus ( )

Definition at line 167 of file class.ilExAssignmentMemberStatus.php.

                               : string
    {
        return $this->status;
    }

References $status.

Referenced by getFields(), and getStatusIcon().

Here is the caller graph for this function:

◆ getStatusIcon()

ilExAssignmentMemberStatus::getStatusIcon ( )

Deprecated:: will be deleted with R8

Definition at line 298 of file class.ilExAssignmentMemberStatus.php.

                                   : string
    {
        switch ($this->getStatus()) {
            case "passed":
                return "scorm/passed.svg";
 
            case "failed":
                return "scorm/failed.svg";
 
            default:
                return "scorm/not_attempted.svg";
        }
    }

References getStatus().

Here is the call graph for this function:

◆ getStatusTime()

ilExAssignmentMemberStatus::getStatusTime ( )

Definition at line 105 of file class.ilExAssignmentMemberStatus.php.

                                   : string
    {
        return $this->status_time;
    }

References $status_time.

Referenced by getFields().

Here is the caller graph for this function:

◆ lookupAnyExerciseSent()

static ilExAssignmentMemberStatus::lookupAnyExerciseSent ( int $a_ass_id )

static

Definition at line 313 of file class.ilExAssignmentMemberStatus.php.

                                                               : bool
    {
        global $DIC;
 
        $ilDB = $DIC->database();
 
        $q = "SELECT count(*) AS cnt" .
            " FROM exc_mem_ass_status" .
            " WHERE NOT sent_time IS NULL" .
            " AND ass_id = " . $ilDB->quote($a_ass_id, "integer");
        $set = $ilDB->query($q);
        $rec = $ilDB->fetchAssoc($set);
        return ($rec["cnt"] > 0);
    }

References $DIC, $ilDB, and $q.

◆ postUpdateReturned()

ilExAssignmentMemberStatus::postUpdateReturned ( )

protected

Exceptions

ilExcUnknownAssignmentTypeException

Definition at line 269 of file class.ilExAssignmentMemberStatus.php.

                                           : void
    {
        $ilDB = $this->db;
 
        // first upload => notification on submission?
        $set = $ilDB->query("SELECT fb_cron, fb_date, fb_file" .
            " FROM exc_assignment" .
            " WHERE id = " . $ilDB->quote($this->ass_id, "integer"));
        $row = $ilDB->fetchAssoc($set);
        if ($row["fb_cron"] &&
            $row["fb_file"] &&
            $row["fb_date"] == ilExAssignment::FEEDBACK_DATE_SUBMISSION) { // #16200
            ilExAssignment::sendFeedbackNotifications($this->ass_id, $this->user_id);
        }
    }

References $db, $ilDB, ilExAssignment\FEEDBACK_DATE_SUBMISSION, and ilExAssignment\sendFeedbackNotifications().

Referenced by update().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ postUpdateStatus()

ilExAssignmentMemberStatus::postUpdateStatus ( )

protected

Exceptions

ilExcUnknownAssignmentTypeException

Definition at line 288 of file class.ilExAssignmentMemberStatus.php.

                                         : void
    {
        $ass = new ilExAssignment($this->ass_id);
        $exc = new ilObjExercise($ass->getExerciseId(), false);
        $exc->updateUserStatus($this->user_id);
    }

Referenced by update().

Here is the caller graph for this function:

◆ read()

ilExAssignmentMemberStatus::read ( )

protected

Definition at line 195 of file class.ilExAssignmentMemberStatus.php.

                             : void
    {
        $ilDB = $this->db;
 
        $set = $ilDB->query("SELECT * FROM exc_mem_ass_status" .
            " WHERE ass_id = " . $ilDB->quote($this->ass_id, "integer") .
            " AND usr_id = " . $ilDB->quote($this->user_id, "integer"));
        if ($ilDB->numRows($set)) {
            $row = $ilDB->fetchAssoc($set);
 
            // not using setters to circumvent any datetime-logic/-magic
            $this->notice = (string) $row["notice"];
            $this->returned = (bool) $row["returned"];
            $this->solved = (bool) $row["solved"];
            $this->status_time = (string) $row["status_time"];
            $this->sent = (bool) $row["sent"];
            $this->sent_time = (string) $row["sent_time"];
            $this->feedback_time = (string) $row["feedback_time"];
            $this->feedback = (bool) $row["feedback"];
            $this->status = (string) $row["status"];
            $this->mark = (string) $row["mark"];
            $this->comment = (string) $row["u_comment"];
            $this->db_exists = true;
        }
    }

References $db, $ilDB, and ILIAS\UI\examples\Symbol\Glyph\Comment\comment().

Referenced by __construct().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setComment()

ilExAssignmentMemberStatus::setComment ( string $a_value )

Definition at line 185 of file class.ilExAssignmentMemberStatus.php.

                                               : void
    {
        $this->comment = $a_value;
    }

References ILIAS\UI\examples\Symbol\Glyph\Comment\comment().

Here is the call graph for this function:

◆ setFeedback()

ilExAssignmentMemberStatus::setFeedback ( bool $a_value )

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

                                              : void
    {
        if ($a_value != $this->sent) {
            $this->setFeedbackTime(ilUtil::now());
        }
        $this->feedback = $a_value;
    }

References ilUtil\now(), and setFeedbackTime().

Here is the call graph for this function:

◆ setFeedbackTime()

ilExAssignmentMemberStatus::setFeedbackTime ( string $a_value )

protected

Definition at line 148 of file class.ilExAssignmentMemberStatus.php.

                                                       : void
    {
        $this->feedback_time = $a_value;
    }

Referenced by setFeedback().

Here is the caller graph for this function:

◆ setMark()

ilExAssignmentMemberStatus::setMark ( string $a_value )

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

                                            : void
    {
        if ($a_value != $this->mark) {
            $this->setStatusTime(ilUtil::now());
        }
        $this->mark = $a_value;
    }

References ilUtil\now(), and setStatusTime().

Here is the call graph for this function:

◆ setNotice()

ilExAssignmentMemberStatus::setNotice ( string $a_value )

Definition at line 59 of file class.ilExAssignmentMemberStatus.php.

                                              : void
    {
        $this->notice = $a_value;
    }

◆ setReturned()

ilExAssignmentMemberStatus::setReturned ( bool $a_value )

Definition at line 69 of file class.ilExAssignmentMemberStatus.php.

                                              : void
    {
        if ($a_value &&
            !$this->returned) {
            $this->returned_update = true;
        }
        $this->returned = $a_value;
    }

◆ setSent()

ilExAssignmentMemberStatus::setSent ( bool $a_value )

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

                                          : void
    {
        if ($a_value && $a_value != $this->sent) {
            $this->setSentTime(ilUtil::now());
        }
        $this->sent = $a_value;
    }

References ilUtil\now(), and setSentTime().

Here is the call graph for this function:

◆ setSentTime()

ilExAssignmentMemberStatus::setSentTime ( string $a_value )

protected

Definition at line 124 of file class.ilExAssignmentMemberStatus.php.

                                                   : void
    {
        $this->sent_time = $a_value;
    }

Referenced by setSent().

Here is the caller graph for this function:

◆ setSolved()

ilExAssignmentMemberStatus::setSolved ( bool $a_value )

Deprecated:

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

                                            : void
    {
        $this->solved = $a_value;
    }

◆ setStatus()

ilExAssignmentMemberStatus::setStatus ( string $a_value )

Definition at line 158 of file class.ilExAssignmentMemberStatus.php.

                                              : void
    {
        if ($a_value != $this->status) {
            $this->setStatusTime(ilUtil::now());
            $this->status = $a_value;
            $this->status_update = true;
        }
    }

References ilUtil\now(), and setStatusTime().

Here is the call graph for this function:

◆ setStatusTime()

ilExAssignmentMemberStatus::setStatusTime ( string $a_value )

protected

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

                                                     : void
    {
        $this->status_time = $a_value;
    }

Referenced by setMark(), and setStatus().

Here is the caller graph for this function:

◆ update()

ilExAssignmentMemberStatus::update ( )

Exceptions

ilExcUnknownAssignmentTypeException

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

                            : void
    {
        $ilDB = $this->db;
 
        $keys = array(
            "ass_id" => array("integer", $this->ass_id)
            ,"usr_id" => array("integer", $this->user_id)
        );
        $fields = $this->getFields();
        if (!$this->db_exists) {
            $fields = array_merge($keys, $fields);
            $ilDB->insert("exc_mem_ass_status", $fields);
            $this->ass_domain->tutorFeedbackFile($this->ass_id)->createCollection($this->user_id);
        } else {
            $ilDB->update("exc_mem_ass_status", $fields, $keys);
        }
 
        if ($this->returned_update) {
            $this->postUpdateReturned();
        }
        if ($this->status_update) {
            $this->postUpdateStatus();
        }
    }