臺灣核心實作指引(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 Observation Pediatric Head Occipital Frontal Circumference Percentile

Official URL: https://twcore.mohw.gov.tw/ig/twcore/StructureDefinition/Observation-pediatric-head-circumference-twcore Version: 0.3.2
Active as of 2025-02-04 Computable Name: TWCoreObservationPediatricHeadOccipitalFrontalCircumferencePercentile

此臺灣核心-兒童頭圍百分位數(TW Core Observation Pediatric Head Occipital Frontal Circumference Percentile) Profile說明本IG如何進一步定義臺灣核心-生命體徵(TW Core Observation Vital Signs) Profile以呈現兒童頭圍百分位數資料。

Usage:

Formal Views of Profile Content

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

NameFlagsCard.TypeDescription & Constraintsdoco
.. Observation C 0..* TWCoreObservationVitalSigns 檢驗檢查,測量及簡單的判定。
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
obs-6: dataAbsentReason SHALL only be present if Observation.value[x] is not present
obs-7: If Observation.code is the same as an Observation.component.code then the value element associated with the code SHALL NOT be present
vs-2: If there is no component or hasMember element then either a value[x] or a data absent reason must be present.
... implicitRules ?!Σ 0..1 uri 創建此內容所依據的一組規則
ele-1: All FHIR elements must have a @value or children
... 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
... status ?!SΣ 1..1 code registered | preliminary | final | amended +
Binding: ObservationStatus (required): 檢驗檢查的狀態代碼;應填入所綁定值集中的其中一個代碼。


ele-1: All FHIR elements must have a @value or children
.... category:VSCat S 1..1 CodeableConceptTW 檢驗檢查分類
Binding: ObservationCategoryCodes (preferred): 高層次的檢驗檢查分類;鼓勵使用所綁定值集中的代碼,但不強制一定要使用此值集,你也可使用其他值集的代碼或單純以文字表示。


ele-1: All FHIR elements must have a @value or children
..... coding SΣ 1..* Coding 由專門術語系統(terminology system)定義的代碼
ele-1: All FHIR elements must have a @value or children
...... system SΣ 1..1 uri 專門術語系統(terminology system)的識別
ele-1: All FHIR elements must have a @value or children
Fixed Value: http://terminology.hl7.org/CodeSystem/observation-category
...... code SΣ 1..1 code 系統定義的語法之符號
ele-1: All FHIR elements must have a @value or children
Fixed Value: vital-signs
... code SΣ 1..1 CodeableConceptTW Head Occipital-frontal circumference Percentile
Binding: LOINC生命體徵值集 (extensible): 應填入所綁定值集中的其中一個代碼。


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: http://loinc.org
..... code 1..1 code Symbol in syntax defined by the system
Fixed Value: 8289-1
.... coding SΣ 0..* CodingTW 由專門術語系統(terminology system)定義的代碼
ele-1: All FHIR elements must have a @value or children
.... text SΣ 0..1 string 概念的文字表示法
ele-1: All FHIR elements must have a @value or children
... subject SΣ 1..1 Reference(TW Core Patient) 檢驗檢查有關的對象及(或)事物
ele-1: All FHIR elements must have a @value or children
... effective[x] SΣC 1..1 檢驗檢查執行日期或時間區間
ele-1: All FHIR elements must have a @value or children
vs-1: if Observation.effective[x] is dateTime and has a value then that value shall be precise to the day
.... effectiveDateTime dateTime
... performer SΣ 0..* Reference(TW Core Practitioner | TW Core Organization | TW Core Patient | TW Core PractitionerRole | TW Core CareTeam) 誰負責這項檢驗檢查
ele-1: All FHIR elements must have a @value or children
... Slices for value[x] SΣC 0..1 檢驗檢查的實際結果
Slice: Unordered, Open by type:$this
Binding: VitalSignsUnits (extensible): 用於記錄生命體徵的常用UCUM單元;應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。


ele-1: All FHIR elements must have a @value or children
.... valueQuantity Quantity
.... value[x]:valueQuantity SΣC 0..1 Quantity 檢驗檢查的實際結果
Binding: VitalSignsUnits (extensible): 用於記錄生命體徵的常用UCUM單元;應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。


ele-1: All FHIR elements must have a @value or children
..... value SΣ 1..1 decimal Numerical value (with implicit precision)
ele-1: All FHIR elements must have a @value or children
..... comparator ?!Σ 0..1 code < | <= | >= | > - how to understand the value
Binding: QuantityComparator (required): How the Quantity should be understood and represented.


ele-1: All FHIR elements must have a @value or children
..... unit SΣ 1..1 string Unit representation
ele-1: All FHIR elements must have a @value or children
..... system SΣC 1..1 uri System that defines coded unit form
ele-1: All FHIR elements must have a @value or children
Fixed Value: http://unitsofmeasure.org
..... code SΣ 1..1 code Coded form of the unit
ele-1: All FHIR elements must have a @value or children
Fixed Value: %
... dataAbsentReason SC 0..1 CodeableConceptTW 缺少檢驗檢查結果的原因
Binding: DataAbsentReason (extensible): 代碼具體說明檢驗檢查結果缺少的原因;應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。


ele-1: All FHIR elements must have a @value or children
... component SΣC 0..* BackboneElement 組成之(部分)檢驗檢查的檢驗結果
ele-1: All FHIR elements must have a @value or children
vs-3: If there is no a value a data absent reason must be present
.... 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
.... code SΣ 1..1 CodeableConceptTW 組成之檢驗檢查的型別(代碼/型別)
Binding: LOINC生命體徵值集 (extensible): 代碼指明檢驗檢查的名稱;可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。


ele-1: All FHIR elements must have a @value or children
.... value[x] SΣC 0..1 Vital Sign Value recorded with UCUM
Binding: VitalSignsUnits (extensible): Common UCUM units for recording Vital Signs.


ele-1: All FHIR elements must have a @value or children
..... valueQuantity Quantity
.... dataAbsentReason SC 0..1 CodeableConceptTW 為什麼缺少組成之檢驗檢查結果
Binding: DataAbsentReason (extensible): 代碼指明為什麼結果(Observation.value[x])缺少;應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。


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

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet / CodeURI
Observation.statusrequiredObservationStatus
http://hl7.org/fhir/ValueSet/observation-status|4.0.1
from the FHIR Standard
Observation.categorypreferredObservationCategoryCodes
http://hl7.org/fhir/ValueSet/observation-category
from the FHIR Standard
Observation.category:VSCatpreferredObservationCategoryCodes
http://hl7.org/fhir/ValueSet/observation-category
from the FHIR Standard
Observation.codeextensiblePattern: LOINC Code 8289-1
https://twcore.mohw.gov.tw/ig/twcore/ValueSet/vital-signs-tw
from this IG
Observation.value[x]extensibleVitalSignsUnits
http://hl7.org/fhir/ValueSet/ucum-vitals-common
from the FHIR Standard
Observation.value[x]:valueQuantityextensibleVitalSignsUnits
http://hl7.org/fhir/ValueSet/ucum-vitals-common
from the FHIR Standard
Observation.value[x]:valueQuantity.comparatorrequiredQuantityComparator
http://hl7.org/fhir/ValueSet/quantity-comparator|4.0.1
from the FHIR Standard
Observation.dataAbsentReasonextensibleDataAbsentReason
http://hl7.org/fhir/ValueSet/data-absent-reason
from the FHIR Standard
Observation.component.codeextensibleTWVitalSigns
https://twcore.mohw.gov.tw/ig/twcore/ValueSet/vital-signs-tw
from this IG
Observation.component.value[x]extensibleVitalSignsUnits
http://hl7.org/fhir/ValueSet/ucum-vitals-common|4.0.1
from the FHIR Standard
Observation.component.dataAbsentReasonextensibleDataAbsentReason
http://hl7.org/fhir/ValueSet/data-absent-reason
from the FHIR Standard

Constraints

IdGradePath(s)DetailsRequirements
dom-2errorObservationIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3errorObservationIf 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-4errorObservationIf 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-5errorObservationIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6best practiceObservationA 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()
obs-6errorObservationdataAbsentReason SHALL only be present if Observation.value[x] is not present
: dataAbsentReason.empty() or value.empty()
obs-7errorObservationIf Observation.code is the same as an Observation.component.code then the value element associated with the code SHALL NOT be present
: value.empty() or component.code.where(coding.intersect(%resource.code.coding).exists()).empty()
vs-1errorObservation.effective[x]if Observation.effective[x] is dateTime and has a value then that value shall be precise to the day
: $this is dateTime implies $this.toString().length() >= 10
vs-2errorObservationIf there is no component or hasMember element then either a value[x] or a data absent reason must be present.
: (component.empty() and hasMember.empty()) implies (dataAbsentReason.exists() or value.exists())
vs-3errorObservation.componentIf there is no a value a data absent reason must be present
: value.exists() or dataAbsentReason.exists()

 

Other representations of profile: CSV, Excel, Schematron

Notes:

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

必須支援以下查詢參數:

  1. 必須(SHALL) 支援透過查詢參數 patientcategory 查詢所有Observation:
    (如何透過reference查詢)
    (如何透過token查詢)
    GET [base]/Observation?patient={Type/}[id]&category=http://terminology.hl7.org/CodeSystem/observation-category|vital-signs

    例子:
    (1) GET [base]/Observation?patient=Patient/pat-example&category=http://terminology.hl7.org/CodeSystem/observation-category|vital-signs

  2. 必須(SHALL) 支援透過查詢參數 patientcode 查詢所有Observation:
    (如何透過reference查詢)
    (如何透過token查詢)
    GET [base]/Observation?patient={Type/}[id]&code={system|}[code]{,{system|}[code],...}

    例子:
    (1) GET [base]/Observation?patient=Patient/pat-example&code=http://loinc.org|8289-1

  3. 必須(SHALL) 支援透過查詢參數 patientcategorydate 查詢所有Observation:
    (如何透過reference查詢)
    (如何透過token查詢)
    (如何透過date查詢)
    GET [base]/Observation?patient={Type/}[id]&category=http://terminology.hl7.org/CodeSystem/observation-category|vital-signs&date={gt|lt|ge|le}[date]{&date={gt|lt|ge|le}[date]&...}

    例子:
    (1) GET [base]/Observation?patient=Patient/pat-example&category=http://terminology.hl7.org/CodeSystem/observation-category|vital-signs&date=ge2020-01-01T00:00:00Z

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

  1. 建議應該(SHOULD) 支援透過查詢參數 patientcategorystatus 查詢所有Observation:
    (如何透過reference查詢)
    (如何透過token查詢)
    GET [base]/Observation?patient={Type/}[id]&category=http://terminology.hl7.org/CodeSystem/observation-category|laboratory&status={system|}[code]{,{system|}[code],...}

    例子:
    (1) GET [base]/Observation?patient=Patient/pat-example&category=http://terminology.hl7.org/CodeSystem/observation-category|vital-signs&status=final

  2. 建議應該(SHOULD) 支援透過查詢參數 patientcategory_lastUpdated 查詢所有Observation:
    (如何透過reference查詢)
    (如何透過token查詢)
    (如何透過date查詢)
    GET [base]/Observation?patient={Type/}[id]&category={system|}[code]&_lastUpdated={gt|lt|ge|le}[date]{&_lastUpdated={gt|lt|ge|le}[date]&...}

    例子:
    (1) GET [base]/Observation?patient=Patient/pat-example&category=http://terminology.hl7.org/CodeSystem/observation-category|vital-signs&_lastUpdated=ge2024-01-01T00:00:00Z

  3. 支援透過查詢參數 patientcodedate 查詢所有Observation:
    (如何透過reference查詢)
    (如何透過token查詢)
    (如何透過date查詢)
    GET [base]/Observation?patient={Type/}[id]&code={system|}[code]{,{system|}[code],...}&date={gt|lt|ge|le}[date]{&date={gt|lt|ge|le}[date]&...}

    例子:
    (1) GET [base]/Observation?patient=Patient/pat-example&code=http://loinc.org|8289-1&date=ge2020-01-01T00:00:00Z