臺灣社政領域基礎實作指引
0.0.1 - ci-build

臺灣社政領域基礎實作指引, published by 衛生福利部社會及家庭署. This guide is not an authorized publication; it is the continuous build for version 0.0.1 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/sfaassn2025-source/base/ and changes regularly. See the Directory of published versions

Resource Profile: 社福表單回覆-QuestionnaireResponse TWSS Base

Official URL: https://sfaa.gov.tw/base/StructureDefinition/QuestionnaireResponse-twss-base Version: 0.0.1
Draft as of 2026-09-03 Computable Name: QuestionnaireResponseTWSSBase

因 TW Core 0.3.2 的 QuestionnaireResponse Profile 限制與本 IG 所需的 Reference target 不完全相容，故繼承原生 QuestionnaireResponse，並保留相容的 TW Core 0.3.2 交換規則。

Usages:

You can also check for usages in the FHIR IG Statistics

Formal Views of Profile Content

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

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. QuestionnaireResponse 0..* QuestionnaireResponse A structured set of questions and their answers
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... basedOn SΣ 0..* Reference(個案通報-ServiceRequest TWSS Base | 個案轉介-ServiceRequest TWSS Base | 個案轉銜-ServiceRequest TWSS Base | 個案服務計畫-CarePlan TWSS Base) Request fulfilled by this QuestionnaireResponse
... status ?!SΣ 1..1 code in-progress | completed | amended | entered-in-error | stopped
Binding: QuestionnaireResponseStatus (required): Lifecycle status of the questionnaire response.
... subject SΣ 1..1 Reference(個案資料-Patient TWSS Base | 關係人資料-RelatedPerson TWSS Base | 人員資料-Practitioner TWSS Base | 人員角色-PractitionerRole TWSS Base | 機構資料-Organization TWSS Base) The subject of the questions
... encounter SΣ 0..1 Reference(個案評估或服務接觸-Encounter TWSS Base | 個案實際服務-Encounter TWSS Base | 個案會談-Encounter TWSS Base | 個案會議-Encounter TWSS Base | 安置服務-Encounter TWSS Base) Encounter created as part of
... authored SΣ 1..1 dateTime Date the answers were gathered
... author SΣ 0..1 Reference(Device | Practitioner | PractitionerRole | Patient | RelatedPerson | Organization) Person who received and recorded the answers
... source SΣ 0..1 Reference(個案資料-Patient TWSS Base | 關係人資料-RelatedPerson TWSS Base | 人員資料-Practitioner TWSS Base | 人員角色-PractitionerRole TWSS Base) The person who answered the questions
... item SC 0..* BackboneElement Groups and questions
Constraints: qrs-1
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... linkId 1..1 string Pointer to specific item from Questionnaire

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
QuestionnaireResponse.​status Base required QuestionnaireResponseStatus 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error QuestionnaireResponse If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error QuestionnaireResponse 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 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-4 error QuestionnaireResponse If 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-5 error QuestionnaireResponse If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice QuestionnaireResponse A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
qrs-1 error QuestionnaireResponse.item Nested item can't be beneath both item and answer (answer.exists() and item.exists()).not()

This structure is derived from QuestionnaireResponse

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. QuestionnaireResponse 0..* QuestionnaireResponse A structured set of questions and their answers
... basedOn S 0..* Reference(個案通報-ServiceRequest TWSS Base | 個案轉介-ServiceRequest TWSS Base | 個案轉銜-ServiceRequest TWSS Base | 個案服務計畫-CarePlan TWSS Base) Request fulfilled by this QuestionnaireResponse
... questionnaire S 1..1 canonical(社福表單-Questionnaire TWSS Base) 本 IG 社福 Questionnaire 的 canonical URL
... status S 1..1 code in-progress | completed | amended | entered-in-error | stopped
... encounter S 0..1 Reference(個案評估或服務接觸-Encounter TWSS Base | 個案實際服務-Encounter TWSS Base | 個案會談-Encounter TWSS Base | 個案會議-Encounter TWSS Base | 安置服務-Encounter TWSS Base) Encounter created as part of
... authored S 1..1 dateTime Date the answers were gathered
... author S 0..1 Reference(Device | Practitioner | PractitionerRole | Patient | RelatedPerson | Organization) Person who received and recorded the answers
... source S 0..1 Reference(個案資料-Patient TWSS Base | 關係人資料-RelatedPerson TWSS Base | 人員資料-Practitioner TWSS Base | 人員角色-PractitionerRole TWSS Base) The person who answered the questions
... item S 0..* BackboneElement Groups and questions

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. QuestionnaireResponse 0..* QuestionnaireResponse A structured set of questions and their answers
... id Σ 0..1 id Logical id of this artifact
... meta Σ 0..1 Meta Metadata about the resource
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... text 0..1 Narrative Text summary of the resource, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
... contained 0..* Resource Contained, inline Resources
... extension 0..* Extension Additional content defined by implementations
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... identifier Σ 0..1 Identifier Unique id for this set of answers
... basedOn SΣ 0..* Reference(個案通報-ServiceRequest TWSS Base | 個案轉介-ServiceRequest TWSS Base | 個案轉銜-ServiceRequest TWSS Base | 個案服務計畫-CarePlan TWSS Base) Request fulfilled by this QuestionnaireResponse
... partOf Σ 0..* Reference(Observation | Procedure) Part of this action
... questionnaire SΣ 1..1 canonical(社福表單-Questionnaire TWSS Base) 本 IG 社福 Questionnaire 的 canonical URL
... status ?!SΣ 1..1 code in-progress | completed | amended | entered-in-error | stopped
Binding: QuestionnaireResponseStatus (required): Lifecycle status of the questionnaire response.
... subject SΣ 1..1 Reference(個案資料-Patient TWSS Base | 關係人資料-RelatedPerson TWSS Base | 人員資料-Practitioner TWSS Base | 人員角色-PractitionerRole TWSS Base | 機構資料-Organization TWSS Base) The subject of the questions
... encounter SΣ 0..1 Reference(個案評估或服務接觸-Encounter TWSS Base | 個案實際服務-Encounter TWSS Base | 個案會談-Encounter TWSS Base | 個案會議-Encounter TWSS Base | 安置服務-Encounter TWSS Base) Encounter created as part of
... authored SΣ 1..1 dateTime Date the answers were gathered
... author SΣ 0..1 Reference(Device | Practitioner | PractitionerRole | Patient | RelatedPerson | Organization) Person who received and recorded the answers
... source SΣ 0..1 Reference(個案資料-Patient TWSS Base | 關係人資料-RelatedPerson TWSS Base | 人員資料-Practitioner TWSS Base | 人員角色-PractitionerRole TWSS Base) The person who answered the questions
... item SC 0..* BackboneElement Groups and questions
Constraints: qrs-1
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... linkId 1..1 string Pointer to specific item from Questionnaire
.... definition 0..1 uri ElementDefinition - details for the item
.... text 0..1 string Name for group or question text
.... answer 0..* BackboneElement The response(s) to the question
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... value[x] 0..1 Single-valued answer to the question
Binding: QuestionnaireAnswerCodes (example): Code indicating the response provided for a question.
...... valueBoolean boolean
...... valueDecimal decimal
...... valueInteger integer
...... valueDate date
...... valueDateTime dateTime
...... valueTime time
...... valueString string
...... valueUri uri
...... valueAttachment Attachment
...... valueCoding Coding
...... valueQuantity Quantity
...... valueReference Reference(Resource)
..... item 0..* See item (QuestionnaireResponse) Nested groups and questions
.... item 0..* See item (QuestionnaireResponse) Nested questionnaire response items

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
QuestionnaireResponse.​language Base preferred Common Languages 📍4.0.1 FHIR Std.
QuestionnaireResponse.​status Base required QuestionnaireResponseStatus 📍4.0.1 FHIR Std.
QuestionnaireResponse.​item.answer.value[x] Base example Questionnaire Answer Codes 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error QuestionnaireResponse If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error QuestionnaireResponse 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 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-4 error QuestionnaireResponse If 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-5 error QuestionnaireResponse If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice QuestionnaireResponse A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
qrs-1 error QuestionnaireResponse.item Nested item can't be beneath both item and answer (answer.exists() and item.exists()).not()

This structure is derived from QuestionnaireResponse

Summary

Mandatory: 3 elements
Must-Support: 9 elements

Structures

This structure refers to these other structures:

Key Elements View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. QuestionnaireResponse 0..* QuestionnaireResponse A structured set of questions and their answers
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... basedOn SΣ 0..* Reference(個案通報-ServiceRequest TWSS Base | 個案轉介-ServiceRequest TWSS Base | 個案轉銜-ServiceRequest TWSS Base | 個案服務計畫-CarePlan TWSS Base) Request fulfilled by this QuestionnaireResponse
... status ?!SΣ 1..1 code in-progress | completed | amended | entered-in-error | stopped
Binding: QuestionnaireResponseStatus (required): Lifecycle status of the questionnaire response.
... subject SΣ 1..1 Reference(個案資料-Patient TWSS Base | 關係人資料-RelatedPerson TWSS Base | 人員資料-Practitioner TWSS Base | 人員角色-PractitionerRole TWSS Base | 機構資料-Organization TWSS Base) The subject of the questions
... encounter SΣ 0..1 Reference(個案評估或服務接觸-Encounter TWSS Base | 個案實際服務-Encounter TWSS Base | 個案會談-Encounter TWSS Base | 個案會議-Encounter TWSS Base | 安置服務-Encounter TWSS Base) Encounter created as part of
... authored SΣ 1..1 dateTime Date the answers were gathered
... author SΣ 0..1 Reference(Device | Practitioner | PractitionerRole | Patient | RelatedPerson | Organization) Person who received and recorded the answers
... source SΣ 0..1 Reference(個案資料-Patient TWSS Base | 關係人資料-RelatedPerson TWSS Base | 人員資料-Practitioner TWSS Base | 人員角色-PractitionerRole TWSS Base) The person who answered the questions
... item SC 0..* BackboneElement Groups and questions
Constraints: qrs-1
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... linkId 1..1 string Pointer to specific item from Questionnaire

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
QuestionnaireResponse.​status Base required QuestionnaireResponseStatus 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error QuestionnaireResponse If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error QuestionnaireResponse 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 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-4 error QuestionnaireResponse If 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-5 error QuestionnaireResponse If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice QuestionnaireResponse A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
qrs-1 error QuestionnaireResponse.item Nested item can't be beneath both item and answer (answer.exists() and item.exists()).not()

Differential View

This structure is derived from QuestionnaireResponse

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. QuestionnaireResponse 0..* QuestionnaireResponse A structured set of questions and their answers
... basedOn S 0..* Reference(個案通報-ServiceRequest TWSS Base | 個案轉介-ServiceRequest TWSS Base | 個案轉銜-ServiceRequest TWSS Base | 個案服務計畫-CarePlan TWSS Base) Request fulfilled by this QuestionnaireResponse
... questionnaire S 1..1 canonical(社福表單-Questionnaire TWSS Base) 本 IG 社福 Questionnaire 的 canonical URL
... status S 1..1 code in-progress | completed | amended | entered-in-error | stopped
... encounter S 0..1 Reference(個案評估或服務接觸-Encounter TWSS Base | 個案實際服務-Encounter TWSS Base | 個案會談-Encounter TWSS Base | 個案會議-Encounter TWSS Base | 安置服務-Encounter TWSS Base) Encounter created as part of
... authored S 1..1 dateTime Date the answers were gathered
... author S 0..1 Reference(Device | Practitioner | PractitionerRole | Patient | RelatedPerson | Organization) Person who received and recorded the answers
... source S 0..1 Reference(個案資料-Patient TWSS Base | 關係人資料-RelatedPerson TWSS Base | 人員資料-Practitioner TWSS Base | 人員角色-PractitionerRole TWSS Base) The person who answered the questions
... item S 0..* BackboneElement Groups and questions

doco Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. QuestionnaireResponse 0..* QuestionnaireResponse A structured set of questions and their answers
... id Σ 0..1 id Logical id of this artifact
... meta Σ 0..1 Meta Metadata about the resource
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... text 0..1 Narrative Text summary of the resource, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
... contained 0..* Resource Contained, inline Resources
... extension 0..* Extension Additional content defined by implementations
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... identifier Σ 0..1 Identifier Unique id for this set of answers
... basedOn SΣ 0..* Reference(個案通報-ServiceRequest TWSS Base | 個案轉介-ServiceRequest TWSS Base | 個案轉銜-ServiceRequest TWSS Base | 個案服務計畫-CarePlan TWSS Base) Request fulfilled by this QuestionnaireResponse
... partOf Σ 0..* Reference(Observation | Procedure) Part of this action
... questionnaire SΣ 1..1 canonical(社福表單-Questionnaire TWSS Base) 本 IG 社福 Questionnaire 的 canonical URL
... status ?!SΣ 1..1 code in-progress | completed | amended | entered-in-error | stopped
Binding: QuestionnaireResponseStatus (required): Lifecycle status of the questionnaire response.
... subject SΣ 1..1 Reference(個案資料-Patient TWSS Base | 關係人資料-RelatedPerson TWSS Base | 人員資料-Practitioner TWSS Base | 人員角色-PractitionerRole TWSS Base | 機構資料-Organization TWSS Base) The subject of the questions
... encounter SΣ 0..1 Reference(個案評估或服務接觸-Encounter TWSS Base | 個案實際服務-Encounter TWSS Base | 個案會談-Encounter TWSS Base | 個案會議-Encounter TWSS Base | 安置服務-Encounter TWSS Base) Encounter created as part of
... authored SΣ 1..1 dateTime Date the answers were gathered
... author SΣ 0..1 Reference(Device | Practitioner | PractitionerRole | Patient | RelatedPerson | Organization) Person who received and recorded the answers
... source SΣ 0..1 Reference(個案資料-Patient TWSS Base | 關係人資料-RelatedPerson TWSS Base | 人員資料-Practitioner TWSS Base | 人員角色-PractitionerRole TWSS Base) The person who answered the questions
... item SC 0..* BackboneElement Groups and questions
Constraints: qrs-1
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... linkId 1..1 string Pointer to specific item from Questionnaire
.... definition 0..1 uri ElementDefinition - details for the item
.... text 0..1 string Name for group or question text
.... answer 0..* BackboneElement The response(s) to the question
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... value[x] 0..1 Single-valued answer to the question
Binding: QuestionnaireAnswerCodes (example): Code indicating the response provided for a question.
...... valueBoolean boolean
...... valueDecimal decimal
...... valueInteger integer
...... valueDate date
...... valueDateTime dateTime
...... valueTime time
...... valueString string
...... valueUri uri
...... valueAttachment Attachment
...... valueCoding Coding
...... valueQuantity Quantity
...... valueReference Reference(Resource)
..... item 0..* See item (QuestionnaireResponse) Nested groups and questions
.... item 0..* See item (QuestionnaireResponse) Nested questionnaire response items

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
QuestionnaireResponse.​language Base preferred Common Languages 📍4.0.1 FHIR Std.
QuestionnaireResponse.​status Base required QuestionnaireResponseStatus 📍4.0.1 FHIR Std.
QuestionnaireResponse.​item.answer.value[x] Base example Questionnaire Answer Codes 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error QuestionnaireResponse If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error QuestionnaireResponse 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 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-4 error QuestionnaireResponse If 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-5 error QuestionnaireResponse If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice QuestionnaireResponse A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
qrs-1 error QuestionnaireResponse.item Nested item can't be beneath both item and answer (answer.exists() and item.exists()).not()

This structure is derived from QuestionnaireResponse

Summary

Mandatory: 3 elements
Must-Support: 9 elements

Structures

This structure refers to these other structures:

 

Other representations of profile: CSV, Excel, Schematron

Notes:

使用範圍

本 Profile 為社福 QuestionnaireResponse 的共用 Profile。subject 可為個案、關係人、服務人、服務人任職角色或機構；basedOn 與 encounter 為選填，應依填答發生的流程階段參照相應的 ServiceRequest、CarePlan 或 Encounter。

個案服務評估應使用「個案服務評估回覆」子 Profile；其他表單使用本共用 Profile，並依各 Questionnaire 的 subjectType 指定填答對象。

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

此 Profile 使用 FHIR R4 QuestionnaireResponse Resource；伺服端建議（SHOULD）支援以下 FHIR 原生查詢參數： 完整定義請參考 FHIR R4 QuestionnaireResponse 原生查詢參數。

查詢參數 類型 查詢範例
_content string GET [base]/_content=[value]
_filter special GET [base]/_filter=[value]
_id token GET [base]/QuestionnaireResponse/[id]
_lastUpdated date GET [base]/_lastUpdated=[value]
_profile uri GET [base]/_profile=[value]
_query token GET [base]/_query=[value]
_security token GET [base]/_security=[value]
_source uri GET [base]/_source=[value]
_tag token GET [base]/_tag=[value]
_text string GET [base]/_text=[value]
author reference GET [base]/author=[value]
authored date GET [base]/authored=[value]
based-on reference GET [base]/based-on=[value]
encounter reference GET [base]/encounter=[value]
identifier token GET [base]/identifier=[value]
item-subject reference GET [base]/item-subject=[value]
part-of reference GET [base]/part-of=[value]
patient reference GET [base]/patient=[value]
questionnaire reference GET [base]/questionnaire=[value]
source reference GET [base]/source=[value]
status token GET [base]/status=[value]
subject reference GET [base]/subject=[value]