ilExerciseManagementGUI: ilFileSystemGUI, ilRepositorySearchGUI ilExerciseManagementGUI: ilExSubmissionTeamGUI, ilExSubmissionFileGUI ilExerciseManagementGUI: ilExSubmissionTextGUI, ilExPeerReviewGUI ilExerciseManagementGUI: ilParticipantsPerAssignmentTableGUI ilExerciseManagementGUI: ilResourceCollectionGUI, ilRepoStandardUploadHandlerGUI More...

Collaboration diagram for ilExerciseManagementGUI:

Public Member Functions
	__construct (InternalService $service, ilExAssignment $a_ass=null)
	Constructor. More...

	executeCommand ()

	addSubTabs (string $a_activate)

	waitingDownloadObject ()

	membersObject ()
	All participants and submission of one assignment. More...

	downloadSelectedObject ()

	downloadSubmissionsObject (?array $selected_participants=null)

	backToCurrentOverview ()

	membersApplyObject ()

	membersResetObject ()

	saveGradesObject ()

	compareTextAssignmentsObject ()
	TODO -> Deal with the redirection after update the grade via action button. More...

	getReportPanel (array $a_data)

	getEvaluationModal (array $a_data)

	getEvaluationModalForm (array $a_data)

	saveEvaluationFromModalObject ()

	addUserFromAutoCompleteObject ()

	addMembersObject ($a_user_ids=array())

	selectAssignmentObject ()

	showParticipantObject ()
	Show Participant. More...

	showParticipantApplyObject ()

	showParticipantResetObject ()

	selectParticipantObject ()

	showGradesOverviewObject ()

	redirectFeedbackMailObject ()

	sendMembersObject ()

	confirmDeassignMembersObject ()

	deassignMembersObject ()

	removeUserSubmissionFilesFromWebDir (int $user_id)

	saveStatusParticipantObject (array $selected_ass_ids=null)
	Save assignment status (participant view) More...

	saveStatusAllObject (array $a_selected=null, bool $a_redirect=true)

	saveStatusSelectedObject ()

	saveCommentForLearnersObject ()

	exportExcelObject ()

	createTeamsObject ()

	dissolveTeamsObject ()

	adoptTeamsFromGroupObject (ilPropertyFormGUI $a_form=null)

	createTeamsFromGroupsObject ()

	getMultiFeedbackForm (int $a_ass_id)

	handleMultiFeedbackUploadResult (FileUpload $upload, UploadResult $result)

	showMultiFeedbackObject (FormAdapterGUI $form=null)

	downloadMultiFeedbackZipObject ()
	Download multi-feedback structrue file. More...

	uploadMultiFeedbackObject ()
	Upload multi feedback file. More...

	showMultiFeedbackConfirmationTableObject ()
	Show multi feedback confirmation table. More...

	cancelMultiFeedbackObject ()
	Cancel Multi Feedback. More...

	saveMultiFeedbackObject ()
	Save multi feedback. More...

	initFilter ()

	openSubmissionPrintViewObject ()
	Open HTML view for portfolio submissions. More...

	openSubmissionViewObject (bool $print_version=false)
	Open HTML view for portfolio submissions. More...

	collectFeedbackDataFromPeer (array $a_data)

	sendGradingNotificationObject ()

Data Fields
const	VIEW_ASSIGNMENT = 1

const	VIEW_PARTICIPANT = 2

const	VIEW_GRADES = 3

const	FEEDBACK_ONLY_SUBMISSION = "submission_only"

const	FEEDBACK_FULL_SUBMISSION = "submission_feedback"

const	GRADE_NOT_GRADED = "notgraded"

const	GRADE_PASSED = "passed"

const	GRADE_FAILED = "failed"

Protected Member Functions
	getViewBack ()

	initSubmission ()

	getMultiActionUserIds (bool $a_keep_teams=false)

	saveStatus (array $a_data, bool $a_redirect=true)

	initGroupForm ()

	initIndividualDeadlineModal ()

	parseIndividualDeadlineData (array $a_data)

	handleIndividualDeadlineCallsObject ()

	initIndividualDeadlineForm (array $a_ass_map, array $ids)

	setIndividualDeadlineObject ()

	getSubmissionZipFilePath (ilExSubmission $submission, bool $print_versions=false)
	Returns the ZIP file path from outside web directory. More...

	copyFileToWebDir (string $internal_file_path)
	Generate the directories and copy the file if necessary. More...

	getWebFilePathFromExternalFilePath (string $external_file_path)
	Get the object specific file path from an external full file path. More...

	setBackToMembers ()

	setFailedObject ()

	setPassedObject ()

	setSingleStatus ($ass_id, $part_id, $status)

Protected Attributes
ZipAdapter	$zip

ilGlobalTemplateInterface	$tpl

ILIAS Exercise InternalDomainService	$domain

ILIAS Exercise Notification NotificationManager	$notification

TutorFeedbackFileManager	$tutor_feedback_file

InternalGUIService	$gui

ILIAS HTTP Services	$http

ilCtrl	$ctrl

ilTabsGUI	$tabs_gui

ilLanguage	$lng

ilAccessHandler	$access

Factory	$ui_factory

Renderer	$ui_renderer

array	$filter = []

ilToolbarGUI	$toolbar

ilObjExercise	$exercise

ilExAssignment	$assignment = null

TaskFactory	$task_factory

ilLogger	$log

ilObjUser	$user

InternalService	$service

ilDBInterface	$db = null

int	$ass_id = 0

int	$requested_member_id = 0

int	$requested_part_id = 0

int	$requested_ass_id = 0

string	$requested_idl_id

bool	$done = false

array	$requested_learning_comments

string	$requested_comment

string	$requested_user_login

array	$selected_participants

array	$listed_participants

array	$selected_ass_ids

array	$listed_ass_ids

array	$requested_marks

array	$requested_status

array	$requested_tutor_notices

array	$requested_group_members

array	$requested_files

string	$requested_filter_status

string	$requested_filter_feedback

GUIRequest	$request

Detailed Description

ilExerciseManagementGUI: ilFileSystemGUI, ilRepositorySearchGUI ilExerciseManagementGUI: ilExSubmissionTeamGUI, ilExSubmissionFileGUI ilExerciseManagementGUI: ilExSubmissionTextGUI, ilExPeerReviewGUI ilExerciseManagementGUI: ilParticipantsPerAssignmentTableGUI ilExerciseManagementGUI: ilResourceCollectionGUI, ilRepoStandardUploadHandlerGUI

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

Constructor & Destructor Documentation

◆ __construct()

ilExerciseManagementGUI::__construct	(	InternalService	$service,
		ilExAssignment	$a_ass = `null`
	)

Constructor.

Parameters

InternalService	$service
ilExAssignment \| null	$a_ass

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

     {
         $this->service = $service;
         $this->gui = $gui = $service->gui();
         $this->domain = $domain = $service->domain();
 
         $this->user = $domain->user();
         $this->log = $domain->logger()->exc();
         $this->access = $domain->access();
         $this->lng = $domain->lng();
 
         $this->toolbar = $gui->toolbar();
         $this->ui_factory = $gui->ui()->factory();
         $this->ui_renderer = $gui->ui()->renderer();
         $this->ctrl = $gui->ctrl();
         $this->tabs_gui = $gui->tabs();
         $this->tpl = $gui->ui()->mainTemplate();
         $this->http = $gui->http();
 
         $this->task_factory = $domain->backgroundTasks()->taskFactory();
         $this->request = $gui->request();
         $request = $this->request;
 
         $this->exercise = $request->getExercise();
         if ($a_ass !== null) {
             $this->assignment = $a_ass;
             $this->ass_id = $this->assignment->getId();
         }
         $this->requested_member_id = $request->getMemberId();
         $this->requested_part_id = $request->getParticipantId();
         $this->requested_ass_id = $request->getAssId();
         $this->requested_idl_id = $request->getIdlId();
         $this->done = $request->getDone();
         $this->requested_learning_comments = $request->getLearningComments();
         $this->requested_comment = $request->getComment();
         $this->requested_user_login = $request->getUserLogin();
         $this->selected_participants = $request->getSelectedParticipants();
         $this->listed_participants = $request->getListedParticipants();
         $this->selected_ass_ids = $request->getSelectedAssignments();
         $this->listed_ass_ids = $request->getListedAssignments();
         $this->requested_marks = $request->getMarks();
         $this->requested_status = $request->getStatus();
         $this->requested_tutor_notices = $request->getTutorNotices();
         $this->requested_group_members = $request->getGroupMembers();
         $this->requested_files = $request->getFiles();
         $this->requested_filter_status = $request->getFilterStatus();
         $this->requested_filter_feedback = $request->getFilterFeedback();
 
         $this->notification = $domain->notification($request->getRefId());
 
         $this->ctrl->saveParameter($this, array("vw", "member_id"));
         if ($this->ass_id > 0) {
             $this->tutor_feedback_file = $domain->assignment()->tutorFeedbackFile($this->ass_id);
         }
         $this->zip = $domain->resources()->zip();
         $this->ctrl->saveParameter($this, array("part_id"));
     }

Here is the call graph for this function:

Member Function Documentation

◆ addMembersObject()

ilExerciseManagementGUI::addMembersObject ( $a_user_ids = array() )

Definition at line 955 of file class.ilExerciseManagementGUI.php.

References ILIAS\Repository\ctrl(), and ILIAS\Repository\lng().

Referenced by addUserFromAutoCompleteObject().

                                                            : void
     {
         if (!count($a_user_ids)) {
             $this->tpl->setOnScreenMessage('failure', $this->lng->txt("no_checkbox"), true);
         } else {
             if (!$this->exercise->members_obj->assignMembers($a_user_ids)) {
                 $this->tpl->setOnScreenMessage('failure', $this->lng->txt("exc_members_already_assigned"), true);
             } else {
                 $this->tpl->setOnScreenMessage('success', $this->lng->txt("exc_members_assigned"), true);
             }
         }
         $this->ctrl->redirect($this, "members");
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ addSubTabs()

ilExerciseManagementGUI::addSubTabs ( string $a_activate )

Definition at line 345 of file class.ilExerciseManagementGUI.php.

References $ctrl, $lng, $requested_part_id, $tabs_gui, and ilLanguage\txt().

Referenced by executeCommand(), membersObject(), showGradesOverviewObject(), showMultiFeedbackConfirmationTableObject(), showMultiFeedbackObject(), and showParticipantObject().

                                                   : void
     {
         $ilTabs = $this->tabs_gui;
         $lng = $this->lng;
         $ilCtrl = $this->ctrl;
 
         $ass_id = $this->assignment !== null ? $this->assignment->getId() : 0;
         $part_id = $this->requested_part_id;
 
         $ilCtrl->setParameter($this, "vw", "");
         $ilCtrl->setParameter($this, "member_id", "");
         $ilCtrl->setParameter($this, "ass_id", "");
         $ilCtrl->setParameter($this, "part_id", "");
 
         $ilTabs->addSubTab(
             "assignment",
             $lng->txt("exc_assignment_view"),
             $ilCtrl->getLinkTarget($this, "members")
         );
         $ilTabs->addSubTab(
             "participant",
             $lng->txt("exc_participant_view"),
             $ilCtrl->getLinkTarget($this, "showParticipant")
         );
         $ilTabs->addSubTab(
             "grades",
             $lng->txt("exc_grades_overview"),
             $ilCtrl->getLinkTarget($this, "showGradesOverview")
         );
         $ilTabs->activateSubTab($a_activate);
 
         $ilCtrl->setParameter($this, "ass_id", $ass_id);
         $ilCtrl->setParameter($this, "part_id", $part_id);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ addUserFromAutoCompleteObject()

ilExerciseManagementGUI::addUserFromAutoCompleteObject ( )

Exceptions

ilExcUnknownAssignmentTypeException

Definition at line 929 of file class.ilExerciseManagementGUI.php.

References ilObjUser\_lookupId(), addMembersObject(), ILIAS\Repository\lng(), and membersObject().

                                                    : void
     {
         if ($this->requested_user_login == "") {
             $this->tpl->setOnScreenMessage('failure', $this->lng->txt('msg_no_search_string'));
             $this->membersObject();
             return;
         }
         $users = explode(',', $this->requested_user_login);
 
         $user_ids = array();
         foreach ($users as $user) {
             $user_id = ilObjUser::_lookupId($user);
 
             if (!$user_id) {
                 $this->tpl->setOnScreenMessage('failure', $this->lng->txt('user_not_known'));
                 $this->membersObject();
                 return;
             }
 
             $user_ids[] = $user_id;
         }
 
         $this->addMembersObject($user_ids);
     }

Here is the call graph for this function:

◆ adoptTeamsFromGroupObject()

ilExerciseManagementGUI::adoptTeamsFromGroupObject ( ilPropertyFormGUI $a_form = null )

Definition at line 1644 of file class.ilExerciseManagementGUI.php.

References $ctrl, $lng, $tabs_gui, $tpl, getViewBack(), initGroupForm(), ilGlobalTemplateInterface\setContent(), and ilLanguage\txt().

Referenced by createTeamsFromGroupsObject().

      : void {
         $ilCtrl = $this->ctrl;
         $ilTabs = $this->tabs_gui;
         $lng = $this->lng;
         $tpl = $this->tpl;
 
         $ilTabs->clearTargets();
         $ilTabs->setBackTarget(
             $lng->txt("back"),
             $ilCtrl->getLinkTarget($this, $this->getViewBack())
         );
 
         if ($a_form === null) {
             $a_form = $this->initGroupForm();
         }
         $tpl->setContent($a_form->getHTML());
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ backToCurrentOverview()

ilExerciseManagementGUI::backToCurrentOverview ( )

Definition at line 543 of file class.ilExerciseManagementGUI.php.

References ILIAS\Repository\ctrl().

Referenced by downloadSelectedObject(), and downloadSubmissionsObject().

                                            : void
     {
         if ($this->assignment !== null) {
             $this->ctrl->redirect($this, "members");
         } else {
             $this->ctrl->redirect($this, "showParticipant");
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ cancelMultiFeedbackObject()

ilExerciseManagementGUI::cancelMultiFeedbackObject ( )

Cancel Multi Feedback.

Definition at line 1912 of file class.ilExerciseManagementGUI.php.

References ILIAS\Repository\ctrl().

                                                : void
     {
         $this->ctrl->redirect($this, "members");
     }

Here is the call graph for this function:

◆ collectFeedbackDataFromPeer()

ilExerciseManagementGUI::collectFeedbackDataFromPeer ( array $a_data )

Definition at line 2391 of file class.ilExerciseManagementGUI.php.

References $data, ilRTE\_replaceMediaObjectImageSrc(), ilObjUser\getFirstname(), and ilObjUser\getLastname().

Referenced by compareTextAssignmentsObject(), and saveGradesObject().

      : array {
         $user = new ilObjUser($a_data["user_id"]);
         $uname = $user->getFirstname() . " " . $user->getLastname();
 
         $data = array(
             "uid" => $a_data["user_id"],
             "uname" => $uname,
             "udate" => $a_data["ts"],
             "utext" => ilRTE::_replaceMediaObjectImageSrc($a_data["atext"], 1) // mob id to mob src
         );
 
         //get data peer and assign it
         $peer_review = new ilExPeerReview($this->assignment);
         $data["peer"] = array();
         foreach ($peer_review->getPeerReviewsByPeerId($a_data['user_id']) as $value) {
             $data["peer"][] = $value['giver_id'];
         }
 
         $data["fb_received"] = count($data["peer"]);
         $data["fb_given"] = $peer_review->countGivenFeedback(true, $a_data["user_id"]);
 
         return $data;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ compareTextAssignmentsObject()

ilExerciseManagementGUI::compareTextAssignmentsObject ( )

TODO -> Deal with the redirection after update the grade via action button.

Extract the data collection to another method. List and compare use this. DRY

Exceptions

ilDateTimeException|ilExcUnknownAssignmentTypeException

Definition at line 652 of file class.ilExerciseManagementGUI.php.

References $data, collectFeedbackDataFromPeer(), ILIAS\Repository\filter(), getMultiActionUserIds(), getReportPanel(), ILIAS\Repository\lng(), and setBackToMembers().

                                                   : void
     {
         $this->setBackToMembers();
 
         $group_panels_tpl = new ilTemplate("tpl.exc_group_report_panels.html", true, true, "Modules/Exercise");
         $group_panels_tpl->setVariable('TITLE', $this->lng->txt("exc_compare_selected_submissions"));
 
         $report_html = "";
         //participant ids selected via checkboxes
         $participants = array_keys($this->getMultiActionUserIds());
 
         $total_reports = 0;
         foreach ($participants as $participant_id) {
             $submission = new ilExSubmission($this->assignment, $participant_id);
 
             //submission data array
             $files = $submission->getFiles();
             $file = reset($files);
 
             if (!$file) {
                 $file = [
                     "user_id" => $participant_id,
                     "ts" => null,
                     "atext" => null
                 ];
             }
 
             $feedback_data = $this->collectFeedbackDataFromPeer($file);
 
             $submission_data = $this->assignment->getExerciseMemberAssignmentData((int) $file["user_id"], $this->filter["status"] ?? "");
 
             if (is_array($submission_data)) {
                 $data = array_merge($feedback_data, $submission_data);
                 $report_html .= $this->getReportPanel($data);
                 $total_reports++;
             }
         }
 
         $group_panels_tpl->setVariable('CONTENT', $report_html);
         $this->tpl->setContent($group_panels_tpl->get());
     }

Here is the call graph for this function:

◆ confirmDeassignMembersObject()

ilExerciseManagementGUI::confirmDeassignMembersObject ( )

Exceptions

ilExcUnknownAssignmentTypeException

Definition at line 1308 of file class.ilExerciseManagementGUI.php.

References $ctrl, $lng, $tpl, getMultiActionUserIds(), ilUserUtil\getNamePresentation(), ilGlobalTemplateInterface\setContent(), and ilLanguage\txt().

                                                   : void
     {
         $ilCtrl = $this->ctrl;
         $tpl = $this->tpl;
         $lng = $this->lng;
 
         $members = $this->getMultiActionUserIds();
 
         $cgui = new ilConfirmationGUI();
         $cgui->setFormAction($ilCtrl->getFormAction($this));
         $cgui->setHeaderText($lng->txt("exc_msg_sure_to_deassign_participant"));
         $cgui->setCancel($lng->txt("cancel"), "members");
         $cgui->setConfirm($lng->txt("remove"), "deassignMembers");
         foreach ($members as $k => $m) {
             $cgui->addItem(
                 "member_ids[]",
                 $k,
                 ilUserUtil::getNamePresentation((int) $k, false, false, "", true)
             );
         }
 
         $tpl->setContent($cgui->getHTML());
     }

Here is the call graph for this function:

◆ copyFileToWebDir()

ilExerciseManagementGUI::copyFileToWebDir ( string $internal_file_path )

protected

Generate the directories and copy the file if necessary.

Returns the copied file path.

Definition at line 2326 of file class.ilExerciseManagementGUI.php.

References $DIC, CLIENT_ID, and ILIAS_WEB_DIR.

Referenced by openSubmissionViewObject().

      : ?string {
         global $DIC;
 
         $web_filesystem = $DIC->filesystem()->web();
         $data_filesystem = $DIC->filesystem()->storage();
 
         $internal_dirs = dirname($internal_file_path);
         $zip_file = basename($internal_file_path);
 
         if ($data_filesystem->has($internal_file_path)) {
             $this->log->debug("internal file path: " . $internal_file_path);
             if ($web_filesystem->hasDir($internal_dirs)) {
                 $web_filesystem->deleteDir($internal_dirs);
             }
             $web_filesystem->createDir($internal_dirs);
 
             if ($web_filesystem->has($internal_file_path)) {
                 $web_filesystem->delete($internal_file_path);
             }
             if (!$web_filesystem->has($internal_file_path)) {
                 $this->log->debug("writing: " . $internal_file_path);
                 $stream = $data_filesystem->readStream($internal_file_path);
                 $web_filesystem->writeStream($internal_file_path, $stream);
 
                 return ILIAS_ABSOLUTE_PATH .
                     DIRECTORY_SEPARATOR .
                     ILIAS_WEB_DIR .
                     DIRECTORY_SEPARATOR .
                     CLIENT_ID .
                     DIRECTORY_SEPARATOR .
                     $internal_dirs .
                     DIRECTORY_SEPARATOR .
                     $zip_file;
             }
         }
 
         return null;
     }

Here is the caller graph for this function:

◆ createTeamsFromGroupsObject()

ilExerciseManagementGUI::createTeamsFromGroupsObject ( )

Exceptions

ilExcUnknownAssignmentTypeException

Definition at line 1708 of file class.ilExerciseManagementGUI.php.

References $lng, $requested_group_members, $valid, adoptTeamsFromGroupObject(), ILIAS\Repository\ctrl(), ilExAssignmentTeam\getAssignmentTeamMap(), ilExAssignmentTeam\getGroupMembersMap(), ilExAssignmentTeam\getInstanceByUserId(), ilUserUtil\getNamePresentation(), initGroupForm(), and ilLanguage\txt().

                                                  : void
     {
         $lng = $this->lng;
 
         $req_members = $this->requested_group_members;
 
         $form = $this->initGroupForm();
         if ($form->checkInput()) {
             $map = ilExAssignmentTeam::getGroupMembersMap($this->exercise->getRefId());
             $all_members = $teams = array();
             $valid = true;
             foreach (array_keys($map) as $grp_id) {
                 if (isset($req_members[$grp_id]) && is_array($req_members[$grp_id])) {
                     $members = $req_members[$grp_id];
                     $teams[] = $members;
                     $invalid_team_members = array();
 
                     foreach ($members as $user_id) {
                         if (!array_key_exists($user_id, $all_members)) {
                             $all_members[$user_id] = $grp_id;
                         } else {
                             // user is selected in multiple groups
                             $invalid_team_members[] = $user_id;
                         }
                     }
 
                     if ($invalid_team_members !== []) {
                         $valid = false;
 
                         $alert = array();
                         foreach ($invalid_team_members as $user_id) {
                             $user_name = ilUserUtil::getNamePresentation($user_id, false, false, "", true);
                             $grp_title = $map[$all_members[$user_id]]["title"];
                             $alert[] = sprintf($lng->txt("exc_adopt_group_teams_conflict"), $user_name, $grp_title);
                         }
                         $input = $form->getItemByPostVar("grpt[" . $grp_id . "]");
                         $input->setAlert(implode("<br/>", $alert));
                     }
                 }
             }
             if ($valid) {
                 if ($teams !== []) {
                     $existing_users = array_keys(ilExAssignmentTeam::getAssignmentTeamMap($this->assignment->getId()));
 
                     // create teams from group selections
                     $sum = array("added" => 0, "blocked" => 0);
                     foreach ($teams as $members) {
                         foreach ($members as $user_id) {
                             if (!$this->exercise->members_obj->isAssigned($user_id)) {
                                 $this->exercise->members_obj->assignMember($user_id);
                             }
 
                             if (!in_array($user_id, $existing_users)) {
                                 $sum["added"]++;
                             } else {
                                 $sum["blocked"]++;
                             }
                         }
 
                         $first = array_shift($members);
                         $team = ilExAssignmentTeam::getInstanceByUserId($this->assignment->getId(), $first, true);
 
                         // getTeamId() does NOT send notification
                         // $team->sendNotification($this->exercise->getRefId(), $first, "add");
 
                         foreach ($members as $user_id) {
                             $team->addTeamMember($user_id);
                         }
                     }
 
                     $mess = array();
                     if ($sum["added"] !== 0) {
                         $mess[] = sprintf($lng->txt("exc_adopt_group_teams_added"), $sum["added"]);
                     }
                     if ($sum["blocked"] !== 0) {
                         $mess[] = sprintf($lng->txt("exc_adopt_group_teams_blocked"), $sum["blocked"]);
                     }
                     if ($sum["added"] !== 0) {
                         $this->tpl->setOnScreenMessage('success', implode(" ", $mess), true);
                     } else {
                         $this->tpl->setOnScreenMessage('failure', implode(" ", $mess), true);
                     }
                 }
                 $this->ctrl->redirect($this, "members");
             } else {
                 $this->tpl->setOnScreenMessage('failure', $lng->txt("form_input_not_valid"));
             }
         }
 
         $form->setValuesByPost();
         $this->adoptTeamsFromGroupObject($form);
     }

Here is the call graph for this function:

◆ createTeamsObject()

ilExerciseManagementGUI::createTeamsObject ( )

Exceptions

ilExcUnknownAssignmentTypeException

Definition at line 1564 of file class.ilExerciseManagementGUI.php.

References $ctrl, ilExAssignmentTeam\getInstanceByUserId(), getMultiActionUserIds(), and ILIAS\Repository\lng().

                                        : void
     {
         $ilCtrl = $this->ctrl;
 
         $members = $this->getMultiActionUserIds(true);
 
         $new_members = array();
 
         foreach ($members as $group) {
             if (is_array($group)) {
                 $new_members = array_merge($new_members, $group);
 
                 $first_user = $group;
                 $first_user = array_shift($first_user);
                 $team = ilExAssignmentTeam::getInstanceByUserId($this->assignment->getId(), $first_user);
                 foreach ($group as $user_id) {
                     $team->removeTeamMember($user_id);
                 }
             } else {
                 $new_members[] = $group;
             }
         }
 
         if ($new_members !== []) {
             // see ilExSubmissionTeamGUI::addTeamMemberActionObject()
 
             $first_user = array_shift($new_members);
             $team = ilExAssignmentTeam::getInstanceByUserId($this->assignment->getId(), $first_user, true);
             foreach ($new_members as $user_id) {
                 $team->addTeamMember($user_id);
             }
 
             // re-evaluate complete team, as some members might have had submitted
             $submission = new ilExSubmission($this->assignment, $first_user);
             $this->exercise->processExerciseStatus(
                 $this->assignment,
                 $team->getMembers(),
                 $submission->hasSubmitted(),
                 $submission->validatePeerReviews()
             );
         }
 
         $this->tpl->setOnScreenMessage('success', $this->lng->txt("msg_obj_modified"), true);
         $ilCtrl->redirect($this, "members");
     }

Here is the call graph for this function:

◆ deassignMembersObject()

ilExerciseManagementGUI::deassignMembersObject ( )

Exceptions

ilExcUnknownAssignmentTypeException

Definition at line 1337 of file class.ilExerciseManagementGUI.php.

References $ctrl, $lng, removeUserSubmissionFilesFromWebDir(), and ilLanguage\txt().

                                            : void
     {
         $ilCtrl = $this->ctrl;
         $lng = $this->lng;
 
         $member_ids = $this->request->getMemberIds();
 
         foreach ($member_ids as $usr_id) {
             $this->exercise->members_obj->deassignMember((int) $usr_id);
             $this->removeUserSubmissionFilesFromWebDir((int) $usr_id);
         }
         $this->tpl->setOnScreenMessage('success', $lng->txt("exc_msg_participants_removed"), true);
         $ilCtrl->redirect($this, "members");
     }

Here is the call graph for this function:

◆ dissolveTeamsObject()

ilExerciseManagementGUI::dissolveTeamsObject ( )

Exceptions

ilExcUnknownAssignmentTypeException

Definition at line 1613 of file class.ilExerciseManagementGUI.php.

References $ctrl, ilExAssignmentTeam\getInstanceByUserId(), getMultiActionUserIds(), and ILIAS\Repository\lng().

                                          : void
     {
         $ilCtrl = $this->ctrl;
 
         $members = $this->getMultiActionUserIds(true);
 
         foreach ($members as $group) {
             // if single member - nothing to do
             if (is_array($group)) {
                 // see ilExSubmissionTeamGUI::removeTeamMemberObject()
 
                 $first_user = $group;
                 $first_user = array_shift($first_user);
                 $team = ilExAssignmentTeam::getInstanceByUserId($this->assignment->getId(), $first_user);
                 foreach ($group as $user_id) {
                     $team->removeTeamMember($user_id);
                 }
 
                 // reset ex team members, as any submission is not valid without team
                 $this->exercise->processExerciseStatus(
                     $this->assignment,
                     $group,
                     false
                 );
             }
         }
 
         $this->tpl->setOnScreenMessage('success', $this->lng->txt("msg_obj_modified"), true);
         $ilCtrl->redirect($this, "members");
     }

Here is the call graph for this function:

◆ downloadMultiFeedbackZipObject()

ilExerciseManagementGUI::downloadMultiFeedbackZipObject ( )

Download multi-feedback structrue file.

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

                                                     : void
     {
         $st_file = $this->domain->assignment()->tutorFeedbackZip()->getMultiFeedbackStructureFile(
             $this->assignment,
             $this->exercise
         );
         $this->gui->httpUtil()->deliverString(
             $st_file->content,
             $st_file->filename,
             "application/zip"
         );
     }

◆ downloadSelectedObject()

ilExerciseManagementGUI::downloadSelectedObject ( )

Definition at line 515 of file class.ilExerciseManagementGUI.php.

References backToCurrentOverview(), and downloadSubmissionsObject().

                                             : void
     {
         if (count($this->selected_participants) > 0) {
             $this->downloadSubmissionsObject($this->selected_participants);
         } else {
             $this->backToCurrentOverview();
         }
     }

Here is the call graph for this function:

◆ downloadSubmissionsObject()

ilExerciseManagementGUI::downloadSubmissionsObject ( ?array $selected_participants = null )

Definition at line 523 of file class.ilExerciseManagementGUI.php.

References $ass_id, $GLOBALS, $requested_part_id, $selected_participants, backToCurrentOverview(), ILIAS\Survey\Mode\getId(), ILIAS\Repository\lng(), and ILIAS\Repository\user().

Referenced by downloadSelectedObject().

                                                                                    : void
     {
         $participant_id = $this->requested_part_id;
 
         $download_task = new ilDownloadSubmissionsBackgroundTask(
             (int) $GLOBALS['DIC']->user()->getId(),
             $this->exercise->getRefId(),
             $this->exercise->getId(),
             $this->ass_id,
             $participant_id,
             $selected_participants
         );
 
         if ($download_task->run()) {
             $this->tpl->setOnScreenMessage('success', $this->lng->txt('exc_down_files_started_bg'), true);
         }
 
         $this->backToCurrentOverview();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ executeCommand()

ilExerciseManagementGUI::executeCommand ( )

Exceptions

ilCtrlException
ilExcUnknownAssignmentTypeException

Definition at line 166 of file class.ilExerciseManagementGUI.php.

References $ctrl, $GLOBALS, $lng, $ref_id, $requested_member_id, $tabs_gui, addSubTabs(), ILIAS\Exercise\InternalGUIService\assignment(), ilFSStorageExercise\create(), ILIAS\Repository\ctrl(), getMultiFeedbackForm(), ilUserUtil\getNamePresentation(), getViewBack(), initSubmission(), ILIAS\Repository\lng(), ILIAS\UI\examples\Symbol\Glyph\Notification\notification(), ilFileSystemGUI\setTableId(), and ilLanguage\txt().

                                     : void
     {
         $ilCtrl = $this->ctrl;
         $lng = $this->lng;
         $ilTabs = $this->tabs_gui;
 
         $class = $ilCtrl->getNextClass($this);
         //$cmd = $ilCtrl->getCmd("listPublicSubmissions");
 
         switch ($class) {
             // feedback files IRSS
             case strtolower(ilResourceCollectionGUI::class):
                 $ilTabs->clearTargets();
                 $ilTabs->setBackTarget(
                     $lng->txt("back"),
                     $ilCtrl->getLinkTarget($this, $this->getViewBack())
                 );
                 $this->domain->assignment()->tutorFeedbackFile($this->ass_id)->addObserver();
                 $this->tpl->setOnScreenMessage('info', $lng->txt("exc_fb_tutor_info"));
                 $gui = $this->gui->assignment()->getTutorFeedbackFileResourceCollectionGUI(
                     $this->exercise->getRefId(),
                     $this->assignment->getId(),
                     $this->requested_member_id
                 );
                 $this->ctrl->forwardCommand($gui);
                 break;
 
                 // feedback files LEGACY
             case "ilfilesystemgui":
                 $ilTabs->clearTargets();
                 $ilTabs->setBackTarget(
                     $lng->txt("back"),
                     $ilCtrl->getLinkTarget($this, $this->getViewBack())
                 );
 
                 $this->tpl->setOnScreenMessage('info', $lng->txt("exc_fb_tutor_info"));
 
                 $fstorage = new ilFSStorageExercise($this->exercise->getId(), $this->assignment->getId());
                 $fstorage->create();
 
                 $submission = new ilExSubmission($this->assignment, $this->requested_member_id);
                 $feedback_id = $submission->getFeedbackId();
                 $noti_rec_ids = $submission->getUserIds();
 
                 $fs_title = array();
                 foreach ($noti_rec_ids as $rec_id) {
                     $fs_title[] = ilUserUtil::getNamePresentation($rec_id, false, false, "", true);
                 }
                 $fs_title = implode(" / ", $fs_title);
 
                 $fs_gui = new ilFileSystemGUI($fstorage->getFeedbackPath($feedback_id));
                 $fs_gui->setTableId("excfbfil" . $this->assignment->getId() . "_" . $feedback_id);
                 $fs_gui->setAllowDirectories(false);
                 $fs_gui->setTitle($lng->txt("exc_fb_files") . " - " .
                     $this->assignment->getTitle() . " - " .
                     $fs_title);
                 $pcommand = $fs_gui->getLastPerformedCommand();
                 if (is_array($pcommand) && ($pcommand["cmd"] ?? "") == "create_file") {
                     foreach ($noti_rec_ids as $user_id) {
                         $member_status = $this->assignment->getMemberStatus($user_id);
                         $member_status->setFeedback(true);
                         $member_status->update();
                     }
 
                     $this->notification->sendFeedbackNotification(
                         $this->assignment->getId(),
                         $noti_rec_ids,
                         $pcommand["name"] ?? ""
                     );
                 }
                 $this->ctrl->forwardCommand($fs_gui);
                 break;
 
             case 'ilrepositorysearchgui':
                 $rep_search = new ilRepositorySearchGUI();
                 $ref_id = $this->exercise->getRefId();
                 $rep_search->addUserAccessFilterCallable(function ($a_user_ids) use ($ref_id) {
                     return $GLOBALS['DIC']->access()->filterUserIdsByRbacOrPositionOfCurrentUser(
                         'edit_submissions_grades',
                         'edit_submissions_grades',
                         $ref_id,
                         $a_user_ids
                     );
                 });
                 $rep_search->setTitle($this->lng->txt("exc_add_participant"));
                 $rep_search->setCallback($this, 'addMembersObject');
 
                 // Set tabs
                 $this->addSubTabs("assignment");
                 $this->ctrl->setReturn($this, 'members');
 
                 $this->ctrl->forwardCommand($rep_search);
                 break;
 
             case strtolower(ilRepoStandardUploadHandlerGUI::class):
                 $form = $this->getMultiFeedbackForm($this->assignment->getId());
                 $gui = $form->getRepoStandardUploadHandlerGUI("mfzip");
                 $this->ctrl->forwardCommand($gui);
                 break;
 
             case "ilexsubmissionteamgui":
                 $gui = new ilExSubmissionTeamGUI($this->exercise, $this->initSubmission());
                 $ilCtrl->forwardCommand($gui);
                 break;
 
             case "ilexsubmissionfilegui":
                 $gui = new ilExSubmissionFileGUI($this->exercise, $this->initSubmission());
                 $ilCtrl->forwardCommand($gui);
                 break;
 
             case "ilexsubmissiontextgui":
                 $ilCtrl->saveParameter($this, array("part_id"));
                 $gui = new ilExSubmissionTextGUI($this->exercise, $this->initSubmission());
                 $ilCtrl->forwardCommand($gui);
                 break;
 
             case "ilexpeerreviewgui":
                 $gui = new ilExPeerReviewGUI($this->assignment, $this->initSubmission());
                 $ilCtrl->forwardCommand($gui);
                 break;
 
             case "ilparticipantsperassignmenttablegui":
                 $table = new ilParticipantsPerAssignmentTableGUI(
                     $this,
                     "members",
                     $this->exercise,
                     $this->assignment->getId()
                 );
                 $this->ctrl->forwardCommand($table);
                 break;
 
             default:
                 $cmd = $ilCtrl->getCmd();
                 switch ($cmd) {
                     case 'downloadSubmissions':
                         $cmd = $ilCtrl->getCmd("downloadSubmissions");
                         break;
                     default:
                         $cmd = $ilCtrl->getCmd("listPublicSubmissions");
                         break;
                 }
                 $this->{$cmd . "Object"}();
                 break;
         }
     }

Here is the call graph for this function:

◆ exportExcelObject()

ilExerciseManagementGUI::exportExcelObject ( )

Definition at line 1550 of file class.ilExerciseManagementGUI.php.

References exit.

                                        : void
     {
         $this->exercise->exportGradesExcel();
         exit;
     }

◆ getEvaluationModal()

ilExerciseManagementGUI::getEvaluationModal ( array $a_data )

Definition at line 812 of file class.ilExerciseManagementGUI.php.

References $id, getEvaluationModalForm(), ILIAS\Repository\lng(), and ILIAS\UI\Implementation\Component\withOnLoadCode().

Referenced by getReportPanel().

      : RoundTrip {
         $modal_tpl = new ilTemplate("tpl.exc_report_evaluation_modal.html", true, true, "Modules/Exercise");
         $modal_tpl->setVariable("USER_NAME", $a_data['uname']);
 
         $form = $this->getEvaluationModalForm($a_data);
         //TODO: CHECK ilias string utils. ilUtil shortenText with net blank.
         if ($this->exercise->hasTutorFeedbackText()) {
             $max_chars = 500;
 
             $u_text = strip_tags($a_data["utext"]); //otherwise will get open P
             $text = $u_text;
             //show more
             if (strlen($u_text) > $max_chars) {
                 $text = "<input type='checkbox' class='read-more-state' id='post-1' />";
                 $text .= "<div class='read-more-wrap'>";
                 $text .= mb_substr($u_text, 0, $max_chars);
                 $text .= "<span class='read-more-target'>";
                 $text .= mb_substr($u_text, $max_chars);
                 $text .= "</span></div>";
                 $text .= "<label for='post-1' class='read-more-trigger'></label>";
             }
             $modal_tpl->setVariable("USER_TEXT", $text);
         }
 
         $modal_tpl->setVariable("FORM", $form->getHTML());
 
         $form_id = 'form_' . $form->getId();
         $submit_btn = $this->ui_factory->button()->primary($this->lng->txt("save"), '#')
             ->withOnLoadCode(function ($id) use ($form_id) {
                 return "$('#$id').click(function() { $('#$form_id').submit(); return false; });";
             });
 
         return  $this->ui_factory->modal()->roundtrip(strtoupper($this->lng->txt("grade_evaluate")), $this->ui_factory->legacy($modal_tpl->get()))->withActionButtons([$submit_btn]);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getEvaluationModalForm()

ilExerciseManagementGUI::getEvaluationModalForm ( array $a_data )

Definition at line 849 of file class.ilExerciseManagementGUI.php.

References ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), ilFormPropertyGUI\setInfo(), and ilSelectInputGUI\setOptions().

Referenced by getEvaluationModal(), and saveEvaluationFromModalObject().

      : ilPropertyFormGUI {
         $form = new ilPropertyFormGUI();
         $form->setFormAction($this->ctrl->getFormAction($this, "saveEvaluationFromModal"));
         $form->setId(uniqid('form'));
 
         //Grade
         $options = array(
             self::GRADE_NOT_GRADED => $this->lng->txt("exc_notgraded"),
             self::GRADE_PASSED => $this->lng->txt("exc_passed"),
             self::GRADE_FAILED => $this->lng->txt("exc_failed")
         );
         $si = new ilSelectInputGUI($this->lng->txt("exc_tbl_status"), "grade");
         $si->setOptions($options);
         $si->setValue($a_data['status'] ?? "");
         $form->addItem($si);
 
         //Mark
         $mark_input = new ilTextInputGUI($this->lng->txt("exc_tbl_mark"), "mark");
         $mark_input->setValue($a_data['mark'] ?? "");
         $mark_input->setMaxLength(32);
         $mark_input->setSize(4);
         $form->addItem($mark_input);
 
         $item = new ilHiddenInputGUI('mem_id');
         $item->setValue($a_data['uid'] ?? "");
         $form->addItem($item);
 
         //TODO: CHECK ilias string utils. ilUtil shortenText with net blank.
         if ($this->exercise->hasTutorFeedbackText()) {
             $ta = new ilTextAreaInputGUI($this->lng->txt("exc_comment"), 'comment');
             $ta->setInfo($this->lng->txt("exc_comment_for_learner_info"));
             $ta->setValue($a_data['comment'] ?? "");
             $ta->setRows(10);
             $form->addItem($ta);
         }
         return $form;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getMultiActionUserIds()

ilExerciseManagementGUI::getMultiActionUserIds ( bool $a_keep_teams = false )

protected

Exceptions

ilExcUnknownAssignmentTypeException

Definition at line 1226 of file class.ilExerciseManagementGUI.php.

References $ass_id, $requested_part_id, ILIAS\Repository\ctrl(), and ILIAS\Repository\lng().

Referenced by compareTextAssignmentsObject(), confirmDeassignMembersObject(), createTeamsObject(), dissolveTeamsObject(), redirectFeedbackMailObject(), sendMembersObject(), setFailedObject(), and setPassedObject().

                                                                         : array
     {
         $members = [];
         // multi-user
         if ($this->assignment !== null) {
             if (count($this->selected_participants) == 0) {
                 $this->tpl->setOnScreenMessage('failure', $this->lng->txt("no_checkbox"), true);
                 $this->ctrl->redirect($this, "members");
             }
 
             foreach ($this->selected_participants as $user_id) {
                 $submission = new ilExSubmission($this->assignment, $user_id);
                 $tmembers = $submission->getUserIds();
                 if (!$a_keep_teams) {
                     foreach ($tmembers as $tuser_id) {
                         $members[$tuser_id] = 1;
                     }
                 } else {
                     if ($tmembers) {
                         $members[] = $tmembers;
                     } else {
                         // no team yet
                         $members[] = $user_id;
                     }
                 }
             }
         }
         // multi-ass
         else {
             if (count($this->selected_ass_ids) == 0) {
                 $this->tpl->setOnScreenMessage('failure', $this->lng->txt("no_checkbox"), true);
                 $this->ctrl->redirect($this, "showParticipant");
             }
 
             $user_id = $this->requested_part_id;
 
             foreach ($this->selected_ass_ids as $ass_id) {
                 $submission = new ilExSubmission(new ilExAssignment($ass_id), $user_id);
                 $tmembers = $submission->getUserIds();
                 if (!$a_keep_teams) {
                     foreach ($tmembers as $tuser_id) {
                         $members[$ass_id][] = $tuser_id;
                     }
                 } else {
                     if ($tmembers) {
                         $members[$ass_id][] = $tmembers;
                     } else {
                         // no team yet
                         $members[$ass_id][] = $user_id;
                     }
                 }
             }
         }
 
         return $members;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getMultiFeedbackForm()

ilExerciseManagementGUI::getMultiFeedbackForm ( int $a_ass_id )

Definition at line 1806 of file class.ilExerciseManagementGUI.php.

References $lng, handleMultiFeedbackUploadResult(), ilExAssignment\lookupTitle(), and ilLanguage\txt().

Referenced by executeCommand(), showMultiFeedbackObject(), and uploadMultiFeedbackObject().

                                                        : FormAdapterGUI
     {
         $lng = $this->lng;
 
         $form = $this->gui->form([self::class], "uploadMultiFeedback")
             ->section("main", ilExAssignment::lookupTitle($a_ass_id))
             ->file(
                 "mfzip",
                 $lng->txt("exc_multi_feedback_file"),
                 $this->handleMultiFeedbackUploadResult(...),
                 "rc_id",
                 "",
                 1,
                 ["application/zip"]
             );
         return $form;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getReportPanel()

ilExerciseManagementGUI::getReportPanel ( array $a_data )

Exceptions

ilDateTimeException

Definition at line 697 of file class.ilExerciseManagementGUI.php.

References $comment, ILIAS\LTI\ToolProvider\$key, ilObject\_lookupType(), ILIAS\Repository\ctrl(), ILIAS\Repository\filter(), ilDatePresentation\formatDate(), getEvaluationModal(), ilObjUser\getFirstname(), ilObjUser\getLastname(), IL_CAL_DATETIME, and ILIAS\Repository\lng().

Referenced by compareTextAssignmentsObject(), and saveGradesObject().

                                                  : string
     {
         $modal = $this->getEvaluationModal($a_data);
 
         $this->ctrl->setParameter($this, "member_id", $a_data['uid']);
         $actions = array(
             $this->ui_factory->button()->shy($this->lng->txt("grade_evaluate"), "#")->withOnClick($modal->getShowSignal())
         );
 
         if ($this->exercise->hasTutorFeedbackMail()) {
             $actions[] = $this->ui_factory->button()->shy(
                 $this->lng->txt("exc_tbl_action_feedback_mail"),
                 $this->ctrl->getLinkTarget($this, "redirectFeedbackMail")
             );
         }
         if ($this->exercise->hasTutorFeedbackFile()) {
             $actions[] = $this->ui_factory->button()->shy(
                 $this->lng->txt("exc_tbl_action_feedback_file"),
                 $this->ctrl->getLinkTargetByClass("ilFileSystemGUI", "listFiles")
             );
         }
 
         $this->ctrl->setParameter($this, "member_id", "");
 
         $actions_dropdown = $this->ui_factory->dropdown()->standard($actions);
         if ($a_data['status'] == self::GRADE_NOT_GRADED) {
             $str_status_key = $this->lng->txt('exc_tbl_status') . ": ";
             $str_status_value = "-";
         } else {
             $str_status_key = $this->lng->txt('exc_tbl_status_time') . ": ";
             $str_status_value = ilDatePresentation::formatDate(new ilDateTime($a_data["status_time"], IL_CAL_DATETIME));
         }
 
         $str_mark_key = $this->lng->txt("exc_tbl_mark") . ": ";
         $str_mark_value = "-";
 
         if (($a_data['mark'] != "")) {
             $str_mark_value = $a_data['mark'];
         }
 
         if ($a_data['feedback_time']) {
             $str_evaluation_key = $this->lng->txt('exc_tbl_feedback_time') . ": ";
             $str_evaluation_value = ilDatePresentation::formatDate(new ilDateTime($a_data["feedback_time"], IL_CAL_DATETIME));
         } else {
             $str_evaluation_key = $this->lng->txt('exc_settings_feedback') . ": ";
             $str_evaluation_value = "-";
         }
 
         $card_content = array(
             $this->lng->txt("exc_tbl_submission_date") . ": " => ilDatePresentation::formatDate(new ilDateTime($a_data["udate"], IL_CAL_DATETIME)),
             $str_status_key => $str_status_value,
             $str_mark_key => $str_mark_value,
             $str_evaluation_key => $str_evaluation_value,
             $this->lng->txt('feedback_given') . ": " => $a_data['fb_given'],
             $this->lng->txt('feedback_received') . ": " => $a_data['fb_received']
         );
         $card_tpl = new ilTemplate("tpl.exc_report_details_card.html", true, true, "Modules/Exercise");
         foreach ($card_content as $key => $value) {
             $card_tpl->setCurrentBlock("assingment_card");
             $card_tpl->setVariable("ROW_KEY", $key);
             $card_tpl->setVariable("ROW_VALUE", $value);
             $card_tpl->parseCurrentBlock();
         }
 
         $main_panel = $this->ui_factory->panel()->sub($a_data['uname'], $this->ui_factory->legacy($a_data['utext']))
             ->withFurtherInformation($this->ui_factory->card()->standard($this->lng->txt('text_assignment'))->withSections(array($this->ui_factory->legacy($card_tpl->get()))))->withActions($actions_dropdown);
 
         $feedback_tpl = new ilTemplate("tpl.exc_report_feedback.html", true, true, "Modules/Exercise");
         //if no feedback filter the feedback is displayed. Can be list submissions or compare submissions.
         $filter_feedback = $this->filter["feedback"] ?? "";
         if (array_key_exists("peer", $a_data) && (($filter_feedback == self::FEEDBACK_FULL_SUBMISSION) || $filter_feedback == "")) {
             $feedback_tpl->setCurrentBlock("feedback");
             foreach ($a_data["peer"] as $peer_id) {
                 if (ilObject::_lookupType($peer_id) == "usr") {
                     $user = new ilObjUser($peer_id);
                     $peer_name = $user->getFirstname() . " " . $user->getLastname();
                 } else {
                     $peer_name = $this->lng->txt("exc_deleted_user");
                 }
 
                 $feedback_tpl->setCurrentBlock("peer_feedback");
                 $feedback_tpl->setVariable("PEER_NAME", $peer_name);
 
                 $submission = new ilExSubmission($this->assignment, $a_data["uid"]);
                 $values = $submission->getPeerReview()->getPeerReviewValues($peer_id, $a_data["uid"]);
 
                 $review_html = "";
                 foreach ($this->assignment->getPeerReviewCriteriaCatalogueItems() as $crit) {
                     $crit_id = $crit->getId()
                         ? $crit->getId()
                         : $crit->getType();
                     $crit->setPeerReviewContext($this->assignment, $peer_id, $a_data["uid"]);
 
                     $review_html .=
                         '<div class="ilBlockPropertyCaption">' . $crit->getTitle() . '</div>' .
                         '<div style="margin:2px 0;">' . $crit->getHTML($values[$crit_id] ?? null) . '</div>';
                 }
                 $feedback_tpl->setVariable("PEER_FEEDBACK", $review_html);
                 $feedback_tpl->parseCurrentBlock();
             }
             $feedback_tpl->parseCurrentBlock();
         }
         $feedback_tpl->setVariable("GRADE", $this->lng->txt('exc_grading') . ": " . $this->lng->txt('exc_' . $a_data['status']));
         $comment = ($a_data['comment'] === "")
             ? "-"
             : $a_data['comment'];
         $feedback_tpl->setVariable("COMMENT", $this->lng->txt('exc_comment') . ": <br>" . $comment);
 
         $feedback_panel = $this->ui_factory->panel()->sub("", $this->ui_factory->legacy($feedback_tpl->get()));
 
         $report = $this->ui_factory->panel()->report("", array($main_panel, $feedback_panel));
 
         return $this->ui_renderer->render([$modal,$report]);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSubmissionZipFilePath()

ilExerciseManagementGUI::getSubmissionZipFilePath	(	ilExSubmission	$submission,
		bool	$print_versions = `false`
	)

protected

Returns the ZIP file path from outside web directory.

Parameters

ilExSubmission user who created the submission

Returns: string|null

Definition at line 2303 of file class.ilExerciseManagementGUI.php.

References ilExSubmission\getFiles().

Referenced by openSubmissionViewObject().

      : ?string {
         $submitted = $submission->getFiles(
             null,
             false,
             null,
             $print_versions
         );
         if ($submitted !== []) {
             $submitted = array_pop($submitted);
 
             return $submitted['filename'];
         }
 
         return null;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getViewBack()

ilExerciseManagementGUI::getViewBack ( )

protected

Definition at line 312 of file class.ilExerciseManagementGUI.php.

Referenced by adoptTeamsFromGroupObject(), executeCommand(), initSubmission(), redirectFeedbackMailObject(), saveStatus(), and sendGradingNotificationObject().

                                     : string
     {
         switch ($this->request->getBackView()) {
             case self::VIEW_PARTICIPANT:
                 $back_cmd = "showParticipant";
                 break;
 
             case self::VIEW_GRADES:
                 $back_cmd = "showGradesOverview";
                 break;
 
             default:
                 // case self::VIEW_ASSIGNMENT:
                 $back_cmd = "members";
                 break;
         }
         return $back_cmd;
     }

Here is the caller graph for this function:

◆ getWebFilePathFromExternalFilePath()

ilExerciseManagementGUI::getWebFilePathFromExternalFilePath ( string $external_file_path )

protected

Get the object specific file path from an external full file path.

Definition at line 2370 of file class.ilExerciseManagementGUI.php.

References CLIENT_ID.

Referenced by openSubmissionViewObject().

      : string {
         list($external_path, $internal_file_path) = explode(CLIENT_ID . "/ilExercise", $external_file_path);
         $internal_file_path = "ilExercise" . $internal_file_path;
         return $internal_file_path;
     }

Here is the caller graph for this function:

◆ handleIndividualDeadlineCallsObject()

ilExerciseManagementGUI::handleIndividualDeadlineCallsObject ( )

protected

Exceptions

ilExcUnknownAssignmentTypeException
ilDateTimeException

Definition at line 1996 of file class.ilExerciseManagementGUI.php.

References $ass_id, $id, $post, $res, $tpl, $valid, ilDateTime\_before(), ILIAS\Repository\ctrl(), exit, ilDatePresentation\formatDate(), ilGlobalTemplateInterface\getOnLoadCodeForAsynch(), ILIAS\FileDelivery\http(), IL_CAL_UNIX, initIndividualDeadlineForm(), ILIAS\Repository\lng(), ILIAS\UI\examples\Symbol\Glyph\Notification\notification(), and parseIndividualDeadlineData().

                                                             : void
     {
         $tpl = $this->tpl;
 
         $this->ctrl->saveParameter($this, "part_id");
 
         // from request "dn", see ilExcIdl.js
         if ($this->done) {
             $this->tpl->setOnScreenMessage('success', $this->lng->txt("settings_saved"), true);
             $this->ctrl->redirect($this, $this->assignment !== null
                 ? "members"
                 : "showParticipant");
         }
 
         // initial form call
         if ($this->requested_idl_id != "") {
             $tmp = $this->parseIndividualDeadlineData(explode(",", $this->requested_idl_id));
             if (is_array($tmp)) {
                 $form = $this->initIndividualDeadlineForm($tmp[1], $tmp[0]);
                 echo $form->getHTML() .
                     $tpl->getOnLoadCodeForAsynch();
             }
         }
         // form "submit"
         else {
             $tmp = array();
             $post = $this->http->request()->getParsedBody();
             foreach (array_keys($post) as $id) {
                 if (substr($id, 0, 3) == "dl_") {
                     $tmp[] = substr($id, 3);
                 }
             }
             $tmp = $this->parseIndividualDeadlineData($tmp);
             $ass_map = $tmp[1];
             $users = $tmp[0];
             unset($tmp);
 
             $form = $this->initIndividualDeadlineForm($ass_map, $users);
             $res = array();
             if ($valid = $form->checkInput()) {
                 foreach ($users as $ass_id => $users2) {
                     $ass = $ass_map[$ass_id];
 
                     // :TODO: should individual deadlines BEFORE extended be possible?
                     $dl = new ilDateTime($ass->getDeadline(), IL_CAL_UNIX);
 
                     foreach ($users2 as $user_id) {
                         $date_field = $form->getItemByPostVar("dl_" . $ass_id . "_" . $user_id);
                         if (ilDate::_before($date_field->getDate(), $dl)) {
                             $date_field->setAlert(sprintf($this->lng->txt("exc_individual_deadline_before_global"), ilDatePresentation::formatDate($dl)));
                             $valid = false;
                         } else {
                             $res[$ass_id][$user_id] = $date_field->getDate();
                         }
                     }
                 }
             }
 
             if (!$valid) {
                 $form->setValuesByPost();
                 echo $form->getHTML() .
                     $tpl->getOnLoadCodeForAsynch();
             } else {
                 foreach ($res as $ass_id => $users) {
                     $ass = $ass_map[$ass_id];
 
                     foreach ($users as $id => $date) {
                         $ass->setIndividualDeadline($id, $date);
                         if (is_numeric($id)) {
                             $this->notification->sendDeadlineSetNotification($ass_id, $id);
                         }
                     }
 
                     $ass->recalculateLateSubmissions();
                 }
 
                 echo "ok";
             }
         }
 
         exit();
     }

Here is the call graph for this function:

◆ handleMultiFeedbackUploadResult()

ilExerciseManagementGUI::handleMultiFeedbackUploadResult	(	FileUpload	$upload,
		UploadResult	$result
	)

Definition at line 1824 of file class.ilExerciseManagementGUI.php.

References ILIAS\Repository\user().

Referenced by getMultiFeedbackForm().

      : BasicHandlerResult {
         $feedback_zip = $this->domain->assignment()->tutorFeedbackZip();
         $rid = $feedback_zip->importFromUploadResult(
             $this->ass_id,
             $this->user->getId(),
             $result
         );
         return new \ILIAS\FileUpload\Handler\BasicHandlerResult(
             '',
             \ILIAS\FileUpload\Handler\HandlerResult::STATUS_OK,
             $rid,
             ''
         );
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ initFilter()

ilExerciseManagementGUI::initFilter ( )

Definition at line 2153 of file class.ilExerciseManagementGUI.php.

References $requested_filter_feedback, $requested_filter_status, ILIAS\Repository\ctrl(), ILIAS\Repository\filter(), ILIAS\Repository\lng(), ilSelectInputGUI\setOptions(), and ILIAS\Repository\toolbar().

Referenced by saveGradesObject().

                                 : void
     {
         if ($this->requested_filter_status != "") {
             $this->filter["status"] = $this->requested_filter_status;
         }
 
         $this->lng->loadLanguageModule("search");
 
         $this->toolbar->setFormAction($this->ctrl->getFormAction($this, "listTextAssignment"));
 
         // Status
 
         $si_status = new ilSelectInputGUI($this->lng->txt("exc_tbl_status"), "filter_status");
         $options = array(
             "" => $this->lng->txt("search_any"),
             self::GRADE_NOT_GRADED => $this->lng->txt("exc_notgraded"),
             self::GRADE_PASSED => $this->lng->txt("exc_passed"),
             self::GRADE_FAILED => $this->lng->txt("exc_failed")
         );
         $si_status->setOptions($options);
         $si_status->setValue($this->filter["status"] ?? "");
 
         $si_feedback = new ilSelectInputGUI($this->lng->txt("feedback"), "filter_feedback");
         $options = array(
             self::FEEDBACK_FULL_SUBMISSION => $this->lng->txt("submissions_feedback"),
             self::FEEDBACK_ONLY_SUBMISSION => $this->lng->txt("submissions_only")
         );
         $si_feedback->setOptions($options);
         $si_feedback->setValue($this->filter["feedback"] ?? "");
 
         $this->toolbar->addInputItem($si_status, true);
 
         // Submissions and Feedback
         #24713
         if ($this->assignment->getPeerReview()) {
             if ($this->requested_filter_feedback != "") {
                 $this->filter["feedback"] = $this->requested_filter_feedback;
             } else {
                 $this->filter["feedback"] = "submission_feedback";
             }
 
             $si_feedback = new ilSelectInputGUI($this->lng->txt("feedback"), "filter_feedback");
             $options = array(
                 "submission_feedback" => $this->lng->txt("submissions_feedback"),
                 "submission_only" => $this->lng->txt("submissions_only")
             );
             $si_feedback->setOptions($options);
             $si_feedback->setValue($this->filter["feedback"] ?? "");
 
             $this->toolbar->addInputItem($si_feedback, true);
         }
 
         $this->gui->button(
             $this->lng->txt("filter"),
             "listTextAssignment"
         )->submit()->toToolbar();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ initGroupForm()

ilExerciseManagementGUI::initGroupForm ( )

protected

Definition at line 1664 of file class.ilExerciseManagementGUI.php.

References $lng, ILIAS\Repository\ctrl(), ilExAssignmentTeam\getGroupMembersMap(), ilUserUtil\getNamePresentation(), and ilLanguage\txt().

Referenced by adoptTeamsFromGroupObject(), and createTeamsFromGroupsObject().

                                       : ilPropertyFormGUI
     {
         $lng = $this->lng;
 
         $form = new ilPropertyFormGUI();
         $form->setTitle($lng->txt("exc_adopt_group_teams") . " - " . $this->assignment->getTitle());
         $form->setFormAction($this->ctrl->getFormAction($this, "createTeamsFromGroups"));
 
         $all_members = array();
         foreach (ilExAssignmentTeam::getGroupMembersMap($this->exercise->getRefId()) as $grp_id => $group) {
             if (count($group["members"]) !== 0) {
                 $grp_team = new ilCheckboxGroupInputGUI($lng->txt("obj_grp") . " \"" . $group["title"] . "\"", "grpt[" . $grp_id . "]");
                 $grp_value = $options = array();
                 foreach ($group["members"] as $user_id) {
                     $user_name = ilUserUtil::getNamePresentation($user_id, false, false, "", true);
                     $options[$user_id] = $user_name;
                     if (!in_array($user_id, $all_members)) {
                         $grp_value[] = $user_id;
                         $all_members[] = $user_id;
                     }
                 }
                 asort($options);
                 foreach ($options as $user_id => $user_name) {
                     $grp_team->addOption(new ilCheckboxOption($user_name, $user_id));
                 }
                 $grp_team->setValue($grp_value);
             } else {
                 $grp_team = new ilNonEditableValueGUI($group["title"]);
                 $grp_team->setValue($lng->txt("exc_adopt_group_teams_no_members"));
             }
             $form->addItem($grp_team);
         }
 
         if ($all_members !== []) {
             $form->addCommandButton("createTeamsFromGroups", $lng->txt("save"));
         }
         $form->addCommandButton("members", $lng->txt("cancel"));
 
         return $form;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ initIndividualDeadlineForm()

ilExerciseManagementGUI::initIndividualDeadlineForm	(	array	$a_ass_map,
		array	$ids
	)

protected

Exceptions

ilDateTimeException

Definition at line 2082 of file class.ilExerciseManagementGUI.php.

References $ass_id, $id, ilObjUser\_lookupName(), ILIAS\Repository\ctrl(), ilExAssignmentTeam\getInstancesFromMap(), IL_CAL_UNIX, ILIAS\Repository\int(), and ILIAS\Repository\lng().

Referenced by handleIndividualDeadlineCallsObject().

      : ilPropertyFormGUI {
         $form = new ilPropertyFormGUI();
         $form->setFormAction($this->ctrl->getFormAction($this));
         $form->setName("ilExcIDlForm");
 
         foreach ($ids as $ass_id => $users) {
             $ass = $a_ass_map[$ass_id];
 
             $section = new ilFormSectionHeaderGUI();
             $section->setTitle($ass->getTitle());
             $form->addItem($section);
 
             $teams = ilExAssignmentTeam::getInstancesFromMap($ass->getId());
 
             $values = $ass->getIndividualDeadlines();
 
             foreach ($users as $id) {
                 // single user
                 if (is_numeric($id)) {
                     $name = ilObjUser::_lookupName($id);
                     $name = $name["lastname"] . ", " . $name["firstname"];
                 }
                 // team
                 else {
                     $name = "";
                     $team_id = (int) substr($id, 1);
                     if (array_key_exists($team_id, $teams)) {
                         $name = array();
                         foreach ($teams[$team_id]->getMembers() as $member_id) {
                             $uname = ilObjUser::_lookupName($member_id);
                             $name[] = $uname["lastname"] . ", " . $uname["firstname"];
                         }
                         asort($name);
                         $name = implode("<br />", $name);
                     }
                 }
 
                 $dl = new ilDateTimeInputGUI($name, "dl_" . $ass_id . "_" . $id);
                 $dl->setShowTime(true);
                 $dl->setRequired(true);
                 $form->addItem($dl);
 
                 if (array_key_exists($id, $values)) {
                     $dl->setDate(new ilDateTime($values[$id], IL_CAL_UNIX));
                 }
             }
         }
 
         $form->addCommandButton("", $this->lng->txt("save"));
 
         return $form;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ initIndividualDeadlineModal()

ilExerciseManagementGUI::initIndividualDeadlineModal ( )

protected

Definition at line 1939 of file class.ilExerciseManagementGUI.php.

References $lng, $tpl, ilGlobalTemplateInterface\addJavaScript(), ilGlobalTemplateInterface\addOnLoadCode(), ILIAS\Repository\ctrl(), ilModalGUI\getInstance(), ilCalendarUtil\initDateTimePicker(), and ilLanguage\txt().

Referenced by membersObject(), and showParticipantObject().

                                                     : string
     {
         $lng = $this->lng;
         $tpl = $this->tpl;
 
         // prepare modal+
         $modal = ilModalGUI::getInstance();
         $modal->setHeading($lng->txt("exc_individual_deadline"));
         $modal->setId("ilExcIDl");
         $modal->setBody('<div id="ilExcIDlBody"></div>');
         $modal = $modal->getHTML();
 
         $ajax_url = $this->ctrl->getLinkTarget($this, "handleIndividualDeadlineCalls", "", true, false);
 
         $tpl->addJavaScript("./Modules/Exercise/js/ilExcIDl.js", true, 3);
         $tpl->addOnLoadCode('il.ExcIDl.init("' . $ajax_url . '");');
 
         ilCalendarUtil::initDateTimePicker();
 
         return $modal;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ initSubmission()

ilExerciseManagementGUI::initSubmission ( )

protected

Definition at line 331 of file class.ilExerciseManagementGUI.php.

References ILIAS\Repository\ctrl(), getViewBack(), and ILIAS\Repository\lng().

Referenced by executeCommand().

                                        : ilExSubmission
     {
         $back_cmd = $this->getViewBack();
         $this->ctrl->setReturn($this, $back_cmd);
 
         $this->tabs_gui->clearTargets();
         $this->tabs_gui->setBackTarget(
             $this->lng->txt("back"),
             $this->ctrl->getLinkTarget($this, $back_cmd)
         );
 
         return new ilExSubmission($this->assignment, $this->requested_member_id, null, true);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ membersApplyObject()

ilExerciseManagementGUI::membersApplyObject ( )

Exceptions

ilExcUnknownAssignmentTypeException

Definition at line 555 of file class.ilExerciseManagementGUI.php.

References membersObject(), ilTable2GUI\resetOffset(), and saveStatusAllObject().

                                         : void
     {
         $this->saveStatusAllObject(null, false);
         $exc_tab = new ilParticipantsPerAssignmentTableGUI($this, "members", $this->exercise, $this->assignment->getId());
         $exc_tab->resetOffset();
         $exc_tab->writeFilterToSession();
 
         $this->membersObject();
     }

Here is the call graph for this function:

◆ membersObject()

ilExerciseManagementGUI::membersObject ( )

All participants and submission of one assignment.

Exceptions

ilExcUnknownAssignmentTypeException

Definition at line 399 of file class.ilExerciseManagementGUI.php.

References Vendor\Package\$a, $ctrl, $GLOBALS, $lng, $toolbar, $tpl, addSubTabs(), ILIAS\Repository\ctrl(), ilRepositorySearchGUI\fillAutoCompleteToolbar(), ilExAssignmentTeam\getAdoptableGroups(), ilExAssignment\getInstancesByExercise(), initIndividualDeadlineModal(), ILIAS\Repository\lng(), ilGlobalTemplateInterface\setContent(), ilSelectInputGUI\setOptions(), ilLanguage\txt(), ilExAssignment\TYPE_TEXT, and ilExAssignment\TYPE_UPLOAD_TEAM.

Referenced by addUserFromAutoCompleteObject(), membersApplyObject(), membersResetObject(), setIndividualDeadlineObject(), and waitingDownloadObject().

                                    : void
     {
         $tpl = $this->tpl;
         $ilToolbar = $this->toolbar;
         $ilCtrl = $this->ctrl;
         $lng = $this->lng;
 
         $this->addSubTabs("assignment");
         $this->gui->permanentLink()->setGradesPermanentLink();
 
         // assignment selection
         $ass = ilExAssignment::getInstancesByExercise($this->exercise->getId());
 
         if ($this->assignment === null && count($ass) > 0) {
             $this->assignment = current($ass);
         }
 
         reset($ass);
         if (count($ass) > 1) {
             $options = array();
             foreach ($ass as $a) {
                 $options[$a->getId()] = $a->getTitle();
             }
             $si = new ilSelectInputGUI($this->lng->txt("exc_assignment"), "ass_id");
             $si->setOptions($options);
             $si->setValue($this->assignment->getId());
             $ilToolbar->addStickyItem($si, true);
             $this->gui->button(
                 $this->lng->txt("select"),
                 "selectAssignment"
             )->submit()->toToolbar(true);
 
             $ilToolbar->addSeparator();
         }
         // #16165 - if only 1 assignment dropdown is not displayed;
         elseif ($this->assignment) {
             $ilCtrl->setParameter($this, "ass_id", $this->assignment->getId());
         }
 
         // add member
         // is only shown if 'edit_submissions_grades' is granted by rbac. positions
         // access is not sufficient.
         $has_rbac_access = $GLOBALS['DIC']->access()->checkAccess(
             'edit_submissions_grades',
             '',
             $this->exercise->getRefId()
         );
         if ($has_rbac_access) {
             ilRepositorySearchGUI::fillAutoCompleteToolbar(
                 $this,
                 $ilToolbar,
                 array(
                     'auto_complete_name' => $lng->txt('user'),
                     'submit_name' => $lng->txt('add'),
                     'add_search' => true,
                     'add_from_container' => $this->exercise->getRefId()
                 )
             );
         }
 
         // #16168 - no assignments
         if ($ass !== []) {
             if ($has_rbac_access) {
                 $ilToolbar->addSeparator();
             }
 
             // we do not want the ilRepositorySearchGUI form action
             $ilToolbar->setFormAction($ilCtrl->getFormAction($this));
 
             $ilCtrl->setParameter($this, "ass_id", $this->assignment->getId());
 
             if ($this->assignment->getType() == ilExAssignment::TYPE_UPLOAD_TEAM) {
                 if (ilExAssignmentTeam::getAdoptableGroups($this->exercise->getRefId())) {
                     $ilToolbar->addButton(
                         $this->lng->txt("exc_adopt_group_teams"),
                         $this->ctrl->getLinkTarget($this, "adoptTeamsFromGroup")
                     );
 
                     $ilToolbar->addSeparator();
                 }
             } elseif ($this->exercise->hasTutorFeedbackFile()) {
                 if (!$this->assignment->getAssignmentType()->usesTeams()) {
                     // multi-feedback
                     $ilToolbar->addButton(
                         $this->lng->txt("exc_multi_feedback"),
                         $this->ctrl->getLinkTarget($this, "showMultiFeedback")
                     );
 
                     $ilToolbar->addSeparator();
                 }
             }
 
             $submission_repository = $this->service->repo()->submission();
 
             if ($submission_repository->hasSubmissions($this->assignment->getId()) !== 0) {
                 $ass_type = $this->assignment->getType();
                 //todo change addFormButton for addButtonInstance
                 if ($ass_type == ilExAssignment::TYPE_TEXT) {
                     $ilToolbar->addFormButton($lng->txt("exc_list_text_assignment"), "listTextAssignment");
                 }
                 $ilToolbar->addFormButton($lng->txt("download_all_returned_files"), "downloadSubmissions");
             }
             $this->ctrl->setParameter($this, "vw", self::VIEW_ASSIGNMENT);
 
             $exc_tab = new ilParticipantsPerAssignmentTableGUI($this, "members", $this->exercise, $this->assignment->getId());
             $tpl->setContent(
                 $exc_tab->getHTML() .
                 $this->initIndividualDeadlineModal()
             );
         } else {
             $this->tpl->setOnScreenMessage('info', $lng->txt("exc_no_assignments_available"));
         }
 
         $ilCtrl->setParameter($this, "ass_id", "");
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ membersResetObject()

ilExerciseManagementGUI::membersResetObject ( )

Exceptions

ilExcUnknownAssignmentTypeException

Definition at line 568 of file class.ilExerciseManagementGUI.php.

References membersObject(), and ilTable2GUI\resetOffset().

                                         : void
     {
         $exc_tab = new ilParticipantsPerAssignmentTableGUI($this, "members", $this->exercise, $this->assignment->getId());
         $exc_tab->resetOffset();
         $exc_tab->resetFilter();
 
         $this->membersObject();
     }

Here is the call graph for this function:

◆ openSubmissionPrintViewObject()

ilExerciseManagementGUI::openSubmissionPrintViewObject ( )

Open HTML view for portfolio submissions.

Definition at line 2214 of file class.ilExerciseManagementGUI.php.

References openSubmissionViewObject().

                                                    : void
     {
         $this->openSubmissionViewObject(true);
     }

Here is the call graph for this function:

◆ openSubmissionViewObject()

ilExerciseManagementGUI::openSubmissionViewObject ( bool $print_version = false )

Open HTML view for portfolio submissions.

Definition at line 2222 of file class.ilExerciseManagementGUI.php.

References $DIC, $requested_member_id, CLIENT_ID, copyFileToWebDir(), getSubmissionZipFilePath(), getWebFilePathFromExternalFilePath(), ILIAS_WEB_DIR, ILIAS\Repository\int(), ILIAS\Repository\lng(), ilUtil\redirect(), and ilWACSignedPath\signFolderOfStartFile().

Referenced by openSubmissionPrintViewObject().

                                                                          : void
     {
         global $DIC;
 
         $member_id = $this->requested_member_id;
 
         $submission = new ilExSubmission($this->assignment, $member_id);
 
         $last_opening = $submission->getLastOpeningHTMLView();
         $submission_time = $submission->getLastSubmission();
 
         // e.g. /<datadir>/<clientid>/ilExercise/3/exc_367/subm_1/<ass_id>/20210628175716_368
         $zip_original_full_path = $this->getSubmissionZipFilePath($submission, $print_version);
         $this->log->debug("zip original full path: " . $zip_original_full_path);
 
         // e.g. ilExercise/3/exc_367/subm_1/<ass_id>/20210628175716_368
         $zip_internal_path = $this->getWebFilePathFromExternalFilePath($zip_original_full_path);
         $this->log->debug("zip internal path: " . $zip_internal_path);
 
         $arr = explode("_", basename($zip_original_full_path));
         $obj_date = $arr[0];
         $obj_id = (int) ($arr[1] ?? 0);
         if ($obj_id === 0) {
             throw new ilExerciseException("Cannot open HTML view for " . $zip_internal_path . " / " .
                 $submission->getSubmittedPrintFile() . ".");
         }
 
         $obj_id = $this->assignment->getAssignmentType()->getExportObjIdForResourceId($obj_id);
         if ($print_version) {
             $obj_id .= "print";
         }
 
         $obj_dir = $this->assignment->getAssignmentType()->getStringIdentifier() . "_" . $obj_id;
 
         $index_html_file = ILIAS_WEB_DIR .
             DIRECTORY_SEPARATOR .
             CLIENT_ID .
             DIRECTORY_SEPARATOR .
             dirname($zip_internal_path) .
             DIRECTORY_SEPARATOR .
             $obj_dir .
             DIRECTORY_SEPARATOR .
             "index.html";
         $this->log->debug("index html file: " . $index_html_file);
 
         $web_filesystem = $DIC->filesystem()->web();
         if ($last_opening > $submission_time && $web_filesystem->has($index_html_file)) {
             ilWACSignedPath::signFolderOfStartFile($index_html_file);
             ilUtil::redirect($index_html_file);
         }
         $error_msg = "";
         if ($zip_original_full_path) {
             $file_copied = $this->copyFileToWebDir($zip_internal_path);
             $this->log->debug("file copied: " . $file_copied);
             // e.g. data/ilias/ilExercise/3/exc_327/subm_9/2/20231212085734_167.zip ?
             if ($file_copied) {
                 $this->zip->unzipFile($file_copied);
                 $web_filesystem->delete($zip_internal_path);
                 $this->log->debug("deleting: " . $zip_internal_path);
 
                 $submission_repository = $this->service->repo()->submission();
                 $submission_repository->updateWebDirAccessTime($this->assignment->getId(), $member_id);
                 ilWACSignedPath::signFolderOfStartFile($index_html_file);
                 ilUtil::redirect($index_html_file . "?" . time());
             }
 
             $error_msg = $this->lng->txt("exc_copy_zip_error");
         }
 
         if ($error_msg === '' || $error_msg === '0') {
             $error_msg = $this->lng->txt("exc_find_zip_error");
         }
 
         $this->tpl->setOnScreenMessage('failure', $error_msg);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ parseIndividualDeadlineData()

ilExerciseManagementGUI::parseIndividualDeadlineData ( array $a_data )

protected

Exceptions

ilExcUnknownAssignmentTypeException

Definition at line 1964 of file class.ilExerciseManagementGUI.php.

References $ass_id, and $assignment.

Referenced by handleIndividualDeadlineCallsObject().

      : array {
         if ($a_data) {
             $map = array();
             $ass_tmp = array();
             foreach ($a_data as $item) {
                 $item = explode("_", $item);
                 $ass_id = $item[0];
                 $user_id = $item[1];
 
                 if (!array_key_exists($ass_id, $ass_tmp)) {
                     if ($this->assignment &&
                         $ass_id == $this->assignment->getId()) {
                         $ass_tmp[$ass_id] = $this->assignment;
                     } else {
                         $ass_tmp[$ass_id] = new ilExAssignment($ass_id);
                     }
                 }
 
                 $map[$ass_id][] = $user_id;
             }
 
             return array($map, $ass_tmp);
         }
         return [];
     }

Here is the caller graph for this function:

◆ redirectFeedbackMailObject()

ilExerciseManagementGUI::redirectFeedbackMailObject ( )

Exceptions

ilExcUnknownAssignmentTypeException

Definition at line 1138 of file class.ilExerciseManagementGUI.php.

References ilObject\_exists(), ilObjUser\_lookupLogin(), ilExSubmission\downloadAllAssignmentFiles(), ilObjectFactory\getInstanceByObjId(), getMultiActionUserIds(), ilMailFormCall\getRedirectTarget(), getViewBack(), ILIAS\Repository\lng(), ilUtil\redirect(), and ilMailFormCall\SIGNATURE_KEY.

                                                 : void
     {
         if ($this->requested_member_id > 0) {
             $submission = new ilExSubmission($this->assignment, $this->requested_member_id);
             $members = $submission->getUserIds();
         } elseif ($members = $this->getMultiActionUserIds()) {
             $members = array_keys($members);
         }
 
         if ($members !== []) {
             $logins = array();
             foreach ($members as $user_id) {
                 $member_status = $this->assignment->getMemberStatus($user_id);
                 $member_status->setFeedback(true);
                 $member_status->update();
 
                 $logins[] = ilObjUser::_lookupLogin($user_id);
             }
             $logins = implode(",", $logins);
 
             // #16530 - see ilObjCourseGUI::createMailSignature
             $sig = chr(13) . chr(10) . chr(13) . chr(10);
             $sig .= $this->lng->txt('exc_mail_permanent_link');
             $sig .= chr(13) . chr(10) . chr(13) . chr(10);
             $sig .= ilLink::_getLink($this->exercise->getRefId());
             $sig = rawurlencode(base64_encode($sig));
 
             ilUtil::redirect(ilMailFormCall::getRedirectTarget(
                 $this,
                 $this->getViewBack(),
                 array(),
                 array(
                     'type' => 'new',
                     'rcp_to' => $logins,
                     ilMailFormCall::SIGNATURE_KEY => $sig
                 )
             ));
         }
     }

Here is the call graph for this function:

◆ removeUserSubmissionFilesFromWebDir()

ilExerciseManagementGUI::removeUserSubmissionFilesFromWebDir ( int $user_id )

Definition at line 1352 of file class.ilExerciseManagementGUI.php.

References $ass_id.

Referenced by deassignMembersObject().

                                                                      : void
     {
         $storage = new ilFSWebStorageExercise($this->exercise->getId(), $this->ass_id);
         $storage->deleteUserSubmissionDirectory($user_id);
     }

Here is the caller graph for this function:

◆ saveCommentForLearnersObject()

ilExerciseManagementGUI::saveCommentForLearnersObject ( )

Exceptions

ilExcUnknownAssignmentTypeException

Definition at line 1502 of file class.ilExerciseManagementGUI.php.

References $comment, $requested_ass_id, $requested_member_id, $res, ILIAS\Repository\ctrl(), exit, ILIAS\UI\examples\Symbol\Glyph\Notification\notification(), and ilUtil\stripSlashes().

                                                   : void
     {
         $res = array("result" => false);
 
         if ($this->ctrl->isAsynch()) {
             $ass_id = $this->requested_ass_id;
             $user_id = $this->requested_member_id;
             $comment = trim($this->requested_comment);
 
             if ($ass_id && $user_id) {
                 $submission = new ilExSubmission($this->assignment, $user_id);
                 $user_ids = $submission->getUserIds();
 
                 $all_members = new ilExerciseMembers($this->exercise);
                 $all_members = $all_members->getMembers();
 
                 $reci_ids = array();
                 foreach ($user_ids as $user_id) {
                     if (in_array($user_id, $all_members)) {
                         $member_status = $this->assignment->getMemberStatus($user_id);
                         $member_status->setComment(ilUtil::stripSlashes($comment));
                         $member_status->setFeedback(true);
                         $member_status->update();
 
                         if (trim($comment) !== '' && trim($comment) !== '0') {
                             $reci_ids[] = $user_id;
                         }
                     }
                 }
 
                 if ($reci_ids !== []) {
                     // send notification
                     $this->notification->sendFeedbackNotification(
                         $ass_id,
                         $reci_ids,
                         "",
                         true
                     );
                 }
 
                 $res = array("result" => true, "snippet" => nl2br($comment));
             }
         }
 
         echo(json_encode($res));
         exit();
     }

Here is the call graph for this function:

◆ saveEvaluationFromModalObject()

ilExerciseManagementGUI::saveEvaluationFromModalObject ( )

Exceptions

ilExcUnknownAssignmentTypeException

Definition at line 894 of file class.ilExerciseManagementGUI.php.

References $comment, ILIAS\Repository\ctrl(), getEvaluationModalForm(), ILIAS\Repository\int(), ILIAS\Repository\lng(), and ilUtil\stripSlashes().

                                                    : void
     {
         $form = $this->getEvaluationModalForm([]);
         $user_id = 0;
         $comment = "";
         $mark = "";
         $grade = "";
         if ($form->checkInput()) {
             $comment = trim($form->getInput('comment'));
             $user_id = (int) $form->getInput('mem_id');
             $grade = trim($form->getInput('grade'));
             $mark = trim($form->getInput('mark'));
         }
 
         if ($this->assignment->getId() && $user_id > 0) {
             $member_status = $this->assignment->getMemberStatus($user_id);
             $member_status->setComment(ilUtil::stripSlashes($comment));
             if ($grade != "") {
                 $member_status->setStatus($grade);
             }
             $member_status->setMark($mark);
             if ($comment != "") {
                 $member_status->setFeedback(true);
             }
             $member_status->update();
         }
         $this->tpl->setOnScreenMessage('success', $this->lng->txt("exc_status_saved"), true);
         $this->ctrl->redirect($this, "listTextAssignment");
     }

Here is the call graph for this function:

◆ saveGradesObject()

ilExerciseManagementGUI::saveGradesObject ( )

Definition at line 577 of file class.ilExerciseManagementGUI.php.

References $ass_id, $ctrl, $data, $id, $lng, ilObject\_exists(), collectFeedbackDataFromPeer(), ILIAS\Repository\filter(), ilExerciseMembersFilter\filterParticipantsByAccess(), ilExSubmission\getAssignmentFilesByUsers(), ilExSubmission\getAssignmentParticipants(), getReportPanel(), initFilter(), ILIAS\Repository\int(), ILIAS\Repository\lng(), setBackToMembers(), ILIAS\Repository\toolbar(), ilLanguage\txt(), ILIAS\Repository\user(), and ILIAS\UI\Implementation\Component\withOnLoadCode().

                                       : void
     {
         $ilCtrl = $this->ctrl;
         $lng = $this->lng;
 
         foreach ($this->requested_learning_comments as $k => $v) {
             $marks_obj = new ilLPMarks($this->exercise->getId(), (int) $k);
             $marks_obj->setComment($v);
             $marks_obj->update();
         }
         foreach ($this->requested_marks as $k => $v) {
             $marks_obj = new ilLPMarks($this->exercise->getId(), (int) $k);
             $marks_obj->setMark($v);
             $marks_obj->update();
         }
         $this->tpl->setOnScreenMessage('success', $lng->txt("exc_msg_saved_grades"), true);
         $ilCtrl->redirect($this, "showGradesOverview");
     }

Here is the call graph for this function:

◆ saveMultiFeedbackObject()

ilExerciseManagementGUI::saveMultiFeedbackObject ( )

Save multi feedback.

Definition at line 1920 of file class.ilExerciseManagementGUI.php.

References $requested_files, ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), and ILIAS\Repository\user().

                                              : void
     {
         $feedback_zip = $this->domain->assignment()->tutorFeedbackZip();
         $feedback_zip->saveMultiFeedbackFiles(
             $this->exercise,
             $this->assignment->getId(),
             $this->user->getId(),
             $this->requested_files
         );
 
         $this->tpl->setOnScreenMessage('success', $this->lng->txt("msg_obj_modified"), true);
         $this->ctrl->redirect($this, "members");
     }

Here is the call graph for this function:

◆ saveStatus()

ilExerciseManagementGUI::saveStatus	(	array	$a_data,
		bool	$a_redirect = `true`
	)

protected

Exceptions

ilExcUnknownAssignmentTypeException

Definition at line 1450 of file class.ilExerciseManagementGUI.php.

References $ctrl, ilObjUser\_lookupName(), getViewBack(), and ILIAS\Repository\lng().

Referenced by saveStatusAllObject(), and saveStatusParticipantObject().

      : void {
         $ilCtrl = $this->ctrl;
         $saved_for = array();
         foreach ($a_data as $ass_id => $users) {
             $ass = ($ass_id < 0)
                 ? $this->assignment
                 : new ilExAssignment($ass_id);
             foreach ($users as $user_id => $values) {
                 // this will add team members if available
                 // $user_id is only the ID of one team member here,
                 // $sub_user_id will be all team members
                 $submission = new ilExSubmission($ass, $user_id);
                 foreach ($submission->getUserIds() as $sub_user_id) {
                     $uname = ilObjUser::_lookupName($sub_user_id);
                     $saved_for[$sub_user_id] = $uname["lastname"] . ", " . $uname["firstname"];
 
                     $member_status = $ass->getMemberStatus($sub_user_id);
 
                     // see bug #22566
                     $status = $values["status"];
                     if ($status == "") {
                         $status = self::GRADE_NOT_GRADED;
                     }
                     $member_status->setStatus($status);
                     if (array_key_exists("mark", $values)) {
                         $member_status->setMark($values["mark"]);
                     }
                     if (array_key_exists("notice", $values)) {
                         $member_status->setNotice($values["notice"]);
                     }
                     $member_status->update();
                 }
             }
         }
 
         $save_for_str = "";
         if ($saved_for !== []) {
             $save_for_str = "(" . implode(" - ", $saved_for) . ")";
         }
 
         if ($a_redirect) {
             $this->tpl->setOnScreenMessage('success', $this->lng->txt("exc_status_saved") . " " . $save_for_str, true);
             $ilCtrl->redirect($this, $this->getViewBack());
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ saveStatusAllObject()

ilExerciseManagementGUI::saveStatusAllObject	(	array	$a_selected = `null`,
		bool	$a_redirect = `true`
	)

Exceptions

ilExcUnknownAssignmentTypeException

Definition at line 1395 of file class.ilExerciseManagementGUI.php.

References $data, $GLOBALS, $listed_participants, $requested_marks, $requested_status, $requested_tutor_notices, and saveStatus().

Referenced by membersApplyObject(), and saveStatusSelectedObject().

      : void {
         $user_ids = $this->listed_participants;
         $marks = $this->requested_marks;
         $notices = $this->requested_tutor_notices;
         $status = $this->requested_status;
         $filtered_user_ids = $GLOBALS['DIC']->access()->filterUserIdsByRbacOrPositionOfCurrentUser(
             'edit_submissions_grades',
             'edit_submissions_grades',
             $this->exercise->getRefId(),
             $user_ids
         );
 
         $data = array();
         foreach ($filtered_user_ids as $user_id) {
             if (is_array($a_selected) &&
                 !in_array($user_id, $a_selected)) {
                 continue;
             }
 
             $data[-1][$user_id] = array(
                 "status" => $status[$user_id] ?? null
             );
 
             if (isset($marks[$user_id])) {
                 $data[-1][$user_id]["mark"] = $marks[$user_id];
             }
             if (isset($notices[$user_id])) {
                 $data[-1][$user_id]["notice"] = $notices[$user_id];
             }
         }
         $this->saveStatus($data, $a_redirect);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ saveStatusParticipantObject()

ilExerciseManagementGUI::saveStatusParticipantObject ( array $selected_ass_ids = null )

Save assignment status (participant view)

Exceptions

ilExcUnknownAssignmentTypeException

Definition at line 1362 of file class.ilExerciseManagementGUI.php.

References $ass_id, $ctrl, $data, $requested_marks, $requested_part_id, $requested_status, $requested_tutor_notices, and saveStatus().

Referenced by saveStatusSelectedObject().

                                                                                : void
     {
         $ilCtrl = $this->ctrl;
 
         $member_id = $this->requested_part_id;
         $data = array();
         $marks = $this->requested_marks;
         $status = $this->requested_status;
         $notices = $this->requested_tutor_notices;
         foreach ($this->listed_ass_ids as $ass_id) {
             if (is_array($selected_ass_ids) &&
                 !in_array($ass_id, $selected_ass_ids)) {
                 continue;
             }
 
             $data[$ass_id][$member_id] = array(
                 "status" => $status[$ass_id]
             );
             if (isset($marks[$ass_id])) {
                 $data[$ass_id][$member_id]["mark"] = $marks[$ass_id];
             }
             if (isset($notices[$ass_id])) {
                 $data[$ass_id][$member_id]["notice"] = $notices[$ass_id];
             }
         }
 
         $ilCtrl->setParameter($this, "part_id", $member_id); // #17629
         $this->saveStatus($data);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ saveStatusSelectedObject()

ilExerciseManagementGUI::saveStatusSelectedObject ( )

Exceptions

ilExcUnknownAssignmentTypeException

Definition at line 1434 of file class.ilExerciseManagementGUI.php.

References saveStatusAllObject(), and saveStatusParticipantObject().

                                               : void
     {
         //$members = $this->getMultiActionUserIds();
 
         if ($this->assignment !== null) {
             $this->saveStatusAllObject($this->selected_participants);
         } else {
             $this->saveStatusParticipantObject($this->selected_ass_ids);
         }
     }

Here is the call graph for this function:

◆ selectAssignmentObject()

ilExerciseManagementGUI::selectAssignmentObject ( )

Exceptions

ilExcUnknownAssignmentTypeException

Definition at line 972 of file class.ilExerciseManagementGUI.php.

References $ctrl, ilCtrl\redirect(), and ilCtrl\setParameter().

                                             : void
     {
         $ctrl = $this->ctrl;
         $ctrl->setParameter($this, "ass_id", $this->requested_ass_id);
         $ctrl->redirect($this, "members");
     }

Here is the call graph for this function:

◆ selectParticipantObject()

ilExerciseManagementGUI::selectParticipantObject ( )

Exceptions

ilExcUnknownAssignmentTypeException

Definition at line 1092 of file class.ilExerciseManagementGUI.php.

References $ctrl, ilCtrl\redirect(), and ilCtrl\setParameter().

                                              : void
     {
         $ctrl = $this->ctrl;
         $ctrl->setParameter($this, "part_id", $this->requested_part_id);
         $ctrl->redirect($this, "showParticipant");
     }

Here is the call graph for this function:

◆ sendGradingNotificationObject()

ilExerciseManagementGUI::sendGradingNotificationObject ( )

Definition at line 2417 of file class.ilExerciseManagementGUI.php.

References ILIAS\Repository\ctrl(), getViewBack(), ILIAS\Repository\lng(), and ilExerciseMailNotification\TYPE_GRADING_DONE.

                                                    : void
     {
 
         $ass_id = $this->request->getAssId();
         $selected_users = $this->request->getSelectedParticipants();
 
         $graded_users = array_filter($selected_users, function ($user_id) {
             return $this->assignment->getMemberStatus($user_id)->getStatus() !== "notgraded";
         });
 
         if (count($graded_users) === 0) {
             $this->tpl->setOnScreenMessage("failure", $this->lng->txt("exc_no_graded_mem_selected"), true);
             $this->ctrl->redirect($this, $this->getViewBack());
         }
 
         $not = new ilExerciseMailNotification();
         $not->setType(ilExerciseMailNotification::TYPE_GRADING_DONE);
         $not->setAssignmentId($ass_id);
         $not->setObjId($this->exercise->getId());
         $not->setRefId($this->exercise->getRefId());
         $not->setRecipients($graded_users);
         $not->send();
         $this->tpl->setOnScreenMessage("success", $this->lng->txt("exc_graded_mem_notified"), true);
         $this->ctrl->redirect($this, $this->getViewBack());
     }

Here is the call graph for this function:

◆ sendMembersObject()

ilExerciseManagementGUI::sendMembersObject ( )

Exceptions

ilExcUnknownAssignmentTypeException

Definition at line 1288 of file class.ilExerciseManagementGUI.php.

References ILIAS\Repository\ctrl(), getMultiActionUserIds(), and ILIAS\Repository\lng().

                                        : void
     {
         $members = $this->getMultiActionUserIds();
 
         $this->tpl->setOnScreenMessage('success', $this->lng->txt("exc_sent"), true);
         if ($this->assignment !== null) {
             $this->exercise->sendAssignment($this->assignment, array_keys($members));
             $this->ctrl->redirect($this, "members");
         } else {
             foreach ($members as $ass_id => $users) {
                 $this->exercise->sendAssignment(new ilExAssignment($ass_id), $users);
             }
             $this->ctrl->setParameter($this, "part_id", $this->requested_part_id); // #17629
             $this->ctrl->redirect($this, "showParticipant");
         }
     }

Here is the call graph for this function:

◆ setBackToMembers()

ilExerciseManagementGUI::setBackToMembers ( )

protected

Definition at line 2381 of file class.ilExerciseManagementGUI.php.

References ILIAS\Repository\ctrl(), and ILIAS\Repository\lng().

Referenced by compareTextAssignmentsObject(), and saveGradesObject().

                                          : void
     {
         //tabs
         $this->tabs_gui->clearTargets();
         $this->tabs_gui->setBackTarget(
             $this->lng->txt("back"),
             $this->ctrl->getLinkTarget($this, "members")
         );
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setFailedObject()

ilExerciseManagementGUI::setFailedObject ( )

protected

Definition at line 2443 of file class.ilExerciseManagementGUI.php.

References ILIAS\Repository\ctrl(), getMultiActionUserIds(), ILIAS\Repository\lng(), and setSingleStatus().

                                         : void
     {
         $members = $this->getMultiActionUserIds();
         $done = false;
         if ($this->assignment !== null) {
             foreach (array_keys($members) as $mem) {
                 $done = true;
                 $this->setSingleStatus($this->assignment->getId(), $mem, "failed");
             }
             if ($done) {
                 $this->tpl->setOnScreenMessage("success", $this->lng->txt("msg_obj_modified"), true);
             }
         }
         $this->ctrl->redirect($this, "members");
     }

Here is the call graph for this function:

◆ setIndividualDeadlineObject()

ilExerciseManagementGUI::setIndividualDeadlineObject ( )

protected

Exceptions

ilExcUnknownAssignmentTypeException

Definition at line 2141 of file class.ilExerciseManagementGUI.php.

References ILIAS\Repository\lng(), membersObject(), and showParticipantObject().

                                                     : void
     {
         // this will only get called if no selection
         $this->tpl->setOnScreenMessage('failure', $this->lng->txt("select_one"));
 
         if ($this->assignment !== null) {
             $this->membersObject();
         } else {
             $this->showParticipantObject();
         }
     }

Here is the call graph for this function:

◆ setPassedObject()

ilExerciseManagementGUI::setPassedObject ( )

protected

Definition at line 2459 of file class.ilExerciseManagementGUI.php.

References ILIAS\Repository\ctrl(), getMultiActionUserIds(), ILIAS\Repository\lng(), and setSingleStatus().

                                         : void
     {
         $members = $this->getMultiActionUserIds();
         $done = false;
         if ($this->assignment !== null) {
             foreach (array_keys($members) as $mem) {
                 $done = true;
                 $this->setSingleStatus($this->assignment->getId(), $mem, "passed");
             }
             if ($done) {
                 $this->tpl->setOnScreenMessage("success", $this->lng->txt("msg_obj_modified"), true);
             }
         }
         $this->ctrl->redirect($this, "members");
     }

Here is the call graph for this function:

◆ setSingleStatus()

ilExerciseManagementGUI::setSingleStatus	(	$ass_id,
		$part_id,
		$status
	)

protected

Definition at line 2475 of file class.ilExerciseManagementGUI.php.

Referenced by setFailedObject(), and setPassedObject().

                                                                   : void
     {
         $ass = new ilExAssignment($ass_id);
         $submission = new ilExSubmission($ass, $part_id);
         $member_status = $ass->getMemberStatus($part_id);
         $member_status->setStatus($status);
         $member_status->update();
     }

Here is the caller graph for this function:

◆ showGradesOverviewObject()

ilExerciseManagementGUI::showGradesOverviewObject ( )

Definition at line 1099 of file class.ilExerciseManagementGUI.php.

References $ctrl, $GLOBALS, $lng, $toolbar, $tpl, addSubTabs(), ILIAS\Repository\ctrl(), ilGlobalTemplateInterface\setContent(), and ilLanguage\txt().

                                               : void
     {
         $tpl = $this->tpl;
         $ilToolbar = $this->toolbar;
         $ilCtrl = $this->ctrl;
         $lng = $this->lng;
 
         $this->addSubTabs("grades");
 
         $mem_obj = new ilExerciseMembers($this->exercise);
         $mems = $mem_obj->getMembers();
 
         $mems = $GLOBALS['DIC']->access()->filterUserIdsByRbacOrPositionOfCurrentUser(
             'edit_submissions_grades',
             'edit_submissions_grades',
             $this->exercise->getRefId(),
             $mems
         );
         if (count($mems) > 0) {
             $ilToolbar->addButton(
                 $lng->txt("exc_export_excel"),
                 $ilCtrl->getLinkTarget($this, "exportExcel")
             );
         }
 
         $this->ctrl->setParameter($this, "vw", self::VIEW_GRADES);
 
         $grades_tab = new ilExGradesTableGUI(
             $this,
             "showGradesOverview",
             $this->service,
             $mem_obj
         );
         $tpl->setContent($grades_tab->getHTML());
     }

Here is the call graph for this function:

◆ showMultiFeedbackConfirmationTableObject()

ilExerciseManagementGUI::showMultiFeedbackConfirmationTableObject ( )

Show multi feedback confirmation table.

Definition at line 1899 of file class.ilExerciseManagementGUI.php.

References $tpl, addSubTabs(), and ilGlobalTemplateInterface\setContent().

                                                               : void
     {
         $tpl = $this->tpl;
 
         $this->addSubTabs("assignment");
 
         $tab = new ilFeedbackConfirmationTable2GUI($this, "showMultiFeedbackConfirmationTable", $this->assignment);
         $tpl->setContent($tab->getHTML());
     }

Here is the call graph for this function:

◆ showMultiFeedbackObject()

ilExerciseManagementGUI::showMultiFeedbackObject ( FormAdapterGUI $form = null )

Definition at line 1843 of file class.ilExerciseManagementGUI.php.

References $lng, $tpl, addSubTabs(), ILIAS\Repository\ctrl(), getMultiFeedbackForm(), ILIAS\Repository\lng(), ilGlobalTemplateInterface\setContent(), ilGlobalTemplateInterface\setOnScreenMessage(), and ilLanguage\txt().

Referenced by uploadMultiFeedbackObject().

      : void {
         $lng = $this->lng;
         $tpl = $this->tpl;
 
         $this->tpl->setOnScreenMessage('info', $lng->txt("exc_multi_feedb_info"));
 
         $this->addSubTabs("assignment");
 
         // #13719
         $this->gui->button(
             $this->lng->txt("exc_download_zip_structure"),
             $this->ctrl->getLinkTarget($this, "downloadMultiFeedbackZip")
         )->toToolbar();
 
         if ($form === null) {
             $form = $this->getMultiFeedbackForm($this->assignment->getId());
         }
 
         $tpl->setContent($form->render());
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ showParticipantApplyObject()

ilExerciseManagementGUI::showParticipantApplyObject ( )

Definition at line 1069 of file class.ilExerciseManagementGUI.php.

References showParticipantObject().

                                                 : void
     {
         $exc_tab = new ilAssignmentsPerParticipantTableGUI($this, "showParticipant", $this->exercise, $this->requested_part_id);
         $exc_tab->resetOffset();
         $exc_tab->writeFilterToSession();
 
         $this->showParticipantObject();
     }

Here is the call graph for this function:

◆ showParticipantObject()

ilExerciseManagementGUI::showParticipantObject ( )

Show Participant.

Definition at line 982 of file class.ilExerciseManagementGUI.php.

References $access, $ctrl, $lng, $requested_part_id, $toolbar, $tpl, ilObjUser\_lookupName(), ilObject\_lookupType(), addSubTabs(), ILIAS\Repository\ctrl(), ilOrgUnitPositionAndRBACAccessHandler\filterUserIdsByRbacOrPositionOfCurrentUser(), initIndividualDeadlineModal(), ILIAS\Repository\lng(), ilGlobalTemplateInterface\setContent(), ilSelectInputGUI\setOptions(), ilArrayUtil\sortArray(), and ilLanguage\txt().

Referenced by setIndividualDeadlineObject(), showParticipantApplyObject(), and showParticipantResetObject().

                                            : void
     {
         $tpl = $this->tpl;
         $ilToolbar = $this->toolbar;
         $ilCtrl = $this->ctrl;
         $lng = $this->lng;
         $access = $this->access;
 
         $this->addSubTabs("participant");
         $this->ctrl->setParameter($this, "ass_id", "");
 
         // participant selection
         $members = $this->exercise->members_obj->getMembers();
 
         $members = $access->filterUserIdsByRbacOrPositionOfCurrentUser(
             'edit_submissions_grades',
             'edit_submissions_grades',
             $this->exercise->getRefId(),
             $members
         );
 
 
         if (count($members) == 0) {
             $this->tpl->setOnScreenMessage('info', $lng->txt("exc_no_participants"));
             return;
         }
 
         $mems = array();
         foreach ($members as $mem_id) {
             if (ilObject::_lookupType($mem_id) == "usr") {
                 $name = ilObjUser::_lookupName($mem_id);
                 if (trim($name["login"]) != "") {               // #20073
                     $mems[$mem_id] = $name;
                 }
             }
         }
 
         $mems = ilArrayUtil::sortArray($mems, "lastname", "asc", false, true);
 
         if ($this->requested_part_id == 0 && $mems !== [] && key($mems) > 0) {
             $ilCtrl->setParameter($this, "part_id", key($mems));
             $ilCtrl->redirect($this, "showParticipant");
         }
 
         $current_participant = $this->requested_part_id;
 
         reset($mems);
         if (count($mems) > 1) {
             $options = array();
             foreach ($mems as $k => $m) {
                 $options[$k] =
                     $m["lastname"] . ", " . $m["firstname"] . " [" . $m["login"] . "]";
             }
             $si = new ilSelectInputGUI($this->lng->txt("exc_participant"), "part_id");
             $si->setOptions($options);
             $si->setValue($current_participant);
             $ilToolbar->addStickyItem($si, true);
 
             $this->gui->button(
                 $this->lng->txt("select"),
                 "selectParticipant"
             )->submit()->toToolbar(true);
         }
 
         if ($mems !== []) {
             $this->ctrl->setParameter($this, "vw", self::VIEW_PARTICIPANT);
             $this->ctrl->setParameter($this, "part_id", $current_participant);
 
             $ilToolbar->addSeparator();
             $ilToolbar->setFormAction($ilCtrl->getFormAction($this));
             $ilToolbar->addFormButton($lng->txt("download_all_returned_files"), "downloadSubmissions");
 
             $part_tab = new ilAssignmentsPerParticipantTableGUI(
                 $this,
                 "showParticipant",
                 $this->exercise,
                 $current_participant
             );
             $tpl->setContent($part_tab->getHTML() .
                 $this->initIndividualDeadlineModal());
         } else {
             $this->tpl->setOnScreenMessage('info', $this->lng->txt("exc_no_assignments_available"));
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ showParticipantResetObject()

ilExerciseManagementGUI::showParticipantResetObject ( )

Definition at line 1080 of file class.ilExerciseManagementGUI.php.

References showParticipantObject().

                                                 : void
     {
         $exc_tab = new ilAssignmentsPerParticipantTableGUI($this, "showParticipant", $this->exercise, $this->requested_part_id);
         $exc_tab->resetOffset();
         $exc_tab->resetFilter();
 
         $this->showParticipantObject();
     }

Here is the call graph for this function:

◆ uploadMultiFeedbackObject()

ilExerciseManagementGUI::uploadMultiFeedbackObject ( )

Upload multi feedback file.

Definition at line 1885 of file class.ilExerciseManagementGUI.php.

References ILIAS\Repository\ctrl(), getMultiFeedbackForm(), and showMultiFeedbackObject().

                                                : void
     {
         // #11983
         $form = $this->getMultiFeedbackForm($this->assignment->getId());
         if ($form->isValid()) {
             $this->ctrl->redirect($this, "showMultiFeedbackConfirmationTable");
         }
 
         $this->showMultiFeedbackObject($form);
     }

Here is the call graph for this function:

◆ waitingDownloadObject()

ilExerciseManagementGUI::waitingDownloadObject ( )

Exceptions

ilExcUnknownAssignmentTypeException

Definition at line 383 of file class.ilExerciseManagementGUI.php.

References $ctrl, $lng, $url, membersObject(), ilCtrl\setParameterByClass(), and ilLanguage\txt().

                                            : void
     {
         $lng = $this->lng;
         $ilCtrl = $this->ctrl;
 
         $ilCtrl->setParameterByClass("ilExSubmissionFileGUI", "member_id", $this->requested_member_id);
         $url = $ilCtrl->getLinkTargetByClass(array("ilExerciseHandlerGUI", "ilObjExerciseGUI", "ilExerciseManagementGUI", "ilExSubmissionFileGUI"), "downloadNewReturned");
         $js_url = $ilCtrl->getLinkTargetByClass(array("ilExerciseHandlerGUI", "ilObjExerciseGUI", "ilExerciseManagementGUI", "ilExSubmissionFileGUI"), "downloadNewReturned", "", "", false);
         $this->tpl->setOnScreenMessage('info', $lng->txt("exc_wait_for_files") . "<a href='$url'> " . $lng->txt('exc_download_files') . "</a><script>window.location.href ='" . $js_url . "';</script>");
         $this->membersObject();
     }

Here is the call graph for this function:

Field Documentation

◆ $access

ilAccessHandler ilExerciseManagementGUI::$access

protected

Definition at line 63 of file class.ilExerciseManagementGUI.php.

Referenced by showParticipantObject().

◆ $ass_id

int ilExerciseManagementGUI::$ass_id = 0

protected

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

Referenced by downloadSubmissionsObject(), getMultiActionUserIds(), handleIndividualDeadlineCallsObject(), initIndividualDeadlineForm(), parseIndividualDeadlineData(), removeUserSubmissionFilesFromWebDir(), saveGradesObject(), and saveStatusParticipantObject().

◆ $assignment

ilExAssignment ilExerciseManagementGUI::$assignment = null

protected

Definition at line 69 of file class.ilExerciseManagementGUI.php.

Referenced by parseIndividualDeadlineData().

◆ $ctrl

ilCtrl ilExerciseManagementGUI::$ctrl

protected

Definition at line 60 of file class.ilExerciseManagementGUI.php.

Referenced by addSubTabs(), adoptTeamsFromGroupObject(), confirmDeassignMembersObject(), createTeamsObject(), deassignMembersObject(), dissolveTeamsObject(), executeCommand(), membersObject(), saveGradesObject(), saveStatus(), saveStatusParticipantObject(), selectAssignmentObject(), selectParticipantObject(), showGradesOverviewObject(), showParticipantObject(), and waitingDownloadObject().

◆ $db

ilDBInterface ilExerciseManagementGUI::$db = null

protected

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

◆ $domain

ILIAS Exercise InternalDomainService ilExerciseManagementGUI::$domain

protected

Definition at line 54 of file class.ilExerciseManagementGUI.php.

◆ $done

bool ilExerciseManagementGUI::$done = false

protected

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

◆ $exercise

ilObjExercise ilExerciseManagementGUI::$exercise

protected

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

◆ $filter

array ilExerciseManagementGUI::$filter = []

protected

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

◆ $gui

InternalGUIService ilExerciseManagementGUI::$gui

protected

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

◆ $http

ILIAS HTTP Services ilExerciseManagementGUI::$http

protected

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

◆ $listed_ass_ids

array ilExerciseManagementGUI::$listed_ass_ids

protected

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

◆ $listed_participants

array ilExerciseManagementGUI::$listed_participants

protected

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

Referenced by saveStatusAllObject().

◆ $lng

ilLanguage ilExerciseManagementGUI::$lng

protected

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

Referenced by addSubTabs(), adoptTeamsFromGroupObject(), confirmDeassignMembersObject(), createTeamsFromGroupsObject(), deassignMembersObject(), executeCommand(), getMultiFeedbackForm(), initGroupForm(), initIndividualDeadlineModal(), membersObject(), saveGradesObject(), showGradesOverviewObject(), showMultiFeedbackObject(), showParticipantObject(), and waitingDownloadObject().

◆ $log

ilLogger ilExerciseManagementGUI::$log

protected

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

◆ $notification

ILIAS Exercise Notification NotificationManager ilExerciseManagementGUI::$notification

protected

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

◆ $request

GUIRequest ilExerciseManagementGUI::$request

protected

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

Referenced by __construct().

◆ $requested_ass_id

int ilExerciseManagementGUI::$requested_ass_id = 0

protected

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

Referenced by saveCommentForLearnersObject().

◆ $requested_comment

string ilExerciseManagementGUI::$requested_comment

protected

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

◆ $requested_files

array ilExerciseManagementGUI::$requested_files

protected

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

Referenced by saveMultiFeedbackObject().

◆ $requested_filter_feedback

string ilExerciseManagementGUI::$requested_filter_feedback

protected

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

Referenced by initFilter().

◆ $requested_filter_status

string ilExerciseManagementGUI::$requested_filter_status

protected

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

Referenced by initFilter().

◆ $requested_group_members

array ilExerciseManagementGUI::$requested_group_members

protected

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

Referenced by createTeamsFromGroupsObject().

◆ $requested_idl_id

string ilExerciseManagementGUI::$requested_idl_id

protected

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

◆ $requested_learning_comments

array ilExerciseManagementGUI::$requested_learning_comments

protected

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

◆ $requested_marks

array ilExerciseManagementGUI::$requested_marks

protected

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

Referenced by saveStatusAllObject(), and saveStatusParticipantObject().

◆ $requested_member_id

int ilExerciseManagementGUI::$requested_member_id = 0

protected

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

Referenced by executeCommand(), openSubmissionViewObject(), and saveCommentForLearnersObject().

◆ $requested_part_id

int ilExerciseManagementGUI::$requested_part_id = 0

protected

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

Referenced by addSubTabs(), downloadSubmissionsObject(), getMultiActionUserIds(), saveStatusParticipantObject(), and showParticipantObject().

◆ $requested_status

array ilExerciseManagementGUI::$requested_status

protected

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

Referenced by saveStatusAllObject(), and saveStatusParticipantObject().

◆ $requested_tutor_notices

array ilExerciseManagementGUI::$requested_tutor_notices

protected

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

Referenced by saveStatusAllObject(), and saveStatusParticipantObject().

◆ $requested_user_login

string ilExerciseManagementGUI::$requested_user_login

protected

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

◆ $selected_ass_ids

array ilExerciseManagementGUI::$selected_ass_ids

protected

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

◆ $selected_participants

array ilExerciseManagementGUI::$selected_participants

protected

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

Referenced by downloadSubmissionsObject().

◆ $service

InternalService ilExerciseManagementGUI::$service

protected

Definition at line 73 of file class.ilExerciseManagementGUI.php.

Referenced by __construct().

◆ $tabs_gui

ilTabsGUI ilExerciseManagementGUI::$tabs_gui

protected

Definition at line 61 of file class.ilExerciseManagementGUI.php.

Referenced by addSubTabs(), adoptTeamsFromGroupObject(), and executeCommand().

◆ $task_factory

TaskFactory ilExerciseManagementGUI::$task_factory

protected

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

◆ $toolbar

ilToolbarGUI ilExerciseManagementGUI::$toolbar

protected

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

Referenced by membersObject(), showGradesOverviewObject(), and showParticipantObject().

◆ $tpl

ilGlobalTemplateInterface ilExerciseManagementGUI::$tpl

protected

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

Referenced by adoptTeamsFromGroupObject(), confirmDeassignMembersObject(), handleIndividualDeadlineCallsObject(), initIndividualDeadlineModal(), membersObject(), showGradesOverviewObject(), showMultiFeedbackConfirmationTableObject(), showMultiFeedbackObject(), and showParticipantObject().

◆ $tutor_feedback_file

TutorFeedbackFileManager ilExerciseManagementGUI::$tutor_feedback_file

protected

Definition at line 56 of file class.ilExerciseManagementGUI.php.

◆ $ui_factory

Factory ilExerciseManagementGUI::$ui_factory

protected

Definition at line 64 of file class.ilExerciseManagementGUI.php.

◆ $ui_renderer

Renderer ilExerciseManagementGUI::$ui_renderer

protected

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

◆ $user

ilObjUser ilExerciseManagementGUI::$user

protected

Definition at line 72 of file class.ilExerciseManagementGUI.php.

◆ $zip

ZipAdapter ilExerciseManagementGUI::$zip

protected

Definition at line 52 of file class.ilExerciseManagementGUI.php.

◆ FEEDBACK_FULL_SUBMISSION

const ilExerciseManagementGUI::FEEDBACK_FULL_SUBMISSION = "submission_feedback"

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

◆ FEEDBACK_ONLY_SUBMISSION

const ilExerciseManagementGUI::FEEDBACK_ONLY_SUBMISSION = "submission_only"

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

◆ GRADE_FAILED

const ilExerciseManagementGUI::GRADE_FAILED = "failed"

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

◆ GRADE_NOT_GRADED

const ilExerciseManagementGUI::GRADE_NOT_GRADED = "notgraded"

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

Referenced by ilExAssignmentReminder\parseGradeReminders().

◆ GRADE_PASSED

const ilExerciseManagementGUI::GRADE_PASSED = "passed"

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

◆ VIEW_ASSIGNMENT

const ilExerciseManagementGUI::VIEW_ASSIGNMENT = 1

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

◆ VIEW_GRADES

const ilExerciseManagementGUI::VIEW_GRADES = 3

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

◆ VIEW_PARTICIPANT

const ilExerciseManagementGUI::VIEW_PARTICIPANT = 2

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

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

Modules/Exercise/classes/class.ilExerciseManagementGUI.php

Public Member Functions

Data Fields

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ addMembersObject()

◆ addSubTabs()

◆ addUserFromAutoCompleteObject()

◆ adoptTeamsFromGroupObject()

◆ backToCurrentOverview()

◆ cancelMultiFeedbackObject()

◆ collectFeedbackDataFromPeer()

◆ compareTextAssignmentsObject()

◆ confirmDeassignMembersObject()

◆ copyFileToWebDir()

◆ createTeamsFromGroupsObject()

◆ createTeamsObject()

◆ deassignMembersObject()

◆ dissolveTeamsObject()

◆ downloadMultiFeedbackZipObject()

◆ downloadSelectedObject()

◆ downloadSubmissionsObject()

◆ executeCommand()

◆ exportExcelObject()

◆ getEvaluationModal()

◆ getEvaluationModalForm()

◆ getMultiActionUserIds()

◆ getMultiFeedbackForm()

◆ getReportPanel()

◆ getSubmissionZipFilePath()

◆ getViewBack()

◆ getWebFilePathFromExternalFilePath()

◆ handleIndividualDeadlineCallsObject()

◆ handleMultiFeedbackUploadResult()

◆ initFilter()

◆ initGroupForm()

◆ initIndividualDeadlineForm()

◆ initIndividualDeadlineModal()

◆ initSubmission()

◆ membersApplyObject()

◆ membersObject()

◆ membersResetObject()

◆ openSubmissionPrintViewObject()

◆ openSubmissionViewObject()

◆ parseIndividualDeadlineData()

◆ redirectFeedbackMailObject()

◆ removeUserSubmissionFilesFromWebDir()

◆ saveCommentForLearnersObject()

◆ saveEvaluationFromModalObject()

◆ saveGradesObject()

◆ saveMultiFeedbackObject()

◆ saveStatus()

◆ saveStatusAllObject()

◆ saveStatusParticipantObject()

◆ saveStatusSelectedObject()

◆ selectAssignmentObject()

◆ selectParticipantObject()

◆ sendGradingNotificationObject()

◆ sendMembersObject()

◆ setBackToMembers()

◆ setFailedObject()

◆ setIndividualDeadlineObject()

◆ setPassedObject()

◆ setSingleStatus()

◆ showGradesOverviewObject()

◆ showMultiFeedbackConfirmationTableObject()

◆ showMultiFeedbackObject()

◆ showParticipantApplyObject()

◆ showParticipantObject()

◆ showParticipantResetObject()

◆ uploadMultiFeedbackObject()

◆ waitingDownloadObject()

Field Documentation

◆ $access

◆ $ass_id

◆ $assignment

◆ $ctrl