Merge pull request #136 from SafeExamBrowser/docu

Docu

docs/index.rst

@@ -21,5 +21,6 @@ Table of Content
    configurations
    exams
    monitoring
+   screen_proctoring
    troubleshooting
 

docs/screen_proctoring.rst

@@ -0,0 +1,209 @@
+Screen Proctoring
+===========
+
+Overview
+---------
+
+SEB Screen Proctoring is an integral component of the SEB Ecosystem, designed to monitor student screens during digital examinations.
+This tool captures and displays screenshots taken by SEB, ensuring a secure and controlled testing environment.
+
+Enable Screen Proctoring after an exam is created in the exam view.
+
+.. image:: images/screen_proctoring/enable_screen_proctoring.png
+    :align: center
+    :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/docu/docs/images/screen_proctoring/enable_screen_proctoring.png
+
+**Enable Screen Proctoring**
+
+
+SEB Server needs to send an instructions to SEB to capture the screen and send the screenshot back to the server.
+To do this enable screen proctoring in the SEB Settings.
+
+.. image:: images/screen_proctoring/enable_screen_proctoring_seb_settings.png
+    :align: center
+    :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/docu/docs/images/screen_proctoring/enable_screen_proctoring_seb_settings.png
+
+**Enable Screen Proctoring in SEB Settings**
+
+
+SEB-Server and SEB are now ready to capture and to display screenshots.
+Navigate to exam monitoring and click the button in the Screen Proctoring section. A new tab will be opened.
+
+.. image:: images/screen_proctoring/open_screen_proctoring.png
+    :align: center
+    :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/docu/docs/images/screen_proctoring/open_screen_proctoring.png
+
+
+Gallery View
+---------
+
+- When a SEB is connected to SEB-Server and the user logged in to LMS a tile with the latest screenshot will appear.
+- Press the "Grid-Size"-Drop-Down to change the displayable sessions per screen to 4, 9 or 16.
+
+- Use the arrow buttons and the left and right on the screen to change windows. The current page and the amount of live sessions / total sessions is display next to the grid selection.
+
+
+.. image:: images/screen_proctoring/gallery_view_live_grid_selection.png
+    :align: center
+    :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/docu/docs/images/screen_proctoring/gallery_view_live_grid_selection.png
+
+
+- Use your mouse to hover over a tile or press the tab key. A "selected" tile reveals information and actions for the session.
+- To change view preferences press the settings icon in the top right corner.
+- Toggling "Show Name" and "Show IP" reveals the the Name and IP of the selected session.
+- Per default all the sessions are sorted by lastname in ascending order. To change this press the "Sort by Name"-button.
+- The camera icon opens the Proctoring View in a new tab. See chapter "Proctoring View" for more infos.
+- Click on the "expand"-icon to enlarge the screenshot.
+
+.. image:: images/screen_proctoring/gallery_view_settings.png
+    :align: center
+    :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/docu/docs/images/screen_proctoring/gallery_view_settings.png
+
+- The SEB-Client additionally sends metadata about the screenshot
+- Metadata changes according to the content displayed on the screenshot
+- Refer to the chapter "Metadata" for more details
+- The camera icon opens the Proctoring View in a new tab. See chapter "Proctoring View" for more infos.
+- Close the expanded view either by clicking on the collapse button or somewhere outside of the screenshot
+
+
+.. image:: images/screen_proctoring/gallery_view_expanded.png
+    :align: center
+    :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/docu/docs/images/screen_proctoring/gallery_view_expanded.png
+
+(kann man evtl. weg lassen)
+- A message box indicates that there are no live sessions available
+- As soon as a sessions are connected the message box will disappear
+
+
+Running Exams
+---------
+
+To get an overview of all running exams which your user has access to click on the "Running Exams" item in the navigation bar on the left side.
+
+- By Default the exams are sorted by "Exam Start-Time" in ascending order
+- click on any table header to change the sorting according to your needs
+- click on the link the "Group" column to get to the gallery view of the group
+
+.. image:: images/screen_proctoring/running_exam_no_selection.png
+    :align: center
+    :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/docu/docs/images/screen_proctoring/running_exam_no_selection.png
+
+By clicking on the settings icon in the menu bar two options are displayed.
+
+- Select "Show past exams" to display all finished exams (red)
+- Select "Show upcoming exams" to display all exams which are planed for the future
+
+
+.. image:: images/screen_proctoring/running_exam_selection.png
+    :align: center
+    :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/docu/docs/images/screen_proctoring/running_exam_selection.png
+
+
+
+Proctoring View
+---------
+
+The proctoring view shows a recorded or live session in more detail.
+
+To open a proctoring view of a sessions either
+
+- Click on the camera icon in the gallery view
+- Use the search feature
+- Directly type in the url in the address bar: https://<your host>/recording/<sessionUuid>
+
+A session can either be live or recorded.
+- A live session is indicated by the "Live"-Button
+- Navigating to the proctoring view during a live session always displays the latest screenshot and updates it accordingly
+- Use the slider as any other video player
+- This is also possible during a live session
+- Click on the "Live"-Button to jump to the latest screenshot
+
+.. image:: images/screen_proctoring/proctoring_overview_live.png
+    :align: center
+    :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/docu/docs/images/screen_proctoring/proctoring_overview_live.png
+
+
+- The "Details"-Box on the right side displays information about the session and the current screenshot
+- "SEB Session Info" is static
+- "Screenshot Metadata" dynamically changes for every Screenshot
+- Refer to the chapter "Metadata" for more details
+
+
+.. image:: images/screen_proctoring/proctoring_overview.png
+    :align: center
+    :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/docu/docs/images/screen_proctoring/proctoring_overview.png
+
+
+- The "Live"-Button disappears when the sessions disconnects from the server
+- Set the playback speed with the "settings"-icon according to you preferences
+- The current screenshot and the total amount of screenshot is display in the "Total"-Row
+
+
+
+Search
+---------
+
+The search functionality is a powerful feature to search and find sessions and screenshots.
+Click on the "Search" item in the navigation bar on the left side.
+
+**Form**
+
+The upper part of the page is the search form.
+There are 4 different categories of search criteria:
+
+- exam data
+- session / user data
+- screenshot metadata
+- time data
+
+Use the form fields and the time / date selection to tailor the search result to your needs.
+
+.. image:: images/screen_proctoring/search_form.png
+    :align: center
+    :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/docu/docs/images/screen_proctoring/search_form.png
+
+
+**Search Results**
+
+The search results are grouped into days and sorted by date in descending order.
+Use the "date"-button on the right side to change the sort oder.
+
+- Clicking on any date expands the panel and displays all sessions (a session is a student using SEB) with recordings on that day
+- Per default the sessions are sorted by "Start-Time" in descending order
+- Click on the table header to change the sorting according to your preferences
+- A click on the down facing arrow on the right side lists all screenshots of that given student
+
+
+.. image:: images/screen_proctoring/search_results_sessions.png
+    :align: center
+    :target: https://raw.githubusercontent.com/SafeExamBrowser/seb-server/docu/docs/images/screen_proctoring/search_results_sessions.png
+
+- Per default the screenshot are sorted by "Capture-Time" in ascending order
+- The screenshots are grouped into the metadata "Application / Website"
+- Grouping means that each successive screenshot that has the same "Application / Website" metadata is placed in the same group
+- Click on the camera icon on the right side to open the proctoring view at this exact time
+
+.. note::
+      If the session is still live the proctoring view won't open at the given time but instead jumps to the latest image.
+
+
+
+Metadata
+---------
+
+Metadata in context of the Screen Proctoring component are data which belong to a screenshot.
+They describe the content of the captured screen.
+
+Currently the SEB-Client captures the following 5 metadata (additional values might follow in future releases):
+
+    - Application: The name of the actual application that is used and focused
+        - e.g. "SafeExamBrowser.Client.exe", "calc.exe"
+
+    - URL: The URL of the browser tab with current focus
+        - e.g. "http://google.com", "http://moodle.com/exam123"
+
+    - Activity Details: The activity which triggerd the screenshot
+        - e.g. "A key has been pressed", "Left mouse button has been pressed"
+
+    - Window Title: The window title of the focused window
+        - e.g. "Google Homepage", "Moodle Exam 123"