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...
	setDeadlineMode ($a_val)
	Set deadline mode. More...
	getDeadlineMode ()
	Get deadline mode. More...
	setRelativeDeadline ($a_val)
	Set relative deadline. More...
	getRelativeDeadline ()
	Get relative deadline. More...
	setRelDeadlineLastSubmission ($a_val)
	Set relative deadline last submission. More...
	getRelDeadlineLastSubmission ()
	Get relative deadline last submission. More...
	getPersonalDeadline ($a_user_id)
	Get individual deadline (max of common or idl (team) deadline = Official Deadline) More...
	getLastPersonalDeadline ()
	Get last/final personal deadline (of assignment) 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...
	getInstructionPresentation ()
	Get instruction presentation. 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...
	getAssignmentType ()
	Get assignment 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...
	setFeedbackDateCustom ($a_value)
	Set (global) feedback file availability using a custom date. More...
	getFeedbackDateCustom ()
	Get feedback file availability using custom 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...
	setPortfolioTemplateId ($a_val)
	Set portfolio template id. More...
	getPortfolioTemplateId ()
	Get portfolio template id. More...
	read ()
	Read from db. More...
	save ()
	Save assignment. More...
	update ()
	Update. More...
	delete ()
	Delete assignment. More...
	getFiles ()
	Get files. More...
	getInstructionFilesOrder ()
	getMemberListData ()
	get member list data More...
	getExerciseMemberAssignmentData ($a_user_id, $a_grade="")
	Get submission data for an specific user,exercise and assignment. More...
	uploadAssignmentFiles ($a_files)
	Upload assignment files (from creation form) More...
	sendMultiFeedbackStructureFile (ilObjExercise $exercise)
	Create member status record for a new assignment for all participants. More...
	uploadMultiFeedbackFile ($a_file)
	Upload multi feedback file. More...
	getMultiFeedbackFiles ($a_user_id=0)
	Get multi feedback files (of uploader) More...
	clearMultiFeedbackDirectory ()
	Clear multi feedback directory. More...
	saveMultiFeedbackFiles ($a_files, ilObjExercise $a_exc)
	Save multi feedback files. More...
	afterDeadline ()
	afterDeadlineStrict ($a_include_personal=true)
	afterCustomDate ()
	beforeDeadline ()
	notStartedYet ()
	getGlobalFeedbackFileStoragePath ()
	deleteGlobalFeedbackFile ()
	handleGlobalFeedbackFileUpload (array $a_file)
	getGlobalFeedbackFilePath ()
	getMemberStatus ($a_user_id=null)
	recalculateLateSubmissions ()
	setIndividualDeadline ($id, ilDateTime $date)
	getIndividualDeadlines ()
	hasActiveIDl ()
	hasReadOnlyIDl ()
	fixInstructionFileOrdering ()
	fileAddOrder ($a_entries=array())
	setMinCharLimit ($a_val)
	Set limit minimum characters. More...
	getMinCharLimit ()
	Get limit minimum characters. More...
	setMaxCharLimit ($a_val)
	Set limit maximum characters. More...
	getMaxCharLimit ()
	get limit maximum characters return int max limit More...
	getCalculatedDeadlines ()
	Get calculated deadlines for user/team members. More...

Static Public Member Functions
static	getInstancesByExercise ($a_exc_id)
static	instructionFileGetFileOrderData ($a_file_data, $a_ass_id)
static	getAssignmentDataOfExercise ($a_exc_id)
	Get assignments data of an exercise in an array. More...
static	cloneAssignmentsOfExercise ($a_old_exc_id, $a_new_exc_id, array $a_crit_cat_map)
	Clone assignments of exercise. More...
static	lookupMaxOrderNrForEx ($a_exc_id)
	Select the maximum order nr for an exercise. More...
static	lookupAssignmentOnline ($a_ass_id)
	Check if assignment is online. More...
static	lookupExerciseId ($a_ass_id)
	Lookup excercise id for assignment id. More...
static	lookupTitle ($a_id)
	Lookup title. More...
static	lookupType ($a_id)
	Lookup type. More...
static	saveAssOrderOfExercise ($a_ex_id, $a_order)
	Save ordering of all assignments of an exercise. More...
static	orderAssByDeadline ($a_ex_id)
	Order assignments by deadline date. More...
static	countMandatory ($a_ex_id)
	Count the number of mandatory assignments. More...
static	count ($a_ex_id)
	Order assignments by deadline date. More...
static	isInExercise ($a_ass_id, $a_ex_id)
	Is assignment in exercise? 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)
static	saveInstructionFilesOrderOfAssignment ($a_ass_id, $a_order)
	Save ordering of instruction files for an assignment. More...
static	insertFileOrderNr (int $a_ass_id, string $a_filename, int $a_order_nr)
static	instructionFileInsertOrder ($a_filename, $a_ass_id, $a_order_nr=0)
	Store the file order in the database. More...
static	instructionFileDeleteOrder ($a_ass_id, $a_file)
static	renameInstructionFile ($a_old_name, $a_new_name, $a_ass_id)
static	instructionFileExistsInDb ($a_filename, $a_ass_id)
static	instructionFileOrderGetMax ($a_ass_id)

Data Fields
const	TYPE_UPLOAD = 1
const	TYPE_BLOG = 2
const	TYPE_PORTFOLIO = 3
const	TYPE_UPLOAD_TEAM = 4
const	TYPE_TEXT = 5
const	TYPE_WIKI_TEAM = 6
const	FEEDBACK_DATE_DEADLINE = 1
const	FEEDBACK_DATE_SUBMISSION = 2
const	FEEDBACK_DATE_CUSTOM = 3
const	PEER_REVIEW_VALID_NONE = 1
const	PEER_REVIEW_VALID_ONE = 2
const	PEER_REVIEW_VALID_ALL = 3
const	TEAMS_FORMED_BY_PARTICIPANTS = 0
const	TEAMS_FORMED_BY_TUTOR = 1
const	TEAMS_FORMED_BY_RANDOM = 2
const	TEAMS_FORMED_BY_ASSIGNMENT = 3
const	DEADLINE_ABSOLUTE = 0
const	DEADLINE_RELATIVE = 1

Protected Member Functions
	initFromDB (array $a_set)
	Import DB record. More...
	handleCalendarEntries ($a_event)
	Handle calendar entries for deadline(s) More...

Protected Attributes
	$db
	$lng
	$user
	$app_event_handler
	$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
	$feedback_date_custom
	$team_tutor = false
	$max_file
	$portfolio_template
	$min_char_limit
	$max_char_limit
	$types = null
	$ass_type
	$deadline_mode = 0
	$relative_deadline = 0
	$starting_timestamp = null
	$rel_deadline_last_subm
	$member_status = array()
	$log

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

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

Constructor & Destructor Documentation

__construct()

ilExAssignment::__construct

(

$a_id = 0

)

Constructor.

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

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

    {
        global $DIC;

        $this->db = $DIC->database();
        $this->lng = $DIC->language();
        $this->user = $DIC->user();
        $this->app_event_handler = $DIC["ilAppEventHandler"];
        $this->types = ilExAssignmentTypes::getInstance();

        $this->setType(self::TYPE_UPLOAD);
        $this->setFeedbackDate(self::FEEDBACK_DATE_DEADLINE);

        $this->log = ilLoggerFactory::getLogger("exc");
        
        if ($a_id > 0) {
            $this->setId($a_id);
            $this->read();
        }
    }

Here is the call graph for this function:

Member Function Documentation

afterCustomDate()

ilExAssignment::afterCustomDate

(

)

Returns

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

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

References getFeedbackDateCustom().

Referenced by ilExAssignmentGUI\addSubmission().

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

Here is the call graph for this function:

Here is the caller graph for this function:

afterDeadline()

ilExAssignment::afterDeadline

(

)

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

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

Referenced by afterDeadlineStrict().

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

Here is the call graph for this function:

Here is the caller graph for this function:

afterDeadlineStrict()

ilExAssignment::afterDeadlineStrict

(

$a_include_personal = true

)

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

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

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

beforeDeadline()

ilExAssignment::beforeDeadline

(

)

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

References afterDeadlineStrict().

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

Here is the call graph for this function:

clearMultiFeedbackDirectory()

ilExAssignment::clearMultiFeedbackDirectory

(

)

Clear multi feedback directory.

Parameters

array

Returns

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

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

Referenced by saveMultiFeedbackFiles().

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

Here is the call graph for this function:

Here is the caller graph for this function:

cloneAssignmentsOfExercise()

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

static

Clone assignments of exercise.

Parameters

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

References $ass_type, $d, ilFSWebStorageExercise\create(), ilFSStorageExercise\create(), ilExAssignmentReminder\FEEDBACK_REMINDER, ilFSStorageExercise\getGlobalFeedbackPath(), ilFileSystemStorage\getPath(), ilExAssignmentReminder\GRADE_REMINDER, insertFileOrderNr(), ilUtil\rCopy(), ilExAssignmentReminder\setReminderStatus(), and ilExAssignmentReminder\SUBMIT_REMINDER.

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->setFeedbackFile($d->getFeedbackFile());
            $new_ass->setFeedbackDate($d->getFeedbackDate());
            $new_ass->setFeedbackDateCustom($d->getFeedbackDateCustom());
            $new_ass->setFeedbackCron($d->hasFeedbackCron()); // #16295
            $new_ass->setTeamTutor($d->getTeamTutor());
            $new_ass->setMaxFile($d->getMaxFile());
            $new_ass->setMinCharLimit($d->getMinCharLimit());
            $new_ass->setMaxCharLimit($d->getMaxCharLimit());
            $new_ass->setPortfolioTemplateId($d->getPortfolioTemplateId());
            $new_ass->setDeadlineMode($d->getDeadlineMode());
            $new_ass->setRelativeDeadline($d->getRelativeDeadline());
            $new_ass->setRelDeadlineLastSubmission($d->getRelDeadlineLastSubmission());

            // criteria catalogue(s)
            if ($d->getPeerReviewCriteriaCatalogue() &&
                array_key_exists($d->getPeerReviewCriteriaCatalogue(), $a_crit_cat_map)) {
                $new_ass->setPeerReviewCriteriaCatalogue($a_crit_cat_map[$d->getPeerReviewCriteriaCatalogue()]);
            }
            
            $new_ass->save();
            

            // clone assignment files
            $old_web_storage = new ilFSWebStorageExercise($a_old_exc_id, (int) $d->getId());
            $new_web_storage = new ilFSWebStorageExercise($a_new_exc_id, (int) $new_ass->getId());
            $new_web_storage->create();
            if (is_dir($old_web_storage->getPath())) {
                ilUtil::rCopy($old_web_storage->getPath(), $new_web_storage->getPath());
            }
            $order = $d->getInstructionFilesOrder();
            foreach ($order as $file) {
                ilExAssignment::insertFileOrderNr($new_ass->getId(), $file["filename"], $file["order_nr"]);
            }

            // clone global feedback file
            $old_storage = new ilFSStorageExercise($a_old_exc_id, (int) $d->getId());
            $new_storage = new ilFSStorageExercise($a_new_exc_id, (int) $new_ass->getId());
            $new_storage->create();
            if (is_dir($old_storage->getGlobalFeedbackPath())) {
                ilUtil::rCopy($old_storage->getGlobalFeedbackPath(), $new_storage->getGlobalFeedbackPath());
            }

            // clone reminders
            foreach ([ilExAssignmentReminder::SUBMIT_REMINDER,
                      ilExAssignmentReminder::GRADE_REMINDER,
                      ilExAssignmentReminder::FEEDBACK_REMINDER] as $rem_type) {
                $rmd_sub = new ilExAssignmentReminder($a_old_exc_id, $d->getId(), $rem_type);
                if ($rmd_sub->getReminderStatus()) {
                    $new_rmd_sub = new ilExAssignmentReminder($a_new_exc_id, $new_ass->getId(), $rem_type);
                    $new_rmd_sub->setReminderStatus($rmd_sub->getReminderStatus());
                    $new_rmd_sub->setReminderStart($rmd_sub->getReminderStart());
                    $new_rmd_sub->setReminderEnd($rmd_sub->getReminderEnd());
                    $new_rmd_sub->setReminderFrequency($rmd_sub->getReminderFrequency());
                    $new_rmd_sub->setReminderMailTemplate($rmd_sub->getReminderMailTemplate());
                    $new_rmd_sub->save();
                }
            }


            // type specific properties
            $ass_type = $d->getAssignmentType();
            $ass_type->cloneSpecificProperties($d, $new_ass);
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

count()

static ilExAssignment::count (   $a_ex_id )

static

Order assignments by deadline date.

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

References $DIC, and $ilDB.

Referenced by getMultiFeedbackFiles(), ilObjExerciseGUI\initEditCustomForm(), and lookupUpdatedSubmission().

    {
        global $DIC;

        $ilDB = $DIC->database();

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

Here is the caller graph for this function:

countMandatory()

static ilExAssignment::countMandatory (   $a_ex_id )

static

Count the number of mandatory assignments.

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

References $DIC, and $ilDB.

Referenced by ilObjExerciseGUI\initEditCustomForm().

    {
        global $DIC;

        $ilDB = $DIC->database();
        
        $set = $ilDB->query(
            "SELECT count(*) cntm FROM exc_assignment " .
            " WHERE exc_id = " . $ilDB->quote($a_ex_id, "integer") .
            " AND mandatory = " . $ilDB->quote(1, "integer")
        );
        $rec = $ilDB->fetchAssoc($set);
        return $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 1679 of file class.ilExAssignment.php.

References $DIC, and $ilDB.

    {
        global $DIC;

        $ilDB = $DIC->database();
        
        $exmem = new ilExerciseMembers($a_exc);
        $mems = $exmem->getMembers();

        foreach ($mems as $mem) {
            $ilDB->replace("exc_mem_ass_status", array(
                "ass_id" => array("integer", $a_ass_id),
                "usr_id" => array("integer", $mem)
                ), array(
                "status" => array("text", "notgraded")
                ));
        }
    }

createNewUserRecords()

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

static

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

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

References $DIC, and $ilDB.

Referenced by ilExerciseMembers\assignMember().

    {
        global $DIC;

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

Here is the caller graph for this function:

delete()

ilExAssignment::delete

(

)

Delete assignment.

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

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

    {
        $ilDB = $this->db;
        
        $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");

        $reminder = new ilExAssignmentReminder();
        $reminder->deleteReminders($this->getId());
    }

Here is the call graph for this function:

deleteGlobalFeedbackFile()

ilExAssignment::deleteGlobalFeedbackFile

(

)

Definition at line 2153 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:

fileAddOrder()

ilExAssignment::fileAddOrder

(

$a_entries = array()

)

Parameters

array	$a_entries
integer	$a_ass_id	assignment id

Returns

array data items

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

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

    {
        $this->fixInstructionFileOrdering();

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

        return $a_entries;
    }

Here is the call graph for this function:

fixInstructionFileOrdering()

ilExAssignment::fixInstructionFileOrdering

(

)

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

References $db, $DIC, Vendor\Package\$f, $order_nr, getFiles(), and getId().

Referenced by fileAddOrder().

    {
        global $DIC;

        $db = $DIC->database();

        $files = array_map(function ($v) {
            return $v["name"];
        }, $this->getFiles());

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

Here is the call graph for this function:

Here is the caller graph for this function:

getAssignmentDataOfExercise()

static ilExAssignment::getAssignmentDataOfExercise (   $a_exc_id )

static

Get assignments data of an exercise in an array.

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

References $data, $DIC, and $ilDB.

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

    {
        global $DIC;

        $ilDB = $DIC->database();
        
        // should be changed to self::getInstancesByExerciseId()
        
        $set = $ilDB->query("SELECT * FROM exc_assignment " .
            " WHERE exc_id = " . $ilDB->quote($a_exc_id, "integer") .
            " ORDER BY order_nr 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"],
                "deadline_mode" => $rec["deadline_mode"],
                "relative_deadline" => $rec["relative_deadline"],
                "rel_deadline_last_subm" => $rec["rel_deadline_last_subm"]
                );
            $order_val += 10;
        }
        return $data;
    }

Here is the caller graph for this function:

getAssignmentType()

ilExAssignment::getAssignmentType

(

)

Get assignment type.

Parameters

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

References $ass_type.

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

    {
        return $this->ass_type;
    }

Here is the caller graph for this function:

getCalculatedDeadlines()

ilExAssignment::getCalculatedDeadlines

(

)

Get calculated deadlines for user/team members.

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

Returns

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

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

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

    {
        $calculated_deadlines = array(
            "user" => array(),
            "team" => array()
        );

        if ($this->getRelativeDeadline() && $this->getDeadlineMode() == self::DEADLINE_RELATIVE) {
            foreach (ilExcIndividualDeadline::getStartingTimestamps($this->getId()) as $ts) {
                $type = $ts["is_team"]
                    ? "team"
                    : "user";

                $calculated_deadlines[$type][$ts["member_id"]] = array(
                    "calculated_deadline" => $ts["starting_ts"] + ($this->getRelativeDeadline() * 24 * 60 * 60)
                );
            }
        }
        return $calculated_deadlines;
    }

Here is the call graph for this function:

getDeadline()

ilExAssignment::getDeadline

(

)

Get deadline (timestamp)

Returns

int deadline (timestamp)

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

References $deadline.

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

    {
        return $this->deadline;
    }

Here is the caller graph for this function:

getDeadlineMode()

ilExAssignment::getDeadlineMode

(

)

Get deadline mode.

Returns

int deadline mode

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

References $deadline_mode.

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

    {
        return $this->deadline_mode;
    }

Here is the caller graph for this function:

getExerciseId()

ilExAssignment::getExerciseId

(

)

Get exercise id.

Returns

int exercise id

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

References $exc_id.

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

    {
        return $this->exc_id;
    }

Here is the caller graph for this function:

getExerciseMemberAssignmentData()

ilExAssignment::getExerciseMemberAssignmentData	(		$a_user_id,
			$a_grade = ""
	)

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

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

Parameters

$a_user_id
$a_grade

Returns

array

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

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

    {
        global $DIC;
        $ilDB = $DIC->database();

        if (in_array($a_grade, array("notgraded", "passed", "failed"))) {
            $and_grade = " AND status = " . $ilDB->quote($a_grade, "text");
        }

        $q = "SELECT * FROM exc_mem_ass_status " .
            "WHERE ass_id = " . $ilDB->quote($this->getId(), "integer") .
            " AND usr_id = " . $ilDB->quote($a_user_id, "integer") .
            $and_grade;

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

        while ($rec = $ilDB->fetchAssoc($set)) {
            $sub = new ilExSubmission($this, $a_user_id);

            $data["sent_time"] = $rec["sent_time"];
            $data["submission"] = $sub->getLastSubmission();
            $data["status_time"] = $rec["status_time"];
            $data["feedback_time"] = $rec["feedback_time"];
            $data["notice"] = $rec["notice"];
            $data["status"] = $rec["status"];
            $data["mark"] = $rec["mark"];
            $data["comment"] = $rec["u_comment"];
        }

        return $data;
    }

Here is the call graph for this function:

getExtendedDeadline()

ilExAssignment::getExtendedDeadline

(

)

Get extended deadline (timestamp)

Returns

int

Definition at line 417 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 881 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:

getFeedbackDateCustom()

ilExAssignment::getFeedbackDateCustom

(

)

Get feedback file availability using custom date.

Returns

string timestamp

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

References $feedback_date_custom.

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

    {
        return $this->feedback_date_custom;
    }

Here is the caller graph for this function:

getFeedbackFile()

ilExAssignment::getFeedbackFile

(

)

Get (global) feedback file.

Returns

int

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

References getExerciseId(), and getId().

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

getGlobalFeedbackFilePath()

ilExAssignment::getGlobalFeedbackFilePath

(

)

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

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

References getExerciseId(), and getId().

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

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

References $id.

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

    {
        return $this->id;
    }

Here is the caller graph for this function:

getIndividualDeadlines()

ilExAssignment::getIndividualDeadlines

(

)

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

References $db, $ilDB, and $res.

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

getInstancesByExercise()

static ilExAssignment::getInstancesByExercise (   $a_exc_id )

static

Parameters

$a_exc_id

Returns

ilExAssignment[]

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

References $data, $DIC, and $ilDB.

Referenced by ilExGradesTableGUI\__construct(), ilExcRandomAssignmentManager\__construct(), ilCalendarScheduleFilterExercise\addCustomEvents(), ilExSubmission\deleteUser(), ilObjExercise\exportGradesExcel(), ilExcRandomAssignmentManager\getAssignmentSelection(), ilExcCriteriaCatalogueTableGUI\getItems(), ilExcRandomAssignmentManager\getNumberOfMandatoryAssignments(), ilExcRandomAssignmentManager\getTotalNumberOfAssignments(), ilExParticipantTableGUI\initMode(), ilExerciseManagementGUI\membersObject(), ilExerciseManagementCollectFilesJob\run(), ilObjExercise\sendAssignment(), and ilObjExerciseGUI\showOverviewObject().

    {
        global $DIC;

        $ilDB = $DIC->database();
        
        $set = $ilDB->query("SELECT * FROM exc_assignment " .
            " WHERE exc_id = " . $ilDB->quote($a_exc_id, "integer") .
            " ORDER BY order_nr 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 437 of file class.ilExAssignment.php.

References $instruction.

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

    {
        return $this->instruction;
    }

Here is the caller graph for this function:

getInstructionFilesOrder()

ilExAssignment::getInstructionFilesOrder

(

)

Parameters

$a_ass_id

Returns

array

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

References $data, $db, and $ilDB.

Referenced by fileAddOrder().

    {
        $ilDB = $this->db;

        $set = $ilDB->query(
            "SELECT filename, order_nr, id FROM exc_ass_file_order " .
            " WHERE assignment_id  = " . $ilDB->quote($this->getId(), "integer")
        );

        $data = array();
        while ($rec = $ilDB->fetchAssoc($set)) {
            $data[$rec['filename']] = $rec;
        }

        return $data;
    }

Here is the caller graph for this function:

getInstructionPresentation()

ilExAssignment::getInstructionPresentation

(

)

Get instruction presentation.

Returns

string

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

References getInstruction(), and ilUtil\makeClickable().

    {
        $inst = $this->getInstruction();
        if (trim($inst)) {
            $is_html = (strlen($inst) != strlen(strip_tags($inst)));
            if (!$is_html) {
                $inst = nl2br(ilUtil::makeClickable($inst, true));
            }
        }
        return $inst;
    }

Here is the call graph for this function:

getLastPersonalDeadline()

ilExAssignment::getLastPersonalDeadline

(

)

Get last/final personal deadline (of assignment)

Returns

int

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

References $db, and $ilDB.

Referenced by afterDeadlineStrict().

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

Here is the caller graph for this function:

getMandatory()

ilExAssignment::getMandatory

(

)

Get mandatory.

Returns

int mandatory

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

References $mandatory.

Referenced by save(), and update().

    {
        return $this->mandatory;
    }

Here is the caller graph for this function:

getMaxCharLimit()

ilExAssignment::getMaxCharLimit

(

)

get limit maximum characters return int max limit

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

References $max_char_limit.

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

    {
        return $this->max_char_limit;
    }

Here is the caller graph for this function:

getMaxFile()

ilExAssignment::getMaxFile

(

)

Get max number of uploads.

Returns

bool

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

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

    {
        $ilDB = $this->db;

        $mem = array();
        
        // first get list of members from member table
        $set = $ilDB->query("SELECT ud.usr_id, ud.lastname, ud.firstname, ud.login" .
            " FROM exc_members excm" .
            " JOIN usr_data ud ON (ud.usr_id = excm.usr_id)" .
            " WHERE excm.obj_id = " . $ilDB->quote($this->getExerciseId(), "integer"));
        while ($rec = $ilDB->fetchAssoc($set)) {
            $mem[$rec["usr_id"]] =
                array(
                "name" => $rec["lastname"] . ", " . $rec["firstname"],
                "login" => $rec["login"],
                "usr_id" => $rec["usr_id"],
                "lastname" => $rec["lastname"],
                "firstname" => $rec["firstname"]
                );
        }
        
        $q = "SELECT * FROM exc_mem_ass_status " .
            "WHERE ass_id = " . $ilDB->quote($this->getId(), "integer");
        $set = $ilDB->query($q);
        while ($rec = $ilDB->fetchAssoc($set)) {
            if (isset($mem[$rec["usr_id"]])) {
                $sub = new ilExSubmission($this, $rec["usr_id"]);
                
                $mem[$rec["usr_id"]]["sent_time"] = $rec["sent_time"];
                $mem[$rec["usr_id"]]["submission"] = $sub->getLastSubmission();
                $mem[$rec["usr_id"]]["status_time"] = $rec["status_time"];
                $mem[$rec["usr_id"]]["feedback_time"] = $rec["feedback_time"];
                $mem[$rec["usr_id"]]["notice"] = $rec["notice"];
                $mem[$rec["usr_id"]]["status"] = $rec["status"];
                $mem[$rec["usr_id"]]["mark"] = $rec["mark"];
                $mem[$rec["usr_id"]]["comment"] = $rec["u_comment"];
            }
        }
        return $mem;
    }

Here is the call graph for this function:

getMemberStatus()

ilExAssignment::getMemberStatus

(

$a_user_id = null

)

Parameters

int | null

$a_user_id

Returns

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

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

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

getMinCharLimit()

ilExAssignment::getMinCharLimit

(

)

Get limit minimum characters.

Returns

int minimum limit

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

References $min_char_limit.

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

    {
        return $this->min_char_limit;
    }

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

References Vendor\Package\$f, $i, $ilUser, $name, $user, ilObjUser\_lookupName(), count(), ilUtil\getDir(), getExerciseId(), and getId().

Referenced by saveMultiFeedbackFiles().

    {
        $ilUser = $this->user;
        
        if ($a_user_id == 0) {
            $a_user_id = $ilUser->getId();
        }
        
        $mf_files = array();
        
        // get members
        $exc = new ilObjExercise($this->getExerciseId(), false);
        $exmem = new ilExerciseMembers($exc);
        $mems = $exmem->getMembers();

        // read mf directory
        $storage = new ilFSStorageExercise($this->getExerciseId(), $this->getId());
        $mfu = $storage->getMultiFeedbackUploadPath($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 515 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 588 of file class.ilExAssignment.php.

References $peer.

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

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

Here is the caller graph for this function:

getPeerReviewChars()

ilExAssignment::getPeerReviewChars

(

)

Get peer review minimum characters.

Returns

int

Definition at line 771 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 794 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 799 of file class.ilExAssignment.php.

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

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

References $peer_dl.

Referenced by 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 608 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 628 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 668 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 1997 of file class.ilExAssignment.php.

References $DIC, $ilDB, and $res.

Referenced by ilExcCronFeedbackNotification\run().

    {
        global $DIC;

        $ilDB = $DIC->database();
        
        $res = array();

        $set = $ilDB->query("SELECT id,fb_file,time_stamp,deadline2,fb_date FROM exc_assignment" .
            " WHERE fb_cron = " . $ilDB->quote(1, "integer") .
            " AND (fb_date = " . $ilDB->quote(self::FEEDBACK_DATE_DEADLINE, "integer") .
                " AND time_stamp IS NOT NULL" .
                " AND time_stamp > " . $ilDB->quote(0, "integer") .
                " AND time_stamp < " . $ilDB->quote(time(), "integer") .
                " AND fb_cron_done = " . $ilDB->quote(0, "integer") .
            ") OR (fb_date = " . $ilDB->quote(self::FEEDBACK_DATE_CUSTOM, "integer") .
                " AND fb_date_custom IS NOT NULL" .
                " AND fb_date_custom > " . $ilDB->quote(0, "integer") .
                " AND fb_date_custom < " . $ilDB->quote(time(), "integer") .
                " AND fb_cron_done = " . $ilDB->quote(0, "integer") . ")");



        while ($row = $ilDB->fetchAssoc($set)) {
            if ($row['fb_date'] == self::FEEDBACK_DATE_DEADLINE) {
                $max = max($row['time_stamp'], $row['deadline2']);
                if (trim($row["fb_file"]) && $max <= time()) {
                    $res[] = $row["id"];
                }
            } elseif ($row['fb_date'] == self::FEEDBACK_DATE_CUSTOM) {
                if (trim($row["fb_file"]) && $row['fb_date_custom'] <= time()) {
                    $res[] = $row["id"];
                }
            }
        }

        return $res;
    }

Here is the caller graph for this function:

getPersonalDeadline()

ilExAssignment::getPersonalDeadline

(

$a_user_id

)

Get individual deadline (max of common or idl (team) deadline = Official Deadline)

Parameters

int

$a_user_id

Returns

int

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

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

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

getPortfolioTemplateId()

ilExAssignment::getPortfolioTemplateId

(

)

Get portfolio template id.

Returns

int portfolio template id

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

References $portfolio_template.

Referenced by ilExAssTypePortfolioGUI\getFormValuesArray().

    {
        return $this->portfolio_template;
    }

Here is the caller graph for this function:

getRelativeDeadline()

ilExAssignment::getRelativeDeadline

(

)

Get relative deadline.

Returns

int relative deadline

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

References $relative_deadline.

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

    {
        return $this->relative_deadline;
    }

Here is the caller graph for this function:

getRelDeadlineLastSubmission()

ilExAssignment::getRelDeadlineLastSubmission

(

)

Get relative deadline last submission.

Returns

int

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

References $rel_deadline_last_subm.

Referenced by save(), and update().

    {
        return $this->rel_deadline_last_subm;
    }

Here is the caller graph for this function:

getStartTime()

ilExAssignment::getStartTime

(

)

Get start time (timestamp)

Returns

int start time (timestamp)

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

References $start_time.

Referenced by 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 919 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 475 of file class.ilExAssignment.php.

References $title.

Referenced by ilExAssignmentPeerReviewOverviewTableGUI\__construct(), ilExAssignmentPeerReviewTableGUI\__construct(), 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

Deprecated:

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

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

References $app, $app_event_handler, DEADLINE_RELATIVE, getDeadline(), getDeadlineMode(), getExerciseId(), getId(), getPeerReview(), getPeerReviewDeadline(), getTitle(), IL_CAL_TRANSLATION_SYSTEM, and IL_CAL_UNIX.

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

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

            if ($this->getPeerReview() &&
                $this->getPeerReviewDeadline()) {
                $app = new ilCalendarAppointmentTemplate($fbdl_id);
                $app->setTranslationType(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;
            }
        }
                
        $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 2158 of file class.ilExAssignment.php.

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

Referenced by ilExAssignmentEditorGUI\importFormToAssignment().

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

Here is the call graph for this function:

Here is the caller graph for this function:

hasActiveIDl()

ilExAssignment::hasActiveIDl

(

)

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

References getDeadline().

Referenced by ilExerciseSubmissionTableGUI\parseRow().

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

Here is the call graph for this function:

Here is the caller graph for this function:

hasFeedbackCron()

ilExAssignment::hasFeedbackCron

(

)

Get (global) feedback file cron status.

Returns

int

Definition at line 861 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 728 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 748 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 688 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 708 of file class.ilExAssignment.php.

References $peer_text.

Referenced by save(), and update().

    {
        return $this->peer_text;
    }

Here is the caller graph for this function:

hasReadOnlyIDl()

ilExAssignment::hasReadOnlyIDl

(

)

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

References getPeerReview().

Referenced by ilExerciseSubmissionTableGUI\parseRow().

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

Here is the call graph for this function:

Here is the caller graph for this function:

hasTeam()

ilExAssignment::hasTeam

(

)

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

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

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

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

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

Referenced by read().

    {
        $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->setFeedbackDateCustom($a_set["fb_date_custom"]);
        $this->setFeedbackCron($a_set["fb_cron"]);
        $this->setTeamTutor($a_set["team_tutor"]);
        $this->setMaxFile($a_set["max_file"]);
        $this->setPortfolioTemplateId($a_set["portfolio_template"]);
        $this->setMinCharLimit($a_set["min_char_limit"]);
        $this->setMaxCharLimit($a_set["max_char_limit"]);
        $this->setDeadlineMode($a_set["deadline_mode"]);
        $this->setRelativeDeadline($a_set["relative_deadline"]);
        $this->setRelDeadlineLastSubmission($a_set["rel_deadline_last_subm"]);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

insertFileOrderNr()

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

static

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

References $db, $DIC, and $id.

Referenced by cloneAssignmentsOfExercise().

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

Here is the caller graph for this function:

instructionFileDeleteOrder()

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

static

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

References $db, and $DIC.

Referenced by ilExAssignmentFileSystemGUI\deleteFile().

    {
        global $DIC;

        $db = $DIC->database();

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

Here is the caller graph for this function:

instructionFileExistsInDb()

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

static

Parameters

$a_filename
$a_ass_id	assignment id

Returns

int if the file exists or not in the DB

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

References $db, $DIC, and $result.

    {
        global $DIC;

        $db = $DIC->database();

        if ($a_ass_id) {
            $result = $db->query(
                "SELECT id FROM exc_ass_file_order" .
                " WHERE assignment_id = " . $db->quote((int) $a_ass_id, 'integer') .
                " AND filename = " . $db->quote($a_filename, 'string')
            );

            return $db->numRows($result);
        }
    }

instructionFileGetFileOrderData()

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

static

Parameters

array	$a_file_data
integer	$a_ass_id	assignment id.

Returns

array

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

References $db, and $DIC.

    {
        global $DIC;

        $db = $DIC->database();
        $db->setLimit(1, 0);

        $result_order_val = $db->query("
                                SELECT id, order_nr
                                FROM exc_ass_file_order
                                WHERE assignment_id = {$db->quote($a_ass_id, 'integer')}
                                AND filename = {$db->quote($a_file_data['entry'], 'string')}
                        ");

        $order_val = 0;
        $order_id = 0;
        while ($row = $db->fetchAssoc($result_order_val)) {
            $order_val = (int) $row['order_nr'];
            $order_id = (int) $row['id'];
        }
        return array($order_val, $order_id);
    }

instructionFileInsertOrder()

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

static

Store the file order in the database.

Parameters

string	$a_filename	previously sanitized.
int	$a_ass_id	assignment id.

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

References $db, $DIC, $filename, $id, and ilUtil\getSafeFilename().

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

    {
        global $DIC;

        $db = $DIC->database();

        $order = 0;
        $order_val = 0;

        if ($a_ass_id) {
            //first of all check the suffix and change if necessary
            $filename = ilUtil::getSafeFilename($a_filename);

            if (!self::instructionFileExistsInDb($filename, $a_ass_id)) {
                if ($a_order_nr == 0) {
                    $order_val = self::instructionFileOrderGetMax($a_ass_id);
                    $order = $order_val + 10;
                } else {
                    $order = $a_order_nr;
                }

                $id = $db->nextID('exc_ass_file_order');
                $db->manipulate("INSERT INTO exc_ass_file_order " .
                    "(id, assignment_id, filename, order_nr) VALUES (" .
                    $db->quote($id, "integer") . "," .
                    $db->quote($a_ass_id, "integer") . "," .
                    $db->quote($filename, "text") . "," .
                    $db->quote($order, "integer") .
                    ")");
            }
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

instructionFileOrderGetMax()

static ilExAssignment::instructionFileOrderGetMax (   $a_ass_id )

static

Parameters

int

$a_ass_id

assignment id

Returns

int

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

References $db, $DIC, and $result.

    {
        global $DIC;

        $db = $DIC->database();

        //get max order number
        $result = $db->queryF(
            "SELECT max(order_nr) as max_order FROM exc_ass_file_order WHERE assignment_id = %s",
            array('integer'),
            array($db->quote($a_ass_id, 'integer'))
        );

        while ($row = $db->fetchAssoc($result)) {
            $order_val = (int) $row['max_order'];
        }
        return $order_val;
    }

isInExercise()

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

static

Is assignment in exercise?

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

References $DIC, and $ilDB.

Referenced by ilExcRandomAssignmentDBRepository\getAssignmentsOfUser(), and ilExcRandomAssignmentDBRepository\saveAssignmentsOfUser().

    {
        global $DIC;

        $ilDB = $DIC->database();

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

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

Referenced by setType().

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

Here is the caller graph for this function:

lookup()

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

staticprivate

Private lookup.

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

References $DIC, and $ilDB.

    {
        global $DIC;

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

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

        return $rec[$a_field];
    }

lookupAssignmentOnline()

static ilExAssignment::lookupAssignmentOnline (   $a_ass_id )

static

Check if assignment is online.

Parameters

int

$a_ass_id

Returns

bool

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

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

Referenced by ilObjExerciseSubItemListGUI\isAssignmentVisible().

    {
        global $DIC;

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

Here is the caller graph for this function:

lookupExerciseId()

static ilExAssignment::lookupExerciseId (   $a_ass_id )

static

Lookup excercise id for assignment id.

Parameters

int

$a_ass_id

Returns

int

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

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

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

    {
        global $DIC;

        $ilDB = $DIC->database();

        $query = "SELECT exc_id FROM exc_assignment " .
            "WHERE id = " . $ilDB->quote($a_ass_id, 'integer');
        $res = $ilDB->fetchAssoc($ilDB->query($query));

        return (int) $res["exc_id"];
    }

Here is the caller graph for this function:

lookupMaxOrderNrForEx()

static ilExAssignment::lookupMaxOrderNrForEx (   $a_exc_id )

static

Select the maximum order nr for an exercise.

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

References $DIC, and $ilDB.

    {
        global $DIC;

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

lookupTitle()

static ilExAssignment::lookupTitle (   $a_id )

static

Lookup title.

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

Referenced by ilExAssignmentReminder\checkReminders(), ilExAssignmentEditorGUI\confirmAssignmentsDeletionObject(), ilExSubmission\downloadMultipleFiles(), ilObjExerciseSubItemListGUI\getHTML(), ilExerciseManagementGUI\initMultiFeedbackForm(), ilExcMailTemplatePeerReminderContext\resolveSpecificPlaceholder(), ilExcMailTemplateSubmitReminderContext\resolveSpecificPlaceholder(), ilExcMailTemplateGradeReminderContext\resolveSpecificPlaceholder(), ilDownloadSubmissionsBackgroundTask\run(), 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 1425 of file class.ilExAssignment.php.

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

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

Here is the caller graph for this function:

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

References $DIC, $ilDB, $lng, and count().

    {
        global $DIC;

        $ilDB = $DIC->database();
        $lng = $DIC->language();
        
        // 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;
        }
    }

Here is the call graph for this function:

notStartedYet()

ilExAssignment::notStartedYet

(

)

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

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

orderAssByDeadline()

static ilExAssignment::orderAssByDeadline (   $a_ex_id )

static

Order assignments by deadline date.

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

References $DIC, and $ilDB.

Referenced by ilExAssignmentEditorGUI\orderAssignmentsByDeadlineObject().

    {
        global $DIC;
        $ilDB = $DIC->database();
        
        $set = $ilDB->query(
            "SELECT id FROM exc_assignment " .
            " WHERE exc_id = " . $ilDB->quote($a_ex_id, "integer") .
            " ORDER BY time_stamp 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 971 of file class.ilExAssignment.php.

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

Referenced by __construct().

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

Here is the call graph for this function:

Here is the caller graph for this function:

recalculateLateSubmissions()

ilExAssignment::recalculateLateSubmissions

(

)

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

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

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

renameInstructionFile()

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

static

Parameters

string	$a_old_name
string	$a_new_name
int	$a_ass_id	assignment id

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

References $db, and $DIC.

Referenced by ilExAssignmentFileSystemGUI\renameFile().

    {
        global $DIC;

        $db = $DIC->database();

        if ($a_ass_id) {
            $db->manipulate(
                "DELETE FROM exc_ass_file_order" .
                " WHERE assignment_id = " . $db->quote((int) $a_ass_id, 'integer') .
                " AND filename = " . $db->quote($a_new_name, 'string')
            );

            $db->manipulate(
                "UPDATE exc_ass_file_order SET" .
                " filename = " . $db->quote($a_new_name, 'string') .
                " WHERE assignment_id = " . $db->quote((int) $a_ass_id, 'integer') .
                " AND filename = " . $db->quote($a_old_name, 'string')
            );
        }
    }

Here is the caller graph for this function:

save()

ilExAssignment::save

(

)

Save assignment.

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

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

Referenced by ilExAssignmentEditorGUI\importFormToAssignment().

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

Here is the call graph for this function:

Here is the caller graph for this function:

saveAssOrderOfExercise()

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

static

Save ordering of all assignments of an exercise.

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

References $DIC, and $ilDB.

Referenced by ilExAssignmentEditorGUI\saveAssignmentOrderObject().

    {
        global $DIC;

        $ilDB = $DIC->database();
        
        $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:

saveInstructionFilesOrderOfAssignment()

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

static

Save ordering of instruction files for an assignment.

Parameters

int	$a_ass_id	assignment id
int	$a_order	order

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

References $db, and $DIC.

Referenced by ilExAssignmentFileSystemGUI\saveFilesOrder().

    {
        global $DIC;

        $db = $DIC->database();

        asort($a_order, SORT_NUMERIC);

        $nr = 10;
        foreach ($a_order as $k => $v) {
            // the check for exc_id is for security reasons. ass ids are unique.
            $db->manipulate(
                $t = "UPDATE exc_ass_file_order SET " .
                " order_nr = " . $db->quote($nr, "integer") .
                " WHERE id = " . $db->quote((int) $k, "integer") .
                " AND assignment_id = " . $db->quote((int) $a_ass_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 1885 of file class.ilExAssignment.php.

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

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

Here is the call graph for this function:

sendFeedbackNotifications()

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

static

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

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

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

    {
        global $DIC;

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

Here is the call graph for this function:

Here is the caller graph for this function:

sendMultiFeedbackStructureFile()

ilExAssignment::sendMultiFeedbackStructureFile

(

ilObjExercise

$exercise

)

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

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

References $DIC, $name, ilObjUser\_lookupName(), ilUtil\deliverFile(), ilUtil\getASCIIFilename(), getExerciseId(), getId(), ilObject\getRefId(), getTitle(), ilUtil\ilTempnam(), ilUtil\makeDir(), and ilUtil\zip().

    {
        global $DIC;
        
        
        // 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
        $exmem = new ilExerciseMembers($exc);
        $mems = $exmem->getMembers();
        
        $mems = $DIC->access()->filterUserIdsByRbacOrPositionOfCurrentUser(
            'edit_submissions_grades',
            'edit_submissions_grades',
            $exercise->getRefId(),
            $mems
        );
        foreach ($mems as $mem) {
            $name = ilObjUser::_lookupName($mem);
            $subdir = $name["lastname"] . "_" . $name["firstname"] . "_" . $name["login"] . "_" . $name["user_id"];
            $subdir = 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 278 of file class.ilExAssignment.php.

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

    {
        $this->deadline = $a_val;
    }

Here is the caller graph for this function:

setDeadlineMode()

ilExAssignment::setDeadlineMode

(

$a_val

)

Set deadline mode.

Parameters

int

$a_val

deadline mode

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

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

    {
        $this->deadline_mode = $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 238 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 404 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 851 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 871 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:

setFeedbackDateCustom()

ilExAssignment::setFeedbackDateCustom

(

$a_value

)

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

Parameters

int

$a_value

timestamp

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

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

    {
        $this->feedback_date_custom = $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 831 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 218 of file class.ilExAssignment.php.

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

    {
        $this->id = $a_val;
    }

Here is the caller graph for this function:

setIndividualDeadline()

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

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

References $db, $id, $ilDB, ilDateTime\get(), getId(), ilExcIndividualDeadline\getInstance(), and IL_CAL_UNIX.

    {
        $ilDB = $this->db;
        
        $is_team = false;
        if (!is_numeric($id)) {
            $id = substr($id, 1);
            $is_team = true;
        }

        $idl = ilExcIndividualDeadline::getInstance($this->getId(), $id, $is_team);
        $idl->setIndividualDeadline($date->get(IL_CAL_UNIX));
        $idl->save();

        /*
        $ilDB->replace("exc_idl",
            array(
                "ass_id" => array("integer", $this->getId()),
                "member_id" => array("integer", $id),
                "is_team" => array("integer", $is_team)
            ),
            array(
                "tstamp" => array("integer", $date->get(IL_CAL_UNIX))
            )
        );*/
    }

Here is the call graph for this function:

setInstruction()

ilExAssignment::setInstruction

(

$a_val

)

Set instruction.

Parameters

string

instruction

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

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

    {
        $this->mandatory = $a_val;
    }

Here is the caller graph for this function:

setMaxCharLimit()

ilExAssignment::setMaxCharLimit

(

$a_val

)

Set limit maximum characters.

Parameters

int

max limit

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

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

    {
        $this->max_char_limit = $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 929 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:

setMinCharLimit()

ilExAssignment::setMinCharLimit

(

$a_val

)

Set limit minimum characters.

Parameters

int	minim limit

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

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

    {
        $this->min_char_limit = $a_val;
    }

Here is the caller graph for this function:

setOrderNr()

ilExAssignment::setOrderNr

(

$a_val

)

Set order nr.

Parameters

int

order nr

Definition at line 505 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 578 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 758 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 781 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 638 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 718 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 598 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 738 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 678 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 618 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 698 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 658 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:

setPortfolioTemplateId()

ilExAssignment::setPortfolioTemplateId

(

$a_val

)

Set portfolio template id.

Parameters

int

$a_val

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

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

    {
        $this->portfolio_template = $a_val;
    }

Here is the caller graph for this function:

setRelativeDeadline()

ilExAssignment::setRelativeDeadline

(

$a_val

)

Set relative deadline.

Parameters

int

$a_val

relative deadline

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

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

    {
        $this->relative_deadline = $a_val;
    }

Here is the caller graph for this function:

setRelDeadlineLastSubmission()

ilExAssignment::setRelDeadlineLastSubmission

(

$a_val

)

Set relative deadline last submission.

Parameters

int

$a_val

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

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

    {
        $this->rel_deadline_last_subm = $a_val;
    }

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 258 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 909 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 465 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

Deprecated:

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

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

References isValidType(), and setPeerReview().

Referenced by __construct(), and initFromDB().

    {
        if ($this->isValidType($a_value)) {
            $this->type = (int) $a_value;

            $this->ass_type = $this->types->getById($a_value);

            if ($this->ass_type->usesTeams()) {
                $this->setPeerReview(false);
            }
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

update()

ilExAssignment::update

(

)

Update.

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

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

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

    {
        $ilDB = $this->db;

        $ilDB->update(
            "exc_assignment",
            array(
            "exc_id" => array("integer", $this->getExerciseId()),
            "time_stamp" => array("integer", $this->getDeadline()),
            "deadline2" => array("integer", $this->getExtendedDeadline()),
            "instruction" => array("clob", $this->getInstruction()),
            "title" => array("text", $this->getTitle()),
            "start_time" => array("integer", $this->getStartTime()),
            "order_nr" => array("integer", $this->getOrderNr()),
            "mandatory" => array("integer", $this->getMandatory()),
            "type" => array("integer", $this->getType()),
            "peer" => array("integer", $this->getPeerReview()),
            "peer_min" => array("integer", $this->getPeerReviewMin()),
            "peer_unlock" => array("integer", $this->getPeerReviewSimpleUnlock()),
            "peer_dl" => array("integer", $this->getPeerReviewDeadline()),
            "peer_valid" => array("integer", $this->getPeerReviewValid()),
            "peer_file" => array("integer", $this->hasPeerReviewFileUpload()),
            "peer_prsl" => array("integer", $this->hasPeerReviewPersonalized()),
            "peer_char" => array("integer", $this->getPeerReviewChars()),
            "peer_text" => array("integer", (int) $this->hasPeerReviewText()),
            "peer_rating" => array("integer", (int) $this->hasPeerReviewRating()),
            "peer_crit_cat" => array("integer", $this->getPeerReviewCriteriaCatalogue()),
            "fb_file" => array("text", $this->getFeedbackFile()),
            "fb_date" => array("integer", $this->getFeedbackDate()),
            "fb_date_custom" => array("integer", $this->getFeedbackDateCustom()),
            "fb_cron" => array("integer", $this->hasFeedbackCron()),
            "team_tutor" => array("integer", $this->getTeamTutor()),
            "max_file" => array("integer", $this->getMaxFile()),
            "portfolio_template" => array("integer", $this->getPortFolioTemplateId()),
            "min_char_limit" => array("integer", $this->getMinCharLimit()),
            "max_char_limit" => array("integer", $this->getMaxCharLimit()),
            "deadline_mode" => array("integer", $this->getDeadlineMode()),
            "relative_deadline" => array("integer", $this->getRelativeDeadline()),
            "rel_deadline_last_subm" => array("integer", (int) $this->getRelDeadlineLastSubmission())
            ),
            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 1702 of file class.ilExAssignment.php.

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

Referenced by ilExAssignmentEditorGUI\importFormToAssignment().

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

Here is the call graph for this function:

Here is the caller graph for this function:

uploadMultiFeedbackFile()

ilExAssignment::uploadMultiFeedbackFile

(

$a_file

)

Upload multi feedback file.

Parameters

array

Returns

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

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

    {
        $lng = $this->lng;
        $ilUser = $this->user;
        
        if (!is_file($a_file["tmp_name"])) {
            throw new ilExerciseException($lng->txt("exc_feedback_file_could_not_be_uploaded"));
        }
        
        $storage = new ilFSStorageExercise($this->getExerciseId(), $this->getId());
        $mfu = $storage->getMultiFeedbackUploadPath($ilUser->getId());
        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

$app_event_handler

ilExAssignment::$app_event_handler

protected

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

Referenced by handleCalendarEntries().

$ass_type

ilExAssignment::$ass_type

protected

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

Referenced by cloneAssignmentsOfExercise(), and getAssignmentType().

$db

ilExAssignment::$db

protected

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

Referenced by delete(), fixInstructionFileOrdering(), getIndividualDeadlines(), getInstructionFilesOrder(), getLastPersonalDeadline(), getMemberListData(), getPersonalDeadline(), insertFileOrderNr(), instructionFileDeleteOrder(), instructionFileExistsInDb(), instructionFileGetFileOrderData(), instructionFileInsertOrder(), instructionFileOrderGetMax(), read(), recalculateLateSubmissions(), renameInstructionFile(), save(), saveInstructionFilesOrderOfAssignment(), setIndividualDeadline(), and update().

$deadline

ilExAssignment::$deadline

protected

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

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

$deadline2

ilExAssignment::$deadline2

protected

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

Referenced by getExtendedDeadline().

$deadline_mode

ilExAssignment::$deadline_mode = 0

protected

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

Referenced by getDeadlineMode().

$exc_id

ilExAssignment::$exc_id

protected

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

Referenced by getExerciseId().

$feedback_cron

ilExAssignment::$feedback_cron

protected

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

Referenced by hasFeedbackCron().

$feedback_date

ilExAssignment::$feedback_date

protected

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

Referenced by getFeedbackDate().

$feedback_date_custom

ilExAssignment::$feedback_date_custom

protected

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

Referenced by getFeedbackDateCustom().

$feedback_file

ilExAssignment::$feedback_file

protected

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

Referenced by getFeedbackFile().

$id

ilExAssignment::$id

protected

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

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

$instruction

ilExAssignment::$instruction

protected

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

Referenced by getInstruction().

$lng

ilExAssignment::$lng

protected

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

Referenced by clearMultiFeedbackDirectory(), lookupUpdatedSubmission(), and uploadMultiFeedbackFile().

$log

ilExAssignment::$log

protected

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

$mandatory

ilExAssignment::$mandatory

protected

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

Referenced by getMandatory().

$max_char_limit

ilExAssignment::$max_char_limit

protected

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

Referenced by getMaxCharLimit().

$max_file

ilExAssignment::$max_file

protected

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

Referenced by getMaxFile().

$member_status

ilExAssignment::$member_status = array()

protected

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

Referenced by saveMultiFeedbackFiles().

$min_char_limit

ilExAssignment::$min_char_limit

protected

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

Referenced by getMinCharLimit().

$order_nr

ilExAssignment::$order_nr

protected

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

Referenced by fixInstructionFileOrdering(), and getOrderNr().

$peer

ilExAssignment::$peer

protected

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

Referenced by getPeerReview().

$peer_char

ilExAssignment::$peer_char

protected

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

Referenced by getPeerReviewChars().

$peer_crit_cat

ilExAssignment::$peer_crit_cat

protected

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

$peer_dl

ilExAssignment::$peer_dl

protected

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

Referenced by getPeerReviewDeadline().

$peer_file

ilExAssignment::$peer_file

protected

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

Referenced by hasPeerReviewFileUpload().

$peer_min

ilExAssignment::$peer_min

protected

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

Referenced by getPeerReviewMin().

$peer_personal

ilExAssignment::$peer_personal

protected

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

Referenced by hasPeerReviewPersonalized().

$peer_rating

ilExAssignment::$peer_rating

protected

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

Referenced by hasPeerReviewRating().

$peer_text

ilExAssignment::$peer_text

protected

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

Referenced by hasPeerReviewText().

$peer_unlock

ilExAssignment::$peer_unlock

protected

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

Referenced by getPeerReviewSimpleUnlock().

$peer_valid

ilExAssignment::$peer_valid

protected

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

Referenced by getPeerReviewValid().

$portfolio_template

ilExAssignment::$portfolio_template

protected

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

Referenced by getPortfolioTemplateId().

$rel_deadline_last_subm

ilExAssignment::$rel_deadline_last_subm

protected

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

Referenced by getRelDeadlineLastSubmission().

$relative_deadline

ilExAssignment::$relative_deadline = 0

protected

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

Referenced by getRelativeDeadline().

$start_time

ilExAssignment::$start_time

protected

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

Referenced by getStartTime().

$starting_timestamp

ilExAssignment::$starting_timestamp = null

protected

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

$team_tutor

ilExAssignment::$team_tutor = false

protected

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

Referenced by getTeamTutor().

$title

ilExAssignment::$title

protected

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

Referenced by getTitle().

$type

ilExAssignment::$type

protected

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

Referenced by getCalculatedDeadlines(), and getType().

$types

ilExAssignment::$types = null

protected

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

$user

ilExAssignment::$user

protected

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

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

DEADLINE_ABSOLUTE

const ilExAssignment::DEADLINE_ABSOLUTE = 0

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

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

DEADLINE_RELATIVE

const ilExAssignment::DEADLINE_RELATIVE = 1

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

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

FEEDBACK_DATE_CUSTOM

const ilExAssignment::FEEDBACK_DATE_CUSTOM = 3

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

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

FEEDBACK_DATE_DEADLINE

const ilExAssignment::FEEDBACK_DATE_DEADLINE = 1

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

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

FEEDBACK_DATE_SUBMISSION

const ilExAssignment::FEEDBACK_DATE_SUBMISSION = 2

Definition at line 58 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 63 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 61 of file class.ilExAssignment.php.

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

PEER_REVIEW_VALID_ONE

const ilExAssignment::PEER_REVIEW_VALID_ONE = 2

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

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

TEAMS_FORMED_BY_ASSIGNMENT

const ilExAssignment::TEAMS_FORMED_BY_ASSIGNMENT = 3

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

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

TEAMS_FORMED_BY_PARTICIPANTS

const ilExAssignment::TEAMS_FORMED_BY_PARTICIPANTS = 0

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

Referenced by ilExAssignmentEditorGUI\initAssignmentForm().

TEAMS_FORMED_BY_RANDOM

const ilExAssignment::TEAMS_FORMED_BY_RANDOM = 2

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

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

TEAMS_FORMED_BY_TUTOR

const ilExAssignment::TEAMS_FORMED_BY_TUTOR = 1

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

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

TYPE_BLOG

const ilExAssignment::TYPE_BLOG = 2

Deprecated:

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

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

TYPE_PORTFOLIO

const ilExAssignment::TYPE_PORTFOLIO = 3

Deprecated:

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

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

TYPE_TEXT

const ilExAssignment::TYPE_TEXT = 5

Deprecated:

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

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

TYPE_UPLOAD

const ilExAssignment::TYPE_UPLOAD = 1

Deprecated:

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

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

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

TYPE_UPLOAD_TEAM

const ilExAssignment::TYPE_UPLOAD_TEAM = 4

Deprecated:

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

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

TYPE_WIKI_TEAM

const ilExAssignment::TYPE_WIKI_TEAM = 6

Deprecated:

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

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

---

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

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