Collaboration diagram for ilExerciseManagementGUI:

Public Member Functions
	executeCommand ()

	addSubTabs (string $a_activate)

	waitingDownloadObject ()

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

	downloadSubmissionsObject ()

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

	initMultiFeedbackForm (int $a_ass_id)

	showMultiFeedbackObject (ilPropertyFormGUI $a_form=null)
	Show multi-feedback screen. More...

	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)

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

Protected Attributes
ILIAS Repository HTML HTMLUtil	$html_util

ILIAS Exercise InternalGUIService	$gui

ILIAS HTTP Services	$http

ilCtrl	$ctrl

ilTabsGUI	$tabs_gui

ilLanguage	$lng

ilAccessHandler	$access

ilGlobalPageTemplate	$tpl

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

Class ilExerciseManagementGUI.

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

ilExerciseManagementGUI: ilFileSystemGUI, ilRepositorySearchGUI ilExerciseManagementGUI: ilExSubmissionTeamGUI, ilExSubmissionFileGUI ilExerciseManagementGUI: ilExSubmissionTextGUI, ilExPeerReviewGUI

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

Member Function Documentation

◆ addMembersObject()

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

Definition at line 894 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 302 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 868 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 1581 of file class.ilExerciseManagementGUI.php.

References $ctrl, $lng, $tabs_gui, $tpl, getViewBack(), initGroupForm(), ilGlobalPageTemplate\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:

◆ cancelMultiFeedbackObject()

ilExerciseManagementGUI::cancelMultiFeedbackObject ( )

Cancel Multi Feedback.

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

References ILIAS\Repository\ctrl().

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

Here is the call graph for this function:

◆ collectFeedbackDataFromPeer()

ilExerciseManagementGUI::collectFeedbackDataFromPeer ( array $a_data )

Definition at line 2309 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 594 of file class.ilExerciseManagementGUI.php.

References $data, collectFeedbackDataFromPeer(), ILIAS\UI\examples\Symbol\Glyph\Filter\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 1246 of file class.ilExerciseManagementGUI.php.

References $ctrl, $lng, $tpl, getMultiActionUserIds(), ilUserUtil\getNamePresentation(), ilGlobalPageTemplate\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 2244 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 1645 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 1501 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 1275 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 1550 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 1795 of file class.ilExerciseManagementGUI.php.

                                                     : void
     {
         $this->assignment->sendMultiFeedbackStructureFile($this->exercise);
     }

◆ downloadSubmissionsObject()

ilExerciseManagementGUI::downloadSubmissionsObject ( )

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

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

                                                : 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
         );
 
         if ($download_task->run()) {
             $this->tpl->setOnScreenMessage('success', $this->lng->txt('exc_down_files_started_bg'), true);
         }
 
         if ($this->assignment !== null) {
             $this->ctrl->redirect($this, "members");
         } else {
             $this->ctrl->redirect($this, "showParticipant");
         }
     }

Here is the call graph for this function:

◆ executeCommand()

ilExerciseManagementGUI::executeCommand ( )

Exceptions

ilCtrlException
ilExcUnknownAssignmentTypeException

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

References $ctrl, $GLOBALS, $lng, $ref_id, $tabs_gui, addSubTabs(), ilTabsGUI\clearTargets(), ilFSStorageExercise\create(), ILIAS\Repository\ctrl(), ilUserUtil\getNamePresentation(), getViewBack(), initSubmission(), ILIAS\Repository\lng(), 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) {
             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->exercise->sendFeedbackFileNotification(
                         $pcommand["name"] ?? "",
                         $noti_rec_ids,
                         $this->assignment->getId()
                     );
                 }
                 $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 "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;
 
             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 1487 of file class.ilExerciseManagementGUI.php.

References exit.

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

◆ getEvaluationModal()

ilExerciseManagementGUI::getEvaluationModal ( array $a_data )

Definition at line 751 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 788 of file class.ilExerciseManagementGUI.php.

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

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 1164 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(), and sendMembersObject().

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

◆ getReportPanel()

ilExerciseManagementGUI::getReportPanel ( array $a_data )

Exceptions

ilDateTimeException

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

References ILIAS\LTI\ToolProvider\$key, ilObject\_lookupType(), ILIAS\Repository\ctrl(), ILIAS\UI\examples\Symbol\Glyph\Filter\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 = $this->lng->txt('not_yet');
         } 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 = $this->lng->txt('not_yet');
 
         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 = $this->lng->txt('not_yet');
         }
 
         $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('grade') . ": " . $this->lng->txt('exc_' . $a_data['status']));
         $feedback_tpl->setVariable("COMMENT", $this->lng->txt('exc_comment') . "<br>" . $a_data['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 2221 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 269 of file class.ilExerciseManagementGUI.php.

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

                                     : 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 2288 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 1916 of file class.ilExerciseManagementGUI.php.

References $ass_id, $id, $post, $res, $tpl, $valid, ilDateTime\_before(), ILIAS\Repository\ctrl(), exit, ilDatePresentation\formatDate(), ilGlobalPageTemplate\getOnLoadCodeForAsynch(), ILIAS\FileDelivery\http(), IL_CAL_UNIX, initIndividualDeadlineForm(), ILIAS\Repository\lng(), 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);
                     }
 
                     $ass->recalculateLateSubmissions();
                 }
 
                 echo "ok";
             }
         }
 
         exit();
     }

Here is the call graph for this function:

◆ initFilter()

ilExerciseManagementGUI::initFilter ( )

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

References $requested_filter_feedback, $requested_filter_status, ILIAS\Repository\ctrl(), ILIAS\UI\examples\Symbol\Glyph\Filter\filter(), ilSubmitButton\getInstance(), 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);
         }
 
         //todo: old school here.
         $submit = ilSubmitButton::getInstance();
         $submit->setCaption("filter");
         $submit->setCommand("listTextAssignment");
         $this->toolbar->addButtonInstance($submit);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ initGroupForm()

ilExerciseManagementGUI::initGroupForm ( )

protected

Definition at line 1601 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 1999 of file class.ilExerciseManagementGUI.php.

References $ass_id, $id, $name, 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 1859 of file class.ilExerciseManagementGUI.php.

References $lng, $tpl, ilGlobalPageTemplate\addJavaScript(), ilGlobalPageTemplate\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:

◆ initMultiFeedbackForm()

ilExerciseManagementGUI::initMultiFeedbackForm ( int $a_ass_id )

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

References $lng, ILIAS\Repository\ctrl(), ilExAssignment\lookupTitle(), ilFileInputGUI\setSuffixes(), and ilLanguage\txt().

Referenced by showMultiFeedbackObject(), and uploadMultiFeedbackObject().

                                                         : ilPropertyFormGUI
     {
         $lng = $this->lng;
 
         $form = new ilPropertyFormGUI();
         $form->addCommandButton("uploadMultiFeedback", $lng->txt("upload"));
         $form->addCommandButton("members", $lng->txt("cancel"));
 
         // multi feedback file
         $fi = new ilFileInputGUI($lng->txt("exc_multi_feedback_file"), "mfzip");
         $fi->setSuffixes(array("zip"));
         $fi->setRequired(true);
         $form->addItem($fi);
 
         $form->setTitle(ilExAssignment::lookupTitle($a_ass_id));
         $form->setFormAction($this->ctrl->getFormAction($this, "uploadMultiFeedback"));
 
         return $form;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ initSubmission()

ilExerciseManagementGUI::initSubmission ( )

protected

Definition at line 288 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 497 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 356 of file class.ilExerciseManagementGUI.php.

References Vendor\Package\$a, $ctrl, $GLOBALS, $lng, $toolbar, $tpl, addSubTabs(), ILIAS\Repository\ctrl(), ilRepositorySearchGUI\fillAutoCompleteToolbar(), ilExAssignmentTeam\getAdoptableGroups(), ilSubmitButton\getInstance(), ilExAssignment\getInstancesByExercise(), initIndividualDeadlineModal(), ILIAS\Repository\lng(), ilGlobalPageTemplate\setContent(), 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");
 
         // 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);
             $button = ilSubmitButton::getInstance();
             $button->setCaption("select");
             $button->setCommand("selectAssignment");
             $ilToolbar->addStickyItem($button);
 
             $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 510 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 2132 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 2140 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(), ilWACSignedPath\signFolderOfStartFile(), and ilFileUtils\unzip().

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);
 
         ilWACSignedPath::signFolderOfStartFile($index_html_file);
 
         $web_filesystem = $DIC->filesystem()->web();
         if ($last_opening > $submission_time && $web_filesystem->has($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);
             if ($file_copied) {
                 ilFileUtils::unzip($file_copied, true);
                 $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);
 
                 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 1884 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 1076 of file class.ilExerciseManagementGUI.php.

References $name, ilObject\_exists(), ilLink\_getLink(), 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 1290 of file class.ilExerciseManagementGUI.php.

References $ass_id, and ilFSWebStorageExercise\deleteUserSubmissionDirectory().

Referenced by deassignMembersObject().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ saveCommentForLearnersObject()

ilExerciseManagementGUI::saveCommentForLearnersObject ( )

Exceptions

ilExcUnknownAssignmentTypeException

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

References $comment, $requested_ass_id, $requested_member_id, $res, ILIAS\Repository\ctrl(), exit, 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->exercise->sendFeedbackFileNotification(
                         "",
                         $reci_ids,
                         $ass_id,
                         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 833 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 519 of file class.ilExerciseManagementGUI.php.

References $ass_id, $ctrl, $data, $id, $lng, ilObject\_exists(), collectFeedbackDataFromPeer(), ILIAS\UI\examples\Symbol\Glyph\Filter\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($this->html_util->strip($v));
             $marks_obj->update();
         }
         foreach ($this->requested_marks as $k => $v) {
             $marks_obj = new ilLPMarks($this->exercise->getId(), (int) $k);
             $marks_obj->setMark($this->html_util->strip($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 1846 of file class.ilExerciseManagementGUI.php.

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

                                              : void
     {
         $this->assignment->saveMultiFeedbackFiles($this->requested_files, $this->exercise);
 
         $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 1388 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
                 $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 1333 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 1300 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 1372 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 911 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 1030 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:

◆ sendMembersObject()

ilExerciseManagementGUI::sendMembersObject ( )

Exceptions

ilExcUnknownAssignmentTypeException

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

◆ setIndividualDeadlineObject()

ilExerciseManagementGUI::setIndividualDeadlineObject ( )

protected

Exceptions

ilExcUnknownAssignmentTypeException

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

◆ showGradesOverviewObject()

ilExerciseManagementGUI::showGradesOverviewObject ( )

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

References $ctrl, $GLOBALS, $lng, $toolbar, $tpl, addSubTabs(), ILIAS\Repository\ctrl(), ilGlobalPageTemplate\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 1824 of file class.ilExerciseManagementGUI.php.

References $tpl, addSubTabs(), and ilGlobalPageTemplate\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 ( ilPropertyFormGUI $a_form = null )

Show multi-feedback screen.

Parameters

ilPropertyFormGUI | null $a_form

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

References $lng, $toolbar, $tpl, addSubTabs(), ILIAS\Repository\ctrl(), ilLinkButton\getInstance(), initMultiFeedbackForm(), ilGlobalPageTemplate\setContent(), ilGlobalPageTemplate\setOnScreenMessage(), and ilLanguage\txt().

Referenced by uploadMultiFeedbackObject().

      : void {
         $ilToolbar = $this->toolbar;
         $lng = $this->lng;
         $tpl = $this->tpl;
 
         $this->tpl->setOnScreenMessage('info', $lng->txt("exc_multi_feedb_info"));
 
         $this->addSubTabs("assignment");
 
         // #13719
         $button = ilLinkButton::getInstance();
         $button->setCaption("exc_download_zip_structure");
         $button->setUrl($this->ctrl->getLinkTarget($this, "downloadMultiFeedbackZip"));
         $button->setOmitPreventDoubleSubmission(true);
         $ilToolbar->addButtonInstance($button);
 
         if ($a_form === null) {
             $a_form = $this->initMultiFeedbackForm($this->assignment->getId());
         }
 
         $tpl->setContent($a_form->getHTML());
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ showParticipantApplyObject()

ilExerciseManagementGUI::showParticipantApplyObject ( )

Definition at line 1007 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 921 of file class.ilExerciseManagementGUI.php.

References $access, $ctrl, $lng, $name, $requested_part_id, $toolbar, $tpl, ilObjUser\_lookupName(), ilObject\_lookupType(), addSubTabs(), ILIAS\Repository\ctrl(), ilOrgUnitPositionAndRBACAccessHandler\filterUserIdsByRbacOrPositionOfCurrentUser(), ilSubmitButton\getInstance(), initIndividualDeadlineModal(), ILIAS\Repository\lng(), ilGlobalPageTemplate\setContent(), 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);
             $button = ilSubmitButton::getInstance();
             $button->setCaption("select");
             $button->setCommand("selectParticipant");
             $ilToolbar->addStickyItem($button);
         }
 
         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 1018 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 1803 of file class.ilExerciseManagementGUI.php.

References Vendor\Package\$e, ILIAS\Repository\ctrl(), initMultiFeedbackForm(), showMultiFeedbackObject(), and ilArrayUtil\stripSlashesArray().

                                                : void
     {
         // #11983
         $form = $this->initMultiFeedbackForm($this->assignment->getId());
         if ($form->checkInput()) {
             try {
                 $this->assignment->uploadMultiFeedbackFile(ilArrayUtil::stripSlashesArray($_FILES["mfzip"]));
                 $this->ctrl->redirect($this, "showMultiFeedbackConfirmationTable");
             } catch (ilException $e) {
                 $this->tpl->setOnScreenMessage('failure', $e->getMessage(), true);
                 $this->ctrl->redirect($this, "showMultiFeedback");
             }
         }
 
         $form->setValuesByPost();
         $this->showMultiFeedbackObject($form);
     }

Here is the call graph for this function:

◆ waitingDownloadObject()

ilExerciseManagementGUI::waitingDownloadObject ( )

Exceptions

ilExcUnknownAssignmentTypeException

Definition at line 340 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();
     }