臺灣核心實作指引(TW Core IG)
0.3.2 - Ci-Build Trial Use

臺灣核心實作指引(TW Core IG), published by 衛生福利部. This guide is not an authorized publication; it is the continuous build for version 0.3.2 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/cctwFHIRterm/MOHW_TWCoreIG_Build/ and changes regularly. See the Directory of published versions

Resource Profile: TW Core QuestionnaireResponse

Official URL: https://twcore.mohw.gov.tw/ig/twcore/StructureDefinition/QuestionnaireResponse-twcore Version: 0.3.2
Active as of 2025-02-04 Computable Name: TWCoreQuestionnaireResponse

此臺灣核心-問卷題目回覆(TW Core QuestionnaireResponse)Profile說明本IG如何進一步定義FHIR的QuestionnaireResponse Resource以呈現問卷題目回覆資料。

Usage:

Formal Views of Profile Content

Description of Profiles, Differentials, Snapshots and how the different presentations work.

NameFlagsCard.TypeDescription & Constraintsdoco
.. QuestionnaireResponse C 0..* SDCQuestionnaireResponse SDC Questionnaire Response
dom-2: If the resource is contained in another resource, it SHALL NOT contain nested Resources
dom-3: If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource
dom-4: If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated
dom-5: If a resource is contained in another resource, it SHALL NOT have a security label
dom-6: A resource should have narrative for robust management
sdcqr-1: Subject SHOULD be present (searching is difficult without subject). Almost all QuestionnaireResponses should be with respect to some sort of subject.
sdcqr-2: When repeats=true for a group, it'll be represented with multiple items with the same linkId in the QuestionnaireResponse. For a question, it'll be represented by a single item with that linkId with multiple answers.
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
ele-1: All FHIR elements must have a @value or children
... Slices for extension Content/Rules for all slices
.... signature 0..* Signature A signature attesting to the content
URL: http://hl7.org/fhir/StructureDefinition/questionnaireresponse-signature
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
.... completionMode 0..1 CodeableConcept E.g. Verbal, written, electronic
URL: http://hl7.org/fhir/StructureDefinition/questionnaireresponse-completionMode
Binding: QuestionnaireResponseMode (required): Codes indicating how the questionnaire was completed.


ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
... basedOn Σ 0..* Reference(TW Core CarePlan | TW Core ServiceRequest) Request fulfilled by this QuestionnaireResponse
ele-1: All FHIR elements must have a @value or children
... partOf Σ 0..* Reference(TW Core Observation Clinical Result | TW Core Procedure) Part of this action
ele-1: All FHIR elements must have a @value or children
... questionnaire SΣ 1..1 canonical(SDCBaseQuestionnaire) Form being answered
ele-1: All FHIR elements must have a @value or children
.... Slices for extension Content/Rules for all slices
..... questionnaireDisplay S 0..1 string Display name for canonical reference
URL: http://hl7.org/fhir/StructureDefinition/display
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
..... url S 0..1 uri Questionnaire Url
URL: https://twcore.mohw.gov.tw/ig/twcore/StructureDefinition/questionnaire-url
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
... status ?!SΣ 1..1 code in-progress | completed | amended | entered-in-error | stopped
Binding: QuestionnaireResponseStatus (required): Lifecycle status of the questionnaire response.


ele-1: All FHIR elements must have a @value or children
... subject SΣ 1..1 Reference(TW Core Patient) The subject of the questions
ele-1: All FHIR elements must have a @value or children
... encounter Σ 0..1 Reference(TW Core Encounter) Encounter created as part of
ele-1: All FHIR elements must have a @value or children
... authored SΣ 1..1 dateTime Date the answers were gathered
ele-1: All FHIR elements must have a @value or children
... author SΣ 0..1 Reference(TW Core Practitioner) Person who received and recorded the answers
ele-1: All FHIR elements must have a @value or children
... source Σ 0..1 Reference(TW Core Patient | TW Core Practitioner | TW Core PractitionerRole | TW Core RelatedPerson) The person who answered the questions
ele-1: All FHIR elements must have a @value or children
... item SC 0..* BackboneElement Groups and questions
ele-1: All FHIR elements must have a @value or children
qrs-1: Nested item can't be beneath both item and answer
.... Slices for extension Content/Rules for all slices
..... itemMedia 0..1 Attachment Media to display
URL: http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-itemMedia
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
..... ItemSignature 0..* Signature A signature attesting to the content
URL: http://hl7.org/fhir/StructureDefinition/questionnaireresponse-signature
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
.... linkId S 1..1 string Pointer to specific item from Questionnaire
ele-1: All FHIR elements must have a @value or children
.... text S 0..1 string Name for group or question text
ele-1: All FHIR elements must have a @value or children
.... answer S 0..* BackboneElement The response(s) to the question
ele-1: All FHIR elements must have a @value or children
..... Slices for extension Content/Rules for all slices
...... itemAnswerMedia 0..1 Attachment Answer Media to display
URL: http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-itemAnswerMedia
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
...... ordinalValue 0..1 decimal Assigned Ordinal Value
URL: http://hl7.org/fhir/StructureDefinition/ordinalValue
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
..... value[x] S 0..1 Single-valued answer to the question
Binding: QuestionnaireAnswerCodes (example): Code indicating the response provided for a question.


ele-1: All FHIR elements must have a @value or children
...... valueBoolean boolean
...... valueDate date
...... valueDateTime dateTime
..... item S 0..* See item (QuestionnaireResponse) Nested groups and questions
ele-1: All FHIR elements must have a @value or children
.... item S 0..* See item (QuestionnaireResponse) Nested questionnaire response items
ele-1: All FHIR elements must have a @value or children

doco Documentation for this format

Terminology Bindings

PathConformanceValueSetURI
QuestionnaireResponse.statusrequiredQuestionnaireResponseStatus
http://hl7.org/fhir/ValueSet/questionnaire-answers-status|4.0.1
from the FHIR Standard
QuestionnaireResponse.item.answer.value[x]exampleQuestionnaireAnswerCodes (a valid code from SNOMED CT)
http://hl7.org/fhir/ValueSet/questionnaire-answers
from the FHIR Standard

Constraints

IdGradePath(s)DetailsRequirements
dom-2errorQuestionnaireResponseIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3errorQuestionnaireResponseIf the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource
: contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4errorQuestionnaireResponseIf a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated
: contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5errorQuestionnaireResponseIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6best practiceQuestionnaireResponseA resource should have narrative for robust management
: text.`div`.exists()
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()
qrs-1errorQuestionnaireResponse.itemNested item can't be beneath both item and answer
: (answer.exists() and item.exists()).not()
sdcqr-1best practiceQuestionnaireResponseSubject SHOULD be present (searching is difficult without subject). Almost all QuestionnaireResponses should be with respect to some sort of subject.
: subject.exists()
sdcqr-2best practiceQuestionnaireResponseWhen repeats=true for a group, it'll be represented with multiple items with the same linkId in the QuestionnaireResponse. For a question, it'll be represented by a single item with that linkId with multiple answers.
: (QuestionnaireResponse|repeat(answer|item)).select(item.where(answer.value.exists()).linkId.isDistinct()).allTrue()

 

Other representations of profile: CSV, Excel, Schematron

Notes:

以下概述了此Profile所需的RESTful FHIR互動功能。有關TW Core IG支援的RESTful互動功能的完整清單,請參閱TW Core Server能力聲明

必須支援以下查詢參數:

  1. 必須(SHALL) 支援透過查詢參數 _id 查詢所有QuestionnaireResponse:
    (如何透過token查詢)

    GET [base]/QuestionnaireResponse?_id=[id]
    GET [base]/QuestionnaireResponse/[id]

    例子:
    (1) GET [base]/QuestionnaireResponse?_id=que-res-example
    (2) GET [base]/QuestionnaireResponse/que-res-example

  2. 必須(SHALL) 支援透過查詢參數 patient 查詢所有QuestionnaireResponse:
    (如何透過reference查詢)

    GET [base]/QuestionnaireResponse?patient={Type/}[id]

    例子:
    (1) GET [base]/QuestionnaireResponse?patient=Patient/pat-example

建議應該支援以下查詢參數:

  1. 建議應該(SHOULD) 支援透過查詢參數 patientstatus 查詢所有QuestionnaireResponse:
    (如何透過reference查詢)
    (如何透過token查詢)
    GET [base]/QuestionnaireResponse?patient={Type/}[id]&status={system|}[code]{,{system|}[code],...}

    例子:
    (1) GET [base]/QuestionnaireResponse?patient=Patient/pat-example&status=final

  2. 建議應該(SHOULD) 支援透過查詢參數 patientauthored 查詢所有QuestionnaireResponse:
    (如何透過reference查詢)
    (如何透過date查詢)

    GET [base]/QuestionnaireResponse?patient={Type/}[id]&authored={gt|lt|ge|le}[date]{&authored={gt|lt|ge|le}[date]&...}

    例子:
    (1) GET [base]/QuestionnaireResponse?Patient/pat-example&date=ge2021

  3. 建議應該(SHOULD) 支援透過查詢參數 patientquestionnaire 查詢所有QuestionnaireResponse:
    (如何透過reference查詢)

    GET [base]/QuestionnaireResponse?patient={Type/}[id]&questionnaire={Type/}[id]

    例子:
    (1) GET [base]/QuestionnaireResponse?Patient/pat-example&questionnaire=http://hl7.org/fhir/uv/sdc/Questionnaire/questionnaire-sdc-test-fhirpath-prepop-source-query