Resource Composition - 內容

一組醫療相關資訊會被整合成一個單一邏輯套件（package），這個套件提供了一個連貫的意義表達，並確立了它自己的上下文。它包含了臨床上的證明，明確指出是誰做出這些陳述。Composition定義了一份文件所需的結構和敘述內容。但是單一個Composition本身並不構成一份完整的文件。反之，Composition必須是在Bundle中的第一個條目，且該Bundle.type必須是document。此外，從Composition參照的任何其他resources都必須作為後續條目包含在該Bundle中（例如：病人（Patient）、健康照護服務提供者（Practitioner）、就醫紀錄（Encounter）等）。

範圍與使用

Composition是FHIR文件（documents.html）的基本結構，這些文件是不可更改的bundle，包含經過認證的敘述。一個單一的邏輯Composition可能與一系列衍生文件相關聯，每一份衍生文件都是該Composition的一個固定副本。 例如：想像您是一位醫生，正在使用一個電子健康紀錄（Electronic Health Record）系統。您為一位病人創建了一份初診報告，這份報告就是使用Composition為報告結構。它包括病人的基本資訊、症狀、初步診斷和治療計劃，當這份報告完成並保存後，它就成為Composition的一個「固定副本」，即不可更改的文件。隨後，每當這位病人回診，您都會基於最初的那份報告來創建新的隨訪記錄。這些隨訪記錄也是Composition的衍生文件，每份都是Composition獨立且不可更改的固定副本。它們可能包括更新的診斷、治療反應和新的治療計劃。

因此，「每一份都是該Composition的固定版本」在這個醫療場景中意味著，無論是原始的初診報告還是基於它創建的任何隨訪記錄，都是獨立且不可更改的文件，保留了創建時的準確資訊。

需要注意的是，Composition在EN13606及FHIR這兩項醫療資訊標準中的概念不完全相同。EN 13606中「Composition」這一專門術語是用來指一次對EHR系統的提交，常見的例子包括包含諮詢記錄、進程紀錄、報告或信件、調查報告、處方單或一組床邊護理觀察紀錄的Composition。在EHR中使用Composition作為經過認證的提交是Composition resource的有效應用。但在FHIR中，通常會進行更細微的更新，並為每次更新提供來源聲明。

臨床文件 Profile（Clinical Document profile）對Composition作進一步定義，使其專門用於指定臨床文件（以符合CDA格式）。關於與CDA的比較，也有進一步的資訊可供參考。

界限與關聯

Composition 是用於將資訊分組的結構，這種結構主要用於資訊的持久保存和可證明性。在 FHIR 中，除了 Composition 外，還有其他幾種用於不同目的的分組結構：

• List resource 主要用於列舉一系列平行結構的 resources，並為管理這些 resources 集合提供功能。一個特定的 List instance 可能代表一個瞬間的「快照（snapshot）」，但從業務流程的角度來看，List 是動態變化會隨時間的推移，會不斷有項目被添加或移除。List resource 會參照其他的 resources。List 可以被精心策劃，並具有特定的業務含義。
• Group resource 在 FHIR 中用於確定一組特定的人群、動物、設備等。這種確定可以是透過直接列出它們，或者描述這些組成成員共有的特質來完成。Group resource 可能會間接地關聯到其他的 resources。Group 的設計初衷是作為一個整體來進行操作或監測，例如：對整個群體進行治療、計算群體的風險等。這個 resource 常用於公共衛生（比如描述一個高風險人群）、臨床試驗（例如確定一組試驗對象）以及其他類似的用途。
• Bundle resource 是 FHIR 中的一種基礎架構容器，用於封裝一組 resources。它不包含敘事性質的內容，而是用於對 resources 進行分組，以便於傳送、保存或處理。這些處理包括訊息傳遞（messages）、文件管理（documents）、異動處理（transactions）、查詢回應（query responses）等。Bundle 中的內容一般是基於特定交換或保存需求，透過演算法自動決定的。
• Composition resource 在 FHIR 中的作用是將一組與健康照護相關的資訊整合成一份單一的邏輯文件。這份文件不僅提供了完整且一致的意義表述，而且還設置了自己的上下文環境，並包含了關於聲明者的臨床認證資訊。Composition resource 是構成 FHIR 文件（document）基本架構的核心部分。為了表達文件的完整內容，會使用一個 Bundle resource，這個 Bundle 包括了 Composition 本身和與該 Composition 相關聯的各個 resource 的條目（entry）。

Composition resource 在 FHIR 中用於將臨床和行政內容組織成多個小節。每個小節都包含敘事內容，並參照其他 resources 來提供支持數據。在 Composition 的不同小節中，敘事內容得到了小節條目中參照的 resources 的支持。為了形成完整的文件，需要將 Composition resource 與直接或間接關聯到 Composition 的各種 resources 結合起來，並將它們全部匯集到一個 Bundle 中，以便於傳輸和保存。與以下 Composition 參照相關的 resources 必須(SHALL) 包含在這個 Bundle 中。

• Composition.subject（文件描述之對象，通常指病人）
• Composition.encounter （就醫事件，通常指此文件所記錄的就醫事實之依據）
• Composition.author （作者，撰寫此份文件者）
• Composition.attester.party （證明文件正確無誤的參與者，或稱認證者）
• Composition.custodian （文件保管機構）
• Composition.event.detail（文件描述事件之細節）
• Composition.section.author （文件小節之作者）
• Composition.section.focus （文件小節之焦點）
• Composition.section.entry （文件小節之條目）

當 FHIR 中的 Composition 參照其他 resources 時，這些被參照的 resources 是否包含在 Bundle 中，取決於創建這些 resources 的系統。這種決策會在該系統的操作定義中進行記載（例如：透過 $document 操作來說明），或者會依照適用的 profiles 進行具體規定。 簡言之，是否將這些額外的 resources 包括在 Bundle 中，是由創建它的系統根據自己的規則和標準來決定的。FHIR並未規定Bundle是否一定要包含或者一定不要包含這些相關聯的 resources。

背景

Composition狀態代碼（Status Codes）

每個 Composition 都包含一個資料項目稱為「狀態（status）」，它用來描述 Composition 內容的當前狀態，這個狀態是從一系列特定的代碼中選擇的。

Composition的工作流程或臨床狀態

Composition 狀態通常只會按照以下順序變化：從 preliminary 變為 final ，然後可能進一步變為 amended。值得注意的是，在許多工作流程中，只有 final 狀態的 compositions 被公開使用，而 preliminary 狀態則不會被使用。

在工作流程中，有極少數的 Composition 是完全錯誤地創建的，通常是涉及錯誤的病人或錯誤的作者所寫，而這個錯誤在 Composition 已經被使用或已從中衍生出文件後才被發現。為了解決這類情況，會將錯誤的 Composition 更新為「entered-in-error」狀態，並可以創建一份新的衍生文件。這表示基於該 Composition 衍生出的所有文件系列都被認為是錯誤創建的。因此，那些接收這些基於已撤回 Composition 衍生的文件的系統應從常規使用中移除之前文件的資料，或採取其他適合行動。雖然系統不必強制提供這種工作流程或支持從已撤回的 Composition 衍生的文件，但它們絕不能忽視「entered-in-error」的狀態。需要注意的是，那些處理 Composition 或衍生文件但不支援錯誤狀態處理的系統，需要找到其他方法來處理錯誤創建的 Composition；即使這不常見，但有些臨床系統沒有辦法從病人紀錄中移除錯誤資訊，用戶也無法知道這些資訊不適用，這是不安全的。

針對熟悉 CDA 的讀者的注意事項

很多使用這個規範的用戶都對臨床文件架構（Clinical Document Architecture，簡稱 CDA）及其相關的規範有所了解。CDA 是構成 Composition resource 的一個重要設計來源，除此之外，還包括其他 HL7 的文件規範和 EN13606。在 CDA 和 Composition resource 這兩者之間，存在著三個主要的結構上的不同。

• Composition是一個邏輯架構，它的識別碼（identifier）對應於CDA ClinicalDocument的setId。Composition resource 被封裝在Document結構中，用於交換整個套件（包括Composition及其各部分）。這個被封裝和密封的單位相當於CDA文件，其中Bundle的id在功能上相似於ClinicalDocument的id，但在將 Composition 轉換為CDA文件或反轉過程中，這兩個不會完全對應，因為這涉及到格式間的轉換）。
• Composition的小節定義了文件的一部分（或子小節）。但不同於CDA，這裡的小節條目實際上是對其他resources的參照，這些 resource 保存了支持該小節的資料內容，這種設計意味著這些資料可以以許多其他方式被重用。
• CDA中定義的上層資訊自動適用於其文件中的所有部分，其屬上下文流程模型（context flow model）；但不同於CDA，在 Composition 中定義的上下文（例如保密級別、文件對象、作者、事件、事件時間和就醫事件）只適用於Composition本身，並不直接適用於從section.entry參照的其他 resources 。FHIR中沒有一個上下文流動的模型，所以從 Composition 中參照的每一個 resource 都會表達它自己的特定上下文。因此，臨床內容可以安全地從 Composition 中分離出來。

另外需要注意的是，代碼列表（例如 Composition.status ）和 Composition resource 本身都被對應到HL7 v3和/或CDA標準。這意味著Composition中使用的特定標準資料項目和值，如其狀態代碼，已經適配於這些更廣泛應用的健康資訊標準中。這種映射確保了不同系統和框架間的相容性和可互操作性。

此外，Composition resource 不僅僅參照自身，還被Contract和Procedure等其他FHIR resources 所參照。在FHIR架構中，這種互相參照的設計使得資料項目和資料結構能夠在不同的臨床和行政場景中被重複使用，增強了資料的連接性和一致性。例如：一個特定的 Composition 可能與某個特定的醫療處置或合約直接相關，從而使得這些相關 resources 的關聯和管理變得更加清晰和有序。

• Differential Table
• Key Elements Table
• Snapshot Table
• Statistics/References
• All

This structure is derived from Composition

Name	Flags	Card.	Type	Description & Constraints
Composition		0..*	Composition	將一組resources組成一份連貫的臨床聲明，並附有臨床證明。
id		0..1	id	不重複的ID用以識別儲存在特定FHIR Server中的Composition紀錄，通常又稱為邏輯性ID。
meta		0..1	Meta	此Composition Resource的metadata
implicitRules		0..1	uri	創建此內容所依據的一組規則
language		0..1	code	用以表述Composition Resource內容的語言 Binding: CommonLanguages (preferred): 人類語言；鼓勵使用所綁定值集中的代碼，但不強制一定要使用此值集，你也可使用其他值集的代碼或單純以文字表示。 Additional Bindings Purpose AllLanguages Max Binding Example Value: zh-TW
text		0..1	Narrative	Composition Resource之內容摘要以供人閱讀
contained		0..*	Resource	內嵌的(contained)、行內的Resources
extension		0..*	Extension	擴充的資料項目
modifierExtension		0..*	Extension	此擴充的資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。
identifier	S	0..1	Identifier	不分版本的臨床文件架構(Composition)識別碼。
status	S	1..1	code	registered | partial | preliminary | final | amended | corrected + Binding: CompositionStatus (required): Composition的工作流程/臨床狀態；應填入所綁定值集中的其中一個代碼。
type	S	1..1	CodeableConceptTW	Composition的種類（如果可能請使用LOINC） Binding: FHIRDocumentTypeCodes (extensible): 應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
category		0..*	CodeableConceptTW	Composition的分類 Binding: DocumentClassValueSet (extensible): 應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
subject	S	0..1	Reference(TW Core Patient | Group | Device | Substance | TW Core Location)	Composition是關於誰和/或什麼
encounter		0..1	Reference(TW Core Encounter)	Composition的情境
date	S	1..1	dateTime	Composition的編輯時間
author	S	1..*	Reference(TW Core Practitioner | TW Core PractitionerRole | TW Core Organization | TW Core Patient | Device | RelatedPerson)	誰和/或什麼創建了這個Composition
title	S	1..1	string	人類可讀的名稱/標題
confidentiality		0..1	code	根據特定技術領域的定義 Binding: v3.ConfidentialityClassification (2014-03-26) (required): 應填入所綁定值集中的其中一個代碼。
attester	S	0..*	BackboneElement	證明Composition的準確性
id		0..1	string	唯一可識別ID，以供資料項目間相互參照。
extension		0..*	Extension	擴充的資料項目
modifierExtension		0..*	Extension	此擴充的資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。
mode		1..1	code	personal | professional | legal | official Binding: CompositionAttestationMode (required): 認證者提供的認證類型；應填入所綁定值集中的其中一個代碼。
time		0..1	dateTime	此Composition被證明的時間
party		0..1	Reference(TW Core Patient | RelatedPerson | TW Core Practitioner | TW Core PractitionerRole | TW Core Organization)	誰證明了此Composition
custodian	S	0..1	Reference(TW Core Organization)	維護Composition的機構
relatesTo		0..*	BackboneElement	與其他Composition/文件之間的關係
id		0..1	string	唯一可識別ID，以供資料項目間相互參照。
extension		0..*	Extension	擴充的資料項目
modifierExtension		0..*	Extension	此擴充的資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。
code		1..1	code	replaces | transforms | signs | appends Binding: DocumentRelationshipType (required): 檔案之間的關係型別；應填入所綁定值集中的其中一個代碼。
target[x]		1..1	Identifier, Reference(Composition)	此關係的目標文件
event		0..*	BackboneElement	正在記錄的臨床服務
id		0..1	string	唯一可識別ID，以供資料項目間相互參照。
extension		0..*	Extension	擴充的資料項目
modifierExtension		0..*	Extension	此擴充的資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。
code		0..*	CodeableConceptTW	此代碼表代表了正在被記錄的主要臨床行為 Binding: v3 Code System ActCode (example): 可參考所綁定值集，但此值集只是針對這個欄位的一個可能值的範例，不預期也不鼓勵使用者一定要使用此值集的代碼。
period		0..1	Period	文件所涵蓋的時間區間
detail		0..*	Reference(Resource)	在描述被記錄下來的事件，這些事件可以是以代碼的形式、參考資料的形式，或者兩者都有的形式來呈現。
section	S	0..*	BackboneElement	Composition被分成一個或數個小節
id		0..1	string	唯一可識別ID，以供資料項目間相互參照。
extension		0..*	Extension	擴充的資料項目
modifierExtension		0..*	Extension	此擴充的資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。
title		0..1	string	小節標籤(例如：目錄ToC)
code	S	0..1	CodeableConceptTW	小節分類(建議) Binding: DocumentSectionCodes (extensible): 應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
author		0..*	Reference(TW Core Practitioner | TW Core PractitionerRole | TW Core Organization | TW Core Patient | Device | RelatedPerson)	誰和/或什麼人撰寫了該小節
focus		0..1	Reference(Resource)	當小節與composition描述的對象無關時，此小節是關於誰/什麼。
text	S	0..1	Narrative	將文件中特定小節的內容簡化成容易理解的文字形式，便於人類閱讀和解釋。
mode		0..1	code	適用於此小節的處理模式 Binding: ListMode (required): 應填入所綁定值集中的其中一個代碼。
orderedBy		0..1	CodeableConceptTW	小節條目的順序 Binding: ListOrderCodes (preferred): 鼓勵使用所綁定值集中的代碼，但不強制一定要使用此值集，你也可使用其他值集的代碼或單純以文字表示。
entry	S	0..*	Reference(Resource)	提供一個連結用於參照或查看支持此小節內容的資料
emptyReason		0..1	CodeableConceptTW	為什麼此小節是空的原因 Binding: ListEmptyReasons (preferred): 鼓勵使用所綁定值集中的代碼，但不強制一定要使用此值集，你也可使用其他值集的代碼或單純以文字表示。
section		0..*		嵌套的小節
Documentation for this format

Terminology Bindings (Differential)

Path	Conformance	ValueSet	URI
Composition.language	preferred	CommonLanguages Additional Bindings Purpose AllLanguages Max Binding http://hl7.org/fhir/ValueSet/languages from the FHIR Standard
Composition.status	required	CompositionStatus http://hl7.org/fhir/ValueSet/composition-status|4.0.1 from the FHIR Standard
Composition.type	extensible	FHIRDocumentTypeCodes http://hl7.org/fhir/ValueSet/doc-typecodes from the FHIR Standard
Composition.category	extensible	DocumentClassValueSet http://hl7.org/fhir/ValueSet/document-classcodes from the FHIR Standard
Composition.confidentiality	required	v3.ConfidentialityClassification http://terminology.hl7.org/ValueSet/v3-ConfidentialityClassification|2014-03-26 from the FHIR Standard
Composition.attester.mode	required	CompositionAttestationMode http://hl7.org/fhir/ValueSet/composition-attestation-mode|4.0.1 from the FHIR Standard
Composition.relatesTo.code	required	DocumentRelationshipType http://hl7.org/fhir/ValueSet/document-relationship-type|4.0.1 from the FHIR Standard
Composition.event.code	example	ActCode http://terminology.hl7.org/ValueSet/v3-ActCode
Composition.section.code	extensible	DocumentSectionCodes http://hl7.org/fhir/ValueSet/doc-section-codes from the FHIR Standard
Composition.section.mode	required	ListMode http://hl7.org/fhir/ValueSet/list-mode|4.0.1 from the FHIR Standard
Composition.section.orderedBy	preferred	ListOrderCodes http://hl7.org/fhir/ValueSet/list-order from the FHIR Standard
Composition.section.emptyReason	preferred	ListEmptyReasons http://hl7.org/fhir/ValueSet/list-empty-reason from the FHIR Standard

Name	Flags	Card.	Type	Description & Constraints
Composition		0..*	Composition	將一組resources組成一份連貫的臨床聲明，並附有臨床證明。
id	Σ	0..1	id	不重複的ID用以識別儲存在特定FHIR Server中的Composition紀錄，通常又稱為邏輯性ID。
meta	Σ	0..1	Meta	此Composition Resource的metadata
implicitRules	?!Σ	0..1	uri	創建此內容所依據的一組規則
language		0..1	code	用以表述Composition Resource內容的語言 Binding: CommonLanguages (preferred): 人類語言；鼓勵使用所綁定值集中的代碼，但不強制一定要使用此值集，你也可使用其他值集的代碼或單純以文字表示。 Additional Bindings Purpose AllLanguages Max Binding Example Value: zh-TW
text		0..1	Narrative	Composition Resource之內容摘要以供人閱讀
contained		0..*	Resource	內嵌的(contained)、行內的Resources
extension		0..*	Extension	擴充的資料項目
modifierExtension	?!	0..*	Extension	此擴充的資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。
identifier	SΣ	0..1	Identifier	不分版本的臨床文件架構(Composition)識別碼。
status	?!SΣ	1..1	code	registered | partial | preliminary | final | amended | corrected + Binding: CompositionStatus (required): Composition的工作流程/臨床狀態；應填入所綁定值集中的其中一個代碼。
type	S	1..1	CodeableConceptTW	Composition的種類（如果可能請使用LOINC） Binding: FHIRDocumentTypeCodes (extensible): 應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
category		0..*	CodeableConceptTW	Composition的分類 Binding: DocumentClassValueSet (extensible): 應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
subject	SΣ	0..1	Reference(TW Core Patient | Group | Device | Substance | TW Core Location)	Composition是關於誰和/或什麼
encounter	Σ	0..1	Reference(TW Core Encounter)	Composition的情境
date	SΣ	1..1	dateTime	Composition的編輯時間
author	SΣ	1..*	Reference(TW Core Practitioner | TW Core PractitionerRole | TW Core Organization | TW Core Patient | Device | RelatedPerson)	誰和/或什麼創建了這個Composition
title	SΣ	1..1	string	人類可讀的名稱/標題
confidentiality	Σ	0..1	code	根據特定技術領域的定義 Binding: v3.ConfidentialityClassification (2014-03-26) (required): 應填入所綁定值集中的其中一個代碼。
attester	S	0..*	BackboneElement	證明Composition的準確性
id		0..1	string	唯一可識別ID，以供資料項目間相互參照。
extension		0..*	Extension	擴充的資料項目
modifierExtension	?!Σ	0..*	Extension	此擴充的資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。
mode		1..1	code	personal | professional | legal | official Binding: CompositionAttestationMode (required): 認證者提供的認證類型；應填入所綁定值集中的其中一個代碼。
time		0..1	dateTime	此Composition被證明的時間
party		0..1	Reference(TW Core Patient | RelatedPerson | TW Core Practitioner | TW Core PractitionerRole | TW Core Organization)	誰證明了此Composition
custodian	SΣ	0..1	Reference(TW Core Organization)	維護Composition的機構
relatesTo		0..*	BackboneElement	與其他Composition/文件之間的關係
id		0..1	string	唯一可識別ID，以供資料項目間相互參照。
extension		0..*	Extension	擴充的資料項目
modifierExtension	?!Σ	0..*	Extension	此擴充的資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。
code		1..1	code	replaces | transforms | signs | appends Binding: DocumentRelationshipType (required): 檔案之間的關係型別；應填入所綁定值集中的其中一個代碼。
target[x]		1..1		此關係的目標文件
targetIdentifier			Identifier
targetReference			Reference(Composition)
event	Σ	0..*	BackboneElement	正在記錄的臨床服務
id		0..1	string	唯一可識別ID，以供資料項目間相互參照。
extension		0..*	Extension	擴充的資料項目
modifierExtension	?!Σ	0..*	Extension	此擴充的資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。
code		0..*	CodeableConceptTW	此代碼表代表了正在被記錄的主要臨床行為 Binding: v3 Code System ActCode (example): 可參考所綁定值集，但此值集只是針對這個欄位的一個可能值的範例，不預期也不鼓勵使用者一定要使用此值集的代碼。
period	Σ	0..1	Period	文件所涵蓋的時間區間
detail	Σ	0..*	Reference(Resource)	在描述被記錄下來的事件，這些事件可以是以代碼的形式、參考資料的形式，或者兩者都有的形式來呈現。
section	SC	0..*	BackboneElement	Composition被分成一個或數個小節 cmp-1: A section must contain at least one of text, entries, or sub-sections cmp-2: A section can only have an emptyReason if it is empty
id		0..1	string	唯一可識別ID，以供資料項目間相互參照。
extension		0..*	Extension	擴充的資料項目
modifierExtension	?!Σ	0..*	Extension	此擴充的資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。
title		0..1	string	小節標籤(例如：目錄ToC)
code	S	0..1	CodeableConceptTW	小節分類(建議) Binding: DocumentSectionCodes (extensible): 應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
author		0..*	Reference(TW Core Practitioner | TW Core PractitionerRole | TW Core Organization | TW Core Patient | Device | RelatedPerson)	誰和/或什麼人撰寫了該小節
focus		0..1	Reference(Resource)	當小節與composition描述的對象無關時，此小節是關於誰/什麼。
text	SC	0..1	Narrative	將文件中特定小節的內容簡化成容易理解的文字形式，便於人類閱讀和解釋。
mode		0..1	code	適用於此小節的處理模式 Binding: ListMode (required): 應填入所綁定值集中的其中一個代碼。
orderedBy		0..1	CodeableConceptTW	小節條目的順序 Binding: ListOrderCodes (preferred): 鼓勵使用所綁定值集中的代碼，但不強制一定要使用此值集，你也可使用其他值集的代碼或單純以文字表示。
entry	SC	0..*	Reference(Resource)	提供一個連結用於參照或查看支持此小節內容的資料
emptyReason		0..1	CodeableConceptTW	為什麼此小節是空的原因 Binding: ListEmptyReasons (preferred): 鼓勵使用所綁定值集中的代碼，但不強制一定要使用此值集，你也可使用其他值集的代碼或單純以文字表示。
section	C	0..*	See section (Composition)	嵌套的小節
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet	URI
Composition.language	preferred	CommonLanguages Additional Bindings Purpose AllLanguages Max Binding http://hl7.org/fhir/ValueSet/languages from the FHIR Standard
Composition.status	required	CompositionStatus http://hl7.org/fhir/ValueSet/composition-status|4.0.1 from the FHIR Standard
Composition.type	extensible	FHIRDocumentTypeCodes http://hl7.org/fhir/ValueSet/doc-typecodes from the FHIR Standard
Composition.category	extensible	DocumentClassValueSet http://hl7.org/fhir/ValueSet/document-classcodes from the FHIR Standard
Composition.confidentiality	required	v3.ConfidentialityClassification http://terminology.hl7.org/ValueSet/v3-ConfidentialityClassification|2014-03-26 from the FHIR Standard
Composition.attester.mode	required	CompositionAttestationMode http://hl7.org/fhir/ValueSet/composition-attestation-mode|4.0.1 from the FHIR Standard
Composition.relatesTo.code	required	DocumentRelationshipType http://hl7.org/fhir/ValueSet/document-relationship-type|4.0.1 from the FHIR Standard
Composition.event.code	example	ActCode http://terminology.hl7.org/ValueSet/v3-ActCode
Composition.section.code	extensible	DocumentSectionCodes http://hl7.org/fhir/ValueSet/doc-section-codes from the FHIR Standard
Composition.section.mode	required	ListMode http://hl7.org/fhir/ValueSet/list-mode|4.0.1 from the FHIR Standard
Composition.section.orderedBy	preferred	ListOrderCodes http://hl7.org/fhir/ValueSet/list-order from the FHIR Standard
Composition.section.emptyReason	preferred	ListEmptyReasons http://hl7.org/fhir/ValueSet/list-empty-reason from the FHIR Standard

Constraints

Id	Grade	Path(s)	Details	Requirements
cmp-1	error	Composition.section	A section must contain at least one of text, entries, or sub-sections : text.exists() or entry.exists() or section.exists()
cmp-2	error	Composition.section	A section can only have an emptyReason if it is empty : emptyReason.empty() or entry.empty()
dom-2	error	Composition	If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty()
dom-3	error	Composition	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	Composition	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	Composition	If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty()
dom-6	best practice	Composition	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()

Name	Flags	Card.	Type	Description & Constraints
Composition		0..*	Composition	將一組resources組成一份連貫的臨床聲明，並附有臨床證明。
id	Σ	0..1	id	不重複的ID用以識別儲存在特定FHIR Server中的Composition紀錄，通常又稱為邏輯性ID。
meta	Σ	0..1	Meta	此Composition Resource的metadata
implicitRules	?!Σ	0..1	uri	創建此內容所依據的一組規則
language		0..1	code	用以表述Composition Resource內容的語言 Binding: CommonLanguages (preferred): 人類語言；鼓勵使用所綁定值集中的代碼，但不強制一定要使用此值集，你也可使用其他值集的代碼或單純以文字表示。 Additional Bindings Purpose AllLanguages Max Binding Example Value: zh-TW
text		0..1	Narrative	Composition Resource之內容摘要以供人閱讀
contained		0..*	Resource	內嵌的(contained)、行內的Resources
extension		0..*	Extension	擴充的資料項目
modifierExtension	?!	0..*	Extension	此擴充的資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。
identifier	SΣ	0..1	Identifier	不分版本的臨床文件架構(Composition)識別碼。
status	?!SΣ	1..1	code	registered | partial | preliminary | final | amended | corrected + Binding: CompositionStatus (required): Composition的工作流程/臨床狀態；應填入所綁定值集中的其中一個代碼。
type	S	1..1	CodeableConceptTW	Composition的種類（如果可能請使用LOINC） Binding: FHIRDocumentTypeCodes (extensible): 應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
category		0..*	CodeableConceptTW	Composition的分類 Binding: DocumentClassValueSet (extensible): 應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
subject	SΣ	0..1	Reference(TW Core Patient | Group | Device | Substance | TW Core Location)	Composition是關於誰和/或什麼
encounter	Σ	0..1	Reference(TW Core Encounter)	Composition的情境
date	SΣ	1..1	dateTime	Composition的編輯時間
author	SΣ	1..*	Reference(TW Core Practitioner | TW Core PractitionerRole | TW Core Organization | TW Core Patient | Device | RelatedPerson)	誰和/或什麼創建了這個Composition
title	SΣ	1..1	string	人類可讀的名稱/標題
confidentiality	Σ	0..1	code	根據特定技術領域的定義 Binding: v3.ConfidentialityClassification (2014-03-26) (required): 應填入所綁定值集中的其中一個代碼。
attester	S	0..*	BackboneElement	證明Composition的準確性
id		0..1	string	唯一可識別ID，以供資料項目間相互參照。
extension		0..*	Extension	擴充的資料項目
modifierExtension	?!Σ	0..*	Extension	此擴充的資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。
mode		1..1	code	personal | professional | legal | official Binding: CompositionAttestationMode (required): 認證者提供的認證類型；應填入所綁定值集中的其中一個代碼。
time		0..1	dateTime	此Composition被證明的時間
party		0..1	Reference(TW Core Patient | RelatedPerson | TW Core Practitioner | TW Core PractitionerRole | TW Core Organization)	誰證明了此Composition
custodian	SΣ	0..1	Reference(TW Core Organization)	維護Composition的機構
relatesTo		0..*	BackboneElement	與其他Composition/文件之間的關係
id		0..1	string	唯一可識別ID，以供資料項目間相互參照。
extension		0..*	Extension	擴充的資料項目
modifierExtension	?!Σ	0..*	Extension	此擴充的資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。
code		1..1	code	replaces | transforms | signs | appends Binding: DocumentRelationshipType (required): 檔案之間的關係型別；應填入所綁定值集中的其中一個代碼。
target[x]		1..1		此關係的目標文件
targetIdentifier			Identifier
targetReference			Reference(Composition)
event	Σ	0..*	BackboneElement	正在記錄的臨床服務
id		0..1	string	唯一可識別ID，以供資料項目間相互參照。
extension		0..*	Extension	擴充的資料項目
modifierExtension	?!Σ	0..*	Extension	此擴充的資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。
code		0..*	CodeableConceptTW	此代碼表代表了正在被記錄的主要臨床行為 Binding: v3 Code System ActCode (example): 可參考所綁定值集，但此值集只是針對這個欄位的一個可能值的範例，不預期也不鼓勵使用者一定要使用此值集的代碼。
period	Σ	0..1	Period	文件所涵蓋的時間區間
detail	Σ	0..*	Reference(Resource)	在描述被記錄下來的事件，這些事件可以是以代碼的形式、參考資料的形式，或者兩者都有的形式來呈現。
section	SC	0..*	BackboneElement	Composition被分成一個或數個小節 cmp-1: A section must contain at least one of text, entries, or sub-sections cmp-2: A section can only have an emptyReason if it is empty
id		0..1	string	唯一可識別ID，以供資料項目間相互參照。
extension		0..*	Extension	擴充的資料項目
modifierExtension	?!Σ	0..*	Extension	此擴充的資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。
title		0..1	string	小節標籤(例如：目錄ToC)
code	S	0..1	CodeableConceptTW	小節分類(建議) Binding: DocumentSectionCodes (extensible): 應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
author		0..*	Reference(TW Core Practitioner | TW Core PractitionerRole | TW Core Organization | TW Core Patient | Device | RelatedPerson)	誰和/或什麼人撰寫了該小節
focus		0..1	Reference(Resource)	當小節與composition描述的對象無關時，此小節是關於誰/什麼。
text	SC	0..1	Narrative	將文件中特定小節的內容簡化成容易理解的文字形式，便於人類閱讀和解釋。
mode		0..1	code	適用於此小節的處理模式 Binding: ListMode (required): 應填入所綁定值集中的其中一個代碼。
orderedBy		0..1	CodeableConceptTW	小節條目的順序 Binding: ListOrderCodes (preferred): 鼓勵使用所綁定值集中的代碼，但不強制一定要使用此值集，你也可使用其他值集的代碼或單純以文字表示。
entry	SC	0..*	Reference(Resource)	提供一個連結用於參照或查看支持此小節內容的資料
emptyReason		0..1	CodeableConceptTW	為什麼此小節是空的原因 Binding: ListEmptyReasons (preferred): 鼓勵使用所綁定值集中的代碼，但不強制一定要使用此值集，你也可使用其他值集的代碼或單純以文字表示。
section	C	0..*	See section (Composition)	嵌套的小節
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet	URI
Composition.language	preferred	CommonLanguages Additional Bindings Purpose AllLanguages Max Binding http://hl7.org/fhir/ValueSet/languages from the FHIR Standard
Composition.status	required	CompositionStatus http://hl7.org/fhir/ValueSet/composition-status|4.0.1 from the FHIR Standard
Composition.type	extensible	FHIRDocumentTypeCodes http://hl7.org/fhir/ValueSet/doc-typecodes from the FHIR Standard
Composition.category	extensible	DocumentClassValueSet http://hl7.org/fhir/ValueSet/document-classcodes from the FHIR Standard
Composition.confidentiality	required	v3.ConfidentialityClassification http://terminology.hl7.org/ValueSet/v3-ConfidentialityClassification|2014-03-26 from the FHIR Standard
Composition.attester.mode	required	CompositionAttestationMode http://hl7.org/fhir/ValueSet/composition-attestation-mode|4.0.1 from the FHIR Standard
Composition.relatesTo.code	required	DocumentRelationshipType http://hl7.org/fhir/ValueSet/document-relationship-type|4.0.1 from the FHIR Standard
Composition.event.code	example	ActCode http://terminology.hl7.org/ValueSet/v3-ActCode
Composition.section.code	extensible	DocumentSectionCodes http://hl7.org/fhir/ValueSet/doc-section-codes from the FHIR Standard
Composition.section.mode	required	ListMode http://hl7.org/fhir/ValueSet/list-mode|4.0.1 from the FHIR Standard
Composition.section.orderedBy	preferred	ListOrderCodes http://hl7.org/fhir/ValueSet/list-order from the FHIR Standard
Composition.section.emptyReason	preferred	ListEmptyReasons http://hl7.org/fhir/ValueSet/list-empty-reason from the FHIR Standard

Constraints

Id	Grade	Path(s)	Details	Requirements
cmp-1	error	Composition.section	A section must contain at least one of text, entries, or sub-sections : text.exists() or entry.exists() or section.exists()
cmp-2	error	Composition.section	A section can only have an emptyReason if it is empty : emptyReason.empty() or entry.empty()
dom-2	error	Composition	If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty()
dom-3	error	Composition	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	Composition	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	Composition	If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty()
dom-6	best practice	Composition	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 Composition

Name	Flags	Card.	Type	Description & Constraints
Composition		0..*	Composition	將一組resources組成一份連貫的臨床聲明，並附有臨床證明。
id		0..1	id	不重複的ID用以識別儲存在特定FHIR Server中的Composition紀錄，通常又稱為邏輯性ID。
meta		0..1	Meta	此Composition Resource的metadata
implicitRules		0..1	uri	創建此內容所依據的一組規則
language		0..1	code	用以表述Composition Resource內容的語言 Binding: CommonLanguages (preferred): 人類語言；鼓勵使用所綁定值集中的代碼，但不強制一定要使用此值集，你也可使用其他值集的代碼或單純以文字表示。 Additional Bindings Purpose AllLanguages Max Binding Example Value: zh-TW
text		0..1	Narrative	Composition Resource之內容摘要以供人閱讀
contained		0..*	Resource	內嵌的(contained)、行內的Resources
extension		0..*	Extension	擴充的資料項目
modifierExtension		0..*	Extension	此擴充的資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。
identifier	S	0..1	Identifier	不分版本的臨床文件架構(Composition)識別碼。
status	S	1..1	code	registered | partial | preliminary | final | amended | corrected + Binding: CompositionStatus (required): Composition的工作流程/臨床狀態；應填入所綁定值集中的其中一個代碼。
type	S	1..1	CodeableConceptTW	Composition的種類（如果可能請使用LOINC） Binding: FHIRDocumentTypeCodes (extensible): 應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
category		0..*	CodeableConceptTW	Composition的分類 Binding: DocumentClassValueSet (extensible): 應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
subject	S	0..1	Reference(TW Core Patient | Group | Device | Substance | TW Core Location)	Composition是關於誰和/或什麼
encounter		0..1	Reference(TW Core Encounter)	Composition的情境
date	S	1..1	dateTime	Composition的編輯時間
author	S	1..*	Reference(TW Core Practitioner | TW Core PractitionerRole | TW Core Organization | TW Core Patient | Device | RelatedPerson)	誰和/或什麼創建了這個Composition
title	S	1..1	string	人類可讀的名稱/標題
confidentiality		0..1	code	根據特定技術領域的定義 Binding: v3.ConfidentialityClassification (2014-03-26) (required): 應填入所綁定值集中的其中一個代碼。
attester	S	0..*	BackboneElement	證明Composition的準確性
id		0..1	string	唯一可識別ID，以供資料項目間相互參照。
extension		0..*	Extension	擴充的資料項目
modifierExtension		0..*	Extension	此擴充的資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。
mode		1..1	code	personal | professional | legal | official Binding: CompositionAttestationMode (required): 認證者提供的認證類型；應填入所綁定值集中的其中一個代碼。
time		0..1	dateTime	此Composition被證明的時間
party		0..1	Reference(TW Core Patient | RelatedPerson | TW Core Practitioner | TW Core PractitionerRole | TW Core Organization)	誰證明了此Composition
custodian	S	0..1	Reference(TW Core Organization)	維護Composition的機構
relatesTo		0..*	BackboneElement	與其他Composition/文件之間的關係
id		0..1	string	唯一可識別ID，以供資料項目間相互參照。
extension		0..*	Extension	擴充的資料項目
modifierExtension		0..*	Extension	此擴充的資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。
code		1..1	code	replaces | transforms | signs | appends Binding: DocumentRelationshipType (required): 檔案之間的關係型別；應填入所綁定值集中的其中一個代碼。
target[x]		1..1	Identifier, Reference(Composition)	此關係的目標文件
event		0..*	BackboneElement	正在記錄的臨床服務
id		0..1	string	唯一可識別ID，以供資料項目間相互參照。
extension		0..*	Extension	擴充的資料項目
modifierExtension		0..*	Extension	此擴充的資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。
code		0..*	CodeableConceptTW	此代碼表代表了正在被記錄的主要臨床行為 Binding: v3 Code System ActCode (example): 可參考所綁定值集，但此值集只是針對這個欄位的一個可能值的範例，不預期也不鼓勵使用者一定要使用此值集的代碼。
period		0..1	Period	文件所涵蓋的時間區間
detail		0..*	Reference(Resource)	在描述被記錄下來的事件，這些事件可以是以代碼的形式、參考資料的形式，或者兩者都有的形式來呈現。
section	S	0..*	BackboneElement	Composition被分成一個或數個小節
id		0..1	string	唯一可識別ID，以供資料項目間相互參照。
extension		0..*	Extension	擴充的資料項目
modifierExtension		0..*	Extension	此擴充的資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。
title		0..1	string	小節標籤(例如：目錄ToC)
code	S	0..1	CodeableConceptTW	小節分類(建議) Binding: DocumentSectionCodes (extensible): 應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
author		0..*	Reference(TW Core Practitioner | TW Core PractitionerRole | TW Core Organization | TW Core Patient | Device | RelatedPerson)	誰和/或什麼人撰寫了該小節
focus		0..1	Reference(Resource)	當小節與composition描述的對象無關時，此小節是關於誰/什麼。
text	S	0..1	Narrative	將文件中特定小節的內容簡化成容易理解的文字形式，便於人類閱讀和解釋。
mode		0..1	code	適用於此小節的處理模式 Binding: ListMode (required): 應填入所綁定值集中的其中一個代碼。
orderedBy		0..1	CodeableConceptTW	小節條目的順序 Binding: ListOrderCodes (preferred): 鼓勵使用所綁定值集中的代碼，但不強制一定要使用此值集，你也可使用其他值集的代碼或單純以文字表示。
entry	S	0..*	Reference(Resource)	提供一個連結用於參照或查看支持此小節內容的資料
emptyReason		0..1	CodeableConceptTW	為什麼此小節是空的原因 Binding: ListEmptyReasons (preferred): 鼓勵使用所綁定值集中的代碼，但不強制一定要使用此值集，你也可使用其他值集的代碼或單純以文字表示。
section		0..*		嵌套的小節
Documentation for this format

Terminology Bindings (Differential)

Path	Conformance	ValueSet	URI
Composition.language	preferred	CommonLanguages Additional Bindings Purpose AllLanguages Max Binding http://hl7.org/fhir/ValueSet/languages from the FHIR Standard
Composition.status	required	CompositionStatus http://hl7.org/fhir/ValueSet/composition-status|4.0.1 from the FHIR Standard
Composition.type	extensible	FHIRDocumentTypeCodes http://hl7.org/fhir/ValueSet/doc-typecodes from the FHIR Standard
Composition.category	extensible	DocumentClassValueSet http://hl7.org/fhir/ValueSet/document-classcodes from the FHIR Standard
Composition.confidentiality	required	v3.ConfidentialityClassification http://terminology.hl7.org/ValueSet/v3-ConfidentialityClassification|2014-03-26 from the FHIR Standard
Composition.attester.mode	required	CompositionAttestationMode http://hl7.org/fhir/ValueSet/composition-attestation-mode|4.0.1 from the FHIR Standard
Composition.relatesTo.code	required	DocumentRelationshipType http://hl7.org/fhir/ValueSet/document-relationship-type|4.0.1 from the FHIR Standard
Composition.event.code	example	ActCode http://terminology.hl7.org/ValueSet/v3-ActCode
Composition.section.code	extensible	DocumentSectionCodes http://hl7.org/fhir/ValueSet/doc-section-codes from the FHIR Standard
Composition.section.mode	required	ListMode http://hl7.org/fhir/ValueSet/list-mode|4.0.1 from the FHIR Standard
Composition.section.orderedBy	preferred	ListOrderCodes http://hl7.org/fhir/ValueSet/list-order from the FHIR Standard
Composition.section.emptyReason	preferred	ListEmptyReasons http://hl7.org/fhir/ValueSet/list-empty-reason from the FHIR Standard

Key Elements View

Name	Flags	Card.	Type	Description & Constraints
Composition		0..*	Composition	將一組resources組成一份連貫的臨床聲明，並附有臨床證明。
id	Σ	0..1	id	不重複的ID用以識別儲存在特定FHIR Server中的Composition紀錄，通常又稱為邏輯性ID。
meta	Σ	0..1	Meta	此Composition Resource的metadata
implicitRules	?!Σ	0..1	uri	創建此內容所依據的一組規則
language		0..1	code	用以表述Composition Resource內容的語言 Binding: CommonLanguages (preferred): 人類語言；鼓勵使用所綁定值集中的代碼，但不強制一定要使用此值集，你也可使用其他值集的代碼或單純以文字表示。 Additional Bindings Purpose AllLanguages Max Binding Example Value: zh-TW
text		0..1	Narrative	Composition Resource之內容摘要以供人閱讀
contained		0..*	Resource	內嵌的(contained)、行內的Resources
extension		0..*	Extension	擴充的資料項目
modifierExtension	?!	0..*	Extension	此擴充的資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。
identifier	SΣ	0..1	Identifier	不分版本的臨床文件架構(Composition)識別碼。
status	?!SΣ	1..1	code	registered | partial | preliminary | final | amended | corrected + Binding: CompositionStatus (required): Composition的工作流程/臨床狀態；應填入所綁定值集中的其中一個代碼。
type	S	1..1	CodeableConceptTW	Composition的種類（如果可能請使用LOINC） Binding: FHIRDocumentTypeCodes (extensible): 應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
category		0..*	CodeableConceptTW	Composition的分類 Binding: DocumentClassValueSet (extensible): 應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
subject	SΣ	0..1	Reference(TW Core Patient | Group | Device | Substance | TW Core Location)	Composition是關於誰和/或什麼
encounter	Σ	0..1	Reference(TW Core Encounter)	Composition的情境
date	SΣ	1..1	dateTime	Composition的編輯時間
author	SΣ	1..*	Reference(TW Core Practitioner | TW Core PractitionerRole | TW Core Organization | TW Core Patient | Device | RelatedPerson)	誰和/或什麼創建了這個Composition
title	SΣ	1..1	string	人類可讀的名稱/標題
confidentiality	Σ	0..1	code	根據特定技術領域的定義 Binding: v3.ConfidentialityClassification (2014-03-26) (required): 應填入所綁定值集中的其中一個代碼。
attester	S	0..*	BackboneElement	證明Composition的準確性
id		0..1	string	唯一可識別ID，以供資料項目間相互參照。
extension		0..*	Extension	擴充的資料項目
modifierExtension	?!Σ	0..*	Extension	此擴充的資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。
mode		1..1	code	personal | professional | legal | official Binding: CompositionAttestationMode (required): 認證者提供的認證類型；應填入所綁定值集中的其中一個代碼。
time		0..1	dateTime	此Composition被證明的時間
party		0..1	Reference(TW Core Patient | RelatedPerson | TW Core Practitioner | TW Core PractitionerRole | TW Core Organization)	誰證明了此Composition
custodian	SΣ	0..1	Reference(TW Core Organization)	維護Composition的機構
relatesTo		0..*	BackboneElement	與其他Composition/文件之間的關係
id		0..1	string	唯一可識別ID，以供資料項目間相互參照。
extension		0..*	Extension	擴充的資料項目
modifierExtension	?!Σ	0..*	Extension	此擴充的資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。
code		1..1	code	replaces | transforms | signs | appends Binding: DocumentRelationshipType (required): 檔案之間的關係型別；應填入所綁定值集中的其中一個代碼。
target[x]		1..1		此關係的目標文件
targetIdentifier			Identifier
targetReference			Reference(Composition)
event	Σ	0..*	BackboneElement	正在記錄的臨床服務
id		0..1	string	唯一可識別ID，以供資料項目間相互參照。
extension		0..*	Extension	擴充的資料項目
modifierExtension	?!Σ	0..*	Extension	此擴充的資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。
code		0..*	CodeableConceptTW	此代碼表代表了正在被記錄的主要臨床行為 Binding: v3 Code System ActCode (example): 可參考所綁定值集，但此值集只是針對這個欄位的一個可能值的範例，不預期也不鼓勵使用者一定要使用此值集的代碼。
period	Σ	0..1	Period	文件所涵蓋的時間區間
detail	Σ	0..*	Reference(Resource)	在描述被記錄下來的事件，這些事件可以是以代碼的形式、參考資料的形式，或者兩者都有的形式來呈現。
section	SC	0..*	BackboneElement	Composition被分成一個或數個小節 cmp-1: A section must contain at least one of text, entries, or sub-sections cmp-2: A section can only have an emptyReason if it is empty
id		0..1	string	唯一可識別ID，以供資料項目間相互參照。
extension		0..*	Extension	擴充的資料項目
modifierExtension	?!Σ	0..*	Extension	此擴充的資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。
title		0..1	string	小節標籤(例如：目錄ToC)
code	S	0..1	CodeableConceptTW	小節分類(建議) Binding: DocumentSectionCodes (extensible): 應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
author		0..*	Reference(TW Core Practitioner | TW Core PractitionerRole | TW Core Organization | TW Core Patient | Device | RelatedPerson)	誰和/或什麼人撰寫了該小節
focus		0..1	Reference(Resource)	當小節與composition描述的對象無關時，此小節是關於誰/什麼。
text	SC	0..1	Narrative	將文件中特定小節的內容簡化成容易理解的文字形式，便於人類閱讀和解釋。
mode		0..1	code	適用於此小節的處理模式 Binding: ListMode (required): 應填入所綁定值集中的其中一個代碼。
orderedBy		0..1	CodeableConceptTW	小節條目的順序 Binding: ListOrderCodes (preferred): 鼓勵使用所綁定值集中的代碼，但不強制一定要使用此值集，你也可使用其他值集的代碼或單純以文字表示。
entry	SC	0..*	Reference(Resource)	提供一個連結用於參照或查看支持此小節內容的資料
emptyReason		0..1	CodeableConceptTW	為什麼此小節是空的原因 Binding: ListEmptyReasons (preferred): 鼓勵使用所綁定值集中的代碼，但不強制一定要使用此值集，你也可使用其他值集的代碼或單純以文字表示。
section	C	0..*	See section (Composition)	嵌套的小節
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet	URI
Composition.language	preferred	CommonLanguages Additional Bindings Purpose AllLanguages Max Binding http://hl7.org/fhir/ValueSet/languages from the FHIR Standard
Composition.status	required	CompositionStatus http://hl7.org/fhir/ValueSet/composition-status|4.0.1 from the FHIR Standard
Composition.type	extensible	FHIRDocumentTypeCodes http://hl7.org/fhir/ValueSet/doc-typecodes from the FHIR Standard
Composition.category	extensible	DocumentClassValueSet http://hl7.org/fhir/ValueSet/document-classcodes from the FHIR Standard
Composition.confidentiality	required	v3.ConfidentialityClassification http://terminology.hl7.org/ValueSet/v3-ConfidentialityClassification|2014-03-26 from the FHIR Standard
Composition.attester.mode	required	CompositionAttestationMode http://hl7.org/fhir/ValueSet/composition-attestation-mode|4.0.1 from the FHIR Standard
Composition.relatesTo.code	required	DocumentRelationshipType http://hl7.org/fhir/ValueSet/document-relationship-type|4.0.1 from the FHIR Standard
Composition.event.code	example	ActCode http://terminology.hl7.org/ValueSet/v3-ActCode
Composition.section.code	extensible	DocumentSectionCodes http://hl7.org/fhir/ValueSet/doc-section-codes from the FHIR Standard
Composition.section.mode	required	ListMode http://hl7.org/fhir/ValueSet/list-mode|4.0.1 from the FHIR Standard
Composition.section.orderedBy	preferred	ListOrderCodes http://hl7.org/fhir/ValueSet/list-order from the FHIR Standard
Composition.section.emptyReason	preferred	ListEmptyReasons http://hl7.org/fhir/ValueSet/list-empty-reason from the FHIR Standard

Constraints

Id	Grade	Path(s)	Details	Requirements
cmp-1	error	Composition.section	A section must contain at least one of text, entries, or sub-sections : text.exists() or entry.exists() or section.exists()
cmp-2	error	Composition.section	A section can only have an emptyReason if it is empty : emptyReason.empty() or entry.empty()
dom-2	error	Composition	If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty()
dom-3	error	Composition	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	Composition	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	Composition	If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty()
dom-6	best practice	Composition	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()

Snapshot View

Name	Flags	Card.	Type	Description & Constraints
Composition		0..*	Composition	將一組resources組成一份連貫的臨床聲明，並附有臨床證明。
id	Σ	0..1	id	不重複的ID用以識別儲存在特定FHIR Server中的Composition紀錄，通常又稱為邏輯性ID。
meta	Σ	0..1	Meta	此Composition Resource的metadata
implicitRules	?!Σ	0..1	uri	創建此內容所依據的一組規則
language		0..1	code	用以表述Composition Resource內容的語言 Binding: CommonLanguages (preferred): 人類語言；鼓勵使用所綁定值集中的代碼，但不強制一定要使用此值集，你也可使用其他值集的代碼或單純以文字表示。 Additional Bindings Purpose AllLanguages Max Binding Example Value: zh-TW
text		0..1	Narrative	Composition Resource之內容摘要以供人閱讀
contained		0..*	Resource	內嵌的(contained)、行內的Resources
extension		0..*	Extension	擴充的資料項目
modifierExtension	?!	0..*	Extension	此擴充的資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。
identifier	SΣ	0..1	Identifier	不分版本的臨床文件架構(Composition)識別碼。
status	?!SΣ	1..1	code	registered | partial | preliminary | final | amended | corrected + Binding: CompositionStatus (required): Composition的工作流程/臨床狀態；應填入所綁定值集中的其中一個代碼。
type	S	1..1	CodeableConceptTW	Composition的種類（如果可能請使用LOINC） Binding: FHIRDocumentTypeCodes (extensible): 應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
category		0..*	CodeableConceptTW	Composition的分類 Binding: DocumentClassValueSet (extensible): 應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
subject	SΣ	0..1	Reference(TW Core Patient | Group | Device | Substance | TW Core Location)	Composition是關於誰和/或什麼
encounter	Σ	0..1	Reference(TW Core Encounter)	Composition的情境
date	SΣ	1..1	dateTime	Composition的編輯時間
author	SΣ	1..*	Reference(TW Core Practitioner | TW Core PractitionerRole | TW Core Organization | TW Core Patient | Device | RelatedPerson)	誰和/或什麼創建了這個Composition
title	SΣ	1..1	string	人類可讀的名稱/標題
confidentiality	Σ	0..1	code	根據特定技術領域的定義 Binding: v3.ConfidentialityClassification (2014-03-26) (required): 應填入所綁定值集中的其中一個代碼。
attester	S	0..*	BackboneElement	證明Composition的準確性
id		0..1	string	唯一可識別ID，以供資料項目間相互參照。
extension		0..*	Extension	擴充的資料項目
modifierExtension	?!Σ	0..*	Extension	此擴充的資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。
mode		1..1	code	personal | professional | legal | official Binding: CompositionAttestationMode (required): 認證者提供的認證類型；應填入所綁定值集中的其中一個代碼。
time		0..1	dateTime	此Composition被證明的時間
party		0..1	Reference(TW Core Patient | RelatedPerson | TW Core Practitioner | TW Core PractitionerRole | TW Core Organization)	誰證明了此Composition
custodian	SΣ	0..1	Reference(TW Core Organization)	維護Composition的機構
relatesTo		0..*	BackboneElement	與其他Composition/文件之間的關係
id		0..1	string	唯一可識別ID，以供資料項目間相互參照。
extension		0..*	Extension	擴充的資料項目
modifierExtension	?!Σ	0..*	Extension	此擴充的資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。
code		1..1	code	replaces | transforms | signs | appends Binding: DocumentRelationshipType (required): 檔案之間的關係型別；應填入所綁定值集中的其中一個代碼。
target[x]		1..1		此關係的目標文件
targetIdentifier			Identifier
targetReference			Reference(Composition)
event	Σ	0..*	BackboneElement	正在記錄的臨床服務
id		0..1	string	唯一可識別ID，以供資料項目間相互參照。
extension		0..*	Extension	擴充的資料項目
modifierExtension	?!Σ	0..*	Extension	此擴充的資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。
code		0..*	CodeableConceptTW	此代碼表代表了正在被記錄的主要臨床行為 Binding: v3 Code System ActCode (example): 可參考所綁定值集，但此值集只是針對這個欄位的一個可能值的範例，不預期也不鼓勵使用者一定要使用此值集的代碼。
period	Σ	0..1	Period	文件所涵蓋的時間區間
detail	Σ	0..*	Reference(Resource)	在描述被記錄下來的事件，這些事件可以是以代碼的形式、參考資料的形式，或者兩者都有的形式來呈現。
section	SC	0..*	BackboneElement	Composition被分成一個或數個小節 cmp-1: A section must contain at least one of text, entries, or sub-sections cmp-2: A section can only have an emptyReason if it is empty
id		0..1	string	唯一可識別ID，以供資料項目間相互參照。
extension		0..*	Extension	擴充的資料項目
modifierExtension	?!Σ	0..*	Extension	此擴充的資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。
title		0..1	string	小節標籤(例如：目錄ToC)
code	S	0..1	CodeableConceptTW	小節分類(建議) Binding: DocumentSectionCodes (extensible): 應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
author		0..*	Reference(TW Core Practitioner | TW Core PractitionerRole | TW Core Organization | TW Core Patient | Device | RelatedPerson)	誰和/或什麼人撰寫了該小節
focus		0..1	Reference(Resource)	當小節與composition描述的對象無關時，此小節是關於誰/什麼。
text	SC	0..1	Narrative	將文件中特定小節的內容簡化成容易理解的文字形式，便於人類閱讀和解釋。
mode		0..1	code	適用於此小節的處理模式 Binding: ListMode (required): 應填入所綁定值集中的其中一個代碼。
orderedBy		0..1	CodeableConceptTW	小節條目的順序 Binding: ListOrderCodes (preferred): 鼓勵使用所綁定值集中的代碼，但不強制一定要使用此值集，你也可使用其他值集的代碼或單純以文字表示。
entry	SC	0..*	Reference(Resource)	提供一個連結用於參照或查看支持此小節內容的資料
emptyReason		0..1	CodeableConceptTW	為什麼此小節是空的原因 Binding: ListEmptyReasons (preferred): 鼓勵使用所綁定值集中的代碼，但不強制一定要使用此值集，你也可使用其他值集的代碼或單純以文字表示。
section	C	0..*	See section (Composition)	嵌套的小節
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet	URI
Composition.language	preferred	CommonLanguages Additional Bindings Purpose AllLanguages Max Binding http://hl7.org/fhir/ValueSet/languages from the FHIR Standard
Composition.status	required	CompositionStatus http://hl7.org/fhir/ValueSet/composition-status|4.0.1 from the FHIR Standard
Composition.type	extensible	FHIRDocumentTypeCodes http://hl7.org/fhir/ValueSet/doc-typecodes from the FHIR Standard
Composition.category	extensible	DocumentClassValueSet http://hl7.org/fhir/ValueSet/document-classcodes from the FHIR Standard
Composition.confidentiality	required	v3.ConfidentialityClassification http://terminology.hl7.org/ValueSet/v3-ConfidentialityClassification|2014-03-26 from the FHIR Standard
Composition.attester.mode	required	CompositionAttestationMode http://hl7.org/fhir/ValueSet/composition-attestation-mode|4.0.1 from the FHIR Standard
Composition.relatesTo.code	required	DocumentRelationshipType http://hl7.org/fhir/ValueSet/document-relationship-type|4.0.1 from the FHIR Standard
Composition.event.code	example	ActCode http://terminology.hl7.org/ValueSet/v3-ActCode
Composition.section.code	extensible	DocumentSectionCodes http://hl7.org/fhir/ValueSet/doc-section-codes from the FHIR Standard
Composition.section.mode	required	ListMode http://hl7.org/fhir/ValueSet/list-mode|4.0.1 from the FHIR Standard
Composition.section.orderedBy	preferred	ListOrderCodes http://hl7.org/fhir/ValueSet/list-order from the FHIR Standard
Composition.section.emptyReason	preferred	ListEmptyReasons http://hl7.org/fhir/ValueSet/list-empty-reason from the FHIR Standard

Constraints

Id	Grade	Path(s)	Details	Requirements
cmp-1	error	Composition.section	A section must contain at least one of text, entries, or sub-sections : text.exists() or entry.exists() or section.exists()
cmp-2	error	Composition.section	A section can only have an emptyReason if it is empty : emptyReason.empty() or entry.empty()
dom-2	error	Composition	If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty()
dom-3	error	Composition	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	Composition	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	Composition	If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty()
dom-6	best practice	Composition	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 Composition

Summary

Must-Support: 13 elements

Structures

This structure refers to these other structures:

• TW CodeableConcept (https://twcore.mohw.gov.tw/ig/twcore/StructureDefinition/CodeableConcept-tw)
• TW Core Patient (https://twcore.mohw.gov.tw/ig/twcore/StructureDefinition/Patient-twcore)
• TW Core Location (https://twcore.mohw.gov.tw/ig/twcore/StructureDefinition/Location-twcore)
• TW Core Encounter (https://twcore.mohw.gov.tw/ig/twcore/StructureDefinition/Encounter-twcore)
• TW Core Practitioner (https://twcore.mohw.gov.tw/ig/twcore/StructureDefinition/Practitioner-twcore)
• TW Core PractitionerRole (https://twcore.mohw.gov.tw/ig/twcore/StructureDefinition/PractitionerRole-twcore)
• TW Core Organization (https://twcore.mohw.gov.tw/ig/twcore/StructureDefinition/Organization-twcore)

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

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

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

   例子：
   (1) GET [base]/Composition?_id=com-example
   (2) GET [base]/Composition/com-example

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

   例子：
   (1) GET [base]/Composition?status=final

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

   例子：
   (1) GET [base]/Composition?type=http://loinc.org|18842-5

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

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