Author Short Answer Question — Backoffice

🔀

Sub-flow: Author Short Answer Question SUC-CCM-08

This page is a sub-flow invoked from another use case — when finished, control returns to the caller.

Question New Question Short Answer

Please fix the errors below before saving.

Question text *

Question text is required.

Accepted answers *

Add one or more keywords. The learner's response is matched against all keywords — the highest matching fraction determines the score. Multiple keywords accept spelling variants or synonyms.

Keyword	Fraction (0–1)	Feedback when matched (optional)

At least one keyword is required, and each keyword must be non-empty.

Case-insensitive matching

Applies to all keywords — when off, the learner's answer must match a keyword's exact casing.

Answer explanation (optional)

Shown to all learners after submission.

Points *

Total marks this question contributes.

Cancel Save Question

Prototype — simulate state:

Normal Validation error

Screen Flow (SUC-CCM-08):

→ Save OK → Return to caller (question saved) → Cancel → Caller (sub_cancelled=1, no save)

Spec notes

Identity

SUC-CCM-08 · Screen: SCR-CCM.07 (Question Editor — Short Answer)

ReturnUrl context

Current returnUrl: /manage-question-bank/
Fallback: / when returnUrl is empty.
Propagation: Save → returnUrl. Cancel → returnUrl + &sub_cancelled=1.

Sub-flow context

SUC-CCM-08 · Invoked by (Backoffice Portal): SUC-CCM-11 (Build Quiz) and UC-CCM.12 (Manage Question Bank).
Question type is locked to short_answer and cannot be changed after first save.
The learner's response is matched against all keywords — the highest matching fraction determines the score (partial credit supported).
New question: Question + QuestionVersion v1 + QuestionAnswer rows, status Active.
Edit mode: a new QuestionVersion is saved; the previous version is preserved for quiz sections already referencing it.
Cancel (AF 5A): no data saved, question bank unchanged.
Validation error (AF 6A): shows an error on each field that failed the requirement; resumes at step 5.

Screen spec: SCR-CCM.07 (short_answer type)

Regions: Question Header · Question Text · Type-Specific Content · Feedback & Explanation · Scoring · Form Actions
question_type (Field 2): read-only · locked to param.type = short_answer · data_ref: Question.type
question_text (Field 3): required · 1–5000 chars · data_ref: QuestionVersion.text
sa_keywords (Field 8): dynamic table — keyword (QuestionAnswer.content), fraction (QuestionAnswer.fraction, 0..1), feedback (QuestionAnswer.feedback, optional); at least 1 keyword required, each non-empty
sa_case_insensitive (Field 9): question-level toggle, default on (case-insensitive) · data_ref: QuestionVersion.config.case_insensitive
explanation (Field 5): optional · max 5000 · data_ref: QuestionVersion.config.explanation
points (Field 4): required · 0.01–1000 · default 1 · data_ref: QuestionVersion.points
AR#1: at least 1 keyword, each non-empty (SS-CCM.09). AR#2: atomic save — no partial data on failure (SS-CCM.07).