===== Exam Entry =====
The Exam Entry tool is used to create and maintain Exams.  Maintenance of Exams include the Exam information, the Sections, [[item_entry|Items]], [[item_group_entry|Item Groups]] and [[attachment_entry|Attachments]] that make up the Exam Layout.  The Exam can also be selected to build [[exam_document|Exam Documents]], run [[exam_calculations|Calculations]], maintain [[session_entry|Sessions and Registrations]] and run Exam specific [[exam_reports|reports and exports]]. 

Authorised users may create, modify or expire Exam records.  

Exam entry is reached from the Main Menu, Item Writing → Exam Tools → Exam Entry

{{:menuexamentry.png?200|}}

This takes the user to the Exam entry grid.  For more on grid navigation, click [[general_navigation_grids|here]].

{{:examentry.png?600|}}

=== Special Filters ===
The Exam entry grid has special filter controls in the title bar.
  * Include Prior Versions by default is unchecked.  This means only the Exam records that are current version are displayed.  When checked, all Exam records (including previous versions) are displayed.
  * Include Expired Records by default is unchecked.  This means exam records that have an Expiry Date prior to today are not displayed.  When checked, all Exam records (including expired) are displayed. [[concepts#effective_and_expiry_dates|Effective and Expiry Dates]]
  * Language Selector is used to display language specific fields for the Exam records.  The Title and Description fields for an Exam are language specific.  Selecting a different language from the selector displays the alternate language values for these fields in the Attachment grid.

{{:examentryspecialfilters.png?600|}}

==== Bulk Actions ====
The Exam grid has bulk actions.  Bulk Actions refer to actions taken against a single or multiple selected records. To learn more about selecting records click [[general_navigation_grids#Selecting Records|here]]. If no records are selected when performing a bulk action, a warning message is displayed.

{{:examentrybulkactions.png?600|}}

  * Update will apply the specified field changes to all selected records. See [[exam_entry_bulk|Bulk Update]].
  * Expire will expire the selected records.
  * Copy will copy the selected record to another Bank.  See [[concepts#Banks and Bank Level|Banks and Bank Level]] and [[bank_copy|Bank Copy]]

==== Context Menu ====
Right-clicking on a row in the Exam grid will open a context menu.

==== Edit Context ====
{{:examentrycontextedit.png?600|}}

=== Edit General ===
Navigates to [[exam_edit_general|Exam Edit General]] page where the user can maintain information for the Exam record.

=== Edit Pass ===
Navigates to [[exam_edit_pass|Exam Edit Pass]] page where the user can maintain pass/fail information for the Exam record.

=== Edit Notes ===
Navigates to [[exam_edit_notes|Exam Edit Notes and Custom]] page where the user can maintain notes and custom information for the Exam record.

=== Edit Layout ===
Navigates to [[exam_edit_layout|Exam Edit Layout]] page where the user can create Sections and link Items, Item groups and Attachments to the Exam.  The user can also create alternate Forms for the Exam.

==== Calculations Context ====
{{:examentrycontextcalculations.png?600|}}

=== Process ===
Navigates to [[calculationsprocess|Process]] page where the user can calculate or recalculate [[stats_concepts#stats results set|Stats Results sets]] for the exam based on selected Sessions.  

=== Include/Exclude ===
Navigates to [[calculationsincludeexclude|Include/Exclude]] page where the user can maintain which Items on the Exam are **Included** and which Items are **Excluded**. **Included** Items on an Exam aggregate Stats on themselves and impact Candidate results.  **Excluded** Items aggregate Stats on themselves, but do not impact Candidate results.

=== Mark Entry ===
Navigates to [[markentry|Mark Entry]] page where the user can create or maintain registered Candidate responses for the Exam.  Candidates must be registered to the exam to create or maintain responses for them.  

=== Graph ===
Navigates to [[calculationsgraph|Graph]] page where the user can select from existing calculated Stats Results sets and view a histogram of Candidate mark distribution as well as basic exam stats such as quantity Pass, quantity and low, high and average mark.

=== Results ===
Navigates to [[calculationsresults|Results]] page where the user can select from existing calculated Stats Results sets and view raw Stats results of the Exam, Sections, Candidates, Items or Competencies.  These results can be filtered and the views (field data selected) can be customized.  The resulting data can be exported.

=== Maintenance ===
Navigates to [[calculationsmaintenance|Maintenance]] page where the user can purge existing Stats Result sets form the system.  

==== Reports Context ====
The Exam Reports is a set of reports or exports of data related to the selected Exam.  

Right click a row in the Exam grid and choose the **Reports → ** and the report/export to run.  

{{:examentrycontextreports.png?600|}}

=== Answer Key ===
Navigates to [[exam_reports_answerkey|Answer Key]] page where the user can view or export the Exam's Answer Key.  The Answer Key shows the [[Item_entry|Items]] on the exam along with all correct options, [[competency_entry|Competency]] and [[reference_entry|Reference]] mappings.  

=== Results Export ===
Navigates to [[exam_reports_resultsexport|Results Export]] page where the user can view various combinations of binomial results, points awarded per Item, Candidate responses and scores at Exam, Section or Competency level.  

=== Document Comparison === 
Navigates to [[exam_reports_documentcomparison|Document Comparison]] page where the user can compare Items on the Exam for similarity in text to other Items on the Exam.  

==== Other Context ====
=== Document ===
Navigates to [[exam_document|Exam Document]] page where the user can open a previously built Exam Document or create a new one.

=== Reversion ===
See [[concepts#Versioning|Versioning]] for more.

=== Copy ===
[[exam_copy|Exam Copy]] allows the User to copy the Exam to a new Exam or, to copy a Section of the Exam to an existing Exam.

=== Session Entry ===
The [[session_entry|Session Entry]] tool is used to create and maintain Sessions for Exams. A Session is a logical grouping of Registrants, which are Candidates taking the Exam. Sessions can be used to differentiate writing centers, different seating dates for Exams or other logical groupings such as first time writers vs repeat writers.
 
Session Entry is reached from the Exam context menu.

{{:examentrycontextsession.png?600|}}  

=== Audit ===
Navigates to the [[audit|Audit grid]] for the selected record.

=== Usage ===
Navigates to the [[usage|Usage grid]] for the selected record.