.. _pt Proctored Session Results:

###################################################
Viewing Proctored Session Results with Proctortrack
###################################################

To review individual violation videos and screenshots, follow these steps:

#. In the LMS, open the Proctortrack Review Dashboard by navigating to the **edX Instructor Dashboard** 
   -> **Special Exams** tab -> **Review Dashboard**.

#. The Verificient **Proctortrack Review Dashboard** will load inline in the LMS. 

#. Navigate to the **Quiz List** tab and locate the exam you want to review.

#. Click on **View Sessions** to open the list of learners who took the exam

#. Review all learners who are flagged as “Require Attention” as follows.

#. To review an individual learner’s session, click on the learner’s name to pop out 
   their detailed exam results in a new tab. Here you can review their exam data, including Video 
   Monitoring, Online Violations, Verification scans, and Onboarding tabs to understand what infractions 
   (if any) were flagged as suspicious

#. If the suspicious behavior is deemed to be in violation of proctoring rules of your course, 
   select **Fail** to fail the learner and set their grade to 0. Learners will get an email informing them that they did not pass proctoring review, and their grade was set to 0. 

#. If needed, you can later revert this decision by clicking **Pass** to pass the learner and 
   restore their original exam grade.

#. If needed, you can download the violation screenshot and data by clicking the **Export Data arrow**.

To see a summary of proctored exam results, you use the Proctored Exam Results
report. This report is a .csv file that you can download from the instructor
dashboard. You can use this report to view proctoring results for all learners,
or :ref:`determine whether a specific learner has passed the proctoring
review<Determine if Learner Passed Proctoring Review>`.

.. note::
 The Proctored Exam Results report contains information about the proctoring
 review. The report does not include information about the learner's score on
 the exam. A learner might pass the proctoring review but not earn a high
 enough score to pass the exam itself.

For more information about the Proctored Exam Results report, see the following
sections.

.. contents::
  :local:
  :depth: 1

.. _Viewing PT Proctored Session Results:

*********************************************
Download the Proctored Exam Results Report
*********************************************

At any time after learners have taken the proctored exam in your course, you
can download a .csv file that displays the current status of the proctoring
session for participating learners.

To generate and download the Proctored Exam Results report, follow these
steps.

.. important::
   This report contains confidential, personally identifiable data. Be sure to
   follow your institution's data stewardship policies when you open or save
   this report.

#. View the live version of your course.

#. In the LMS, select **Instructor**, then select **Data Download**.

#. In the **Reports** section, select **Generate Proctored Exam Results
   Report**.

   A status message indicates that the report generation process is in
   progress. This process can take some time to complete. You can navigate away
   from this page while the process runs.

#. To check the progress of the report generation, reload the page in your
   browser and scroll to the **Pending Tasks** section. The table shows the
   status of active tasks.

   When the report is complete, a linked .csv file name becomes available in
   the **Reports Available for Download** section. The most recently generated
   reports appear at the top of the list.

   File names are in the following format.

   ``{course_id}_proctored_exam_results_report_{datetime}.csv``

#. To download a report file, select the link for the report you requested.
   The .csv file begins downloading automatically.

.. note::
   To prevent the accidental distribution of learner data, you can download
   exam result report files only by clicking the links on this page. These
   links expire after 5 minutes. If necessary, refresh the page to generate new
   links.

#. When the download is complete, open the .csv files in a spreadsheet
   application to sort, graph, and compare data.

.. _PT Proctored Session Results File:

********************************************
Interpret the Proctored Exam Results Report
********************************************

The Proctored Exam Results report contains the following fields.

.. list-table::
   :widths: 30 55
   :header-rows: 1

   * - Column
     - Description
   * - course_id
     - The ID of the course.
   * - exam_name
     - The name of the proctored exam in the body of the course.
   * - username
     - The username that identifies the learner taking the proctored exam.
   * - email
     - The email address that identifies the learner taking the proctored exam.
   * - attempt_code
     - An identifier for the exam attempt. The attempt code is an
       internal identifier and is included in the report for use in
       troubleshooting.
   * - allowed_time_limit_mins
     - The amount of time in minutes that this learner was allotted for
       completing the exam.
   * - is_sample_attempt
     - Indicates whether this exam attempt was for a practice exam.
   * - started_at
     - The date and time that the learner started to take the proctored exam.
   * - completed_at
     - The date and time that the learner submitted the proctored exam.
   * - status
     - The current status of the proctoring session as a whole. The proctoring
       session encompasses the time from when the learner chooses to take the
       proctored exam until the proctored exam review is complete. If the
       proctored exam review is complete, the value in the ``review_status``
       column affects the value in this column.

       For possible values in the status column and an explanation of each
       value, see :ref:`Proctoring Results Status Column`.

   * - review_status
     - The current status of the proctoring exam review by
       Proctortrack/the course team. If the proctored exam review is
       complete, the value in this column affects the value in the
       ``status`` column.

       For possible values and an explanation of each value, see
       :ref:`Proctoring Results Review Status Column PT`.

   * - Suspicious Count
     - Number of incidents during the exam that Proctortrack marked as
       "Suspicious".
   * - Suspicious Comments
     - The comments that Proctortrack entered for each "Suspicious"
       incident, separated by semicolons (;).
   * - Rules Violation Count
     - Number of incidents during the exam that Proctortrack marked as
       "Rules Violation".
   * - Rules Violation Comments
     - The comments that Proctortrack entered for each "Rules Violation"
       incident, separated by semicolons (;).

.. _Proctoring Results Status Column:

===============================
Values in the ``status`` Column
===============================

The following table describes the possible values in the ``status`` column.

.. list-table::
   :widths: 30 55
   :header-rows: 1

   * - Value
     - Description
   * - completed
     - The learner has completed the proctored exam.
   * - created
     - The exam attempt record has been created, but the exam has not yet been
       started.
   * - declined
     - The learner declined to take the exam as a proctored exam.
   * - error
     - An error has occurred with the exam.
   * - expired
     - The course end date passed before the learner completed the proctored
       exam.
   * - ready_to_start
     - The exam attempt record has been created. The learner still needs to
       start the exam.
   * - ready_to_submit
     - The learner has completed but not yet submitted the proctored exam.
   * - rejected
     - The proctoring session review has been completed, and the learner has
       not passed the review. The learner receives a value of "Unsatisfactory"
       on the learner exam page and in a notification email message.
       Additionally, the learner automatically receives a score of 0 for the
       exam. For most courses, the learner is no longer eligible for academic
       credit.

       This value results from a value of "Suspicious" in the
       :ref:`review_status<Proctoring Results Review Status Column PT>`
       column after a member of the course team marks the exam session
       a failure in the Proctortrack dashboard.

   * - second_review_required
     - The exam attempt has been reviewed and the review team has determined
       that the exam requires additional evaluation. Course teams
       should perform this second round of review, as described
       :ref:`above<pt Proctored Session Results>`

       This status results from a value of "Suspicious" in the
       :ref:`review_status<Proctoring Results Review Status Column PT>` column.

   * - started
     - The learner has started the proctored exam.
   * - submitted
     - The learner has completed the proctored exam and results have been
       submitted for review.
   * - timed_out
     - The proctored exam has timed out.
   * - verified
     - The proctoring session review has been completed, and the learner has
       passed the review. The learner receives a value of "Satisfactory" on the
       learner exam page and in a notification email message.

       This value results from a value of "Clean" or "Rules Violation" in the
       :ref:`review_status<Proctoring Results Review Status Column PT>` column.


.. _Proctoring Results Review Status Column PT:

======================================
Values in the ``review_status`` Column
======================================

After learners complete a proctored exam, a reviewer from the proctoring
service provider reviews the exam according to specific criteria, including the
:ref:`Online Proctoring Rules <CA Online Proctoring Rules>`. The value in the
``review_status`` column shows the outcome of the proctored exam review.

Additionally, the value in the ``review_status`` column affects the following
information for the course team and for the learner.

* The values in the ``status`` column.
* The proctoring result that is visible on the learner exam page and in the
  email notification that the learner receives.

For example, if the ``review_status`` column has a value of "Clean", the value
in the ``status`` column is "verified". On the learner exam page and in the
email notification, the status of the exam is "Satisfactory".

If the ``review_status`` column has a value of "Suspicious", the value
in the ``status`` column is "second_review_required" or "rejected". If
the ``status`` is "rejected", then on the learner exam page and in the email
notification, the status of the exam is "Unsatisfactory".

The following table describes the possible values in the ``review_status``
column.

.. list-table::
   :widths: 30 20 55
   :header-rows: 1

   * - Value
     - Exam Result
     - Description
   * - Clean
     - Pass
     - No rules violations or suspicious incidents occurred. The learner has
       passed the proctoring review.

       This value causes a value of "verified" in the ``status`` column. The
       learner receives a result of "Satisfactory" for the proctored exam.

   * - Not Reviewed
     - n/a
     - The proctoring review is not yet complete.
   * - Rules Violation
     - Pass
     - An incident occurred that violates proctored exam rules, but the
       incident does not compromise exam integrity. For example, music may be
       playing. The learner has passed the proctoring review.

       This value causes a value of "verified" in the ``status`` column. The
       learner receives a result of "Satisfactory" for the proctored exam.

   * - Suspicious
     - Fail
     - An incident has occurred that directly compromises exam integrity. For
       example, cheating might have occurred. The learner has failed the
       proctoring review.

       This value causes a value of "second_review_required" or
       "rejected" in the ``status`` column. The learner receives a
       result of "Unsatisfactory" for the proctored exam in the latter
       case.  The learner also receives a score of 0 on the exam. In
       most courses, the learner is no longer eligible for academic
       credit.


.. _Determine if Learner Passed Proctoring Review:

*******************************************************
Determine if a Learner Passed the Proctored Exam Review
*******************************************************

To determine whether a specific learner passed the proctored exam review, you
can either view the Proctored Session Results report or view the course as the
learner.

=========================================
View the Proctored Session Results Report
=========================================

#. Download and open the Proctored Session Results report.
#. In the row for the learner, check the ``status`` column.

   * If the value in the column is "verified", the learner passed the review.
   * If the value is "rejected", the learner did not pass the review. The
     learner automatically receives a score of 0 on the exam. Additionally, for
     most courses, the learner is no longer eligible for academic credit.

==============================
View the Course as the Learner
==============================

#. :ref:`View the course as the learner that you want<Roles for Viewing Course
   Content>`.
#. Open the page for the proctored exam.

On the page, the learner's status is visible as "Pending", "Satisfactory", or
"Unsatisfactory".
