From 383810907294e11ecc256aee04fa241d7c46c895 Mon Sep 17 00:00:00 2001 From: anhefti Date: Thu, 28 Mar 2024 13:36:34 +0100 Subject: [PATCH] SEBSERV-496 --- docs/connection_config.rst | 2 ++ docs/exam_import.rst | 5 +-- docs/exam_proctoring.rst | 2 +- docs/exam_quit_password.rst | 4 ++- docs/exam_with_url.rst | 66 ++++++++++++++++++++++++++++++++++++- 5 files changed, 72 insertions(+), 7 deletions(-) diff --git a/docs/connection_config.rst b/docs/connection_config.rst index b0078544..85a447bb 100644 --- a/docs/connection_config.rst +++ b/docs/connection_config.rst @@ -100,6 +100,7 @@ feature it is now possible to reduce this choice for a specific Client Configura when SEB loads the respective Connection Configuration. . note:: + Since the Exam selection is stored with SEB Server and not exported to an Connection Configuration it is also possible to change the Exam selection for a certain Connection Configuration after the Connection Configuration was downloaded. SEB will always present the running exams exclusively from actual Exam selection from Connection Configuration on the SEB Server. @@ -114,6 +115,7 @@ these exams with the multi selector. It is also possible to filter the list by t :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/connection_config/examSelection.png + Use Cases --------- diff --git a/docs/exam_import.rst b/docs/exam_import.rst index d11ea50a..e895d480 100644 --- a/docs/exam_import.rst +++ b/docs/exam_import.rst @@ -46,7 +46,7 @@ like name, description, start-, end-time and course-identifier will not be store This means, that the course data has to be modified on the LMS/Assessment Tool side as usual and the SEB Server always takes the actual data from the LMS/Assessment Tool for the course. This has the advantages of the principle of single responsibility and prevents synchronization issues. -You will see the creation page of the new exam with additional information: +You will see the creation page of the new exam with additional information from LMS/Assessment Tool: - **Name**: Is the name of the course, defines on the LMS/Assessment Tool - **LMS/Assessment Tool Setup**: Is the name of the LMS/Assessment Tool Setup on the SEB Server from which the course was imported @@ -71,9 +71,6 @@ typing characters of the name of the user-account you want to apply to automatic specified user that will be added to the list below the input field. To add another user to the selection just click again into the input field and select another user. To remove a selected user from the selection-list, double-click on the specified entry of the selection-list. -.. note:: - At least one user account must be selected for the attribute "Exam Supporter". You are able to change this also later on by editing the exam. - To confirm the import use the "Save Exam" action of the action pane on the right hand side or use "Cancel" if you want to abort the import of the exam and go back to the course list. If you have confirmed and successfully imported the exam, you will see the exam overview page where you are able to edit the details of the exam, apply SEB restrictions of supported by the LMS/Assessment Tool, apply a SEB exam configuration for the exam and define indicators diff --git a/docs/exam_proctoring.rst b/docs/exam_proctoring.rst index cabbe9cf..fa1e13eb 100644 --- a/docs/exam_proctoring.rst +++ b/docs/exam_proctoring.rst @@ -1,6 +1,6 @@ .. _sebProctoringSettings-label: -(Deprecated) Live Proctoring +Live Proctoring (Deprecated) ======================== .. attention:: diff --git a/docs/exam_quit_password.rst b/docs/exam_quit_password.rst index 3be3d65f..e1139767 100644 --- a/docs/exam_quit_password.rst +++ b/docs/exam_quit_password.rst @@ -1,6 +1,6 @@ .. _sebExamQuitPassword-label: -(New) Exam Quit Password +Exam Quit Password (New) ======================== Since SEB Server Version 1.6 it is possible to set the quit-password (usually set in the Exam Configuration/SEB Settings) while @@ -29,12 +29,14 @@ The quit password can be set on Exam creation or import: :align: center :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/exam/quitPasswordImport.png + As well as in the Exam edit view: .. image:: images/exam/quitPasswordEdit.png :align: center :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/exam/quitPasswordEdit.png + If the Exam was created from an LMS/Assessment Tool with SEB Server integration that allows to send the quit-password to the LMS/Assessment Tool for display, SEB Server sends a new quit-password as on save. The LMS/Assessment Tool should therefore also display always the actual quit password. \ No newline at end of file diff --git a/docs/exam_with_url.rst b/docs/exam_with_url.rst index 2cc7b87e..becb9f22 100644 --- a/docs/exam_with_url.rst +++ b/docs/exam_with_url.rst @@ -1,4 +1,68 @@ .. _sebExamWithURL-label: -(New) Exam With URL +Exam With URL (New) ======================== + +This is a new feature since SEB Server Version 1.6 and allows to create SEB Server Exams without the need of a +dedicated LMS/Assessment Tool integration but by providing an course URL, start- and end-type by its own. +SEB will then the given URL use as a start URL and just forward to the given URL page as usual. This of course has +some limitations in comparison to a Exam with LMS/Assessment Tool integration that are described at the end of +this chapter. + +To create a new Exam with URL please select the Exam tab on the left menu pane and the "Add Exam with URL" Action +on the right action pane. Click on the action to open the creation view. This is the same view as on Exam import +put with some fields you have to provide instead of they coming from LMS/Assessment Tool. + +.. image:: images/exam/examWithURL.png + :align: center + :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/exam/examWithURLNew.png + +.. image:: images/exam/examWithURL.png + :align: center + :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/exam/examWithURLNew.png + + + +You are now able to either choose an existing :ref:`exam-template-label` to initialize the new exam with the settings defined within the template +or to set the needed settings only for this exam. If you choose a template, the settings from the template will automatically be added to the exam +on creation and you are still able to modify them afterwards. + +For this kind of Exam you also have to provide additional data that usually comes from LMS/Assessment Tool. + +- The name of the Exam - mandatory +- A description of the Exam - optional +- The start date and time of the Exam - mandatory +- The end date and time of the Exam - optional + +Initially also choose a type for the exam - "Exam Type" - that is currently only used for informational purpose and has no further restrictions or consequences on handling on in SEB Server. +Furthermore you can select and apply all exam supporter that shall be able to see and support this exam while running. To do so, click in the +input field of the attribute "Exam Supporter" to see a drop down list of all available users for selection. To filter the drop down list, start +typing characters of the name of the user-account you want to apply to automatically filter the list. Click on the drop-down list entry to select the +specified user that will be added to the list below the input field. To add another user to the selection just click again into the input field +and select another user. To remove a selected user from the selection-list, double-click on the specified entry of the selection-list. + +To finally create the new Exam use the save action from the right action pane. New you are in the usual Exam view and can +go one with setting up your Exam. + +.. image:: images/exam/examWithURLView.png + :align: center + :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/master/docs/images/exam/examWithURLView.png + +If you want to edit the Exam settings please use the edit action on the right action pane. Here you can also modify +the data that usually comes from LMS/Assessment Tool. You can change name, start- and end-date directly here within +the Exam on the SEB Server. + +**Restrictions** + +There are a few restrictions for an Exam with URL. First of all, since there os no LMS/Assessment Tool binding available, +SEB Server cannot call an LMS/Assessment Tool and restrict access for SEB only with either Config Key or Browser Exam key. +If an LMS/Assessment Tool supports such, one is of course be able to put the Config Key from SEB Server to the LMS manually +by copy und past it. + +The other restriction is about the student login name resolving that is used and shown in the monitoring view of SEB Server. +Since this login name resolving needs a LMS/Assessment Tool binding to request the students LMS account name by SEB Server +this is not possible with this setup. But SEB Server will display other information within the User Name or Session column +of the SEB Server monitoring. SEB Server will show either the client IP address or the client machine name or the client +user device login, depending on what SEB is able to sends to the SEB Server. + +