ilExAssignment Class Reference

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.

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

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

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.

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

afterDeadline()

ilExAssignment::afterDeadline

(

)

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

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

References $ilUser.

afterDeadlineStrict()

ilExAssignment::afterDeadlineStrict

(

bool

$a_include_personal = true

)

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

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

beforeDeadline()

ilExAssignment::beforeDeadline

(

)

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

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

canParticipantReceiveFeedback()

ilExAssignment::canParticipantReceiveFeedback

(

int

$part_id

)

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

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

References ILIAS\Survey\Mode\getId(), and ilExAssignmentTeam\getTeamId().

Here is the call graph for this function:

clearMultiFeedbackDirectory()

ilExAssignment::clearMultiFeedbackDirectory

(

)

Clear multi feedback directory.

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

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

References $ilUser, ilFileUtils\delDir(), and ILIAS\Survey\Mode\getId().

Here is the call 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.

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

References $d, ilExAssignmentTypeInterface\cloneSpecificProperties(), ilExAssignmentReminder\FEEDBACK_REMINDER, ilExAssignmentReminder\GRADE_REMINDER, insertFileOrderNr(), ilFileUtils\rCopy(), and ilExAssignmentReminder\SUBMIT_REMINDER.

Here is the call graph for this function:

count()

static ilExAssignment::count ( int  $a_ex_id )

static

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

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

References $DIC, and $ilDB.

countMandatory()

static ilExAssignment::countMandatory ( int  $a_ex_id )

static

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

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

References $DIC, and $ilDB.

createNewAssignmentRecords()

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

static

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

     : 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.

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

Referenced by ilExerciseMembers\assignMember().

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.

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

References $ilDB, ILIAS\Survey\Mode\getId(), and ilObjExercise\updateAllUsersStatus().

Here is the call graph for this function:

deleteGlobalFeedbackFile()

ilExAssignment::deleteGlobalFeedbackFile

(

)

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

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

References ilFileUtils\delDir().

Here is the call graph for this function:

fileAddOrder()

ilExAssignment::fileAddOrder

(

array

$a_entries = array()

)

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

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

fixInstructionFileOrdering()

ilExAssignment::fixInstructionFileOrdering

(

)

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

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

References Vendor\Package\$f, ilDBInterface\fetchAssoc(), ILIAS\Survey\Mode\getId(), ilDBInterface\manipulate(), ilDBInterface\query(), and ilDBInterface\quote().

Here is the call graph for this function:

getAssignmentDataOfExercise()

static ilExAssignment::getAssignmentDataOfExercise ( int  $a_exc_id )

static

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

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

References $data, $DIC, and $ilDB.

Referenced by ilExerciseXMLParser\__construct(), ilObjExercise\delete(), and ilExerciseXMLWriter\start().

Here is the caller graph for this function:

getAssignmentType()

ilExAssignment::getAssignmentType

(

)

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

                                       : ilExAssignmentTypeInterface
    {
        return $this->ass_type;
    }

Referenced by ilExSubmission\__construct().

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.

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

References $type, ILIAS\Survey\Mode\getId(), and ilExcIndividualDeadline\getStartingTimestamps().

Here is the call graph for this function:

getDeadline()

ilExAssignment::getDeadline

(

)

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

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

getDeadlineMode()

ilExAssignment::getDeadlineMode

(

)

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

                                     : int
    {
        return $this->deadline_mode;
    }

getExerciseId()

ilExAssignment::getExerciseId

(

)

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

                                   : int
    {
        return $this->exc_id;
    }

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.

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

References $ilDB.

getExtendedDeadline()

ilExAssignment::getExtendedDeadline

(

)

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

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

getFeedbackDate()

ilExAssignment::getFeedbackDate

(

)

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

                                     : int
    {
        return $this->feedback_date;
    }

getFeedbackDateCustom()

ilExAssignment::getFeedbackDateCustom

(

)

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

                                           : int
    {
        return $this->feedback_date_custom;
    }

getFeedbackFile()

ilExAssignment::getFeedbackFile

(

)

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

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

getFiles()

ilExAssignment::getFiles

(

)

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

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

References ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

getGlobalFeedbackFilePath()

ilExAssignment::getGlobalFeedbackFilePath

(

)

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

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

References $path.

getGlobalFeedbackFileStoragePath()

ilExAssignment::getGlobalFeedbackFileStoragePath

(

)

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

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

References ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

getId()

ilExAssignment::getId

(

)

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

                           : int
    {
        return $this->id;
    }

References $id.

Referenced by ilExcAssMemberState\__construct(), ilExSubmission\__construct(), ilExPeerReview\__construct(), ilExAssignmentGUI\addFiles(), ilExAssignmentEditorGUI\generateTeams(), ilExAssTypeWikiTeamGUI\getFormValuesArray(), ilExAssignmentGUI\getOverviewBody(), ilExAssignmentGUI\getOverviewHeader(), ilExAssTypeWikiTeamGUI\importFormToAssignment(), and ilAssignmentsPerParticipantTableGUI\parseData().

Here is the caller graph for this function:

getIndividualDeadlines()

ilExAssignment::getIndividualDeadlines

(

)

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

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

References $ilDB, and $res.

Referenced by ilAssignmentsPerParticipantTableGUI\parseData().

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.

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

References $data, $DIC, and $ilDB.

Referenced by ilExGradesTableGUI\__construct(), ilCalendarScheduleFilterExercise\addCustomEvents(), ilExerciseMembers\deassignMember(), ilObjExercise\exportGradesExcel(), ILIAS\Exercise\Assignment\Mandatory\RandomAssignmentsManager\getAssignmentSelection(), ilExcCriteriaCatalogueTableGUI\getItems(), ILIAS\Exercise\Assignment\Mandatory\RandomAssignmentsManager\getTotalNumberOfAssignments(), ilExerciseManagementGUI\membersObject(), and ilAssignmentsPerParticipantTableGUI\parseData().

Here is the caller graph for this function:

getInstruction()

ilExAssignment::getInstruction

(

)

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

                                    : string
    {
        return $this->instruction;
    }

getInstructionFilesOrder()

ilExAssignment::getInstructionFilesOrder

(

)

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

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

References $data, and $ilDB.

getInstructionPresentation()

ilExAssignment::getInstructionPresentation

(

)

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

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

getLastPersonalDeadline()

ilExAssignment::getLastPersonalDeadline

(

)

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

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

References $ilDB.

getMandatory()

ilExAssignment::getMandatory

(

)

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

                                  : bool
    {
        return $this->mandatory;
    }

getMaxCharLimit()

ilExAssignment::getMaxCharLimit

(

)

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

                                     : int
    {
        return $this->max_char_limit;
    }

Referenced by ilExAssTypeTextGUI\getFormValuesArray().

Here is the caller graph for this function:

getMaxFile()

ilExAssignment::getMaxFile

(

)

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

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

getMemberListData()

ilExAssignment::getMemberListData

(

)

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

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

References $ilDB, $name, ilObject\_exists(), ilObjUser\_lookupName(), and ILIAS\Survey\Mode\getId().

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.

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

References $ilUser, and ILIAS\Survey\Mode\getId().

Referenced by ilExAssignmentGUI\getOverviewHeader(), ilAssignmentsPerParticipantTableGUI\parseData(), and ilObjExercise\processExerciseStatus().

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.

                                     : int
    {
        return $this->min_char_limit;
    }

Referenced by ilExAssTypeTextGUI\getFormValuesArray().

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.

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

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

Here is the call graph for this function:

getOrderNr()

ilExAssignment::getOrderNr

(

)

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

                                : int
    {
        return $this->order_nr;
    }

Referenced by ilAssignmentsPerParticipantTableGUI\parseData().

Here is the caller graph for this function:

getPeerReview()

ilExAssignment::getPeerReview

(

)

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

                                   : bool
    {
        return $this->peer;
    }

getPeerReviewChars()

ilExAssignment::getPeerReviewChars

(

)

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

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

getPeerReviewCriteriaCatalogue()

ilExAssignment::getPeerReviewCriteriaCatalogue

(

)

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

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

getPeerReviewDeadline()

ilExAssignment::getPeerReviewDeadline

(

)

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

                                           : int
    {
        return $this->peer_dl;
    }

getPeerReviewMin()

ilExAssignment::getPeerReviewMin

(

)

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

                                      : int
    {
        return $this->peer_min;
    }

getPeerReviewSimpleUnlock()

ilExAssignment::getPeerReviewSimpleUnlock

(

)

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

                                               : bool
    {
        return $this->peer_unlock;
    }

getPeerReviewValid()

ilExAssignment::getPeerReviewValid

(

)

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

                                        : int
    {
        return $this->peer_valid;
    }

getPendingFeedbackNotifications()

static ilExAssignment::getPendingFeedbackNotifications ( )

static

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

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

References $DIC, $ilDB, and $res.

Referenced by ilExcCronFeedbackNotification\run().

Here is the caller graph for this function:

getPersonalDeadline()

ilExAssignment::getPersonalDeadline

(

int

$a_user_id

)

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

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

References $ilDB, ILIAS\Survey\Mode\getId(), and ilExAssignmentTeam\getTeamId().

Here is the call graph for this function:

getPortfolioTemplateId()

ilExAssignment::getPortfolioTemplateId

(

)

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

                                            : int
    {
        return $this->portfolio_template;
    }

Referenced by ilExAssTypePortfolioGUI\getFormValuesArray().

Here is the caller graph for this function:

getRelativeDeadline()

ilExAssignment::getRelativeDeadline

(

)

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

                                         : int
    {
        return $this->relative_deadline;
    }

getRelDeadlineLastSubmission()

ilExAssignment::getRelDeadlineLastSubmission

(

)

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

                                                  : int
    {
        return $this->rel_deadline_last_subm;
    }

getStartTime()

ilExAssignment::getStartTime

(

)

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

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

getTeamTutor()

ilExAssignment::getTeamTutor

(

)

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

                                  : bool
    {
        return $this->team_tutor;
    }

getTitle()

ilExAssignment::getTitle

(

)

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

                              : string
    {
        return $this->title;
    }

Referenced by ilExAssignmentPeerReviewOverviewTableGUI\__construct(), ilExAssignmentPeerReviewTableGUI\__construct(), ilExAssignmentGUI\getOverviewHeader(), and ilAssignmentsPerParticipantTableGUI\parseData().

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.

                             : int
    {
        return $this->type;
    }

References $type.

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.

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

handleGlobalFeedbackFileUpload()

ilExAssignment::handleGlobalFeedbackFileUpload

(

array

$a_file

)

Exceptions

ilException

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

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

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

Here is the call graph for this function:

hasActiveIDl()

ilExAssignment::hasActiveIDl

(

)

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

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

hasFeedbackCron()

ilExAssignment::hasFeedbackCron

(

)

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

                                     : bool
    {
        return $this->feedback_cron;
    }

hasPeerReviewFileUpload()

ilExAssignment::hasPeerReviewFileUpload

(

)

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

                                             : bool
    {
        return $this->peer_file;
    }

hasPeerReviewPersonalized()

ilExAssignment::hasPeerReviewPersonalized

(

)

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

                                               : bool
    {
        return $this->peer_personal;
    }

hasPeerReviewRating()

ilExAssignment::hasPeerReviewRating

(

)

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

                                         : bool
    {
        return $this->peer_rating;
    }

hasPeerReviewText()

ilExAssignment::hasPeerReviewText

(

)

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

                                       : bool
    {
        return $this->peer_text;
    }

hasReadOnlyIDl()

ilExAssignment::hasReadOnlyIDl

(

)

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

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

hasTeam()

ilExAssignment::hasTeam

(

)

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

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

Referenced by ilExSubmission\__construct(), and ilAssignmentsPerParticipantTableGUI\parseData().

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.

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

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.

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

Referenced by cloneAssignmentsOfExercise().

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.

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

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

Referenced by ilExAssignmentFileSystemGUI\deleteFile().

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.

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

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

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.

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

References ILIAS\Repository\int().

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.

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

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

Referenced by ilExAssignmentFileSystemGUI\uploadFile().

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.

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

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

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.

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

References $DIC, and $ilDB.

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

Here is the caller graph for this function:

isValidType()

ilExAssignment::isValidType

(

int

$a_value

)

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

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

lookup()

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

staticprivate

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

                                                              : 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] ?? "";
    }

References $DIC, and $ilDB.

lookupAssignmentOnline()

static ilExAssignment::lookupAssignmentOnline ( int  $a_ass_id )

static

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

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

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

lookupExerciseId()

static ilExAssignment::lookupExerciseId ( int  $a_ass_id )

static

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

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

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

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

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.

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

References $DIC, and $ilDB.

lookupTitle()

static ilExAssignment::lookupTitle ( int  $a_id )

static

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

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

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

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.

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

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

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.

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

References $DIC, and $ilDB.

Referenced by ilExAssignmentEditorGUI\orderAssignmentsByDeadlineObject().

Here is the caller graph for this function:

read()

ilExAssignment::read

(

)

Exceptions

ilExcUnknownAssignmentTypeException

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

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

References $ilDB.

Referenced by __construct().

Here is the caller graph for this function:

recalculateLateSubmissions()

ilExAssignment::recalculateLateSubmissions

(

)

Exceptions

ilDateTimeException

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

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

References $id, $ilDB, ilExSubmission\getAllAssignmentFiles(), ILIAS\Survey\Mode\getId(), IL_CAL_DATETIME, and IL_CAL_UNIX.

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.

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

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

Referenced by ilExAssignmentFileSystemGUI\renameFile().

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.

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

References $ilDB.

saveAssOrderOfExercise()

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

static

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

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

References $DIC, and $ilDB.

Referenced by ilExAssignmentEditorGUI\saveAssignmentOrderObject().

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.

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

Referenced by ilExAssignmentFileSystemGUI\saveFilesOrder().

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.

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

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.

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

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

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.

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

References $exercise, $name, ilObjUser\_lookupName(), ilFileDelivery\deliverFileLegacy(), ilOrgUnitPositionAndRBACAccessHandler\filterUserIdsByRbacOrPositionOfCurrentUser(), ilFileUtils\getASCIIFilename(), ILIAS\Survey\Mode\getId(), ilFileUtils\ilTempnam(), ilFileUtils\makeDir(), and ilFileUtils\zip().

Here is the call graph for this function:

setDeadline()

ilExAssignment::setDeadline

(

?int

$a_val

)

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

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

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.

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

setExerciseId()

ilExAssignment::setExerciseId

(

int

$a_val

)

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

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

setExtendedDeadline()

ilExAssignment::setExtendedDeadline

(

?int

$a_val

)

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

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

setFeedbackCron()

ilExAssignment::setFeedbackCron

(

bool

$a_value

)

Toggle (global) feedback file cron.

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

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

setFeedbackDate()

ilExAssignment::setFeedbackDate

(

int

$a_value

)

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

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

Referenced by __construct().

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.

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

setFeedbackFile()

ilExAssignment::setFeedbackFile

(

?string

$a_value

)

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

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

setId()

ilExAssignment::setId

(

int

$a_val

)

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

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

Referenced by __construct().

Here is the caller graph for this function:

setIndividualDeadline()

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

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

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

References $id.

setInstruction()

ilExAssignment::setInstruction

(

string

$a_val

)

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

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

setMandatory()

ilExAssignment::setMandatory

(

bool

$a_val

)

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

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

Referenced by ilExAssignmentEditorGUI\importFormToAssignment().

Here is the caller graph for this function:

setMaxCharLimit()

ilExAssignment::setMaxCharLimit

(

int

$a_val

)

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

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

Referenced by ilExAssTypeTextGUI\importFormToAssignment().

Here is the caller graph for this function:

setMaxFile()

ilExAssignment::setMaxFile

(

?int

$a_value

)

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

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

setMinCharLimit()

ilExAssignment::setMinCharLimit

(

int

$a_val

)

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

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

Referenced by ilExAssTypeTextGUI\importFormToAssignment().

Here is the caller graph for this function:

setOrderNr()

ilExAssignment::setOrderNr

(

int

$a_val

)

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

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

setPeerReview()

ilExAssignment::setPeerReview

(

bool

$a_value

)

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

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

setPeerReviewChars()

ilExAssignment::setPeerReviewChars

(

?int

$a_value

)

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

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

References ILIAS\Repository\int().

Here is the call graph for this function:

setPeerReviewCriteriaCatalogue()

ilExAssignment::setPeerReviewCriteriaCatalogue

(

?int

$a_value

)

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

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

setPeerReviewDeadline()

ilExAssignment::setPeerReviewDeadline

(

int

$a_val

)

Parameters

int	deadline (timestamp)

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

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

setPeerReviewFileUpload()

ilExAssignment::setPeerReviewFileUpload

(

bool

$a_val

)

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

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

setPeerReviewMin()

ilExAssignment::setPeerReviewMin

(

int

$a_value

)

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

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

setPeerReviewPersonalized()

ilExAssignment::setPeerReviewPersonalized

(

bool

$a_val

)

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

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

setPeerReviewRating()

ilExAssignment::setPeerReviewRating

(

bool

$a_val

)

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

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

setPeerReviewSimpleUnlock()

ilExAssignment::setPeerReviewSimpleUnlock

(

bool

$a_value

)

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

    {
        $this->peer_unlock = $a_value;
    }

setPeerReviewText()

ilExAssignment::setPeerReviewText

(

bool

$a_val

)

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

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

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.

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

setPortfolioTemplateId()

ilExAssignment::setPortfolioTemplateId

(

int

$a_val

)

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

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

Referenced by ilExAssTypePortfolioGUI\importFormToAssignment().

Here is the caller graph for this function:

setRelativeDeadline()

ilExAssignment::setRelativeDeadline

(

int

$a_val

)

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

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

setRelDeadlineLastSubmission()

ilExAssignment::setRelDeadlineLastSubmission

(

int

$a_val

)

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

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

setStartTime()

ilExAssignment::setStartTime

(

?int

$a_val

)

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

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

setTeamTutor()

ilExAssignment::setTeamTutor

(

bool

$a_value

)

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

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

setTitle()

ilExAssignment::setTitle

(

string

$a_val

)

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

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

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.

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

Referenced by __construct().

Here is the caller graph for this function:

update()

ilExAssignment::update

(

)

Exceptions

ilDateTimeException

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

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

References $ilDB, and ILIAS\Survey\Mode\getId().

Here is the call 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.

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

References ILIAS\Survey\Mode\getId(), and ilLoggerFactory\getLogger().

Here is the call graph for this function:

uploadMultiFeedbackFile()

ilExAssignment::uploadMultiFeedbackFile

(

array

$a_file

)

Exceptions

ilException
ilExerciseException

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

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

References $ilUser, $lng, ilFileUtils\delDir(), ilFileUtils\getDir(), ILIAS\Survey\Mode\getId(), ilFileUtils\moveUploadedFile(), and ilFileUtils\unzip().

Here is the call graph for this function:

Field Documentation

$access

ilAccessHandler ilExAssignment::$access

protected

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

$app_event_handler

ilAppEventHandler ilExAssignment::$app_event_handler

protected

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

$ass_type

ilExAssignmentTypeInterface ilExAssignment::$ass_type

protected

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

$crit_cat

int ilExAssignment::$crit_cat = 0

protected

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

$db

ilDBInterface ilExAssignment::$db

protected

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

$deadline

int ilExAssignment::$deadline = null

protected

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

$deadline2

int ilExAssignment::$deadline2 = null

protected

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

$deadline_mode

int ilExAssignment::$deadline_mode = 0

protected

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

$exc_id

int ilExAssignment::$exc_id = 0

protected

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

$feedback_cron

bool ilExAssignment::$feedback_cron = false

protected

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

$feedback_date

int ilExAssignment::$feedback_date = 0

protected

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

$feedback_date_custom

int ilExAssignment::$feedback_date_custom = 0

protected

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

$feedback_file

string ilExAssignment::$feedback_file = null

protected

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

$id

int ilExAssignment::$id = 0

protected

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

$instruction

string ilExAssignment::$instruction = ""

protected

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

$lng

ilLanguage ilExAssignment::$lng

protected

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

$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.

$max_char_limit

int ilExAssignment::$max_char_limit = 0

protected

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

$max_file

int ilExAssignment::$max_file = null

protected

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

$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.

$order_nr

int ilExAssignment::$order_nr = 0

protected

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

$peer

bool ilExAssignment::$peer = false

protected

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

$peer_char

int ilExAssignment::$peer_char = null

protected

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

$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.

$peer_file

bool ilExAssignment::$peer_file = false

protected

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

$peer_min

int ilExAssignment::$peer_min = 0

protected

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

$peer_personal

bool ilExAssignment::$peer_personal = false

protected

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

$peer_rating

bool ilExAssignment::$peer_rating = false

protected

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

$peer_text

bool ilExAssignment::$peer_text = false

protected

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

$peer_unlock

bool ilExAssignment::$peer_unlock = false

protected

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

$peer_valid

int ilExAssignment::$peer_valid

protected

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

$portfolio_template

int ilExAssignment::$portfolio_template = 0

protected

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

$rel_deadline_last_subm

int ilExAssignment::$rel_deadline_last_subm = 0

protected

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

$relative_deadline

int ilExAssignment::$relative_deadline = 0

protected

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

$start_time

int ilExAssignment::$start_time = null

protected

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

$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.

$title

string ilExAssignment::$title = ""

protected

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

$type

int ilExAssignment::$type = 0

protected

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

$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.

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(), 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 ilExcAssMemberState\isGlobalFeedbackFileAccessible().

FEEDBACK_DATE_DEADLINE

const ilExAssignment::FEEDBACK_DATE_DEADLINE = 1

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

Referenced by 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 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\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(), and ilExAssignmentEditorGUI\processForm().

TEAMS_FORMED_BY_PARTICIPANTS

const ilExAssignment::TEAMS_FORMED_BY_PARTICIPANTS = 0

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

TEAMS_FORMED_BY_RANDOM

const ilExAssignment::TEAMS_FORMED_BY_RANDOM = 2

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

Referenced by ilExAssignmentEditorGUI\generateTeams(), 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\processForm().

TYPE_BLOG

const ilExAssignment::TYPE_BLOG = 2

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

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

TYPE_PORTFOLIO

const ilExAssignment::TYPE_PORTFOLIO = 3

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

Referenced by ilExerciseManagementCollectFilesJob\__construct(), ilExerciseManagementCollectFilesJob\collectAssignmentData(), ilExAssignmentTypes\getAllIds(), ilExAssignmentTypes\getById(), ilExAssignmentTypesGUI\getById(), ilExSubmission\getDownloadedFilesInfoForTableGUIS(), 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(), ilExAssignmentTypes\getById(), ilExAssignmentTypesGUI\getById(), ilExSubmission\getDownloadedFilesInfoForTableGUIS(), 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\collectAssignmentData(), ilExAssignmentTypes\getAllIds(), ilExAssignmentTypes\getById(), ilExAssignmentTypesGUI\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(), ilExAssignmentTypes\getAllIds(), ilExAssignmentTypes\getById(), ilExAssignmentTypesGUI\getById(), ilExSubmission\getDownloadedFilesInfoForTableGUIS(), 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 ilWikiPageGUI\finalizeAssignment(), ilExAssignmentTypes\getAllIds(), ilExAssignmentTypes\getById(), ilExAssignmentTypesGUI\getById(), ilExSubmission\getDownloadedFilesInfoForTableGUIS(), and ilObjWikiListGUI\getProperties().

---

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

• Modules/Exercise/Assignment/class.ilExAssignment.php