# Help: Tests

## What is a Test?

A **Test** is an evaluation that selects questions from one or several repositories to create an assessment session. Tests allow evaluating knowledge in a structured way and obtaining educational feedback.

## Test Features

**General Data (Required):**

- **Name**: Test identifier

- **Description**: Brief explanation of the test objective

- **Categories**: Thematic classification

- **Tags**: Keywords for search

- **Author**: Test creator

- **Number of questions**: Amount of questions that will appear in the test

- **Repositories**: One or several repositories from which questions will be extracted

**Test Type:**

- **DYNAMIC**: Questions are randomly selected each time you run the test. Each execution is different.

- **STATIC**: Questions are always the same in each execution. The order may be random but the questions don't change.

**Scoring System:**

- **Points for correct**: Points awarded for each correct answer (default: 1.0)

- **Points for incorrect**: Points awarded/subtracted for incorrect answer (default: 0.0, can be negative)

- **Points for unanswered**: Points when a question is left unanswered (default: 0.0)

**Aesthetic Customization (Optional):**

- **Background color**: Custom color for the test background (hexadecimal code)

- **Text color**: Text color for better readability

- **Background image**: Image that appears as background during the test

- **Title image**: Image that appears on the test start screen

## Test Execution Structure

**1. Start Screen:**

- Shows the title image (if defined)

- Test name

- Description

- Test information (number of questions, points per correct answer)

- "Start Test" button

**2. During the Test:**

- Shows each question sequentially

- Navigation with "Previous" and "Next" buttons

- Current question counter (e.g., "Question 3 of 10")

- Question multimedia resources (images/audios)

- Answer options with their multimedia resources

- From the first question, the "Previous" button returns to the start screen

- On the last question, "Finish" button to complete the test

**3. Results Screen:**

- Total score obtained

- Number of correct, incorrect, and unanswered questions

- Detailed review of each question with feedback and explanations

- "Finish and Exit" button

## Menu Functions

**1. Sort List**

- **No order**: By modification date (most recent first)

- **Name A-Z**: Alphabetically ascending

- **Name Z-A**: Alphabetically descending

**2. Search Tests**

- Real-time search by name, description, categories, or tags

**3. Create New Test**

- Complete the form with all fields

- Select at least one repository

- Define the number of questions

- Customize scoring and aesthetics

**4. Edit Test**

- Modify any test field

- Change associated repositories

- Adjust scoring and visual customization

**5. Delete Test**

- Permanently deletes the test

- Does NOT delete previous statistics/results

- This action CANNOT be undone

**6. Execute Test**

- Starts a new test session

- Upon completion, saves the result in statistics

**7. Export/Share Test**

- Creates a `.evalisTest` file with the configuration

- Does NOT include questions (only configuration)

- The recipient will need the associated repositories

**8. Import Test**

- Imports `.evalisTest` files

- Verifies that necessary repositories are available

## Question Types

**MULTIPLE_CHOICE:**

- Only one answer can be selected

- A single answer has a score of 1.0 (correct)

- The rest have a score of 0.0 (incorrect)

**MULTIPLE_ANSWER:**

- Multiple answers can be selected

- Several answers may have partial or full scores

**TRUE_FALSE:**

- Only two options: True or False

- One has a score of 1.0, the other 0.0

## Scoring System

For each question:

1. Sum the score of all selected answers

2. If the sum is 1.0 → "points for correct" are applied

3. If the sum is 0.0 → "points for incorrect" are applied

4. If the sum is between 0.0 and 1.0 → proportionally applied

5. If not answered → "points for unanswered" are applied

## Visual Customization

**Colors:**

- Use hexadecimal codes: #RRGGBB (e.g., #FF5733)

- Ensure good contrast between background and text

- If background image is defined, color is applied with transparency

**Images:**

- **Background image**: Shown during all questions

- **Title image**: Shown only on the start screen

- Supported formats: PNG, JPG, JPEG (maximum 5 MB)

## Recommendations

- Ensure repositories have enough questions

- Define scores according to difficulty level

- Use descriptive names

- Test tests before sharing them

- Export important tests as backup