臺灣核心實作指引(TW Core IG)
0.2.0 - Trial Use

This page is part of the 臺灣核心實作指引(TW Core IG) (v0.2.0: Releases) based on FHIR (HL7® FHIR® Standard) R4. This is the current published version. For a full list of available versions, see the Directory of published versions

應用說明

Official URL: https://twcore.mohw.gov.tw/ig/twcore/ImplementationGuide/tw.gov.mohw.twcore Version: 0.2.0
Active as of 2024-03-21 Computable Name: TWCore

因考量實作需求，於2024/3/21異動以下內容：
  1. 新增十二個Profiles:
    1. 臺灣核心-過敏或不耐症(TW Core AllergyIntolerance)
    2. 臺灣核心-資料交換基本單位(TW Core Bundle)
      1. 臺灣核心-資料交換基本單位-文件 (TW Core Bundle Document)
      2. 臺灣核心-資料交換基本單位-訊息(TW Core Bundle Message)
    3. 臺灣核心-臨床文件架構(TW Core Composition)
    4. 臺灣核心-影像檢查(TW Core ImagingStudy)
    5. 臺灣核心-文件參照(TW Core DocumentReference)
    6. 臺灣核心-地點(TW Core Location)
    7. 臺灣核心-多媒體(TW Core Media)
    8. 臺灣核心-配藥或藥品調劑(TW Core MedicationDispense)
    9. 臺灣核心-用藥聲明(TW Core MedicationStatement)
    10. 臺灣核心-訊息表頭(TW Core MessageHeader)
    11. 臺灣核心-檢體(TW Core Specimen)
    12. 臺灣核心-健康照護服務提供者角色(TW Core PractitionerRole)
  2. 修改Resource Profile: 臺灣核心-病情、問題或診斷(TW Core Condition)：以下欄位之值集綁定強度由example改為extensible，以利實務專案使用：
    1. Condition.severity
    2. Condition.bodySite
    3. Condition.stage.summary
    4. Condition.stage.type
    5. Condition.evidence.code
  3. 修改Resource Profile: 臺灣核心-診斷報告(TW Core DiagnosticReport)：conclusionCode欄位之值集綁定強度由example改為extensible，以利實務專案使用。
  4. 修改Resource Profile: 臺灣核心-就醫事件(TW Core Encounter) ：serviceType欄位之改綁定「ValueSet:SNOMED CT + 臺灣健保署 + 衛福部統計處診療科別值集」，以提高資料國際互通性及實務專案使用。
  5. 修改Resource Profile: 臺灣核心-藥品請求(TW Core MedicationRequest)：
    1. 以下欄位之值集綁定強度由example改為extensible，以利實務專案使用：
      1. MedicationRequest.performerType
      2. MedicationRequest.reasonCode
      3. MedicationRequest.dosageInstruction.additionalInstruction
      4. MedicationRequest.dosageInstruction.asNeeded[x]
      5. MedicationRequest.dosageInstruction.site
      6. MedicationRequest.dosageInstruction.method
    2. MedicationRequest.dosageInstruction.time.codeing欄位改綁定「ValueSet:HL7 TimingAbbreviation + 臺灣衛福部統計處藥品使用頻率值集」，以提高資料國際互通性及實務專案使用。
    3. MedicationRequest.dosageInstruction.route.codeing欄位改綁定「ValueSet:SNOMED CT + 臺灣衛福部統計處給藥途徑值集」，以提高資料國際互通性及實務專案使用。
  6. 修改Resource Profile: 臺灣核心-檢驗檢查(TW Core Observation Laboratory Result)：以下欄位之值集綁定強度由example改為extensible，以利實務專案使用：
    1. Observation.bodySite
    2. Observation.method
  7. 修改Resource Profile: 臺灣核心-機構(TW Core Organization)：identifier.type欄位之值集綁定強度由required改為extensible，以利實務專案使用。
  8. 修改Resource Profile: 臺灣核心-病人(TW Core Patient)：identifier.type欄位之值集綁定強度由required改為extensible，以利實務專案使用。
  9. 修改Resource Profile: 臺灣核心-健康照護服務提供者(TW Core Practitioner)：qualification.code綁定新增的「ValueSet: SNOMED CT + 臺灣醫事司醫事人員類別值集」
  10. 修改Resource Profile: 臺灣核心-處置或手術(TW Core Procedure)：以下欄位之值集綁定強度由example改為extensible，以利實務專案使用：
    1. Procedure.statusReason
    2. Procedure.category
    3. Procedure.performer.function
    4. Procedure.reasonCode
    5. Procedure.bodySite
    6. Procedure.outcome
    7. Procedure.complication
    8. Procedure.followUp
    9. Procedure.usedCode
  11. 新增值集(ValueSets):
    1. 臺灣健保署診療科別值集
    2. 臺灣衛福部統計處診療科別值集
    3. SNOMED CT + 臺灣健保署 + 衛福部統計處診療科別值集
    4. SNOMED CT + 臺灣衛福部統計處給藥途徑值集
    5. HL7 TimingAbbreviation + 臺灣衛福部統計處藥品使用頻率值集
    6. SNOMED CT + 臺灣醫事司醫事人員類別值集
  12. 新增代碼系統(CodeSystems):
    1. 臺灣健保署診療科別
    2. 臺灣衛生福利部統計處診療科別
  13. 修改代碼系統(CodeSystems):
    1. 所有代碼系統皆新增兩個Properties:將所有的代碼系統皆加上Property - 異動日期(updateDate)、異動方式(event)。
    2. 臺灣中華郵政3碼郵遞區號代碼系統：2023.12.28的新版3碼郵遞區號代碼中有修改部分代碼。
    3. 臺灣中華郵政6碼郵遞區號代碼系統：2023.12.28的新版6碼郵遞區號代碼中有新增、刪除、修改部分代碼。
  14. 新增概念對應(ConceptMaps):
    1. 臺灣健保署診療科別代碼對應SNOMED CT
    2. 臺灣衛生福利部統計處診療科別代碼對應SNOMED CT
    3. 臺灣衛福部統計處給藥途徑代碼對應SNOMED CT
    4. 臺灣衛福部統計處藥品使用頻率代碼對應對應HL7 TimingAbbreviation
    5. 臺灣醫事司醫事人員類別代碼對應SNOMED CT
  15. 專門術語名稱調整:將所有的專門術語之名稱加上代碼來源，如：ValueSet: 臺灣醫事機構代碼值集 -> ValueSet: 臺灣健保署醫事機構代碼值集。
  16. 頁面與其名稱調整:
    1. 首頁 －> 應用說明
    2. 文件索引 －> 規範文件
請留意這些異動，以避免影響您的實作。

介紹

臺灣核心實作指引（Taiwan Core Implementation Guide，簡稱TW core IG）採用HL7® FHIR® standard（Fast Healthcare Interoperability Resources）IG建置方法，在FHIR R4.0.1之標準基礎上，參考了國際病人摘要(International Patient Summary，IPS)1.1.0-CI Build及美國核心實作指引(US Core Implementation Guide)，進一步定義適用於臺灣健康照護資料交換需求的Resources（類似資料表）、其中的資料項目（意即欄位）、基數（意即0..1、0..*、1..1或1..*）、資料類型（文字、日期時間、代碼等）、可綁定的代碼（及其綁定的強制程度）及查詢參數等，旨在提供健康照護資訊系統開發與實作者以TW Core IG為基礎，再進一步訂定其實務專案所需之資料交換格式以應用於專案中。TW Core IG的實作方式有兩種：

  1. 僅支援Profiles：系統僅支援TW Core Profiles以呈現健康照護相關資料。
  2. 支援Profiles + RESTful互動：系統支援TW Core Profiles及RESTful互動以呈現健康照護相關資料。

背景

TW Core IG由衛生福利部2022年3月招標之「111年度智慧健康雲專案辦公室營運案專案」經費支應下建置，TW Core IG註冊於國際平臺及衛生福利部之IG管理平臺以供查找與參考。

鑑於FHIR R5還在投票階段，故此版本TW Core IG以FHIR R4.0.1為基礎，並同時參考其他國家作法規劃TW Core IG網站。為使制訂之IG符合臺灣的實作需求，TW Core IG內容將在未來的版本中持續更新，各版本亦將附有版本異動說明。所有經進一步定義的Resources或Profiles，皆稱為Profiles，各Profiles依據其可被在地實際採用的程度與不再修改的程度，將標記其「成熟度(Maturity Level)」，被稱之為FMM（根據眾所周知的CMM级別）。FMM等級(level)可被實作者用来判斷一個規範文件的進階程度，也就是穩定度。以下是已被定義的FMM等級，實務上會視情況調整以符合定義：

DRAFT 0 此Resource或Profile (規範文件) 已被發佈於目前的建置，這個等級意即草稿。

FMM 1 滿足DRAFT 0條件，而且此規範文件在建置的過程沒有任何的警語，負責的工作小組已指明他們認為這份規範文件基本上已完成並可供實作使用。

FMM 2 滿足FMM 1條件，而且此規範文件已被測試，並成功支援至少三套獨立系統之間的可互操作性(意即至少有三套系統實作此規範成功地互通資料)，這些系統利用大部分的規範文件(例如至少80%的核心資料)，使用基於此規範文件的至少一個聲明範圍的半真實資料及情境(例如在聯測)。這些互操作結果要求被報告及被工作小組接受。

FMM 3 滿足FMM 2條件，而且此規範文件已被工作小组驗證應遵從的《Conformance Resource Quality Guidelines》；已經通過一輪正式投票；至少有10位來自至少3家機構不同的實作者提出意見，並造成至少一項實質性的改變。

FMM 4 滿足FMM 3條件，而且此規範文件已正式出版(例如：FHIR實作指引)，並已實際應用於多個雛型專案。同時，負責的工作小組同意此規範文件足夠穩定，在後續的非向下相容(non-backward compatible)的異動中需與實作者協商與諮詢。

FMM 5 滿足FMM 4條件，而且此規範文件於在FMM 1以上等級(意即：試用等級)的兩個正式出版品發佈週期中出版，並已實際應用於至少五套獨立的產品系統。

Normative(規範) 此規範文件已被認定為穩定。

TW Core IG 中所有Profiles的FMM等級如下：

  • 0.1.1版之10個 Profiles 屬 FMM 2：Condition、DiagnosticReport、Encounter、Medication、MedicationRequest、Observation、Organization、Patient、Practitioner、Procedure。
  • 0.2.0版 新增之12個 Profiles 屬 FMM 1：AllergyIntolerance、Bundle、Composition、ImagingStudy、DocumentReference、Location、Media、MedicationDispense、MedicationStatement、MessageHeader、Specimen、PractitionerRole。

    • 如何閱讀這個實作指引(IG)

    TW Core IG之網站架構圖如下圖所示。各功能說明如下：

    IG架構圖
    • 應用說明：TW Core IG介紹及背景說明。
    • 規範文件
      • 能力聲明 ：應用TW Core IG於建置業務目的使用的FHIR Server時，該FHIR Server必須及建議應該支援的操作功能。
      • 查詢參數及操作定義 ：查詢FHIR Server的Profiles時，針對各Profiles可使用的查詢參數及操作定義。
      • 邏輯模型 ：TW Core IG的所有邏輯模型(Logical Models)，各邏輯模型會定義相應情境下使用的所有資料欄位。為了便於實作者快速理解，資料欄位會使用易於理解的命名，實作者再透過邏輯模型中的功能頁籤「Mappings」瞭解各資料欄位實際使用本IG的哪個Profiles的哪個資料項目(element)。
      • FHIR Profiles及Extensions：
        • TW Core IG的所有Profiles之定義與範例及Extensions。
        • 各資料項目不同實作強制程度的Terminology。
        • 各資料項目的限制（Constraints）。
        • 查詢依據TW Core IG實作之FHIR Server的特定Profiles時，可使用的查詢參數。
        • 有哪些Profiles具有查詢參數以及Server必須支援哪些必要的查詢參數功能。
      • 專門術語 ：TW Core IG網站所使用的專門術語，包括代碼系統（Code Systems）及值集（Value Sets），內容主要依據全國專門術語服務平臺(TW terminology services)建置。
    • 範例：遵從TW Core IG所定義Profiles之範例。
    • 結構定義與範例檔下載：實作者若不偏好使用FHIR RESTful API驗證資料是否遵從Profiles，可直接下載所需的格式驗證檔，包括XML、JSON及Turtle三種格式，亦可於此下載完整範例。
    • 安全性：主要說明採用TW Core IG網站進行實作時，有關資料存取授權的作法。
    • 驗證教學：如何驗證實作檔是否遵從TW Core IG規範。
    • 版本異動：若TW Core IG網站的版本有所異動，皆可透過異動說明頁得以瞭解版本間的異動差異。

    專有名詞定義

    Profiles相關

    英文名 中文名 說明
    Name 名稱 resource的資料項目名稱(意即XML元素名稱；JSON或RDF屬性名稱)。有些名稱末端為[x]，圖示為multipleBirth[x]範例，意即可以選擇適用的資料類型表述該資料項目內容值,故需依據資料類型填入適當的內容值，例如Patient.multipleBirth[x]。
    multipleBirth[x]範例
    如果系統只知病人是否多胞胎，則資料項目名稱為multipleBirthBoolean，內容值為「true」；如果系統中有病人多胞胎之出生順序為第2序位，則資料項目名稱為multipleBirthInteger，內容值為「2」。更多符號說明，請參閱FHIR官網相關說明。
    Flags 標記 一組有關影響實作者如何操作資料項目的資訊，範例如下。
    A MustSupport image 必須支援(MustSupport)，表示用戶端(Client)所傳送之資料項目，伺服端(Server)必須有能力接收並儲存此資料項目。繼承使用時可再依據專案需求，對MS做出延伸定義，但必須於應用說明說明其延伸定義的具體說明。詳可參閱MustSupport。
    A modifier image 表示此資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。詳可參閱Modifier。
    A summary searches image 表示此資料項目為摘要的一部分，詳可參閱Summary searches。
    A contraint image 表示此資料項目受規範設定的限制(constraints)影響，例如：Patient.name的限制為「name.text(完整中文姓名)」或name.family(英文姓)或者兩者必須填寫」，詳可參閱Constraints。
    constraints
    Card. 基數 此資料項目允許出現在這個resource的最小至最大次數，意即例如某一資料項目的基數若為0..1，表示可不填寫或至多填入1筆；若為1..1，表示必須(只能)填入1筆；若為0..*，表示可不填寫或填入多筆(不限筆數)；若為1..*，表示至少要填入1筆或填入多筆(不限筆數)。
    Type 資料型別 資料項目的資料型別(可超連結至該型別的定義)，例如：boolean、integer、dateTime等。
    Description &Constraints 描述與限制 此資料項目的描述及詳細的限制。尤其編碼的資料項目可使用何種代碼填寫，如果有特定需要綁定的的代碼，則會以Binding陳述。

    限制與綁定值集(ValueSet)

    如下圖所示，Patient.name的限制為「name.text(完整中文姓名)」或name.family(英文姓)或者兩者必須填寫」；Patient.name.use要求使用NameUse這個值集，而且要求使用(Required)使用該值集中的任一代碼，TW Core Patient規定必須填入「official」。 constraints

    綁定值集(value set)的強度

    英文名 中文名 說明
    Required 要求使用 應填入值集中的其中一個代碼
    Extensible 可擴充 應填入值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
    Preferred 鼓勵使用 鼓勵使用值集中的代碼，但不強制一定要使用此值集，你也可使用其他值集的代碼或單純以文字表示。
    Example 範例 可參考值集，但此值集只是針對這個欄位的一個可能值的範例，不預期也不鼓勵使用者一定要使用此值集的代碼。
    如下圖所示，telecom.system應使用ContactPointSystem代碼表(或稱代碼系統)中的其中一個代碼，telecom.use及gender也都有應該搭配使用的代碼表，否則以此IG驗證格式時會出現錯誤訊息。
    required examples

    遵從度用語(Conformance Language)，或可理解為「應遵從規範的程度」

    FHIR使用RFC 2119中定義的遵從度動詞必須(SHALL)、建議應該(SHOULD)和可能可以(MAY)。而FHIR與RFC 2119不同的是，FHIR允許不同的應用程式因使用可選功能的方式而無法達到可互操作性，特別是：

    1. 必須(SHALL)：所有實作絕對要遵從要求。

    2. 必須沒有(SHALL NOT)：所有實作絕對禁止的要求。

    3. 建議應該(SHOULD)/建議不應該(SHOULD NOT)：實作者在特定實作的情境下考慮的最佳或建議實作方法；雖然忽略一個項目可能有正當理由，但在選擇不同的程序之前，必須了解並慎重衡量所有含義。

    4. 可能可以(MAY)：這是實作者真正可選的要求；可根據實作者的決定使用或不使用，不會造成任何影響。

    FHIR發佈和版本劃分

    (資料來源：Versions - FHIR v4.3.0 (hl7.org))

    FHIR的新版本的發佈週期約為18-24個月，此頻率主要基於需向實作者諮詢、開發和審查新內容、以及ANSI批准的標準所需的正式投票和核對過程所需的時間，這個發佈週期也確保了有機會將實作者對標準規範早期版本的回饋意見納入後續版本，在滿足實作者需求的情況下，偶爾也會出現時間較短的有限範圍的發佈。

    每個新版本都有一個獨特的版本號。FHIR的版本政策是基於Semantic versioning(或可閱讀下表精簡整理)，但由於FHIR是一個標準規範，而不是一個軟體API，因此有一些區別。

    Major 當你對API進行不相容的修改時
    Minor 當你以向下相容的方式增加功能時
    Patch 你進行向下相容的錯誤修復時

    FHIR有單一的開發版本，它經由HL7管理的開發週期，每個主要的開發週期都透過正式投票（或不止一次）後才發佈新的標準規範。從版本控管的角度來看，每份發佈的標準規範都是開發主幹的一個分支，然後隨著HL7對發佈的標準規範的維護，其本身可能會發生進一步的改變（儘管這種改變通常是最小的，僅限於必要的技術修正或安全警示）。

    每個FHIR版本由4個部分組成的字串來識別：major.minor.patch-label。 IG的實作亦遵循此規則，其中的major異動將由「電子病歷交換標準工作小組」決定，minor及patch可由相關工作小組討論後作調整：

    版本 定義 可能時機
    major 當HL7將FHIR作為一個重要的新規格版本發佈時，如FHIR試用版(Trial Use)或標準規範版(Normative)，就會增加此序號。
    ● 第1次的試用版(Trial Use)是第0版 以0.1.0開始進行版本控管
    ● 第2次發行（DSTU）是第1版 當所有profiles為FMM2時
    ● 第3次發行（STU）是第3版（依據實作者要求以統一major序號故跳過「2」） 當所有profiles為FMM3時
    ● 第4次發行（Normative + STU）是第4版 當所有profiles為FMM4時
    ● 第5次發行（STU）是第5版 當所有profiles為FMM5時
    minor 包括微小實質改變的修改（可能包括有限的破壞性改變） 在既有版本上，新增StructureDefinition內容時
    ● 只要有新版本(major)發佈，minor就重置為0，而在開發分支中為1。
    ● HL7不會對已發佈的版本進行重大改變(技術性修正)，所以這些版本總是有一個版本號X.n.0。
    ● 開發中的版本是持續分析、辯論、投票和反復修改，因此可預期STU內容可能會有改變。 FHIR第4B版（僅STU改變）為4.3.0版本。
    patch 表示更新，包括對先前版本的技術性修正 針對既有版本的StructureDefinition作修改及刪除時
    ● 只要minor版本改變，patch就會被重置為0例如：4.0.1代表對4.0.0版本的第一次技術性修正 。
    label 版本末端有一個標籤，代表一個正在建立的標準規範的 「工作 」版本，並正在建立到指定的發行版本；例如，5.0.0-ballot1、5.0.0-snapshot2等。 目前仍持續在修訂與新增TW Core IG內容，故label為cibuild。
    ● 標籤前端的序號表示在投票、審查結束後的「預期」版本序號。
    ● label可以是任何字串，然而典型的標籤是：
    ○ 「snapshotN」：由於聯測(connectathon)、投票相依性或其他原因，標準規範的凍結版本。
    ○ 「ballotN」：在投票過程中使用的凍結版本。
    ○ 「draftN」：為非投票審查或QA而發佈的凍結版本。
    ○ 「cibuild」：一個 「特殊」的版本標籤，指的是一個非穩定的版本，隨著每次提交而改變。

    作者與貢獻者

    角色 貢獻版次 機構名稱 姓名 所屬單位 聯絡方式
    作者 v0.1.1、v0.2.0 衛生福利部智慧健康雲專案辦公室
    (Smart Health Cloud Project Mgmt. Office, Ministry of Health and Welfare)    		 李麗惠(Li-Hui Lee) 國立臺北護理健康大學－健康事業管理系
    (Department of Health Care Management, National Taipei University of Nursing and Health Sciences)    		 cclhlee@gmail.com
    cclhlee@ntunhs.edu.tw
    作者 v0.1.1、v0.2.0 曾鈺珈(Yu-Jia Tseng) yujia151645@gmail.com
    102116007@ntunhs.edu.tw
    作者 v0.1.1、v0.2.0 林伃瑤(Yu-Yao Lin) a28485251@gmail.com
    082114224@ntunhs.edu.tw
    作者 v0.2.0 李奇安(Chi-An Lee) ec460520@gmail.com
    072114216@ntunhs.edu.tw
    貢獻者 v0.1.1 歐陽渝(Yang-Yu Ou) ouyangyu0326@gmail.com
    貢獻者 v0.1.1、v0.2.0 連中岳(Chung-Yueh Lien) 國立臺北護理健康大學－資訊管理系
    (Department of Information Management, National Taipei University of Nursing and Health Sciences)    		 chungyueh@ntunhs.edu.tw
    貢獻者 v0.1.1 徐建業(Chien-Yeh Hsu) cyhsu@ntunhs.edu.tw
    貢獻者 v0.1.1 陳欣怡(Hsin-Yi Chen) c86976@gmail.com
    貢獻者 v0.1.1 郭俐君(Li-Chun Kuo) lily220487@gmail.com
    貢獻者 v0.1.1 丁子芸(Tzu-Yun Ting) aewqoo832456@gmail.com
    貢獻者 v0.2.0 陳杏宜(Hsin-Yi Chen) bii901231@gmail.com
    貢獻者 v0.2.0 蔡姍紜(Shan-Yun Tsai) appletsai319@gmail.com
    貢獻者 v0.2.0 黃睿駿(Hrui-Jun Huang) a27114171@gmail.com
    貢獻者 v0.1.1 李祥豪(Siang-Hao Lee) 康統醫學科技股份有限公司(KENKONE) shvoidlee@gmail.com
    貢獻者 v0.1.1、v0.2.0 李修安(Hsiu-An Lee) 國家衛生研究院 - 癌症研究所
    (National Health Research Institutes - The National Institute of Cancer Research)    		 billy72325@gmail.com
    貢獻者 v0.2.0 劉貞沂 (Zhen-Yi Liu) 國家衛生研究院 - 癌症研究所
    (National Health Research Institutes - The National Institute of Cancer Research)    		 ceo@sita.tech
    貢獻者 v0.2.0 燕洛嫺 (Luo-Xian Yan) 社團法人台灣醫學資訊學會
    (Taiwan Association for Medical Information)    		 ceo@sita.tech
    貢獻者 v0.1.1 MI-TW臺灣醫學資訊聯測
    (Medical Informatics Taiwan Connectathon, MI-TW Connectathon)    		 楊宇凡 (Lorex L. Yang) 矽塔資訊服務有限公司 (Sitatech) ceo@sita.tech