SP-732 document quiz: beta test guide

How to test the document quiz fixes from PR #705 on beta, with the result and a screenshot of each step from a real run on 18 November 2026. Eleven steps passed. Step 12 was not possible in this course.

Summary

StepWhat it checksResult
1Answer file typesPASS
2Section labels from a worksheetPASS
3Essay rows block SavePASS
4Labels stay when rows are added or removedPASS
5Labels that are not allowedPASS
6Save and reopenPASS
7Numbered exam renumbers 1..NPASS
8Answer file with no answersPASS
9ExplanationsPASS
10Student takes the labelled quizPASS
11Student review pagePASS
12Native quiz review still numberedBLOCKED

Setup

Quizzes left on beta from this run (you can look at them, or make your own)

Test files

FileUsed inWhat it is
unit2-questions.pdf (146 KB)Steps 1 to 6Worksheet with sections; numbering restarts in each exercise
unit2-answers.docx (19 KB)Step 2Answer key for the worksheet (Word)
answers-dummy.xlsx (1 KB)Step 1A file type that is not allowed
thpt2025-questions.pdf (170 KB)Step 740-question exam numbered 1 to 40
thpt2025-answers.pdf (101 KB)Step 7Answer key for the exam (PDF)
no-answers.txt (1 KB)Step 8Text file with no answers in it
tuyenquang-questions.pdf (284 KB)Step 940-question exam
tuyenquang-answers-table.docx (48 KB)Step 9Answer key as a table with explanations (Word)

Steps

Step 1

Answer file types

PASS
Do this
  1. Create quiz 1 (see Setup) and open Edit questions.
  2. Under 1. Upload question PDF: Choose File → unit2-questions.pdf → Upload / retry PDF.
  3. Under 2. Enter the answer sheet: Choose File → set the picker to All files → choose a file that is not allowed, for example answers-dummy.xlsx → Upload answers and extract.
Expected
  • The file is refused at once. Nothing is uploaded.
  • Red message: Choose a PDF, Word (.docx), text (.txt), PNG or JPG answer file.
Result on beta, 18 Nov 2026
Message shown as expected. No request was sent to the server.
The refused .xlsx file and the message
The refused .xlsx file and the message
Step 2

Section labels from a worksheet

PASS
Do this
  1. Same quiz. Choose File → unit2-answers.docx → Upload answers and extract.
  2. Wait until Extracting answers… ends (about 1 to 3 minutes).
  3. Use the page buttons 1 to 6 above the sheet to look at all rows.
Expected
  • About 55 rows. Each row has the label printed on the paper, for example B1.3, D3a.1.
  • Essay items (C2, E2) are empty Short answer rows that are flagged for review.
  • A flagged row says: Question C2 needs review. Enter its answer, or remove the row if it cannot be graded automatically, for example an essay.
Result on beta, 18 Nov 2026
55 rows in about 75 seconds. 48 rows have an answer. 7 rows are flagged: C2, E2, and B5.1 to B5.5. B5.1 to B5.5 are answer keys for an exercise that is not in the question paper; they are listed after E1.5. The AI can give slightly different rows on another run.
Page 1: rows with the paper's labels
Page 1: rows with the paper's labels
Page 6: flagged rows
Page 6: flagged rows
Step 3

Essay rows block Save

PASS
Do this
  1. Do not change anything. Press Save answers (bottom right of the sheet).
Expected
  • Nothing is saved.
  • The sheet jumps to the first flagged row and opens it with: Question C2 — Accepted answers: enter at least one answer.
Result on beta, 18 Nov 2026
Save was blocked. The sheet opened row C2 with both messages.
Save blocked on the empty essay row
Save blocked on the empty essay row
Step 4

Labels stay when rows are added or removed

PASS
Do this
  1. Row B1.3 → … → Insert.
  2. Row B3.2 → … → Remove.
Expected
  • All other labels stay the same (no renumbering).
  • The new row has an empty label, shown as —, and asks for one: Enter a unique whole number or a short label such as B1.3.
Result on beta, 18 Nov 2026
The other labels did not change after the insert or after the remove. The new row had an empty label.
After Insert: new row with an empty label
After Insert: new row with an empty label
After Remove: other labels unchanged
After Remove: other labels unchanged
Step 5

Labels that are not allowed

PASS
Do this
  1. Open the new row (…). Set Question Type to Short Answer and type an accepted answer.
  2. In Question number or label type B 1 (with a space). Press Save answers.
  3. Change the label to B1.4 (same as another row). Press Save answers.
Expected
  • Both labels are refused and nothing is saved.
  • Message: Enter a unique whole number or a short label such as B1.3. For the duplicate, both rows show it.
Result on beta, 18 Nov 2026
Both cases were refused. No request was sent to the server.
Label with a space
Label with a space
Duplicate label
Duplicate label
Step 6

Save and reopen

PASS
Do this
  1. Give the new row a free label, for example B1.6.
  2. For each flagged row: type an accepted answer, or remove the row.
  3. Press Save answers, then reload the page.
Expected
  • Toast: Question(s) saved successfully for the quiz.
  • After reload the labels, order and answers are the same.
Result on beta, 18 Nov 2026
Saved with 54 rows. After reload the labels, order and answers were identical.
Saved
Saved
After reload
After reload
Step 7

Numbered exam renumbers 1..N

PASS
Do this
  1. Create quiz 2. Upload thpt2025-questions.pdf, then thpt2025-answers.pdf as the answer file.
  2. After extraction: page 2 → row 20 → … → Insert.
  3. Then remove the inserted row 21 and press Save answers.
Expected
  • 40 rows numbered 1 to 40, each with one answer.
  • After Insert the whole sheet is renumbered 1 to 41. After Remove it is 1 to 40 again.
Result on beta, 18 Nov 2026
40 rows with answers in about 40 seconds. Insert gave 1 to 41; remove gave 1 to 40. Saved.
After extraction
After extraction
After Insert: last row is 41
After Insert: last row is 41
Step 8

Answer file with no answers

PASS
Do this
  1. Quiz 2, after saving. Use no-answers.txt (a few lines of unrelated text).
  2. Choose it as the answer file → Upload answers and extract. Do not save afterwards.
Expected
  • Extraction finishes normally (it is not an error).
  • Yellow box: No answers could be matched with the help text The answer file was read, but no answer could be matched to the questions. Check the rows below, upload another answer file, or enter the answers manually.
Result on beta, 18 Nov 2026
Warning shown after about 39 seconds. The 40 saved answers stay on the server. Note: after a reload the editor opens on the new empty draft (0 of 40 answers) with the same warning, not on the saved answers. Students still get the saved answers.
The warning
The warning
Step 9

Explanations

PASS
Do this
  1. Create quiz 3. Upload tuyenquang-questions.pdf, then tuyenquang-answers-table.docx.
  2. After extraction: page 4 → row 31 → … → look at Explanation (optional).
  3. Press Save answers.
Expected
  • Rows have an explanation taken from the answer file.
  • Apostrophes and quotes look normal. The text ' does not appear.
Result on beta, 18 Nov 2026
40 rows, each with an answer and an explanation, in about 87 seconds. No ' anywhere in the data. Minor: some explanations have no line break between sentences.
Explanation of row 31 with normal apostrophes
Explanation of row 31 with normal apostrophes
Step 10

Student takes the labelled quiz

PASS
Do this
  1. Open the course as a learner and open quiz 1 (SP-732 TEST 1 - labelled worksheet).
  2. Press Start Quiz.
Expected
  • Each answer row is headed by its label (B1.1, B1.3 …).
  • The text NaN does not appear anywhere.
Result on beta, 18 Nov 2026
Labels shown; no NaN. The instructor account could open the learner page directly.
Quiz in progress
Quiz in progress
Step 11

Student review page

PASS
Do this
  1. Answer a few rows. Press Submit, then Submit anyway in the dialog.
  2. The review page opens.
Expected
  • Each row shows only its label, for example B1.3.
  • There is no running count before it (not 3. B1.3).
Result on beta, 18 Nov 2026
Rows are headed by the label only.
Review page: label only
Review page: label only
Step 12

Native quiz review still numbered

BLOCKED
Do this
  1. Open the review page of an attempt on a normal (not document) quiz.
Expected
  • Rows still start with 1., 2. … as before.
Result on beta, 18 Nov 2026
Not tested on beta. The only native quiz in this course is closed and has no attempt. This case passed on the local stack. To test it on beta, use any open native quiz with an attempt.
The native quiz in this course is closed
The native quiz in this course is closed

Not covered by this guide