TW Core Observation Pulse Oximetry - 臺灣核心實作指引(TW Core IG) v0.3.2

This page is part of the 臺灣核心實作指引(TW Core IG) (v0.3.2: Releases) based on FHIR (HL7® FHIR® Standard) R4. This is the current published version in its permanent home (it will always be available at this URL). For a full list of available versions, see the Directory of published versions

Resource Profile: TW Core Observation Pulse Oximetry

Official URL: https://twcore.mohw.gov.tw/ig/twcore/StructureDefinition/Observation-pulse-oximetry-twcore				Version: 0.3.2
Active as of 2024-12-12			Computable Name: TWCoreObservationPulseOximetry

此臺灣核心-脈搏血氧飽和度（TW Core Observation Pulse Oximetry） Profile說明本IG如何進一步定義臺灣核心-生命體徵（TW Core Observation Vital Signs） Profile以呈現脈搏血氧飽和度資料。

Usage:

Examples for this Resource Profile: Observation/obs-pulse-oximetry-example

Formal Views of Profile Content

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

Differential Table
Key Elements Table
Snapshot Table
Statistics/References
All

This structure is derived from TWCoreObservationVitalSigns

Name	Flags	Card.	Type	Description & Constraints
Observation		0..*	TWCoreObservationVitalSigns	檢驗檢查，測量及簡單的判定。
code		1..1	CodeableConceptTW	Oxygen Saturation by Pulse Oximetry
Slices for coding	S	2..*	CodingTW	由專門術語系統（terminology system）定義的代碼 Slice: Unordered, Open by pattern:$this
coding:PulseOx	S	1..1	CodingTW	Oxygen saturation in Arterial blood by Pulse oximetry Required Pattern: At least the following
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: 59408-5
coding:OxygenSatCode	S	1..1	CodingTW	Oxygen saturation in Arterial blood Required Pattern: At least the following
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: 2708-6
Slices for value[x]		0..1	Quantity, CodeableConcept, string, boolean, integer, Range, Ratio, SampledData, time, dateTime, Period	檢驗檢查的實際結果 Slice: Unordered, Open by type:$this
value[x]:valueQuantity	S	0..1	Quantity S	檢驗檢查的實際結果
value	S	1..1	decimal	Numerical value (with implicit precision)
unit	S	1..1	string	Unit representation
system	S	1..1	uri	System that defines coded unit form Fixed Value: http://unitsofmeasure.org
code	S	1..1	code	Coded form of the unit Fixed Value: %
Slices for component		0..*	BackboneElement	Used when reporting flow rates or oxygen concentration. Slice: Unordered, Open by pattern:code
component:FlowRate	S	0..1	BackboneElement	Inhaled oxygen flow rate
code		1..1	CodeableConceptTW	組成之檢驗檢查的型別（代碼／型別） 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: 3151-8
Slices for value[x]		0..1	Quantity, CodeableConcept, string, boolean, integer, Range, Ratio, SampledData, time, dateTime, Period	Vital Sign Value recorded with UCUM Slice: Unordered, Open by type:$this
value[x]:valueQuantity	S	0..1	Quantity S	Vital Sign Component Value
value	S	1..1	decimal	Numerical value (with implicit precision)
unit	S	1..1	string	Unit representation
system	S	1..1	uri	System that defines coded unit form Fixed Value: http://unitsofmeasure.org
code	S	1..1	code	Coded form of the unit Fixed Value: L/min
component:Concentration	S	0..1	BackboneElement	Inhaled oxygen concentration
code		1..1	CodeableConceptTW	組成之檢驗檢查的型別（代碼／型別） 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: 3150-0
Slices for value[x]		0..1	Quantity, CodeableConcept, string, boolean, integer, Range, Ratio, SampledData, time, dateTime, Period	Vital Sign Value recorded with UCUM Slice: Unordered, Open by type:$this
value[x]:valueQuantity	S	0..1	Quantity S	Vital Sign Component Value
value	S	1..1	decimal	Numerical value (with implicit precision)
unit	S	1..1	string	Unit representation
system	S	1..1	uri	System that defines coded unit form Fixed Value: http://unitsofmeasure.org
code	S	1..1	code	Coded form of the unit Fixed Value: %
Documentation for this format

Name	Flags	Card.	Type	Description & Constraints
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
Slices for category	S	1..*	CodeableConceptTW	概念（concept）－參照一個專門術語或只是純文字。 Slice: Unordered, Open by value:coding.code, value:coding.system Binding: ObservationCategoryCodes (preferred): 高層次的檢驗檢查分類；鼓勵使用所綁定值集中的代碼，但不強制一定要使用此值集，你也可使用其他值集的代碼或單純以文字表示。 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	Oxygen Saturation by Pulse Oximetry Binding: LOINC生命體徵值集 (extensible): 應填入所綁定值集中的其中一個代碼。 ele-1: All FHIR elements must have a @value or children
Slices for coding	S	2..*	CodingTW	由專門術語系統（terminology system）定義的代碼 Slice: Unordered, Open by pattern:$this ele-1: All FHIR elements must have a @value or children
coding:PulseOx	S	1..1	CodingTW	Oxygen saturation in Arterial blood by Pulse oximetry ele-1: All FHIR elements must have a @value or children Required Pattern: At least the following
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: 59408-5
coding:OxygenSatCode	S	1..1	CodingTW	Oxygen saturation in Arterial blood ele-1: All FHIR elements must have a @value or children Required Pattern: At least the following
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: 2708-6
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	S	0..1	CodeableConceptTW	缺少檢驗檢查結果的原因 Binding: DataAbsentReason (extensible): 代碼具體說明檢驗檢查結果缺少的原因；應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。 ele-1: All FHIR elements must have a @value or children
Slices for component	SΣC	0..*	BackboneElement	Used when reporting flow rates or oxygen concentration. Slice: Unordered, Open by pattern:code 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
component:All Slices				Content/Rules for all slices
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	S	0..1	CodeableConceptTW	為什麼缺少組成之檢驗檢查結果 Binding: DataAbsentReason (extensible): 代碼指明為什麼結果（Observation.value[x]）缺少；應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。 ele-1: All FHIR elements must have a @value or children
component:FlowRate	SΣC	0..1	BackboneElement	Inhaled oxygen flow rate 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 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: 3151-8
Slices for value[x]	SΣC	0..1		Vital Sign Value recorded with UCUM Slice: Unordered, Open by type:$this Binding: VitalSignsUnits (extensible): Common UCUM units for recording Vital Signs. ele-1: All FHIR elements must have a @value or children
valueQuantity			Quantity
value[x]:valueQuantity	SΣC	0..1	Quantity	Vital Sign Component Value Binding: VitalSignsUnits (extensible): Common UCUM units for recording Vital Signs. 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: L/min
dataAbsentReason	S	0..1	CodeableConceptTW	為什麼缺少組成之檢驗檢查結果 Binding: DataAbsentReason (extensible): 代碼指明為什麼結果（Observation.value[x]）缺少；應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。 ele-1: All FHIR elements must have a @value or children
component:Concentration	SΣC	0..1	BackboneElement	Inhaled oxygen concentration 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 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: 3150-0
Slices for value[x]	SΣC	0..1		Vital Sign Value recorded with UCUM Slice: Unordered, Open by type:$this Binding: VitalSignsUnits (extensible): Common UCUM units for recording Vital Signs. ele-1: All FHIR elements must have a @value or children
valueQuantity			Quantity
value[x]:valueQuantity	SΣC	0..1	Quantity	Vital Sign Component Value Binding: VitalSignsUnits (extensible): Common UCUM units for recording Vital Signs. 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	S	0..1	CodeableConceptTW	為什麼缺少組成之檢驗檢查結果 Binding: DataAbsentReason (extensible): 代碼指明為什麼結果（Observation.value[x]）缺少；應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。 ele-1: All FHIR elements must have a @value or children
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet / Code	URI
Observation.status	required	ObservationStatus `http://hl7.org/fhir/ValueSet/observation-status\|4.0.1` from the FHIR Standard
Observation.category	preferred	ObservationCategoryCodes `http://hl7.org/fhir/ValueSet/observation-category` from the FHIR Standard
Observation.category:VSCat	preferred	ObservationCategoryCodes `http://hl7.org/fhir/ValueSet/observation-category` from the FHIR Standard
Observation.code	extensible	TWVitalSigns `https://twcore.mohw.gov.tw/ig/twcore/ValueSet/vital-signs-tw` from this IG
Observation.value[x]	extensible	VitalSignsUnits `http://hl7.org/fhir/ValueSet/ucum-vitals-common` from the FHIR Standard
Observation.value[x]:valueQuantity	extensible	VitalSignsUnits `http://hl7.org/fhir/ValueSet/ucum-vitals-common` from the FHIR Standard
Observation.value[x]:valueQuantity.comparator	required	QuantityComparator `http://hl7.org/fhir/ValueSet/quantity-comparator\|4.0.1` from the FHIR Standard
Observation.dataAbsentReason	extensible	DataAbsentReason `http://hl7.org/fhir/ValueSet/data-absent-reason` from the FHIR Standard
Observation.component.code	extensible	TWVitalSigns `https://twcore.mohw.gov.tw/ig/twcore/ValueSet/vital-signs-tw` from this IG
Observation.component.value[x]	extensible	VitalSignsUnits `http://hl7.org/fhir/ValueSet/ucum-vitals-common\|4.0.1` from the FHIR Standard
Observation.component.dataAbsentReason	extensible	DataAbsentReason `http://hl7.org/fhir/ValueSet/data-absent-reason` from the FHIR Standard
Observation.component:FlowRate.code	extensible	Pattern: LOINC Code 3151-8 `https://twcore.mohw.gov.tw/ig/twcore/ValueSet/vital-signs-tw` from this IG
Observation.component:FlowRate.value[x]	extensible	VitalSignsUnits `http://hl7.org/fhir/ValueSet/ucum-vitals-common\|4.0.1` from the FHIR Standard
Observation.component:FlowRate.value[x]:valueQuantity	extensible	VitalSignsUnits `http://hl7.org/fhir/ValueSet/ucum-vitals-common\|4.0.1` from the FHIR Standard
Observation.component:FlowRate.value[x]:valueQuantity.comparator	required	QuantityComparator `http://hl7.org/fhir/ValueSet/quantity-comparator\|4.0.1` from the FHIR Standard
Observation.component:FlowRate.dataAbsentReason	extensible	DataAbsentReason `http://hl7.org/fhir/ValueSet/data-absent-reason` from the FHIR Standard
Observation.component:Concentration.code	extensible	Pattern: LOINC Code 3150-0 `https://twcore.mohw.gov.tw/ig/twcore/ValueSet/vital-signs-tw` from this IG
Observation.component:Concentration.value[x]	extensible	VitalSignsUnits `http://hl7.org/fhir/ValueSet/ucum-vitals-common\|4.0.1` from the FHIR Standard
Observation.component:Concentration.value[x]:valueQuantity	extensible	VitalSignsUnits `http://hl7.org/fhir/ValueSet/ucum-vitals-common\|4.0.1` from the FHIR Standard
Observation.component:Concentration.value[x]:valueQuantity.comparator	required	QuantityComparator `http://hl7.org/fhir/ValueSet/quantity-comparator\|4.0.1` from the FHIR Standard
Observation.component:Concentration.dataAbsentReason	extensible	DataAbsentReason `http://hl7.org/fhir/ValueSet/data-absent-reason` from the FHIR Standard

Constraints

Id	Grade	Path(s)	Details	Requirements
dom-2	error	Observation	If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty()
dom-3	error	Observation	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	Observation	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	Observation	If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty()
dom-6	best practice	Observation	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()
obs-6	error	Observation	dataAbsentReason SHALL only be present if Observation.value[x] is not present : dataAbsentReason.empty() or value.empty()
obs-7	error	Observation	If 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-1	error	Observation.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-2	error	Observation	If 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-3	error	Observation.component, Observation.component:FlowRate, Observation.component:Concentration	If there is no a value a data absent reason must be present : value.exists() or dataAbsentReason.exists()

Description & Constraints

Observation

0..*

TWCoreObservationVitalSigns

檢驗檢查，測量及簡單的判定。
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.

0..1

不重複的ID用以識別儲存在特定FHIR Server中的Observation紀錄，通常又稱為邏輯性ID。