diff --git a/docs/exam.rst b/docs/exam.rst index b4764a4f..508ce36c 100644 --- a/docs/exam.rst +++ b/docs/exam.rst @@ -170,3 +170,25 @@ If you have "Exam Administrator" privileges you are able to entirely delete an e - Within the delete exam dialog you see a list of a dependencies that also will be deleted. Please check them carefully before deletion. - Use the below action to either delete the exam or cancel the action and go back to the exam view. +** Archive an exam** + +Since SEB Server version 1.4 it is possible to archive an exam that has been finished. An archived exam and all its data is still available +on the SEB Server but read only and the exam is not been updated from the LMS data anymore and it is not possible to run this exam again. + +This is a good use-case to organize your exams since archived exam are not shown in the Exam list with the default filter anymore. They are +only shown if the status filter of the exam list is explicitly set to Archived status. An they are shown within the new "Finished Exam" +section in the monitoring view. + +.. image:: images/exam/archiveExamsFilter.png + :align: center + :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/exam/archiveExamsFilter.png + +This is also a good use-case if you want to remove an LMS and LMS Setup but still want to be able to access the exams data on the SEB Server. +In this case you can archive all exams from that LMS Setup before deactivating or deleting the respective LMS Setup. + +To archive a finished exam you just have to use the "Archive Exam" action on the right action pane of the exam view: + +.. image:: images/exam/archiveExam1.png + :align: center + :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/exam/archiveExam1.png + diff --git a/docs/exam_template.rst b/docs/exam_template.rst index 1e0d6770..42ead0cf 100644 --- a/docs/exam_template.rst +++ b/docs/exam_template.rst @@ -55,6 +55,14 @@ And you are able to add/edit/remove monitoring indicators for the exam template .. image:: images/exam_template/indicator.png :align: center :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/exam_template/indicator.png + +There are also proctoring settings available since SEB Server version 1.4 for the exam template. They just have the same settings and +look like the ones on the Exam and will get copied for an exam imported with the respective template that defines the proctoring settings. + +.. image:: images/exam_template/proctoringSettings.png + :align: center + :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/exam_template/proctoringSettings.png + Import Exam with Template ------------------------- diff --git a/docs/images/exam_config/bulkActionSelection1.png b/docs/images/exam_config/bulkActionSelection1.png new file mode 100644 index 00000000..d0c2f2a9 Binary files /dev/null and b/docs/images/exam_config/bulkActionSelection1.png differ diff --git a/docs/images/exam_config/bulkActionSelection2.png b/docs/images/exam_config/bulkActionSelection2.png new file mode 100644 index 00000000..2f1913e0 Binary files /dev/null and b/docs/images/exam_config/bulkActionSelection2.png differ diff --git a/docs/images/exam_config/bulkStateChange1.png b/docs/images/exam_config/bulkStateChange1.png new file mode 100644 index 00000000..6d84fd4e Binary files /dev/null and b/docs/images/exam_config/bulkStateChange1.png differ diff --git a/docs/images/exam_config/bulkStateChange2.png b/docs/images/exam_config/bulkStateChange2.png new file mode 100644 index 00000000..7e4de905 Binary files /dev/null and b/docs/images/exam_config/bulkStateChange2.png differ diff --git a/docs/images/exam_config/bulkStateChange3.png b/docs/images/exam_config/bulkStateChange3.png new file mode 100644 index 00000000..40ffcbcf Binary files /dev/null and b/docs/images/exam_config/bulkStateChange3.png differ diff --git a/docs/images/exam_template/proctoringSettings.png b/docs/images/exam_template/proctoringSettings.png new file mode 100644 index 00000000..cd170bb5 Binary files /dev/null and b/docs/images/exam_template/proctoringSettings.png differ diff --git a/docs/images/monitoring/finishedClientConnection.png b/docs/images/monitoring/finishedClientConnection.png new file mode 100644 index 00000000..52c4226b Binary files /dev/null and b/docs/images/monitoring/finishedClientConnection.png differ diff --git a/docs/monitoring.rst b/docs/monitoring.rst index ae24dc71..dda9f633 100644 --- a/docs/monitoring.rst +++ b/docs/monitoring.rst @@ -181,7 +181,39 @@ A Student as well as a proctor is then able to use all the features of the meeti - In Zoom it is not possible to fully control a participant microphone. Therefore it may happen that participant can hear each other even if no proctor is in the meeting. - Within Jitsi Meet service when a proctor leaves the room it currently happens that a random participant became host/moderator since it is not possible in Jitsi Meet to have a meeting without host. We try to mitigate the problem with the `moderator plugin `_ or `Jitsi Meet SaS `_ - In both services while broadcasting, it is not guaranteed that a student always see the proctor. Usually the meeting service shows or pins the participant that is currently speaking automatically. - + + +Finished Exams +-------------- + +Since SEB Server version 1.4 there is a new section "Finished Exams" within the monitoring section to view finished and archived exams +like you do within the monitoring. You see all the SEB connections that has been connected to the exam when running and are able to view +particular SEB client connection details by either double-click on a SEB client connection entry in the list or by selection and using the View action +on the right action pane. + +In the "Finished Exams" list you can see all finished or archived exams and filter the list by Name, State and Type. + +.. image:: images/monitoring/finishedExams.png + :align: center + :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/monitoring/finishedExams.png + +To see a particular finished or archived exam you can just double-click in the list entry or use the View action on the right action pane. +In the exam view you see all SEB connections that has been connected to the exam during the exam run just like in the usual monitoring view +but with no update since the SEB connections are not active and the data is not changing anymore. You are able to filter the list by +User or Session Info, Connection Info or Status and are also be able to sort the list even for indicator columns. + +.. image:: images/monitoring/finishedExam.png + :align: center + :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/monitoring/finishedExam.png + +As in the usual monitoring view, you can show SEB client connection details by double-clicking on a list entry or by selecting a list entry +and use the View action on the right action pane. +In the detail view you see the same information for a particular SEB client connection as within the usual monitoring view. You can view +the SEB client logs of a SEB client connection here and analyze it after the exam was running. + +.. image:: images/monitoring/finishedClientConnection.png + :align: center + :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/monitoring/finishedClientConnection.png All SEB Client Logs diff --git a/docs/overview.rst b/docs/overview.rst index 24adcb9b..fc66f5e8 100644 --- a/docs/overview.rst +++ b/docs/overview.rst @@ -204,4 +204,16 @@ After correcting the missing or wrong input and saveing the form again, the SEB .. note:: If you navigate away from a form in edit mode, the GUI will inform you about possible data loss on this action and will prompt you to - proceed or abort the action. \ No newline at end of file + proceed or abort the action. + +** Actions ** + +Actions are usually placed on the right action pane of the application and belongs to the actual site or view. There are generally three types of actions: + +- Form Actions that directly belongs to the actual view or object and either save, manipulate or create a new object. +- List Action - Single Selection are actions on a list page that effects the selected list entry. +- List Action - Multi Selection are actions that refer to the current multi selection on a list and apply for every selected item. + +.. note:: + List action are disabled when nothing is selected from the list and get enabled as soon as one or more list items are selected. + Actions that are considdered single selection actions, and are used with a multi selection on the list will only affect the first selected item in the list. \ No newline at end of file