> For the complete documentation index, see [llms.txt](https://docs.skillzrun.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.skillzrun.com/navchannya/uroki/ispit.md).

# Іспит

Як створити тип уроку «іспит», встановити час і кількість спроб, переглянути результати, як зараховується найкращий результат, як видалити окрему спробу та як працювати з іспитом у мобільному застосун

### **Як створити урок типу «іспит» у бек-офісі**

✓ Знаходимо у меню зліва функцію **«теми та уроки»**, натискаємо на неї.

✓ Зайшовши в розділ, знаходимо напис **«уроки»** та кнопку **«створити урок»**, натискаємо.

✓ На екрані з'являється перемикач **«увімкнути режим іспиту»**, вмикаємо та даємо назву іспиту, натискаємо **«далі»**.

**Іспит без обмеження часу.** Якщо таймер не потрібен, у налаштуваннях іспиту вкажіть тривалість `-1`. У такому разі обмеження за часом проходження знімається.

✓ Наступний крок: Визначити час проходження. Для цього ми натискаємо зверху на кнопку **«вправи»** та самостійно заповнюємо пункт **«поріг проходження»** та **«час»**. Потім натискаємо **«створити вправу»** або **«вибрати вправу»**.\
\
**Зверніть увагу:** кількість спроб на виконання окремої вправи в іспиті не налаштовується — вона завжди одна. А ось можливість **перескласти сам іспит** визначається в налаштуваннях предмета (сторінка [Налаштування предмету](https://docs.skillzrun.com/navchannya/nalashtuvannya-predmeta), вкладка «Уроки», перемикач «Увімкнути можливість перескладання іспитів» разом із «Кількість перескладання іспитів»): якщо він увімкнений, учень може перескласти іспит самостійно — стільки разів, скільки там вказано, без участі адміністратора. Якщо вимкнений — повторна здача можлива лише з дозволу адміністрації, яка видаляє попередній результат.

**Зверніть увагу:** на уроках типу «іспит» у правому кутку є позначення EX.

✓ **Бали за вправу.** За замовчуванням кожна вправа в іспиті коштує **1 бал**. Щоб змінити кількість балів, вкажіть потрібне значення в колонці **«Бали»** у таблиці вправ іспиту та натисніть **«Зберегти зміни»** внизу сторінки. У вже створених іспитах бали за вправи не змінилися.

<figure><img src="https://135744108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjgRDsyXtfduYZJEtYHGk%2Fuploads%2Fy7ei6YvVaiX4TE2lV77k%2Fexam-points-1.png?alt=media" alt="Колонка «Бали» у таблиці вправ іспиту"><figcaption><p>Колонка «Бали» у таблиці вправ іспиту</p></figcaption></figure>

✓ Зверху на екрані поруч з розділом «вправи» знаходиться пункт **«екзамен».** Натиснувши на нього, ви зможете побачити статус виконання іспиту. Хочете отримати більше інформації про результати іспиту? Натисніть на ім'я учня та виберіть розділ **«детальна статистика»**. У самому низу сторінки з'являться детальні результати.

**Зверніть увагу:** вчитель має перевірити вправи типу **«домашнє завдання»**, які входять до іспиту. Іспит не буде завершено, допоки вчитель не перевірить усі завдання.

### **Як працювати з уроком типу «іспит» у мобільному застосунку**

✓ Переходимо у застосунок та вибираємо рівень. **На екрані з'являється іспит**, а внизу позначка з максимальною кількістю балів, які за нього можна отримати.

✓ Натискаємо на іспит. На екрані з'являється інформація про **час проходження, кількість спроб та запитань**. Також система попереджає, що іспит неможливо поставити на паузу, навіть, якщо учень закриє або видалить застосунок.

**Зверніть увагу:** усі невиконані вправи матимуть статус неправильних.

✓ Натискаємо **“Let's go”** та розпочинаємо іспит. У правому верхньому кутку ви побачите відлік часу.

✓ Після завершення іспиту, **на екрані з'явиться результат**. Хочете переглянути свої відповіді та дізнатись, які з них правильні, а які — ні? Натисніть **Review**. У правому верхньому кутку ви побачите позначки, де червоний хрестик означає неправильну відповідь, а зелена галочка — правильну.

**Зверніть увагу**: чи побачить учень можливість перескласти іспит самостійно — залежить від тієї ж настройки предмета. Якщо вона вимкнена, повторна спроба стане доступною лише після того, як викладач видалить попередній запис.

#### **Дивіться детальну відеоінструкцію про створення іспиту:**

{% embed url="<https://youtu.be/fdGF-Hv5vPM>" %}

## Оцінювання вправи «Заповнити пропуски» в іспиті

У межах іспиту кожен пропуск перевіряється окремо. Частково правильні відповіді враховуються в підсумковому результаті. Це правило стосується саме іспитів; для звичайних уроків і домашніх завдань логіка цієї вправи не змінювалася.

## Унікальні набори вправ

Під час проходження іспиту учні можуть отримувати різні набори вправ. Це допомагає проводити іспит із індивідуальним набором завдань для кожного учня.

## Найкращий результат при перескладанні

Якщо учень перескладає іспит, у статистиці зараховується його **найкращий результат**, а не останній. Невдале, менш успішне або незавершене перескладання не скасовує попередню успішну здачу. Усі спроби при цьому зберігаються в історії.

Логіка стосується лише іспитів — звичайні уроки рахуються як і раніше.

### Як обирається результат

1. **Статус.** Іспит, складений успішно, має пріоритет над будь-якою іншою спробою. Далі — завершена, але не складена спроба. Далі — спроба, що чекає перевірки домашнього завдання. Останнім — поточне проходження.
2. **Бали.** Серед спроб з однаковим статусом обирається та, де набрано **більше балів**. Порівнюються саме бали, а не відсоток від максимуму.
3. **Дата.** Якщо статус і бали однакові, обирається пізніша спроба.

Статус, бали, максимум балів, дати та деталі виконання вправ завжди показуються з **однієї** обраної спроби — дані різних спроб не змішуються.

**Приклади** (максимум 20 балів, прохідний бал 14):

| Історія спроб (від ранньої до пізньої)        | Що зараховується                      |
| --------------------------------------------- | ------------------------------------- |
| Складено 18 → не складено 6                   | Складено, 18/20, дати першої спроби   |
| Складено 18 → складено 14                     | Складено, 18/20, дати першої спроби   |
| Складено 14 → складено 19                     | Складено, 19/20, дати другої спроби   |
| Не складено 3 → складено 19 → складено 14     | Складено, 19/20, дати другої спроби   |
| Не складено 9 → не складено 3 → не складено 6 | Не складено, 9/20, дати першої спроби |
| Складено 18 → нова спроба триває              | Складено, 18/20                       |
| Складено 18 → складено 18                     | Складено, 18/20, дати другої спроби   |

**Зверніть увагу:** якщо в іспиті випадковий набір вправ різної вартості, максимум балів у спроб може відрізнятися. Наприклад, зі спроб 8/10 і 9/20 (обидві складені) буде обрано 9/20 — набрано більше балів, хоча відсоток нижчий.

### Домашні завдання в іспиті

* Якщо після успішної здачі учень перескладає іспит із домашнім завданням, поки його не перевірено, у статистиці залишається попередня успішна здача.
* Після перевірки нова спроба замінює попередню, лише якщо вона краща. Гірша спроба результат не змінює.
* Якщо попередня спроба була не складена (наприклад, 6/20), до перевірки нової показується 6/20. Після перевірки, якщо нова спроба краща (наприклад, 16/20), зараховується вона.
* Якщо інших завершених спроб немає, іспит показується зі статусом «чекає перевірки».

### Під час перескладання

Поки учень проходить нову спробу, він бачить саме її: власний таймер, «чисті» вправи без старих відповідей і поточні бали. Найкращий результат показується в статистиці та під час перегляду іспиту поза проходженням.

### Історія та кількість спроб

* В історії спроб у вкладці з прогресом учнів зберігаються **всі** спроби з їхніми власними результатами, включно з гіршими.
* Кожна використана спроба зменшує кількість доступних перескладань — вибір ранішого найкращого результату спроби не повертає.
* Фільтр за статусом у таблиці прогресу працює за зарахованим результатом. Наприклад, учень, який склав іспит, а потім невдало перескладав, потрапляє у фільтр складених, а не нескладених.
* У таблиці кожен учень показується одним рядком, незалежно від кількості спроб.

### Завершення курсу та середня оцінка

* Успішно складений іспит рахується як **один завершений урок**. Гірше або незавершене перескладання не зменшує відсоток завершення розділу й курсу.
* Відсоток набраних балів і завершення уроку — різні показники. Результат 18/20 — це 90% балів, але в детальній статистиці складений урок рахується як завершений на 100%. Це не помилка.
* У зведенні курсу середня оцінка рахується за найкращим результатом: 18/20 відповідає 9 за шкалою 0–10.
* Ручна оцінка, яку виставив співробітник, як і раніше має пріоритет над автоматично розрахованою.

### External API

У відповіді `GET /external/api/users/{id}/progress` дані об'єкта `exam` (`status`, `points`, `totalPoints`, `startDate`, `endDate`) відповідають найкращій спробі. `numberOfAttempts` показує фактичну кількість доступних спроб з урахуванням усіх використаних. Історія відповідей `exercisesAnswers` містить відповіді всіх спроб. Для звичайних уроків `exam` дорівнює `null`.

## Видалення окремих спроб іспиту

Якщо в предметі дозволено перескладання, в учня може накопичитися кілька спроб одного іспиту. Адміністратор може видалити **будь-яку окрему спробу** — наприклад, помилкову чи технічно невдалу — і не скидати при цьому весь результат учня.

### Як видалити спробу

✓ Відкрийте потрібний предмет і розділ, перейдіть до уроку-іспиту.

✓ Перейдіть на вкладку з таблицею результатів учнів. Щоб швидко знайти учня, скористайтеся пошуком або фільтром за групою.

✓ У рядку учня розгорніть **історію спроб**. Для кожної спроби видно її статус, бали та дати.

✓ Біля потрібної спроби натисніть дію **видалення**.

✓ У вікні підтвердження перевірте **дату та час початку** спроби — так ви переконаєтеся, що видаляєте саме ту, яку треба. Підтвердіть видалення.

Якщо передумали — натисніть **«Скасувати»** або клавішу **Esc**: усі спроби залишаться без змін.

### Що відбувається після видалення

* Видаляється **лише вибрана спроба**. Інші спроби зберігають свої дати, порядок, бали та результати.
* Якщо видалена спроба не була тією, що зараховується в статистиці, результат учня не змінюється.
* Якщо видалити спробу, яка зараховувалася, результат перераховується з решти спроб за правилами [найкращого результату](#naikrashii-rezultat-pri-pereskladanni) — разом зі статусом, балами, максимумом, датами, набором вправ і позначками виконання. Дані видаленої спроби не змішуються з новим результатом.
* Видалена спроба **повертає учню одну спробу** перескладання. Якщо учень уже вичерпав ліміт, після видалення він знову зможе перескласти іспит один раз.
* Нова спроба після видалення починається «з чистого аркуша»: зі своїми відповідями, балами та **повним лімітом часу**.
* Якщо видалити спробу, яку учень **саме зараз проходить**, вона не відновиться. Учень побачить результат за рештою спроб і, якщо є доступні перескладання, зможе почати нову.
* Якщо видалити іншу спробу, поки учень проходить нову, поточне проходження продовжується: відповіді, бали й таймер зберігаються.
* Монети при видаленні **не списуються і не нараховуються**, ручні нарахування в колонці «Нараховано монет» зберігаються.
* Домашні завдання та результати інших спроб, інших учнів, уроків і предметів не змінюються.

**Приклад.** Учень складав іспит тричі: 6/20 (не складено) → 18/20 (складено) → 10/20 (не складено). У статистиці зараховано 18/20.

* Видаляємо 6/20 або 10/20 — зараховано, як і раніше, 18/20.
* Видаляємо 18/20 — зараховується найкраща з решти: 10/20, «Не складено».

### Коли окреме видалення недоступне

* **В учня лише одна спроба.** Окремої дії видалення немає — щоб повністю скинути результат, скористайтеся видаленням усього результату (див. нижче).
* **Іспит ще не запускався.** Спроб немає, видаляти нічого.
* Окремими видаленнями не можна залишити учня зовсім без спроб: якщо двоє співробітників одночасно видаляють дві останні спроби, одна з операцій буде відхилена.

### Видалення спроби чи видалення всього результату

|                        | Видалення спроби                              | Видалення всього результату               |
| ---------------------- | --------------------------------------------- | ----------------------------------------- |
| Що видаляється         | Одна вибрана спроба                           | Усі спроби учня в цьому іспиті            |
| Коли доступно          | Якщо спроб дві й більше                       | Завжди, коли є результат                  |
| Результат у статистиці | Залишається або перераховується з решти спроб | Скидається, учень проходить іспит заново  |
| Кілька учнів одразу    | Ні                                            | Так — позначте учнів прапорцями в таблиці |

У жодному випадку сам урок-іспит і результати інших учнів не видаляються.

**Зверніть увагу:** видаляти спроби можуть лише співробітники, яким дозволено видаляти результати іспиту. Нова функція не розширює наявних прав доступу.

***

## Часті запитання

<details>

<summary>Скільки балів дається за вправу в іспиті?</summary>

За замовчуванням — 1 бал за вправу. Значення можна змінити в колонці «Бали» у таблиці вправ іспиту та зберегти зміни. Бали у вже створених іспитах не змінилися.

</details>

<details>

<summary>Учень склав іспит, а потім невдало перескладав. Чому в статистиці «Складено»?</summary>

Зараховується найкращий результат. Невдале перескладання збережено в історії спроб, але воно не скасовує попередню успішну здачу. Детальніше — у розділі [Найкращий результат при перескладанні](#naikrashii-rezultat-pri-pereskladanni).

</details>

<details>

<summary>У списку уроків 90%, а в детальній статистиці 100%. Це помилка?</summary>

Ні. 90% — це частка набраних балів (наприклад, 18 з 20). 100% — це завершення уроку: успішно складений іспит рахується як повністю завершений урок.

</details>

<details>

<summary>Для домашнього завдання в іспиті немає статусу «Відхилено (можна редагувати)»</summary>

Це очікувано: цей статус передбачає повторне відправлення відповіді, а в іспиті в учня лише одна спроба. Для вправи типу «Домашнє завдання» всередині іспиту доступні лише статуси «Чекає перевірки», «В процесі», «Прийнято», «Відхилено». Статус «Відхилено (можна редагувати)» існує тільки для звичайних уроків.

</details>

<details>

<summary>Учню недоступний іспит для проходження</summary>

Найчастіша причина — учень уже запускав іспит раніше, час вийшов, і спроба не була складена. Рішення: видаліть невдалий результат тесту в адмін-версії — після цього іспит стане доступним знову.

Якщо в учня кілька спроб і вичерпано ліміт перескладань, достатньо [видалити одну окрему спробу](#vidalennya-okremikh-sprob-ispitu) — решта історії збережеться, а учень отримає ще одну спробу.

</details>

<details>

<summary>Чому не видно кнопки видалення біля спроби?</summary>

У учня лише одна спроба. Окремо її видалити не можна — використайте видалення всього результату учня: позначте його прапорцем у таблиці та видаліть результат.

</details>

<details>

<summary>Після видалення спроби в учня змінився статус</summary>

Ймовірно, ви видалили саме ту спробу, яка зараховувалася. Тепер зараховується найкраща з решти спроб — її статус може бути іншим. Якщо таблиця відфільтрована за статусом, рядок учня може зникнути або з'явитися відповідно до нового статусу.

</details>

<details>

<summary>З'явилося повідомлення, що спробу вже видалено або дані змінилися</summary>

Ймовірно, цю спробу щойно видалив інший співробітник. Оновіть сторінку — ви побачите актуальну історію спроб.

</details>
