Differences

This shows you the differences between two versions of the page.

--- exam_reports_documentcomparison [2017/03/15 10:36]
127.0.0.1 external edit
+++ exam_reports_documentcomparison [2017/03/15 11:01] (current)
steveclarke
@@ Line 1: / Line 1: @@
-===== Exam Reports =====
+===== Exam Reports - Document Comparison =====
-The Exam Reports is a set of reports or exports of data related to the selected Exam.  The Exam Reports are reached via the context menu from the [[exam_entry|Exam Entry]] tool.
+The Document Comparison report enables the user to compare [[item_entry|Items]] on the [[exam_entry|Exam]] for similarity in text to other Items on the Exam.
-Right click a row in the Exam grid and choose the **Reports → ** and the report/export to run.
+Right click a row in the Exam grid and choose the **Reports → Document Comparison**.
 {{:examentrycontextreports.png?600|}}
-=== Answer Key ===
+This will navigate to the Document Comparison page.
-Navigates to [[exam_reports_answerkey|Answer Key]] FIXME 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 ===
+{{:exam_reports_documentcomparison.png?600|}}
-Navigates to [[exam_reports_resultsexport|Results Export]] FIXME 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.
+=== Correlation Factor ===
+The user must enter a correlation factor as a value between 0 and 1.  The correlation factors sets a threshold of how similar the text of the Items must be in order to be listed.  The higher the number, the more similar the Item's text has to be. The correlation algorithm counts all the words in each Items text (omitting words like "the", "and", "or".  It then looks at how many of those words exist in both Items' text.  The ratio of common words to total words must exceed the correlation factor in order to be listed.
+Example: "This is a help file."  "This is a help document."  The words "is" and "a" will be removed leaving 3 words to compare.  In this case 2 of the 3 words are the same so these Items would be .67 correlated.  If the report correlation factor is less than .67 then this Item comparison would be listed.
+=== Language ===
+Item writing supports multiple languages of Item text.  Only one language of text can be compared at a time.  Use the language drop down selector to choose which language to compare.
+==== Running the Report ====
+To run the report click the **Run Report** button.  This will open a report window.  The user can print or export the report using the toolbar.  To close the report, click the X in the top right of the report window.
+{{:exam_reports_documentcomparisonreport.png?600|}}
+==== Return to Exam Entry ====
+To return to the Exam Entry tool, click the hyperlink in the bottom left of the page.
-=== Document Comparison ===
-Navigates to [[exam_reports_deocumentcomparison|Document Comparison]] FIXME page where the user can compare Items on the Exam for similarity in text to other Items on the Exam.