Generated from
smart-base/L4/skills/smart-l4/complete-sdc-questionnaire.md— do not edit here.
Complete an SDC questionnaire
Skill id:
complete-sdc-questionnaire· Package:authoring-who-smart-guidelines· TaskTask_Completeofquestionnaire-data-capture.bpmn(Process_QuestionnaireDataCapture), lanehealth-worker.
Performed by a person: the health worker, or a client filling in a form on their own device. Their device’s form filler does the rendering; this skill is what the person does with it and what the result must be.
The meaning of every element is the FHIR R4
Questionnaire and
QuestionnaireResponse
and HL7 Structured Data Capture (SDC): this
skill restates none of it. A DAK’s forms are SDC Questionnaires (for example
sdc-questionnaire-extr-smap in WHO’s immunization and HIV DAKs); a form that
is not cannot be completed by this skill.
Input and output
The contract is input.schema.json
and output.schema.json.
- In: the
questionnaire(a FHIR R4 Questionnaire resource), how it isrenderedOn(form factor, language, whether offline), and, when the form is about someone, thesubjectand the SDClaunchContextvalues; anyprepopulatedQuestionnaireResponse that SDC$populateor the device filled in before the person saw the form. - Out: the
questionnaireResponse, and theissuesthe form filler raised that the person chose to leave (only for a response savedin-progress).
Preconditions
- The Questionnaire is
active(ordraft, in a test), and the device renders it whole: no item is silently dropped. - When the form has a
subject, the person has identified the client.
What the person does
- Read what is shown. Pre-populated answers are proposals: confirm or correct each one; the form filler marks none as confirmed for them.
- Answer the enabled items. An item whose
enableWhen(or SDCenableWhenExpression) is false is not shown and gets no answer. - Satisfy the form’s checks before submitting: every enabled
requireditem is answered; each answer has the item’s type and stays within itsanswerOption/answerValueSet,maxLength, and SDCminValue,maxValueandregexconstraints. - Submit, which marks the response
completed. Leaving it unfinished saves itin-progress, and nothing downstream reads it as complete.
Success criteria
questionnaireResponse.questionnaireis the Questionnaire’s canonical (url|version);subjectis the client the form is about.statusiscompleted, every enabledrequireditem has an answer, no disabled item has one, and everylinkIdis one of the Questionnaire’s.- The response validates against the Questionnaire (SDC form behaviour).
What it does not do
Creating the client’s resources from the answers is the system’s step,
extract-questionnaire-response. Authoring
or reviewing the form itself is fhir-harness’s fhir-questionnaire-wireframe.
Input and output contracts
What this skill takes and gives, as a class diagram drawn from its JSON Schema contracts by the schemas viewer’s own renderer. Each box links to its definition; each type to its specification.
- input:
smart-base/L4/schemas/skills/complete-sdc-questionnaire/input.schema.json - output:
smart-base/L4/schemas/skills/complete-sdc-questionnaire/output.schema.json
Processes that run this skill
| process | step(s) that name it |
|---|---|
| Capture data with an SDC questionnaire | Complete the form |