Differences

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

--- exam_import [2017/01/09 08:02]
steveclarke
+++ exam_import [2017/03/20 13:55] (current)
steveclarke [Exam Import from File]
@@ Line 1: / Line 1: @@
-===== Exam Import from Answer Key =====
+===== Exam Import from File =====
-The Item Import tool is used to import one or more Items from an external file. Item Import can be used to create new Items.  Item Import can also update existing Items in the Item Bank.  The reasons for importing Items are:
+The Exam Import tool is used to create an [[exam_entry|Exam]] link from a spreadsheet consisting of a Section_Title and ItemID columns. The import process will create an Exam with a specified Title, add a distinct set of Sections to the Exam with specified Section Titles, and link the Items specified by their ItemID to the various sections.  In essence, it is a quick method of constructing and Exam with a known list of Items.
-  * More rapid development of Items, either for creating or updating.  The user does not have to navigate through multiple Item entry pages to set all values.  FIXME link to Item entry
-  * Limiting exposure of your Item Banks to external users.  By using Import files, external users to CE such as subject matter experts (SME) or contract authors do not have to be trained to use CE or be exposed to the system at all.
-{{:itemimport.png?600|}}
+The reasons for creating an Exam using Exam Import from File are:
+  * More rapid development of Exams, as the spreadsheet import method is faster than linking each Item to the Exam using the [[exam_edit_layout|Exam Layout]].
+  * Limiting exposure of your Exam Banks to external users.  By using Exam Import from Ffile, external users to CE such as subject matter experts (SME) or contract authors do not have to be trained to use CE or be exposed to the system at all.
+Exam Import from File is reached from the Main Menu, Item Writing → Exam Tools → New Exam from File
+{{:menuexamfromfile.png?200|}}
+{{:examimport.png?600|}}
 ==== Import Files ====
-Item Import supports importing Items from Microsoft® Excel (.xlsx) and Microsoft® Word (.docx) formats.  The user can download the import templates using the template hyperlinks.  Note: Microsoft® Excel or Microsoft® Word must be installed to open or maintain these files.
+Exam Import supports importing Exams from Microsoft® Excel (.xlsx).  The user can download the import templates using the template hyperlink.  Note: Microsoft® Excel must be installed to open or maintain these files.
-{{:itemimportsample.png?600|}}
+{{:examimportsample.png?600|}}
 ==== Uploading an Import File ====
-To upload an Item Import file, click the **Select** button.
+To upload an Exam Import file, click the **Select** button.
-{{:itemimportselect.png?600|}}
+{{:examimportselect.png?600|}}
 This will open a file dialog.  Select the file and click **Open** button.
-{{:itemimportupload.png?600|}}
+{{:examimportupload.png?600|}}
-The image file will be uploaded but not Imported yet. To import the Items to the database click the **Import** button.
+The import file will be uploaded but not Imported yet. To import the Items to the database click the **Import** button.
-{{:itemimportuploaded.png?600|}}
+{{:examimportuploaded.png?600|}}
-This will navigate you to a progress page.  As the Items are imported and processed, this page will indicate the progress.
+If no **New Exam Title** is specified, a warning message will appear. If no import file is selected, a warning message will appear. Otherwise the import file will be processed.
-{{:itemimportprogress.png?600|}}
+When complete, a message area will appear indicating how many records were processed and any validation issues that occurred.  If successful a green message are will indicate success.  If there were validation issues a yellow message are will appear.
-When complete, a message area will appear indicating how many records were processed and any validation issues that occurred.  If successful a green message are will indicate success.  If there were validation issues a yellow message are will appear.  The user can navigate back to the Item Import page via the hyperlink.
+==== Exam Import Notes ====
+The Exam Import file consists of two columns.
-{{:itemimport_success.png?600|}}
+^Field^Description^
+|SECTION_TITLE|This is the Title that you want to give to the Section you are adding to the Exam.  Each Item linked to an Exam must be linked to a Section that has been added to the Exam.  For each distinct SECTION_TITLE value, a distinct Section is created.  So if there are 3 distinct SECTION_TITLE values, there will be 3 Sections added to the Exam.|
+|ITEMID|This is the unique identifier of an [[item_entry|Item]] in the Exam/Item bank.  The Item must be a valid Item in the currently selected Exam/Item Bank.  See [[concepts#Banks and Bank Level|Bank and Bank Level]].  The Item cannot be Inactive.|
-==== Item Import Notes ====
+==== Exam Import Sample ====
-For more on Item Import field types, validation, requirements, see [[item_import_notes|Item Import Notes]].
+^Section_Title^ItemID^
+|First Section|27|
+|First Section|28|
+|First Section|29|
+|Second Section|200|
+|Second Section|201|
+This will create an Exam with two Sections (**First Section** and **Second Section**) as there are two distinct Section Title values.  **First Section** has 3 Items (27,28,29) and **Second Section** has two Items (200,201).