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.

References $DIC, and read().

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

Here is the call graph for this function:

Member Function Documentation

◆ getComment()

ilExAssignmentMemberStatus::getComment ( )

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

References $comment.

Referenced by getFields().

                                 : string
     {
         return $this->comment;
     }

Here is the caller graph for this function:

◆ getFeedback()

ilExAssignmentMemberStatus::getFeedback ( )

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

References $feedback.

Referenced by getFields().

                                  : bool
     {
         return $this->feedback;
     }

Here is the caller graph for this function:

◆ getFeedbackTime()

ilExAssignmentMemberStatus::getFeedbackTime ( )

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

References $feedback_time.

Referenced by getFields().

                                      : string
     {
         return $this->feedback_time;
     }

Here is the caller graph for this function:

◆ getFields()

ilExAssignmentMemberStatus::getFields ( )

protected

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

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

Referenced by update().

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

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.

References $mark.

Referenced by getFields().

                              : string
     {
         return $this->mark;
     }

Here is the caller graph for this function:

◆ getNotice()

ilExAssignmentMemberStatus::getNotice ( )

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

References $notice.

Referenced by getFields().

                                : string
     {
         return $this->notice;
     }

Here is the caller graph for this function:

◆ getReturned()

ilExAssignmentMemberStatus::getReturned ( )

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

References $returned.

Referenced by getFields().

                                  : bool
     {
         return $this->returned;
     }

Here is the caller graph for this function:

◆ getSent()

ilExAssignmentMemberStatus::getSent ( )

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

References $sent.

Referenced by getFields().

                              : bool
     {
         return $this->sent;
     }

Here is the caller graph for this function:

◆ getSentTime()

ilExAssignmentMemberStatus::getSentTime ( )

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

References $sent_time.

Referenced by getFields().

                                  : string
     {
         return $this->sent_time;
     }

Here is the caller graph for this function:

◆ getSolved()

ilExAssignmentMemberStatus::getSolved ( )

Deprecated:

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

References $solved.

Referenced by getFields().

                                : bool
     {
         return $this->solved;
     }

Here is the caller graph for this function:

◆ getStatus()

ilExAssignmentMemberStatus::getStatus ( )

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

References $status.

Referenced by ilExGradesTableGUI\fillRow(), getFields(), and getStatusIcon().

                                : string
     {
         return $this->status;
     }

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.

References getStatus().

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

Here is the call graph for this function:

◆ getStatusTime()

ilExAssignmentMemberStatus::getStatusTime ( )

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

References $status_time.

Referenced by getFields().

                                    : string
     {
         return $this->status_time;
     }

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.

References $DIC, $ilDB, and $q.

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

◆ postUpdateReturned()

ilExAssignmentMemberStatus::postUpdateReturned ( )

protected

Exceptions

ilExcUnknownAssignmentTypeException

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

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

Referenced by update().

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

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.

References ilObjExercise\updateUserStatus().

Referenced by update().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ read()

ilExAssignmentMemberStatus::read ( )

protected

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

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

Referenced by __construct().

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

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.

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

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

Here is the call graph for this function:

◆ setFeedback()

ilExAssignmentMemberStatus::setFeedback ( bool $a_value )

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

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

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

Here is the call graph for this function:

◆ setFeedbackTime()

ilExAssignmentMemberStatus::setFeedbackTime ( string $a_value )

protected

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

Referenced by setFeedback().

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

Here is the caller graph for this function:

◆ setMark()

ilExAssignmentMemberStatus::setMark ( string $a_value )

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

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

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

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.

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

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

Here is the call graph for this function:

◆ setSentTime()

ilExAssignmentMemberStatus::setSentTime ( string $a_value )

protected

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

Referenced by setSent().

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

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.

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

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

Here is the call graph for this function:

◆ setStatusTime()

ilExAssignmentMemberStatus::setStatusTime ( string $a_value )

protected

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

Referenced by setMark(), and setStatus().

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

Here is the caller graph for this function:

◆ update()

ilExAssignmentMemberStatus::update ( )

Exceptions

ilExcUnknownAssignmentTypeException

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

References $db, $ilDB, getFields(), postUpdateReturned(), and postUpdateStatus().

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