臺灣核心實作指引(TW Core IG)
0.3.3 - 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.3 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/MOHW-TWCoreIG/cctwFHIRterm/ and changes regularly. See the Directory of published versions

Resource Profile: TW Core Specimen

Official URL: https://twcore.mohw.gov.tw/ig/twcore/StructureDefinition/Specimen-twcore Version: 0.3.3
Active as of 2025-11-21 Computable Name: TWCoreSpecimen

此臺灣核心-檢體(TW Core Specimen) Profile說明本IG如何進一步定義FHIR的Specimen Resource以呈現檢體的詳細資料。

Resource Specimen - 內容

用於分析的樣本。

範圍與使用

任何物質樣本:

  • 來自生物實體,無論是活著或死亡的
  • 來自實體物件或環境

有些檢體(Specimen)是生物性的,可能包含一個或多個組成部分,這些部分包括但不限於細胞分子、細胞、組織、器官、體液、胚胎以及身體排泄物(來源:NCI Thesaurus修改後)。

Specimen resource 涵蓋了用於診斷和環境檢測的物質。Specimen resource 的焦點(focus)在於檢體的採集、維護和處理過程,以及檢體的來源地。這與使用 Substance resource 的情況不同,只有在這些其他方面不適用時,才會使用 Substance。

背景

Specimen resource 的定義只包括關於檢體容器的基本資訊,但未涉及容器之間可能存在的層級關係,或是一個容器在其上級容器中位置的追蹤問題(例如:一個試管位於托盤中,該托盤又放在架子上,而架子則存放在冷凍櫃中)。這些資料項目被追蹤的頻率可能會根據使用情境有所不同,比如是在一般的實驗室中使用,還是在生物銀行等特定場合。

此 resource 被診斷報告 (DiagnosticReport)、影像檢查 (ImagingStudy)、多媒體 (Media)、分子序列 (MolecularSequence)、檢驗檢查 (Observation)、服務請求 (ServiceRequest)及檢體(Specimen)所參照。

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
.. Specimen 0..* Specimen 用於分析的檢體
... id Σ 0..1 id 不重複的ID用以識別儲存在特定FHIR Server中的Specimen紀錄,通常又稱為邏輯性ID。
... meta Σ 0..1 Meta 此Specimen Resource的metadata
... implicitRules ?!Σ 0..1 uri 創建此內容所依據的一組規則
... text 0..1 Narrative Specimen Resource之內容摘要以供人閱讀
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... identifier SΣ 0..* Identifier 檢體的外部識別碼
... accessionIdentifier Σ 0..1 Identifier 實驗室指定的識別碼
... status ?!Σ 0..1 code available | unavailable | unsatisfactory | entered-in-error
Binding: SpecimenStatus (required): 檢體的可取得性;應填入所綁定值集中的其中一個代碼。
... type SΣ 0..1 CodeableConceptTW 檢體的種類
Binding: hl7VS-specimenType (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
... subject SΣ 1..1 Reference(TW Core Patient | Group | Device | Substance | TW Core Location) 檢體取自哪邊?檢體的來源可能有幾種,它可能來自病人,來自某個地方(例如:從環境中取得的樣本),或者是對某種物質或設備的抽樣。
... receivedTime Σ 0..1 dateTime 收到此檢體進行處理的時間
... parent 0..* Reference(TW Core Specimen) 此檢體的來源檢體
... request 0..* Reference(TW Core ServiceRequest) 採集檢體的原因
... collection 0..1 BackboneElement 採集細節
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... collector Σ 0..1 Reference(TW Core Practitioner | TW Core PractitionerRole) 誰採集了檢體
.... collected[x] Σ 0..1 採集檢體的時間
..... collectedDateTime dateTime
..... collectedPeriod Period
.... duration Σ 0..1 Duration 採集檢體需要多長時間
.... quantity 0..1 SimpleQuantity(4.0.1) 採集檢體的數量
.... method 0..1 CodeableConceptTW 用於執行檢體採集的技術
Binding: FHIRSpecimenCollectionMethod (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
.... bodySite 0..1 CodeableConceptTW 解剖採集部位
Binding: SNOMEDCTBodyStructures (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
.... fastingStatus[x] Σ 0..1 病人是否禁食/禁飲料,或禁食/禁飲料多長時間
Binding: hl7VS-relevantClincialInformation (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
..... fastingStatusCodeableConcept CodeableConcept(CodeableConceptTW)
..... fastingStatusDuration Duration
... processing 0..* BackboneElement 處理和處理步驟細節
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... description 0..1 string 程序的文字描述
.... procedure 0..1 CodeableConceptTW 表明應用於檢體的處理步驟
Binding: SpecimenProcessingProcedure (example): 可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。
.... additive 0..* Reference(Substance) 處理步驟中使用的物質
.... time[x] 0..1 檢體處理的日期和時間
..... timeDateTime dateTime
..... timePeriod Period
... container 0..* BackboneElement 檢體的直接容器(試管/玻片等)
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... identifier Σ 0..* Identifier 容器的ID
.... description 0..1 string 容器的文字說明
.... type 0..1 CodeableConceptTW 與檢體直接相關的容器類型
Binding: SpecimenContainerType (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
.... capacity 0..1 SimpleQuantity(4.0.1) 容器的體積或大小
.... specimenQuantity 0..1 SimpleQuantity(4.0.1) 容器內的檢體量
.... Slices for additive[x] 0..1 與容器相關的添加劑
Slice: Unordered, Open by type:$this
Binding: hl7VS-additivePreservative (example): 可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。
..... additiveCodeableConcept CodeableConcept
..... additiveReference Reference(Substance)
..... additive[x]:additiveCodeableConcept 0..1 CodeableConceptTW Additive associated with container
Binding: hl7VS-additivePreservative (example): 可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。
... condition Σ 0..* CodeableConceptTW 檢體狀態
Binding: hl7VS-specimenCondition (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
... note 0..* Annotation 評論或意見

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Specimen.language Base preferred Common Languages 📦4.0.1 FHIR Std.
Specimen.status Base required SpecimenStatus 📍4.0.1 FHIR Std.
Specimen.type Base extensible hl7VS-specimenType 📦2.0.0 THO v7.0
Specimen.collection.​method Base extensible FHIR Specimen Collection Method 📦4.0.1 FHIR Std.
Specimen.collection.​bodySite Base extensible SNOMED CT Body Structures 📦4.0.1 FHIR Std.
Specimen.collection.​fastingStatus[x] Base extensible hl7VS-relevantClincialInformation 📦2.0.0 THO v7.0
Specimen.processing.​procedure Base example Specimen processing procedure 📦4.0.1 FHIR Std.
Specimen.container.type Base extensible Specimen Container Type 📦4.0.1 FHIR Std.
Specimen.container.additive[x] Base example hl7VS-additivePreservative 📦2.0.0 THO v7.0
Specimen.container.additive[x]:additiveCodeableConcept Base example hl7VS-additivePreservative 📦2.0.0 THO v7.0
Specimen.condition Base extensible hl7VS-specimenCondition 📦2.0.0 THO v7.0

Constraints

Id Grade Path(s) Description Expression
dom-2 error Specimen If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Specimen 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 Specimen 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 Specimen If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Specimen 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()

This structure is derived from Specimen

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Specimen 0..* Specimen 用於分析的檢體
... id 0..1 id 不重複的ID用以識別儲存在特定FHIR Server中的Specimen紀錄,通常又稱為邏輯性ID。
... meta 0..1 Meta 此Specimen Resource的metadata
... implicitRules 0..1 uri 創建此內容所依據的一組規則
... text 0..1 Narrative Specimen Resource之內容摘要以供人閱讀
... identifier S 0..* Identifier 檢體的外部識別碼
... accessionIdentifier 0..1 Identifier 實驗室指定的識別碼
... status 0..1 code available | unavailable | unsatisfactory | entered-in-error
Binding: SpecimenStatus (required): 檢體的可取得性;應填入所綁定值集中的其中一個代碼。
... type S 0..1 CodeableConceptTW 檢體的種類
Binding: hl7VS-specimenType (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
... subject S 1..1 Reference(TW Core Patient | Group | Device | Substance | TW Core Location) 檢體取自哪邊?檢體的來源可能有幾種,它可能來自病人,來自某個地方(例如:從環境中取得的樣本),或者是對某種物質或設備的抽樣。
... receivedTime 0..1 dateTime 收到此檢體進行處理的時間
... parent 0..* Reference(TW Core Specimen) 此檢體的來源檢體
... request 0..* Reference(TW Core ServiceRequest) 採集檢體的原因
... collection 0..1 BackboneElement 採集細節
.... collector 0..1 Reference(TW Core Practitioner | TW Core PractitionerRole) 誰採集了檢體
.... collected[x] 0..1 dateTime, Period 採集檢體的時間
.... duration 0..1 Duration 採集檢體需要多長時間
.... quantity 0..1 SimpleQuantity(4.0.1) 採集檢體的數量
.... method 0..1 CodeableConceptTW 用於執行檢體採集的技術
Binding: FHIRSpecimenCollectionMethod (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
.... bodySite 0..1 CodeableConceptTW 解剖採集部位
Binding: SNOMEDCTBodyStructures (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
.... fastingStatus[x] 0..1 病人是否禁食/禁飲料,或禁食/禁飲料多長時間
Binding: hl7VS-relevantClincialInformation (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
..... fastingStatusCodeableConcept CodeableConcept(CodeableConceptTW)
..... fastingStatusDuration Duration
... processing 0..* BackboneElement 處理和處理步驟細節
.... description 0..1 string 程序的文字描述
.... procedure 0..1 CodeableConceptTW 表明應用於檢體的處理步驟
Binding: SpecimenProcessingProcedure (example): 可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。
.... additive 0..* Reference(Substance) 處理步驟中使用的物質
.... time[x] 0..1 dateTime, Period 檢體處理的日期和時間
... container 0..* BackboneElement 檢體的直接容器(試管/玻片等)
.... identifier 0..* Identifier 容器的ID
.... description 0..1 string 容器的文字說明
.... type 0..1 CodeableConceptTW 與檢體直接相關的容器類型
Binding: SpecimenContainerType (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
.... capacity 0..1 SimpleQuantity(4.0.1) 容器的體積或大小
.... specimenQuantity 0..1 SimpleQuantity(4.0.1) 容器內的檢體量
.... Slices for additive[x] 0..1 CodeableConcept, Reference(Substance) 與容器相關的添加劑
Slice: Unordered, Open by type:$this
Binding: hl7VS-additivePreservative (example): 可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。
..... additive[x]:additiveCodeableConcept 0..1 CodeableConceptTW Additive associated with container
Binding: hl7VS-additivePreservative (example): 可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。
... condition 0..* CodeableConceptTW 檢體狀態
Binding: hl7VS-specimenCondition (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
... note 0..* Annotation 評論或意見

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
Specimen.language Base preferred Common Languages 📦4.0.1 FHIR Std.
Specimen.status Base required SpecimenStatus 📍4.0.1 FHIR Std.
Specimen.type Base extensible hl7VS-specimenType 📦2.0.0 THO v7.0
Specimen.collection.​method Base extensible FHIR Specimen Collection Method 📦4.0.1 FHIR Std.
Specimen.collection.​bodySite Base extensible SNOMED CT Body Structures 📦4.0.1 FHIR Std.
Specimen.collection.​fastingStatus[x] Base extensible hl7VS-relevantClincialInformation 📦2.0.0 THO v7.0
Specimen.processing.​procedure Base example Specimen processing procedure 📦4.0.1 FHIR Std.
Specimen.container.type Base extensible Specimen Container Type 📦4.0.1 FHIR Std.
Specimen.container.additive[x] Base example hl7VS-additivePreservative 📦2.0.0 THO v7.0
Specimen.container.additive[x]:additiveCodeableConcept Base example hl7VS-additivePreservative 📦2.0.0 THO v7.0
Specimen.condition Base extensible hl7VS-specimenCondition 📦2.0.0 THO v7.0
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Specimen 0..* Specimen 用於分析的檢體
... id Σ 0..1 id 不重複的ID用以識別儲存在特定FHIR Server中的Specimen紀錄,通常又稱為邏輯性ID。
... meta Σ 0..1 Meta 此Specimen Resource的metadata
... implicitRules ?!Σ 0..1 uri 創建此內容所依據的一組規則
... text 0..1 Narrative Specimen Resource之內容摘要以供人閱讀
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 SΣ 0..* Identifier 檢體的外部識別碼
... accessionIdentifier Σ 0..1 Identifier 實驗室指定的識別碼
... status ?!Σ 0..1 code available | unavailable | unsatisfactory | entered-in-error
Binding: SpecimenStatus (required): 檢體的可取得性;應填入所綁定值集中的其中一個代碼。
... type SΣ 0..1 CodeableConceptTW 檢體的種類
Binding: hl7VS-specimenType (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
... subject SΣ 1..1 Reference(TW Core Patient | Group | Device | Substance | TW Core Location) 檢體取自哪邊?檢體的來源可能有幾種,它可能來自病人,來自某個地方(例如:從環境中取得的樣本),或者是對某種物質或設備的抽樣。
... receivedTime Σ 0..1 dateTime 收到此檢體進行處理的時間
... parent 0..* Reference(TW Core Specimen) 此檢體的來源檢體
... request 0..* Reference(TW Core ServiceRequest) 採集檢體的原因
... collection 0..1 BackboneElement 採集細節
.... 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
.... collector Σ 0..1 Reference(TW Core Practitioner | TW Core PractitionerRole) 誰採集了檢體
.... collected[x] Σ 0..1 採集檢體的時間
..... collectedDateTime dateTime
..... collectedPeriod Period
.... duration Σ 0..1 Duration 採集檢體需要多長時間
.... quantity 0..1 SimpleQuantity(4.0.1) 採集檢體的數量
.... method 0..1 CodeableConceptTW 用於執行檢體採集的技術
Binding: FHIRSpecimenCollectionMethod (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
.... bodySite 0..1 CodeableConceptTW 解剖採集部位
Binding: SNOMEDCTBodyStructures (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
.... fastingStatus[x] Σ 0..1 病人是否禁食/禁飲料,或禁食/禁飲料多長時間
Binding: hl7VS-relevantClincialInformation (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
..... fastingStatusCodeableConcept CodeableConcept(CodeableConceptTW)
..... fastingStatusDuration Duration
... processing 0..* BackboneElement 處理和處理步驟細節
.... 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
.... description 0..1 string 程序的文字描述
.... procedure 0..1 CodeableConceptTW 表明應用於檢體的處理步驟
Binding: SpecimenProcessingProcedure (example): 可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。
.... additive 0..* Reference(Substance) 處理步驟中使用的物質
.... time[x] 0..1 檢體處理的日期和時間
..... timeDateTime dateTime
..... timePeriod Period
... container 0..* BackboneElement 檢體的直接容器(試管/玻片等)
.... 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
.... identifier Σ 0..* Identifier 容器的ID
.... description 0..1 string 容器的文字說明
.... type 0..1 CodeableConceptTW 與檢體直接相關的容器類型
Binding: SpecimenContainerType (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
.... capacity 0..1 SimpleQuantity(4.0.1) 容器的體積或大小
.... specimenQuantity 0..1 SimpleQuantity(4.0.1) 容器內的檢體量
.... Slices for additive[x] 0..1 與容器相關的添加劑
Slice: Unordered, Open by type:$this
Binding: hl7VS-additivePreservative (example): 可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。
..... additiveCodeableConcept CodeableConcept
..... additiveReference Reference(Substance)
..... additive[x]:additiveCodeableConcept 0..1 CodeableConceptTW Additive associated with container
Binding: hl7VS-additivePreservative (example): 可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。
... condition Σ 0..* CodeableConceptTW 檢體狀態
Binding: hl7VS-specimenCondition (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
... note 0..* Annotation 評論或意見

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Specimen.language Base preferred Common Languages 📦4.0.1 FHIR Std.
Specimen.status Base required SpecimenStatus 📍4.0.1 FHIR Std.
Specimen.type Base extensible hl7VS-specimenType 📦2.0.0 THO v7.0
Specimen.collection.​method Base extensible FHIR Specimen Collection Method 📦4.0.1 FHIR Std.
Specimen.collection.​bodySite Base extensible SNOMED CT Body Structures 📦4.0.1 FHIR Std.
Specimen.collection.​fastingStatus[x] Base extensible hl7VS-relevantClincialInformation 📦2.0.0 THO v7.0
Specimen.processing.​procedure Base example Specimen processing procedure 📦4.0.1 FHIR Std.
Specimen.container.type Base extensible Specimen Container Type 📦4.0.1 FHIR Std.
Specimen.container.additive[x] Base example hl7VS-additivePreservative 📦2.0.0 THO v7.0
Specimen.container.additive[x]:additiveCodeableConcept Base example hl7VS-additivePreservative 📦2.0.0 THO v7.0
Specimen.condition Base extensible hl7VS-specimenCondition 📦2.0.0 THO v7.0

Constraints

Id Grade Path(s) Description Expression
dom-2 error Specimen If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Specimen 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 Specimen 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 Specimen If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Specimen 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()

Key Elements View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Specimen 0..* Specimen 用於分析的檢體
... id Σ 0..1 id 不重複的ID用以識別儲存在特定FHIR Server中的Specimen紀錄,通常又稱為邏輯性ID。
... meta Σ 0..1 Meta 此Specimen Resource的metadata
... implicitRules ?!Σ 0..1 uri 創建此內容所依據的一組規則
... text 0..1 Narrative Specimen Resource之內容摘要以供人閱讀
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... identifier SΣ 0..* Identifier 檢體的外部識別碼
... accessionIdentifier Σ 0..1 Identifier 實驗室指定的識別碼
... status ?!Σ 0..1 code available | unavailable | unsatisfactory | entered-in-error
Binding: SpecimenStatus (required): 檢體的可取得性;應填入所綁定值集中的其中一個代碼。
... type SΣ 0..1 CodeableConceptTW 檢體的種類
Binding: hl7VS-specimenType (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
... subject SΣ 1..1 Reference(TW Core Patient | Group | Device | Substance | TW Core Location) 檢體取自哪邊?檢體的來源可能有幾種,它可能來自病人,來自某個地方(例如:從環境中取得的樣本),或者是對某種物質或設備的抽樣。
... receivedTime Σ 0..1 dateTime 收到此檢體進行處理的時間
... parent 0..* Reference(TW Core Specimen) 此檢體的來源檢體
... request 0..* Reference(TW Core ServiceRequest) 採集檢體的原因
... collection 0..1 BackboneElement 採集細節
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... collector Σ 0..1 Reference(TW Core Practitioner | TW Core PractitionerRole) 誰採集了檢體
.... collected[x] Σ 0..1 採集檢體的時間
..... collectedDateTime dateTime
..... collectedPeriod Period
.... duration Σ 0..1 Duration 採集檢體需要多長時間
.... quantity 0..1 SimpleQuantity(4.0.1) 採集檢體的數量
.... method 0..1 CodeableConceptTW 用於執行檢體採集的技術
Binding: FHIRSpecimenCollectionMethod (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
.... bodySite 0..1 CodeableConceptTW 解剖採集部位
Binding: SNOMEDCTBodyStructures (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
.... fastingStatus[x] Σ 0..1 病人是否禁食/禁飲料,或禁食/禁飲料多長時間
Binding: hl7VS-relevantClincialInformation (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
..... fastingStatusCodeableConcept CodeableConcept(CodeableConceptTW)
..... fastingStatusDuration Duration
... processing 0..* BackboneElement 處理和處理步驟細節
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... description 0..1 string 程序的文字描述
.... procedure 0..1 CodeableConceptTW 表明應用於檢體的處理步驟
Binding: SpecimenProcessingProcedure (example): 可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。
.... additive 0..* Reference(Substance) 處理步驟中使用的物質
.... time[x] 0..1 檢體處理的日期和時間
..... timeDateTime dateTime
..... timePeriod Period
... container 0..* BackboneElement 檢體的直接容器(試管/玻片等)
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... identifier Σ 0..* Identifier 容器的ID
.... description 0..1 string 容器的文字說明
.... type 0..1 CodeableConceptTW 與檢體直接相關的容器類型
Binding: SpecimenContainerType (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
.... capacity 0..1 SimpleQuantity(4.0.1) 容器的體積或大小
.... specimenQuantity 0..1 SimpleQuantity(4.0.1) 容器內的檢體量
.... Slices for additive[x] 0..1 與容器相關的添加劑
Slice: Unordered, Open by type:$this
Binding: hl7VS-additivePreservative (example): 可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。
..... additiveCodeableConcept CodeableConcept
..... additiveReference Reference(Substance)
..... additive[x]:additiveCodeableConcept 0..1 CodeableConceptTW Additive associated with container
Binding: hl7VS-additivePreservative (example): 可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。
... condition Σ 0..* CodeableConceptTW 檢體狀態
Binding: hl7VS-specimenCondition (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
... note 0..* Annotation 評論或意見

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Specimen.language Base preferred Common Languages 📦4.0.1 FHIR Std.
Specimen.status Base required SpecimenStatus 📍4.0.1 FHIR Std.
Specimen.type Base extensible hl7VS-specimenType 📦2.0.0 THO v7.0
Specimen.collection.​method Base extensible FHIR Specimen Collection Method 📦4.0.1 FHIR Std.
Specimen.collection.​bodySite Base extensible SNOMED CT Body Structures 📦4.0.1 FHIR Std.
Specimen.collection.​fastingStatus[x] Base extensible hl7VS-relevantClincialInformation 📦2.0.0 THO v7.0
Specimen.processing.​procedure Base example Specimen processing procedure 📦4.0.1 FHIR Std.
Specimen.container.type Base extensible Specimen Container Type 📦4.0.1 FHIR Std.
Specimen.container.additive[x] Base example hl7VS-additivePreservative 📦2.0.0 THO v7.0
Specimen.container.additive[x]:additiveCodeableConcept Base example hl7VS-additivePreservative 📦2.0.0 THO v7.0
Specimen.condition Base extensible hl7VS-specimenCondition 📦2.0.0 THO v7.0

Constraints

Id Grade Path(s) Description Expression
dom-2 error Specimen If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Specimen 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 Specimen 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 Specimen If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Specimen 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()

Differential View

This structure is derived from Specimen

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Specimen 0..* Specimen 用於分析的檢體
... id 0..1 id 不重複的ID用以識別儲存在特定FHIR Server中的Specimen紀錄,通常又稱為邏輯性ID。
... meta 0..1 Meta 此Specimen Resource的metadata
... implicitRules 0..1 uri 創建此內容所依據的一組規則
... text 0..1 Narrative Specimen Resource之內容摘要以供人閱讀
... identifier S 0..* Identifier 檢體的外部識別碼
... accessionIdentifier 0..1 Identifier 實驗室指定的識別碼
... status 0..1 code available | unavailable | unsatisfactory | entered-in-error
Binding: SpecimenStatus (required): 檢體的可取得性;應填入所綁定值集中的其中一個代碼。
... type S 0..1 CodeableConceptTW 檢體的種類
Binding: hl7VS-specimenType (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
... subject S 1..1 Reference(TW Core Patient | Group | Device | Substance | TW Core Location) 檢體取自哪邊?檢體的來源可能有幾種,它可能來自病人,來自某個地方(例如:從環境中取得的樣本),或者是對某種物質或設備的抽樣。
... receivedTime 0..1 dateTime 收到此檢體進行處理的時間
... parent 0..* Reference(TW Core Specimen) 此檢體的來源檢體
... request 0..* Reference(TW Core ServiceRequest) 採集檢體的原因
... collection 0..1 BackboneElement 採集細節
.... collector 0..1 Reference(TW Core Practitioner | TW Core PractitionerRole) 誰採集了檢體
.... collected[x] 0..1 dateTime, Period 採集檢體的時間
.... duration 0..1 Duration 採集檢體需要多長時間
.... quantity 0..1 SimpleQuantity(4.0.1) 採集檢體的數量
.... method 0..1 CodeableConceptTW 用於執行檢體採集的技術
Binding: FHIRSpecimenCollectionMethod (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
.... bodySite 0..1 CodeableConceptTW 解剖採集部位
Binding: SNOMEDCTBodyStructures (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
.... fastingStatus[x] 0..1 病人是否禁食/禁飲料,或禁食/禁飲料多長時間
Binding: hl7VS-relevantClincialInformation (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
..... fastingStatusCodeableConcept CodeableConcept(CodeableConceptTW)
..... fastingStatusDuration Duration
... processing 0..* BackboneElement 處理和處理步驟細節
.... description 0..1 string 程序的文字描述
.... procedure 0..1 CodeableConceptTW 表明應用於檢體的處理步驟
Binding: SpecimenProcessingProcedure (example): 可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。
.... additive 0..* Reference(Substance) 處理步驟中使用的物質
.... time[x] 0..1 dateTime, Period 檢體處理的日期和時間
... container 0..* BackboneElement 檢體的直接容器(試管/玻片等)
.... identifier 0..* Identifier 容器的ID
.... description 0..1 string 容器的文字說明
.... type 0..1 CodeableConceptTW 與檢體直接相關的容器類型
Binding: SpecimenContainerType (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
.... capacity 0..1 SimpleQuantity(4.0.1) 容器的體積或大小
.... specimenQuantity 0..1 SimpleQuantity(4.0.1) 容器內的檢體量
.... Slices for additive[x] 0..1 CodeableConcept, Reference(Substance) 與容器相關的添加劑
Slice: Unordered, Open by type:$this
Binding: hl7VS-additivePreservative (example): 可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。
..... additive[x]:additiveCodeableConcept 0..1 CodeableConceptTW Additive associated with container
Binding: hl7VS-additivePreservative (example): 可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。
... condition 0..* CodeableConceptTW 檢體狀態
Binding: hl7VS-specimenCondition (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
... note 0..* Annotation 評論或意見

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
Specimen.language Base preferred Common Languages 📦4.0.1 FHIR Std.
Specimen.status Base required SpecimenStatus 📍4.0.1 FHIR Std.
Specimen.type Base extensible hl7VS-specimenType 📦2.0.0 THO v7.0
Specimen.collection.​method Base extensible FHIR Specimen Collection Method 📦4.0.1 FHIR Std.
Specimen.collection.​bodySite Base extensible SNOMED CT Body Structures 📦4.0.1 FHIR Std.
Specimen.collection.​fastingStatus[x] Base extensible hl7VS-relevantClincialInformation 📦2.0.0 THO v7.0
Specimen.processing.​procedure Base example Specimen processing procedure 📦4.0.1 FHIR Std.
Specimen.container.type Base extensible Specimen Container Type 📦4.0.1 FHIR Std.
Specimen.container.additive[x] Base example hl7VS-additivePreservative 📦2.0.0 THO v7.0
Specimen.container.additive[x]:additiveCodeableConcept Base example hl7VS-additivePreservative 📦2.0.0 THO v7.0
Specimen.condition Base extensible hl7VS-specimenCondition 📦2.0.0 THO v7.0

Snapshot View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Specimen 0..* Specimen 用於分析的檢體
... id Σ 0..1 id 不重複的ID用以識別儲存在特定FHIR Server中的Specimen紀錄,通常又稱為邏輯性ID。
... meta Σ 0..1 Meta 此Specimen Resource的metadata
... implicitRules ?!Σ 0..1 uri 創建此內容所依據的一組規則
... text 0..1 Narrative Specimen Resource之內容摘要以供人閱讀
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 SΣ 0..* Identifier 檢體的外部識別碼
... accessionIdentifier Σ 0..1 Identifier 實驗室指定的識別碼
... status ?!Σ 0..1 code available | unavailable | unsatisfactory | entered-in-error
Binding: SpecimenStatus (required): 檢體的可取得性;應填入所綁定值集中的其中一個代碼。
... type SΣ 0..1 CodeableConceptTW 檢體的種類
Binding: hl7VS-specimenType (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
... subject SΣ 1..1 Reference(TW Core Patient | Group | Device | Substance | TW Core Location) 檢體取自哪邊?檢體的來源可能有幾種,它可能來自病人,來自某個地方(例如:從環境中取得的樣本),或者是對某種物質或設備的抽樣。
... receivedTime Σ 0..1 dateTime 收到此檢體進行處理的時間
... parent 0..* Reference(TW Core Specimen) 此檢體的來源檢體
... request 0..* Reference(TW Core ServiceRequest) 採集檢體的原因
... collection 0..1 BackboneElement 採集細節
.... 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
.... collector Σ 0..1 Reference(TW Core Practitioner | TW Core PractitionerRole) 誰採集了檢體
.... collected[x] Σ 0..1 採集檢體的時間
..... collectedDateTime dateTime
..... collectedPeriod Period
.... duration Σ 0..1 Duration 採集檢體需要多長時間
.... quantity 0..1 SimpleQuantity(4.0.1) 採集檢體的數量
.... method 0..1 CodeableConceptTW 用於執行檢體採集的技術
Binding: FHIRSpecimenCollectionMethod (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
.... bodySite 0..1 CodeableConceptTW 解剖採集部位
Binding: SNOMEDCTBodyStructures (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
.... fastingStatus[x] Σ 0..1 病人是否禁食/禁飲料,或禁食/禁飲料多長時間
Binding: hl7VS-relevantClincialInformation (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
..... fastingStatusCodeableConcept CodeableConcept(CodeableConceptTW)
..... fastingStatusDuration Duration
... processing 0..* BackboneElement 處理和處理步驟細節
.... 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
.... description 0..1 string 程序的文字描述
.... procedure 0..1 CodeableConceptTW 表明應用於檢體的處理步驟
Binding: SpecimenProcessingProcedure (example): 可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。
.... additive 0..* Reference(Substance) 處理步驟中使用的物質
.... time[x] 0..1 檢體處理的日期和時間
..... timeDateTime dateTime
..... timePeriod Period
... container 0..* BackboneElement 檢體的直接容器(試管/玻片等)
.... 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
.... identifier Σ 0..* Identifier 容器的ID
.... description 0..1 string 容器的文字說明
.... type 0..1 CodeableConceptTW 與檢體直接相關的容器類型
Binding: SpecimenContainerType (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
.... capacity 0..1 SimpleQuantity(4.0.1) 容器的體積或大小
.... specimenQuantity 0..1 SimpleQuantity(4.0.1) 容器內的檢體量
.... Slices for additive[x] 0..1 與容器相關的添加劑
Slice: Unordered, Open by type:$this
Binding: hl7VS-additivePreservative (example): 可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。
..... additiveCodeableConcept CodeableConcept
..... additiveReference Reference(Substance)
..... additive[x]:additiveCodeableConcept 0..1 CodeableConceptTW Additive associated with container
Binding: hl7VS-additivePreservative (example): 可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。
... condition Σ 0..* CodeableConceptTW 檢體狀態
Binding: hl7VS-specimenCondition (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
... note 0..* Annotation 評論或意見

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Specimen.language Base preferred Common Languages 📦4.0.1 FHIR Std.
Specimen.status Base required SpecimenStatus 📍4.0.1 FHIR Std.
Specimen.type Base extensible hl7VS-specimenType 📦2.0.0 THO v7.0
Specimen.collection.​method Base extensible FHIR Specimen Collection Method 📦4.0.1 FHIR Std.
Specimen.collection.​bodySite Base extensible SNOMED CT Body Structures 📦4.0.1 FHIR Std.
Specimen.collection.​fastingStatus[x] Base extensible hl7VS-relevantClincialInformation 📦2.0.0 THO v7.0
Specimen.processing.​procedure Base example Specimen processing procedure 📦4.0.1 FHIR Std.
Specimen.container.type Base extensible Specimen Container Type 📦4.0.1 FHIR Std.
Specimen.container.additive[x] Base example hl7VS-additivePreservative 📦2.0.0 THO v7.0
Specimen.container.additive[x]:additiveCodeableConcept Base example hl7VS-additivePreservative 📦2.0.0 THO v7.0
Specimen.condition Base extensible hl7VS-specimenCondition 📦2.0.0 THO v7.0

Constraints

Id Grade Path(s) Description Expression
dom-2 error Specimen If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Specimen 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 Specimen 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 Specimen If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Specimen 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()

 

Other representations of profile: CSV, Excel, Schematron

Notes:

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

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

  1. 建議應該(SHOULD) 支援透過查詢參數 _id 查詢所有Specimen:
    (如何透過token查詢)
    GET [base]/Specimen?_id=[id]
    GET [base]/Specimen/[id]

    例子:
    (1) GET [base]/Specimen?_id=spe-blood-example
    (2) GET [base]/Specimen/spe-blood-example

  2. 建議應該(SHOULD) 支援透過查詢參數 status 查詢所有Specimen:
    (如何透過token查詢)
    GET [base]/Specimen?status=[code]

    例子:
    (1) GET [base]/Specimen?status=available

  3. 建議應該(SHOULD) 支援透過查詢參數 identifier 查詢所有Specimen:
    (如何透過token查詢)
    GET [base]/Specimen?identifier={system|}[code]

    例子:
    (1) GET [base]/Specimen?identifier=https://www.tph.mohw.gov.tw|1a3f5b7d-9e2c-4f6a-8c1e-0b2d4e6f8a9c

  4. 建議應該(SHOULD) 支援透過查詢參數 subject 查詢所有Specimen:
    (如何透過reference查詢)
    GET [base]/Specimen?subject={Type/}[id]

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