Exercise assignment. More...

Collaboration diagram for ilExAssignment:

Public Member Functions
	__construct ($a_id=0)
	Constructor. More...

	hasTeam ()

	setId (int $a_val)

	getId ()

	setExerciseId (int $a_val)

	getExerciseId ()

	setStartTime (?int $a_val)

	getStartTime ()

	setDeadline (?int $a_val)

	getDeadline ()

	setDeadlineMode (int $a_val)
	Set deadline mode. More...

	getDeadlineMode ()

	setRelativeDeadline (int $a_val)

	getRelativeDeadline ()

	setRelDeadlineLastSubmission (int $a_val)

	getRelDeadlineLastSubmission ()

	getPersonalDeadline (int $a_user_id)

	getLastPersonalDeadline ()

	setExtendedDeadline (?int $a_val)

	getExtendedDeadline ()

	setInstruction (string $a_val)

	getInstruction ()

	getInstructionPresentation ()

	setTitle (string $a_val)

	getTitle ()

	setMandatory (bool $a_val)

	getMandatory ()

	setOrderNr (int $a_val)

	getOrderNr ()

	setType (int $a_value)
	Set type this will most probably become an non public function in the future (or become obsolete) More...

	getAssignmentType ()

	getType ()
	Get type this will most probably become an non public function in the future (or become obsolete) More...

	isValidType (int $a_value)

	setPeerReview (bool $a_value)

	getPeerReview ()

	setPeerReviewMin (int $a_value)

	getPeerReviewMin ()

	setPeerReviewSimpleUnlock (bool $a_value)

	getPeerReviewSimpleUnlock ()

	setPeerReviewDeadline (int $a_val)

	getPeerReviewDeadline ()

	setPeerReviewValid (int $a_value)
	Set peer review validation. More...

	getPeerReviewValid ()

	setPeerReviewRating (bool $a_val)

	hasPeerReviewRating ()

	setPeerReviewText (bool $a_val)

	hasPeerReviewText ()

	setPeerReviewFileUpload (bool $a_val)

	hasPeerReviewFileUpload ()

	setPeerReviewPersonalized (bool $a_val)

	hasPeerReviewPersonalized ()

	setPeerReviewChars (?int $a_value)

	getPeerReviewChars ()

	setPeerReviewCriteriaCatalogue (?int $a_value)

	getPeerReviewCriteriaCatalogue ()

	setFeedbackFile (?string $a_value)

	getFeedbackFile ()

	setFeedbackCron (bool $a_value)
	Toggle (global) feedback file cron. More...

	hasFeedbackCron ()

	setFeedbackDate (int $a_value)

	getFeedbackDate ()

	setFeedbackDateCustom (int $a_value)
	Set (global) feedback file availability using a custom date. More...

	getFeedbackDateCustom ()

	setTeamTutor (bool $a_value)

	getTeamTutor ()

	setMaxFile (?int $a_value)

	getMaxFile ()

	setPortfolioTemplateId (int $a_val)

	getPortfolioTemplateId ()

	read ()

	save ()

	update ()

	delete (ilObjExercise $exc, bool $update_status=true)

	getFiles ()

	getInstructionFilesOrder ()

	getMemberListData ()

	getExerciseMemberAssignmentData (int $a_user_id, string $a_grade="")
	Get submission data for an specific user,exercise and assignment. More...

	uploadAssignmentFiles (array $a_files)
	Upload assignment files (from creation form) More...

	sendMultiFeedbackStructureFile (ilObjExercise $exercise)
	Create member status record for a new assignment for all participants. More...

	uploadMultiFeedbackFile (array $a_file)

	getMultiFeedbackFiles (int $a_user_id=0)
	Get multi feedback files (of uploader) More...

	clearMultiFeedbackDirectory ()
	Clear multi feedback directory. More...

	saveMultiFeedbackFiles (array $a_files, ilObjExercise $a_exc)

	afterDeadline ()

	afterDeadlineStrict (bool $a_include_personal=true)

	afterCustomDate ()

	beforeDeadline ()

	notStartedYet ()

	getGlobalFeedbackFileStoragePath ()

	deleteGlobalFeedbackFile ()

	handleGlobalFeedbackFileUpload (array $a_file)

	getGlobalFeedbackFilePath ()

	getMemberStatus (?int $a_user_id=null)

	recalculateLateSubmissions ()

	setIndividualDeadline (string $id, ilDateTime $date)

	getIndividualDeadlines ()

	hasActiveIDl ()

	hasReadOnlyIDl ()

	fixInstructionFileOrdering ()

	fileAddOrder (array $a_entries=array())

	setMinCharLimit (int $a_val)

	getMinCharLimit ()

	setMaxCharLimit (int $a_val)

	getMaxCharLimit ()

	getCalculatedDeadlines ()
	Get calculated deadlines for user/team members. More...

	canParticipantReceiveFeedback (int $part_id)

Static Public Member Functions
static	getInstancesByExercise (int $a_exc_id)

static	instructionFileGetFileOrderData (array $a_file_data, int $a_ass_id)

static	getAssignmentDataOfExercise (int $a_exc_id)

static	cloneAssignmentsOfExercise (int $a_old_exc_id, int $a_new_exc_id, array $a_crit_cat_map)
	Clone assignments of exercise. More...

static	lookupMaxOrderNrForEx (int $a_exc_id)

static	lookupAssignmentOnline (int $a_ass_id)

static	lookupExerciseId (int $a_ass_id)

static	lookupTitle (int $a_id)

static	lookupType (int $a_id)

static	saveAssOrderOfExercise (int $a_ex_id, array $a_order)

static	orderAssByDeadline (int $a_ex_id)

static	countMandatory (int $a_ex_id)

static	count (int $a_ex_id)

static	isInExercise (int $a_ass_id, int $a_ex_id)

static	createNewUserRecords (int $a_user_id, int $a_exc_id)

static	createNewAssignmentRecords (int $a_ass_id, ilObjExercise $a_exc)

static	getPendingFeedbackNotifications ()

static	sendFeedbackNotifications (int $a_ass_id, int $a_user_id=null)

static	saveInstructionFilesOrderOfAssignment (int $a_ass_id, array $a_order)

static	insertFileOrderNr (int $a_ass_id, string $a_filename, int $a_order_nr)

static	instructionFileInsertOrder (string $a_filename, int $a_ass_id, int $a_order_nr=0)

static	instructionFileDeleteOrder (int $a_ass_id, array $a_file)

static	renameInstructionFile (string $a_old_name, string $a_new_name, int $a_ass_id)

static	instructionFileExistsInDb (string $a_filename, int $a_ass_id)

static	instructionFileOrderGetMax (int $a_ass_id)

Data Fields
const	TYPE_UPLOAD = 1
	direct checks against const should be avoided, use type objects instead More...

const	TYPE_BLOG = 2

const	TYPE_PORTFOLIO = 3

const	TYPE_UPLOAD_TEAM = 4

const	TYPE_TEXT = 5

const	TYPE_WIKI_TEAM = 6

const	FEEDBACK_DATE_DEADLINE = 1

const	FEEDBACK_DATE_SUBMISSION = 2

const	FEEDBACK_DATE_CUSTOM = 3

const	PEER_REVIEW_VALID_NONE = 1

const	PEER_REVIEW_VALID_ONE = 2

const	PEER_REVIEW_VALID_ALL = 3

const	TEAMS_FORMED_BY_PARTICIPANTS = 0

const	TEAMS_FORMED_BY_TUTOR = 1

const	TEAMS_FORMED_BY_RANDOM = 2

const	TEAMS_FORMED_BY_ASSIGNMENT = 3

const	DEADLINE_ABSOLUTE = 0

const	DEADLINE_RELATIVE = 1

Protected Member Functions
	initFromDB (array $a_set)
	Import DB record. More...

	handleCalendarEntries (string $a_event, ilObjExercise $exc)
	Handle calendar entries for deadline(s) More...

Protected Attributes
ILIAS Refinery String Group	$string_transform

ilDBInterface	$db

ilLanguage	$lng

ilObjUser	$user

ilAppEventHandler	$app_event_handler

ilAccessHandler	$access

int	$id = 0

int	$exc_id = 0

int	$type = 0

int	$start_time = null

int	$deadline = null

int	$deadline2 = null

string	$instruction = ""

string	$title = ""

bool	$mandatory = false

int	$order_nr = 0

bool	$peer = false

int	$peer_min = 0

bool	$peer_unlock = false

int	$peer_dl = 0

int	$peer_valid

bool	$peer_file = false

bool	$peer_personal = false

int	$peer_char = null

bool	$peer_text = false

bool	$peer_rating = false

int	$peer_crit_cat = 0

string	$feedback_file = null

bool	$feedback_cron = false

int	$feedback_date = 0

int	$feedback_date_custom = 0

bool	$team_tutor = false

int	$max_file = null

int	$portfolio_template = 0

int	$min_char_limit = 0

int	$max_char_limit = 0

ilExAssignmentTypes	$types

ilExAssignmentTypeInterface	$ass_type

int	$deadline_mode = 0

int	$relative_deadline = 0

int	$rel_deadline_last_subm = 0

array	$member_status = []

ilLogger	$log

int	$crit_cat = 0

Static Private Member Functions
static	lookup (int $a_id, string $a_field)

Detailed Description

Exercise assignment.

Author: Alexander Killing killi.nosp@m.ng@l.nosp@m.eifos.nosp@m..de

Definition at line 28 of file class.ilExAssignment.php.

Constructor & Destructor Documentation

◆ __construct()

ilExAssignment::__construct ( $a_id = 0 )

Constructor.

Exceptions

ilExcUnknownAssignmentTypeException

Definition at line 106 of file class.ilExAssignment.php.

References $DIC, ILIAS\Repository\access(), ilExAssignmentTypes\getInstance(), ilLoggerFactory\getLogger(), ILIAS\Repository\lng(), read(), setFeedbackDate(), setId(), setType(), and ILIAS\Repository\user().

     {
         global $DIC;
 
         $this->db = $DIC->database();
         $this->lng = $DIC->language();
         $this->user = $DIC->user();
         $this->app_event_handler = $DIC["ilAppEventHandler"];
         $this->types = ilExAssignmentTypes::getInstance();
         $this->access = $DIC->access();
 
         $this->setType(self::TYPE_UPLOAD);
         $this->setFeedbackDate(self::FEEDBACK_DATE_DEADLINE);
 
         $this->log = ilLoggerFactory::getLogger("exc");
 
         if ($a_id > 0) {
             $this->setId($a_id);
             $this->read();
         }
         $this->string_transform = $DIC->refinery()
             ->string();
     }

Here is the call graph for this function:

Member Function Documentation

◆ afterCustomDate()

ilExAssignment::afterCustomDate ( )

Returns: bool return if sample solution is available using a custom date.

Definition at line 1762 of file class.ilExAssignment.php.

References getFeedbackDateCustom().

Referenced by ilExAssignmentGUI\addSubmission().

                                      : bool
     {
         $date_custom = $this->getFeedbackDateCustom();
         //if the solution will be displayed only after reach all the deadlines.
         //$final_deadline = $this->afterDeadlineStrict();
         //$dl = max($final_deadline, time());
         //return ($date_custom - $dl <= 0);
         return ($date_custom - time() <= 0);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ afterDeadline()

ilExAssignment::afterDeadline ( )

Definition at line 1724 of file class.ilExAssignment.php.

References $ilUser, $user, and getPersonalDeadline().

Referenced by afterDeadlineStrict().

                                    : bool
     {
         $ilUser = $this->user;
 
         // :TODO: always current user?
         $idl = $this->getPersonalDeadline($ilUser->getId());            // official deadline
 
         // no deadline === true
         $deadline = max($this->deadline, $this->deadline2, $idl);       // includes grace period
         return ($deadline - time() <= 0);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ afterDeadlineStrict()

ilExAssignment::afterDeadlineStrict ( bool $a_include_personal = true )

Definition at line 1736 of file class.ilExAssignment.php.

References afterDeadline(), and getLastPersonalDeadline().

Referenced by beforeDeadline(), ilObjWikiGUI\getAssignmentButtons(), and ilExerciseSubmissionTableGUI\parseColumns().

                                                                         : bool
     {
         // :TODO: this means that peer feedback, global feedback is available
         // after LAST personal deadline
         // team management is currently ignoring personal deadlines
         $idl = $a_include_personal
             ? $this->getLastPersonalDeadline()
             : null;
 
         // no deadline === false
         $deadline = max($this->deadline, $this->deadline2, $idl);
 
         // #18271 - afterDeadline() does not handle last personal deadline
         // after effective deadline of all users
         if ($idl && $deadline == $idl) {
             return ($deadline - time() <= 0);
         }
 
         // like: after effective deadline (for single user), except: no deadline false
         return ($deadline > 0 &&
             $this->afterDeadline());
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ beforeDeadline()

ilExAssignment::beforeDeadline ( )

Definition at line 1773 of file class.ilExAssignment.php.

References afterDeadlineStrict().

                                     : bool
     {
         // no deadline === true
         return !$this->afterDeadlineStrict();
     }

Here is the call graph for this function:

◆ canParticipantReceiveFeedback()

ilExAssignment::canParticipantReceiveFeedback ( int $part_id )

Definition at line 2208 of file class.ilExAssignment.php.

References getId(), ilExAssignmentTeam\getTeamId(), and hasTeam().

Referenced by ilExerciseSubmissionTableGUI\parseColumns().

                                                                : bool
     {
         if ($this->hasTeam()) {
             if (!ilExAssignmentTeam::getTeamId($this->getId(), $part_id)) {
                 return false;
             }
         }
         return true;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ clearMultiFeedbackDirectory()

ilExAssignment::clearMultiFeedbackDirectory ( )

Clear multi feedback directory.

Definition at line 1511 of file class.ilExAssignment.php.

References $ilUser, $user, ilFileUtils\delDir(), getExerciseId(), and getId().

Referenced by saveMultiFeedbackFiles().

                                                  : void
     {
         $ilUser = $this->user;
 
         $storage = new ilFSStorageExercise($this->getExerciseId(), $this->getId());
         $mfu = $storage->getMultiFeedbackUploadPath($ilUser->getId());
         ilFileUtils::delDir($mfu);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ cloneAssignmentsOfExercise()

static ilExAssignment::cloneAssignmentsOfExercise	(	int	$a_old_exc_id,
		int	$a_new_exc_id,
		array	$a_crit_cat_map
	)

static

Clone assignments of exercise.

Exceptions

DirectoryNotFoundException
FileNotFoundException
IOException
ilExcUnknownAssignmentTypeException\|ilDateTimeException

Definition at line 922 of file class.ilExAssignment.php.

References $d, ilExAssignmentTypeInterface\cloneSpecificProperties(), ilFSStorageExercise\create(), ilFileSystemAbstractionStorage\create(), ilExAssignmentReminder\FEEDBACK_REMINDER, ilFileSystemAbstractionStorage\getAbsolutePath(), ilFSStorageExercise\getGlobalFeedbackPath(), ilExAssignmentReminder\GRADE_REMINDER, insertFileOrderNr(), ilFileUtils\rCopy(), ilExAssignmentReminder\setReminderStatus(), and ilExAssignmentReminder\SUBMIT_REMINDER.

Referenced by ilObjExercise\saveData().

      : void {
         $ass_data = self::getInstancesByExercise($a_old_exc_id);
         foreach ($ass_data as $d) {
             // clone assignment
             $new_ass = new ilExAssignment();
             $new_ass->setExerciseId($a_new_exc_id);
             $new_ass->setTitle($d->getTitle());
             $new_ass->setDeadline($d->getDeadline());
             $new_ass->setExtendedDeadline($d->getExtendedDeadline());
             $new_ass->setInstruction($d->getInstruction());
             $new_ass->setMandatory($d->getMandatory());
             $new_ass->setOrderNr($d->getOrderNr());
             $new_ass->setStartTime($d->getStartTime());
             $new_ass->setType($d->getType());
             $new_ass->setPeerReview($d->getPeerReview());
             $new_ass->setPeerReviewMin($d->getPeerReviewMin());
             $new_ass->setPeerReviewDeadline($d->getPeerReviewDeadline());
             $new_ass->setPeerReviewFileUpload($d->hasPeerReviewFileUpload());
             $new_ass->setPeerReviewPersonalized($d->hasPeerReviewPersonalized());
             $new_ass->setPeerReviewValid($d->getPeerReviewValid());
             $new_ass->setPeerReviewChars($d->getPeerReviewChars());
             $new_ass->setPeerReviewText($d->hasPeerReviewText());
             $new_ass->setPeerReviewRating($d->hasPeerReviewRating());
             $new_ass->setPeerReviewCriteriaCatalogue($d->getPeerReviewCriteriaCatalogue());
             $new_ass->setPeerReviewSimpleUnlock($d->getPeerReviewSimpleUnlock());
             $new_ass->setFeedbackFile($d->getFeedbackFile());
             $new_ass->setFeedbackDate($d->getFeedbackDate());
             $new_ass->setFeedbackDateCustom($d->getFeedbackDateCustom());
             $new_ass->setFeedbackCron($d->hasFeedbackCron()); // #16295
             $new_ass->setTeamTutor($d->getTeamTutor());
             $new_ass->setMaxFile($d->getMaxFile());
             $new_ass->setMinCharLimit($d->getMinCharLimit());
             $new_ass->setMaxCharLimit($d->getMaxCharLimit());
             $new_ass->setPortfolioTemplateId($d->getPortfolioTemplateId());
             $new_ass->setDeadlineMode($d->getDeadlineMode());
             $new_ass->setRelativeDeadline($d->getRelativeDeadline());
             $new_ass->setRelDeadlineLastSubmission($d->getRelDeadlineLastSubmission());
 
             // criteria catalogue(s)
             if ($d->getPeerReviewCriteriaCatalogue() &&
                 array_key_exists($d->getPeerReviewCriteriaCatalogue(), $a_crit_cat_map)) {
                 $new_ass->setPeerReviewCriteriaCatalogue($a_crit_cat_map[$d->getPeerReviewCriteriaCatalogue()]);
             }
 
             $new_ass->save();
 
 
             // clone assignment files
             $old_web_storage = new ilFSWebStorageExercise($a_old_exc_id, $d->getId());
             $new_web_storage = new ilFSWebStorageExercise($a_new_exc_id, $new_ass->getId());
             $new_web_storage->create();
             if (is_dir($old_web_storage->getAbsolutePath())) {
                 ilFileUtils::rCopy($old_web_storage->getAbsolutePath(), $new_web_storage->getAbsolutePath());
             }
             $order = $d->getInstructionFilesOrder();
             foreach ($order as $file) {
                 ilExAssignment::insertFileOrderNr($new_ass->getId(), $file["filename"], $file["order_nr"]);
             }
 
             // clone global feedback file
             $old_storage = new ilFSStorageExercise($a_old_exc_id, $d->getId());
             $new_storage = new ilFSStorageExercise($a_new_exc_id, $new_ass->getId());
             $new_storage->create();
             if (is_dir($old_storage->getGlobalFeedbackPath())) {
                 ilFileUtils::rCopy($old_storage->getGlobalFeedbackPath(), $new_storage->getGlobalFeedbackPath());
             }
 
             // clone reminders
             foreach ([ilExAssignmentReminder::SUBMIT_REMINDER,
                       ilExAssignmentReminder::GRADE_REMINDER,
                       ilExAssignmentReminder::FEEDBACK_REMINDER] as $rem_type) {
                 $rmd_sub = new ilExAssignmentReminder($a_old_exc_id, $d->getId(), $rem_type);
                 if ($rmd_sub->getReminderStatus()) {
                     $new_rmd_sub = new ilExAssignmentReminder($a_new_exc_id, $new_ass->getId(), $rem_type);
                     $new_rmd_sub->setReminderStatus($rmd_sub->getReminderStatus());
                     $new_rmd_sub->setReminderStart($rmd_sub->getReminderStart());
                     $new_rmd_sub->setReminderEnd($rmd_sub->getReminderEnd());
                     $new_rmd_sub->setReminderFrequency($rmd_sub->getReminderFrequency());
                     $new_rmd_sub->setReminderMailTemplate($rmd_sub->getReminderMailTemplate());
                     $new_rmd_sub->save();
                 }
             }
 
 
             // type specific properties
             $ass_type = $d->getAssignmentType();
             $ass_type->cloneSpecificProperties($d, $new_ass);
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ count()

static ilExAssignment::count ( int $a_ex_id )

static

Definition at line 1170 of file class.ilExAssignment.php.

References $DIC, and $ilDB.

Referenced by getMultiFeedbackFiles(), and ilObjExerciseGUI\listAssignmentsObject().

                                               : int
     {
         global $DIC;
 
         $ilDB = $DIC->database();
 
         $set = $ilDB->query(
             "SELECT count(*) cntm FROM exc_assignment " .
             " WHERE exc_id = " . $ilDB->quote($a_ex_id, "integer")
         );
         $rec = $ilDB->fetchAssoc($set);
         return $rec["cntm"];
     }

Here is the caller graph for this function:

◆ countMandatory()

static ilExAssignment::countMandatory ( int $a_ex_id )

static

Definition at line 1154 of file class.ilExAssignment.php.

References $DIC, and $ilDB.

Referenced by ilObjExerciseGUI\listAssignmentsObject().

                                                        : int
     {
         global $DIC;
 
         $ilDB = $DIC->database();
 
         $set = $ilDB->query(
             "SELECT count(*) cntm FROM exc_assignment " .
             " WHERE exc_id = " . $ilDB->quote($a_ex_id, "integer") .
             " AND mandatory = " . $ilDB->quote(1, "integer")
         );
         $rec = $ilDB->fetchAssoc($set);
         return (int) $rec["cntm"];
     }

Here is the caller graph for this function:

◆ createNewAssignmentRecords()

static ilExAssignment::createNewAssignmentRecords	(	int	$a_ass_id,
		ilObjExercise	$a_exc
	)

static

Definition at line 1327 of file class.ilExAssignment.php.

References $DIC, and $ilDB.

      : void {
         global $DIC;
 
         $ilDB = $DIC->database();
 
         $exmem = new ilExerciseMembers($a_exc);
         $mems = $exmem->getMembers();
 
         foreach ($mems as $mem) {
             $ilDB->replace("exc_mem_ass_status", array(
                 "ass_id" => array("integer", $a_ass_id),
                 "usr_id" => array("integer", $mem)
                 ), array(
                 "status" => array("text", "notgraded")
                 ));
         }
     }

◆ createNewUserRecords()

static ilExAssignment::createNewUserRecords	(	int	$a_user_id,
		int	$a_exc_id
	)

static

Definition at line 1306 of file class.ilExAssignment.php.

References $DIC, and $ilDB.

Referenced by ilExerciseMembers\assignMember().

      : void {
         global $DIC;
 
         $ilDB = $DIC->database();
 
         $ass_data = self::getAssignmentDataOfExercise($a_exc_id);
         foreach ($ass_data as $ass) {
             //echo "-".$ass["id"]."-".$a_user_id."-";
             $ilDB->replace("exc_mem_ass_status", array(
                 "ass_id" => array("integer", $ass["id"]),
                 "usr_id" => array("integer", $a_user_id)
                 ), array(
                 "status" => array("text", "notgraded")
                 ));
         }
     }

Here is the caller graph for this function:

◆ delete()

ilExAssignment::delete	(	ilObjExercise	$exc,
		bool	$update_status = `true`
	)

Exceptions

ilDateTimeException

Definition at line 816 of file class.ilExAssignment.php.

References $db, $ilDB, deleteGlobalFeedbackFile(), getExerciseId(), getId(), getPeerReview(), handleCalendarEntries(), and ilObjExercise\updateAllUsersStatus().

      : void {
         $ilDB = $this->db;
 
         // delete submissions
         $exc_members = new ilExerciseMembers($exc);
         foreach ($exc_members->getMembers() as $mem) {
             $submission = new ilExSubmission($this, $mem);
             $submission->deleteAllFiles();
         }
 
         $ilDB->manipulateF(
             "DELETE FROM exc_usr_tutor " .
             "WHERE ass_id = %s",
             array("integer"),
             array($this->getId())
         );
 
         $this->deleteGlobalFeedbackFile();
 
         // remove peer review data
         if ($this->getPeerReview()) {
             $peer_review = new ilExPeerReview($this);
             $peer_review->resetPeerReviews();
         }
 
         $ilDB->manipulate(
             "DELETE FROM exc_ass_file_order" .
             " WHERE assignment_id = " . $ilDB->quote($this->getId(), 'integer')
         );
 
         $ilDB->manipulate(
             "DELETE FROM exc_mem_ass_status" .
             " WHERE ass_id = " . $ilDB->quote($this->getId(), 'integer')
         );
 
         $ilDB->manipulate(
             "DELETE FROM exc_assignment WHERE " .
             " id = " . $ilDB->quote($this->getId(), "integer")
         );
 
         if ($update_status) {
             $exc = new ilObjExercise($this->getExerciseId(), false);
             $exc->updateAllUsersStatus();
         }
 
         $this->handleCalendarEntries("delete", $exc);
 
         $reminder = new ilExAssignmentReminder();
         $reminder->deleteReminders($this->getId());
     }

Here is the call graph for this function:

◆ deleteGlobalFeedbackFile()

ilExAssignment::deleteGlobalFeedbackFile ( )

Definition at line 1795 of file class.ilExAssignment.php.

References ilFileUtils\delDir(), and getGlobalFeedbackFileStoragePath().

Referenced by delete(), and ilExAssignmentEditorGUI\importFormToAssignment().

                                               : void
     {
         ilFileUtils::delDir($this->getGlobalFeedbackFileStoragePath());
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fileAddOrder()

ilExAssignment::fileAddOrder ( array $a_entries = array() )

Definition at line 2121 of file class.ilExAssignment.php.

References Vendor\Package\$e, fixInstructionFileOrdering(), and getInstructionFilesOrder().

      : array {
         $this->fixInstructionFileOrdering();
 
         $order = $this->getInstructionFilesOrder();
         foreach ($a_entries as $k => $e) {
             $a_entries[$k]["order_val"] = $order[$e["file"]]["order_nr"] ?? 0;
             $a_entries[$k]["order_id"] = $order[$e["file"]]["id"] ?? "";
         }
 
         return $a_entries;
     }

Here is the call graph for this function:

◆ fixInstructionFileOrdering()

ilExAssignment::fixInstructionFileOrdering ( )

Definition at line 2082 of file class.ilExAssignment.php.

References $db, Vendor\Package\$f, ilDBInterface\fetchAssoc(), getFiles(), getId(), ilDBInterface\manipulate(), ilDBInterface\query(), and ilDBInterface\quote().

Referenced by fileAddOrder().

                                                 : void
     {
         $db = $this->db;
 
         $files = array_map(function ($v) {
             return $v["name"];
         }, $this->getFiles());
 
         $set = $db->query("SELECT * FROM exc_ass_file_order " .
             " WHERE assignment_id = " . $db->quote($this->getId(), "integer") .
             " ORDER BY order_nr");
         $order_nr = 10;
         $numbered_files = array();
         while ($rec = $db->fetchAssoc($set)) {
             // file exists, set correct order nr
             if (in_array($rec["filename"], $files)) {
                 $db->manipulate(
                     "UPDATE exc_ass_file_order SET " .
                     " order_nr = " . $db->quote($order_nr, "integer") .
                     " WHERE assignment_id = " . $db->quote($this->getId(), "integer") .
                     " AND id = " . $db->quote($rec["id"], "integer")
                 );
                 $order_nr += 10;
                 $numbered_files[] = $rec["filename"];
             } else {    // file does not exist, delete entry
                 $db->manipulate(
                     "DELETE FROM exc_ass_file_order " .
                     " WHERE assignment_id = " . $db->quote($this->getId(), "integer") .
                     " AND id = " . $db->quote($rec["id"], "integer")
                 );
             }
         }
         foreach ($files as $f) {
             if (!in_array($f, $numbered_files)) {
                 self::instructionFileInsertOrder($f, $this->getId());
             }
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getAssignmentDataOfExercise()

static ilExAssignment::getAssignmentDataOfExercise ( int $a_exc_id )

static

Definition at line 872 of file class.ilExAssignment.php.

References $data, $DIC, and $ilDB.

Referenced by ilExerciseXMLParser\__construct(), ilObjExercise\delete(), ilExAssignmentTeam\getAdoptableTeamAssignments(), ilObjExerciseGUI\getService(), and ilExerciseXMLWriter\start().

                                                                      : array
     {
         global $DIC;
 
         $ilDB = $DIC->database();
 
         // should be changed to self::getInstancesByExerciseId()
 
         $set = $ilDB->query("SELECT * FROM exc_assignment " .
             " WHERE exc_id = " . $ilDB->quote($a_exc_id, "integer") .
             " ORDER BY order_nr");
         $data = array();
 
         $order_val = 10;
         while ($rec = $ilDB->fetchAssoc($set)) {
             $data[] = array(
                 "id" => (int) $rec["id"],
                 "exc_id" => (int) $rec["exc_id"],
                 "deadline" => (int) $rec["time_stamp"],
                 "deadline2" => (int) $rec["deadline2"],
                 "instruction" => (string) $rec["instruction"],
                 "title" => (string) $rec["title"],
                 "start_time" => (int) $rec["start_time"],
                 "order_val" => $order_val,
                 "mandatory" => (bool) $rec["mandatory"],
                 "type" => (int) $rec["type"],
                 "peer" => (bool) $rec["peer"],
                 "peer_min" => (int) $rec["peer_min"],
                 "peer_dl" => (int) $rec["peer_dl"],
                 "peer_file" => (bool) $rec["peer_file"],
                 "peer_prsl" => (bool) $rec["peer_prsl"],
                 "fb_file" => (string) $rec["fb_file"],
                 "fb_date" => (int) $rec["fb_date"],
                 "fb_cron" => (bool) $rec["fb_cron"],
                 "deadline_mode" => (int) $rec["deadline_mode"],
                 "relative_deadline" => (int) $rec["relative_deadline"],
                 "rel_deadline_last_subm" => (int) $rec["rel_deadline_last_subm"]
                 );
             $order_val += 10;
         }
         return $data;
     }

Here is the caller graph for this function:

◆ getAssignmentType()

ilExAssignment::getAssignmentType ( )

Definition at line 391 of file class.ilExAssignment.php.

References $ass_type.

Referenced by ilExSubmission\__construct(), ilExSubmission\downloadAllAssignmentFiles(), and ilExAssignmentEditorGUI\generateTeams().

                                        : ilExAssignmentTypeInterface
     {
         return $this->ass_type;
     }

Here is the caller graph for this function:

◆ getCalculatedDeadlines()

ilExAssignment::getCalculatedDeadlines ( )

Get calculated deadlines for user/team members.

These arrays will contain no entries, if team or user has not started the assignment yet.

Returns: array[array] contains two arrays one with key "user", second with key "team", each one has member id as keys and calculated deadline as value

Definition at line 2186 of file class.ilExAssignment.php.

References $type, getDeadlineMode(), getId(), getRelativeDeadline(), and ilExcIndividualDeadline\getStartingTimestamps().

                                             : array
     {
         $calculated_deadlines = array(
             "user" => array(),
             "team" => array()
         );
 
         if ($this->getRelativeDeadline() && $this->getDeadlineMode() == self::DEADLINE_RELATIVE) {
             foreach (ilExcIndividualDeadline::getStartingTimestamps($this->getId()) as $ts) {
                 $type = $ts["is_team"]
                     ? "team"
                     : "user";
 
                 $calculated_deadlines[$type][$ts["member_id"]] = array(
                     "calculated_deadline" => $ts["starting_ts"] + ($this->getRelativeDeadline() * 24 * 60 * 60)
                 );
             }
         }
         return $calculated_deadlines;
     }

Here is the call graph for this function:

◆ getDeadline()

ilExAssignment::getDeadline ( )

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

References $deadline.

Referenced by getPersonalDeadline(), handleCalendarEntries(), hasActiveIDl(), ilExerciseSubmissionTableGUI\parseColumns(), save(), ilObjExercise\update(), and update().

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

Here is the caller graph for this function:

◆ getDeadlineMode()

ilExAssignment::getDeadlineMode ( )

Definition at line 245 of file class.ilExAssignment.php.

References $deadline_mode.

Referenced by getCalculatedDeadlines(), handleCalendarEntries(), save(), and update().

                                      : int
     {
         return $this->deadline_mode;
     }

Here is the caller graph for this function:

◆ getExerciseId()

ilExAssignment::getExerciseId ( )

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

References $exc_id.

Referenced by ilExAssignmentGUI\addSubmissionFeedback(), clearMultiFeedbackDirectory(), delete(), ilExSubmission\downloadAllAssignmentFiles(), getFiles(), getGlobalFeedbackFileStoragePath(), getMultiFeedbackFiles(), ilExAssTypeWikiTeam\handleNewUpload(), save(), saveMultiFeedbackFiles(), sendMultiFeedbackStructureFile(), ilObjExercise\update(), update(), uploadAssignmentFiles(), and uploadMultiFeedbackFile().

                                    : int
     {
         return $this->exc_id;
     }

Here is the caller graph for this function:

◆ getExerciseMemberAssignmentData()

ilExAssignment::getExerciseMemberAssignmentData	(	int	$a_user_id,
		string	$a_grade = `""`
	)

Get submission data for an specific user,exercise and assignment.

todo we can refactor a bit the method getMemberListData to use this and remove duplicate code.

Definition at line 1269 of file class.ilExAssignment.php.

References $data, $DIC, $ilDB, and getId().

      : ?array {
         global $DIC;
         $ilDB = $DIC->database();
 
         $and_grade = "";
         if (in_array($a_grade, array("notgraded", "passed", "failed"))) {
             $and_grade = " AND status = " . $ilDB->quote($a_grade, "text");
         }
 
         $q = "SELECT * FROM exc_mem_ass_status " .
             "WHERE ass_id = " . $ilDB->quote($this->getId(), "integer") .
             " AND usr_id = " . $ilDB->quote($a_user_id, "integer") .
             $and_grade;
 
         $set = $ilDB->query($q);
 
         $data = null;
         while ($rec = $ilDB->fetchAssoc($set)) {
             $sub = new ilExSubmission($this, $a_user_id);
 
             $data["sent_time"] = $rec["sent_time"];
             $data["submission"] = $sub->getLastSubmission();
             $data["status_time"] = $rec["status_time"];
             $data["feedback_time"] = $rec["feedback_time"];
             $data["notice"] = $rec["notice"];
             $data["status"] = $rec["status"];
             $data["mark"] = $rec["mark"];
             $data["comment"] = $rec["u_comment"];
         }
 
         return $data;
     }

Here is the call graph for this function:

◆ getExtendedDeadline()

ilExAssignment::getExtendedDeadline ( )

Definition at line 314 of file class.ilExAssignment.php.

References $deadline2.

Referenced by recalculateLateSubmissions(), save(), and update().

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

Here is the caller graph for this function:

◆ getFeedbackDate()

ilExAssignment::getFeedbackDate ( )

Definition at line 589 of file class.ilExAssignment.php.

References $feedback_date.

Referenced by ilExAssignmentGUI\addSubmission(), save(), and update().

                                      : int
     {
         return $this->feedback_date;
     }

Here is the caller graph for this function:

◆ getFeedbackDateCustom()

ilExAssignment::getFeedbackDateCustom ( )

Definition at line 603 of file class.ilExAssignment.php.

References $feedback_date_custom.

Referenced by afterCustomDate(), save(), and update().

                                            : int
     {
         return $this->feedback_date_custom;
     }

Here is the caller graph for this function:

◆ getFeedbackFile()

ilExAssignment::getFeedbackFile ( )

Definition at line 565 of file class.ilExAssignment.php.

References $feedback_file.

Referenced by ilExAssignmentGUI\addSubmission(), ilExAssignmentGUI\addSubmissionFeedback(), getGlobalFeedbackFilePath(), save(), and update().

                                      : ?string
     {
         return $this->feedback_file;
     }

Here is the caller graph for this function:

◆ getFiles()

ilExAssignment::getFiles ( )

Definition at line 1016 of file class.ilExAssignment.php.

References getExerciseId(), and getId().

Referenced by ilExAssignmentGUI\addFiles(), and fixInstructionFileOrdering().

                               : array
     {
         $this->log->debug("getting files from class.ilExAssignment using ilFSWebStorageExercise");
         $storage = new ilFSWebStorageExercise($this->getExerciseId(), $this->getId());
         return $storage->getFiles();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getGlobalFeedbackFilePath()

ilExAssignment::getGlobalFeedbackFilePath ( )

Definition at line 1814 of file class.ilExAssignment.php.

References $path, getFeedbackFile(), and getGlobalFeedbackFileStoragePath().

                                                : string
     {
         $file = $this->getFeedbackFile();
         if ($file) {
             $path = $this->getGlobalFeedbackFileStoragePath();
             return $path . "/" . $file;
         }
         return "";
     }

Here is the call graph for this function:

◆ getGlobalFeedbackFileStoragePath()

ilExAssignment::getGlobalFeedbackFileStoragePath ( )

Definition at line 1789 of file class.ilExAssignment.php.

References getExerciseId(), and getId().

Referenced by deleteGlobalFeedbackFile(), getGlobalFeedbackFilePath(), and handleGlobalFeedbackFileUpload().

                                                       : string
     {
         $storage = new ilFSStorageExercise($this->getExerciseId(), $this->getId());
         return $storage->getGlobalFeedbackPath();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getId()

ilExAssignment::getId ( )

Definition at line 201 of file class.ilExAssignment.php.

References $id.

Referenced by ilExPeerReview\__construct(), ilExSubmission\__construct(), ilExcAssMemberState\__construct(), ilExAssignmentGUI\addFiles(), ilExAssignmentGUI\addInstructions(), ilExAssignmentGUI\addPublicSubmissions(), ilExAssignmentGUI\addSchedule(), ilExAssignmentGUI\addSubmission(), ilExAssignmentGUI\addSubmissionFeedback(), canParticipantReceiveFeedback(), clearMultiFeedbackDirectory(), ilExAssTypeWikiTeam\cloneSpecificProperties(), delete(), ilExSubmission\downloadAllAssignmentFiles(), fixInstructionFileOrdering(), ilExAssignmentEditorGUI\generateTeams(), getCalculatedDeadlines(), getExerciseMemberAssignmentData(), getFiles(), ilExAssTypeWikiTeamGUI\getFormValuesArray(), getGlobalFeedbackFileStoragePath(), getMemberListData(), getMemberStatus(), getMultiFeedbackFiles(), ilExAssignmentGUI\getOverviewBody(), ilExAssignmentGUI\getOverviewHeader(), getPersonalDeadline(), handleCalendarEntries(), ilExAssTypeWikiTeam\handleNewUpload(), ilExAssTypeWikiTeamGUI\importFormToAssignment(), ilExAssignmentEditorGUI\importFormToAssignment(), ilExAssignmentEditorGUI\importPeerReviewFormToAssignment(), ilExerciseSubmissionTableGUI\parseColumns(), recalculateLateSubmissions(), saveMultiFeedbackFiles(), sendMultiFeedbackStructureFile(), setIndividualDeadline(), ilObjExercise\update(), update(), uploadAssignmentFiles(), and uploadMultiFeedbackFile().

                            : int
     {
         return $this->id;
     }

Here is the caller graph for this function:

◆ getIndividualDeadlines()

ilExAssignment::getIndividualDeadlines ( )

Definition at line 1901 of file class.ilExAssignment.php.

References $db, $ilDB, and $res.

Referenced by getMemberListData().

                                             : array
     {
         $ilDB = $this->db;
 
         $res = array();
 
         $set = $ilDB->query("SELECT * FROM exc_idl" .
             " WHERE ass_id = " . $ilDB->quote($this->getId(), "integer"));
         while ($row = $ilDB->fetchAssoc($set)) {
             if ($row["is_team"]) {
                 $row["member_id"] = "t" . $row["member_id"];
             }
 
             $res[$row["member_id"]] = $row["tstamp"];
         }
 
         return $res;
     }

Here is the caller graph for this function:

◆ getInstancesByExercise()

static ilExAssignment::getInstancesByExercise ( int $a_exc_id )

static

Parameters

int $a_exc_id

Returns: ilExAssignment[]

Exceptions

ilExcUnknownAssignmentTypeException

Definition at line 135 of file class.ilExAssignment.php.

References $data, $DIC, and $ilDB.

Referenced by ILIAS\Exercise\Assignment\Mandatory\RandomAssignmentsManager\__construct(), ilExGradesTableGUI\__construct(), ilCalendarScheduleFilterExercise\addCustomEvents(), ilObjExerciseGUI\addLocatorItems(), ilExerciseMembers\deassignMember(), ilExSubmission\deleteUser(), ilObjExercise\exportGradesExcel(), ILIAS\Exercise\Assignment\Mandatory\RandomAssignmentsManager\getAssignmentSelection(), ilExcCriteriaCatalogueTableGUI\getItems(), ILIAS\Exercise\Assignment\Mandatory\RandomAssignmentsManager\getNumberOfMandatoryAssignments(), ILIAS\Exercise\Assignment\Mandatory\RandomAssignmentsManager\getTotalNumberOfAssignments(), ilExerciseManagementGUI\membersObject(), ilAssignmentsPerParticipantTableGUI\parseData(), ilExerciseManagementCollectFilesJob\run(), and ilObjExercise\update().

                                                                 : array
     {
         global $DIC;
 
         $ilDB = $DIC->database();
 
         $set = $ilDB->query("SELECT * FROM exc_assignment " .
             " WHERE exc_id = " . $ilDB->quote($a_exc_id, "integer") .
             " ORDER BY order_nr");
         $data = array();
 
         $order_val = 10;
         while ($rec = $ilDB->fetchAssoc($set)) {
             // ???
             $rec["order_val"] = $order_val;
 
             $ass = new self();
             $ass->initFromDB($rec);
             $data[] = $ass;
 
             $order_val += 10;
         }
 
         return $data;
     }

Here is the caller graph for this function:

◆ getInstruction()

ilExAssignment::getInstruction ( )

Definition at line 324 of file class.ilExAssignment.php.

References $instruction.

Referenced by getInstructionPresentation(), save(), ilObjExercise\update(), and update().

                                     : string
     {
         return $this->instruction;
     }

Here is the caller graph for this function:

◆ getInstructionFilesOrder()

ilExAssignment::getInstructionFilesOrder ( )

Definition at line 1023 of file class.ilExAssignment.php.

References $data, $db, and $ilDB.

Referenced by fileAddOrder().

                                               : array
     {
         $ilDB = $this->db;
 
         $set = $ilDB->query(
             "SELECT filename, order_nr, id FROM exc_ass_file_order " .
             " WHERE assignment_id  = " . $ilDB->quote($this->getId(), "integer")
         );
 
         $data = array();
         while ($rec = $ilDB->fetchAssoc($set)) {
             $data[$rec['filename']] = $rec;
         }
 
         return $data;
     }

Here is the caller graph for this function:

◆ getInstructionPresentation()

ilExAssignment::getInstructionPresentation ( )

Definition at line 329 of file class.ilExAssignment.php.

References getInstruction().

                                                 : string
     {
         $inst = $this->getInstruction();
         if (trim($inst)) {
             $is_html = (strlen($inst) != strlen(strip_tags($inst)));
             if (!$is_html) {
                 $inst = nl2br(
                     $this->string_transform->makeClickable()->transform($inst)
                 );
             }
         }
         return $inst;
     }

Here is the call graph for this function:

◆ getLastPersonalDeadline()

ilExAssignment::getLastPersonalDeadline ( )

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

References $db, and $ilDB.

Referenced by afterDeadlineStrict().

                                              : int
     {
         $ilDB = $this->db;
 
         $set = $ilDB->query("SELECT MAX(tstamp) FROM exc_idl" .
             " WHERE ass_id = " . $ilDB->quote($this->getId(), "integer"));
         $row = $ilDB->fetchAssoc($set);
         return $row["tstamp"] ?? 0;
     }

Here is the caller graph for this function:

◆ getMandatory()

ilExAssignment::getMandatory ( )

Definition at line 358 of file class.ilExAssignment.php.

References $mandatory.

Referenced by save(), and update().

                                   : bool
     {
         return $this->mandatory;
     }

Here is the caller graph for this function:

◆ getMaxCharLimit()

ilExAssignment::getMaxCharLimit ( )

Definition at line 2173 of file class.ilExAssignment.php.

References $max_char_limit.

Referenced by ilExAssTypeTextGUI\getFormValuesArray(), save(), and update().

                                      : int
     {
         return $this->max_char_limit;
     }

Here is the caller graph for this function:

◆ getMaxFile()

ilExAssignment::getMaxFile ( )

Definition at line 625 of file class.ilExAssignment.php.

References $max_file.

Referenced by save(), and update().

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

Here is the caller graph for this function:

◆ getMemberListData()

ilExAssignment::getMemberListData ( )

Definition at line 1202 of file class.ilExAssignment.php.

References $db, $ilDB, $name, ilObject\_exists(), ilObjUser\_lookupName(), getId(), and getIndividualDeadlines().

                                        : array
     {
         $ilDB = $this->db;
 
         $mem = array();
 
         // first get list of members from member table
         $set = $ilDB->query("SELECT ud.usr_id, ud.lastname, ud.firstname, ud.login" .
             " FROM exc_members excm" .
             " JOIN usr_data ud ON (ud.usr_id = excm.usr_id)" .
             " WHERE excm.obj_id = " . $ilDB->quote($this->getExerciseId(), "integer"));
         while ($rec = $ilDB->fetchAssoc($set)) {
             $mem[$rec["usr_id"]] =
                 array(
                 "name" => $rec["lastname"] . ", " . $rec["firstname"],
                 "login" => $rec["login"],
                 "usr_id" => $rec["usr_id"],
                 "lastname" => $rec["lastname"],
                 "firstname" => $rec["firstname"]
                 );
         }
 
         // users in idl may already exist before occuring in the members db table
         // if user starts an assignment with relative deadline
         $idl = $this->getIndividualDeadlines();
         if (!$this->ass_type->usesTeams()) {
             foreach ($idl as $user_id => $v) {
                 if (!isset($mem[$user_id])) {
                     if (ilObjUser::_exists((int) $user_id)) {
                         $name = ilObjUser::_lookupName($user_id);
                         $mem[$user_id] =
                             array(
                                 "name" => $name["lastname"] . ", " . $name["firstname"],
                                 "login" => $name["login"],
                                 "usr_id" => $user_id,
                                 "lastname" => $name["lastname"],
                                 "firstname" => $name["firstname"]
                             );
                     }
                 }
             }
         }
 
         $q = "SELECT * FROM exc_mem_ass_status " .
             "WHERE ass_id = " . $ilDB->quote($this->getId(), "integer");
         $set = $ilDB->query($q);
         while ($rec = $ilDB->fetchAssoc($set)) {
             if (isset($mem[$rec["usr_id"]])) {
                 $sub = new ilExSubmission($this, $rec["usr_id"]);
 
                 $mem[$rec["usr_id"]]["sent_time"] = $rec["sent_time"];
                 $mem[$rec["usr_id"]]["submission"] = $sub->getLastSubmission();
                 $mem[$rec["usr_id"]]["status_time"] = $rec["status_time"];
                 $mem[$rec["usr_id"]]["feedback_time"] = $rec["feedback_time"];
                 $mem[$rec["usr_id"]]["notice"] = $rec["notice"];
                 $mem[$rec["usr_id"]]["status"] = $rec["status"];
                 $mem[$rec["usr_id"]]["mark"] = $rec["mark"];
                 $mem[$rec["usr_id"]]["comment"] = $rec["u_comment"];
             }
         }
         return $mem;
     }

Here is the call graph for this function:

◆ getMemberStatus()

ilExAssignment::getMemberStatus ( ?int $a_user_id = null )

Definition at line 1824 of file class.ilExAssignment.php.

References $ilUser, $user, and getId().

Referenced by ilExAssignmentGUI\addSubmissionFeedback(), ilExAssignmentGUI\getOverviewHeader(), ilObjExercise\processExerciseStatus(), saveMultiFeedbackFiles(), and ilObjExercise\update().

                                                            : ilExAssignmentMemberStatus
     {
         $ilUser = $this->user;
 
         if (!$a_user_id) {
             $a_user_id = $ilUser->getId();
         }
         if (!array_key_exists($a_user_id, $this->member_status)) {
             $this->member_status[$a_user_id] = new ilExAssignmentMemberStatus($this->getId(), $a_user_id);
         }
         return $this->member_status[$a_user_id];
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getMinCharLimit()

ilExAssignment::getMinCharLimit ( )

Definition at line 2162 of file class.ilExAssignment.php.

References $min_char_limit.

Referenced by ilExAssTypeTextGUI\getFormValuesArray(), save(), and update().

                                      : int
     {
         return $this->min_char_limit;
     }

Here is the caller graph for this function:

◆ getMultiFeedbackFiles()

ilExAssignment::getMultiFeedbackFiles ( int $a_user_id = 0 )

Get multi feedback files (of uploader)

Parameters

int $a_user_id user id of uploader

Returns: array array of user files (keys: lastname, firstname, user_id, login, file)

Definition at line 1451 of file class.ilExAssignment.php.

References Vendor\Package\$f, $i, $ilUser, $name, $parts, $user, ilObjUser\_lookupName(), count(), ilFileUtils\getDir(), getExerciseId(), getId(), and ILIAS\Repository\int().

Referenced by saveMultiFeedbackFiles().

                                                              : array
     {
         $ilUser = $this->user;
 
         if ($a_user_id == 0) {
             $a_user_id = $ilUser->getId();
         }
 
         $mf_files = array();
 
         // get members
         $exc = new ilObjExercise($this->getExerciseId(), false);
         $exmem = new ilExerciseMembers($exc);
         $mems = $exmem->getMembers();
 
         // read mf directory
         $storage = new ilFSStorageExercise($this->getExerciseId(), $this->getId());
         $mfu = $storage->getMultiFeedbackUploadPath($a_user_id);
 
         // get subdir that starts with multi_feedback
         $subdirs = ilFileUtils::getDir($mfu);
         $subdir = "notfound";
         foreach ($subdirs as $s => $j) {
             if ($j["type"] == "dir" && substr($s, 0, 14) == "multi_feedback") {
                 $subdir = $s;
             }
         }
 
         $items = ilFileUtils::getDir($mfu . "/" . $subdir);
         foreach ($items as $k => $i) {
             // check directory
             if ($i["type"] == "dir" && !in_array($k, array(".", ".."))) {
                 // check if valid member id is given
                 $parts = explode("_", $i["entry"]);
                 $user_id = (int) $parts[count($parts) - 1];
                 if (in_array($user_id, $mems)) {
                     // read dir of user
                     $name = ilObjUser::_lookupName($user_id);
                     $files = ilFileUtils::getDir($mfu . "/" . $subdir . "/" . $k);
                     foreach ($files as $k2 => $f) {
                         // append files to array
                         if ($f["type"] == "file" && substr($k2, 0, 1) != ".") {
                             $mf_files[] = array(
                                 "lastname" => $name["lastname"],
                                 "firstname" => $name["firstname"],
                                 "login" => $name["login"],
                                 "user_id" => $name["user_id"],
                                 "full_path" => $mfu . "/" . $subdir . "/" . $k . "/" . $k2,
                                 "file" => $k2);
                         }
                     }
                 }
             }
         }
         return $mf_files;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getOrderNr()

ilExAssignment::getOrderNr ( )

Definition at line 368 of file class.ilExAssignment.php.

References $order_nr.

Referenced by save(), and update().

                                 : int
     {
         return $this->order_nr;
     }

Here is the caller graph for this function:

◆ getPeerReview()

ilExAssignment::getPeerReview ( )

Definition at line 416 of file class.ilExAssignment.php.

References $peer.

Referenced by delete(), handleCalendarEntries(), hasReadOnlyIDl(), save(), and update().

                                    : bool
     {
         return $this->peer;
     }

Here is the caller graph for this function:

◆ getPeerReviewChars()

ilExAssignment::getPeerReviewChars ( )

Definition at line 517 of file class.ilExAssignment.php.

References $peer_char.

Referenced by save(), and update().

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

Here is the caller graph for this function:

◆ getPeerReviewCriteriaCatalogue()

ilExAssignment::getPeerReviewCriteriaCatalogue ( )

Definition at line 527 of file class.ilExAssignment.php.

References $crit_cat, $res, ilExcCriteria\getInstanceByType(), and ilExcCriteria\getInstancesByParentId().

Referenced by save(), and update().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getPeerReviewDeadline()

ilExAssignment::getPeerReviewDeadline ( )

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

References $peer_dl.

Referenced by handleCalendarEntries(), save(), and update().

                                            : int
     {
         return $this->peer_dl;
     }

Here is the caller graph for this function:

◆ getPeerReviewMin()

ilExAssignment::getPeerReviewMin ( )

Definition at line 426 of file class.ilExAssignment.php.

References $peer_min.

Referenced by save(), and update().

                                       : int
     {
         return $this->peer_min;
     }

Here is the caller graph for this function:

◆ getPeerReviewSimpleUnlock()

ilExAssignment::getPeerReviewSimpleUnlock ( )

Definition at line 436 of file class.ilExAssignment.php.

References $peer_unlock.

Referenced by save(), and update().

                                                : bool
     {
         return $this->peer_unlock;
     }

Here is the caller graph for this function:

◆ getPeerReviewValid()

ilExAssignment::getPeerReviewValid ( )

Definition at line 464 of file class.ilExAssignment.php.

References $peer_valid.

Referenced by save(), and update().

                                         : int
     {
         return $this->peer_valid;
     }

Here is the caller graph for this function:

◆ getPendingFeedbackNotifications()

static ilExAssignment::getPendingFeedbackNotifications ( )

static

Definition at line 1630 of file class.ilExAssignment.php.

References $DIC, $ilDB, and $res.

Referenced by ilExcCronFeedbackNotification\run().

                                                             : array
     {
         global $DIC;
 
         $ilDB = $DIC->database();
 
         $res = array();
 
         $set = $ilDB->query("SELECT id,fb_file,time_stamp,deadline2,fb_date FROM exc_assignment" .
             " WHERE fb_cron = " . $ilDB->quote(1, "integer") .
             " AND (fb_date = " . $ilDB->quote(self::FEEDBACK_DATE_DEADLINE, "integer") .
                 " AND time_stamp IS NOT NULL" .
                 " AND time_stamp > " . $ilDB->quote(0, "integer") .
                 " AND time_stamp < " . $ilDB->quote(time(), "integer") .
                 " AND fb_cron_done = " . $ilDB->quote(0, "integer") .
             ") OR (fb_date = " . $ilDB->quote(self::FEEDBACK_DATE_CUSTOM, "integer") .
                 " AND fb_date_custom IS NOT NULL" .
                 " AND fb_date_custom > " . $ilDB->quote(0, "integer") .
                 " AND fb_date_custom < " . $ilDB->quote(time(), "integer") .
                 " AND fb_cron_done = " . $ilDB->quote(0, "integer") . ")");
 
 
 
         while ($row = $ilDB->fetchAssoc($set)) {
             if ($row['fb_date'] == self::FEEDBACK_DATE_DEADLINE) {
                 $max = max($row['time_stamp'], $row['deadline2']);
                 if (trim($row["fb_file"]) && $max <= time()) {
                     $res[] = $row["id"];
                 }
             } elseif ($row['fb_date'] == self::FEEDBACK_DATE_CUSTOM) {
                 if (trim($row["fb_file"] ?? "") && ($row['fb_date_custom'] ?? 0) <= time()) {
                     $res[] = $row["id"];
                 }
             }
         }
 
         return $res;
     }

Here is the caller graph for this function:

◆ getPersonalDeadline()

ilExAssignment::getPersonalDeadline ( int $a_user_id )

Definition at line 272 of file class.ilExAssignment.php.

References $db, $ilDB, getDeadline(), getId(), and ilExAssignmentTeam\getTeamId().

Referenced by afterDeadline(), and recalculateLateSubmissions().

                                                        : int
     {
         $ilDB = $this->db;
 
         $is_team = false;
         if ($this->ass_type->usesTeams()) {
             $team_id = ilExAssignmentTeam::getTeamId($this->getId(), $a_user_id);
             if (!$team_id) {
                 // #0021043
                 return $this->getDeadline();
             }
             $a_user_id = $team_id;
             $is_team = true;
         }
 
         $set = $ilDB->query("SELECT tstamp FROM exc_idl" .
             " WHERE ass_id = " . $ilDB->quote($this->getId(), "integer") .
             " AND member_id = " . $ilDB->quote($a_user_id, "integer") .
             " AND is_team = " . $ilDB->quote($is_team, "integer"));
         $row = $ilDB->fetchAssoc($set);
 
         // use assignment deadline if no direct personal
         return max(($row["tstamp"] ?? 0), $this->getDeadline());
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getPortfolioTemplateId()

ilExAssignment::getPortfolioTemplateId ( )

Definition at line 636 of file class.ilExAssignment.php.

References $portfolio_template.

Referenced by ilExAssTypePortfolioGUI\getFormValuesArray(), save(), and update().

                                             : int
     {
         return $this->portfolio_template;
     }

Here is the caller graph for this function:

◆ getRelativeDeadline()

ilExAssignment::getRelativeDeadline ( )

Definition at line 255 of file class.ilExAssignment.php.

References $relative_deadline.

Referenced by getCalculatedDeadlines(), hasActiveIDl(), save(), and update().

                                          : int
     {
         return $this->relative_deadline;
     }

Here is the caller graph for this function:

◆ getRelDeadlineLastSubmission()

ilExAssignment::getRelDeadlineLastSubmission ( )

Definition at line 265 of file class.ilExAssignment.php.

References $rel_deadline_last_subm.

Referenced by save(), and update().

                                                   : int
     {
         return $this->rel_deadline_last_subm;
     }

Here is the caller graph for this function:

◆ getStartTime()

ilExAssignment::getStartTime ( )

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

References $start_time.

Referenced by save(), and update().

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

Here is the caller graph for this function:

◆ getTeamTutor()

ilExAssignment::getTeamTutor ( )

Definition at line 614 of file class.ilExAssignment.php.

References $team_tutor.

Referenced by save(), and update().

                                   : bool
     {
         return $this->team_tutor;
     }

Here is the caller graph for this function:

◆ getTitle()

ilExAssignment::getTitle ( )

Definition at line 348 of file class.ilExAssignment.php.

References $title.

Referenced by ilExAssignmentPeerReviewOverviewTableGUI\__construct(), ilExAssignmentPeerReviewTableGUI\__construct(), ilExAssignmentGUI\getOverviewHeader(), handleCalendarEntries(), save(), sendMultiFeedbackStructureFile(), ilObjExercise\update(), and update().

                               : string
     {
         return $this->title;
     }

Here is the caller graph for this function:

◆ getType()

ilExAssignment::getType ( )

Get type this will most probably become an non public function in the future (or become obsolete)

Definition at line 401 of file class.ilExAssignment.php.

References $type.

Referenced by ilExSubmission\downloadAllAssignmentFiles(), save(), and update().

                              : int
     {
         return $this->type;
     }

Here is the caller graph for this function:

◆ handleCalendarEntries()

ilExAssignment::handleCalendarEntries	(	string	$a_event,
		ilObjExercise	$exc
	)

protected

Handle calendar entries for deadline(s)

Exceptions

ilDateTimeException

Definition at line 1579 of file class.ilExAssignment.php.

References $app, $app_event_handler, DEADLINE_RELATIVE, getDeadline(), getDeadlineMode(), getId(), ilObject\getId(), getPeerReview(), getPeerReviewDeadline(), getTitle(), IL_CAL_UNIX, and ilCalendarEntry\TRANSLATION_SYSTEM.

Referenced by delete(), save(), and update().

      : void {
         $ilAppEventHandler = $this->app_event_handler;
 
         $dl_id = $this->getId() . "0";
         $fbdl_id = $this->getId() . "1";
 
         $context_ids = array($dl_id, $fbdl_id);
         $apps = array();
 
         if ($a_event != "delete") {
             // deadline or relative deadline given
             if ($this->getDeadline() || $this->getDeadlineMode() == ilExAssignment::DEADLINE_RELATIVE) {
                 $app = new ilCalendarAppointmentTemplate($dl_id);
                 $app->setTranslationType(ilCalendarEntry::TRANSLATION_SYSTEM);
                 $app->setSubtitle("cal_exc_deadline");
                 $app->setTitle($this->getTitle());
                 $app->setFullday(false);
                 // note: in the case of a relative deadline this will be set to 0 / 1970...)
                 // see ilCalendarScheduleFilterExercise for appointment modification
                 $app->setStart(new ilDateTime($this->getDeadline(), IL_CAL_UNIX));
 
                 $apps[] = $app;
             }
 
             if ($this->getPeerReview() &&
                 $this->getPeerReviewDeadline()) {
                 $app = new ilCalendarAppointmentTemplate($fbdl_id);
                 $app->setTranslationType(ilCalendarEntry::TRANSLATION_SYSTEM);
                 $app->setSubtitle("cal_exc_peer_review_deadline");
                 $app->setTitle($this->getTitle());
                 $app->setFullday(false);
                 $app->setStart(new ilDateTime($this->getPeerReviewDeadline(), IL_CAL_UNIX));
 
                 $apps[] = $app;
             }
         }
 
         $ilAppEventHandler->raise(
             'Modules/Exercise',
             $a_event . 'Assignment',
             array(
             'object' => $exc,
             'obj_id' => $exc->getId(),
             'context_ids' => $context_ids,
             'appointments' => $apps)
         );
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ handleGlobalFeedbackFileUpload()

ilExAssignment::handleGlobalFeedbackFileUpload ( array $a_file )

Exceptions

ilException

Definition at line 1803 of file class.ilExAssignment.php.

References $path, ilFileUtils\delDir(), getGlobalFeedbackFileStoragePath(), ilFileUtils\moveUploadedFile(), and setFeedbackFile().

Referenced by ilExAssignmentEditorGUI\importFormToAssignment().

                                                                  : bool
     {
         $path = $this->getGlobalFeedbackFileStoragePath();
         ilFileUtils::delDir($path, true);
         if (ilFileUtils::moveUploadedFile($a_file["tmp_name"], $a_file["name"], $path . "/" . $a_file["name"])) {
             $this->setFeedbackFile($a_file["name"]);
             return true;
         }
         return false;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ hasActiveIDl()

ilExAssignment::hasActiveIDl ( )

Definition at line 1920 of file class.ilExAssignment.php.

References getDeadline(), and getRelativeDeadline().

Referenced by ilExerciseSubmissionTableGUI\parseColumns().

                                   : bool
     {
         return (bool) $this->getDeadline() || (bool) $this->getRelativeDeadline();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ hasFeedbackCron()

ilExAssignment::hasFeedbackCron ( )

Definition at line 578 of file class.ilExAssignment.php.

References $feedback_cron.

Referenced by save(), and update().

                                      : bool
     {
         return $this->feedback_cron;
     }

Here is the caller graph for this function:

◆ hasPeerReviewFileUpload()

ilExAssignment::hasPeerReviewFileUpload ( )

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

References $peer_file.

Referenced by save(), and update().

                                              : bool
     {
         return $this->peer_file;
     }

Here is the caller graph for this function:

◆ hasPeerReviewPersonalized()

ilExAssignment::hasPeerReviewPersonalized ( )

Definition at line 504 of file class.ilExAssignment.php.

References $peer_personal.

Referenced by save(), and update().

                                                : bool
     {
         return $this->peer_personal;
     }

Here is the caller graph for this function:

◆ hasPeerReviewRating()

ilExAssignment::hasPeerReviewRating ( )

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

References $peer_rating.

Referenced by save(), and update().

                                          : bool
     {
         return $this->peer_rating;
     }

Here is the caller graph for this function:

◆ hasPeerReviewText()

ilExAssignment::hasPeerReviewText ( )

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

References $peer_text.

Referenced by save(), and update().

                                        : bool
     {
         return $this->peer_text;
     }

Here is the caller graph for this function:

◆ hasReadOnlyIDl()

ilExAssignment::hasReadOnlyIDl ( )

Definition at line 1925 of file class.ilExAssignment.php.

References getPeerReview().

Referenced by ilExerciseSubmissionTableGUI\parseColumns().

                                     : bool
     {
         if (!$this->ass_type->usesTeams() &&
             $this->getPeerReview()) {
             // all deadlines are read-only if we have peer feedback
             $peer_review = new ilExPeerReview($this);
             if ($peer_review->hasPeerReviewGroups()) {
                 return true;
             }
         }
 
         return false;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ hasTeam()

ilExAssignment::hasTeam ( )

Definition at line 191 of file class.ilExAssignment.php.

Referenced by ilExSubmission\__construct(), canParticipantReceiveFeedback(), ilExSubmission\downloadAllAssignmentFiles(), and ilExerciseSubmissionTableGUI\parseColumns().

                              : bool
     {
         return $this->ass_type->usesTeams();
     }

Here is the caller graph for this function:

◆ initFromDB()

ilExAssignment::initFromDB ( array $a_set )

protected

Import DB record.

Parameters

array $a_set

Exceptions

ilExcUnknownAssignmentTypeException

Definition at line 665 of file class.ilExAssignment.php.

References setDeadline(), setDeadlineMode(), setExerciseId(), setExtendedDeadline(), setFeedbackCron(), setFeedbackDate(), setFeedbackDateCustom(), setFeedbackFile(), setId(), setInstruction(), setMandatory(), setMaxCharLimit(), setMaxFile(), setMinCharLimit(), setOrderNr(), setPeerReview(), setPeerReviewChars(), setPeerReviewCriteriaCatalogue(), setPeerReviewDeadline(), setPeerReviewFileUpload(), setPeerReviewMin(), setPeerReviewPersonalized(), setPeerReviewRating(), setPeerReviewSimpleUnlock(), setPeerReviewText(), setPeerReviewValid(), setPortfolioTemplateId(), setRelativeDeadline(), setRelDeadlineLastSubmission(), setStartTime(), setTeamTutor(), setTitle(), and setType().

Referenced by read().

                                                : void
     {
         $this->setId((int) $a_set["id"]);
         $this->setExerciseId((int) $a_set["exc_id"]);
         $this->setDeadline((int) $a_set["time_stamp"]);
         $this->setExtendedDeadline((int) $a_set["deadline2"]);
         $this->setInstruction((string) $a_set["instruction"]);
         $this->setTitle((string) $a_set["title"]);
         $this->setStartTime((int) $a_set["start_time"]);
         $this->setOrderNr((int) $a_set["order_nr"]);
         $this->setMandatory((bool) $a_set["mandatory"]);
         $this->setType((int) $a_set["type"]);
         $this->setPeerReview((bool) $a_set["peer"]);
         $this->setPeerReviewMin((int) $a_set["peer_min"]);
         $this->setPeerReviewSimpleUnlock((bool) $a_set["peer_unlock"]);
         $this->setPeerReviewDeadline((int) $a_set["peer_dl"]);
         $this->setPeerReviewValid((int) $a_set["peer_valid"]);
         $this->setPeerReviewFileUpload((bool) $a_set["peer_file"]);
         $this->setPeerReviewPersonalized((bool) $a_set["peer_prsl"]);
         $this->setPeerReviewChars((int) $a_set["peer_char"]);
         $this->setPeerReviewText((bool) $a_set["peer_text"]);
         $this->setPeerReviewRating((bool) $a_set["peer_rating"]);
         $this->setPeerReviewCriteriaCatalogue((int) $a_set["peer_crit_cat"]);
         $this->setFeedbackFile((string) $a_set["fb_file"]);
         $this->setFeedbackDate((int) $a_set["fb_date"]);
         $this->setFeedbackDateCustom((int) $a_set["fb_date_custom"]);
         $this->setFeedbackCron((bool) $a_set["fb_cron"]);
         $this->setTeamTutor((bool) $a_set["team_tutor"]);
         $this->setMaxFile((int) $a_set["max_file"]);
         $this->setPortfolioTemplateId((int) $a_set["portfolio_template"]);
         $this->setMinCharLimit((int) $a_set["min_char_limit"]);
         $this->setMaxCharLimit((int) $a_set["max_char_limit"]);
         $this->setDeadlineMode((int) $a_set["deadline_mode"]);
         $this->setRelativeDeadline((int) $a_set["relative_deadline"]);
         $this->setRelDeadlineLastSubmission((int) $a_set["rel_deadline_last_subm"]);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ insertFileOrderNr()

static ilExAssignment::insertFileOrderNr	(	int	$a_ass_id,
		string	$a_filename,
		int	$a_order_nr
	)

static

Definition at line 1962 of file class.ilExAssignment.php.

References $DIC, ilDBInterface\insert(), and ilDBInterface\nextId().

Referenced by cloneAssignmentsOfExercise().

      : void {
         global $DIC;
         $db = $DIC->database();
         $id = $db->nextId("exc_ass_file_order");
         $db->insert(
             "exc_ass_file_order",
             [
                 "id" => ["integer", $id],
                 "order_nr" => ["integer", $a_order_nr],
                 "assignment_id" => ["integer", $a_ass_id],
                 "filename" => ["text", $a_filename]
             ]
         );
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ instructionFileDeleteOrder()

static ilExAssignment::instructionFileDeleteOrder	(	int	$a_ass_id,
		array	$a_file
	)

static

Parameters

list<string> $a_file

Definition at line 2018 of file class.ilExAssignment.php.

References $DIC, ilDBInterface\manipulate(), and ilDBInterface\quote().

Referenced by ilExAssignmentFileSystemGUI\deleteFile().

      : void {
         global $DIC;
 
         $db = $DIC->database();
 
         //now its done by filename. We need to figure how to get the order id in the confirmdelete method
         foreach ($a_file as $v) {
             $db->manipulate(
                 "DELETE FROM exc_ass_file_order " .
                 "WHERE filename = " . $db->quote($v, 'text') .
                 " AND assignment_id = " . $db->quote($a_ass_id, 'integer')
             );
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ instructionFileExistsInDb()

static ilExAssignment::instructionFileExistsInDb	(	string	$a_filename,
		int	$a_ass_id
	)

static

Definition at line 2061 of file class.ilExAssignment.php.

References $DIC, ilDBInterface\numRows(), ilDBInterface\query(), and ilDBInterface\quote().

      : int {
         global $DIC;
 
         $db = $DIC->database();
 
         if ($a_ass_id) {
             $result = $db->query(
                 "SELECT id FROM exc_ass_file_order" .
                 " WHERE assignment_id = " . $db->quote($a_ass_id, 'integer') .
                 " AND filename = " . $db->quote($a_filename, 'text')
             );
 
             return $db->numRows($result);
         }
 
         return 0;
     }

Here is the call graph for this function:

◆ instructionFileGetFileOrderData()

static ilExAssignment::instructionFileGetFileOrderData	(	array	$a_file_data,
		int	$a_ass_id
	)

static

Parameters

array	$a_file_data
int	$a_ass_id	assignment id

Returns: int[]

Definition at line 166 of file class.ilExAssignment.php.

References $DIC, ilDBInterface\fetchAssoc(), ILIAS\Repository\int(), ilDBInterface\query(), and ilDBInterface\setLimit().

      : array {
         global $DIC;
 
         $db = $DIC->database();
         $db->setLimit(1, 0);
 
         $result_order_val = $db->query("
                                 SELECT id, order_nr
                                 FROM exc_ass_file_order
                                 WHERE assignment_id = {$db->quote($a_ass_id, 'integer')}
                                 AND filename = {$db->quote($a_file_data['entry'], 'text')}
                         ");
 
         $order_val = 0;
         $order_id = 0;
         while ($row = $db->fetchAssoc($result_order_val)) {
             $order_val = (int) $row['order_nr'];
             $order_id = (int) $row['id'];
         }
         return array($order_val, $order_id);
     }

Here is the call graph for this function:

◆ instructionFileInsertOrder()

static ilExAssignment::instructionFileInsertOrder	(	string	$a_filename,
		int	$a_ass_id,
		int	$a_order_nr = `0`
	)

static

Definition at line 1982 of file class.ilExAssignment.php.

References $DIC, $filename, ilFileUtils\getSafeFilename(), ilDBInterface\manipulate(), and ilDBInterface\quote().

Referenced by ilExerciseDataSet\importRecord(), and ilExAssignmentFileSystemGUI\uploadFile().

      : void {
         global $DIC;
 
         $db = $DIC->database();
 
         if ($a_ass_id) {
             //first of all check the suffix and change if necessary
             $filename = ilFileUtils::getSafeFilename($a_filename);
 
             if (self::instructionFileExistsInDb($filename, $a_ass_id) == 0) {
                 if ($a_order_nr == 0) {
                     $order_val = self::instructionFileOrderGetMax($a_ass_id);
                     $order = $order_val + 10;
                 } else {
                     $order = $a_order_nr;
                 }
 
                 $id = $db->nextID('exc_ass_file_order');
                 $db->manipulate("INSERT INTO exc_ass_file_order " .
                     "(id, assignment_id, filename, order_nr) VALUES (" .
                     $db->quote($id, "integer") . "," .
                     $db->quote($a_ass_id, "integer") . "," .
                     $db->quote($filename, "text") . "," .
                     $db->quote($order, "integer") .
                     ")");
             }
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ instructionFileOrderGetMax()

static ilExAssignment::instructionFileOrderGetMax ( int $a_ass_id )

static

Definition at line 2135 of file class.ilExAssignment.php.

References $DIC, ilDBInterface\fetchAssoc(), ILIAS\Repository\int(), ilDBInterface\queryF(), and ilDBInterface\quote().

                                                                     : int
     {
         global $DIC;
 
         $db = $DIC->database();
 
         //get max order number
         $result = $db->queryF(
             "SELECT max(order_nr) as max_order FROM exc_ass_file_order WHERE assignment_id = %s",
             array('integer'),
             array($db->quote($a_ass_id, 'integer'))
         );
 
         $order_val = 0;
         while ($row = $db->fetchAssoc($result)) {
             $order_val = (int) $row['max_order'];
         }
         return $order_val;
     }

Here is the call graph for this function:

◆ isInExercise()

static ilExAssignment::isInExercise	(	int	$a_ass_id,
		int	$a_ex_id
	)

static

Definition at line 1185 of file class.ilExAssignment.php.

References $DIC, and $ilDB.

Referenced by ILIAS\Exercise\Assignment\Mandatory\RandomAssignmentsDBRepository\getAssignmentsOfUser(), and ILIAS\Exercise\Assignment\Mandatory\RandomAssignmentsDBRepository\saveAssignmentsOfUser().

                                                                     : bool
     {
         global $DIC;
 
         $ilDB = $DIC->database();
 
         $set = $ilDB->query(
             "SELECT * FROM exc_assignment " .
             " WHERE exc_id = " . $ilDB->quote($a_ex_id, "integer") .
             " AND id = " . $ilDB->quote($a_ass_id, "integer")
         );
         if ($ilDB->fetchAssoc($set)) {
             return true;
         }
         return false;
     }

Here is the caller graph for this function:

◆ isValidType()

ilExAssignment::isValidType ( int $a_value )

Definition at line 406 of file class.ilExAssignment.php.

Referenced by setType().

                                              : bool
     {
         return $this->types->isValidId($a_value);
     }

Here is the caller graph for this function:

◆ lookup()

static ilExAssignment::lookup	(	int	$a_id,
		string	$a_field
	)

staticprivate

Definition at line 1084 of file class.ilExAssignment.php.

References $DIC, and $ilDB.

                                                               : string
     {
         global $DIC;
 
         $ilDB = $DIC->database();
 
         $set = $ilDB->query(
             "SELECT " . $a_field . " FROM exc_assignment " .
             " WHERE id = " . $ilDB->quote($a_id, "integer")
         );
 
         $rec = $ilDB->fetchAssoc($set);
 
         return $rec[$a_field] ?? "";
     }

◆ lookupAssignmentOnline()

static ilExAssignment::lookupAssignmentOnline ( int $a_ass_id )

static

Definition at line 1057 of file class.ilExAssignment.php.

References $DIC, $ilDB, $query, and $res.

Referenced by ilObjExerciseSubItemListGUI\isAssignmentVisible().

                                                                 : bool
     {
         global $DIC;
 
         $ilDB = $DIC->database();
 
         $query = "SELECT id FROM exc_assignment " .
             "WHERE start_time <= " . $ilDB->quote(time(), 'integer') . ' ' .
             "AND time_stamp >= " . $ilDB->quote(time(), 'integer') . ' ' .
             "AND id = " . $ilDB->quote($a_ass_id, 'integer');
         $res = $ilDB->query($query);
 
         return (bool) $res->numRows();
     }

Here is the caller graph for this function:

◆ lookupExerciseId()

static ilExAssignment::lookupExerciseId ( int $a_ass_id )

static

Definition at line 1072 of file class.ilExAssignment.php.

References $DIC, $ilDB, $query, and $res.

Referenced by ilObjExerciseGUI\__construct(), and ilExerciseGSToolProvider\getAssignmentInfo().

                                                           : int
     {
         global $DIC;
 
         $ilDB = $DIC->database();
         $query = "SELECT exc_id FROM exc_assignment " .
             "WHERE id = " . $ilDB->quote($a_ass_id, 'integer');
         $res = $ilDB->fetchAssoc($ilDB->query($query));
 
         return (int) ($res["exc_id"] ?? 0);
     }

Here is the caller graph for this function:

◆ lookupMaxOrderNrForEx()

static ilExAssignment::lookupMaxOrderNrForEx ( int $a_exc_id )

static

Definition at line 1041 of file class.ilExAssignment.php.

References $DIC, and $ilDB.

                                                                : int
     {
         global $DIC;
 
         $ilDB = $DIC->database();
 
         $set = $ilDB->query(
             "SELECT MAX(order_nr) mnr FROM exc_assignment " .
             " WHERE exc_id = " . $ilDB->quote($a_exc_id, "integer")
         );
         if ($rec = $ilDB->fetchAssoc($set)) {
             return (int) $rec["mnr"];
         }
         return 0;
     }

◆ lookupTitle()

static ilExAssignment::lookupTitle ( int $a_id )

static

Definition at line 1100 of file class.ilExAssignment.php.

Referenced by ilExAssignmentReminder\checkReminders(), ilExAssignmentEditorGUI\confirmAssignmentsDeletionObject(), ilExSubmission\downloadMultipleFiles(), ilObjExerciseSubItemListGUI\getHTML(), ilExerciseManagementGUI\initMultiFeedbackForm(), ilExcMailTemplateSubmitReminderContext\resolveSpecificPlaceholder(), ilExcMailTemplateGradeReminderContext\resolveSpecificPlaceholder(), ilExcMailTemplatePeerReminderContext\resolveSpecificPlaceholder(), ilDownloadSubmissionsBackgroundTask\run(), and ilExerciseMailNotification\send().

                                                  : string
     {
         return self::lookup($a_id, "title");
     }

Here is the caller graph for this function:

◆ lookupType()

static ilExAssignment::lookupType ( int $a_id )

static

Definition at line 1105 of file class.ilExAssignment.php.

Referenced by ilParticipantsPerAssignmentTableGUI\__construct(), ilExSubmission\getAllAssignmentFiles(), ilExSubmission\getAssignmentFilesByUsers(), and ilExerciseMailNotification\send().

                                                 : string
     {
         return self::lookup($a_id, "type");
     }

Here is the caller graph for this function:

◆ notStartedYet()

ilExAssignment::notStartedYet ( )

Definition at line 1779 of file class.ilExAssignment.php.

                                    : bool
     {
         return (time() - $this->start_time <= 0);
     }

◆ orderAssByDeadline()

static ilExAssignment::orderAssByDeadline ( int $a_ex_id )

static

Definition at line 1132 of file class.ilExAssignment.php.

References $DIC, and $ilDB.

Referenced by ilExAssignmentEditorGUI\orderAssignmentsByDeadlineObject().

                                                            : void
     {
         global $DIC;
         $ilDB = $DIC->database();
 
         $set = $ilDB->query(
             "SELECT id FROM exc_assignment " .
             " WHERE exc_id = " . $ilDB->quote($a_ex_id, "integer") .
             " ORDER BY time_stamp"
         );
         $nr = 10;
         while ($rec = $ilDB->fetchAssoc($set)) {
             $ilDB->manipulate(
                 "UPDATE exc_assignment SET " .
                 " order_nr = " . $ilDB->quote($nr, "integer") .
                 " WHERE id = " . $ilDB->quote($rec["id"], "integer")
             );
             $nr += 10;
         }
     }

Here is the caller graph for this function:

◆ read()

ilExAssignment::read ( )

Exceptions

ilExcUnknownAssignmentTypeException

Definition at line 644 of file class.ilExAssignment.php.

References $db, $ilDB, and initFromDB().

Referenced by __construct().

                           : void
     {
         $ilDB = $this->db;
 
         $set = $ilDB->query(
             "SELECT * FROM exc_assignment " .
             " WHERE id = " . $ilDB->quote($this->getId(), "integer")
         );
         $rec = $ilDB->fetchAssoc($set);
 
         // #16172 - might be deleted
         if (is_array($rec)) {
             $this->initFromDB($rec);
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ recalculateLateSubmissions()

ilExAssignment::recalculateLateSubmissions ( )

Exceptions

ilDateTimeException

Definition at line 1840 of file class.ilExAssignment.php.

References $db, $ilDB, ilExSubmission\getAllAssignmentFiles(), getExtendedDeadline(), getId(), getPersonalDeadline(), IL_CAL_DATETIME, and IL_CAL_UNIX.

                                                 : void
     {
         $ilDB = $this->db;
 
         // see JF, 2015-05-11
 
         $ext_deadline = $this->getExtendedDeadline();
 
         foreach (ilExSubmission::getAllAssignmentFiles($this->exc_id, $this->getId()) as $file) {
             $id = $file["returned_id"];
             $uploaded = new ilDateTime($file["ts"], IL_CAL_DATETIME);
             $uploaded = $uploaded->get(IL_CAL_UNIX);
 
             $deadline = $this->getPersonalDeadline($file["user_id"]);
             $last_deadline = max($deadline, $this->getExtendedDeadline());
 
             $late = null;
 
             // upload is not late anymore
             if ($file["late"] &&
                 (!$last_deadline ||
                 !$ext_deadline ||
                 $uploaded < $deadline)) {
                 $late = false;
             }
             // upload is now late
             elseif (!$file["late"] &&
                 $ext_deadline &&
                 $deadline &&
                 $uploaded > $deadline) {
                 $late = true;
             }
 
             if ($late !== null) {
                 $ilDB->manipulate("UPDATE exc_returned" .
                     " SET late = " . $ilDB->quote($late, "integer") .
                     " WHERE returned_id = " . $ilDB->quote($id, "integer"));
             }
         }
     }

Here is the call graph for this function:

◆ renameInstructionFile()

static ilExAssignment::renameInstructionFile	(	string	$a_old_name,
		string	$a_new_name,
		int	$a_ass_id
	)

static

Definition at line 2036 of file class.ilExAssignment.php.

References $DIC, ilDBInterface\manipulate(), and ilDBInterface\quote().

Referenced by ilExAssignmentFileSystemGUI\renameFile().

      : void {
         global $DIC;
 
         $db = $DIC->database();
 
         if ($a_ass_id) {
             $db->manipulate(
                 "DELETE FROM exc_ass_file_order" .
                 " WHERE assignment_id = " . $db->quote($a_ass_id, 'integer') .
                 " AND filename = " . $db->quote($a_new_name, 'text')
             );
 
             $db->manipulate(
                 "UPDATE exc_ass_file_order SET" .
                 " filename = " . $db->quote($a_new_name, 'text') .
                 " WHERE assignment_id = " . $db->quote($a_ass_id, 'integer') .
                 " AND filename = " . $db->quote($a_old_name, 'text')
             );
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ save()

ilExAssignment::save ( )

Exceptions

ilDateTimeException

Definition at line 705 of file class.ilExAssignment.php.

References $db, $ilDB, getDeadline(), getDeadlineMode(), getExerciseId(), getExtendedDeadline(), getFeedbackDate(), getFeedbackDateCustom(), getFeedbackFile(), getInstruction(), getMandatory(), getMaxCharLimit(), getMaxFile(), getMinCharLimit(), getOrderNr(), getPeerReview(), getPeerReviewChars(), getPeerReviewCriteriaCatalogue(), getPeerReviewDeadline(), getPeerReviewMin(), getPeerReviewSimpleUnlock(), getPeerReviewValid(), getPortfolioTemplateId(), getRelativeDeadline(), getRelDeadlineLastSubmission(), getStartTime(), getTeamTutor(), getTitle(), getType(), handleCalendarEntries(), hasFeedbackCron(), hasPeerReviewFileUpload(), hasPeerReviewPersonalized(), hasPeerReviewRating(), hasPeerReviewText(), setId(), and setOrderNr().

Referenced by ilExAssignmentEditorGUI\importFormToAssignment().

                           : void
     {
         $ilDB = $this->db;
 
         if ($this->getOrderNr() == 0) {
             $this->setOrderNr(
                 self::lookupMaxOrderNrForEx($this->getExerciseId())
                 + 10
             );
         }
 
         $next_id = $ilDB->nextId("exc_assignment");
         $ilDB->insert("exc_assignment", array(
             "id" => array("integer", $next_id),
             "exc_id" => array("integer", $this->getExerciseId()),
             "time_stamp" => array("integer", $this->getDeadline()),
             "deadline2" => array("integer", $this->getExtendedDeadline()),
             "instruction" => array("clob", $this->getInstruction()),
             "title" => array("text", $this->getTitle()),
             "start_time" => array("integer", $this->getStartTime()),
             "order_nr" => array("integer", $this->getOrderNr()),
             "mandatory" => array("integer", $this->getMandatory()),
             "type" => array("integer", $this->getType()),
             "peer" => array("integer", $this->getPeerReview()),
             "peer_min" => array("integer", $this->getPeerReviewMin()),
             "peer_unlock" => array("integer", $this->getPeerReviewSimpleUnlock()),
             "peer_dl" => array("integer", $this->getPeerReviewDeadline()),
             "peer_valid" => array("integer", $this->getPeerReviewValid()),
             "peer_file" => array("integer", $this->hasPeerReviewFileUpload()),
             "peer_prsl" => array("integer", $this->hasPeerReviewPersonalized()),
             "peer_char" => array("integer", $this->getPeerReviewChars()),
             "peer_text" => array("integer", (int) $this->hasPeerReviewText()),
             "peer_rating" => array("integer", (int) $this->hasPeerReviewRating()),
             "peer_crit_cat" => array("integer", $this->getPeerReviewCriteriaCatalogue()),
             "fb_file" => array("text", $this->getFeedbackFile()),
             "fb_date" => array("integer", $this->getFeedbackDate()),
             "fb_date_custom" => array("integer", $this->getFeedbackDateCustom()),
             "fb_cron" => array("integer", $this->hasFeedbackCron()),
             "team_tutor" => array("integer", $this->getTeamTutor()),
             "max_file" => array("integer", $this->getMaxFile()),
             "portfolio_template" => array("integer", $this->getPortfolioTemplateId()),
             "min_char_limit" => array("integer", $this->getMinCharLimit()),
             "max_char_limit" => array("integer", $this->getMaxCharLimit()),
             "relative_deadline" => array("integer", $this->getRelativeDeadline()),
             "rel_deadline_last_subm" => array("integer", $this->getRelDeadlineLastSubmission()),
             "deadline_mode" => array("integer", $this->getDeadlineMode())
             ));
         $this->setId($next_id);
         $exc = new ilObjExercise($this->getExerciseId(), false);
         $exc->updateAllUsersStatus();
         self::createNewAssignmentRecords($next_id, $exc);
 
         $this->handleCalendarEntries("create", $exc);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ saveAssOrderOfExercise()

static ilExAssignment::saveAssOrderOfExercise	(	int	$a_ex_id,
		array	$a_order
	)

static

Definition at line 1111 of file class.ilExAssignment.php.

References $DIC, and $ilDB.

Referenced by ilExAssignmentEditorGUI\saveAssignmentOrderObject().

                                                                                : void
     {
         global $DIC;
 
         $ilDB = $DIC->database();
 
         asort($a_order);
         $nr = 10;
         foreach ($a_order as $k => $v) {
             // the check for exc_id is for security reasons. ass ids are unique.
             $ilDB->manipulate(
                 "UPDATE exc_assignment SET " .
                 " order_nr = " . $ilDB->quote($nr, "integer") .
                 " WHERE id = " . $ilDB->quote((int) $k, "integer") .
                 " AND exc_id = " . $ilDB->quote($a_ex_id, "integer")
             );
             $nr += 10;
         }
     }

Here is the caller graph for this function:

◆ saveInstructionFilesOrderOfAssignment()

static ilExAssignment::saveInstructionFilesOrderOfAssignment	(	int	$a_ass_id,
		array	$a_order
	)

static

Definition at line 1939 of file class.ilExAssignment.php.

References $DIC, ilDBInterface\manipulate(), and ilDBInterface\quote().

Referenced by ilExAssignmentFileSystemGUI\saveFilesOrder().

      : void {
         global $DIC;
 
         $db = $DIC->database();
 
         asort($a_order, SORT_NUMERIC);
 
         $nr = 10;
         foreach (array_keys($a_order) as $k) {
             // the check for exc_id is for security reasons. ass ids are unique.
             $db->manipulate(
                 "UPDATE exc_ass_file_order SET " .
                 " order_nr = " . $db->quote($nr, "integer") .
                 " WHERE id = " . $db->quote((int) $k, "integer") .
                 " AND assignment_id = " . $db->quote($a_ass_id, "integer")
             );
             $nr += 10;
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ saveMultiFeedbackFiles()

ilExAssignment::saveMultiFeedbackFiles	(	array	$a_files,
		ilObjExercise	$a_exc
	)

Parameters

array<int,list<string>> $a_files

Definition at line 1523 of file class.ilExAssignment.php.

References Vendor\Package\$f, clearMultiFeedbackDirectory(), getExerciseId(), getId(), ilObject\getId(), getMemberStatus(), getMultiFeedbackFiles(), ilFileUtils\rename(), and ilObjExercise\sendFeedbackFileNotification().

      : void {
         if ($this->getExerciseId() != $a_exc->getId()) {
             return;
         }
 
         $fstorage = new ilFSStorageExercise($this->getExerciseId(), $this->getId());
         $fstorage->create();
 
         $mf_files = $this->getMultiFeedbackFiles();
         foreach ($mf_files as $f) {
             $user_id = $f["user_id"];
             $file_path = $f["full_path"];
             $file_name = $f["file"];
 
             // if checked in confirmation gui
             if (is_array($a_files[$user_id] ?? false) && in_array(md5($file_name), $a_files[$user_id])) {
                 $submission = new ilExSubmission($this, $user_id);
                 $feedback_id = $submission->getFeedbackId();
                 $noti_rec_ids = $submission->getUserIds();
 
                 if ($feedback_id) {
                     $fb_path = $fstorage->getFeedbackPath($feedback_id);
                     $target = $fb_path . "/" . $file_name;
                     if (is_file($target)) {
                         unlink($target);
                     }
                     // rename file
                     ilFileUtils::rename($file_path, $target);
 
                     if ($noti_rec_ids) {
                         foreach ($noti_rec_ids as $user_id) {
                             $member_status = $this->getMemberStatus($user_id);
                             $member_status->setFeedback(true);
                             $member_status->update();
                         }
 
                         $a_exc->sendFeedbackFileNotification(
                             $file_name,
                             $noti_rec_ids,
                             $this->getId()
                         );
                     }
                 }
             }
         }
 
         $this->clearMultiFeedbackDirectory();
     }

Here is the call graph for this function:

◆ sendFeedbackNotifications()

static ilExAssignment::sendFeedbackNotifications	(	int	$a_ass_id,
		int	$a_user_id = `null`
	)

static

Exceptions

ilExcUnknownAssignmentTypeException

Definition at line 1672 of file class.ilExAssignment.php.

References $DIC, $ilDB, and ilExerciseMembers\_getMembers().

Referenced by ilExAssignmentMemberStatus\postUpdateReturned(), and ilExcCronFeedbackNotification\run().

      : bool {
         global $DIC;
 
         $ilDB = $DIC->database();
 
         $ass = new self($a_ass_id);
 
         // valid assignment?
         if (!$ass->hasFeedbackCron() || !$ass->getFeedbackFile()) {
             return false;
         }
 
         if (!$a_user_id) {
             // already done?
             $set = $ilDB->query("SELECT fb_cron_done" .
                 " FROM exc_assignment" .
                 " WHERE id = " . $ilDB->quote($a_ass_id, "integer"));
             $row = $ilDB->fetchAssoc($set);
             if ($row["fb_cron_done"]) {
                 return false;
             }
         }
 
         $ntf = new ilSystemNotification();
         $ntf->setLangModules(array("exc"));
         $ntf->setObjId($ass->getExerciseId());
         $ntf->setSubjectLangId("exc_feedback_notification_subject");
         $ntf->setIntroductionLangId("exc_feedback_notification_body");
         $ntf->addAdditionalInfo("exc_assignment", $ass->getTitle());
         $ntf->setGotoLangId("exc_feedback_notification_link");
         $ntf->setReasonLangId("exc_feedback_notification_reason");
 
         if (!$a_user_id) {
             $ntf->sendMail(ilExerciseMembers::_getMembers($ass->getExerciseId()));
 
             $ilDB->manipulate("UPDATE exc_assignment" .
                 " SET fb_cron_done = " . $ilDB->quote(1, "integer") .
                 " WHERE id = " . $ilDB->quote($a_ass_id, "integer"));
         } else {
             $ntf->sendMail(array($a_user_id));
         }
 
         return true;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ sendMultiFeedbackStructureFile()

ilExAssignment::sendMultiFeedbackStructureFile ( ilObjExercise $exercise )

Create member status record for a new assignment for all participants.

Definition at line 1368 of file class.ilExAssignment.php.

References $access, $name, ilObjUser\_lookupName(), ilFileDelivery\deliverFileLegacy(), ilOrgUnitPositionAndRBACAccessHandler\filterUserIdsByRbacOrPositionOfCurrentUser(), ilFileUtils\getASCIIFilename(), getExerciseId(), getId(), ilObject\getRefId(), getTitle(), ilFileUtils\ilTempnam(), ilFileUtils\makeDir(), and ilFileUtils\zip().

                                                                            : void
     {
         $access = $this->access;
 
         // send and delete the zip file
         $deliverFilename = trim(str_replace(" ", "_", $this->getTitle() . "_" . $this->getId()));
         $deliverFilename = ilFileUtils::getASCIIFilename($deliverFilename);
         $deliverFilename = "multi_feedback_" . $deliverFilename;
 
         $exc = new ilObjExercise($this->getExerciseId(), false);
 
         $cdir = getcwd();
 
         // create temporary directoy
         $tmpdir = ilFileUtils::ilTempnam();
         ilFileUtils::makeDir($tmpdir);
         $mfdir = $tmpdir . "/" . $deliverFilename;
         ilFileUtils::makeDir($mfdir);
 
         // create subfolders <lastname>_<firstname>_<id> for each participant
         $exmem = new ilExerciseMembers($exc);
         $mems = $exmem->getMembers();
 
         $mems = $access->filterUserIdsByRbacOrPositionOfCurrentUser(
             'edit_submissions_grades',
             'edit_submissions_grades',
             $exercise->getRefId(),
             $mems
         );
         foreach ($mems as $mem) {
             $name = ilObjUser::_lookupName($mem);
             $subdir = $name["lastname"] . "_" . $name["firstname"] . "_" . $name["login"] . "_" . $name["user_id"];
             $subdir = ilFileUtils::getASCIIFilename($subdir);
             ilFileUtils::makeDir($mfdir . "/" . $subdir);
         }
 
         // create the zip file
         chdir($tmpdir);
         $tmpzipfile = $tmpdir . "/multi_feedback.zip";
         ilFileUtils::zip($tmpdir, $tmpzipfile, true);
         chdir($cdir);
 
 
         ilFileDelivery::deliverFileLegacy($tmpzipfile, $deliverFilename . ".zip", "", false, true);
     }

Here is the call graph for this function:

◆ setDeadline()

ilExAssignment::setDeadline ( ?int $a_val )

Definition at line 226 of file class.ilExAssignment.php.

Referenced by ilExAssignmentEditorGUI\importFormToAssignment(), and initFromDB().

                                             : void
     {
         $this->deadline = $a_val;
     }

Here is the caller graph for this function:

◆ setDeadlineMode()

ilExAssignment::setDeadlineMode ( int $a_val )

Set deadline mode.

Parameters

int $a_val deadline mode (self::DEADLINE_ABSOLUTE | self::DEADLINE_ABSOLUTE)

Definition at line 240 of file class.ilExAssignment.php.

Referenced by ilExAssignmentEditorGUI\importFormToAssignment(), and initFromDB().

                                                : void
     {
         $this->deadline_mode = $a_val;
     }

Here is the caller graph for this function:

◆ setExerciseId()

ilExAssignment::setExerciseId ( int $a_val )

Definition at line 206 of file class.ilExAssignment.php.

Referenced by initFromDB().

                                              : void
     {
         $this->exc_id = $a_val;
     }

Here is the caller graph for this function:

◆ setExtendedDeadline()

ilExAssignment::setExtendedDeadline ( ?int $a_val )

Definition at line 309 of file class.ilExAssignment.php.

Referenced by ilExAssignmentEditorGUI\importFormToAssignment(), and initFromDB().

                                                     : void
     {
         $this->deadline2 = $a_val;
     }

Here is the caller graph for this function:

◆ setFeedbackCron()

ilExAssignment::setFeedbackCron ( bool $a_value )

Toggle (global) feedback file cron.

Definition at line 573 of file class.ilExAssignment.php.

Referenced by ilExAssignmentEditorGUI\importFormToAssignment(), and initFromDB().

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

Here is the caller graph for this function:

◆ setFeedbackDate()

ilExAssignment::setFeedbackDate ( int $a_value )

Definition at line 584 of file class.ilExAssignment.php.

Referenced by __construct(), ilExAssignmentEditorGUI\importFormToAssignment(), and initFromDB().

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

Here is the caller graph for this function:

◆ setFeedbackDateCustom()

ilExAssignment::setFeedbackDateCustom ( int $a_value )

Set (global) feedback file availability using a custom date.

Parameters

int $a_value timestamp

Definition at line 598 of file class.ilExAssignment.php.

Referenced by ilExAssignmentEditorGUI\importFormToAssignment(), and initFromDB().

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

Here is the caller graph for this function:

◆ setFeedbackFile()

ilExAssignment::setFeedbackFile ( ?string $a_value )

Definition at line 560 of file class.ilExAssignment.php.

Referenced by handleGlobalFeedbackFileUpload(), ilExAssignmentEditorGUI\importFormToAssignment(), and initFromDB().

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

Here is the caller graph for this function:

◆ setId()

ilExAssignment::setId ( int $a_val )

Definition at line 196 of file class.ilExAssignment.php.

Referenced by __construct(), initFromDB(), and save().

                                      : void
     {
         $this->id = $a_val;
     }

Here is the caller graph for this function:

◆ setIndividualDeadline()

ilExAssignment::setIndividualDeadline	(	string	$id,
		ilDateTime	$date
	)

Definition at line 1886 of file class.ilExAssignment.php.

References ilDateTime\get(), getId(), ilExcIndividualDeadline\getInstance(), and IL_CAL_UNIX.

      : void {
         $is_team = false;
         if (!is_numeric($id)) {
             $id = substr($id, 1);
             $is_team = true;
         }
 
         $idl = ilExcIndividualDeadline::getInstance($this->getId(), (int) $id, $is_team);
         $idl->setIndividualDeadline($date->get(IL_CAL_UNIX));
         $idl->save();
     }

Here is the call graph for this function:

◆ setInstruction()

ilExAssignment::setInstruction ( string $a_val )

Definition at line 319 of file class.ilExAssignment.php.

Referenced by ilExAssignmentEditorGUI\importFormToAssignment(), and initFromDB().

                                                  : void
     {
         $this->instruction = $a_val;
     }

Here is the caller graph for this function:

◆ setMandatory()

ilExAssignment::setMandatory ( bool $a_val )

Definition at line 353 of file class.ilExAssignment.php.

Referenced by ilExAssignmentEditorGUI\importFormToAssignment(), and initFromDB().

                                              : void
     {
         $this->mandatory = $a_val;
     }

Here is the caller graph for this function:

◆ setMaxCharLimit()

ilExAssignment::setMaxCharLimit ( int $a_val )

Definition at line 2168 of file class.ilExAssignment.php.

Referenced by ilExAssTypeTextGUI\importFormToAssignment(), and initFromDB().

                                                : void
     {
         $this->max_char_limit = $a_val;
     }

Here is the caller graph for this function:

◆ setMaxFile()

ilExAssignment::setMaxFile ( ?int $a_value )

Definition at line 620 of file class.ilExAssignment.php.

Referenced by ilExAssignmentEditorGUI\importFormToAssignment(), and initFromDB().

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

Here is the caller graph for this function:

◆ setMinCharLimit()

ilExAssignment::setMinCharLimit ( int $a_val )

Definition at line 2157 of file class.ilExAssignment.php.

Referenced by ilExAssTypeTextGUI\importFormToAssignment(), and initFromDB().

                                                : void
     {
         $this->min_char_limit = $a_val;
     }

Here is the caller graph for this function:

◆ setOrderNr()

ilExAssignment::setOrderNr ( int $a_val )

Definition at line 363 of file class.ilExAssignment.php.

Referenced by initFromDB(), and save().

                                           : void
     {
         $this->order_nr = $a_val;
     }

Here is the caller graph for this function:

◆ setPeerReview()

ilExAssignment::setPeerReview ( bool $a_value )

Definition at line 411 of file class.ilExAssignment.php.

Referenced by ilExAssignmentEditorGUI\importFormToAssignment(), initFromDB(), and setType().

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

Here is the caller graph for this function:

◆ setPeerReviewChars()

ilExAssignment::setPeerReviewChars ( ?int $a_value )

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

References ILIAS\Repository\int().

Referenced by ilExAssignmentEditorGUI\importPeerReviewFormToAssignment(), and initFromDB().

                                                      : void
     {
         $a_value = (is_numeric($a_value) && (int) $a_value > 0)
             ? (int) $a_value
             : null;
         $this->peer_char = $a_value;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setPeerReviewCriteriaCatalogue()

ilExAssignment::setPeerReviewCriteriaCatalogue ( ?int $a_value )

Definition at line 522 of file class.ilExAssignment.php.

Referenced by ilExAssignmentEditorGUI\importPeerReviewFormToAssignment(), and initFromDB().

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

Here is the caller graph for this function:

◆ setPeerReviewDeadline()

ilExAssignment::setPeerReviewDeadline ( int $a_val )

Parameters

int	deadline (timestamp)

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

Referenced by ilExAssignmentEditorGUI\importPeerReviewFormToAssignment(), and initFromDB().

                                                      : void
     {
         $this->peer_dl = $a_val;
     }

Here is the caller graph for this function:

◆ setPeerReviewFileUpload()

ilExAssignment::setPeerReviewFileUpload ( bool $a_val )

Definition at line 489 of file class.ilExAssignment.php.

Referenced by ilExAssignmentEditorGUI\importFormToAssignment(), ilExAssignmentEditorGUI\importPeerReviewFormToAssignment(), and initFromDB().

                                                         : void
     {
         $this->peer_file = $a_val;
     }

Here is the caller graph for this function:

◆ setPeerReviewMin()

ilExAssignment::setPeerReviewMin ( int $a_value )

Definition at line 421 of file class.ilExAssignment.php.

Referenced by ilExAssignmentEditorGUI\importFormToAssignment(), ilExAssignmentEditorGUI\importPeerReviewFormToAssignment(), and initFromDB().

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

Here is the caller graph for this function:

◆ setPeerReviewPersonalized()

ilExAssignment::setPeerReviewPersonalized ( bool $a_val )

Definition at line 499 of file class.ilExAssignment.php.

Referenced by ilExAssignmentEditorGUI\importFormToAssignment(), ilExAssignmentEditorGUI\importPeerReviewFormToAssignment(), and initFromDB().

                                                           : void
     {
         $this->peer_personal = $a_val;
     }

Here is the caller graph for this function:

◆ setPeerReviewRating()

ilExAssignment::setPeerReviewRating ( bool $a_val )

Definition at line 469 of file class.ilExAssignment.php.

Referenced by ilExAssignmentEditorGUI\importFormToAssignment(), ilExAssignmentEditorGUI\importPeerReviewFormToAssignment(), and initFromDB().

                                                     : void
     {
         $this->peer_rating = $a_val;
     }

Here is the caller graph for this function:

◆ setPeerReviewSimpleUnlock()

ilExAssignment::setPeerReviewSimpleUnlock ( bool $a_value )

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

Referenced by ilExAssignmentEditorGUI\importFormToAssignment(), ilExAssignmentEditorGUI\importPeerReviewFormToAssignment(), and initFromDB().

     {
         $this->peer_unlock = $a_value;
     }

Here is the caller graph for this function:

◆ setPeerReviewText()

ilExAssignment::setPeerReviewText ( bool $a_val )

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

Referenced by ilExAssignmentEditorGUI\importFormToAssignment(), ilExAssignmentEditorGUI\importPeerReviewFormToAssignment(), and initFromDB().

                                                   : void
     {
         $this->peer_text = $a_val;
     }

Here is the caller graph for this function:

◆ setPeerReviewValid()

ilExAssignment::setPeerReviewValid ( int $a_value )

Set peer review validation.

Parameters

int $a_value (self::PEER_REVIEW_VALID_NONE, self::PEER_REVIEW_VALID_ONE, self::PEER_REVIEW_VALID_ALL)

Definition at line 459 of file class.ilExAssignment.php.

Referenced by ilExAssignmentEditorGUI\importFormToAssignment(), ilExAssignmentEditorGUI\importPeerReviewFormToAssignment(), and initFromDB().

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

Here is the caller graph for this function:

◆ setPortfolioTemplateId()

ilExAssignment::setPortfolioTemplateId ( int $a_val )

Definition at line 631 of file class.ilExAssignment.php.

Referenced by ilExAssTypePortfolioGUI\importFormToAssignment(), and initFromDB().

                                                       : void
     {
         $this->portfolio_template = $a_val;
     }

Here is the caller graph for this function:

◆ setRelativeDeadline()

ilExAssignment::setRelativeDeadline ( int $a_val )

Definition at line 250 of file class.ilExAssignment.php.

Referenced by ilExAssignmentEditorGUI\importFormToAssignment(), and initFromDB().

                                                    : void
     {
         $this->relative_deadline = $a_val;
     }

Here is the caller graph for this function:

◆ setRelDeadlineLastSubmission()

ilExAssignment::setRelDeadlineLastSubmission ( int $a_val )

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

Referenced by ilExAssignmentEditorGUI\importFormToAssignment(), and initFromDB().

                                                             : void
     {
         $this->rel_deadline_last_subm = $a_val;
     }

Here is the caller graph for this function:

◆ setStartTime()

ilExAssignment::setStartTime ( ?int $a_val )

Definition at line 216 of file class.ilExAssignment.php.

Referenced by ilExAssignmentEditorGUI\importFormToAssignment(), and initFromDB().

                                              : void
     {
         $this->start_time = $a_val;
     }

Here is the caller graph for this function:

◆ setTeamTutor()

ilExAssignment::setTeamTutor ( bool $a_value )

Definition at line 609 of file class.ilExAssignment.php.

Referenced by ilExAssignmentEditorGUI\importFormToAssignment(), and initFromDB().

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

Here is the caller graph for this function:

◆ setTitle()

ilExAssignment::setTitle ( string $a_val )

Definition at line 343 of file class.ilExAssignment.php.

Referenced by ilExAssignmentEditorGUI\importFormToAssignment(), and initFromDB().

                                            : void
     {
         $this->title = $a_val;
     }

Here is the caller graph for this function:

◆ setType()

ilExAssignment::setType ( int $a_value )

Set type this will most probably become an non public function in the future (or become obsolete)

Exceptions

ilExcUnknownAssignmentTypeException

Definition at line 378 of file class.ilExAssignment.php.

References isValidType(), and setPeerReview().

Referenced by __construct(), and initFromDB().

                                          : void
     {
         if ($this->isValidType($a_value)) {
             $this->type = $a_value;
 
             $this->ass_type = $this->types->getById($a_value);
 
             if ($this->ass_type->usesTeams()) {
                 $this->setPeerReview(false);
             }
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ update()

ilExAssignment::update ( )

Exceptions

ilDateTimeException

Definition at line 763 of file class.ilExAssignment.php.

References $db, $ilDB, getDeadline(), getDeadlineMode(), getExerciseId(), getExtendedDeadline(), getFeedbackDate(), getFeedbackDateCustom(), getFeedbackFile(), getId(), getInstruction(), getMandatory(), getMaxCharLimit(), getMaxFile(), getMinCharLimit(), getOrderNr(), getPeerReview(), getPeerReviewChars(), getPeerReviewCriteriaCatalogue(), getPeerReviewDeadline(), getPeerReviewMin(), getPeerReviewSimpleUnlock(), getPeerReviewValid(), getPortfolioTemplateId(), getRelativeDeadline(), getRelDeadlineLastSubmission(), getStartTime(), getTeamTutor(), getTitle(), getType(), handleCalendarEntries(), hasFeedbackCron(), hasPeerReviewFileUpload(), hasPeerReviewPersonalized(), hasPeerReviewRating(), and hasPeerReviewText().

Referenced by ilExAssignmentEditorGUI\importFormToAssignment(), and ilExAssignmentEditorGUI\importPeerReviewFormToAssignment().

                             : void
     {
         $ilDB = $this->db;
 
         $ilDB->update(
             "exc_assignment",
             array(
             "exc_id" => array("integer", $this->getExerciseId()),
             "time_stamp" => array("integer", $this->getDeadline()),
             "deadline2" => array("integer", $this->getExtendedDeadline()),
             "instruction" => array("clob", $this->getInstruction()),
             "title" => array("text", $this->getTitle()),
             "start_time" => array("integer", $this->getStartTime()),
             "order_nr" => array("integer", $this->getOrderNr()),
             "mandatory" => array("integer", $this->getMandatory()),
             "type" => array("integer", $this->getType()),
             "peer" => array("integer", $this->getPeerReview()),
             "peer_min" => array("integer", $this->getPeerReviewMin()),
             "peer_unlock" => array("integer", $this->getPeerReviewSimpleUnlock()),
             "peer_dl" => array("integer", $this->getPeerReviewDeadline()),
             "peer_valid" => array("integer", $this->getPeerReviewValid()),
             "peer_file" => array("integer", $this->hasPeerReviewFileUpload()),
             "peer_prsl" => array("integer", $this->hasPeerReviewPersonalized()),
             "peer_char" => array("integer", $this->getPeerReviewChars()),
             "peer_text" => array("integer", (int) $this->hasPeerReviewText()),
             "peer_rating" => array("integer", (int) $this->hasPeerReviewRating()),
             "peer_crit_cat" => array("integer", $this->getPeerReviewCriteriaCatalogue()),
             "fb_file" => array("text", $this->getFeedbackFile()),
             "fb_date" => array("integer", $this->getFeedbackDate()),
             "fb_date_custom" => array("integer", $this->getFeedbackDateCustom()),
             "fb_cron" => array("integer", $this->hasFeedbackCron()),
             "team_tutor" => array("integer", $this->getTeamTutor()),
             "max_file" => array("integer", $this->getMaxFile()),
             "portfolio_template" => array("integer", $this->getPortfolioTemplateId()),
             "min_char_limit" => array("integer", $this->getMinCharLimit()),
             "max_char_limit" => array("integer", $this->getMaxCharLimit()),
             "deadline_mode" => array("integer", $this->getDeadlineMode()),
             "relative_deadline" => array("integer", $this->getRelativeDeadline()),
             "rel_deadline_last_subm" => array("integer", $this->getRelDeadlineLastSubmission())
             ),
             array(
             "id" => array("integer", $this->getId()),
             )
         );
         $exc = new ilObjExercise($this->getExerciseId(), false);
         $exc->updateAllUsersStatus();
 
         $this->handleCalendarEntries("update", $exc);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ uploadAssignmentFiles()

ilExAssignment::uploadAssignmentFiles ( array $a_files )

Upload assignment files (from creation form)

Definition at line 1352 of file class.ilExAssignment.php.

References getExerciseId(), getId(), and ilLoggerFactory\getLogger().

Referenced by ilExAssignmentEditorGUI\importFormToAssignment().

                                                          : void
     {
         ilLoggerFactory::getLogger("exc")->debug("upload assignment files files = ", $a_files);
         $storage = new ilFSWebStorageExercise($this->getExerciseId(), $this->getId());
         $storage->create();
         $storage->uploadAssignmentFiles($a_files);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ uploadMultiFeedbackFile()

ilExAssignment::uploadMultiFeedbackFile ( array $a_file )

Exceptions

ilException
ilExerciseException

Definition at line 1418 of file class.ilExAssignment.php.

References $ilUser, $lng, $user, ilFileUtils\delDir(), ilFileUtils\getDir(), getExerciseId(), getId(), ilFileUtils\moveUploadedFile(), ilLanguage\txt(), and ilFileUtils\unzip().

                                                           : void
     {
         $lng = $this->lng;
         $ilUser = $this->user;
 
         if (!is_file($a_file["tmp_name"])) {
             throw new ilExerciseException($lng->txt("exc_feedback_file_could_not_be_uploaded"));
         }
 
         $storage = new ilFSStorageExercise($this->getExerciseId(), $this->getId());
         $mfu = $storage->getMultiFeedbackUploadPath($ilUser->getId());
         ilFileUtils::delDir($mfu, true);
         ilFileUtils::moveUploadedFile($a_file["tmp_name"], "multi_feedback.zip", $mfu . "/" . "multi_feedback.zip");
         ilFileUtils::unzip($mfu . "/multi_feedback.zip", true);
         $subdirs = ilFileUtils::getDir($mfu);
         $subdir = "notfound";
         foreach ($subdirs as $s => $j) {
             if ($j["type"] == "dir" && substr($s, 0, 14) == "multi_feedback") {
                 $subdir = $s;
             }
         }
 
         if (!is_dir($mfu . "/" . $subdir)) {
             throw new ilExerciseException($lng->txt("exc_no_feedback_dir_found_in_zip"));
         }
     }

Here is the call graph for this function:

Field Documentation

◆ $access

ilAccessHandler ilExAssignment::$access

protected

Definition at line 61 of file class.ilExAssignment.php.

Referenced by sendMultiFeedbackStructureFile().

◆ $app_event_handler

ilAppEventHandler ilExAssignment::$app_event_handler

protected

Definition at line 60 of file class.ilExAssignment.php.

Referenced by handleCalendarEntries().

◆ $ass_type

ilExAssignmentTypeInterface ilExAssignment::$ass_type

protected

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

Referenced by getAssignmentType().

◆ $crit_cat

int ilExAssignment::$crit_cat = 0

protected

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

Referenced by getPeerReviewCriteriaCatalogue().

◆ $db

ilDBInterface ilExAssignment::$db

protected

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

Referenced by delete(), fixInstructionFileOrdering(), getIndividualDeadlines(), getInstructionFilesOrder(), getLastPersonalDeadline(), getMemberListData(), getPersonalDeadline(), read(), recalculateLateSubmissions(), save(), and update().

◆ $deadline

int ilExAssignment::$deadline = null

protected

Definition at line 67 of file class.ilExAssignment.php.

Referenced by getDeadline().

◆ $deadline2

int ilExAssignment::$deadline2 = null

protected

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

Referenced by getExtendedDeadline().

◆ $deadline_mode

int ilExAssignment::$deadline_mode = 0

protected

Definition at line 95 of file class.ilExAssignment.php.

Referenced by getDeadlineMode().

◆ $exc_id

int ilExAssignment::$exc_id = 0

protected

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

Referenced by getExerciseId().

◆ $feedback_cron

bool ilExAssignment::$feedback_cron = false

protected

Definition at line 85 of file class.ilExAssignment.php.

Referenced by hasFeedbackCron().

◆ $feedback_date

int ilExAssignment::$feedback_date = 0

protected

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

Referenced by getFeedbackDate().

◆ $feedback_date_custom

int ilExAssignment::$feedback_date_custom = 0

protected

Definition at line 87 of file class.ilExAssignment.php.

Referenced by getFeedbackDateCustom().

◆ $feedback_file

string ilExAssignment::$feedback_file = null

protected

Definition at line 84 of file class.ilExAssignment.php.

Referenced by getFeedbackFile().

◆ $id

int ilExAssignment::$id = 0

protected

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

Referenced by getId().

◆ $instruction

string ilExAssignment::$instruction = ""

protected

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

Referenced by getInstruction().

◆ $lng

ilLanguage ilExAssignment::$lng

protected

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

Referenced by uploadMultiFeedbackFile().

◆ $log

ilLogger ilExAssignment::$log

protected

Definition at line 99 of file class.ilExAssignment.php.

◆ $mandatory

bool ilExAssignment::$mandatory = false

protected

Definition at line 71 of file class.ilExAssignment.php.

Referenced by getMandatory().

◆ $max_char_limit

int ilExAssignment::$max_char_limit = 0

protected

Definition at line 92 of file class.ilExAssignment.php.

Referenced by getMaxCharLimit().

◆ $max_file

int ilExAssignment::$max_file = null

protected

Definition at line 89 of file class.ilExAssignment.php.

Referenced by getMaxFile().

◆ $member_status

array ilExAssignment::$member_status = []

protected

Definition at line 98 of file class.ilExAssignment.php.

◆ $min_char_limit

int ilExAssignment::$min_char_limit = 0

protected

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

Referenced by getMinCharLimit().

◆ $order_nr

int ilExAssignment::$order_nr = 0

protected

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

Referenced by getOrderNr().

◆ $peer

bool ilExAssignment::$peer = false

protected

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

Referenced by getPeerReview().

◆ $peer_char

int ilExAssignment::$peer_char = null

protected

Definition at line 80 of file class.ilExAssignment.php.

Referenced by getPeerReviewChars().

◆ $peer_crit_cat

int ilExAssignment::$peer_crit_cat = 0

protected

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

◆ $peer_dl

int ilExAssignment::$peer_dl = 0

protected

Definition at line 76 of file class.ilExAssignment.php.

Referenced by getPeerReviewDeadline().

◆ $peer_file

bool ilExAssignment::$peer_file = false

protected

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

Referenced by hasPeerReviewFileUpload().

◆ $peer_min

int ilExAssignment::$peer_min = 0

protected

Definition at line 74 of file class.ilExAssignment.php.

Referenced by getPeerReviewMin().

◆ $peer_personal

bool ilExAssignment::$peer_personal = false

protected

Definition at line 79 of file class.ilExAssignment.php.

Referenced by hasPeerReviewPersonalized().

◆ $peer_rating

bool ilExAssignment::$peer_rating = false

protected

Definition at line 82 of file class.ilExAssignment.php.

Referenced by hasPeerReviewRating().

◆ $peer_text

bool ilExAssignment::$peer_text = false

protected

Definition at line 81 of file class.ilExAssignment.php.

Referenced by hasPeerReviewText().

◆ $peer_unlock

bool ilExAssignment::$peer_unlock = false

protected

Definition at line 75 of file class.ilExAssignment.php.

Referenced by getPeerReviewSimpleUnlock().

◆ $peer_valid

int ilExAssignment::$peer_valid

protected

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

Referenced by getPeerReviewValid().

◆ $portfolio_template

int ilExAssignment::$portfolio_template = 0

protected

Definition at line 90 of file class.ilExAssignment.php.

Referenced by getPortfolioTemplateId().

◆ $rel_deadline_last_subm

int ilExAssignment::$rel_deadline_last_subm = 0

protected

Definition at line 97 of file class.ilExAssignment.php.

Referenced by getRelDeadlineLastSubmission().

◆ $relative_deadline

int ilExAssignment::$relative_deadline = 0

protected

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

Referenced by getRelativeDeadline().

◆ $start_time

int ilExAssignment::$start_time = null

protected

Definition at line 66 of file class.ilExAssignment.php.

Referenced by getStartTime().

◆ $string_transform

ILIAS Refinery String Group ilExAssignment::$string_transform

protected

Definition at line 55 of file class.ilExAssignment.php.

◆ $team_tutor

bool ilExAssignment::$team_tutor = false

protected

Definition at line 88 of file class.ilExAssignment.php.

Referenced by getTeamTutor().

◆ $title

string ilExAssignment::$title = ""

protected

Definition at line 70 of file class.ilExAssignment.php.

Referenced by getTitle().

◆ $type

int ilExAssignment::$type = 0

protected

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

Referenced by getCalculatedDeadlines(), and getType().

◆ $types

ilExAssignmentTypes ilExAssignment::$types

protected

Definition at line 93 of file class.ilExAssignment.php.

◆ $user

ilObjUser ilExAssignment::$user

protected

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

Referenced by afterDeadline(), clearMultiFeedbackDirectory(), getMemberStatus(), getMultiFeedbackFiles(), and uploadMultiFeedbackFile().

◆ DEADLINE_ABSOLUTE

const ilExAssignment::DEADLINE_ABSOLUTE = 0

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

Referenced by ilAssignmentsTableGUI\fillRow(), ilExcAssMemberState\getCommonDeadline(), ilExcAssMemberState\getOfficialDeadline(), ilExcAssMemberState\hasSubmissionStarted(), and ilExAssignmentEditorGUI\processForm().

◆ DEADLINE_RELATIVE

const ilExAssignment::DEADLINE_RELATIVE = 1

Definition at line 54 of file class.ilExAssignment.php.

Referenced by ilCalendarScheduleFilterExercise\addCustomEvents(), ilExcAssMemberState\getCalculatedDeadline(), ilExcAssMemberState\getIndividualStart(), ilExcAssMemberState\getLastSubmissionOfRelativeDeadline(), ilExcAssMemberState\getRelativeDeadline(), ilExcAssMemberState\getRelativeDeadlinePresentation(), handleCalendarEntries(), ilCalendarScheduleFilterExercise\modifyEvent(), ilParticipantsPerAssignmentTableGUI\parseModeColumns(), and ilExAssignmentEditorGUI\processForm().

◆ FEEDBACK_DATE_CUSTOM

const ilExAssignment::FEEDBACK_DATE_CUSTOM = 3

Definition at line 42 of file class.ilExAssignment.php.

Referenced by ilExAssignmentGUI\addSubmission(), ilExAssignmentEditorGUI\initAssignmentForm(), and ilExcAssMemberState\isGlobalFeedbackFileAccessible().

◆ FEEDBACK_DATE_DEADLINE

const ilExAssignment::FEEDBACK_DATE_DEADLINE = 1

Definition at line 40 of file class.ilExAssignment.php.

Referenced by ilExAssignmentGUI\addSubmission(), ilExAssignmentEditorGUI\initAssignmentForm(), ilExcAssMemberState\isGlobalFeedbackFileAccessible(), and ilExAssignmentEditorGUI\processForm().

◆ FEEDBACK_DATE_SUBMISSION

const ilExAssignment::FEEDBACK_DATE_SUBMISSION = 2

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

Referenced by ilExAssignmentEditorGUI\initAssignmentForm(), and ilExAssignmentMemberStatus\postUpdateReturned().

◆ PEER_REVIEW_VALID_ALL

const ilExAssignment::PEER_REVIEW_VALID_ALL = 3

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

Referenced by ilExAssignmentEditorGUI\initPeerReviewForm(), and ilExPeerReview\isFeedbackValidForPassed().

◆ PEER_REVIEW_VALID_NONE

const ilExAssignment::PEER_REVIEW_VALID_NONE = 1

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

Referenced by ilExAssignmentEditorGUI\importFormToAssignment(), ilExAssignmentEditorGUI\importPeerReviewFormToAssignment(), ilExAssignmentEditorGUI\initPeerReviewForm(), ilExPeerReview\isFeedbackValidForPassed(), and ilExPeerReviewGUI\resetPeerReviewObject().

◆ PEER_REVIEW_VALID_ONE

const ilExAssignment::PEER_REVIEW_VALID_ONE = 2

Definition at line 45 of file class.ilExAssignment.php.

Referenced by ilExAssignmentEditorGUI\initPeerReviewForm(), and ilExPeerReview\isFeedbackValidForPassed().

◆ TEAMS_FORMED_BY_ASSIGNMENT

const ilExAssignment::TEAMS_FORMED_BY_ASSIGNMENT = 3

Definition at line 51 of file class.ilExAssignment.php.

Referenced by ilExAssignmentEditorGUI\generateTeams(), ilExAssignmentEditorGUI\initAssignmentForm(), and ilExAssignmentEditorGUI\processForm().

◆ TEAMS_FORMED_BY_PARTICIPANTS

const ilExAssignment::TEAMS_FORMED_BY_PARTICIPANTS = 0

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

Referenced by ilExAssignmentEditorGUI\initAssignmentForm().

◆ TEAMS_FORMED_BY_RANDOM

const ilExAssignment::TEAMS_FORMED_BY_RANDOM = 2

Definition at line 50 of file class.ilExAssignment.php.

Referenced by ilExAssignmentEditorGUI\generateTeams(), ilExAssignmentEditorGUI\initAssignmentForm(), and ilExAssignmentEditorGUI\processForm().

◆ TEAMS_FORMED_BY_TUTOR

const ilExAssignment::TEAMS_FORMED_BY_TUTOR = 1

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

Referenced by ilExAssignmentEditorGUI\generateTeams(), ilExAssignmentEditorGUI\initAssignmentForm(), and ilExAssignmentEditorGUI\processForm().

◆ TYPE_BLOG

const ilExAssignment::TYPE_BLOG = 2

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

Referenced by ilExerciseManagementCollectFilesJob\__construct(), ilExerciseManagementCollectFilesJob\addLink(), ilExerciseManagementCollectFilesJob\collectAssignmentData(), ilExSubmission\downloadAllAssignmentFiles(), ilExSubmission\downloadFiles(), ilExAssignmentTypes\getAllIds(), ilExAssignmentTypesGUI\getById(), ilExAssignmentTypes\getById(), ilExSubmission\getDownloadedFilesInfoForTableGUIS(), ilExSubmission\getFiles(), and ilExSubmissionObjectGUI\getOverviewContent().

◆ TYPE_PORTFOLIO

const ilExAssignment::TYPE_PORTFOLIO = 3

Definition at line 35 of file class.ilExAssignment.php.

Referenced by ilExerciseManagementCollectFilesJob\__construct(), ilExerciseManagementCollectFilesJob\addLink(), ilExerciseManagementCollectFilesJob\collectAssignmentData(), ilExSubmission\downloadAllAssignmentFiles(), ilExSubmission\downloadFiles(), ilExAssignmentTypes\getAllIds(), ilExAssignmentTypesGUI\getById(), ilExAssignmentTypes\getById(), ilExSubmission\getDownloadedFilesInfoForTableGUIS(), ilExSubmission\getFiles(), ilExSubmissionObjectGUI\getOverviewContent(), and ilObjPortfolioGUI\linkPortfolioToAssignment().

◆ TYPE_TEXT

const ilExAssignment::TYPE_TEXT = 5

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

Referenced by ilExerciseSubmissionTableGUI\__construct(), ilExerciseManagementCollectFilesJob\collectAssignmentData(), ilExSubmissionTextGUI\executeCommand(), ilExAssignmentTypes\getAllIds(), ilExAssignmentTypesGUI\getById(), ilExAssignmentTypes\getById(), ilExSubmission\getDownloadedFilesInfoForTableGUIS(), ilExPeerReviewGUI\getSubmissionContent(), ilExerciseManagementCollectFilesJob\isExcelNeeded(), ilExSubmissionGUI\listPublicSubmissionsObject(), and ilExerciseManagementGUI\membersObject().

◆ TYPE_UPLOAD

const ilExAssignment::TYPE_UPLOAD = 1

direct checks against const should be avoided, use type objects instead

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

Referenced by ilExerciseManagementCollectFilesJob\__construct(), ilExerciseManagementCollectFilesJob\addLink(), ilExerciseManagementCollectFilesJob\collectAssignmentData(), ilExAssignmentTypes\getAllIds(), ilExAssignmentTypesGUI\getById(), ilExAssignmentTypes\getById(), ilExSubmission\getDownloadedFilesInfoForTableGUIS(), ilExerciseManagementCollectFilesJob\isExcelNeeded(), and ilExerciseMailNotification\send().

◆ TYPE_UPLOAD_TEAM

const ilExAssignment::TYPE_UPLOAD_TEAM = 4

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

Referenced by ilExerciseManagementCollectFilesJob\__construct(), ilExcAssMemberState\__construct(), ilExerciseManagementCollectFilesJob\collectAssignmentData(), ilExAssignmentTeam\getAdoptableTeamAssignments(), ilExAssignmentTypes\getAllIds(), ilExAssignmentTypesGUI\getById(), ilExAssignmentTypes\getById(), ilExSubmission\getDownloadedFilesInfoForTableGUIS(), ilExcAssMemberState\getInstanceByIds(), ilExerciseManagementCollectFilesJob\isExcelNeeded(), and ilExerciseManagementGUI\membersObject().

◆ TYPE_WIKI_TEAM

const ilExAssignment::TYPE_WIKI_TEAM = 6

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

Referenced by ilExSubmission\downloadFiles(), ilWikiPageGUI\finalizeAssignment(), ilExAssignmentTypes\getAllIds(), ilExAssignmentTypesGUI\getById(), ilExAssignmentTypes\getById(), ilExSubmission\getDownloadedFilesInfoForTableGUIS(), ilExSubmission\getFiles(), ilObjWikiListGUI\getProperties(), and ilExerciseDataSet\importRecord().

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

Modules/Exercise/Assignment/class.ilExAssignment.php

Public Member Functions

Static Public Member Functions

Data Fields

Protected Member Functions

Protected Attributes

Static Private Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ afterCustomDate()

◆ afterDeadline()

◆ afterDeadlineStrict()

◆ beforeDeadline()

◆ canParticipantReceiveFeedback()

◆ clearMultiFeedbackDirectory()

◆ cloneAssignmentsOfExercise()

◆ count()

◆ countMandatory()

◆ createNewAssignmentRecords()

◆ createNewUserRecords()

◆ delete()

◆ deleteGlobalFeedbackFile()

◆ fileAddOrder()

◆ fixInstructionFileOrdering()

◆ getAssignmentDataOfExercise()

◆ getAssignmentType()

◆ getCalculatedDeadlines()

◆ getDeadline()

◆ getDeadlineMode()

◆ getExerciseId()

◆ getExerciseMemberAssignmentData()

◆ getExtendedDeadline()

◆ getFeedbackDate()

◆ getFeedbackDateCustom()

◆ getFeedbackFile()

◆ getFiles()

◆ getGlobalFeedbackFilePath()

◆ getGlobalFeedbackFileStoragePath()

◆ getId()

◆ getIndividualDeadlines()

◆ getInstancesByExercise()

◆ getInstruction()

◆ getInstructionFilesOrder()

◆ getInstructionPresentation()

◆ getLastPersonalDeadline()

◆ getMandatory()

◆ getMaxCharLimit()

◆ getMaxFile()

◆ getMemberListData()

◆ getMemberStatus()

◆ getMinCharLimit()

◆ getMultiFeedbackFiles()

◆ getOrderNr()

◆ getPeerReview()

◆ getPeerReviewChars()

◆ getPeerReviewCriteriaCatalogue()

◆ getPeerReviewDeadline()

◆ getPeerReviewMin()

◆ getPeerReviewSimpleUnlock()

◆ getPeerReviewValid()

◆ getPendingFeedbackNotifications()

◆ getPersonalDeadline()

◆ getPortfolioTemplateId()

◆ getRelativeDeadline()

◆ getRelDeadlineLastSubmission()

◆ getStartTime()

◆ getTeamTutor()

◆ getTitle()

◆ getType()

◆ handleCalendarEntries()

◆ handleGlobalFeedbackFileUpload()

◆ hasActiveIDl()

◆ hasFeedbackCron()

◆ hasPeerReviewFileUpload()

◆ hasPeerReviewPersonalized()

◆ hasPeerReviewRating()

◆ hasPeerReviewText()

◆ hasReadOnlyIDl()

◆ hasTeam()