This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V. More...

Collaboration diagram for ilExSubmission:

Public Member Functions
	__construct (ilExAssignment $a_ass, int $a_user_id, ilExAssignmentTeam $a_team=null, bool $a_is_tutor=false, bool $a_public_submissions=false)

	getSubmissionType ()

	getAssignment ()

	getTeam ()

	getPeerReview ()

	validatePeerReviews ()

	getUserId ()

	getUserIds ()

	getFeedbackId ()

	hasSubmitted ()

	hasSubmittedPrintVersion ()

	getSubmittedPrintFile ()

	getSelectedObject ()

	canSubmit ()

	canView ()

	isTutor ()

	hasNoTeamYet ()

	isInTeam (int $a_user_id=null)

	isOwner ()

	hasPeerReviewAccess ()

	canAddFile ()

	uploadFile (array $a_http_post_files, bool $unzip=false)
	Save submitted file of user. More...

	processUploadedZipFile (string $fileTmp)
	processes error handling etc for uploaded archive More...

	getFiles (array $a_file_ids=null, bool $a_only_valid=false, string $a_min_timestamp=null, bool $print_versions=false)
	Get submission items (not only files) More...

	lookupNewFiles (int $a_tutor=null)
	Check how much files have been uploaded by the learner after the last download of the tutor. More...

	deleteAllFiles ()

	deleteSelectedFiles (array $file_id_array)
	Deletes already delivered files. More...

	downloadFiles (array $a_file_ids=null, bool $a_only_new=false, bool $a_peer_review_mask_filename=false)

	updateTutorDownloadTime ()

	getTableUserWhere (bool $a_team_mode=false)

	getLastSubmission ()
	TODO -> get rid of getTableUserWhere and move to repository class Get the date of the last submission of a user for the assignment. More...

	getLastOpeningHTMLView ()
	TODO -> get rid of getTableUserWhere and move to repository class Get a mysql timestamp from the last HTML view opening. More...

	addResourceObject (string $a_wsp_id, string $a_text=null)
	Add personal resource or repository object (ref_id) to assigment. More...

	deleteResourceObject ()

	updateTextSubmission (string $a_text)
	Handle text assignment submissions. More...

	getDownloadedFilesInfoForTableGUIS ()

Static Public Member Functions
static	getAllAssignmentFiles (int $a_exc_id, int $a_ass_id)

static	getAssignmentFilesByUsers (int $a_exc_id, int $a_ass_id, array $a_users)

static	lookupExerciseIdForReturnedId (int $a_returned_id)
	Get exercise from submission id (used in ilObjMediaObject) More...

static	findUserFiles (int $a_user_id, string $a_filetitle)
	Check if given file was assigned Used in Blog/Portfolio. More...

static	deleteUser (int $a_exc_id, int $a_user_id)
	Delete all delivered files of user. More...

static	downloadAllAssignmentFiles (ilExAssignment $a_ass, array $members, string $to_path)
	Download all submitted files of an assignment (all user) More...

static	getSubmissionsForFilename (string $a_filename, array $a_assignment_types=array())
	Get assignment return entries for a filename. More...

static	getDirectoryNameFromUserData (int $a_user_id)

static	getAssignmentParticipants (int $a_exercise_id, int $a_ass_id)

Data Fields
const	TYPE_FILE = "File"

const	TYPE_OBJECT = "Object"

const	TYPE_TEXT = "Text"

const	TYPE_REPO_OBJECT = "RepoObject"

Protected Member Functions
	isLate ()

	initStorage ()

	getStorageId ()

	getLastDownloadTime (array $a_user_ids)

	downloadSingleFile (int $a_user_id, string $filename, string $filetitle, int $a_team_id=0)

	downloadMultipleFiles (array $a_filenames, ?int $a_user_id, bool $a_multi_user=false)

Protected Attributes
ilObjUser	$user

ilDBInterface	$db

ilLanguage	$lng

ilCtrl	$ctrl

ilExAssignment	$assignment

int	$user_id

ilExAssignmentTeam	$team = null

ilExPeerReview	$peer_review = null

bool	$is_tutor

bool	$public_submissions

ilExAssignmentTypeInterface	$ass_type

ilExAssignmentTypes	$ass_types

ilExcAssMemberState	$state

Private Attributes
ilGlobalTemplateInterface	$main_tpl

Detailed Description

This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V.

ILIAS is licensed with the GPL-3.0, see https://www.gnu.org/licenses/gpl-3.0.en.html You should have received a copy of said license along with the source code, too.

If this is not the case or you just want to try ILIAS, you'll find us at: https://www.ilias.de https://github.com/ILIAS-eLearning Exercise submission //TODO: This class has many static methods related to delivered "files". Extract them to classes.

Author: Jörg Lützenkirchen luetz.nosp@m.enki.nosp@m.rchen.nosp@m.@lei.nosp@m.fos.c.nosp@m.om; Alexander Killing killi.nosp@m.ng@l.nosp@m.eifos.nosp@m..de

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

Constructor & Destructor Documentation

◆ __construct()

ilExSubmission::__construct	(	ilExAssignment	$a_ass,
		int	$a_user_id,
		ilExAssignmentTeam	$a_team = `null`,
		bool	$a_is_tutor = `false`,
		bool	$a_public_submissions = `false`
	)

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

References $DIC, $user_id, ILIAS\Repository\ctrl(), ilExAssignment\getAssignmentType(), ilExAssignment\getId(), ilExAssignmentTypes\getInstance(), ilExcAssMemberState\getInstanceByIds(), ilExAssignmentTeam\getInstanceByUserId(), ilExAssignment\hasTeam(), ILIAS\Repository\lng(), and ILIAS\Repository\user().

       {
         global $DIC;
         $this->main_tpl = $DIC->ui()->mainTemplate();
 
         $this->user = $DIC->user();
         $this->db = $DIC->database();
         $this->lng = $DIC->language();
         $this->ctrl = $DIC->ctrl();
 
         $this->assignment = $a_ass;
         $this->ass_type = $this->assignment->getAssignmentType();
         $this->ass_types = ilExAssignmentTypes::getInstance();
 
         $this->user_id = $a_user_id;
         $this->is_tutor = $a_is_tutor;
         $this->public_submissions = $a_public_submissions;
 
         $this->state = ilExcAssMemberState::getInstanceByIds($a_ass->getId(), $a_user_id);
 
         if ($a_ass->hasTeam()) {
             if (!$a_team) {
                 $this->team = ilExAssignmentTeam::getInstanceByUserId($this->assignment->getId(), $this->user_id);
             } else {
                 $this->team = $a_team;
             }
         }
 
         if ($this->assignment->getPeerReview()) {
             $this->peer_review = new ilExPeerReview($this->assignment);
         }
     }

Here is the call graph for this function:

Member Function Documentation

◆ addResourceObject()

ilExSubmission::addResourceObject	(	string	$a_wsp_id,
		string	$a_text = `null`
	)

Add personal resource or repository object (ref_id) to assigment.

Exceptions

ilExcUnknownAssignmentTypeException
ilExerciseException

Definition at line 1273 of file class.ilExSubmission.php.

References $db, $ilDB, $query, getAssignment(), getSubmissionsForFilename(), getSubmissionType(), getTeam(), getUserId(), isLate(), ilUtil\now(), and TYPE_REPO_OBJECT.

Referenced by ilObjPortfolioGUI\linkPortfolioToAssignment(), and updateTextSubmission().

      : int {
         $ilDB = $this->db;
 
         if ($this->getAssignment()->getAssignmentType()->isSubmissionAssignedToTeam()) {
             $user_id = 0;
             $team_id = $this->getTeam()->getId();
         } else {
             $user_id = $this->getUserId();
             $team_id = 0;
         }
 
         // repository objects must be unique in submissions
         // the same repo object cannot be used in different submissions or even different assignment/exercises
         // why? -> the access handling would fail, since the access depends e.g. on teams or even phase of the
         // assignment
         if ($this->getAssignment()->getAssignmentType()->getSubmissionType() == ilExSubmission::TYPE_REPO_OBJECT) {
             $repos_ass_type_ids = $this->ass_types->getIdsForSubmissionType(ilExSubmission::TYPE_REPO_OBJECT);
             $subs = $this->getSubmissionsForFilename($a_wsp_id, $repos_ass_type_ids);
             if ($subs !== []) {
                 throw new ilExerciseException("Repository object $a_wsp_id is already assigned to another assignment.");
             }
         }
 
         $next_id = $ilDB->nextId("exc_returned");
         $query = sprintf(
             "INSERT INTO exc_returned " .
                          "(returned_id, obj_id, user_id, filetitle, ass_id, ts, atext, late, team_id) " .
                          "VALUES (%s, %s, %s, %s, %s, %s, %s, %s, %s)",
             $ilDB->quote($next_id, "integer"),
             $ilDB->quote($this->assignment->getExerciseId(), "integer"),
             $ilDB->quote($user_id, "integer"),
             $ilDB->quote($a_wsp_id, "text"),
             $ilDB->quote($this->assignment->getId(), "integer"),
             $ilDB->quote(ilUtil::now(), "timestamp"),
             $ilDB->quote($a_text, "text"),
             $ilDB->quote($this->isLate(), "integer"),
             $ilDB->quote($team_id, "integer")
         );
         $ilDB->manipulate($query);
 
         return $next_id;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ canAddFile()

ilExSubmission::canAddFile ( )

Definition at line 253 of file class.ilExSubmission.php.

References canSubmit(), getAssignment(), and getFiles().

Referenced by uploadFile().

                                 : bool
     {
         if (!$this->canSubmit()) {
             return false;
         }
 
         $max = $this->getAssignment()->getMaxFile();
         if ($max &&
             $max <= sizeof($this->getFiles())) {
             return false;
         }
 
         return true;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ canSubmit()

ilExSubmission::canSubmit ( )

Definition at line 186 of file class.ilExSubmission.php.

References isOwner().

Referenced by canAddFile(), canView(), ilExSubmissionTextGUI\getOverviewContent(), ilExSubmissionFileGUI\getOverviewContent(), ilExSubmissionObjectGUI\getOverviewContentBlog(), and ilExAssTypeWikiTeamGUI\renderOverviewContent().

                                : bool
     {
         return ($this->isOwner() &&
             $this->state->isSubmissionAllowed());
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ canView()

ilExSubmission::canView ( )

Definition at line 192 of file class.ilExSubmission.php.

References $ilUser, $user, canSubmit(), isInTeam(), and isTutor().

Referenced by ilExSubmissionGUI\executeCommand().

                              : bool
     {
         $ilUser = $this->user;
 
         if ($this->canSubmit() ||
             $this->isTutor() ||
             $this->isInTeam() ||
             $this->public_submissions) {
             return true;
         }
 
         // #16115
         if ($this->peer_review) {
             // peer review givers may view peer submissions
             foreach ($this->peer_review->getPeerReviewsByPeerId($this->getUserId()) as $giver) {
                 if ($giver["giver_id"] == $ilUser->getId()) {
                     return true;
                 }
             }
         }
 
         return false;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ deleteAllFiles()

ilExSubmission::deleteAllFiles ( )

Definition at line 642 of file class.ilExSubmission.php.

References deleteSelectedFiles(), and getFiles().

Referenced by deleteResourceObject(), and updateTextSubmission().

                                     : void
     {
         $files = array();
         // normal files
         foreach ($this->getFiles() as $item) {
             $files[] = $item["returned_id"];
         }
         // print versions
         foreach ($this->getFiles(null, false, null, true) as $item) {
             $files[] = $item["returned_id"];
         }
         if ($files !== []) {
             $this->deleteSelectedFiles($files);
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ deleteResourceObject()

ilExSubmission::deleteResourceObject ( )

Definition at line 1323 of file class.ilExSubmission.php.

References deleteAllFiles().

Referenced by ilExSubmissionObjectGUI\getOverviewContentBlog(), and ilExAssTypeWikiTeamGUI\renderOverviewContent().

                                           : void
     {
         $this->deleteAllFiles();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ deleteSelectedFiles()

ilExSubmission::deleteSelectedFiles ( array $file_id_array )

Deletes already delivered files.

Parameters

array $file_id_array An array containing database ids of the delivered files

Definition at line 662 of file class.ilExSubmission.php.

References $db, $filename, $ilDB, $path, getAssignment(), getTableUserWhere(), initStorage(), and ilExAssignmentTeam\TEAM_LOG_REMOVE_FILE.

Referenced by deleteAllFiles().

      : void {
         $ilDB = $this->db;
 
 
         $where = " AND " . $this->getTableUserWhere(true);
 
 
         if ($file_id_array === []) {
             return;
         }
 
         if ($file_id_array !== []) {
             $result = $ilDB->query("SELECT * FROM exc_returned" .
                 " WHERE " . $ilDB->in("returned_id", $file_id_array, false, "integer") .
                 $where);
 
             if ($ilDB->numRows($result)) {
                 $result_array = array();
                 while ($row = $ilDB->fetchAssoc($result)) {
                     $row["timestamp"] = $row["ts"];
                     $result_array[] = $row;
                 }
 
                 // delete the entries in the database
                 $ilDB->manipulate("DELETE FROM exc_returned" .
                     " WHERE " . $ilDB->in("returned_id", $file_id_array, false, "integer") .
                     $where);
 
                 // delete the files
                 $path = $this->initStorage()->getAbsoluteSubmissionPath();
                 foreach ($result_array as $value) {
                     if ($value["filename"]) {
                         if ($this->team) {
                             $this->team->writeLog(
                                 ilExAssignmentTeam::TEAM_LOG_REMOVE_FILE,
                                 $value["filetitle"]
                             );
                         }
 
                         if ($this->getAssignment()->getAssignmentType()->isSubmissionAssignedToTeam()) {
                             $storage_id = $value["team_id"];
                         } else {
                             $storage_id = $value["user_id"];
                         }
 
                         $filename = $path . "/" . $storage_id . "/" . basename($value["filename"]);
                         if (file_exists($filename)) {
                             unlink($filename);
                         }
                     }
                 }
             }
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ deleteUser()

static ilExSubmission::deleteUser	(	int	$a_exc_id,
		int	$a_user_id
	)

static

Delete all delivered files of user.

Exceptions

ilExcUnknownAssignmentTypeException

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

References ilExAssignment\getInstancesByExercise(), and ilExAssignmentTeam\removeTeamMember().

Referenced by ilExerciseMembers\deassignMember().

      : void {
         foreach (ilExAssignment::getInstancesByExercise($a_exc_id) as $ass) {
             $submission = new self($ass, $a_user_id);
             $submission->deleteAllFiles();
 
             // remove from any team
             $team = $submission->getTeam();
             if ($team) {
                 $team->removeTeamMember($a_user_id);
             }
 
             // #14900
             $member_status = $ass->getMemberStatus($a_user_id);
             $member_status->setStatus("notgraded");
             $member_status->update();
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ downloadAllAssignmentFiles()

static ilExSubmission::downloadAllAssignmentFiles	(	ilExAssignment	$a_ass,
		array	$members,
		string	$to_path
	)

static

Download all submitted files of an assignment (all user)

Exceptions

ilExerciseException

Definition at line 1017 of file class.ilExSubmission.php.

References $DIC, $id, $log, ilObject\_lookupObjId(), ilObject\_lookupType(), ilFSStorageExercise\create(), ilFileUtils\delDir(), ilFileUtils\dirsize(), ilShellUtil\escapeShellArg(), ilFileUtils\getASCIIFilename(), ilExAssignmentTeam\getAssignmentTeamMap(), ilExAssignment\getAssignmentType(), ilExAssignment\getExerciseId(), ilExAssignment\getId(), ilLoggerFactory\getLogger(), ilExAssignment\getType(), ilExAssignment\hasTeam(), ilFileUtils\makeDir(), ilLanguage\txt(), ilExAssignment\TYPE_BLOG, ilExAssignment\TYPE_PORTFOLIO, and ilFileUtils\unzip().

Referenced by ilExerciseManagementCollectFilesJob\createSubmissionsDirectory(), and ilExerciseManagementGUI\redirectFeedbackMailObject().

      : void {
         global $DIC;
 
         $lng = $DIC->language();
         $log = ilLoggerFactory::getLogger("exc");
 
         $storage = new ilFSStorageExercise($a_ass->getExerciseId(), $a_ass->getId());
         $storage->create();
 
         ksort($members);
         //$savepath = $this->getExercisePath() . "/" . $this->obj_id . "/";
         $savepath = $storage->getAbsoluteSubmissionPath();
         $cdir = getcwd();
 
 
         // important check: if the directory does not exist
         // ILIAS stays in the current directory (echoing only a warning)
         // and the zip command below archives the whole ILIAS directory
         // (including the data directory) and sends a mega file to the user :-o
         if (!is_dir($savepath)) {
             return;
         }
         // Safe mode fix
         //              chdir($this->getExercisePath());
 
         $tmpdir = $storage->getTempPath();
         chdir($tmpdir);
         $zip = PATH_TO_ZIP;
 
         // check free diskspace
         $dirsize = 0;
         foreach (array_keys($members) as $id) {
             $directory = $savepath . DIRECTORY_SEPARATOR . $id;
             $dirsize += ilFileUtils::dirsize($directory);
         }
         if ($dirsize > disk_free_space($tmpdir)) {
             return;
         }
 
         $ass_type = $a_ass->getType();
 
         // copy all member directories to the temporary folder
         // switch from id to member name and append the login if the member name is double
         // ensure that no illegal filenames will be created
         // remove timestamp from filename
         $team_map = null;
         $team_dirs = null;
         if ($a_ass->hasTeam()) {
             $team_dirs = array();
             $team_map = ilExAssignmentTeam::getAssignmentTeamMap($a_ass->getId());
         }
         foreach ($members as $id => $item) {
             $user_files = $item["files"] ?? null;
             $sourcedir = $savepath . DIRECTORY_SEPARATOR . $id;
             if (!is_dir($sourcedir)) {
                 continue;
             }
 
             // group by teams
             $team_dir = "";
             if (is_array($team_map) &&
                 array_key_exists($id, $team_map)) {
                 $team_id = $team_map[$id];
                 if (!array_key_exists($team_id, $team_dirs)) {
                     $team_dir = $lng->txt("exc_team") . " " . $team_id;
                     ilFileUtils::makeDir($team_dir);
                     $team_dirs[$team_id] = $team_dir;
                 }
                 $team_dir = $team_dirs[$team_id] . DIRECTORY_SEPARATOR;
             }
 
             if ($a_ass->getAssignmentType()->isSubmissionAssignedToTeam()) {
                 $targetdir = $team_dir . ilFileUtils::getASCIIFilename(
                     $item["name"]
                 );
                 if ($targetdir == "") {
                     continue;
                 }
             } else {
                 $targetdir = self::getDirectoryNameFromUserData($id);
                 if ($a_ass->getAssignmentType()->usesTeams()) {
                     $targetdir = $team_dir . $targetdir;
                 }
             }
 
             $log->debug("Creation target directory: " . $targetdir);
             ilFileUtils::makeDir($targetdir);
 
             $log->debug("Scanning source directory: " . $sourcedir);
             $sourcefiles = scandir($sourcedir);
             $duplicates = array();
             foreach ($sourcefiles as $sourcefile) {
                 if ($sourcefile == "." || $sourcefile == "..") {
                     continue;
                 }
 
                 $targetfile = trim(basename($sourcefile));
                 $pos = strpos($targetfile, "_");
                 if ($pos !== false) {
                     $targetfile = substr($targetfile, $pos + 1);
                 }
 
                 if ($a_ass->getAssignmentType()->getSubmissionType() == self::TYPE_REPO_OBJECT) {
                     $obj_id = ilObject::_lookupObjId($targetfile);
                     $obj_type = ilObject::_lookupType($obj_id);
                     $targetfile = $obj_type . "_" . $obj_id . ".zip";
                 }
 
 
                 // #14536
                 if (array_key_exists($targetfile, $duplicates)) {
                     $suffix = strrpos($targetfile, ".");
                     $targetfile = substr($targetfile, 0, $suffix) .
                         " (" . (++$duplicates[$targetfile]) . ")" .
                         substr($targetfile, $suffix);
                 } else {
                     $duplicates[$targetfile] = 1;
                 }
 
                 // late submission?
                 if (isset($user_files)) {       // see #23900
                     foreach ($user_files as $file) {
                         if (basename($file["filename"]) == $sourcefile) {
                             if ($file["late"]) {
                                 $targetfile = $lng->txt("exc_late_submission") . " - " .
                                     $targetfile;
                             }
                             break;
                         }
                     }
                 }
 
                 $targetfile = ilFileUtils::getASCIIFilename($targetfile);
                 $targetfile = $targetdir . DIRECTORY_SEPARATOR . $targetfile;
                 $sourcefile = $sourcedir . DIRECTORY_SEPARATOR . $sourcefile;
 
                 $log->debug("Copying: " . $sourcefile . " -> " . $targetfile);
 
                 if (!copy($sourcefile, $targetfile)) {
                     throw new ilExerciseException("Could not copy " . basename($sourcefile) . " to '" . $targetfile . "'.");
                 } else {
                     // preserve time stamp
                     touch($targetfile, filectime($sourcefile));
 
                     // blogs and portfolios are stored as zip and have to be unzipped
                     if ($ass_type == ilExAssignment::TYPE_PORTFOLIO ||
                         $ass_type == ilExAssignment::TYPE_BLOG) {
                         $log->debug("Unzipping: " . $targetfile);
                         $log->debug("Current directory is: " . getcwd());
 
                         ilFileUtils::unzip($targetfile);
                         unlink($targetfile);
                     }
                 }
             }
         }
         $tmpzipfile = ilFileUtils::getASCIIFilename($lng->txt("exc_ass_submission_zip")) . ".zip";
         // Safe mode fix
         $zipcmd = $zip . " -r " . ilShellUtil::escapeShellArg($tmpzipfile) . " .";
         exec($zipcmd);
         //$path_final_zip_file = $to_path.DIRECTORY_SEPARATOR."Submissions/".$tmpzipfile;
         $path_final_zip_file = $to_path . DIRECTORY_SEPARATOR . $tmpzipfile;
 
         if (file_exists($tmpdir . DIRECTORY_SEPARATOR . $tmpzipfile)) {
             copy($tmpzipfile, $path_final_zip_file);
             ilFileUtils::delDir($tmpdir);
 
             //unzip the submissions zip file.(decided to unzip to allow the excel link the files more obvious when blog/portfolio)
             chdir($to_path);
             //TODO Bug in ilUtil -> if flat unzip fails. We can get rid of creating Submissions directory
             //ilUtil::unzip($path_final_zip_file,FALSE, TRUE);
             ilFileUtils::unzip($path_final_zip_file);
             unlink($path_final_zip_file);
         }
 
         chdir($cdir);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ downloadFiles()

ilExSubmission::downloadFiles	(	array	$a_file_ids = `null`,
		bool	$a_only_new = `false`,
		bool	$a_peer_review_mask_filename = `false`
	)

Definition at line 764 of file class.ilExSubmission.php.

References $ilUser, $lng, $user, ilObjUser\_lookupName(), ilObject\_lookupTitle(), downloadMultipleFiles(), downloadSingleFile(), getFiles(), getLastDownloadTime(), getTeam(), getUserId(), getUserIds(), ilLanguage\txt(), ilExAssignment\TYPE_BLOG, ilExAssignment\TYPE_PORTFOLIO, ilExAssignment\TYPE_WIKI_TEAM, and updateTutorDownloadTime().

      : bool {
         $ilUser = $this->user;
         $lng = $this->lng;
 
         $user_ids = $this->getUserIds();
         $is_team = $this->assignment->hasTeam();
         // get last download time
         $download_time = null;
         if ($a_only_new) {
             $download_time = $this->getLastDownloadTime($user_ids);
         }
 
         if ($this->is_tutor) {
             $this->updateTutorDownloadTime();
         }
 
         if ($a_peer_review_mask_filename) {
             // process peer review sequence id
             $peer_id = null;
             foreach ($this->peer_review->getPeerReviewsByGiver($ilUser->getId()) as $idx => $item) {
                 if ($item["peer_id"] == $this->getUserId()) {
                     $peer_id = $idx + 1;
                     break;
                 }
             }
             // this will remove personal info from zip-filename
             $is_team = true;
         }
 
         $files = $this->getFiles($a_file_ids, false, $download_time);
 
         if ($files !== []) {
             if (count($files) == 1) {
                 $file = array_pop($files);
 
                 switch ($this->assignment->getType()) {
                     case ilExAssignment::TYPE_BLOG:
                     case ilExAssignment::TYPE_PORTFOLIO:
                         $file["filetitle"] = ilObjUser::_lookupName($file["user_id"]);
                         $file["filetitle"] = ilObject::_lookupTitle($this->assignment->getExerciseId()) . " - " .
                             $this->assignment->getTitle() . " - " .
                             $file["filetitle"]["firstname"] . " " .
                             $file["filetitle"]["lastname"] . " (" .
                             $file["filetitle"]["login"] . ").zip";
                         break;
 
                     // @todo: generalize
                     case ilExAssignment::TYPE_WIKI_TEAM:
                         $file["filetitle"] = ilObject::_lookupTitle($this->assignment->getExerciseId()) . " - " .
                             $this->assignment->getTitle() . " (Team " . $this->getTeam()->getId() . ").zip";
                         break;
 
                     default:
                         break;
                 }
 
                 if ($a_peer_review_mask_filename) {
                     $title_a = explode(".", $file["filetitle"]);
                     $suffix = array_pop($title_a);
                     $file["filetitle"] = $this->assignment->getTitle() . "_peer" . $peer_id . "." . $suffix;
                 } elseif ($file["late"]) {
                     $file["filetitle"] = $lng->txt("exc_late_submission") . " - " .
                         $file["filetitle"];
                 }
 
                 $this->downloadSingleFile($file["user_id"], $file["filename"], $file["filetitle"], $file["team_id"]);
             } else {
                 $array_files = array();
                 foreach ($files as $seq => $file) {
                     if ($this->assignment->getAssignmentType()->isSubmissionAssignedToTeam()) {
                         $storage_id = $file["team_id"];
                     } else {
                         $storage_id = $file["user_id"];
                     }
 
                     $src = basename($file["filename"]);
                     if ($a_peer_review_mask_filename) {
                         $src_a = explode(".", $src);
                         $suffix = array_pop($src_a);
                         $tgt = $this->assignment->getTitle() . "_peer" . $peer_id .
                             "_" . (++$seq) . "." . $suffix;
 
                         $array_files[$storage_id][] = array(
                             "src" => $src,
                             "tgt" => $tgt
                         );
                     } else {
                         $array_files[$storage_id][] = array(
                             "src" => $src,
                             "late" => $file["late"]
                         );
                     }
                 }
                 $this->downloadMultipleFiles(
                     $array_files,
                     ($is_team ? null : $this->getUserId()),
                     $is_team
                 );
             }
         } else {
             return false;
         }
 
         return true;
     }

Here is the call graph for this function:

◆ downloadMultipleFiles()

ilExSubmission::downloadMultipleFiles	(	array	$a_filenames,
		?int	$a_user_id,
		bool	$a_multi_user = `false`
	)

protected

Definition at line 918 of file class.ilExSubmission.php.

References $filename, $lng, $path, ilObjUser\_lookupName(), ilFileUtils\delDir(), ilFileDelivery\deliverFileLegacy(), ilShellUtil\escapeShellArg(), exit, ilFileUtils\getASCIIFilename(), ilFileUtils\ilTempnam(), initStorage(), ILIAS\Repository\int(), ilExAssignment\lookupTitle(), ilFileUtils\makeDir(), and ilLanguage\txt().

Referenced by downloadFiles().

      : void {
         $lng = $this->lng;
         $a_user_id = (int) $a_user_id;
 
         $path = $this->initStorage()->getAbsoluteSubmissionPath();
 
         $cdir = getcwd();
 
         $zip = PATH_TO_ZIP;
         $tmpdir = ilFileUtils::ilTempnam();
         $tmpfile = ilFileUtils::ilTempnam();
         $tmpzipfile = $tmpfile . ".zip";
 
         ilFileUtils::makeDir($tmpdir);
         chdir($tmpdir);
 
         $assTitle = ilExAssignment::lookupTitle($this->assignment->getId());
         $deliverFilename = str_replace(" ", "_", $assTitle);
         if ($a_user_id > 0 && !$a_multi_user) {
             $userName = ilObjUser::_lookupName($a_user_id);
             $deliverFilename .= "_" . $userName["lastname"] . "_" . $userName["firstname"];
         } else {
             $deliverFilename .= "_files";
         }
         $orgDeliverFilename = trim($deliverFilename);
         $deliverFilename = ilFileUtils::getASCIIFilename($orgDeliverFilename);
         ilFileUtils::makeDir($tmpdir . "/" . $deliverFilename);
         chdir($tmpdir . "/" . $deliverFilename);
 
         //copy all files to a temporary directory and remove them afterwards
         $parsed_files = $duplicates = array();
         foreach ($a_filenames as $storage_id => $files) {
             $pathname = $path . "/" . $storage_id;
 
             foreach ($files as $filename) {
                 // peer review masked filenames, see deliverReturnedFiles()
                 if (isset($filename["tgt"])) {
                     $newFilename = $filename["tgt"];
                     $filename = $filename["src"];
                 } else {
                     $late = $filename["late"];
                     $filename = $filename["src"];
 
                     // remove timestamp
                     $newFilename = trim($filename);
                     $pos = strpos($newFilename, "_");
                     if ($pos !== false) {
                         $newFilename = substr($newFilename, $pos + 1);
                     }
                     // #11070
                     $chkName = strtolower($newFilename);
                     if (array_key_exists($chkName, $duplicates)) {
                         $suffix = strrpos($newFilename, ".");
                         $newFilename = substr($newFilename, 0, $suffix) .
                             " (" . (++$duplicates[$chkName]) . ")" .
                             substr($newFilename, $suffix);
                     } else {
                         $duplicates[$chkName] = 1;
                     }
 
                     if ($late) {
                         $newFilename = $lng->txt("exc_late_submission") . " - " .
                             $newFilename;
                     }
                 }
 
                 $newFilename = ilFileUtils::getASCIIFilename($newFilename);
                 $newFilename = $tmpdir . DIRECTORY_SEPARATOR . $deliverFilename . DIRECTORY_SEPARATOR . $newFilename;
                 // copy to temporal directory
                 $oldFilename = $pathname . DIRECTORY_SEPARATOR . $filename;
                 if (!copy($oldFilename, $newFilename)) {
                     echo 'Could not copy ' . $oldFilename . ' to ' . $newFilename;
                 }
                 touch($newFilename, filectime($oldFilename));
                 $parsed_files[] = ilShellUtil::escapeShellArg(
                     $deliverFilename . DIRECTORY_SEPARATOR . basename($newFilename)
                 );
             }
         }
 
         chdir($tmpdir);
         $zipcmd = $zip . " " . ilShellUtil::escapeShellArg($tmpzipfile) . " " . implode(" ", $parsed_files);
 
         exec($zipcmd);
         ilFileUtils::delDir($tmpdir);
 
         chdir($cdir);
         ilFileDelivery::deliverFileLegacy($tmpzipfile, $orgDeliverFilename . ".zip", "", false, true);
         exit;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ downloadSingleFile()

ilExSubmission::downloadSingleFile	(	int	$a_user_id,
		string	$filename,
		string	$filetitle,
		int	$a_team_id = `0`
	)

protected

Definition at line 900 of file class.ilExSubmission.php.

References ilFileDelivery\deliverFileLegacy(), and initStorage().

Referenced by downloadFiles().

      : void {
         if ($this->ass_type->isSubmissionAssignedToTeam()) {
             $storage_id = $a_team_id;
         } else {
             $storage_id = $a_user_id;
         }
 
         $filename = $this->initStorage()->getAbsoluteSubmissionPath() .
             "/" . $storage_id . "/" . basename($filename);
 
         ilFileDelivery::deliverFileLegacy($filename, $filetitle);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ findUserFiles()

static ilExSubmission::findUserFiles	(	int	$a_user_id,
		string	$a_filetitle
	)

static

Check if given file was assigned Used in Blog/Portfolio.

Definition at line 623 of file class.ilExSubmission.php.

References $DIC, $ilDB, and $res.

Referenced by ilBlogExercise\getAssignmentsOfBlog(), and ilPortfolioExercise\getAssignmentsOfPortfolio().

      : array {
         global $DIC;
 
         $ilDB = $DIC->database();
 
         $set = $ilDB->query("SELECT obj_id, ass_id" .
             " FROM exc_returned" .
             " WHERE user_id = " . $ilDB->quote($a_user_id, "integer") .
             " AND filetitle = " . $ilDB->quote($a_filetitle, "text"));
         $res = array();
         while ($row = $ilDB->fetchAssoc($set)) {
             $res[$row["ass_id"]] = $row;
         }
         return $res;
     }

Here is the caller graph for this function:

◆ getAllAssignmentFiles()

static ilExSubmission::getAllAssignmentFiles	(	int	$a_exc_id,
		int	$a_ass_id
	)

static

Exceptions

ilExcUnknownAssignmentTypeException

Definition at line 412 of file class.ilExSubmission.php.

References $DIC, $ilDB, $path, $query, $res, ilExAssignmentTypes\getInstance(), ilExAssignmentTypeInterface\isSubmissionAssignedToTeam(), and ilExAssignment\lookupType().

Referenced by ilExAssignmentListTextTableGUI\parse(), and ilExAssignment\recalculateLateSubmissions().

      : array {
         global $DIC;
 
         $ilDB = $DIC->database();
 
         $storage = new ilFSStorageExercise($a_exc_id, $a_ass_id);
         $path = $storage->getAbsoluteSubmissionPath();
 
         $ass_type = ilExAssignmentTypes::getInstance()->getById(ilExAssignment::lookupType($a_ass_id));
 
         $query = "SELECT * FROM exc_returned WHERE ass_id = " .
             $ilDB->quote($a_ass_id, "integer");
 
         $res = $ilDB->query($query);
         $delivered = [];
         while ($row = $ilDB->fetchAssoc($res)) {
             if ($ass_type->isSubmissionAssignedToTeam()) {
                 $storage_id = $row["team_id"];
             } else {
                 $storage_id = $row["user_id"];
             }
 
             $row["timestamp"] = $row["ts"];
             $row["filename"] = $path . "/" . $storage_id . "/" . basename($row["filename"]);
             $delivered[] = $row;
         }
 
         return $delivered;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getAssignment()

ilExSubmission::getAssignment ( )

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

References $assignment.

Referenced by addResourceObject(), canAddFile(), deleteSelectedFiles(), ilExSubmissionGUI\executeCommand(), getFiles(), getLastDownloadTime(), ilExSubmissionObjectGUI\getOverviewContent(), ilExSubmissionTeamGUI\getOverviewContent(), ilExPeerReviewGUI\getOverviewContent(), getTableUserWhere(), and lookupNewFiles().

                                    : ilExAssignment
     {
         return $this->assignment;
     }

Here is the caller graph for this function:

◆ getAssignmentFilesByUsers()

static ilExSubmission::getAssignmentFilesByUsers	(	int	$a_exc_id,
		int	$a_ass_id,
		array	$a_users
	)

static

Exceptions

ilExcUnknownAssignmentTypeException

Definition at line 448 of file class.ilExSubmission.php.

References $DIC, $ilDB, $path, $query, $res, ilExAssignmentTypes\getInstance(), ilExAssignmentTypeInterface\isSubmissionAssignedToTeam(), and ilExAssignment\lookupType().

Referenced by ilExerciseManagementGUI\saveGradesObject().

      : array {
         global $DIC;
 
         $ilDB = $DIC->database();
 
         $storage = new ilFSStorageExercise($a_exc_id, $a_ass_id);
         $path = $storage->getAbsoluteSubmissionPath();
 
         $ass_type = ilExAssignmentTypes::getInstance()->getById(ilExAssignment::lookupType($a_ass_id));
 
         $query = "SELECT * FROM exc_returned WHERE ass_id = " .
             $ilDB->quote($a_ass_id, "integer") .
             " AND user_id IN (" . implode(',', $a_users) . ")";
 
         $res = $ilDB->query($query);
         $delivered = [];
         while ($row = $ilDB->fetchAssoc($res)) {
             if ($ass_type->isSubmissionAssignedToTeam()) {
                 $storage_id = $row["team_id"];
             } else {
                 $storage_id = $row["user_id"];
             }
 
             $row["timestamp"] = $row["ts"];
             $row["filename"] = $path . "/" . $storage_id . "/" . basename($row["filename"]);
             $delivered[] = $row;
         }
 
         return $delivered;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getAssignmentParticipants()

static ilExSubmission::getAssignmentParticipants	(	int	$a_exercise_id,
		int	$a_ass_id
	)

static

Definition at line 1566 of file class.ilExSubmission.php.

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

Referenced by ilExerciseManagementGUI\saveGradesObject().

      : array {
         global $DIC;
 
         $ilDB = $DIC->database();
 
         $participants = array();
         $query = "SELECT user_id FROM exc_returned WHERE ass_id = " .
             $ilDB->quote($a_ass_id, "integer") .
             " AND obj_id = " .
             $ilDB->quote($a_exercise_id, "integer");
 
         $res = $ilDB->query($query);
 
         while ($row = $ilDB->fetchAssoc($res)) {
             $participants[] = $row['user_id'];
         }
 
         return $participants;
     }

Here is the caller graph for this function:

◆ getDirectoryNameFromUserData()

static ilExSubmission::getDirectoryNameFromUserData ( int $a_user_id )

static

Definition at line 1555 of file class.ilExSubmission.php.

References ilObjUser\_lookupName(), and ilFileUtils\getASCIIFilename().

Referenced by ilExerciseManagementCollectFilesJob\addLink(), ilExerciseManagementCollectFilesJob\createTargetDirectory(), ilExerciseManagementCollectFilesJob\getFeedbackDirectory(), ilDownloadSubmissionsBackgroundTask\run(), and ilExerciseManagementCollectFilesJob\run().

                                                                        : string
     {
         $userName = ilObjUser::_lookupName($a_user_id);
         return ilFileUtils::getASCIIFilename(
             trim($userName["lastname"]) . "_" .
             trim($userName["firstname"]) . "_" .
             trim($userName["login"]) . "_" .
             $userName["user_id"]
         );
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getDownloadedFilesInfoForTableGUIS()

ilExSubmission::getDownloadedFilesInfoForTableGUIS ( )

Exceptions

ilDateTimeException

Definition at line 1369 of file class.ilExSubmission.php.

References $ctrl, $lng, ilDatePresentation\formatDate(), getFiles(), getLastSubmission(), getUserId(), IL_CAL_DATETIME, lookupNewFiles(), ilLanguage\txt(), ilExAssignment\TYPE_BLOG, ilExAssignment\TYPE_PORTFOLIO, ilExAssignment\TYPE_TEXT, ilExAssignment\TYPE_UPLOAD, ilExAssignment\TYPE_UPLOAD_TEAM, and ilExAssignment\TYPE_WIKI_TEAM.

Referenced by ilExPeerReviewGUI\initPeerReviewItemForm(), and ilExPeerReviewGUI\renderInfoWidget().

                                                         : array
     {
         $lng = $this->lng;
         $ilCtrl = $this->ctrl;
 
         $result = array();
         $result["files"]["count"] = "---";
 
         // submission:
         // see if files have been resubmmited after solved
         $last_sub = $this->getLastSubmission();
         if ($last_sub) {
             $last_sub = ilDatePresentation::formatDate(new ilDateTime($last_sub, IL_CAL_DATETIME));
         } else {
             $last_sub = "---";
         }
         $result["last_submission"]["txt"] = $lng->txt("exc_last_submission");
         $result["last_submission"]["value"] = $last_sub;
 
         // #16994
         $ilCtrl->setParameterByClass("ilexsubmissionfilegui", "member_id", $this->getUserId());
 
         // assignment type specific
         switch ($this->assignment->getType()) {
             case ilExAssignment::TYPE_UPLOAD_TEAM:
                 // data is merged by team - see above
                 // fallthrough
 
             case ilExAssignment::TYPE_UPLOAD:
                 $all_files = $this->getFiles();
                 $late_files = 0;
                 foreach ($all_files as $file) {
                     if ($file["late"]) {
                         $late_files++;
                     }
                 }
 
                 // nr of submitted files
                 $result["files"]["txt"] = $lng->txt("exc_files_returned");
                 if ($late_files !== 0) {
                     $result["files"]["txt"] .= ' - <span class="warning">' . $lng->txt("exc_late_submission") . " (" . $late_files . ")</span>";
                 }
                 $sub_cnt = count($all_files);
                 $new = $this->lookupNewFiles();
                 if ($new !== []) {
                     $sub_cnt .= " " . sprintf($lng->txt("cnt_new"), count($new));
                 }
 
                 $result["files"]["count"] = $sub_cnt;
 
                 // download command
                 if ($sub_cnt > 0) {
                     $result["files"]["download_url"] =
                         $ilCtrl->getLinkTargetByClass("ilexsubmissionfilegui", "downloadReturned");
 
                     if (count($new) <= 0) {
                         $result["files"]["download_txt"] = $lng->txt("exc_tbl_action_download_files");
                     } else {
                         $result["files"]["download_txt"] = $lng->txt("exc_tbl_action_download_all_files");
                     }
 
                     // download new files only
                     if ($new !== []) {
                         $result["files"]["download_new_url"] =
                             $ilCtrl->getLinkTargetByClass("ilexsubmissionfilegui", "downloadNewReturned");
 
                         $result["files"]["download_new_txt"] = $lng->txt("exc_tbl_action_download_new_files");
                     }
                 }
                 break;
 
             case ilExAssignment::TYPE_BLOG:
                 $result["files"]["txt"] = $lng->txt("exc_blog_returned");
                 $blogs = $this->getFiles();
                 if ($blogs !== []) {
                     $blogs = array_pop($blogs);
                     if ($blogs && substr($blogs["filename"], -1) != "/") {
                         if ($blogs["late"]) {
                             $result["files"]["txt"] .= ' - <span class="warning">' . $lng->txt("exc_late_submission") . "</span>";
                         }
 
                         $result["files"]["count"] = 1;
 
                         $result["files"]["download_url"] =
                             $ilCtrl->getLinkTargetByClass("ilexsubmissionfilegui", "downloadReturned");
 
                         $result["files"]["download_txt"] = $lng->txt("exc_tbl_action_download_files");
                     }
                 }
                 break;
 
             case ilExAssignment::TYPE_PORTFOLIO:
                 $result["files"]["txt"] = $lng->txt("exc_portfolio_returned");
                 $portfolios = $this->getFiles();
                 if ($portfolios !== []) {
                     $portfolios = array_pop($portfolios);
                     if ($portfolios && substr($portfolios["filename"], -1) != "/") {
                         if ($portfolios["late"]) {
                             $result["files"]["txt"] .= ' - <span class="warning">' . $lng->txt("exc_late_submission") . "</span>";
                         }
 
                         $result["files"]["count"] = 1;
 
                         $result["files"]["download_url"] =
                             $ilCtrl->getLinkTargetByClass("ilexsubmissionfilegui", "downloadReturned");
 
                         $result["files"]["download_txt"] = $lng->txt("exc_tbl_action_download_files");
                     }
                 }
                 break;
 
             case ilExAssignment::TYPE_TEXT:
                 $result["files"]["txt"] = $lng->txt("exc_files_returned_text");
                 $files = $this->getFiles();
                 if ($files !== []) {
                     $result["files"]["count"] = 1;
 
                     $files = array_shift($files);
                     if (trim($files["atext"]) !== '' && trim($files["atext"]) !== '0') {
                         if ($files["late"]) {
                             $result["files"]["txt"] .= ' - <span class="warning">' . $lng->txt("exc_late_submission") . "</span>";
                         }
 
                         $result["files"]["download_url"] =
                             $ilCtrl->getLinkTargetByClass("ilexsubmissiontextgui", "showAssignmentText");
 
                         $result["files"]["download_txt"] = $lng->txt("exc_tbl_action_text_assignment_show");
                     }
                 }
                 break;
 
             case ilExAssignment::TYPE_WIKI_TEAM:
                 $result["files"]["txt"] = $lng->txt("exc_wiki_returned");
                 $objs = $this->getFiles();
                 if ($objs !== []) {
                     $objs = array_pop($objs);
                     if ($objs && substr($objs["filename"], -1) != "/") {
                         if ($objs["late"]) {
                             $result["files"]["txt"] .= ' - <span class="warning">' . $lng->txt("exc_late_submission") . "</span>";
                         }
 
                         $result["files"]["count"] = 1;
 
                         $result["files"]["download_url"] =
                             $ilCtrl->getLinkTargetByClass("ilexsubmissionfilegui", "downloadReturned");
 
                         $result["files"]["download_txt"] = $lng->txt("exc_tbl_action_download_files");
                     }
                 }
                 break;
         }
 
         $ilCtrl->setParameterByClass("ilexsubmissionfilegui", "member_id", "");
 
         return $result;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getFeedbackId()

ilExSubmission::getFeedbackId ( )

Definition at line 138 of file class.ilExSubmission.php.

References getUserId().

                                    : string
     {
         if ($this->team) {
             return "t" . $this->team->getId();
         } else {
             return (string) $this->getUserId();
         }
     }

Here is the call graph for this function:

◆ getFiles()

ilExSubmission::getFiles	(	array	$a_file_ids = `null`,
		bool	$a_only_valid = `false`,
		string	$a_min_timestamp = `null`,
		bool	$print_versions = `false`
	)

Get submission items (not only files)

Todo:: this also returns non-file entries, rename this, see dev.txt.php

Definition at line 487 of file class.ilExSubmission.php.

References $db, $i, $ilDB, $path, getAssignment(), ILIAS\Survey\Mode\getId(), getTableUserWhere(), initStorage(), ilExAssignment\TYPE_BLOG, ilExAssignment\TYPE_PORTFOLIO, and ilExAssignment\TYPE_WIKI_TEAM.

Referenced by canAddFile(), deleteAllFiles(), ilBlogExerciseGUI\downloadExcSubFile(), ilWikiPageGUI\downloadExcSubFile(), downloadFiles(), getDownloadedFilesInfoForTableGUIS(), ilExPeerReviewGUI\getLateSubmissionInfo(), ilExSubmissionFileGUI\getOverviewContent(), getSelectedObject(), ilExPeerReviewGUI\getSubmissionContent(), ilExerciseManagementGUI\getSubmissionZipFilePath(), getSubmittedPrintFile(), hasSubmitted(), processUploadedZipFile(), and updateTextSubmission().

      : array {
         $ilDB = $this->db;
 
         $sql = "SELECT * FROM exc_returned" .
             " WHERE ass_id = " . $ilDB->quote($this->getAssignment()->getId(), "integer");
 
         $sql .= " AND " . $this->getTableUserWhere(true);
 
 
         if ($a_file_ids) {
             $sql .= " AND " . $ilDB->in("returned_id", $a_file_ids, false, "integer");
         }
 
         if ($a_min_timestamp) {
             $sql .= " AND ts > " . $ilDB->quote($a_min_timestamp, "timestamp");
         }
 
         $result = $ilDB->query($sql);
 
         $delivered_files = array();
         if ($ilDB->numRows($result)) {
             $path = $this->initStorage()->getAbsoluteSubmissionPath();
 
             while ($row = $ilDB->fetchAssoc($result)) {
                 // blog/portfolio/text submissions
                 if ($a_only_valid &&
                     !$row["filename"] &&
                     !(trim($row["atext"]))) {
                     continue;
                 }
 
                 $row["owner_id"] = $row["user_id"];
                 $row["timestamp"] = $row["ts"];
                 $row["timestamp14"] = substr($row["ts"], 0, 4) .
                     substr($row["ts"], 5, 2) . substr($row["ts"], 8, 2) .
                     substr($row["ts"], 11, 2) . substr($row["ts"], 14, 2) .
                     substr($row["ts"], 17, 2);
 
                 if ($this->getAssignment()->getAssignmentType()->isSubmissionAssignedToTeam()) {
                     $storage_id = $row["team_id"];
                 } else {
                     $storage_id = $row["user_id"];
                 }
 
 
                 $row["filename"] = $path .
                     "/" . $storage_id . "/" . basename($row["filename"]);
 
                 // see 22301, 22719
                 if (is_file($row["filename"]) || (!$this->assignment->getAssignmentType()->usesFileUpload())) {
                     $delivered_files[] = $row;
                 }
             }
         }
 
         // filter print versions
         if (in_array($this->assignment->getType(), [
             ilExAssignment::TYPE_BLOG,
             ilExAssignment::TYPE_PORTFOLIO,
             ilExAssignment::TYPE_WIKI_TEAM
         ])) {
             $delivered_files = array_filter($delivered_files, function ($i) use ($print_versions) {
                 $is_print_version = false;
                 if (substr($i["filetitle"], strlen($i["filetitle"]) - 5) == "print") {
                     $is_print_version = true;
                 }
                 if (substr($i["filetitle"], strlen($i["filetitle"]) - 9) == "print.zip") {
                     $is_print_version = true;
                 }
                 return ($is_print_version == $print_versions);
             });
         }
 
         return $delivered_files;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getLastDownloadTime()

ilExSubmission::getLastDownloadTime ( array $a_user_ids )

protected

Parameters

array $a_user_ids

Returns: string "Y-m-d H:i:s"

Definition at line 748 of file class.ilExSubmission.php.

References $db, $ilDB, $ilUser, $user, getAssignment(), and ILIAS\Survey\Mode\getId().

Referenced by downloadFiles().

      : string {
         $ilDB = $this->db;
         $ilUser = $this->user;
 
         $q = "SELECT download_time FROM exc_usr_tutor WHERE " .
             " ass_id = " . $ilDB->quote($this->getAssignment()->getId(), "integer") . " AND " .
             $ilDB->in("usr_id", $a_user_ids, "", "integer") . " AND " .
             " tutor_id = " . $ilDB->quote($ilUser->getId(), "integer") .
             " ORDER BY download_time DESC";
         $lu_set = $ilDB->query($q);
         $lu_rec = $ilDB->fetchAssoc($lu_set);
         return $lu_rec["download_time"] ?? "";
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getLastOpeningHTMLView()

ilExSubmission::getLastOpeningHTMLView ( )

TODO -> get rid of getTableUserWhere and move to repository class Get a mysql timestamp from the last HTML view opening.

Definition at line 1245 of file class.ilExSubmission.php.

References $data, $res, and getTableUserWhere().

                                             : ?string
     {
         $this->db->setLimit(1, 0);
 
         $q = "SELECT web_dir_access_time FROM exc_returned" .
             " WHERE ass_id = " . $this->db->quote($this->assignment->getId(), "integer") .
             " AND (filename IS NOT NULL OR atext IS NOT NULL)" .
             " AND web_dir_access_time IS NOT NULL" .
             " AND " . $this->getTableUserWhere(true) .
             " ORDER BY web_dir_access_time DESC";
 
         $res = $this->db->query($q);
 
         $data = $this->db->fetchAssoc($res);
 
         return $data["web_dir_access_time"] ?? null;
     }

Here is the call graph for this function:

◆ getLastSubmission()

ilExSubmission::getLastSubmission ( )

TODO -> get rid of getTableUserWhere and move to repository class Get the date of the last submission of a user for the assignment.

Definition at line 1224 of file class.ilExSubmission.php.

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

Referenced by getDownloadedFilesInfoForTableGUIS(), and ilExSubmissionTeamGUI\getOverviewContent().

                                        : ?string
     {
         $ilDB = $this->db;
 
         $ilDB->setLimit(1, 0);
 
         $q = "SELECT obj_id,user_id,ts FROM exc_returned" .
             " WHERE ass_id = " . $ilDB->quote($this->assignment->getId(), "integer") .
             " AND " . $this->getTableUserWhere(true) .
             " AND (filename IS NOT NULL OR atext IS NOT NULL)" .
             " AND ts IS NOT NULL" .
             " ORDER BY ts DESC";
         $usr_set = $ilDB->query($q);
         $array = $ilDB->fetchAssoc($usr_set);
         return ($array["ts"] ?? null);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getPeerReview()

ilExSubmission::getPeerReview ( )

Definition at line 101 of file class.ilExSubmission.php.

References $peer_review.

Referenced by ilExPeerReviewGUI\getOverviewContent().

                                    : ?ilExPeerReview
     {
         return $this->peer_review;
     }

Here is the caller graph for this function:

◆ getSelectedObject()

ilExSubmission::getSelectedObject ( )

Definition at line 177 of file class.ilExSubmission.php.

References getFiles().

Referenced by ilExSubmissionObjectGUI\askUnlinkPortfolioObject(), ilObjWikiGUI\getAssignmentButtons(), ilBlogExerciseGUI\getDownloadSubmissionButton(), ilBlogExerciseGUI\getExerciseInfo(), ilExSubmissionObjectGUI\getOverviewContentBlog(), and ilExAssTypeWikiTeamGUI\renderOverviewContent().

                                        : ?array
     {
         $files = $this->getFiles();
         if ($files !== []) {
             return array_pop($files);
         }
         return null;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getStorageId()

ilExSubmission::getStorageId ( )

protected

Definition at line 285 of file class.ilExSubmission.php.

References getTeam(), and getUserId().

Referenced by uploadFile().

                                      : int
     {
         if ($this->ass_type->isSubmissionAssignedToTeam()) {
             $storage_id = $this->getTeam()->getId();
         } else {
             $storage_id = $this->getUserId();
         }
         return $storage_id;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSubmissionsForFilename()

static ilExSubmission::getSubmissionsForFilename	(	string	$a_filename,
		array	$a_assignment_types = `array()`
	)

static

Get assignment return entries for a filename.

Definition at line 1529 of file class.ilExSubmission.php.

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

Referenced by addResourceObject(), ilExcRepoObjAssignmentInfo\getInfo(), and ilObjWikiListGUI\getProperties().

      : array {
         global $DIC;
 
         $db = $DIC->database();
 
         $query = "SELECT * FROM exc_returned r LEFT JOIN exc_assignment a" .
             " ON (r.ass_id = a.id) " .
             " WHERE r.filetitle = " . $db->quote($a_filename, "string");
 
         if (is_array($a_assignment_types) && $a_assignment_types !== []) {
             $query .= " AND " . $db->in("a.type", $a_assignment_types, false, "integer");
         }
 
         $set = $db->query($query);
         $rets = array();
         while ($rec = $db->fetchAssoc($set)) {
             $rets[] = $rec;
         }
 
 
         return $rets;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSubmissionType()

ilExSubmission::getSubmissionType ( )

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

Referenced by addResourceObject(), and ilExSubmissionGUI\executeCommand().

                                        : string
     {
         return $this->assignment->getAssignmentType()->getSubmissionType();
     }

Here is the caller graph for this function:

◆ getSubmittedPrintFile()

ilExSubmission::getSubmittedPrintFile ( )

Definition at line 157 of file class.ilExSubmission.php.

References getFiles().

Referenced by hasSubmittedPrintVersion().

                                            : string
     {
         $submitted = $this->getFiles(
             null,
             false,
             null,
             true
         );
 
         if (count($submitted) > 0) {
             $submitted = array_pop($submitted);
 
             if (is_file($submitted['filename'])) {
                 return $submitted['filename'];
             }
         }
 
         return "";
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getTableUserWhere()

ilExSubmission::getTableUserWhere ( bool $a_team_mode = false )

Definition at line 1201 of file class.ilExSubmission.php.

References $db, $ilDB, getAssignment(), getTeam(), getUserId(), and getUserIds().

Referenced by deleteSelectedFiles(), getFiles(), getLastOpeningHTMLView(), getLastSubmission(), and lookupNewFiles().

      : string {
         $ilDB = $this->db;
 
         if ($this->getAssignment()->getAssignmentType()->isSubmissionAssignedToTeam()) {
             $team_id = $this->getTeam()->getId();
             $where = " team_id = " . $ilDB->quote($team_id, "integer") . " ";
         } else {
             if ($a_team_mode) {
                 $where = " " . $ilDB->in("user_id", $this->getUserIds(), "", "integer") . " ";
             } else {
                 $where = " user_id = " . $ilDB->quote($this->getUserId(), "integer");
             }
         }
         return $where;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getTeam()

ilExSubmission::getTeam ( )

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

References $team.

Referenced by addResourceObject(), downloadFiles(), ilExSubmissionTeamGUI\getOverviewContent(), getStorageId(), getTableUserWhere(), ilExAssTypeWikiTeamGUI\renderOverviewContent(), and uploadFile().

                              : ?ilExAssignmentTeam
     {
         return $this->team;
     }

Here is the caller graph for this function:

◆ getUserId()

ilExSubmission::getUserId ( )

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

References $user_id.

Referenced by addResourceObject(), downloadFiles(), getDownloadedFilesInfoForTableGUIS(), getFeedbackId(), ilExSubmissionTeamGUI\getOverviewContent(), ilExPeerReviewGUI\getOverviewContent(), ilExSubmissionObjectGUI\getOverviewContentBlog(), getStorageId(), getTableUserWhere(), isOwner(), and uploadFile().

                                : int
     {
         return $this->user_id;
     }

Here is the caller graph for this function:

◆ getUserIds()

ilExSubmission::getUserIds ( )

Definition at line 127 of file class.ilExSubmission.php.

References hasNoTeamYet().

Referenced by downloadFiles(), getTableUserWhere(), ilExAssTypeWikiTeam\handleNewUpload(), isInTeam(), updateTutorDownloadTime(), and validatePeerReviews().

                                 : array
     {
         if ($this->team &&
             !$this->hasNoTeamYet()) {
             return $this->team->getMembers();
         }
 
         // if has no team currently there still might be uploads attached
         return array($this->user_id);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ hasNoTeamYet()

ilExSubmission::hasNoTeamYet ( )

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

Referenced by ilExSubmissionFileGUI\getOverviewContent(), and getUserIds().

                                   : bool
     {
         if ($this->assignment->hasTeam() &&
             !$this->team->getId()) {
             return true;
         }
         return false;
     }

Here is the caller graph for this function:

◆ hasPeerReviewAccess()

ilExSubmission::hasPeerReviewAccess ( )

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

                                          : bool
     {
         return ($this->peer_review &&
             $this->peer_review->hasPeerReviewAccess($this->user_id));
     }

◆ hasSubmitted()

ilExSubmission::hasSubmitted ( )

Definition at line 147 of file class.ilExSubmission.php.

References getFiles().

Referenced by ilExSubmissionTeamGUI\getOverviewContent(), ilExSubmissionObjectGUI\getOverviewContentBlog(), ilExAssTypeWikiTeam\handleNewUpload(), ilExcAssMemberState\isGlobalFeedbackFileAccessible(), and ilExAssTypeWikiTeamGUI\renderOverviewContent().

                                   : bool
     {
         return (bool) count($this->getFiles(null, true));
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ hasSubmittedPrintVersion()

ilExSubmission::hasSubmittedPrintVersion ( )

Definition at line 152 of file class.ilExSubmission.php.

References getSubmittedPrintFile().

                                               : bool
     {
         return $this->getSubmittedPrintFile() !== "";
     }

Here is the call graph for this function:

◆ initStorage()

ilExSubmission::initStorage ( )

protected

Definition at line 280 of file class.ilExSubmission.php.

Referenced by deleteSelectedFiles(), downloadMultipleFiles(), downloadSingleFile(), getFiles(), and uploadFile().

                                     : ilFSStorageExercise
     {
         return new ilFSStorageExercise($this->assignment->getExerciseId(), $this->assignment->getId());
     }

Here is the caller graph for this function:

◆ isInTeam()

ilExSubmission::isInTeam ( int $a_user_id = null )

Definition at line 230 of file class.ilExSubmission.php.

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

Referenced by canView().

                                                    : bool
     {
         $ilUser = $this->user;
 
         if (!$a_user_id) {
             $a_user_id = $ilUser->getId();
         }
         return in_array($a_user_id, $this->getUserIds());
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isLate()

ilExSubmission::isLate ( )

protected

Definition at line 273 of file class.ilExSubmission.php.

Referenced by addResourceObject(), and updateTextSubmission().

                                : bool
     {
         $dl = $this->state->getOfficialDeadline();
         //$dl = $this->assignment->getPersonalDeadline($this->getUserId());
         return ($dl && $dl < time());
     }

Here is the caller graph for this function:

◆ isOwner()

ilExSubmission::isOwner ( )

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

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

Referenced by canSubmit().

                              : bool
     {
         $ilUser = $this->user;
 
         return ($ilUser->getId() == $this->getUserId());
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isTutor()

ilExSubmission::isTutor ( )

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

References $is_tutor.

Referenced by canView().

                              : bool
     {
         return $this->is_tutor;
     }

Here is the caller graph for this function:

◆ lookupExerciseIdForReturnedId()

static ilExSubmission::lookupExerciseIdForReturnedId ( int $a_returned_id )

static

Get exercise from submission id (used in ilObjMediaObject)

Definition at line 605 of file class.ilExSubmission.php.

References $DIC, and $ilDB.

Referenced by ilObjMediaObject\getParentObjectIdForUsage().

      : int {
         global $DIC;
 
         $ilDB = $DIC->database();
 
         $set = $ilDB->query("SELECT obj_id" .
             " FROM exc_returned" .
             " WHERE returned_id = " . $ilDB->quote($a_returned_id, "integer"));
         $row = $ilDB->fetchAssoc($set);
         return (int) $row["obj_id"];
     }

Here is the caller graph for this function:

◆ lookupNewFiles()

ilExSubmission::lookupNewFiles ( int $a_tutor = null )

Check how much files have been uploaded by the learner after the last download of the tutor.

Definition at line 572 of file class.ilExSubmission.php.

References $db, $ilDB, $ilUser, $user, getAssignment(), ILIAS\Survey\Mode\getId(), and getTableUserWhere().

Referenced by getDownloadedFilesInfoForTableGUIS().

      : array {
         $ilDB = $this->db;
         $ilUser = $this->user;
 
         $tutor = ($a_tutor)
             ?: $ilUser->getId();
 
         $where = " AND " . $this->getTableUserWhere(true);
 
         $q = "SELECT exc_returned.returned_id AS id " .
             "FROM exc_usr_tutor, exc_returned " .
             "WHERE exc_returned.ass_id = exc_usr_tutor.ass_id " .
             " AND exc_returned.user_id = exc_usr_tutor.usr_id " .
             " AND exc_returned.ass_id = " . $ilDB->quote($this->getAssignment()->getId(), "integer") .
             $where .
             " AND exc_usr_tutor.tutor_id = " . $ilDB->quote($tutor, "integer") .
             " AND exc_usr_tutor.download_time < exc_returned.ts ";
 
         $new_up_set = $ilDB->query($q);
 
         $new_up = array();
         while ($new_up_rec = $ilDB->fetchAssoc($new_up_set)) {
             $new_up[] = $new_up_rec["id"];
         }
 
         return $new_up;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ processUploadedZipFile()

ilExSubmission::processUploadedZipFile ( string $fileTmp )

processes error handling etc for uploaded archive

Parameters

string $fileTmp path and filename to uploaded file

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

References Vendor\Package\$e, $filename, ILIAS\LTI\ToolProvider\$key, $lng, ilFileUtils\delDir(), getFiles(), ilFileUtils\ilTempnam(), ilFileUtils\makeDir(), ilFileUtils\processZipFile(), ilFileUtils\recursive_dirscan(), ilLanguage\txt(), uploadFile(), and ilFileUtils\utf8_encode().

      : bool {
         $lng = $this->lng;
 
         // Create unzip-directory
         $newDir = ilFileUtils::ilTempnam();
         ilFileUtils::makeDir($newDir);
 
         $success = true;
 
         try {
             $filearray = [];
             ilFileUtils::processZipFile($newDir, $fileTmp, false);
             ilFileUtils::recursive_dirscan($newDir, $filearray);
 
             // #18441 - check number of files in zip
             $max_num = $this->assignment->getMaxFile();
             if ($max_num) {
                 $current_num = count($this->getFiles());
                 $zip_num = count($filearray["file"]);
                 if ($current_num + $zip_num > $max_num) {
                     $success = false;
                     $this->main_tpl->setOnScreenMessage('failure', $lng->txt("exc_upload_error") . " [Zip1]", true);
                 }
             }
 
             if ($success) {
                 foreach ($filearray["file"] as $key => $filename) {
                     $a_http_post_files["name"] = ilFileUtils::utf8_encode($filename);
                     $a_http_post_files["type"] = "other";
                     $a_http_post_files["tmp_name"] = $filearray["path"][$key] . "/" . $filename;
                     $a_http_post_files["error"] = 0;
                     $a_http_post_files["size"] = filesize($filearray["path"][$key] . "/" . $filename);
 
                     if (!$this->uploadFile($a_http_post_files, true)) {
                         $success = false;
                         $this->main_tpl->setOnScreenMessage('failure', $lng->txt("exc_upload_error") . " [Zip2]", true);
                     }
                 }
             }
         } catch (ilFileUtilsException $e) {
             $success = false;
             $this->main_tpl->setOnScreenMessage('failure', $e->getMessage());
         }
 
         ilFileUtils::delDir($newDir);
         return $success;
     }

Here is the call graph for this function:

◆ updateTextSubmission()

ilExSubmission::updateTextSubmission ( string $a_text )

Handle text assignment submissions.

Exceptions

ilExcUnknownAssignmentTypeException
ilExerciseException

Definition at line 1333 of file class.ilExSubmission.php.

References $db, $id, $ilDB, addResourceObject(), deleteAllFiles(), getFiles(), isLate(), and ilUtil\now().

                                                         : ?int
     {
         $ilDB = $this->db;
 
         $files = $this->getFiles();
 
         // no text = remove submission
         if (!trim($a_text)) {
             $this->deleteAllFiles();
             return null;
         }
 
         if (!$files) {
             return $this->addResourceObject("TEXT", $a_text);
         } else {
             $files = array_shift($files);
             $id = $files["returned_id"];
             if ($id) {
                 $ilDB->manipulate("UPDATE exc_returned" .
                     " SET atext = " . $ilDB->quote($a_text, "text") .
                     ", ts = " . $ilDB->quote(ilUtil::now(), "timestamp") .
                     ", late = " . $ilDB->quote($this->isLate(), "integer") .
                     " WHERE returned_id = " . $ilDB->quote($id, "integer"));
                 return $id;
             }
         }
         return null;
     }

Here is the call graph for this function:

◆ updateTutorDownloadTime()

ilExSubmission::updateTutorDownloadTime ( )

Definition at line 875 of file class.ilExSubmission.php.

References $db, $ilDB, $ilUser, $user, getUserIds(), and ilUtil\now().

Referenced by downloadFiles().

                                              : void
     {
         $ilUser = $this->user;
         $ilDB = $this->db;
 
         $exc_id = $this->assignment->getExerciseId();
         $ass_id = $this->assignment->getId();
 
         foreach ($this->getUserIds() as $user_id) {
             $ilDB->manipulateF(
                 "DELETE FROM exc_usr_tutor " .
                 "WHERE ass_id = %s AND usr_id = %s AND tutor_id = %s",
                 array("integer", "integer", "integer"),
                 array($ass_id, $user_id, $ilUser->getId())
             );
 
             $ilDB->manipulateF(
                 "INSERT INTO exc_usr_tutor (ass_id, obj_id, usr_id, tutor_id, download_time) VALUES " .
                 "(%s, %s, %s, %s, %s)",
                 array("integer", "integer", "integer", "integer", "timestamp"),
                 array($ass_id, $exc_id, $user_id, $ilUser->getId(), ilUtil::now())
             );
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ uploadFile()

ilExSubmission::uploadFile	(	array	$a_http_post_files,
		bool	$unzip = `false`
	)

Save submitted file of user.

Exceptions

ilFileUtilsException

Definition at line 300 of file class.ilExSubmission.php.

References $db, $ilDB, $query, canAddFile(), getStorageId(), getTeam(), getUserId(), ilFileUtils\getValidFilename(), initStorage(), ilUtil\now(), and ilExAssignmentTeam\TEAM_LOG_ADD_FILE.

Referenced by processUploadedZipFile().

      : bool {
         $ilDB = $this->db;
 
         if (!$this->canAddFile()) {
             return false;
         }
 
         if ($this->ass_type->isSubmissionAssignedToTeam()) {
             $team_id = $this->getTeam()->getId();
             $user_id = 0;
             if ($team_id == 0) {
                 return false;
             }
         } else {
             $team_id = 0;
             $user_id = $this->getUserId();
         }
         $storage_id = $this->getStorageId();
 
         $deliver_result = $this->initStorage()->uploadFile($a_http_post_files, $storage_id, $unzip);
 
         if ($deliver_result) {
             $next_id = $ilDB->nextId("exc_returned");
             $query = sprintf(
                 "INSERT INTO exc_returned " .
                              "(returned_id, obj_id, user_id, filename, filetitle, mimetype, ts, ass_id, late, team_id) " .
                              "VALUES (%s, %s, %s, %s, %s, %s, %s, %s, %s, %s)",
                 $ilDB->quote($next_id, "integer"),
                 $ilDB->quote($this->assignment->getExerciseId(), "integer"),
                 $ilDB->quote($user_id, "integer"),
                 $ilDB->quote($deliver_result["fullname"], "text"),
                 $ilDB->quote(ilFileUtils::getValidFilename($a_http_post_files["name"]), "text"),
                 $ilDB->quote($deliver_result["mimetype"], "text"),
                 $ilDB->quote(ilUtil::now(), "timestamp"),
                 $ilDB->quote($this->assignment->getId(), "integer"),
                 $ilDB->quote($this->isLate(), "integer"),
                 $ilDB->quote($team_id, "integer")
             );
             $ilDB->manipulate($query);
 
             if ($this->team) {
                 $this->team->writeLog(
                     ilExAssignmentTeam::TEAM_LOG_ADD_FILE,
                     $a_http_post_files["name"]
                 );
             }
 
             return true;
         }
         return false;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ validatePeerReviews()

ilExSubmission::validatePeerReviews ( )

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

References $res, $user_id, $valid, and getUserIds().

Referenced by ilExAssTypeWikiTeam\handleNewUpload().

                                          : array
     {
         $res = array();
         foreach ($this->getUserIds() as $user_id) {
             $valid = true;
 
             // no peer review == valid
             if ($this->peer_review) {
                 $valid = $this->peer_review->isFeedbackValidForPassed($user_id);
             }
 
             $res[$user_id] = $valid;
         }
         return $res;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

◆ $ass_type

ilExAssignmentTypeInterface ilExSubmission::$ass_type

protected

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

◆ $ass_types

ilExAssignmentTypes ilExSubmission::$ass_types

protected

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

◆ $assignment

ilExAssignment ilExSubmission::$assignment

protected

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

Referenced by getAssignment().

◆ $ctrl

ilCtrl ilExSubmission::$ctrl

protected

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

Referenced by getDownloadedFilesInfoForTableGUIS().

◆ $db

ilDBInterface ilExSubmission::$db

protected

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

Referenced by addResourceObject(), deleteSelectedFiles(), getFiles(), getLastDownloadTime(), getLastSubmission(), getTableUserWhere(), lookupNewFiles(), updateTextSubmission(), updateTutorDownloadTime(), and uploadFile().

◆ $is_tutor

bool ilExSubmission::$is_tutor

protected

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

Referenced by isTutor().

◆ $lng

ilLanguage ilExSubmission::$lng

protected

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

Referenced by downloadFiles(), downloadMultipleFiles(), getDownloadedFilesInfoForTableGUIS(), and processUploadedZipFile().

◆ $main_tpl

ilGlobalTemplateInterface ilExSubmission::$main_tpl

private

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

◆ $peer_review

ilExPeerReview ilExSubmission::$peer_review = null

protected

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

Referenced by getPeerReview().

◆ $public_submissions

bool ilExSubmission::$public_submissions

protected

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

◆ $state

ilExcAssMemberState ilExSubmission::$state

protected

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

◆ $team

ilExAssignmentTeam ilExSubmission::$team = null

protected

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

Referenced by getTeam().

◆ $user

ilObjUser ilExSubmission::$user

protected

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

Referenced by canView(), downloadFiles(), getLastDownloadTime(), isInTeam(), isOwner(), lookupNewFiles(), and updateTutorDownloadTime().

◆ $user_id

int ilExSubmission::$user_id

protected

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

Referenced by __construct(), getUserId(), and validatePeerReviews().

◆ TYPE_FILE

const ilExSubmission::TYPE_FILE = "File"

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

Referenced by ilExAssTypeUpload\getSubmissionType(), and ilExAssTypeUploadTeam\getSubmissionType().

◆ TYPE_OBJECT

const ilExSubmission::TYPE_OBJECT = "Object"

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

Referenced by ilExAssTypeBlog\getSubmissionType(), and ilExAssTypePortfolio\getSubmissionType().

◆ TYPE_REPO_OBJECT

const ilExSubmission::TYPE_REPO_OBJECT = "RepoObject"

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

Referenced by addResourceObject(), ilExSubmissionGUI\executeCommand(), ilExcRepoObjAssignmentInfo\getInfo(), and ilExAssTypeWikiTeam\getSubmissionType().

◆ TYPE_TEXT

const ilExSubmission::TYPE_TEXT = "Text"

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

Referenced by ilExAssTypeText\getSubmissionType().

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

Modules/Exercise/Submission/class.ilExSubmission.php

Public Member Functions

Static Public Member Functions

Data Fields

Protected Member Functions

Protected Attributes

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ addResourceObject()

◆ canAddFile()

◆ canSubmit()

◆ canView()

◆ deleteAllFiles()

◆ deleteResourceObject()

◆ deleteSelectedFiles()

◆ deleteUser()

◆ downloadAllAssignmentFiles()

◆ downloadFiles()

◆ downloadMultipleFiles()

◆ downloadSingleFile()

◆ findUserFiles()

◆ getAllAssignmentFiles()

◆ getAssignment()

◆ getAssignmentFilesByUsers()

◆ getAssignmentParticipants()

◆ getDirectoryNameFromUserData()

◆ getDownloadedFilesInfoForTableGUIS()

◆ getFeedbackId()

◆ getFiles()

◆ getLastDownloadTime()

◆ getLastOpeningHTMLView()

◆ getLastSubmission()

◆ getPeerReview()

◆ getSelectedObject()

◆ getStorageId()

◆ getSubmissionsForFilename()

◆ getSubmissionType()

◆ getSubmittedPrintFile()

◆ getTableUserWhere()

◆ getTeam()

◆ getUserId()

◆ getUserIds()

◆ hasNoTeamYet()

◆ hasPeerReviewAccess()

◆ hasSubmitted()

◆ hasSubmittedPrintVersion()

◆ initStorage()

◆ isInTeam()

◆ isLate()

◆ isOwner()

◆ isTutor()

◆ lookupExerciseIdForReturnedId()

◆ lookupNewFiles()

◆ processUploadedZipFile()

◆ updateTextSubmission()

◆ updateTutorDownloadTime()

◆ uploadFile()

◆ validatePeerReviews()

Field Documentation

◆ $ass_type

◆ $ass_types

◆ $assignment

◆ $ctrl

◆ $db

◆ $is_tutor

◆ $lng

◆ $main_tpl

◆ $peer_review

◆ $public_submissions

◆ $state

◆ $team

◆ $user

◆ $user_id

◆ TYPE_FILE

◆ TYPE_OBJECT

◆ TYPE_REPO_OBJECT

◆ TYPE_TEXT