臺灣核心實作指引(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 CarePlan

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

此臺灣核心-照護計畫(TW Core CarePlan) Profile說明本IG如何進一步定義FHIR的CarePlan Resource以呈現照護計畫資料。

Usage:

Formal Views of Profile Content

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

NameFlagsCard.TypeDescription & Constraintsdoco
.. CarePlan 0..* CarePlan Healthcare plan for patient or group
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
... 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
... text S 0..1 Narrative CarePlan Resource之內容摘要以供人閱讀
ele-1: All FHIR elements must have a @value or children
.... status S 1..1 code generated | additional
Binding: 臺灣衛福部資訊處Narrative狀態值集 (required): Constrained value set of narrative statuses.


ele-1: All FHIR elements must have a @value or children
.... div SC 1..1 xhtml Limited xhtml content
ele-1: All FHIR elements must have a @value or children
txt-1: The narrative SHALL contain only the basic html formatting elements and attributes described in chapters 7-11 (except section 4 of chapter 9) and 15 of the HTML 4.0 standard, <a> elements (either name or href), images and internally contained style attributes
txt-2: The narrative SHALL have some non-whitespace content
... 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
... replaces Σ 0..* Reference(TW Core CarePlan) CarePlan replaced by this CarePlan
ele-1: All FHIR elements must have a @value or children
... partOf Σ 0..* Reference(TW Core CarePlan) Part of referenced CarePlan
ele-1: All FHIR elements must have a @value or children
... status ?!SΣ 1..1 code draft | active | on-hold | revoked | completed | entered-in-error | unknown
Binding: RequestStatus (required): Indicates whether the plan is currently being acted upon, represents future intentions or is now a historical record.


ele-1: All FHIR elements must have a @value or children
... intent ?!SΣ 1..1 code proposal | plan | order | option
Binding: CarePlanIntent (required): Codes indicating the degree of authority/intentionality associated with a care plan


ele-1: All FHIR elements must have a @value or children
... Slices for category SΣ 1..* CodeableConcept Type of plan
Slice: Unordered, Open by pattern:$this
Binding: CarePlanCategory (example): Identifies what "kind" of plan this is to support differentiation between multiple co-existing plans; e.g. "Home health", "psychiatric", "asthma", "disease management", etc.


ele-1: All FHIR elements must have a @value or children
.... category:AssessPlan SΣ 1..1 CodeableConcept Type of plan
Binding: CarePlanCategory (example): Identifies what "kind" of plan this is to support differentiation between multiple co-existing plans; e.g. "Home health", "psychiatric", "asthma", "disease management", etc.


ele-1: All FHIR elements must have a @value or children

Required Pattern: At least the following
..... coding 1..* Coding Code defined by a terminology system
Fixed Value: (complex)
...... system 1..1 uri Identity of the terminology system
Fixed Value: https://twcore.mohw.gov.tw/ig/twcore/CodeSystem/careplan-category-tw
...... code 1..1 code Symbol in syntax defined by the system
Fixed Value: assess-plan
... subject SΣ 1..1 Reference(TW Core Patient) Who the care plan is for
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
... author Σ 0..1 Reference(TW Core Patient | TW Core Practitioner | TW Core PractitionerRole | TW Core Implantable Device | TW Core RelatedPerson | TW Core Organization | TW Core CareTeam) Who is the designated responsible party
ele-1: All FHIR elements must have a @value or children
... contributor 0..* Reference(TW Core Patient | TW Core Practitioner | TW Core PractitionerRole | TW Core Implantable Device | TW Core RelatedPerson | TW Core Organization | TW Core CareTeam) Who provided the content of the care plan
ele-1: All FHIR elements must have a @value or children
... careTeam 0..* Reference(TW Core CareTeam) Who's involved in plan?
ele-1: All FHIR elements must have a @value or children
... addresses Σ 0..* Reference(TW Core Condition) Health issues this plan addresses
ele-1: All FHIR elements must have a @value or children

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet / CodeURI
CarePlan.text.statusrequiredTWNarrativeStatus
https://twcore.mohw.gov.tw/ig/twcore/ValueSet/narrative-status
from this IG
CarePlan.statusrequiredRequestStatus
http://hl7.org/fhir/ValueSet/request-status
from the FHIR Standard
CarePlan.intentrequiredCarePlanIntent
http://hl7.org/fhir/ValueSet/care-plan-intent
from the FHIR Standard
CarePlan.categoryexampleCarePlanCategory
http://hl7.org/fhir/ValueSet/care-plan-category
from the FHIR Standard
CarePlan.category:AssessPlanexamplePattern: assess-plan
http://hl7.org/fhir/ValueSet/care-plan-category
from the FHIR Standard

Constraints

IdGradePath(s)DetailsRequirements
dom-2errorCarePlanIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3errorCarePlanIf 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-4errorCarePlanIf 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-5errorCarePlanIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6best practiceCarePlanA 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()
txt-1errorCarePlan.text.divThe narrative SHALL contain only the basic html formatting elements and attributes described in chapters 7-11 (except section 4 of chapter 9) and 15 of the HTML 4.0 standard, <a> elements (either name or href), images and internally contained style attributes
: htmlChecks()
txt-2errorCarePlan.text.divThe narrative SHALL have some non-whitespace content
: htmlChecks()

 

Other representations of profile: CSV, Excel, Schematron

Notes:

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

必須支援以下查詢參數:

  1. 必須(SHALL) 支援透過查詢參數 patientcategory 查詢所有CarePlan:
    (如何透過reference查詢)
    (如何透過token查詢)
    GET [base]/CarePlan?patient={Type/}[id]&category=https://twcore.mohw.gov.tw/ig/twcore/CodeSystem/careplan-category-twy|assess-plan

    例子:
    (1) GET [base]/CarePlan?patient=Patient/pat-example&category=https://twcore.mohw.gov.tw/ig/twcore/CodeSystem/careplan-category-tw|assess-plan

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

  1. 建議應該(SHOULD) 支援透過查詢參數 patientcategorydate 查詢所有CarePlan:
    (如何透過reference查詢)
    (如何透過token查詢)
    (如何透過date查詢)
    GET [base]/CarePlan?patient={Type/}[id]&category=https://twcore.mohw.gov.tw/ig/twcore/CodeSystem/careplan-category-twy|assess-plan&date={gt|lt|ge|le}[date]{&date={gt|lt|ge|le}[date]&...}

    例子:
    (1) GET [base]/CarePlan?patient=Patient/pat-example&category=https://twcore.mohw.gov.tw/ig/twcore/CodeSystem/careplan-category-tw|assess-plan&date=ge2019-01-01T00:00:00Z
    (2) GET [base]/CarePlan?patient=Patient/pat-example&category=https://twcore.mohw.gov.tw/ig/twcore/CodeSystem/careplan-category-tw|assess-plan&date=ge2018-01-01T00:00:00Z&date=le2019-01-01T00:00:00Z

  2. 建議應該(SHOULD) 支援透過查詢參數 patientcategorystatus 查詢所有CarePlan:
    (如何透過reference查詢)
    (如何透過token查詢)
    GET [base]/CarePlan?patient={Type/}[id]&category=https://twcore.mohw.gov.tw/ig/twcore/CodeSystem/careplan-category-twy|assess-plan&status={system|}[code]{,{system|}[code],...}

    例子:
    (1) GET [base]/CarePlan?patient=Patient/pat-example&category=https://twcore.mohw.gov.tw/ig/twcore/CodeSystem/careplan-category-tw|assess-plan&status=active

  3. 建議應該(SHOULD) 支援透過查詢參數 patientcategorystatusdate 查詢所有CarePlan:
    (如何透過reference查詢)
    (如何透過token查詢)
    (如何透過date查詢)
    GET [base]/CarePlan?patient={Type/}[id]&category=https://twcore.mohw.gov.tw/ig/twcore/CodeSystem/careplan-category-twy|assess-plan&status={system|}[code]{,{system|}[code],...}&date={gt|lt|ge|le}[date]{&date={gt|lt|ge|le}[date]&...}

    例子:
    (1) GET [base]/CarePlan?patient=Patient/pat-example&category=https://twcore.mohw.gov.tw/ig/twcore/CodeSystem/careplan-category-tw|assess-plan&status=active&date=ge2019-01-01T00:00:00Z
    (2) GET [base]/CarePlan?patient=Patient/pat-example&category=https://twcore.mohw.gov.tw/ig/twcore/CodeSystem/careplan-category-tw|assess-plan&status=active&date=ge2018-01-01T00:00:00Z&date=le2019-01-01T00:00:00Z