ilExAssignment Class Reference

Exercise assignment. More...

Collaboration diagram for ilExAssignment:

Public Member Functions
	__construct ($a_id=0)
	Constructor. More...
	hasTeam ()
	setId ($a_val)
	Set assignment id. More...
	getId ()
	Get assignment id. More...
	setExerciseId ($a_val)
	Set exercise id. More...
	getExerciseId ()
	Get exercise id. More...
	setStartTime ($a_val)
	Set start time (timestamp) More...
	getStartTime ()
	Get start time (timestamp) More...
	setDeadline ($a_val)
	Set deadline (timestamp) More...
	getDeadline ()
	Get deadline (timestamp) More...
	getPersonalDeadline ($a_user_id)
	Get individual deadline. More...
	setExtendedDeadline ($a_val)
	Set extended deadline (timestamp) More...
	getExtendedDeadline ()
	Get extended deadline (timestamp) More...
	setInstruction ($a_val)
	Set instruction. More...
	getInstruction ()
	Get instruction. More...
	setTitle ($a_val)
	Set title. More...
	getTitle ()
	Get title. More...
	setMandatory ($a_val)
	Set mandatory. More...
	getMandatory ()
	Get mandatory. More...
	setOrderNr ($a_val)
	Set order nr. More...
	getOrderNr ()
	Get order nr. More...
	setType ($a_value)
	Set type. More...
	getType ()
	Get type. More...
	isValidType ($a_value)
	Is given type valid? More...
	setPeerReview ($a_value)
	Toggle peer review. More...
	getPeerReview ()
	Get peer review status. More...
	setPeerReviewMin ($a_value)
	Set peer review minimum. More...
	getPeerReviewMin ()
	Get peer review minimum. More...
	setPeerReviewSimpleUnlock ($a_value)
	Set peer review simple unlock. More...
	getPeerReviewSimpleUnlock ()
	Get peer review simple unlock. More...
	setPeerReviewDeadline ($a_val)
	Set peer review deadline (timestamp) More...
	getPeerReviewDeadline ()
	Get peer review deadline (timestamp) More...
	setPeerReviewValid ($a_value)
	Set peer review validation. More...
	getPeerReviewValid ()
	Get peer review validatiob. More...
	setPeerReviewRating ($a_val)
	Set peer review rating. More...
	hasPeerReviewRating ()
	Get peer review rating status. More...
	setPeerReviewText ($a_val)
	Set peer review text. More...
	hasPeerReviewText ()
	Get peer review text status. More...
	setPeerReviewFileUpload ($a_val)
	Set peer review file upload. More...
	hasPeerReviewFileUpload ()
	Get peer review file upload status. More...
	setPeerReviewPersonalized ($a_val)
	Set peer review personalized. More...
	hasPeerReviewPersonalized ()
	Get peer review personalized status. More...
	setPeerReviewChars ($a_value)
	Set peer review minimum characters. More...
	getPeerReviewChars ()
	Get peer review minimum characters. More...
	setPeerReviewCriteriaCatalogue ($a_value)
	Set peer review criteria catalogue id. More...
	getPeerReviewCriteriaCatalogue ()
	Get peer review criteria catalogue id. More...
	getPeerReviewCriteriaCatalogueItems ()
	setFeedbackFile ($a_value)
	Set (global) feedback file. More...
	getFeedbackFile ()
	Get (global) feedback file. More...
	setFeedbackCron ($a_value)
	Toggle (global) feedback file cron. More...
	hasFeedbackCron ()
	Get (global) feedback file cron status. More...
	setFeedbackDate ($a_value)
	Set (global) feedback file availability date. More...
	getFeedbackDate ()
	Get (global) feedback file availability date. More...
	setTeamTutor ($a_value)
	Set team management by tutor. More...
	getTeamTutor ()
	Get team management by tutor. More...
	setMaxFile ($a_value)
	Set max number of uploads. More...
	getMaxFile ()
	Get max number of uploads. More...
	read ()
	Read from db. More...
	save ()
	Save assignment. More...
	update ()
	Update. More...
	delete ()
	Delete assignment. More...
	getFiles ()
	Get files. More...
	saveAssOrderOfExercise ($a_ex_id, $a_order)
	Save ordering of all assignments of an exercise. More...
	getMemberListData ()
	get member list data More...
	uploadAssignmentFiles ($a_files)
	Upload assignment files (from creation form) More...
	sendMultiFeedbackStructureFile ()
	Create member status record for a new assignment for all participants. More...
	uploadMultiFeedbackFile ($a_file)
	Upload multi feedback file. More...
	getMultiFeedbackFiles ($a_user_id=0)
	Get multi feedback files (of uploader) More...
	clearMultiFeedbackDirectory ()
	Clear multi feedback directory. More...
	saveMultiFeedbackFiles ($a_files, ilObjExercise $a_exc)
	Save multi feedback files. More...
	afterDeadline ()
	afterDeadlineStrict ($a_include_personal=true)
	beforeDeadline ()
	notStartedYet ()
	getGlobalFeedbackFileStoragePath ()
	deleteGlobalFeedbackFile ()
	handleGlobalFeedbackFileUpload (array $a_file)
	getGlobalFeedbackFilePath ()
	getMemberStatus ($a_user_id=null)
	recalculateLateSubmissions ()
	setIndividualDeadline ($id, ilDateTime $date)
	getIndividualDeadlines ()
	hasActiveIDl ()
	hasReadOnlyIDl ()

Static Public Member Functions
static	getInstancesByExercise ($a_exc_id)
static	getAssignmentDataOfExercise ($a_exc_id)
	Get assignments data of an exercise in an array. More...
static	cloneAssignmentsOfExercise ($a_old_exc_id, $a_new_exc_id, array $a_crit_cat_map)
	Clone assignments of exercise. More...
static	lookupMaxOrderNrForEx ($a_exc_id)
	Select the maximum order nr for an exercise. More...
static	lookupAssignmentOnline ($a_ass_id)
	Check if assignment is online. More...
static	lookupExerciseId ($a_ass_id)
	Lookup excercise id for assignment id. More...
static	lookupTitle ($a_id)
	Lookup title. More...
static	lookupType ($a_id)
	Lookup type. More...
static	orderAssByDeadline ($a_ex_id)
	Order assignments by deadline date. More...
static	countMandatory ($a_ex_id)
	Order assignments by deadline date. More...
static	lookupUpdatedSubmission ($ass_id, $member_id)
	Check whether student has upload new files after tutor has set the exercise to another than notgraded. More...
static	createNewUserRecords ($a_user_id, $a_exc_id)
	Create member status record for a new participant for all assignments. More...
static	createNewAssignmentRecords ($a_ass_id, $a_exc)
	Create member status record for a new assignment for all participants. More...
static	getPendingFeedbackNotifications ()
static	sendFeedbackNotifications ($a_ass_id, $a_user_id=null)

Data Fields
const	TYPE_UPLOAD = 1
const	TYPE_BLOG = 2
const	TYPE_PORTFOLIO = 3
const	TYPE_UPLOAD_TEAM = 4
const	TYPE_TEXT = 5
const	FEEDBACK_DATE_DEADLINE = 1
const	FEEDBACK_DATE_SUBMISSION = 2
const	PEER_REVIEW_VALID_NONE = 1
const	PEER_REVIEW_VALID_ONE = 2
const	PEER_REVIEW_VALID_ALL = 3

Protected Member Functions
	getLastPersonalDeadline ()
	Get last/final personal deadline (of assignment) More...
	initFromDB (array $a_set)
	Import DB record. More...
	handleCalendarEntries ($a_event)
	Handle calendar entries for deadline(s) More...

Protected Attributes
	$id
	$exc_id
	$type
	$start_time
	$deadline
	$deadline2
	$instruction
	$title
	$mandatory
	$order_nr
	$peer
	$peer_min
	$peer_unlock
	$peer_dl
	$peer_valid
	$peer_file
	$peer_personal
	$peer_char
	$peer_text
	$peer_rating
	$peer_crit_cat
	$feedback_file
	$feedback_cron
	$feedback_date
	$team_tutor = false
	$max_file
	$member_status = array()

Static Private Member Functions
static	lookup ($a_id, $a_field)
	Private lookup. More...

Detailed Description

Exercise assignment.

Author

Alex Killing alex..nosp@m.kill.nosp@m.ing@g.nosp@m.mx.d.nosp@m.e

Version

$Id$

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

Constructor & Destructor Documentation

__construct()

ilExAssignment::__construct

(

$a_id = 0

)

Constructor.

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

References read(), setFeedbackDate(), setId(), and setType().

        {
                $this->setType(self::TYPE_UPLOAD);
                $this->setFeedbackDate(self::FEEDBACK_DATE_DEADLINE);
                
                if ($a_id > 0)
                {
                        $this->setId($a_id);
                        $this->read();
                }
        }

Here is the call graph for this function:

Member Function Documentation

afterDeadline()

ilExAssignment::afterDeadline

(

)

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

References $deadline, $ilUser, getPersonalDeadline(), and time.

Referenced by ilExAssignmentGUI\addPublicSubmissions(), and afterDeadlineStrict().

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

Here is the call graph for this function:

Here is the caller graph for this function:

afterDeadlineStrict()

ilExAssignment::afterDeadlineStrict

(

$a_include_personal = true

)

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

References $deadline, afterDeadline(), getLastPersonalDeadline(), and time.

Referenced by ilExAssignmentGUI\addSubmission(), beforeDeadline(), and ilExerciseSubmissionTableGUI\parseRow().

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

Here is the call graph for this function:

Here is the caller graph for this function:

beforeDeadline()

ilExAssignment::beforeDeadline

(

)

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

References afterDeadlineStrict().

Referenced by ilExAssignmentGUI\addSchedule().

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

Here is the call graph for this function:

Here is the caller graph for this function:

clearMultiFeedbackDirectory()

ilExAssignment::clearMultiFeedbackDirectory

(

)

Clear multi feedback directory.

Parameters

array

Returns

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

References $ilUser, $lng, ilUtil\delDir(), getExerciseId(), and getId().

Referenced by saveMultiFeedbackFiles().

        {
                global $lng, $ilUser;
                
                include_once("./Modules/Exercise/classes/class.ilFSStorageExercise.php");
                $storage = new ilFSStorageExercise($this->getExerciseId(), $this->getId());
                $mfu = $storage->getMultiFeedbackUploadPath($ilUser->getId());
                ilUtil::delDir($mfu);
        }

Here is the call graph for this function:

Here is the caller graph for this function:

cloneAssignmentsOfExercise()

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

static

Clone assignments of exercise.

Parameters

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

References $d, ilFSStorageExercise\create(), ilFSStorageExercise\getGlobalFeedbackPath(), ilFileSystemStorage\getPath(), and ilUtil\rCopy().

Referenced by ilObjExercise\cloneObject().

        {
                $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->setPeerReviewText($d->hasPeerReviewText());
                        $new_ass->setPeerReviewRating($d->hasPeerReviewRating());                       
                        $new_ass->setFeedbackFile($d->getFeedbackFile());
                        $new_ass->setFeedbackDate($d->getFeedbackDate());
                        $new_ass->setFeedbackCron($d->hasFeedbackCron()); // #16295
                        $new_ass->setTeamTutor($d->getTeamTutor());
                        $new_ass->setMaxFile($d->getMaxFile());
                        
                        // 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();
                        
                        include_once("./Modules/Exercise/classes/class.ilFSStorageExercise.php");
                        $old_storage = new ilFSStorageExercise($a_old_exc_id, (int) $d->getId());
                        $new_storage = new ilFSStorageExercise($a_new_exc_id, (int) $new_ass->getId());
                        $new_storage->create();
                        
                        // clone assignment files               
                        if (is_dir($old_storage->getPath()))
                        {
                                ilUtil::rCopy($old_storage->getPath(), $new_storage->getPath());
                        }
                        
                        // clone global feedback file                   
                        if (is_dir($old_storage->getGlobalFeedbackPath()))
                        {
                                ilUtil::rCopy($old_storage->getGlobalFeedbackPath(), $new_storage->getGlobalFeedbackPath());
                        }
                }
        }

Here is the call graph for this function:

Here is the caller graph for this function:

countMandatory()

static ilExAssignment::countMandatory (   $a_ex_id )

static

Order assignments by deadline date.

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

References $ilDB.

Referenced by ilObjExerciseGUI\initEditCustomForm().

        {
                global $ilDB;
                
                $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 $rec["cntm"];
        }

Here is the caller graph for this function:

createNewAssignmentRecords()

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

static

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

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

References $ilDB, and array.

        {
                global $ilDB;
                
                include_once("./Modules/Exercise/classes/class.ilExerciseMembers.php");
                $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 (   $a_user_id,   $a_exc_id  )

static

Create member status record for a new participant for all assignments.

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

References $ilDB, and array.

Referenced by ilExerciseMembers\assignMember().

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

Here is the caller graph for this function:

delete()

ilExAssignment::delete

(

)

Delete assignment.

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

References $ilDB, deleteGlobalFeedbackFile(), getExerciseId(), and handleCalendarEntries().

        {
                global $ilDB;
                
                $this->deleteGlobalFeedbackFile();
                
                $ilDB->manipulate("DELETE FROM exc_assignment WHERE ".
                        " id = ".$ilDB->quote($this->getId(), "integer")
                        );
                $exc = new ilObjExercise($this->getExerciseId(), false);
                $exc->updateAllUsersStatus();
                
                $this->handleCalendarEntries("delete");
        }

Here is the call graph for this function:

deleteGlobalFeedbackFile()

ilExAssignment::deleteGlobalFeedbackFile

(

)

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

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

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

getAssignmentDataOfExercise()

static ilExAssignment::getAssignmentDataOfExercise (   $a_exc_id )

static

Get assignments data of an exercise in an array.

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

References $data, $ilDB, and array.

Referenced by ilAssignmentsTableGUI\__construct(), ilExerciseXMLParser\__construct(), ilExAssignmentTeam\getAdoptableTeamAssignments(), ilObjExerciseGUI\infoScreen(), ilExerciseManagementGUI\showParticipantObject(), and ilExerciseXMLWriter\start().

        {
                global $ilDB;
                
                // 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 ASC");
                $data = array();

                $order_val = 10;
                while ($rec = $ilDB->fetchAssoc($set))
                {
                        
                        $data[] = array(
                                "id" => $rec["id"],
                                "exc_id" => $rec["exc_id"],
                                "deadline" => $rec["time_stamp"],
                                "deadline2" => $rec["deadline2"],
                                "instruction" => $rec["instruction"],
                                "title" => $rec["title"],
                                "start_time" => $rec["start_time"],
                                "order_val" => $order_val,
                                "mandatory" => $rec["mandatory"],
                                "type" => $rec["type"],
                                "peer" => $rec["peer"],
                                "peer_min" => $rec["peer_min"],
                                "peer_dl" => $rec["peer_dl"],
                                "peer_file" => $rec["peer_file"],
                                "peer_prsl" => $rec["peer_prsl"],
                                "fb_file" => $rec["fb_file"],
                                "fb_date" => $rec["fb_date"],
                                "fb_cron" => $rec["fb_cron"],
                                );
                        $order_val += 10;
                }
                return $data;
        }

Here is the caller graph for this function:

getDeadline()

ilExAssignment::getDeadline

(

)

Get deadline (timestamp)

Returns

int deadline (timestamp)

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

References $deadline.

Referenced by ilExAssignmentGUI\addSchedule(), ilExAssignmentGUI\getOverviewHeader(), getPersonalDeadline(), handleCalendarEntries(), hasActiveIDl(), save(), ilObjExercise\sendAssignment(), and update().

        {
                return $this->deadline;
        }

Here is the caller graph for this function:

getExerciseId()

ilExAssignment::getExerciseId

(

)

Get exercise id.

Returns

int exercise id

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

References $exc_id.

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

        {
                return $this->exc_id;
        }

Here is the caller graph for this function:

getExtendedDeadline()

ilExAssignment::getExtendedDeadline

(

)

Get extended deadline (timestamp)

Returns

int

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

References $deadline2.

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

        {
                return $this->deadline2;
        }

Here is the caller graph for this function:

getFeedbackDate()

ilExAssignment::getFeedbackDate

(

)

Get (global) feedback file availability date.

Returns

int

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

References $feedback_date.

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

        {
                return (int)$this->feedback_date;
        }

Here is the caller graph for this function:

getFeedbackFile()

ilExAssignment::getFeedbackFile

(

)

Get (global) feedback file.

Returns

int

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

References $feedback_file.

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

        {
                return (string)$this->feedback_file;
        }

Here is the caller graph for this function:

getFiles()

ilExAssignment::getFiles

(

)

Get files.

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

References getExerciseId(), and getId().

Referenced by ilExAssignmentGUI\addFiles().

        {
                include_once("./Modules/Exercise/classes/class.ilFSStorageExercise.php");
                $storage = new ilFSStorageExercise($this->getExerciseId(), $this->getId());
                return $storage->getFiles();
        }

Here is the call graph for this function:

Here is the caller graph for this function:

getGlobalFeedbackFilePath()

ilExAssignment::getGlobalFeedbackFilePath

(

)

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

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

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

Here is the call graph for this function:

getGlobalFeedbackFileStoragePath()

ilExAssignment::getGlobalFeedbackFileStoragePath

(

)

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

References getExerciseId(), and getId().

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

        {
                include_once("./Modules/Exercise/classes/class.ilFSStorageExercise.php");
                $storage = new ilFSStorageExercise($this->getExerciseId(), $this->getId());
                return $storage->getGlobalFeedbackPath();
        }

Here is the call graph for this function:

Here is the caller graph for this function:

getId()

ilExAssignment::getId

(

)

Get assignment id.

Returns

int assignment id

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

References $id.

Referenced by ilExPeerReview\__construct(), ilExAssignmentGUI\addSubmission(), ilExAssignmentGUI\addSubmissionFeedback(), clearMultiFeedbackDirectory(), ilExSubmission\downloadAllAssignmentFiles(), getFiles(), getGlobalFeedbackFileStoragePath(), getMemberListData(), getMemberStatus(), getMultiFeedbackFiles(), ilExAssignmentGUI\getOverviewBody(), getPersonalDeadline(), handleCalendarEntries(), ilExAssignmentEditorGUI\importFormToAssignment(), ilExerciseSubmissionTableGUI\parseRow(), recalculateLateSubmissions(), saveMultiFeedbackFiles(), ilObjExercise\sendAssignment(), sendMultiFeedbackStructureFile(), setIndividualDeadline(), update(), uploadAssignmentFiles(), and uploadMultiFeedbackFile().

        {
                return $this->id;
        }

Here is the caller graph for this function:

getIndividualDeadlines()

ilExAssignment::getIndividualDeadlines

(

)

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

References $ilDB, $res, $row, and array.

        {
                global $ilDB;
                
                $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;
        }

getInstancesByExercise()

static ilExAssignment::getInstancesByExercise (   $a_exc_id )

static

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

References $data, $ilDB, and array.

Referenced by ilExGradesTableGUI\__construct(), ilCalendarScheduleFilterExercise\addCustomEvents(), ilExSubmission\deleteUser(), ilObjExercise\determinStatusOfUser(), ilObjExercise\exportGradesExcel(), ilExcCriteriaCatalogueTableGUI\getItems(), ilExerciseManagementGUI\membersObject(), ilExParticipantTableGUI\parseData(), and ilObjExerciseGUI\showOverviewObject().

        {
                global $ilDB;
                
                $set = $ilDB->query("SELECT * FROM exc_assignment ".
                        " WHERE exc_id = ".$ilDB->quote($a_exc_id, "integer").
                        " ORDER BY order_nr ASC");
                $data = array();

                $order_val = 10;
                while ($rec = $ilDB->fetchAssoc($set))
                {
                        // ???
                        $rec["order_val"] = $order_val;
                        
                        $ass = new self();
                        $ass->initFromDB($rec);
                        $data[] = $ass;
                        
                        $order_val += 10;
                }
                
                return $data;
        }

Here is the caller graph for this function:

getInstruction()

ilExAssignment::getInstruction

(

)

Get instruction.

Returns

string instruction

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

References $instruction.

Referenced by ilExAssignmentGUI\addInstructions(), save(), ilObjExercise\sendAssignment(), and update().

        {
                return $this->instruction;
        }

Here is the caller graph for this function:

getLastPersonalDeadline()

ilExAssignment::getLastPersonalDeadline ( )

protected

Get last/final personal deadline (of assignment)

Returns

int

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

References $ilDB, and $row.

Referenced by afterDeadlineStrict().

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

Here is the caller graph for this function:

getMandatory()

ilExAssignment::getMandatory

(

)

Get mandatory.

Returns

int mandatory

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

References $mandatory.

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

        {
                return $this->mandatory;
        }

Here is the caller graph for this function:

getMaxFile()

ilExAssignment::getMaxFile

(

)

Get max number of uploads.

Returns

bool

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

References $max_file.

Referenced by save(), and update().

        {
                return $this->max_file;
        }

Here is the caller graph for this function:

getMemberListData()

ilExAssignment::getMemberListData

(

)

get member list data

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

References $ilDB, array, and getId().

        {
                global $ilDB;

                $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"]
                                );                      
                }
                
                include_once "Modules/Exercise/classes/class.ilExSubmission.php";

                $q = "SELECT * FROM exc_mem_ass_status ".
                        "WHERE ass_id = ".$ilDB->quote($this->getId(), "integer");
                $set = $ilDB->query($q);
                while($rec = $ilDB->fetchAssoc($set))
                {
                        if (isset($mem[$rec["usr_id"]]))
                        {
                                $sub = new ilExSubmission($this, $rec["usr_id"]);
                                
                                $mem[$rec["usr_id"]]["sent_time"] = $rec["sent_time"];
                                $mem[$rec["usr_id"]]["submission"] = $sub->getLastSubmission();
                                $mem[$rec["usr_id"]]["status_time"] = $rec["status_time"];
                                $mem[$rec["usr_id"]]["feedback_time"] = $rec["feedback_time"];
                                $mem[$rec["usr_id"]]["notice"] = $rec["notice"];
                                $mem[$rec["usr_id"]]["status"] = $rec["status"];
                                $mem[$rec["usr_id"]]["mark"] = $rec["mark"];
                                $mem[$rec["usr_id"]]["comment"] = $rec["u_comment"];
                        }
                }
                return $mem;
        }

Here is the call graph for this function:

getMemberStatus()

ilExAssignment::getMemberStatus

(

$a_user_id = null

)

Parameters

int | null

$a_user_id

Returns

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

References $ilUser, and getId().

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

        {
                global $ilUser;
                
                if(!$a_user_id)
                {
                        $a_user_id = $ilUser->getId();
                }
                if(!array_key_exists($a_user_id, $this->member_status))
                {
                        include_once "Modules/Exercise/classes/class.ilExAssignmentMemberStatus.php";
                        $this->member_status[$a_user_id] = new ilExAssignmentMemberStatus($this->getId(), $a_user_id);
                }
                return $this->member_status[$a_user_id];
        }

Here is the call graph for this function:

Here is the caller graph for this function:

getMultiFeedbackFiles()

ilExAssignment::getMultiFeedbackFiles

(

$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 1419 of file class.ilExAssignment.php.

References $files, $ilUser, ilObjUser\_lookupName(), array, ilUtil\getDir(), getExerciseId(), and getId().

Referenced by saveMultiFeedbackFiles().

        {
                global $ilUser;
                
                if ($a_user_id == 0)
                {
                        $a_user_id = $ilUser->getId();
                }
                
                $mf_files = array();
                
                // get members
                $exc = new ilObjExercise($this->getExerciseId(), false);
                include_once("./Modules/Exercise/classes/class.ilExerciseMembers.php");
                $exmem = new ilExerciseMembers($exc);
                $mems = $exmem->getMembers();

                // read mf directory
                include_once("./Modules/Exercise/classes/class.ilFSStorageExercise.php");
                $storage = new ilFSStorageExercise($this->getExerciseId(), $this->getId());
                $mfu = $storage->getMultiFeedbackUploadPath($ilUser->getId());

                // get subdir that starts with multi_feedback
                $subdirs = ilUtil::getDir($mfu);
                $subdir = "notfound";
                foreach ($subdirs as $s => $j)
                {
                        if ($j["type"] == "dir" && substr($s, 0, 14) == "multi_feedback")
                        {
                                $subdir = $s;
                        }
                }
                
                $items = ilUtil::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 = ilUtil::getDir($mfu."/".$subdir."/".$k);
                                        foreach ($files as $k2 => $f)
                                        {
                                                // append files to array
                                                if ($f["type"] == "file" && substr($k2, 0, 1) != ".")
                                                {
                                                        $mf_files[] = array(
                                                                "lastname" => $name["lastname"],
                                                                "firstname" => $name["firstname"],
                                                                "login" => $name["login"],
                                                                "user_id" => $name["user_id"],
                                                                "full_path" => $mfu."/".$subdir."/".$k."/".$k2,
                                                                "file" => $k2);
                                                }
                                        }
                                }
                        }
                }
                return $mf_files;
        }

Here is the call graph for this function:

Here is the caller graph for this function:

getOrderNr()

ilExAssignment::getOrderNr

(

)

Get order nr.

Returns

int order nr

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

References $order_nr.

Referenced by save(), and update().

        {
                return $this->order_nr;
        }

Here is the caller graph for this function:

getPeerReview()

ilExAssignment::getPeerReview

(

)

Get peer review status.

Returns

bool

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

References $peer.

Referenced by ilExAssignmentGUI\getOverviewHeader(), handleCalendarEntries(), hasReadOnlyIDl(), save(), and update().

        {
                return (bool)$this->peer;
        }

Here is the caller graph for this function:

getPeerReviewChars()

ilExAssignment::getPeerReviewChars

(

)

Get peer review minimum characters.

Returns

int

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

References $peer_char.

Referenced by save(), and update().

        {
                return $this->peer_char;
        }

Here is the caller graph for this function:

getPeerReviewCriteriaCatalogue()

ilExAssignment::getPeerReviewCriteriaCatalogue

(

)

Get peer review criteria catalogue id.

Returns

int

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

Referenced by save(), and update().

        {
                return $this->crit_cat;
        }

Here is the caller graph for this function:

getPeerReviewCriteriaCatalogueItems()

ilExAssignment::getPeerReviewCriteriaCatalogueItems

(

)

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

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

        {
                include_once "Modules/Exercise/classes/class.ilExcCriteria.php";
                
                if($this->crit_cat)
                {                       
                        return ilExcCriteria::getInstancesByParentId($this->crit_cat);
                }
                else
                {
                        $res = array();
                        
                        if($this->peer_rating)
                        {
                                $res[] = ilExcCriteria::getInstanceByType("rating");
                        }
                        
                        if($this->peer_text)
                        {
                                $crit = ilExcCriteria::getInstanceByType("text");                               
                                if($this->peer_char)
                                {
                                        $crit->setMinChars($this->peer_char);
                                }
                                $res[] = $crit;
                        }
                        
                        if($this->peer_file)
                        {
                                $res[] = ilExcCriteria::getInstanceByType("file");
                        }
                        
                        return $res;
                }
        }

Here is the call graph for this function:

getPeerReviewDeadline()

ilExAssignment::getPeerReviewDeadline

(

)

Get peer review deadline (timestamp)

Returns

int deadline (timestamp)

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

References $peer_dl.

Referenced by ilExAssignmentGUI\getOverviewHeader(), handleCalendarEntries(), save(), and update().

        {
                return $this->peer_dl;
        }

Here is the caller graph for this function:

getPeerReviewMin()

ilExAssignment::getPeerReviewMin

(

)

Get peer review minimum.

Returns

int

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

References $peer_min.

Referenced by save(), and update().

        {
                return (int)$this->peer_min;
        }

Here is the caller graph for this function:

getPeerReviewSimpleUnlock()

ilExAssignment::getPeerReviewSimpleUnlock

(

)

Get peer review simple unlock.

Returns

bool

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

References $peer_unlock.

Referenced by save(), and update().

        {
                return (bool)$this->peer_unlock;
        }

Here is the caller graph for this function:

getPeerReviewValid()

ilExAssignment::getPeerReviewValid

(

)

Get peer review validatiob.

Returns

int

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

References $peer_valid.

Referenced by save(), and update().

        {
                return (int)$this->peer_valid;
        }

Here is the caller graph for this function:

getPendingFeedbackNotifications()

static ilExAssignment::getPendingFeedbackNotifications ( )

static

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

References $ilDB, $res, $row, array, and time.

Referenced by ilExcCronFeedbackNotification\run().

        {
                global $ilDB;
                
                $res = array();
                
                $set = $ilDB->query("SELECT id,fb_file 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"));
                while($row = $ilDB->fetchAssoc($set))
                {
                        if(trim($row["fb_file"]))
                        {
                                $res[] = $row["id"];                    
                        }
                }               
        
                return $res;
        }

Here is the caller graph for this function:

getPersonalDeadline()

ilExAssignment::getPersonalDeadline

(

$a_user_id

)

Get individual deadline.

Parameters

int

$a_user_id

Returns

int

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

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

Referenced by ilExAssignmentGUI\addSchedule(), afterDeadline(), ilExAssignmentGUI\getOverviewHeader(), and recalculateLateSubmissions().

        {
                global $ilDB;
                
                $is_team = false;
                if($this->getType() == self::TYPE_UPLOAD_TEAM)
                {
                        include_once("./Modules/Exercise/classes/class.ilExAssignmentTeam.php");
                        $team_id = ilExAssignmentTeam::getTeamId($this->getId(), $a_user_id);
                        if(!$team_id)
                        {
                                // #0021043
                                $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"], $this->getDeadline());
        }

Here is the call graph for this function:

Here is the caller graph for this function:

getStartTime()

ilExAssignment::getStartTime

(

)

Get start time (timestamp)

Returns

int start time (timestamp)

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

References $start_time.

Referenced by ilExAssignmentGUI\addSchedule(), ilExAssignmentGUI\getOverviewHeader(), save(), and update().

        {
                return $this->start_time;
        }

Here is the caller graph for this function:

getTeamTutor()

ilExAssignment::getTeamTutor

(

)

Get team management by tutor.

Returns

bool

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

References $team_tutor.

Referenced by save(), and update().

        {
                return $this->team_tutor;
        }

Here is the caller graph for this function:

getTitle()

ilExAssignment::getTitle

(

)

Get title.

Returns

string title

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

References $title.

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

        {
                return $this->title;
        }

Here is the caller graph for this function:

getType()

ilExAssignment::getType

(

)

Get type.

Returns

int

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

References $type.

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

        {
                return $this->type;
        }

Here is the caller graph for this function:

handleCalendarEntries()

ilExAssignment::handleCalendarEntries (   $a_event )

protected

Handle calendar entries for deadline(s)

Parameters

string

$a_event

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

References array, getDeadline(), getExerciseId(), getId(), getPeerReview(), getPeerReviewDeadline(), getTitle(), IL_CAL_TRANSLATION_SYSTEM, and IL_CAL_UNIX.

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

        {               
                global $ilAppEventHandler;
                
                $dl_id = $this->getId()."0";
                $fbdl_id = $this->getId()."1";
                
                $context_ids = array($dl_id, $fbdl_id);         
                $apps = array();
                
                if($a_event != "delete")
                {                                                                               
                        include_once "Services/Calendar/classes/class.ilCalendarAppointmentTemplate.php";
                        
                        if($this->getDeadline())
                        {                                       
                                $app = new ilCalendarAppointmentTemplate($dl_id);
                                $app->setTranslationType(IL_CAL_TRANSLATION_SYSTEM);
                                $app->setSubtitle("cal_exc_deadline");
                                $app->setTitle($this->getTitle());                              
                                $app->setFullday(false);
                                $app->setStart(new ilDateTime($this->getDeadline(), IL_CAL_UNIX));                      
                                
                                $apps[] = $app;
                        }

                        if($this->getPeerReview() &&
                                $this->getPeerReviewDeadline())
                        {
                                $app = new ilCalendarAppointmentTemplate($fbdl_id);
                                $app->setTranslationType(IL_CAL_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;
                        }               
                        
                }                       
                                
                include_once "Modules/Exercise/classes/class.ilObjExercise.php";
                $exc = new ilObjExercise($this->getExerciseId(), false);
                
                $ilAppEventHandler->raise('Modules/Exercise',
                        $a_event.'Assignment',
                        array(
                        'object' => $exc,
                        'obj_id' => $exc->getId(),                      
                        'context_ids' => $context_ids,
                        'appointments' => $apps));              
        }

Here is the call graph for this function:

Here is the caller graph for this function:

handleGlobalFeedbackFileUpload()

ilExAssignment::handleGlobalFeedbackFileUpload

(

array

$a_file

)

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

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

Referenced by ilExAssignmentEditorGUI\importFormToAssignment().

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

Here is the call graph for this function:

Here is the caller graph for this function:

hasActiveIDl()

ilExAssignment::hasActiveIDl

(

)

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

References getDeadline().

Referenced by ilExerciseSubmissionTableGUI\parseRow().

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

Here is the call graph for this function:

Here is the caller graph for this function:

hasFeedbackCron()

ilExAssignment::hasFeedbackCron

(

)

Get (global) feedback file cron status.

Returns

int

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

References $feedback_cron.

Referenced by save(), and update().

        {
                return (bool)$this->feedback_cron;
        }

Here is the caller graph for this function:

hasPeerReviewFileUpload()

ilExAssignment::hasPeerReviewFileUpload

(

)

Get peer review file upload status.

Returns

bool

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

References $peer_file.

Referenced by save(), and update().

        {
                return $this->peer_file;
        }

Here is the caller graph for this function:

hasPeerReviewPersonalized()

ilExAssignment::hasPeerReviewPersonalized

(

)

Get peer review personalized status.

Returns

bool

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

References $peer_personal.

Referenced by save(), and update().

        {
                return $this->peer_personal;
        }       

Here is the caller graph for this function:

hasPeerReviewRating()

ilExAssignment::hasPeerReviewRating

(

)

Get peer review rating status.

Returns

bool

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

References $peer_rating.

Referenced by save(), and update().

        {
                return $this->peer_rating;
        }

Here is the caller graph for this function:

hasPeerReviewText()

ilExAssignment::hasPeerReviewText

(

)

Get peer review text status.

Returns

bool

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

References $peer_text.

Referenced by save(), and update().

        {
                return $this->peer_text;
        }

Here is the caller graph for this function:

hasReadOnlyIDl()

ilExAssignment::hasReadOnlyIDl

(

)

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

References getPeerReview(), getType(), and TYPE_UPLOAD_TEAM.

Referenced by ilExerciseSubmissionTableGUI\parseRow().

        {
                if($this->getType() != ilExAssignment::TYPE_UPLOAD_TEAM &&
                        $this->getPeerReview())
                {               
                        // all deadlines are read-only if we have peer feedback
                        include_once "Modules/Exercise/classes/class.ilExPeerReview.php";
                        $peer_review = new ilExPeerReview($this);       
                        if($peer_review->hasPeerReviewGroups())
                        {
                                return true;
                        }
                }
                
                return false;           
        }

Here is the call graph for this function:

Here is the caller graph for this function:

hasTeam()

ilExAssignment::hasTeam

(

)

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

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

        {
                return $this->type == self::TYPE_UPLOAD_TEAM;
        }

Here is the caller graph for this function:

initFromDB()

ilExAssignment::initFromDB ( array  $a_set )

protected

Import DB record.

See also

getInstancesByExercise()

Parameters

array

$a_set

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

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

Referenced by read().

        {
                $this->setId($a_set["id"]);
                $this->setExerciseId($a_set["exc_id"]);
                $this->setDeadline($a_set["time_stamp"]);
                $this->setExtendedDeadline($a_set["deadline2"]);
                $this->setInstruction($a_set["instruction"]);
                $this->setTitle($a_set["title"]);
                $this->setStartTime($a_set["start_time"]);
                $this->setOrderNr($a_set["order_nr"]);
                $this->setMandatory($a_set["mandatory"]);
                $this->setType($a_set["type"]);
                $this->setPeerReview($a_set["peer"]);
                $this->setPeerReviewMin($a_set["peer_min"]);
                $this->setPeerReviewSimpleUnlock($a_set["peer_unlock"]);
                $this->setPeerReviewDeadline($a_set["peer_dl"]);
                $this->setPeerReviewValid($a_set["peer_valid"]);
                $this->setPeerReviewFileUpload($a_set["peer_file"]);
                $this->setPeerReviewPersonalized($a_set["peer_prsl"]);
                $this->setPeerReviewChars($a_set["peer_char"]);
                $this->setPeerReviewText($a_set["peer_text"]);
                $this->setPeerReviewRating($a_set["peer_rating"]);
                $this->setPeerReviewCriteriaCatalogue($a_set["peer_crit_cat"]);
                $this->setFeedbackFile($a_set["fb_file"]);
                $this->setFeedbackDate($a_set["fb_date"]);
                $this->setFeedbackCron($a_set["fb_cron"]);
                $this->setTeamTutor($a_set["team_tutor"]);
                $this->setMaxFile($a_set["max_file"]);          
        }

Here is the call graph for this function:

Here is the caller graph for this function:

isValidType()

ilExAssignment::isValidType

(

$a_value

)

Is given type valid?

Parameters

int

$a_value

Returns

bool

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

References array.

Referenced by setType().

        {
                if(in_array((int)$a_value, array(self::TYPE_UPLOAD, self::TYPE_BLOG, 
                        self::TYPE_PORTFOLIO, self::TYPE_UPLOAD_TEAM, self::TYPE_TEXT)))
                {
                        return true;
                }
                return false;
        }

Here is the caller graph for this function:

lookup()

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

staticprivate

Private lookup.

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

References $ilDB.

        {
                global $ilDB;
                
                $set = $ilDB->query("SELECT ".$a_field." FROM exc_assignment ".
                        " WHERE id = ".$ilDB->quote($a_id, "integer")
                        );

                $rec = $ilDB->fetchAssoc($set);

                return $rec[$a_field];
        }

lookupAssignmentOnline()

static ilExAssignment::lookupAssignmentOnline (   $a_ass_id )

static

Check if assignment is online.

Parameters

int

$a_ass_id

Returns

bool

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

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

Referenced by ilObjExerciseSubItemListGUI\isAssignmentVisible().

        {
                global $ilDB;
                
                $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 $res->numRows() ? true : false;
        }

Here is the caller graph for this function:

lookupExerciseId()

static ilExAssignment::lookupExerciseId (   $a_ass_id )

static

Lookup excercise id for assignment id.

Parameters

int

$a_ass_id

Returns

int

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

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

Referenced by ilObjExerciseGUI\__construct().

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

Here is the caller graph for this function:

lookupMaxOrderNrForEx()

static ilExAssignment::lookupMaxOrderNrForEx (   $a_exc_id )

static

Select the maximum order nr for an exercise.

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

References $ilDB.

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

lookupTitle()

static ilExAssignment::lookupTitle (   $a_id )

static

Lookup title.

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

Referenced by ilExAssignmentEditorGUI\confirmAssignmentsDeletionObject(), ilExSubmission\downloadMultipleFiles(), ilObjExerciseSubItemListGUI\getHTML(), ilExerciseManagementGUI\initMultiFeedbackForm(), and ilExerciseMailNotification\send().

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

Here is the caller graph for this function:

lookupType()

static ilExAssignment::lookupType (   $a_id )

static

Lookup type.

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

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

lookupUpdatedSubmission()

static ilExAssignment::lookupUpdatedSubmission (   $ass_id,   $member_id  )

static

Check whether student has upload new files after tutor has set the exercise to another than notgraded.

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

References $ilDB, $lng, and array.

        {
                global $ilDB, $lng;
                
                // team upload?
                $user_ids = self::getTeamMembersByAssignmentId($ass_id, $member_id);
                if(!$user_ids)
                {
                        $user_ids = array($member_id);
                }

                $q="SELECT exc_mem_ass_status.status_time, exc_returned.ts ".
                        "FROM exc_mem_ass_status, exc_returned ".
                        "WHERE exc_mem_ass_status.status_time < exc_returned.ts ".
                        "AND NOT exc_mem_ass_status.status_time IS NULL ".
                        "AND exc_returned.ass_id = exc_mem_ass_status.ass_id ".
                        "AND exc_returned.user_id = exc_mem_ass_status.usr_id ".
                        "AND exc_returned.ass_id=".$ilDB->quote($ass_id, "integer").
                        " AND ".$ilDB->in("exc_returned.user_id", $user_ids, "", "integer");

                $usr_set = $ilDB->query($q);

                $array = $ilDB->fetchAssoc($usr_set);

                if (count($array)==0)
                {
                        return 0;
                }
                else
                {
                        return 1;
                }

        }

notStartedYet()

ilExAssignment::notStartedYet

(

)

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

References time.

Referenced by ilExAssignmentGUI\addInstructions(), ilExAssignmentGUI\addSchedule(), ilExAssignmentGUI\getOverviewBody(), and ilExAssignmentGUI\getOverviewHeader().

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

Here is the caller graph for this function:

orderAssByDeadline()

static ilExAssignment::orderAssByDeadline (   $a_ex_id )

static

Order assignments by deadline date.

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

References $ilDB.

Referenced by ilExAssignmentEditorGUI\orderAssignmentsByDeadlineObject().

        {
                global $ilDB;

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

Here is the caller graph for this function:

read()

ilExAssignment::read

(

)

Read from db.

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

References $ilDB, and initFromDB().

Referenced by __construct().

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

Here is the call graph for this function:

Here is the caller graph for this function:

recalculateLateSubmissions()

ilExAssignment::recalculateLateSubmissions

(

)

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

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

        {
                global $ilDB;
                
                // see JF, 2015-05-11 
                                
                $ext_deadline = $this->getExtendedDeadline();
                
                include_once "Modules/Exercise/classes/class.ilExSubmission.php";
                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 
                        else if(!$file["late"] &&
                                $ext_deadline &&
                                $deadline && 
                                $uploaded > $deadline)
                        {
                                $late = true;
                        }
                        else if($last_deadline && $uploaded > $last_deadline)
                        {
                                // do nothing, we do not remove submissions?
                        }
                        
                        if($late !== null)
                        {                               
                                $ilDB->manipulate("UPDATE exc_returned".
                                        " SET late = ".$ilDB->quote($late, "integer").
                                        " WHERE returned_id = ".$ilDB->quote($id, "integer"));
                        }
                }       
        }

Here is the call graph for this function:

save()

ilExAssignment::save

(

)

Save assignment.

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

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

Referenced by ilExAssignmentEditorGUI\importFormToAssignment().

        {
                global $ilDB;
                
                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_cron" => array("integer", $this->hasFeedbackCron()),
                        "team_tutor" => array("integer", $this->getTeamTutor()),
                        "max_file" => array("integer", $this->getMaxFile())
                        ));
                $this->setId($next_id);
                $exc = new ilObjExercise($this->getExerciseId(), false);
                $exc->updateAllUsersStatus();
                self::createNewAssignmentRecords($next_id, $exc);
                
                $this->handleCalendarEntries("create");
        }

Here is the call graph for this function:

Here is the caller graph for this function:

saveAssOrderOfExercise()

ilExAssignment::saveAssOrderOfExercise	(		$a_ex_id,
			$a_order
	)

Save ordering of all assignments of an exercise.

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

References $ilDB, $t, and array.

Referenced by ilExAssignmentEditorGUI\saveAssignmentOrderObject().

        {
                global $ilDB;
                
                $result_order = array();
                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($t = "UPDATE exc_assignment SET ".
                                " order_nr = ".$ilDB->quote($nr, "integer").
                                " WHERE id = ".$ilDB->quote((int) $k, "integer").
                                " AND exc_id = ".$ilDB->quote((int) $a_ex_id, "integer")
                                );
                        $nr+=10;
                }
        }

Here is the caller graph for this function:

saveMultiFeedbackFiles()

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

Save multi feedback files.

Parameters

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

References $member_status, $target, array, clearMultiFeedbackDirectory(), getExerciseId(), getId(), ilObject\getId(), getMemberStatus(), getMultiFeedbackFiles(), and ilObjExercise\sendFeedbackFileNotification().

        {                                       
                if($this->getExerciseId() != $a_exc->getId())
                {
                        return;
                }
                
                include_once("./Modules/Exercise/classes/class.ilFSStorageExercise.php");
                $fstorage = new ilFSStorageExercise($this->getExerciseId(), $this->getId());
                $fstorage->create();
                
                $team_map = array();
                
                $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 ($a_files[$user_id][md5($file_name)] != "")
                        {                       
                                $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
                                        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,
                                                        (int) $this->getId());
                                        }
                                }                               
                        }
                }
                
                $this->clearMultiFeedbackDirectory();
        }

Here is the call graph for this function:

sendFeedbackNotifications()

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

static

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

References $ilDB, $row, ilExerciseMembers\_getMembers(), and array.

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

        {
                global $ilDB;
                
                $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;
                        }
                }
                
                include_once "./Services/Notification/classes/class.ilSystemNotification.php";
                $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)
                {
                        include_once "./Modules/Exercise/classes/class.ilExerciseMembers.php";
                        $ntf->sendMail(ilExerciseMembers::_getMembers($ass->getExerciseId()));
                                                
                        $ilDB->manipulate("UPDATE exc_assignment".
                                " SET fb_cron_done = ".$ilDB->quote(1, "integer").
                                " WHERE id = ".$ilDB->quote($a_ass_id, "integer"));
                }
                else
                {               
                        $ntf->sendMail(array($a_user_id));
                }
                
                return true;            
        }

Here is the call graph for this function:

Here is the caller graph for this function:

sendMultiFeedbackStructureFile()

ilExAssignment::sendMultiFeedbackStructureFile

(

)

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

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

References $ilDB, ilObjUser\_lookupName(), ilUtil\deliverFile(), ilUtil\getASCIIFilename(), getExerciseId(), getId(), getTitle(), ilUtil\ilTempnam(), ilUtil\makeDir(), and ilUtil\zip().

        {
                global $ilDB;
                
                
                // send and delete the zip file
                $deliverFilename = trim(str_replace(" ", "_", $this->getTitle()."_".$this->getId()));
                $deliverFilename = ilUtil::getASCIIFilename($deliverFilename);
                $deliverFilename = "multi_feedback_".$deliverFilename;

                $exc = new ilObjExercise($this->getExerciseId(), false);
                
                $cdir = getcwd();
                
                // create temporary directoy
                $tmpdir = ilUtil::ilTempnam();
                ilUtil::makeDir($tmpdir);
                $mfdir = $tmpdir."/".$deliverFilename;
                ilUtil::makeDir($mfdir);
                
                // create subfolders <lastname>_<firstname>_<id> for each participant
                include_once("./Modules/Exercise/classes/class.ilExerciseMembers.php");
                $exmem = new ilExerciseMembers($exc);
                $mems = $exmem->getMembers();

                foreach ($mems as $mem)
                {
                        $name = ilObjUser::_lookupName($mem);
                        $subdir = $name["lastname"]."_".$name["firstname"]."_".$name["login"]."_".$name["user_id"];
                        $subdir = ilUtil::getASCIIFilename($subdir);
                        ilUtil::makeDir($mfdir."/".$subdir);
                }
                
                // create the zip file
                chdir($tmpdir);
                $tmpzipfile = $tmpdir."/multi_feedback.zip";
                ilUtil::zip($tmpdir, $tmpzipfile, true);
                chdir($cdir);
                

                ilUtil::deliverFile($tmpzipfile, $deliverFilename.".zip", "", false, true);
        }

Here is the call graph for this function:

setDeadline()

ilExAssignment::setDeadline

(

$a_val

)

Set deadline (timestamp)

Parameters

int	deadline (timestamp)

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

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

        {
                $this->deadline = $a_val;
        }

Here is the caller graph for this function:

setExerciseId()

ilExAssignment::setExerciseId

(

$a_val

)

Set exercise id.

Parameters

int	exercise id

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

Referenced by initFromDB().

        {
                $this->exc_id = $a_val;
        }

Here is the caller graph for this function:

setExtendedDeadline()

ilExAssignment::setExtendedDeadline

(

$a_val

)

Set extended deadline (timestamp)

Parameters

int

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

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

        {
                if($a_val !== null)
                {
                        $a_val = (int)$a_val;
                }
                $this->deadline2 = $a_val;
        }

Here is the caller graph for this function:

setFeedbackCron()

ilExAssignment::setFeedbackCron

(

$a_value

)

Toggle (global) feedback file cron.

Parameters

bool

$a_value

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

References string.

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

        {
                $this->feedback_cron = (string)$a_value;
        }

Here is the caller graph for this function:

setFeedbackDate()

ilExAssignment::setFeedbackDate

(

$a_value

)

Set (global) feedback file availability date.

Parameters

int

$a_value

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

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

        {
                $this->feedback_date = (int)$a_value;
        }

Here is the caller graph for this function:

setFeedbackFile()

ilExAssignment::setFeedbackFile

(

$a_value

)

Set (global) feedback file.

Parameters

string

$a_value

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

References string.

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

        {
                $this->feedback_file = (string)$a_value;
        }

Here is the caller graph for this function:

setId()

ilExAssignment::setId

(

$a_val

)

Set assignment id.

Parameters

int	assignment id

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

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

        {
                $this->id = $a_val;
        }

Here is the caller graph for this function:

setIndividualDeadline()

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

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

References $id, $ilDB, array, ilDateTime\get(), getId(), and IL_CAL_UNIX.

        {
                global $ilDB;
                
                $is_team = false;
                if(!is_numeric($id))
                {
                        $id = substr($id, 1);
                        $is_team = true;
                }
                
                $ilDB->replace("exc_idl",
                        array(
                                "ass_id" => array("integer", $this->getId()),
                                "member_id" => array("integer", $id),
                                "is_team" => array("integer", $is_team)
                        ),
                        array(
                                "tstamp" => array("integer", $date->get(IL_CAL_UNIX))
                        )
                );
        }

Here is the call graph for this function:

setInstruction()

ilExAssignment::setInstruction

(

$a_val

)

Set instruction.

Parameters

string

instruction

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

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

        {
                $this->instruction = $a_val;
        }

Here is the caller graph for this function:

setMandatory()

ilExAssignment::setMandatory

(

$a_val

)

Set mandatory.

Parameters

int

mandatory

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

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

        {
                $this->mandatory = $a_val;
        }

Here is the caller graph for this function:

setMaxFile()

ilExAssignment::setMaxFile

(

$a_value

)

Set max number of uploads.

Parameters

int

$a_value

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

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

        {
                if($a_value !== null)
                {
                        $a_value = (int)$a_value;
                }
                $this->max_file = $a_value;
        }

Here is the caller graph for this function:

setOrderNr()

ilExAssignment::setOrderNr

(

$a_val

)

Set order nr.

Parameters

int

order nr

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

Referenced by initFromDB(), and save().

        {
                $this->order_nr = $a_val;
        }

Here is the caller graph for this function:

setPeerReview()

ilExAssignment::setPeerReview

(

$a_value

)

Toggle peer review.

Parameters

bool

$a_value

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

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

        {
                $this->peer = (bool)$a_value;
        }

Here is the caller graph for this function:

setPeerReviewChars()

ilExAssignment::setPeerReviewChars

(

$a_value

)

Set peer review minimum characters.

Parameters

int

$a_value

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

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

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

Here is the caller graph for this function:

setPeerReviewCriteriaCatalogue()

ilExAssignment::setPeerReviewCriteriaCatalogue

(

$a_value

)

Set peer review criteria catalogue id.

Parameters

int

$a_value

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

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

        {
                $a_value = is_numeric($a_value)
                        ? (int)$a_value
                        : null;         
                $this->crit_cat = $a_value;
        }

Here is the caller graph for this function:

setPeerReviewDeadline()

ilExAssignment::setPeerReviewDeadline

(

$a_val

)

Set peer review deadline (timestamp)

Parameters

int	deadline (timestamp)

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

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

        {
                $this->peer_dl = $a_val;
        }

Here is the caller graph for this function:

setPeerReviewFileUpload()

ilExAssignment::setPeerReviewFileUpload

(

$a_val

)

Set peer review file upload.

Parameters

bool

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

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

        {
                $this->peer_file = (bool)$a_val;
        }

Here is the caller graph for this function:

setPeerReviewMin()

ilExAssignment::setPeerReviewMin

(

$a_value

)

Set peer review minimum.

Parameters

int

$a_value

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

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

        {
                $this->peer_min = (int)$a_value;
        }

Here is the caller graph for this function:

setPeerReviewPersonalized()

ilExAssignment::setPeerReviewPersonalized

(

$a_val

)

Set peer review personalized.

Parameters

bool

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

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

        {
                $this->peer_personal = (bool)$a_val;
        }

Here is the caller graph for this function:

setPeerReviewRating()

ilExAssignment::setPeerReviewRating

(

$a_val

)

Set peer review rating.

Parameters

bool

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

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

        {
                $this->peer_rating = (bool)$a_val;
        }

Here is the caller graph for this function:

setPeerReviewSimpleUnlock()

ilExAssignment::setPeerReviewSimpleUnlock

(

$a_value

)

Set peer review simple unlock.

Parameters

bool

$a_value

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

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

        {
                $this->peer_unlock = (bool)$a_value;
        }

Here is the caller graph for this function:

setPeerReviewText()

ilExAssignment::setPeerReviewText

(

$a_val

)

Set peer review text.

Parameters

bool

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

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

        {
                $this->peer_text = (bool)$a_val;
        }

Here is the caller graph for this function:

setPeerReviewValid()

ilExAssignment::setPeerReviewValid

(

$a_value

)

Set peer review validation.

Parameters

int

$a_value

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

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

        {
                $this->peer_valid = (int)$a_value;
        }

Here is the caller graph for this function:

setStartTime()

ilExAssignment::setStartTime

(

$a_val

)

Set start time (timestamp)

Parameters

int	start time (timestamp)

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

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

        {
                $this->start_time = $a_val;
        }

Here is the caller graph for this function:

setTeamTutor()

ilExAssignment::setTeamTutor

(

$a_value

)

Set team management by tutor.

Parameters

bool

$a_value

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

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

        {
                $this->team_tutor = (bool)$a_value;
        }

Here is the caller graph for this function:

setTitle()

ilExAssignment::setTitle

(

$a_val

)

Set title.

Parameters

string

title

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

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

        {
                $this->title = $a_val;
        }

Here is the caller graph for this function:

setType()

ilExAssignment::setType

(

$a_value

)

Set type.

Parameters

int

$a_value

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

References isValidType(), and setPeerReview().

Referenced by __construct(), and initFromDB().

        {
                if($this->isValidType($a_value))
                {
                        $this->type = (int)$a_value;
                        
                        if($this->type == self::TYPE_UPLOAD_TEAM)
                        {
                                $this->setPeerReview(false);
                        }
                }
        }

Here is the call graph for this function:

Here is the caller graph for this function:

update()

ilExAssignment::update

(

)

Update.

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

References $ilDB, array, getDeadline(), getExerciseId(), getExtendedDeadline(), getFeedbackDate(), getFeedbackFile(), getId(), getInstruction(), getMandatory(), getMaxFile(), getOrderNr(), getPeerReview(), getPeerReviewChars(), getPeerReviewCriteriaCatalogue(), getPeerReviewDeadline(), getPeerReviewMin(), getPeerReviewSimpleUnlock(), getPeerReviewValid(), getStartTime(), getTeamTutor(), getTitle(), getType(), handleCalendarEntries(), hasFeedbackCron(), hasPeerReviewFileUpload(), hasPeerReviewPersonalized(), hasPeerReviewRating(), and hasPeerReviewText().

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

        {               
                global $ilDB;
                
                $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_cron" => array("integer", $this->hasFeedbackCron()),
                        "team_tutor" => array("integer", $this->getTeamTutor()),
                        "max_file" => array("integer", $this->getMaxFile())
                        ),
                        array(
                        "id" => array("integer", $this->getId()),
                        ));
                $exc = new ilObjExercise($this->getExerciseId(), false);
                $exc->updateAllUsersStatus();
                
                $this->handleCalendarEntries("update");
        }

Here is the call graph for this function:

Here is the caller graph for this function:

uploadAssignmentFiles()

ilExAssignment::uploadAssignmentFiles

(

$a_files

)

Upload assignment files (from creation form)

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

References getExerciseId(), and getId().

Referenced by ilExAssignmentEditorGUI\importFormToAssignment().

        {
                include_once("./Modules/Exercise/classes/class.ilFSStorageExercise.php");
                $storage = new ilFSStorageExercise($this->getExerciseId(), $this->getId());
                $storage->create();
                $storage->uploadAssignmentFiles($a_files);
        }

Here is the call graph for this function:

Here is the caller graph for this function:

uploadMultiFeedbackFile()

ilExAssignment::uploadMultiFeedbackFile

(

$a_file

)

Upload multi feedback file.

Parameters

array

Returns

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

References $ilUser, $lng, ilUtil\delDir(), ilUtil\getDir(), getExerciseId(), getId(), ilUtil\moveUploadedFile(), and ilUtil\unzip().

        {
                global $lng, $ilUser;
                
                include_once("./Modules/Exercise/exceptions/class.ilExerciseException.php");
                if (!is_file($a_file["tmp_name"]))
                {
                        throw new ilExerciseException($lng->txt("exc_feedback_file_could_not_be_uploaded"));
                }
                
                include_once("./Modules/Exercise/classes/class.ilFSStorageExercise.php");
                $storage = new ilFSStorageExercise($this->getExerciseId(), $this->getId());
                $mfu = $storage->getMultiFeedbackUploadPath($ilUser->getId());
                ilUtil::delDir($mfu, true);
                ilUtil::moveUploadedFile($a_file["tmp_name"], "multi_feedback.zip", $mfu."/"."multi_feedback.zip");
                ilUtil::unzip($mfu."/multi_feedback.zip", true);
                $subdirs = ilUtil::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"));
                }

                return true;
        }

Here is the call graph for this function:

Field Documentation

$deadline

ilExAssignment::$deadline

protected

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

Referenced by afterDeadline(), afterDeadlineStrict(), getDeadline(), and recalculateLateSubmissions().

$deadline2

ilExAssignment::$deadline2

protected

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

Referenced by getExtendedDeadline().

$exc_id

ilExAssignment::$exc_id

protected

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

Referenced by getExerciseId().

$feedback_cron

ilExAssignment::$feedback_cron

protected

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

Referenced by hasFeedbackCron().

$feedback_date

ilExAssignment::$feedback_date

protected

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

Referenced by getFeedbackDate().

$feedback_file

ilExAssignment::$feedback_file

protected

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

Referenced by getFeedbackFile().

$id

ilExAssignment::$id

protected

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

Referenced by getId(), recalculateLateSubmissions(), and setIndividualDeadline().

$instruction

ilExAssignment::$instruction

protected

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

Referenced by getInstruction().

$mandatory

ilExAssignment::$mandatory

protected

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

Referenced by getMandatory().

$max_file

ilExAssignment::$max_file

protected

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

Referenced by getMaxFile().

$member_status

ilExAssignment::$member_status = array()

protected

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

Referenced by saveMultiFeedbackFiles().

$order_nr

ilExAssignment::$order_nr

protected

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

Referenced by getOrderNr().

$peer

ilExAssignment::$peer

protected

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

Referenced by getPeerReview().

$peer_char

ilExAssignment::$peer_char

protected

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

Referenced by getPeerReviewChars().

$peer_crit_cat

ilExAssignment::$peer_crit_cat

protected

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

$peer_dl

ilExAssignment::$peer_dl

protected

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

Referenced by getPeerReviewDeadline().

$peer_file

ilExAssignment::$peer_file

protected

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

Referenced by hasPeerReviewFileUpload().

$peer_min

ilExAssignment::$peer_min

protected

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

Referenced by getPeerReviewMin().

$peer_personal

ilExAssignment::$peer_personal

protected

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

Referenced by hasPeerReviewPersonalized().

$peer_rating

ilExAssignment::$peer_rating

protected

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

Referenced by hasPeerReviewRating().

$peer_text

ilExAssignment::$peer_text

protected

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

Referenced by hasPeerReviewText().

$peer_unlock

ilExAssignment::$peer_unlock

protected

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

Referenced by getPeerReviewSimpleUnlock().

$peer_valid

ilExAssignment::$peer_valid

protected

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

Referenced by getPeerReviewValid().

$start_time

ilExAssignment::$start_time

protected

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

Referenced by getStartTime().

$team_tutor

ilExAssignment::$team_tutor = false

protected

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

Referenced by getTeamTutor().

$title

ilExAssignment::$title

protected

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

Referenced by getTitle().

$type

ilExAssignment::$type

protected

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

Referenced by getType().

FEEDBACK_DATE_DEADLINE

const ilExAssignment::FEEDBACK_DATE_DEADLINE = 1

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

Referenced by ilExAssignmentGUI\addSubmission(), ilExSubmissionGUI\downloadGlobalFeedbackFileObject(), ilExAssignmentEditorGUI\initAssignmentForm(), and ilExAssignmentEditorGUI\processForm().

FEEDBACK_DATE_SUBMISSION

const ilExAssignment::FEEDBACK_DATE_SUBMISSION = 2

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

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

PEER_REVIEW_VALID_ALL

const ilExAssignment::PEER_REVIEW_VALID_ALL = 3

Definition at line 24 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 22 of file class.ilExAssignment.php.

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

PEER_REVIEW_VALID_ONE

const ilExAssignment::PEER_REVIEW_VALID_ONE = 2

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

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

TYPE_BLOG

const ilExAssignment::TYPE_BLOG = 2

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

Referenced by ilAssignmentsTableGUI\__construct(), ilExSubmission\downloadAllAssignmentFiles(), ilExSubmission\downloadFiles(), ilExSubmission\getDownloadedFilesInfoForTableGUIS(), ilExSubmissionObjectGUI\getOverviewContent(), ilExSubmission\getSubmissionType(), and ilExAssignmentEditorGUI\getTypeDropdown().

TYPE_PORTFOLIO

const ilExAssignment::TYPE_PORTFOLIO = 3

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

Referenced by ilAssignmentsTableGUI\__construct(), ilObjPortfolioGUI\createPortfolioFromTemplateProcess(), ilExSubmission\downloadAllAssignmentFiles(), ilExSubmission\downloadFiles(), ilExSubmission\getDownloadedFilesInfoForTableGUIS(), ilExSubmissionObjectGUI\getOverviewContent(), ilExSubmission\getSubmissionType(), and ilExAssignmentEditorGUI\getTypeDropdown().

TYPE_TEXT

const ilExAssignment::TYPE_TEXT = 5

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

Referenced by ilAssignmentsTableGUI\__construct(), ilExSubmissionTextGUI\executeCommand(), ilExSubmission\getDownloadedFilesInfoForTableGUIS(), ilExPeerReviewGUI\getSubmissionContent(), ilExSubmission\getSubmissionType(), ilExAssignmentEditorGUI\getTypeDropdown(), ilExSubmissionGUI\listPublicSubmissionsObject(), ilExerciseManagementGUI\listTextAssignmentObject(), and ilExerciseManagementGUI\membersObject().

TYPE_UPLOAD

const ilExAssignment::TYPE_UPLOAD = 1

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

Referenced by ilAssignmentsTableGUI\__construct(), ilExAssignmentEditorGUI\getAssignmentValues(), ilExSubmission\getDownloadedFilesInfoForTableGUIS(), ilExSubmission\getFiles(), ilExSubmission\getSubmissionType(), ilExAssignmentEditorGUI\getTypeDropdown(), and ilExAssignmentEditorGUI\initAssignmentForm().

TYPE_UPLOAD_TEAM

const ilExAssignment::TYPE_UPLOAD_TEAM = 4

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

Referenced by ilAssignmentsTableGUI\__construct(), ilExcDeliveredFilesTableGUI\__construct(), ilExcDeliveredFilesTableGUI\fillRow(), ilExAssignmentTeam\getAdoptableTeamAssignments(), ilExAssignmentEditorGUI\getAssignmentValues(), ilExSubmission\getDownloadedFilesInfoForTableGUIS(), ilExSubmission\getFiles(), ilExSubmission\getSubmissionType(), ilExAssignmentEditorGUI\getTypeDropdown(), ilExAssignmentEditorGUI\handleDisabledFields(), hasReadOnlyIDl(), ilExAssignmentEditorGUI\initAssignmentForm(), ilExerciseManagementGUI\membersObject(), ilExAssignmentEditorGUI\saveAssignmentObject(), and ilExAssignmentEditorGUI\setAssignmentHeader().

---

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

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