Quizzes and Surveys

Quizzes and Surveys can be created and managed on the administrative side of the SkillTree Dashboard and seamlessly administered by associating them to Skills or running them independently.

• Quiz - a knowledge check composed of multiple questions with a passing requirement
• Survey - data collection technique utilizing one or more questions

A Quiz/Survey association to an existing skill requires successful completion of that Quiz/Survey in order to earn the skill and its points. In the case of a quiz, then the quiz serves as the skill's knowledge check. On the other hand associating a survey is method to get feedback about that skill or collect some pieces of important data related to the skill.

To view existing quizzes or surveys or to create a new Quiz or Survey please navigate to Quizzes and Surveys page featured under the main Navigation on the administrative part of the Dashboard.

To create a new Quiz or a Survey please click on Quiz/Survey+ button and the New Quiz/Survey form will be displayed.

New Quiz/Survey form fields are:

Field	Explanation
Name	The name of the quiz or the survey
Type	Can either be Quiz or Survey; the type is immutable and can only be changed at the initial creation time.
Description	A description will be visualized on a splash screen when a user starts a quiz or a survey. You can build a visually pleasing comprehensive description using SkillTree's Rich Text Editor

Friendly Reminder

The Type for a Quiz or a Survey must be selected at creation time and cannot be modified at a later time.

TIP

Although the description is optional it is generally recommended to create one. Using the Rich Text Editor we encourage authoring visually pleasing descriptions.

Quiz

A quiz is a knowledge check composed of multiple questions with a passing requirement. Quizzes can be associated to a skill or can be executed independently. Associating a Quiz to an existing skill will require successful completion of that Quiz in order to earn the skill and its points. In the case of a quiz, then the quiz serves as the skill's knowledge check.

Quizzes currently support two types of questions:

• Single Choice - question will only have 1 correct answer
• Mulitple Choice - question has 2 or more correct choices; all correct choices must be selected to get credit for the question
• Input Text - question for test-takers to provide a free-form text answer that will later be graded by a quiz administrator

To administer a quiz click Manage button for that quiz on the Quizzes and Surveys page.

To add a new question please click Question + button.

The Question's text supports all the same features that the Description Editor currently affords which includes a generous feature set including attaching or copy-and-pasting screenshots. The two supported question's types and Single Choice and Mulitple Choice and are implicitly derived from the number of the selected correct answers. A single selected correct answer implies Single Choice question type and when more than one corrected answers selected then Mulitple Choice is used.

TIP

When multiple correct answers are selected users will be required to properly identify all of those correct answers in order to receive the credit for the question

TIP

Use the Preview button on the top left below the Quiz name in order to see what the quiz will look like to your users.

Answer Grading Since skills-service:3.2

If a quiz has at least 1 Input Text question then after a quiz taker submits an attempt a quiz administrator will be able to grade the answers for the Input Text questions.

To do so please navigate to Quizzes and Surveys -> Quiz -> Grading page.

A table of quiz attempts that contain Input Text questions will be displayed. Click on the Grade button to the right of the user to open the grading request. Once expanded answers can be marked as either "Correct" or "Wrong", in addition a justification can be provided. Once all the answers are marked as either correct or wrong, the system will grade the quiz attempt in its entirety considering all the questions in this quiz.

Grading Notifications

SkillTree will send email notifications to quiz administrators when grading is requested, and also send email notifications to quiz takers when answers are graded.

Quiz administrators can unsubscribe from notifications by navigating to the Quizzes and Surveys -> Quiz -> Grading page.

The Grading section contains a Subscribed/Unsubscribed toggle on the top-right of the component.

Quiz Settings

A Quiz has a number of customization parameters, to customize a quiz please navigate to Quizzes and Surveys -> Quiz -> Settings page.

Setting: # of Questions per Quiz Attempt

When enabled, a sub-set of random questions will be presented to the user taking this quiz. For example, if there are 10 questions and this setting is set to 5, then each time a user takes this quiz only 5 random questions will be presented for that quiz attempt. If a user fails a quiz attempt the following attempt will present another 5 random questions from the available question pool.

Setting: Passing Requirement

This setting adjusts the minimum number of questions required to pass this quiz. By default, all questions have to be answered correctly in order to get the credit.

Setting: Maximum Number of Attempts

By default, users have an unlimited number of attempts to pass a quiz. You can set the maximum number of attempts to 1 or more.

Setting: Randomize Question Order

If enabled, questions are presented in a random order each time the quiz is taken.

Setting: Randomize Answers Order

If enabled, each question's answers are presented in a random order each time the quiz is taken.

Setting: Quiz Time Limit

If a time limit is set, users will have a specific duration to complete the quiz. If they exceed the time limit, their attempt will be marked as 'Failed'.

Setting: Allow Retakes After Completion Since skills-service:3.1

With this feature enabled, users can retake quizzes even after achieving a passing score. The system accurately tracks each successful attempt, providing a comprehensive view of user progress and performance.

Setting: Show Correct Answers On Failure: Since skills-service:3.1

Enabling this feature will provide the correct answers on failed quiz attempts, allowing users to review and understand the correct answers, improving their learning and understanding of the material.

Survey

A Survey is a data collection technique utilizing one or more questions. Surveys can be associated to a skill or can be executed independently. Associating a Survey to an existing skill will require completion of that Survey in order to earn the skill and its points. When associated to a skill, the survey is a method to gather feedback about that skill or collect some pieces of important data related to the skill.

A Survey currently supports four types of questions:

• Single Choice - question will only allow a single choice to be selected
• Mulitple Choice - one or more choices are required to be selected
• Text Input - a freeform answer text is required
• Rating - a star-based rating question with an ability configure between 3 and 10 stars

To administer a survey click the Manage button for that survey on the Quizzes and Surveys page.

To add a new question please click the Question + button.

The Question's text supports all the same features that the Description Editor currently affords which includes a generous feature set including attaching or copy-and-pasting screenshots. Please use the Answer's dropdown to select the type, currently available options are Single Choice, Mulitple Choice and Text Input.

TIP

Use the Preview button on the top left below the Survey name in order to see what the survey will look like to your users.

Survey Settings

A Survey has customization parameters, to customize a survey please navigate to Quizzes and Surveys -> Survey -> Settings page.

Setting: Allow Retakes After Completion Since skills-service:3.1

With this feature enabled, users can retake surveys unlimited number of times. The system accurately tracks each completion, providing a comprehensive view of user progress and performance.

Copy

Quizzes, surveys and questions can easily be copied.

To use an existing Quiz/Survey as a template you can easily copy its declarations (questions, settings, etc..) into a brand-new Quiz/Survey.
To copy a Quiz/Survey please use the button available on a quizzes/surveys administration page. The system will prompt you to enter a new Quiz/Survey name and optionally modify the Quiz/Survey id.

Similarly, to copy a question please use the button available on a questions page within a single Quiz/Survey administration.

Results

Summarized quiz/survey results can be located on the Results page (Quizzes and Surveys -> Quiz/Survey -> Results).

The page features

• total number of users' attempts
• number of passed and failed attempts
• average quiz/survey runtime
• in the case of quizzes, a bar chart breakdown for each question depicting the difference between the correct and the wrong question attempts
• number of times each answer was selected and its associated selection percentage
• for each answer, an ability to drill down to its history

TIP

Please note that only the completed quizzes/surveys are shown on this page, if you are looking for In Progress runs please visit Runs page.

Runs

To track individual quiz/survey runs please visit the Runs page (Quizzes and Surveys -> Quiz/Survey -> Results). Each row represents a single Quiz/Survey for a single user.

Select the run details button to the right of the user to view details of that particular Quiz/Survey run.

Quiz results will depict selected answer(s) and its correctness status. Survey results will simply display which results were selected.

Skill Association

A Quiz/Survey association to an existing skill requires successful completion of that Quiz/Survey in order to earn the skill and its points. In the case of a quiz, then the quiz serves as the skill's knowledge check. On the other hand associating a survey is method to get feedback about that skill or collect some pieces of important data related to the skill.

To make a quiz-to-skill association when creating or editing a skill

1. select Self Reporting checkbox
2. then select Quiz/Survey

To configure a Quiz-based or a Survey-based skill please select Quiz/Survey option and then use the drop-down to locate one of the available Quizzes or Surveys.

Useful Tips

A Quiz or a Survey can be associated to more than one skill in one or more project(s).

A quiz/survey administrator can easily view which skills the quiz/survey is associated with by navigating to the Skills page in that particular quiz/survey (Quizzes and Surveys -> Quiz/Survey -> Skills) :

Access

The Quiz/Survey Access page supports adding or removing Quiz Administrators. To add and remove Administrators please navigate to Quiz/Survey -> Access page.

Activity History Since skills-service:2.10

The Activity History feature provides a comprehensive record of all administrative changes made to this quiz/survey.

Activity History includes the following fields:

• User: the user who performed the action
• Action: the type of change made by the user (e.g., Create, Edit, Delete)
• Item: the item that was modified
• Item ID: the identifier of the modified item (e.g., Quiz ID)
• Performed: the date when the change was made
• Additional Attributes: additional fields that can be expanded to view more details

You can sort the Activity History by user, action, item, item ID, and performed fields. Additionally, you can filter the Activity History by user, action, item, and item ID.