Create a Test Instance

Just as the LMS system requires the creation of both a Learning Object (Course) and a course instance (where users enroll in a specific course instance), similarly it requires the creation of both a test library (test) and a test instance. The test instance will be selectable when associating a test to a learning object / course.

After creating a new Test Library, the Available Test Instance section displays at the bottom of the screen with the New Instance button, or you can access a Test Library from the Test List (Advanced View>Learning Objects>Test Libraries). 

Add a Test Instance

1. Click the New Test Instance button, which opens the Test Instance Details screen.
    
   1. Instance Name - This is the required name for the test instance. This name will be displayed when the user adds the test instance to a course. 
      TIP: The Test Instance Name is usually the same as the Test Library (Test) Name.
   2. Randomize - An option to have the test questions shuffled every time the user takes the test, if checked. 
   3. Passing Score - This is the score required to pass the test (e.g. 80 or 100). 
      NOTE: This can be overridden by entering a different passing score at the course or learning object level.
   4. Use All Questions - This option lets the test use all questions for the test.
      NOTE - The user can submit the test for scoring if not all the questions are answered, even if the Use All Questions is checked. 
   5. Make Public - Currently this is not in use. It can be left blank. 
   6. Enforce Retake Logic - This option allows the user to retake the test.
      1.  If left blank - it will allow for unlimited test retakes
      2. If checked - you must enter the number of Attempts allowed and
      3. Enter the Days Before Retake, which is now required also.
   7. Max Questions - the number of questions to show on the test.
   8. Attempts - If the Enforce Retake Logic is checked, this is the number of retakes attempts the user is allowed.
   9. Days before Retake - This is related to the Enforce Retake Logic. It is the number of days a user has to wait to retake the test. 
      
      1. Enter 1 will require 24 hours before retake is allowed.
      2. Enter 0 will have no time restriction to retake the test. 
   10. Review on Completion - if selected will allow the user to review the test questions and answers after passing the test. 
   11. Permit Review - If selected, will display the incorrect answer in red and the correct answer selected for each question when the user retakes the test. 
   12. Show One Question Per Page - If checked, only one question is displayed per page.
   13. Show Feedback - This is a feature where hints can be setup to help the user answer the question. It shows the feedback for each question in blue in the test, if the comments section for each question is filled out.
   14. Time Allowed (Minutes) - Is currently not available for use. You can leave blank.
2. Either check the Use All Questions checkbox or enter a numeric value in Max Questions field.
3. Enter optional attributes to complete the setup. 
4. Click Save, when finished. 
5. This will return you to the specific Test Library Instance List with the new instance now added to the Instance List.
6. Select Exit to return to the Test List.

    Add Questions to a Test

After setting up the Test Instance, the next step is to add questions to the Test Library.

1. Navigate to the Test List (Advanced View > Learning Objects > Test Library)
2. Click on the View link in the Questions Column of the row of the Test Library to add questions.  If questions are already present, there will be a number next to the View link.
3. This will launch the Test Question List that displays all the test questions associated with the specific Test Library.
4. Click the New Test Question button. This will launch the Test Question details screen. 
   
   
   1. Question Text - This field is required and is the question as it appears to a user while taking the test.
   2. Randomize - Select If questions are to appear in random order.
   3. Comments - This is the feedback for the question that would appear after the test is completed if show feedback is selected in the Test Instance.
   4. Display Order - This required field is the order in which the questions are displayed on the test.
5.  Enter information in the required fields: Question Text and Display Order.
6. Enter optional attributes as needed. 
7. Click Save, when finished. 
8. This will save the question and display the saved question details and two new sections:
   1. Available Test Answer - Allows you to add both correct and incorrect answers to the question (For details see the Add Answers to Test question section).
   2. Attachment - Allows you to add an attachment to the question. For example, you can add an image which can be referenced in the question (For details see Add Attachment to Test Questions section).
9.  Repeat steps 4-7 to add all test questions to the selected Test Library.

   Add Answers to Test Questions

The next step after the question is setup, is to add answers to the question. 

1. Navigate to the Test Question Details page of the Test Question to add answers.
2. After adding a test question, the creator will be automatically returned to this page to allow immediate entry of answers.
3. If adding (or editing) test answers at a later time, navigate to this page as directed in the previous section.
4. Navigate to section Available Test Answer and click the New Answer button. If there are previous answers, they are listed and can be selected for editing by clicking the pencil icon to the right of the row of the selected answer or delete by clicking on the red (X) icon to the left of the row of the selected answer.
5.  This will launch the Test Answer Details page in a popup window.
   1. Answer Text - This is where the answer is entered as it appears to a user while taking the test.
   2. Is Correct? checkbox - Select this box if the answer text entered is the correct option.
   3. Answer Type - This is a dropdown selection of controls by which the user can select an answer. Options include:
      1. Check Box
      2. Radio Button
      3. Text Area
      4. Text Box
   4. Answer Value - This field is usually left blank, and the system will copy over the Answer text when saving the answer. If desired a separate value may be used for display in reports.
   5. Display Order - This is the order in which the answers are displayed on the test. 
6. In the Answer Text textbox, enter a possible answer as you would like the user to view it when taking the test.
7. Select the Answer Type from the drop-down box.
8. Enter a number in the Display order for this particular answer as part of the group of answers to be added to this question.
9. Select the Is Correct? Checkbox, if this is this is the correct response, 
10. When finished entering information and to add additional answers to this question, click the Save and New button.
    
11. This will save the answer and launch a blank Test Answer Details popup page for a new answer. Repeat steps 3-10 for all additional answers.
12. If finished entering all answers for this question, click the Save button.
13. This will return you to the Test Question Details page with the saved answers now visible in the Available Test Answer section.
    
14. To add an Attachment to a question, see the section: Add an Attachment to a test question. 
15. Exit to the Test Question List screen and continue to add answers to all questions. 
16. When finished, Exit to the Test List screen.