Avendoo® online documentation

Knowledge tests

Knowledge tests resume questions and tasks in a fixed or random order. They serve, placed on the learning path, as exercise or exam.

In the overview (learning content → knowledge tests) you see all already existing knowledge tests. If you click on the title, you get to the appropiate sequence assistant. Via click on the national flag you get to the preview of the user. Furthermore you see the owner of the knowledge test and the creation date.

There are the mass processing functions Copy, MoveDeleteChange status, Export and Print (PDF) for knowledge tests. More information about these functions you find under Knowledge tests: Mass processing functions.

To create a new knowledge test, choose learning content → knowledge tests → new knowledge test. The sequence assistant opens.

Master data


Enter a significant title for the knowledge test. It is shown on the learning path.


The teaser appears on the learning path as supplementary information about the knowledge test.


Determine the main language for the knowledge test. If the knowledge test is to be accessible in multiple languages, it must be translated in the translation area.



Define which knowledge test type you want. Afterwards you can filter in reports via type.

Learners can repeat exercises and exams as often as they please or exercises and exams are restricted. This configuration you do on the learning path.

Point system

Set the point mode you wish to use for assessing the question in the knowledge test.

For further information and examples regarding the point system click on the button below:

Grading key

You can use the grading scale to depict the results of the knowledge test as a grade. Save the grading scale under Resources -> grading scale.

Access code

Add an access code to restrict access to the knowledge test. By doing so, you guarantee that learners can only start this test if they have the code. Application example: joint on-site test.

This input is optional.

Time limit

Indicate the maximum time allowed for taking the knowledge test.

To activate the time limit for the appropiate knowledge test, set the check box “Activate processing time limit”. Then you enter the time limit in the format hh:mm:ss. Avendoo® shows this time limit on the final page of the appropiate knowledge test. If the time limit is exceeded, the attempt of the knowledge test gets the status “Failed”. Depending on how many attempts are configured in the preferences of the appropriate knowledge test the user can do as many attempts as configured.

Display settings

Define whether the learners should be allowed to see the points they have earned while doing the knowledge test.


  • Show the points for each question and/or
  • Show information on the knowledge test (score achieved)


Define whether the correction of an item should be shown while the user is doing the test and if so in what form.

And define what navigation functions the learner has at his/her disposal.

Below you see the icons which represent your configurations.

Information on the correct answer to a question

  • Do not show answer
  • Learner can select himself
  • Show answer only if an incorrect answer was given (default)
  • Always show the answer

Elements of navigation during editing the knowledge test

  • Show quick navigation
  • Allow questions to be remembered and skipped
  • Knowledge test can be ended and assessed at any time
  • Allow editing of the answers prior to assessment

Early exit

  • If you exit a knowledge test early without working, you get a dialog box if you really want to exit the knowledge test. You can cease processing or you can continue the working.
  • If you exit a knowledge test early, after the working has been done, you can continue the working of the unvalued questions via button. The working starts at the first question, for which you don’t have entered an answer. Note that remembered questions are considered unanswered.


With this combination:

  • Display setting “Show information on the knowledge test (score achieved)”
  • Navigation setting “Do not show answer”
  • Navigation setting “Show quick navigation”

you can open already answered questions via the quick navigation bar again. The users can find out, which is the best answer combination, because the points are shown. Therefore we recommend not to use the option “Show information on the knowledge test (score achieved)”at the quick navigation.

Da die Punkte angezeigt werden, können die Benutzer herausfinden, welches die beste Antwortkombination ist. Daher empfehlen wir Ihnen bei der Schnellnavigation die Option Informationen zum Wissenstest (erreichte Punkte) einblenden nicht zu verwenden.

You can choose further options for knowledge tests. Therefore go to Courses → Course content (learning path) → Settings per learning object

Starting page

The starting page appears when the knowledge test is opened. It is optional and serves the purpose of providing information before the knowledge test starts. You can provide information to the learner regarding the working. Define by setting the check box, if the starting page should be shown when the knowledge test opens.

Design template: Simple knowledge test starting page 

To help you at the creating and editing of a course starting page, you can create an own design template, you can open a simple design template or you can create via blanc page freely.

Now the content which ideally should be entered in various sections is further explained. The editor is available for editing.

Available variables

Variable hinzufügenFor creating a knowledge test you get various variables in the editor. Via variables chosen content is automatically inserted:

  • $CourseTitle$ = Title of the course
  • $ObjectCertification$=Link to the certificate, if the course is passed
  • $ObjectTeaser$=Teaser of the knowledge test
  • $ObjectTitle$=Title of the knowledge test
  • $UserCountry$ = Country of the registered user
  • $UserDivision$ = Division of the registered user
  • $UserFirstname$ = First name of the registered user
  • $UserGroup$ = Group of the registered user
  • $UserLastname$ = Last name of the registered user
  • $UserOe$ = Organizational unit (OU) of the registered user
  • $UserRegion$ = Region of the registered user
  • $UserSex$ = Gender of the registered user

Enter title

Enter the title of the knowledge test.

Enter subheadline

For concretizing the title you can add a subheadline.


  • Title: Health management
  • Subheadline: Regulations

Enter introductory text

Give some information to the learner regarding the knowledge test. Hints and criteria, which have to be met for passing the knowledge test, provide the learner an informative basis.

Important note: The greyed-out box contains further hints for the learner. You can state the duration of the knowledge test and the number of attempts allowed and you can show the existing passing grade.

Knowledge test questions

Choice of questions

Add the questions and determine their order. The order is ignored if there are knowledge tests with random question order.

Knowledge test questions

  • Add
    Opens the selection dialog for questions. Select a category and then select the favored questions.
  • Delete
    Deletes the question, which you have marked.
  • Up / Down
    Moves the position of the marked question in the knowledge test.

Intermediate pages

Intermediate pages can contain hints and information during the knowledge test. To add an intermediate page, do the following steps:

  1. Mark a question.
  2. Click on the button Add below Intermediate page.
  3. Enter a title for the intermediate page.
  4. Enter the text and design your intermediate page.
  5. Define the display settings: Show intermediate page before or after the marked question.

For adding an intermediate page, click first on an existing question to activate the section “Intermediate page”.

  • Add
    Opens the edit mode for the intermediate pages. Choose a design template, enter title and text and define the position in the knowledge test.
  • Edit
    Opens the edit mode for intermediate pages. You can edit title, content and position of the intermediate page.
  • Delete
    Deletes the question, which you have marked.

Final page

On the tab “Final page” you define how an assessment is shown to the learner at the end of the knowledge test. If you want to show a grade as result, choose  a grading scale before on the tab “Parameter”. Each single result and the total result are shown percentaged additionally as default.

To use an evaluation tool, click on the appropriate icon and move the elements to the favored position. Already used elements you can move and position via drag and drop.

Edit mode

If you want to create a final page, choose Blank page or a Design template. Now you can freely arrange all sections and you can move them via drag-and-drop at any time. Furthermore you can configure the size of the appropriate section individually.

Available variables

Variable hinzufügen

For creating a knowledge test you get various variables in the editor. Via variables chosen content is automatically inserted:

  • $CourseTitle$ = Title of the course
  • $ObjectCertification$=Link to the certificate, if the course is passed
  • $ObjectTeaser$=Teaser of the knowledge test
  • $ObjectTitle$=Title of the knowledge test
  • $UserCountry$ = Country of the registered user
  • $UserDivision$ = Division of the registered user
  • $UserFirstname$ = First name of the registered user
  • $UserGroup$ = Group of the registered user
  • $UserLastname$ = Last name of the registered user
  • $UserOe$ = Organizational unit (OU) of the registered user
  • $UserRegion$ = Region of the registered user
  • $UserSex$ = Gender of the registered user

Preview mode

To see how the current question is shown on mobile devices, there are five preview modes and the current edit mode available. The pixel width is based on average values. The pixel height is individually well adapted for the dialog window. Choose first a responsive layout and then the preview mode will be shown correctly.

Display on the smartphone (Portrait format, width: 320px)

Display on the smartphone (Landscape format, width: 480px)

Display on the tablet (Portrait format, width: 800px)

Display on the tablet (Landscape format, width: 1000px)

Display on the PC monitor (width: 1200px)

Text area

Via editor you can create and format a text area for the final page of your knowledge test. Via the icon Einfügen you can position the favored evaluation tools directly in the text area. In the opening dialog window you get different options for the width of the chosen evaluation tool (Progress bar chart, Summary, Rankings or Details). Define the width by selecting an appropriate value or define an individual width by selecting Individual and entering an value.

Evaluation tools

If you choose Details as evaluation tool for example you get further settings. Click on the gearwheel in the lower area to get further setting options shown (Overview of the individual question results or Overview and repeated display of the questions).

Progress bar chart

The progress bar chart shows the learner his/her knowledge test result in relation to his colleagues (average). Furthermore the personal average is shown, if the knowledge test type exercise was chosen, and the required score and the points of the current attempt.


The summary shows the learner his personal knowledge score. Furthermore the learner gets the hint “Passed or Did not pass” if it is chosen in the menue.


To get further incentive among the learners, you can show rankings on the final page.


The detailed assessment is shown, if the option ” ” or the option “Overview and repeated display of the questions” is shown. In both cases the invidual knowledge test questions, their status and the achieved points are shown. If the option “Overview and repeated display of the questions” is chosen, the learner can look at his given answers via click on the button Details in order to learn from the wrong answers.

Notification about passing (e-mail to user)

A noticification will be sent to the user, if he/she has passed the knowledge test. This is meaningful, if the knowledge tests contain essay questions.

Responsive layouts

For an optimum display of your knowledge test even on mobile devices various responsive layouts are available.

To adopt your favored layout into the edit mode, click on the appopriate layout. Only after this the display is adapted in the preview mode.

Reset page

Via click on this icon the existing content is deleted and you can start again.

If a knowledge test contains an essay question, which should be answered by an author, the learner can’t get displayed a result and a grade.
Then appears the hint “Pending evaluation” under the “Evaluation details” and the grade is declared as “Preliminary grade (Evaluation of the essay question(s) is pending)”.

Avendoo® API

Experienced authors with appropriate HTML/CSS and JavaScript skills can use the  Avendoo® API (application programming interface) for the final page. So they can transfer certain parameters to an autonomous created design.



Determine the order of the questions. Select between a fixed order and a random order.

You define the fixed order of the questions at the selection of the question for a knowledge test. On the random order you define, how many questions of the question selection should be asked.

Select according to keyword

This function is available, if you have chosen Random order of questions. Via keywords, which have to be assigned to the questions, you can choose from a questionnaire, which are assigned to a keyword.


You have prepared 50 questions for a course. Ten questions are assigned to the keyword “Training camp”. If you want now to create a knowledge test with 25 questions, you can define by entering the keyword “Training camp”, how many questions from the questionnaire “Training camp” (25 questions) should be asked. Which of these 25 questions will be asked in the knowledge test, is random.