Tests Module

1. Module Overview

1.1 Module Purpose

The Tests module enables comprehensive management of online tests and quizzes within the eIntranet.net system. It is primarily designed for employee training, knowledge assessment, and skills certification.

1.3 Target Audience

• Test Administrators - HR department, trainers, training managers (require level 3 rights)
• Evaluators - users with access to view all results (require level 2 rights)
• Employees - regular users taking assigned tests (basic level 1 access)
• External Users - people without an eIntranet account (for anonymous tests only)

2. Setup and Configuration

2.1 Module Activation

The module must be activated by a system administrator in the global company settings. After activation, the module will appear in the main application menu.

2.2 User Rights

Rights Level	Rights Name	Permissions
0	No Access	User has no access to the Tests module
1	Basic Access	User can only take tests assigned to them. Only sees the "My Tests" section
2	View All Test Results	User can take tests and view results of all tests in the "Test Results" section
3	Create and Manage Tests	Full access - user can create new tests, edit existing tests, view all sections including "Test Management" and "Test Templates"

2.3 Module Settings

Global module settings are available in the Settings → Modules → Tests section (gear icon in the module header).

3. User Interface

3.1 Module Sections

The Tests module consists of four main sections accessible via the top navigation bar:

3.1.1 My Tests

Displays tests assigned to the currently logged-in user for completion. This section is visible to all users with module access.

3.1.2 Test Results

Overview of all tests with the ability to view their results. Available to users with level 2 rights and above.

3.1.3 Test Management

Tools for creating, editing, and deleting tests. Available only to users with level 3 rights.

3.1.4 Test Templates

Pre-prepared tests that can be copied and customized. Available to users with level 3 rights.

4. Basic Operations

4.1 Creating a New Test

To create a new test, follow these steps:

1. 1Go to the Test Management section
2. 2Click the Create New Test button
3. 3Fill in the basic test information
4. 4Set test parameters
5. 5Configure evaluation settings
6. 6Add optional information
7. 7Click the Save button

4.1.1 Basic Information

Field	Description	Required
Name	Test name displayed to users	Yes
Available From	Date and time when the test becomes available	Yes
Available Until	Date and time when the test availability ends	Yes
Accessible to Users	Determines who can take the test (see below)	Yes

4.1.2 Test Accessibility Options

Option	Description	Use Case
All eIntranet Users from Your Company	Test is available to all active users in the system	Mandatory training, general knowledge tests
Selected eIntranet Users from Your Company	Test is available only to selected users (a selection list will appear)	Specific tests for certain departments or positions
Anyone - We Will Generate a Unique Link	Test is accessible via unique URL even for users without an eIntranet account	Entrance exams, certification tests for external candidates
Training Employees	Test is linked to the Training module and automatically assigned to training participants	Final training tests, training completion assessments

4.1.3 Test Parameters

Parameter	Description	Default Value
Time Limit	Total time to complete the test in minutes. 0 = unlimited time	0 (unlimited)
Question Time Limit	Maximum time to answer one question in seconds. 0 = unlimited time	0 (unlimited)
Random Question Order	Questions are displayed in random order (prevents cheating)	No
Random Answer Order	Answer options are displayed in random order	No
Select Random X Questions	Only X random questions are selected from all available. 0 = all questions	0 (all)
Select by Question Groups	Questions are selected in groups (e.g., 5 = always 5 consecutive questions are selected). 0 = not used	0
Show Correct Answers	No / After Answer (cannot go back) / After Completing Entire Test	No
Allow Step Back	Allows returning to the previous question and changing the answer	No
Can Take Test Multiple Times	Allows repeated test completion without administrator deleting results	No
Display Completion ID	Unique ID of current completion is displayed in the test	No
Use Custom Question IDs	Allows entering custom question identifiers (e.g., "A1", "B2")	No
Display Custom Question IDs	Custom question IDs are displayed during test completion	No

4.1.4 Evaluation Settings

Parameter	Description
Show Pass/Fail at End of Test	After completing the test, whether the user passed or failed is displayed
Minimum Points for Successful Completion	Number of points required to successfully pass the test

4.1.5 Optional Information

Parameter	Description
Logo	Logo displayed in the upper right corner during test completion. Recommended size: 200x100 px
Introduction Text	Text displayed before the test starts (instructions, introduction)
End Text	Text displayed after completing the test (thank you, next steps)
Automatically Continue with Test After Completion	Allows linking multiple tests into a series (e.g., basic + advanced test)
Minimum Total Points	Minimum total points from all linked tests
Test Administrator Can Edit Completed Tests	Allows administrator to change points and answers after completion
Administrator Can Add Notes to Answers	Allows administrator to add comments to individual answers

4.2 Adding Questions to Test

After creating the test, you need to add questions:

1. 1In the test overview (Test Management section), click the Edit Questions icon (list icon) for the selected test
2. 2Click the Add Another Question button
3. 3Fill in the question text
4. 4Optionally upload an image for the question (recommended size up to 800x600 px)
5. 5Select the answer type
6. 6Enter the correct answer or answer options according to type
7. 7Set the number of points for the correct answer
8. 8Click the Save button

4.2.1 Question Types

Type	Name	Description	Example Use
0	Text Answer	User writes answer as free text. Answer must exactly match the specified correct answer	"What is the capital of the Czech Republic?" → "Prague"
1	Numeric Answer	User writes answer as a number. Answer must exactly match the specified number	"What is 2 + 2?" → "4"
2	Select 1 from Given Options	Selection of one correct answer from up to 10 options (radio button)	Question with choices A, B, C, D where only one answer is correct
3	Select Multiple Options	Selection of multiple correct answers from up to 10 options (checkbox). Points can be set for each correct option	"Select all primary colors:" → Red, Blue, Yellow
4	Select One Image	Selection of correct image from up to 10 uploaded images	Identify traffic sign, company logo, etc.
5	Fill in Words/Letters	Fill in missing words in text. Words to fill in are marked with vertical bars: |word|	"How long are |you| here?" - user fills in "you"
6	Selection with Limited Count	Selection of maximum X correct answers from up to 10 options. Points can be set for each correct option	"Select maximum 3 European countries:" - user can select at most 3 options

4.3 Ordering Questions

You can change the order of questions using arrows in the question overview:

• Up Arrow - moves the question up one position
• Down Arrow - moves the question down one position

4.4 Editing a Question

To edit an existing question:

1. In the question overview, click the pencil icon for the selected question
2. Edit the text, answer type, or points
3. Click Save

4.5 Deleting a Question

To delete a question:

1. In the question overview, click the X icon for the selected question
2. Confirm deletion in the dialog box

4.6 Test Preview

To view a test preview before publishing:

1. In the test overview (Test Management section), click the eye icon for the selected test
2. A test preview will be displayed as the user would see it
3. You can browse questions and test functionality

4.7 Taking a Test

Procedure for taking a test as a user:

1. 1Go to the My Tests section
2. 2In the test overview, click the Start Test button for the selected test
3. 3If an introduction text is set, read it and click Save & Next
4. 4Answer individual questions one by one
5. 5After answering each question, click Save & Next
6. 6After answering the last question, the final screen is displayed

4.8 Viewing Results

To view test results:

1. 1Go to the Test Results section
2. 2Select the test whose results you want to view
3. 3Click the columns icon to display the list of completions
4. 4In the list you will see:
   • Who took the test (first and last name)
   • When they took the test (start date and time)
   • How many questions they answered
   • How long it took (format mm:ss)
   • How many points they earned
   • Whether they passed (if evaluation is set)
5. 5To view specific answers, click the eye icon for the selected completion

4.8.1 Results Detail

In the results detail you will see:

• Basic Information: Test name, who completed it, date, total points, maximum possible points
• Questions and Answers: List of all questions with:
  • Question text (including custom ID if set)
  • User's answer (color-coded - green = correct, red = incorrect)
  • Correct answer (if user answered incorrectly)
  • Points for the answer
  • Trainer's note (if enabled and added)
• Export to PDF: Link to download PDF with test results

5. Advanced Features

5.1 Exporting Results to PDF

Results of each test completion can be exported to PDF format:

1. Open the results detail of a specific completion (see section 4.8)
2. At the bottom of the page, click the "here" link next to "Test with results for download in PDF"
3. A PDF file will be downloaded containing:
   • Test name
   • Participant information
   • Completion date
   • Total points
   • All questions with given and correct answers
   • Trainer's notes (if added)

5.2 Copying a Test

Copying is useful for creating similar tests or modifying templates:

1. In the test overview (Test Management section), click the copy icon for the selected test
2. A new copy of the test is created including all questions
3. A dialog for editing the copy automatically opens
4. Edit the test name (we recommend adding "- copy" for distinction)
5. Adjust settings as needed
6. Click Save

5.3 Training Integration

The Tests module can be linked with the Employee Training module:

5.3.1 Setting Up Test for Training

1. When creating or editing a test, select access: "Training Employees - Users Assigned to Training"
2. Save the test

5.3.2 Linking in Training

1. Go to the Training module
2. Create or edit training
3. In training settings, select your created test in the "Test" field
4. Set "Completion Confirmation Type" to "Test"
5. Save the training

5.3.3 Automatic Integration Features

• Automatic Assignment: The test is automatically made available to all users assigned to the training
• Results Linking: Test result (pass/fail) is automatically recorded in the training
• Notifications: If "Test can be retaken on failure" is enabled in training, users receive email on failure
• Training Status: Training completion status is updated based on test result

5.4 Anonymous Tests

Anonymous tests allow test completion even for users without an eIntranet account:

5.4.1 Creating an Anonymous Test

1. When creating a test, select access: "Anyone - We Will Generate a Unique Link"
2. Select which fields users must fill in:
   • Email
   • First Name
   • Last Name
   • Custom Fields 1 and 2 (with custom name)
3. Save the test

5.4.2 Getting the Test Link

After saving the test, a unique link is generated in the format:

https://your-domain.eintranet.net/test/[ID]/[HASH]/

You can find this link:

• In the test overview in the "Accessible to" column
• When editing the test in the "Accessible to Users" section

5.4.3 Sharing the Test

You can share the link:

• By email to candidates
• Via social networks
• On websites
• By QR code

5.5 Continuing with Another Test

You can create a series of tests that follow each other:

5.5.1 Setting Up Test Series

1. Create the first test in the series (e.g., "Basic Test")
2. Create the second test in the series (e.g., "Advanced Test")
3. In the first test settings, select: "Automatically Continue with Test After Completion" → select the second test
4. Set "Minimum Total Points" - total minimum points from all tests in the series
5. Save the test

5.5.2 Test Series Evaluation

The system evaluates the test series as follows:

• Total Points: Sum of points from all tests in the series must be ≥ the set minimum
• Minimum Points in Each Test: Each test in the series must have min. points set in its own "Minimum Points" setting
• Result Display: At the end of the last part, the overall series result is displayed

5.6 Editing Completed Tests

Test administrators can edit already completed tests:

5.6.1 Enabling Edits

1. When creating or editing a test, check: "Test Administrator Can Edit Completed Tests"
2. Optionally check: "Administrator Can Add Notes to Answers"
3. Save the test

5.6.2 Making Edits

1. Open the test results detail you want to edit
2. If you have level 3 rights and the test has editing enabled, the following will be displayed:
   • Field for changing the answer
   • Field for changing points
   • Field for adding trainer's note
3. Make the required changes
4. Changes are saved automatically when leaving the field

5.7 Test Templates

The system contains pre-prepared test templates that you can use:

5.7.1 Available Templates

In the Test Templates section you will find tests divided into groups:

• Language Tests:
  • English language test (basic level A1-A2)
  • English language test (advanced B1-B2)
  • German language test
  • French language test
• PC Skills Tests:
  • MS Word skills test
  • MS Excel skills test
  • Email skills test
  • Internet skills test

5.7.2 Using a Template

1. Go to the Test Templates section
2. Select the template you want to use
3. Click the copy icon
4. A copy of the template is created in your test management
5. Edit the name, settings, and questions as needed
6. Save the test

6. Integration and Linking

6.1 Linked Modules

Module	Link Type	Description
Employee Training	Bidirectional	Test can be assigned as final training evaluation. Test result is automatically recorded in training completion status.
Users	Unidirectional	Selection of specific users who have access to the test
Files	Unidirectional	Storage of question images and test logos

6.2 Data Flows

6.2.1 Training Link

Direction: Tests → Training

• Automatic Assignment: When assigning a user to training, the test is automatically made available to them
• Results Transfer: Test result (points, pass/fail) is recorded in the Skoleni_has_User table
• Status Update: Training status changes to "Completed" on successful test or "Not Completed" on failure

6.2.2 Results Storage

Test results are stored in these database tables:

• Testy: Basic test information
• Testy_otazky: Individual test questions
• Testy_absolvoval: Records of test completions by users
• Testy_odpovedi: Specific user answers to individual questions

7. Tips and Recommendations

7.1 Creating Quality Tests

7.2 Parameter Settings

7.2.1 Time Limits

Test Type	Recommended Time Limit	Reasoning
Quick quiz (5-10 questions)	5-10 minutes	About 1 minute per question
Standard test (15-25 questions)	20-30 minutes	About 1-1.5 minutes per question
Comprehensive assessment (30+ questions)	45-60 minutes	About 1.5-2 minutes per question
Test with difficult tasks	No limit or 60+ minutes	Allows thorough consideration of answers

7.2.2 Randomization

Situation	Random Questions	Random Answers
Test in classroom (side by side)	✓ Enable	✓ Enable
Certification test	✓ Enable	✓ Enable
Educational test with progression	✗ Disable	✓ Enable
Online test without supervision	✓ Enable	✓ Enable

7.3 Specific Tips by Question Type

7.3.1 Text and Numeric Answers (type 0, 1)

• Specify the exact required answer format in the question (e.g., "Answer with first and last name", "Enter number without spaces")
• For text answers, consider case-sensitivity - if not important, add note "uppercase/lowercase not distinguished"
• For numeric answers, specify whether you want the result rounded and to how many decimal places

7.3.2 Choice Selection (type 2, 3, 6)

• All options should be the same length and similar style
• Avoid options like "all of the above" or "none of the above" - they are confusing
• For multiple correct answers (type 3, 6), state in the question how many answers should be selected
• Don't use more than 6-8 options - more options reduce readability

7.3.3 Image Questions (type 4)

• Recommended image size: 400x400 px to 800x600 px
• Use JPG or PNG formats
• Make sure images are readable even on mobile devices
• All images in one question should have similar size and quality

7.3.4 Fill-in Questions (type 5)

• Correctly format text using vertical bars: |correct answer|
• Leave sufficient context around the part to fill in
• Good usage example: "The capital of the Czech Republic is |Prague|."
• Bad usage example: "|Prague|" (missing context)

7.4 Cheating Prevention

7.5 Optimization for Learning

7.6 Mobile Access

The eIntranet.net system is fully responsive. For optimal experience on mobile devices:

• Use shorter question texts
• Prefer "Choice Selection" type over text answers
• Test the test on a mobile device before publishing
• For fill-in questions, watch the length - too long text displays poorly
• Images should be readable even on small screens

8. Troubleshooting

8.1 Common Problems and Solutions

Problem	Possible Cause	Solution
Test doesn't show in "My Tests"	Availability date hasn't started yet Availability date has already expired You're not in the list of selected users Test is linked to training you're not assigned to	Contact the test administrator and verify access rights and availability date settings
Cannot add question with image	Image is too large (over 5 MB)	Reduce image size using graphics editor to max. 2 MB
Test automatically ended	Time limit expired	Time limit cannot be changed retroactively. Contact administrator if you need to take the test again
Cannot go back to previous question	"Step Back" feature is disabled Correct answer display is set to "After Answer"	This is an intentional test setting. If it's a problem, contact the test administrator
Test results don't display correctly	Test doesn't have correct answers set for questions	Administrator must add correct answers for all questions in the test
PDF with results won't generate	Insufficient server permissions or PDF library error	Contact system administrator

8.2 Error Messages

8.2.1 "Test has already been taken"

Cause: Test doesn't have multiple completion option enabled.

Solution: Administrator must either enable repeated completion or delete the previous result.

8.2.2 "Time limit expired"

Cause: You exceeded the set time limit for the test.

Solution: Test was automatically submitted. Results are saved in current state. Contact administrator if you need to take the test again.

8.2.3 "You don't have permission for this test"

Cause: Test is not accessible for your user role or you're not in the list of selected users.

Solution: Contact test administrator or HR department.

8.3 Contact Information

If you encounter a problem that cannot be resolved using this documentation:

• Technical Issues: Contact IT department or system administrator
• Content Questions: Contact the specific test administrator or HR department
• Improvement Suggestions: Use the "Ideas and Suggestions" module in eIntranet

9. FAQ - Frequently Asked Questions

9.1 For Users Taking Tests

9.2 For Test Administrators

10. Glossary

Term	Meaning
Completion	One specific instance of a user filling out a test
Anonymous Test	Test accessible via unique link even without logging into eIntranet
Time Limit	Maximum time allowed for completing the test or question
Hash	Unique code for anonymous test access
Randomization	Random ordering of questions or answers
Points	Point value for correct answer
Test Administrator	User with level 3 rights who created the test
Template	Pre-prepared test that can be copied and customized
Pass/Fail	Test result based on minimum point threshold
Custom ID	User-defined question identifier (e.g., "A1", "B5")

11. Related Documentation

For deeper understanding and advanced use, we recommend studying documentation for these related modules:

• Employee Training - for linking tests with training programs
• Users and Permissions - for managing access rights
• Company Settings - for global system configuration
• Data Export - for advanced results exports