ilExSubmission Class Reference

Exercise submission //TODO: This class has many static methods related to delivered "files". 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 ()
	used for the legacy storage path of feedbacks only More...
	hasSubmitted ()
	hasSubmittedPrintVersion ()
	getSubmittedEntry (bool $print=false)
	getSelectedObject ()
	canSubmit ()
	canView ()
	isTutor ()
	hasNoTeamYet ()
	isInTeam (?int $a_user_id=null)
	isOwner ()
	hasPeerReviewAccess ()
	canAddFile ()
	isLate ()
	lookupNewFiles (?int $a_tutor=null)
	Check how much files have been uploaded by the learner after the last download of the tutor. More...
	deleteAllFiles ()
	updateTutorDownloadTime ()
	getTableUserWhere ()
	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...

Static Public Member Functions
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)
	Deletes already delivered files. 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)
static	processZipFile (string $a_directory, string $a_file, bool $structure)

Data Fields
const	TYPE_FILE = "File"
const	TYPE_OBJECT = "Object"
const	TYPE_TEXT = "Text"
const	TYPE_REPO_OBJECT = "RepoObject"

Protected Member Functions
	getStorageId ()
	getLastDownloadTime (array $a_user_ids)
	downloadSingleFile (Submission $sub, string $title)

Protected Attributes
ILIAS Exercise Submission SubmissionManager	$sub_manager
ILIAS Exercise InternalDomainService	$domain
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

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 28 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 52 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()) {        // ass type uses teams...
            if (!$a_team) {
                // this might be a team with no id (since the create on demand parameter is not set)
                $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);
        }
        $this->domain = $DIC->exercise()->internal()->domain();
        $this->sub_manager = $DIC->exercise()->internal()->domain()->submission(
            $a_ass->getId()
        );
    }

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 691 of file class.ilExSubmission.php.

References $db, $ilDB, 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 256 of file class.ilExSubmission.php.

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

                                : bool
    {
        if (!$this->canSubmit()) {
            return false;
        }

        $max = $this->getAssignment()->getMaxFile();
        $cnt_sub = $this->sub_manager->countSubmissionsOfUser(
            $this->getUserId()
        );
        if ($max &&
            $max <= $cnt_sub) {
            return false;
        }

        return true;
    }

Here is the call graph for this function:

canSubmit()

ilExSubmission::canSubmit

(

)

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

References isOwner().

Referenced by canAddFile(), canView(), ilExSubmissionTextGUI\getOverviewContent(), ilExSubmissionFileGUI\getOverviewContent(), ilExSubmissionObjectGUI\getOverviewContentBlog(), ilExSubmissionObjectGUI\getOverviewContentPortfolio(), 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 195 of file class.ilExSubmission.php.

References $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 370 of file class.ilExSubmission.php.

References getUserId().

Referenced by deleteResourceObject().

                                    : void
    {
        $this->sub_manager->deleteAllSubmissionsOfUser($this->getUserId());
    }

Here is the call graph for this function:

Here is the caller graph for this function:

deleteResourceObject()

ilExSubmission::deleteResourceObject

(

)

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

References deleteAllFiles().

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

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

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

Deletes already delivered files.

Parameters

array

$file_id_array

An array containing database ids of the delivered files Delete all delivered files of user

Exceptions

ilExcUnknownAssignmentTypeException

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

References $DIC, ilExAssignment\getInstancesByExercise(), ilDBInterface\manipulateF(), and ilExAssignmentTeam\removeTeamMember().

Referenced by ilExerciseMembers\deassignMember().

     : void {
        global $DIC;

        $db = $DIC->database();

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

            $db->manipulateF(
                "DELETE FROM exc_usr_tutor " .
                "WHERE ass_id = %s AND usr_id = %s",
                array("integer", "integer"),
                array($ass->getId(), $a_user_id)
            );
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

downloadSingleFile()

ilExSubmission::downloadSingleFile ( Submission  $sub, string  $title  )

protected

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

References ILIAS\Exercise\Submission\Submission\getRid(), and ILIAS\Exercise\Submission\Submission\getUserId().

Referenced by getLastDownloadTime().

     : void {
        $this->domain->submission($this->assignment->getId())->deliverFile(
            $sub->getUserId(),
            $sub->getRid(),
            $title
        );
    }

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 351 of file class.ilExSubmission.php.

References $DIC, $ilDB, and $res.

Referenced by ILIAS\Exercise\BlogExercise\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:

getAssignment()

ilExSubmission::getAssignment

(

)

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

References $assignment.

Referenced by ilExSubmissionTextGUI\__construct(), ilExSubmissionFileGUI\__construct(), ilExSubmissionBaseGUI\__construct(), addResourceObject(), ilExSubmissionTeamGUI\buildSubmissionPropertiesAndActions(), ilExPeerReviewGUI\buildSubmissionPropertiesAndActions(), canAddFile(), ilExSubmissionGUI\executeCommand(), getLastDownloadTime(), ilExSubmissionObjectGUI\getOverviewContent(), ilExSubmissionFileGUI\getOverviewContent(), ilExSubmissionTeamGUI\getOverviewContent(), ilExPeerReviewGUI\getOverviewContent(), getTableUserWhere(), lookupNewFiles(), and setSubmission().

                                   : ilExAssignment
    {
        return $this->assignment;
    }

Here is the caller graph for this function:

getAssignmentParticipants()

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

static

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

References $DIC, $ilDB, 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

Deprecated:

see getDirectoryNameFromUserData in SubmissionManager

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

getFeedbackId()

ilExSubmission::getFeedbackId

(

)

used for the legacy storage path of feedbacks only

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

getLastDownloadTime()

ilExSubmission::getLastDownloadTime ( array  $a_user_ids )

protected

Parameters

array

$a_user_ids

Returns

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

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

References $db, $ilDB, $lng, $q, $user, ilObjUser\_lookupName(), ilObject\_lookupTitle(), downloadSingleFile(), getAssignment(), ILIAS\Survey\Mode\getId(), getTeam(), getUserId(), getUserIds(), null, ilLanguage\txt(), ilExAssignment\TYPE_BLOG, ilExAssignment\TYPE_PORTFOLIO, ilExAssignment\TYPE_WIKI_TEAM, and updateTutorDownloadTime().

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

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 663 of file class.ilExSubmission.php.

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

                                            : ?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() .
            " 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 642 of file class.ilExSubmission.php.

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

Referenced by ilExSubmissionTeamGUI\buildSubmissionPropertiesAndActions(), ilExSubmissionTeamGUI\getOverviewContent(), and updateTextSubmission().

                                       : ?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() .
            " 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 110 of file class.ilExSubmission.php.

References $peer_review.

Referenced by ilExPeerReviewGUI\buildSubmissionPropertiesAndActions(), ilExPeerReviewGUI\getOverviewContent(), and ilExPeerReviewGUI\getPeerReviewReceiverPanel().

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

Here is the caller graph for this function:

getSelectedObject()

ilExSubmission::getSelectedObject

(

)

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

References getUserId().

Referenced by ilExSubmissionObjectGUI\askUnlinkBlogObject(), ilExSubmissionObjectGUI\askUnlinkPortfolioObject(), ilObjWikiGUI\getAssignmentButtons(), ilExSubmissionObjectGUI\getOverviewContentBlog(), ilExSubmissionObjectGUI\getOverviewContentPortfolio(), and ilExAssTypeWikiTeamGUI\renderOverviewContent().

                                       : ?Submission
    {
        return $this->sub_manager->getSubmissionsOfUser($this->getUserId())->current();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getStorageId()

ilExSubmission::getStorageId ( )

protected

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

References getTeam(), and getUserId().

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

getSubmissionsForFilename()

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

static

Get assignment return entries for a filename.

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

References $DIC, 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 95 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:

getSubmittedEntry()

ilExSubmission::getSubmittedEntry

(

bool

$print = false

)

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

References getUserId(), and null.

Referenced by hasSubmittedPrintVersion().

                                                          : ?Submission
    {
        return $this->sub_manager->getSubmissionsOfUser(
            $this->getUserId(),
            null,
            false,
            null,
            $print
        )->current();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getTableUserWhere()

ilExSubmission::getTableUserWhere

(

)

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

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

Referenced by 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 {
            $where = " " . $ilDB->in("user_id", $this->getUserIds(), "", "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 105 of file class.ilExSubmission.php.

References $team.

Referenced by addResourceObject(), ilExSubmissionTeamGUI\buildSubmissionPropertiesAndActions(), getLastDownloadTime(), ilExSubmissionTeamGUI\getOverviewContent(), getStorageId(), getTableUserWhere(), and ilExAssTypeWikiTeamGUI\renderOverviewContent().

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

Here is the caller graph for this function:

getUserId()

ilExSubmission::getUserId

(

)

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

References $user_id.

Referenced by ilExcDeliveredFilesTableGUI\__construct(), addResourceObject(), ilExSubmissionTeamGUI\buildSubmissionPropertiesAndActions(), ilExPeerReviewGUI\buildSubmissionPropertiesAndActions(), canAddFile(), deleteAllFiles(), getFeedbackId(), getLastDownloadTime(), ilExPeerReviewGUI\getLateSubmissionInfo(), ilExSubmissionFileGUI\getOverviewContent(), ilExSubmissionTeamGUI\getOverviewContent(), ilExPeerReviewGUI\getOverviewContent(), ilExSubmissionObjectGUI\getOverviewContentBlog(), ilExSubmissionObjectGUI\getOverviewContentPortfolio(), getSelectedObject(), getStorageId(), ilExPeerReviewGUI\getSubmissionContent(), getSubmittedEntry(), hasSubmitted(), isOwner(), setSubmission(), and updateTextSubmission().

                               : int
    {
        return $this->user_id;
    }

Here is the caller graph for this function:

getUserIds()

ilExSubmission::getUserIds

(

)

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

References hasNoTeamYet().

Referenced by getLastDownloadTime(), 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 224 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 250 of file class.ilExSubmission.php.

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

hasSubmitted()

ilExSubmission::hasSubmitted

(

)

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

References getUserId(), and null.

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

                                  : bool
    {
        return (bool) $this->sub_manager->getSubmissionsOfUser(
            $this->getUserId(),
            null,
            true
        )->current();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

hasSubmittedPrintVersion()

ilExSubmission::hasSubmittedPrintVersion

(

)

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

References getSubmittedEntry().

                                              : bool
    {
        return ($this->getSubmittedEntry(true)?->getRid() != "");
    }

Here is the call graph for this function:

isInTeam()

ilExSubmission::isInTeam

(

?int

$a_user_id = null

)

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

References $user, ilObject\getId(), 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

(

)

Definition at line 279 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 243 of file class.ilExSubmission.php.

References $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 219 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 333 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 300 of file class.ilExSubmission.php.

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

Referenced by updateTextSubmission().

     : array {
        $ilDB = $this->db;
        $ilUser = $this->user;

        $tutor = ($a_tutor)
            ?: $ilUser->getId();

        $where = " AND " . $this->getTableUserWhere();

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

processZipFile()

static ilExSubmission::processZipFile ( string  $a_directory, string  $a_file, bool  $structure  )

static

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

References ilFileUtilsException\$BROKEN_FILE, $DIC, ilFileUtilsException\$DOUBLETTES_FOUND, ilFileUtilsException\$INFECTED_FILE, ilFileUtils\delDir(), ilFileUtils\moveUploadedFile(), null, ilFileUtils\recursive_dirscan(), ilLanguage\txt(), ilFileUtils\utf8_encode(), and ilVirusScanner\virusHandling().

     : void {
        global $DIC;

        $lng = $DIC->language();

        $pathinfo = pathinfo($a_file);
        $file = $pathinfo["basename"];

        // see 22727
        if (($pathinfo["extension"] ?? '') === '') {
            $file .= ".zip";
        }

        // Copy zip-file to new directory, unzip and remove it
        // TODO: check archive for broken file
        //copy ($a_file, $a_directory . "/" . $file);
        ilFileUtils::moveUploadedFile($a_file, $file, $a_directory . "/" . $file);
        $DIC->legacyArchives()->unzip(
            $a_directory . "/" . $file,
            null,
            false,
            true,
            false
        );
        unlink($a_directory . "/" . $file);
        //echo "-".$a_directory . "/" . $file."-";
        // Stores filename and paths into $filearray to check for viruses
        // Checks if filenames can be read, else -> throw exception and leave
        $filearray = [];
        ilFileUtils::recursive_dirscan($a_directory, $filearray);

        // if there are no files unziped (->broken file!)
        if (empty($filearray)) {
            throw new ilFileUtilsException(
                $lng->txt("archive_broken"),
                ilFileUtilsException::$BROKEN_FILE
            );
        }

        // virus handling
        foreach ($filearray["file"] as $key => $value) {
            // remove "invisible" files
            if (substr($value, 0, 1) == "." || stristr(
                $filearray["path"][$key],
                "/__MACOSX/"
            )) {
                unlink($filearray["path"][$key] . $value);
                unset($filearray["path"][$key]);
                unset($filearray["file"][$key]);
                continue;
            }

            $vir = ilVirusScanner::virusHandling($filearray["path"][$key], $value);
            if (!$vir[0]) {
                // Unlink file and throw exception
                unlink($filearray['path'][$key]);
                throw new ilFileUtilsException(
                    $lng->txt("file_is_infected") . "<br />" . $vir[1],
                    ilFileUtilsException::$INFECTED_FILE
                );
            } elseif ($vir[1] != "") {
                throw new ilFileUtilsException(
                    $vir[1],
                    ilFileUtilsException::$INFECTED_FILE
                );
            }
        }

        // If archive is to be used "flat"
        $doublettes = '';
        if (!$structure) {
            foreach (array_count_values($filearray["file"]) as $key => $value) {
                // Archive contains same filenames in different directories
                if ($value != "1") {
                    $doublettes .= " '" . ilFileUtils::utf8_encode($key) . "'";
                }
            }
            if (strlen($doublettes) > 0) {
                throw new ilFileUtilsException(
                    $lng->txt("exc_upload_error") . "<br />" . $lng->txt(
                        "zip_structure_error"
                    ) . $doublettes,
                    ilFileUtilsException::$DOUBLETTES_FOUND
                );
            }
        } else {
            $mac_dir = $a_directory . "/__MACOSX";
            if (file_exists($mac_dir)) {
                ilFileUtils::delDir($mac_dir);
            }
        }
    }

Here is the call graph for this function:

updateTextSubmission()

ilExSubmission::updateTextSubmission

(

string

$a_text

)

Handle text assignment submissions.

Exceptions

ilExcUnknownAssignmentTypeException
ilExerciseException

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

References $ctrl, $db, $id, $ilDB, $lng, addResourceObject(), ilDatePresentation\formatDate(), getLastSubmission(), getUserId(), IL_CAL_DATETIME, isLate(), lookupNewFiles(), ilUtil\now(), null, ilLanguage\txt(), ilExAssignment\TYPE_BLOG, ilExAssignment\TYPE_PORTFOLIO, ilExAssignment\TYPE_TEXT, ilExAssignment\TYPE_UPLOAD, ilExAssignment\TYPE_UPLOAD_TEAM, and ilExAssignment\TYPE_WIKI_TEAM.

                                                        : ?int
    {
        $ilDB = $this->db;

        // no text = remove submission
        if (!trim($a_text)) {
            $this->sub_manager->deleteAllSubmissionsOfUser($this->getUserId());
            return null;
        }

        $sub = $this->sub_manager->getSubmissionsOfUser($this->getUserId())->current();

        if (!$sub) {
            return $this->addResourceObject("TEXT", $a_text);
        } else {
            $id = $sub->getId();
            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 587 of file class.ilExSubmission.php.

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

Referenced by getLastDownloadTime().

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

validatePeerReviews()

ilExSubmission::validatePeerReviews

(

)

Definition at line 115 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 47 of file class.ilExSubmission.php.

$ass_types

ilExAssignmentTypes ilExSubmission::$ass_types

protected

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

$assignment

ilExAssignment ilExSubmission::$assignment

protected

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

Referenced by getAssignment().

$ctrl

ilCtrl ilExSubmission::$ctrl

protected

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

Referenced by updateTextSubmission().

$db

ilDBInterface ilExSubmission::$db

protected

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

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

$domain

ILIAS Exercise InternalDomainService ilExSubmission::$domain

protected

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

$is_tutor

bool ilExSubmission::$is_tutor

protected

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

Referenced by isTutor().

$lng

ilLanguage ilExSubmission::$lng

protected

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

Referenced by getLastDownloadTime(), and updateTextSubmission().

$main_tpl

ilGlobalTemplateInterface ilExSubmission::$main_tpl

private

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

$peer_review

ilExPeerReview ilExSubmission::$peer_review = null

protected

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

Referenced by getPeerReview().

$public_submissions

bool ilExSubmission::$public_submissions

protected

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

$state

ilExcAssMemberState ilExSubmission::$state

protected

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

$sub_manager

ILIAS Exercise Submission SubmissionManager ilExSubmission::$sub_manager

protected

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

$team

ilExAssignmentTeam ilExSubmission::$team = null

protected

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

Referenced by getTeam().

$user

ilObjUser ilExSubmission::$user

protected

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

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

$user_id

int ilExSubmission::$user_id

protected

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

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

TYPE_FILE

const ilExSubmission::TYPE_FILE = "File"

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

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

TYPE_OBJECT

const ilExSubmission::TYPE_OBJECT = "Object"

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

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

TYPE_REPO_OBJECT

const ilExSubmission::TYPE_REPO_OBJECT = "RepoObject"

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

Referenced by addResourceObject(), ILIAS\Exercise\Submission\SubmissionManager\copySubmissionsToDir(), ilExSubmissionGUI\executeCommand(), ilExcRepoObjAssignmentInfo\getInfo(), and ilExAssTypeWikiTeam\getSubmissionType().

TYPE_TEXT

const ilExSubmission::TYPE_TEXT = "Text"

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

Referenced by ilExAssTypeText\getSubmissionType().

---

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

• components/ILIAS/Exercise/Submission/class.ilExSubmission.php