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...
	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...
	cloneAssignmentsOfExercise ($a_old_exc_id, $a_new_exc_id, array $a_crit_cat_map)
	Clone assignments of exercise. More...
	getFiles ()
	Get files. More...
	saveAssOrderOfExercise ($a_ex_id, $a_order)
	Save ordering of all assignments of an exercise. More...
	orderAssByDeadline ($a_ex_id)
	Order assignments by deadline date. More...
	countMandatory ($a_ex_id)
	Order assignments by deadline date. 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 ()
	beforeDeadline ()
	notStartedYet ()
	getGlobalFeedbackFileStoragePath ()
	deleteGlobalFeedbackFile ()
	handleGlobalFeedbackFileUpload (array $a_file)
	getGlobalFeedbackFilePath ()
	getMemberStatus ($a_user_id=null)
	recalculateLateSubmissions ()

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	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	lookupTitle ($a_id)
	Lookup title. More...
static	lookupType ($a_id)
	Lookup type. 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
	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 1631 of file class.ilExAssignment.php.

References $deadline.

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

        {
                // no deadline === true
                $deadline = max($this->deadline, $this->deadline2);
                return ($deadline - time() <= 0);
        }

Here is the caller graph for this function:

afterDeadlineStrict()

ilExAssignment::afterDeadlineStrict

(

)

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

References $deadline, and afterDeadline().

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

        {
                // no deadline === false
                $deadline = max($this->deadline, $this->deadline2);             
                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 1646 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 1424 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()

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

Clone assignments of exercise.

Parameters

Definition at line 912 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()

ilExAssignment::countMandatory

(

$a_ex_id

)

Order assignments by deadline date.

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

References $ilDB.

        {
                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 1203 of file class.ilExAssignment.php.

References $ilDB.

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 847 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 1669 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 866 of file class.ilExAssignment.php.

References $data, and $ilDB.

Referenced by ilAssignmentsTableGUI\__construct(), ilExParticipantTableGUI\__construct(), ilExAssignmentTeam\getAdoptableTeamAssignments(), ilExerciseXMLParser\ilExerciseXMLParser(), 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(), handleCalendarEntries(), recalculateLateSubmissions(), 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 199 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 645 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 605 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 978 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 1686 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 1662 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(), handleCalendarEntries(), ilExAssignmentEditorGUI\importFormToAssignment(), recalculateLateSubmissions(), saveMultiFeedbackFiles(), ilObjExercise\sendAssignment(), sendMultiFeedbackStructureFile(), update(), uploadAssignmentFiles(), and uploadMultiFeedbackFile().

        {
                return $this->id;
        }

Here is the caller graph for this function:

getInstancesByExercise()

static ilExAssignment::getInstancesByExercise (   $a_exc_id )

static

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

References $data, and $ilDB.

Referenced by ilExGradesTableGUI\__construct(), ilExSubmission\deleteUser(), ilObjExercise\determinStatusOfUser(), ilObjExercise\exportGradesExcel(), ilExcCriteriaCatalogueTableGUI\getItems(), ilExerciseManagementGUI\membersObject(), 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 219 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:

getMandatory()

ilExAssignment::getMandatory

(

)

Get mandatory.

Returns

int mandatory

Definition at line 259 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 689 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 1155 of file class.ilExAssignment.php.

References $ilDB, 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"];
                        }
                }
                return $mem;
        }

Here is the call graph for this function:

getMemberStatus()

ilExAssignment::getMemberStatus

(

$a_user_id = null

)

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

References $ilUser, and getId().

Referenced by ilExAssignmentGUI\addSubmissionFeedback(), ilExAssignmentGUI\getOverviewHeader(), ilObjExercise\processExerciseStatus(), 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 1351 of file class.ilExAssignment.php.

References $ilUser, ilObjUser\_lookupName(), 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 279 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 343 of file class.ilExAssignment.php.

References $peer.

Referenced by ilExAssignmentGUI\getOverviewHeader(), handleCalendarEntries(), 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 526 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 549 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 554 of file class.ilExAssignment.php.

References $res, 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 403 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 363 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 383 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 423 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 1552 of file class.ilExAssignment.php.

References $ilDB, $res, and $row.

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:

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 665 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 239 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 307 of file class.ilExAssignment.php.

References $type.

Referenced by ilExSubmission\downloadAllAssignmentFiles(), 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 1498 of file class.ilExAssignment.php.

References 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 1674 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:

hasFeedbackCron()

ilExAssignment::hasFeedbackCron

(

)

Get (global) feedback file cron status.

Returns

int

Definition at line 625 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 483 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 503 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 443 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 463 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:

hasTeam()

ilExAssignment::hasTeam

(

)

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

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

        {
                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 719 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 318 of file class.ilExAssignment.php.

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 1024 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 1007 of file class.ilExAssignment.php.

References $ilDB, $query, and $res.

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:

lookupMaxOrderNrForEx()

static ilExAssignment::lookupMaxOrderNrForEx (   $a_exc_id )

static

Select the maximum order nr for an exercise.

Definition at line 988 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 1040 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 1048 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 1117 of file class.ilExAssignment.php.

References $ilDB, and $lng.

        {
                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 1652 of file class.ilExAssignment.php.

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()

ilExAssignment::orderAssByDeadline

(

$a_ex_id

)

Order assignments by deadline date.

Definition at line 1078 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 697 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 1712 of file class.ilExAssignment.php.

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

        {
                global $ilDB;
                
                // see JF, 2015-05-11 
                
                $deadline = $this->getDeadline();
                $ext_deadline = $this->getExtendedDeadline();
                $last_deadline = max($this->getDeadline(), $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);
                        
                        $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 752 of file class.ilExAssignment.php.

References $ilDB, 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 1056 of file class.ilExAssignment.php.

References $ilDB, and $t.

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

References clearMultiFeedbackDirectory(), getExerciseId(), getId(), ilObject\getId(), 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)
                                        {
                                                $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 1576 of file class.ilExAssignment.php.

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

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 1262 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 185 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 615 of file class.ilExAssignment.php.

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 635 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 595 of file class.ilExAssignment.php.

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:

setInstruction()

ilExAssignment::setInstruction

(

$a_val

)

Set instruction.

Parameters

string

instruction

Definition at line 209 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 249 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 675 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 269 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 333 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 513 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 536 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 393 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 473 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 353 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 493 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 433 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 373 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 453 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 413 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 655 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 229 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 289 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 803 of file class.ilExAssignment.php.

References $ilDB, 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 1246 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 1311 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(), and recalculateLateSubmissions().

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

$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\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\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\getSubmissionType(), ilExAssignmentEditorGUI\getTypeDropdown(), ilExAssignmentEditorGUI\handleDisabledFields(), 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