Overview

Please note this article is temporarily under construction.

1. Completion threshold actions that control access to modules.
   
2. Question randomization that pulls from multiple question banks.
   
3. Variable point values per question.
   
4. And more!
   

Please note CYPHER for business defaults to the term assessment. CYPHER for academia defaults to the term assignment. The terms assessment and assignment are interchangeable in this article.

Adding a quiz assessment to a course

1. Access the course or class.
   
2. Click Assessments from the course navigation menu.
   
3. Click + Add.
   
4. Click Quiz.
   

In the Options tab, you can set up the following:

• Release scores: Select this option if you want scores to be released to learners instantly, or if you want to manually release scores.
  
• Timed: Select this option if you want the quiz to be timed.
  
• If you select Timed, enter the number of minutes for the quiz.
  
• Randomize order: Select this option if you want to randomize the order of the questions in the quiz.
• Instant feedback: Select this option if you want to provide learners with instant feedback on their answers.
  
• Allow review: Select this option if you want to allow learners to review their answers before submitting the quiz.
• Grading: Select whether you want to use the learner's latest score or their best score.
• Allow users to jump between questions: Select this option if you want to allow learners to move between questions before answering them.
  
• Show in learner results: Select which options you would like to display for learners in their quiz results. You can display the question question, response, correct answer, score, and feedback.
  
• Autocomplete on retake: Enabling this option impacts learners when they retake the quiz. If this option is enabled, questions the learner answered correctly are saved, so learners only need to focus on the questions they answered incorrectly.  
  
• Library: Determine in which Resources library you would like to save the quiz.   
  
• After selecting options for the quiz, click Save. 
  

The assessment quiz has been created! If you would like to set a minimum score requirement:

1. Click Assessments in the course navigation menu.
   
2. Click the quiz assessment.
   
3. Click the Completion tab.
   
4. Click + Add minimum score requirement.
   

Individual learner settings

There are several quiz settings that can be adjusted for individual learners, including quiz timing, allowing late submissions and the maximum number of attempts. To adjust quiz settings for an individual learner:

1. Click Assessments from the course navigation menu.
   
2. Click the quiz assessment you want to adjust.
   
3. Click the Scores/Grades tab.
4. Click the Score assessment icon in the Show/Score column.
   

CYPHER for business defaults to the term score. CYPHER for academia defaults to the term grade. The terms "score" and "grade" are interchangeable in this article.

Locate the learner's score submission widget in the right panel.

1. Click edit.

The learner's individual quiz settings pop-up displays.

1. Max attempts: Select a maximum number of quiz attempts for the learner.
   
2. Allow late submissions: Select this option if you want to allow the learner to submit an assessment after the due date.
   
3. Timed: Select this option if you want to adjust the quiz timing for the learner.
   
4. Click Save.

Questions

Creating a quiz assessment automatically sets up a private, empty question bank with the same name as the quiz.  The private question bank is associated with the assessment, and if you delete the assessment, the question bank is also deleted.

Adding a question bank

1. Click the Assessments tab in the course.
   
2. Click the quiz assessment.
   
3. Click the Questions tab.
   
4. Click + Add question bank.
   

The Add question bank pop-up displays.

1. Click New to create a new question bank.
   
2. Click Library to use an existing question bank. 
   

If you add a new question bank:

1. Enter a name for the question bank.
   
2. Select Shared? if you would like to make the question bank public.
   
1. If you select Shared, add a description to the question bank and select a library to share the question bank with.
   

The question bank displays in a table at the top of the page. 

1. Click + Add question bank to add another question bank.
   
1. You can add as many question banks as you would like to the quiz.
2. Click Edit to edit a question bank.
   
1. Please note you can only make a shared question bank private if the question bank is only associated with one quiz.
3. Click Remove to remove a question bank from the quiz.
   
4. Click the  reorder icon and use drag and drop to reorder question banks.
   

Please note that you can only remove a private bank from the list of banks if you have deleted all of its questions. 

Add questions to question banks

You can add questions to a question bank manually or by importing QTI. This article will cover both processes.

Adding questions manually

To add questions to a quiz manually:

1. Access a quiz assessment.
   
2. Click the Questions tab.
   
3. Select a question bank.
   
4. Click + Add questions.
   

The Add questions pop-up displays. Select from the following types of questions:

1. True or false
   
2. Multiple choice (one answer)
   
3. Multiple choice (many answers)
   
4. Fill in the blanks
   
5. Freeform
   
6. Matching
   
7. Hotspot
   
8. Arithmetic
   

 True or false

1. Enter a true or false question.
   
1. Note that you can select </> HTML mode if you would like use the editor to add images, files, or videos to the question.
2. Set the number of points for the question.
1. A correct answer gets full points, and an incorrect answer gets zero points.
   
3. Select True or False for the answer.
   
4. Correction:  A correction box gives the learner a chance to enter the correct answer if the question is false.
   
1. Click Yes if you would like to add a correction box.
   
2. If you click "Yes", enter the Correction phrase and the Correction weight. If the learner enters an incorrect phrase, the percentage specified as the "Correction weight" will be subtracted from the question's points.
   
5. Feedback: This option allows you to provide feedback to learners for both the True and False answers.
   
1. Click Yes if you would like to provide feedback.
   
2. Enter True feedback.
   
3. Enter False feedback.
   
6. Select a save option.
   

Multiple choice (one answer)

1. Enter a multiple choice question.
   
1. Note that you can select </> HTML mode if you would like use the editor to add images, files, or videos to the question.
   
2. Set the number of points for the question.
1. A correct answer gets full points, and an incorrect answer gets zero points.
   
3. Determine if the answer choices should be presented to learners in a random order or the original order. 
   
4. Enter up to 12 answer choices, and designate one answer as the correct answer.
5. Feedback: This option allows you to provide custom feedback for any of the answer choices.
   
6. Select a save option.

Multiple choice (many answers)

The answer to this type of question is selected from a set of choices. Each choice can add or subtract a specified percentage from the total number of points associated with the question. A negative score is rounded up to zero.

Fill in the blanks

The answer to this type of question is a set of words, one for each blank in the question. Each blank can have one or more right answers. The score is based on the percentage of blanks that are filled in correctly.

Freeform

The answer to this type of question is text together with some optional attachments. Attachments can be any kind of file, such as a video, a PDF file, or a Word document.

Matching

The answer to this type of question is a set of matches between two sets of items. The score is based on the percentage of matches that are correct.

Hotspot

The answer to this type of question is one or more selected regions from a picture. The score is proportional to the number of regions correctly selected.

1. Enter a question or instructions for the Hotspot activity.
   
1. Note that you can select </> HTML mode if you would like use the editor to add images, files, or videos to the question.
2. Set the number of points for the question.
3. Click Add picture to upload the hotspot image.

1. After the picture is uploaded, click a shape for the first hotspot. 
   
2. Use your mouse to draw the shape on the image.  
   
1. Click and drag to create a circle or rectangle.
   
2. Click point to point to create a custom shape. Double click on the last point to complete the shape.
   
3. If you would like to redraw the shapes, click Reset drawing. 

1. For each shape, enter an associated answer/label.
   
2. When you finish adding shapes and labels, select a save option.
   

To take the quiz:

1. Learners drag the labels to the region of the picture they think are associated with the label.
   
2. When learners have finished dragging labels to the picture, they click Continue.

Adding questions by importing QTI

To learn how to import a question bank, visit the Question banks article. Once the questions have been added:

1. You can use drag and drop to reorder the questions within a bank.
   
2. Click Print to print the quiz.
   
3. Click Answer key to view the answer key.
   

Tagging questions

You can add tags to questions in a question bank and then select questions to include in a quiz based on tags.

1. For example, you could tag five questions in a question bank with #easy and tag five questions with #hard, and then create a quiz that picks two #easy questions at 1 point and three #hard questions at 2 points.
   

To add tags to a question:

1. Click a question within an assessment.
   
2. Click add in the Tags section.
   
3. Enter tags, using a comma to separate them.
   
1. To remove tags, click X on the tag.
   
4. When you are finished adding tags, click save.
   

Note - If Advanced tagging was enabled on your platform, you can select a tag value. To learn more about "Advanced tagging", please visit the Tags topic.

Adding skills and competencies to quiz questions

CYPHER for business defaults to the term skills. CYPHER for academia defaults to the term competencies. The terms "skills" and "competencies" are interchangeable in this article.

You can add skills to individual quiz questions.

Each score for a question that has skills is considered to be a separate data point for mastering that skill. For example, if you have two questions in a quiz assessment that are associated with skill X, and the learner scores 5 out of 10 on one question and 8 out of 10 on the following question, then the learner rating for skill X would be the best (80%) or average (65%) based on the mastery option settings for that course.

Please note that if you add competencies to a question, they will be reflected in the existing assessment competencies.  

To add competencies to a quiz question:

1. Click a question within an assessment.
   
2. Click the Set skills tab.
   
1. In CYPHER for academia platforms, click the Set competencies tab. 

1. Select the skills associated with the question.
   
2. Click Save. 
   

The skills associated with the question now display in the Skills tab.

1. Click Edit to edit the skills.
   
2. Click Clear to remove all skills for the question.
   

If you view the Questions tab for a quiz assessment, questions that have skills are indicated with a green tag.

For more details on skills, please visit the Mastery article.

Settings for question banks

By default, all questions in a question bank are used when generating a quiz, and the points per question are the face value shown next to each question. To override the default settings:

1. Click Assessments from the course navigation menu.
   
2. Select a quiz assessment.
   
3. Select the Questions tab.
   
4. Select a question bank.
   
5. Click [change] next to "All questions in the bank are selected".

1. Choose the number of questions selected each time the quiz is taken.
   
1. Please note that if you leave this setting as "All", you will not be able to select skills and tags.
2. Enter the number of points per question.
   
1. Please note this field cannot be blank because the platform needs to calculate the total points the bank is worth before the quiz is taken.
   

1. Skills: If a course has associated skills, you can select the skill(s) that must be included in the selected questions from the drop-down menu. For example, you can create a quiz that uses two questions that test Skill X.
   
1. Please note that if you specify more than one skill, then all the specified skills must be associated with the question for it to be selected.
   

1. Tags: You can also use tags to define which questions should be selected for the quiz. Enter the tags associated with the questions you would like selected. 
   
1. Use a comma to separate tags, if multiple tags are needed.
   
2. When you are finished, click Save. 
   

The new question selection rule displays above the question bank.

1. Click edit to edit the question selector rule.
   
2. Click remove to remove the question selector rule. 
   
3. Click add select to add an additional selector rule to the question bank.
   
1. You can have multiple selector rules per question bank. For example, you may want the quiz to include two questions with one set of skills, and three questions with another set of skills.

When a quiz is generated, the following rules are used:

1. The quiz generator cycles through each question selector rule to pick questions that satisfy the selector. If the selector cannot be completely satisfied, an error is not generated. For example, if the selector rule is "Select two questions with the tag '#hard'" and only one question has the '#hard' tag, the one question that satisfies the rule will be used and the generator will move on to the next question selector rule.  
   
2. Questions are not selected twice. So if the first question selector rule is "Select three questions" and one of them is the single question with the tag "#hard", and the next question selector rule is "Select two questions with the tag '#hard'", no questions would get picked by the second selector rule.

Please note that when creating question selector rules, you should be careful when adding selectors and check that they can all be satisfied under any condition. Otherwise, learners may get a quiz with less than the expected number of questions.

Preview

After creating a quiz, you can preview it. To preview a quiz assessment:

1. Click Assessments from the course navigation menu.
   
2. Select the quiz assessment.
   
3. In the Assessment tab, click Take quiz.
   

Learner submissions

To take a quiz, learners:

1. Access a course.
   
2. Click Assessments/Assignments from the course navigation menu.
   
3. Click the quiz assessment.
4. Click Take quiz. 
   
5. Answer the quiz questions.
   
6. Click Finished once all questions have been answered.
   

If the Allow users to jump between questions option was selected for the quiz assessment, learners can also:

1. Move between questions using the Next and Previous buttons.
   
2. Move directly to a specific question by clicking the question in the question grid in the right panel.
   

1. Click Pause in the status widget in the right panel to pause the quiz.
   
1. Learners can click Resume quiz to resume the quiz.
   
2.  Click Cancel to cancel a quiz submission, in which case the submission is discarded and does not count as a submission attempt.
   

Once a leaners submits their answers, the results are displayed according to selections made in the "Options" pop-up for the quiz.

1. If a quiz contains free-form questions, learners are reminded that their grade is not final because an instructor must grade their submission.
   

<please insert a screenshot of question results from a learner perspective>

Once learners have submitted a quiz assessment, they can view their submission. To view an assessment submission, learners:

1. In the History table, learners click the icon in the Show column to view a specific submission.

Scoring/Grading quiz assessments

There are a few scenarios where you may need to score or grade a learner's quiz submission:

1. To score or grade a freeform question.
   
2. To excuse an assessment.
   
3. To override a score.
   

1. Click Assessments/Assignments from the course navigation menu.
   
2. Click the quiz assessment.
3. Click the To score tab.
   
1. CYPHER for academia users will click the To grade tab.
   
4. Click the Score assessment icon in the Show/Score column.
   
5. Enter a score for the quiz in the score widget in the right panel.

Additionally, you can view the amount of time it took for learners to complete the quiz. To view a learner's quiz time:

1. Access the course.
2. Click Learners/Students from the course navigation menu.
   
3. Click the More  icon for a learner.
   
4. Click Activity from the menu.

The time the learner spent on the quiz is indicated after the name of the quiz assessment.

Exporting results

The platform allows you to export quiz results. To export a CSV file of quiz results:

1. Click Assessments/Assignments from the course navigation menu.
   
2. Click the quiz assessment.
   
3. Click the Analytics tab.
   
4. Click Export below the quiz questions.