臺灣血液透析實作指引 (TW HD IG)
0.0.2 - ci-build Taiwan, Province of China flag

臺灣血液透析實作指引 (TW HD IG) - Local Development build (v0.0.2) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Artifacts Summary

This page provides a list of the FHIR artifacts defined as part of this implementation guide.

Behavior: Capability Statements

The following artifacts define the specific capabilities that different types of systems are expected to have in order to comply with this implementation guide. Systems conforming to this implementation guide are expected to declare conformance to one or more of the following capability statements.

血液透析交換伺服器能力聲明 (HD Server Capability Statement)

宣稱符合本實作指引之 FHIR 伺服器,於「透析病例交換」情境下具備的能力(kind=requirements)。 涵蓋:文件型 Bundle 之收發、各 profiled 資源之讀取/查詢/建立,以及應支援之標準查詢參數。 互動標註原則:必須=read / search-type;建議=create / update(依交換方向而定)。

Structures: Logical Models

These define data models that represent the domain covered by this implementation guide in more business-friendly terms than the underlying FHIR resources.

透析病例交換 (Hemodialysis Case Exchange)

透析病例交換之概念性業務資料結構(邏輯模型,kind=logical)。

本模型規範一份血液透析病例交換文件(文件型 Bundle,type=document)應包含哪些內容: 以 HemodialysisComposition 為文件骨架, 其各章節 entry 參照下列本 IG 之 profiled 資源。所有基礎資源皆衍生自 TW Core IG,確保可通過 TW Core 驗證。

實際交換時以 HemodialysisDocumentBundle 打包。

Structures: Resource Profiles

These define constraints on FHIR resources for systems conforming to this implementation guide.

一般狀況評估 (HD General Status)

血液透析病患一般工作/生活狀況評估。

原發腎臟疾病 (HD Primary Renal Disease)

導致末期腎病、需血液透析之原發腎臟疾病診斷。對應 KiDiT『原發病大類/細類』。

合併症 (HD Comorbidity)

血液透析病患之合併症 / 共病。對應 KiDiT『合併症』與『其他系統性疾病』。

生活活動評估 (HD Functional Status)

血液透析病患生活活動評估(類 Karnofsky 量表)。

血液透析住出院 (HD Encounter)

血液透析病患之住出院紀錄。

  • 住院日期 / 出院日期 → period.start / period.end
  • 住院原因大類 / 細類 → reasonCode(KiDiT 本地分類 coding)
血液透析文件 Bundle (HD Document Bundle)

血液透析病歷之文件型 Bundle(type=document)。第一筆 entry 為 HemodialysisComposition, 其餘 entry 為文件所參照之各 profiled 資源。供整份病歷一次性交換。

血液透析檢驗 (HD Laboratory Observation)

血液透析病患之檢驗結果,衍生自 TW Core 檢驗結果 Observation。 每筆 KiDiT 檢驗項目對應一個 LOINC 代碼(見「資料對應」頁之 LOINC 對照表)。 若該檢驗區分透析前/後,請以 extension dialysisTiming 標記。

血液透析治療紀錄 (Hemodialysis Session)

單次血液透析治療紀錄。 透析前/後體重與血壓以 HDBodyWeight / HDBloodPressure Observation 表述, 並以 Observation.partOf 參照本 Session。

血液透析病患 (HD Patient)

血液透析病患基本資料,衍生自 TW Core Patient,對應 KiDiT「病患資料」。

對應說明:

  • 身分證號 → identifier:idCardNumber(系統 http://www.moi.gov.tw)
  • 病歷號 → identifier:medicalRecord(type MR)
  • 透析代號 → extension HDPatientDialysisId
  • 病患類別 / 狀態 / 教育程度 → 對應 extension
  • 性別 → gender、生日 → birthDate、婚姻 → maritalStatus
  • 連絡人 / 關係 → contact、地址 → address、電話 → telecom
血液透析病歷文件 (HD Composition)

血液透析病歷之文件骨架(Composition)。定義文件層級 metadata 與章節, 章節 entry 參照本 IG 之各 profiled 資源(病患/處方/治療/檢驗/診斷…)。

血液透析處方 (Hemodialysis Prescription)

病患之血液透析處方(標稱治療設定)。以 Procedure 表述其透析療程設定。 建議 code 採 SNOMED CT #302497006「Hemodialysis」,並以下列 extension 攜帶處方參數; 透析器以 usedReference 參照 Dialyzer Device。

血管通路處置 (Vascular Access Procedure)

血液透析血管通路之建立、介入或重建。對應 KiDiT「HD造管」。

血管通路血流量 (HD Access Flow)

透析幫浦血流量或血管通路血流量 (ml/min)。對應 KiDiT HD造管。

血管通路裝置 (Vascular Access Device)

血液透析血管通路裝置(AVF/AVG/導管)。

透析前後血壓 (HD Blood Pressure)

血液透析前/後之血壓。以 extension dialysisTiming 標記透析前或透析後。

透析器 (Dialyzer)

血液透析使用之透析器(人工腎臟)。type 採 KiDiT 透析器型號代碼,表面積以 extension 表述。

透析用藥 (HD Medication Statement)

血液透析病患用藥狀態(EPO、鐵劑、活性維他命 D、降血壓劑等)。 EPO 種類可於 medicationCodeableConcept 以 KiDiT EPO 代碼(epo-type)表述。

透析相關感染 (Dialysis Infection)

血液透析相關感染(含血管通路感染)。對應 KiDiT「感染」。

透析體重 (HD Body Weight)

血液透析相關體重(透析前 / 後、上次透析後、理想乾體重)。 code 採透析專用 LOINC(值集 HDBodyWeightVS:8347-7 透析前、8344-4 透析後、 8341-0 乾體重量測、8340-2 乾體重估計);value 以 kg(UCUM)表述。 「上次透析後體重」以 8344-4 搭配較早之 effective[x] 表示。

Structures: Extension Definitions

These define constraints on FHIR data types for systems conforming to this implementation guide.

EPO 劑量 (EPO Dose)

本次 EPO 劑量 (U)。對應 KiDiT 透析紀錄『EPO劑U』。

EPO 種類 (EPO Type)

本次使用之 EPO 種類。對應 KiDiT 透析紀錄『EPO種類』。

感染發生原因 (Infection Cause)

感染發生原因。對應 KiDiT 感染『發生原因』。

感染結果 (Infection Outcome)

感染治療結果。對應 KiDiT 感染『感染結果』。

感染菌種 (Infection Organism)

感染培養菌種。對應 KiDiT 感染『菌種』。

抗凝劑 (Anticoagulant)

透析使用之抗凝劑。對應 KiDiT HD處方『抗凝劑』。

抗凝劑初劑量 (Anticoagulant Initial Dose)

抗凝劑初劑量 (U)。對應 KiDiT HD處方『初劑量』。

抗凝劑維持劑量 (Anticoagulant Maintenance Dose)

抗凝劑維持劑量 (U/小時)。對應 KiDiT HD處方『維持劑量』。

教育程度 (Education Level)

病患教育程度。對應 KiDiT 病患資料『教育程度』。

是否使用 IV 鐵劑 (IV Iron Used)

本次透析是否使用靜脈鐵劑。對應 KiDiT 透析紀錄『是否使用IV鐵劑』。

是否具福保身分 (Social Welfare Insurance Status)

病患是否具福保身分。對應 KiDiT 病患資料『是否具福保身分』。

是否為原住民 (Indigenous Status)

病患是否具原住民身分。對應 KiDiT 病患資料『是否為原住民』。

本院開始治療日期 (First Dialysis Date at This Facility)

病患於本院開始透析治療之日期。對應 KiDiT 病患資料『本院開始治療日期』。

每次透析時間 (Duration Per Session)

每次透析時間 (小時)。對應 KiDiT HD處方『每次透析時間』。

每週次數 (Sessions Per Week)

每週透析次數。對應 KiDiT HD處方『每週次數』。

照護場域 (Care Setting)

本次透析之門診/住院。對應 KiDiT 透析紀錄『門診/住院』。

病患類別 (Patient Category)

病患費用類別(健保/自費)。對應 KiDiT 病患資料『病患類別』。

血液流速 (Blood Flow Rate)

處方血液流速 (ml/min)。對應 KiDiT HD處方『血液流速』。

血管通路型態 (Vascular Access Type)

血管通路型態(AVF/AVG/長期導管/短期導管)。對應 KiDiT HD造管。

血管重建方式 (Access Rebuild Method)

原有血管重建方式。對應 KiDiT HD造管『原有血管重建方式』。

輸血量 (Transfusion Volume)

本次透析輸血量 (mL)。對應 KiDiT 透析紀錄『輸血量』。

透析代號 (Dialysis ID)

病患於透析登錄系統之透析代號。對應 KiDiT 病患資料『透析代號』。

透析器表面積 (Dialyzer Surface Area)

透析器(人工腎臟)膜表面積 (m2)。對應 KiDiT HD處方『透析器表面積』。

透析方式 (Dialysis Modality)

血液透析治療方式。對應 KiDiT HD處方『透析方式』。

透析時間點 (Dialysis Timing)

標記本測量值相對於血液透析療程之時間點(透析前/後)。對應 KiDiT 之『透析前/透析後』欄位前綴。

透析液流速 (Dialysate Flow Rate)

處方透析液流速 (ml/min)。對應 KiDiT HD處方『透析液流速』。

透析液鈣離子濃度 (Dialysate Calcium)

透析液鈣離子濃度 (meq/L)。對應 KiDiT HD處方『鈣離子濃度』。

透析液鉀離子濃度 (Dialysate Potassium)

透析液鉀離子濃度 (meq/L)。對應 KiDiT HD處方『鉀離子濃度』。

透析液鹼基 (Dialysate Base)

透析液鹼基。對應 KiDiT HD處方『鹼基』。

透析狀態 (Dialysis Status)

病患透析治療狀態(長期HD/PD/移植/轉院/死亡等)。對應 KiDiT 病患資料『狀態』。

通路側別 (Access Side)

血管通路所在側別(左/右)。對應 KiDiT HD造管『左右』。

通路失敗原因 (Access Failure Reason)

血管通路失敗原因。對應 KiDiT HD造管『血管通路失敗原因』。

重大傷病卡號 (Catastrophic Illness Card No.)

病患重大傷病卡號。對應 KiDiT 病患資料『重大傷病卡號』。

首次治療日期 (First Dialysis Date)

病患(不限院所)首次接受透析治療之日期。對應 KiDiT 病患資料『首次治療日期』。

Terminology: Value Sets

These define sets of codes used by systems conforming to this implementation guide.

ABO 血型 值集 (abo-blood-group-vs)

ABO 血型。

EPO 種類 ATC (Erythropoiesis-Stimulating Agent)

紅血球生成素 (EPO/ESA) 之 WHO ATC 代碼。

EPO 種類 值集 (epo-type-vs)

紅血球生成素 (EPO) 種類。

一般狀況評估 值集 (general-status-vs)

一般工作/生活狀況評估。

住院原因大類 值集 (admission-reason-major-vs)

住院原因大類 (A–T)。

住院原因細類 值集 (admission-reason-vs)

住院原因細類。

其他系統性疾病 值集 (systemic-disease-vs)

併存之其他系統性疾病(複選)。

動靜脈廔管位置 值集 (fistula-location-vs)

動靜脈廔管位置(前臂/上臂/大腿/小腿/其他)。

原發病大類 值集 (primary-renal-disease-major-vs)

末期腎病原發病大類 (A–I)。

原發病細類 值集 (primary-renal-disease-vs)

末期腎病原發病細類。

合併症 值集 (comorbidity-vs)

透析病患之合併症(複選)。

導管置入位置 值集 (catheter-location-vs)

長期/短期導管置入位置(內頸/鎖股下/股靜脈/其他)。

尿毒症狀 值集 (uremic-symptom-vs)

合併之尿毒症狀(複選)。

感染發生原因 值集 (infection-cause-vs)

感染發生原因。

感染種類 值集 (infection-type-vs)

透析相關感染種類。

感染結果 值集 (infection-outcome-vs)

感染治療結果。

感染菌種 SNOMED CT (Organism)

感染培養菌種之 SNOMED CT(Organism 階層,intensional,依實際培養結果逐例編碼);含『無菌長出 No growth』。

感染菌種 值集 (infection-organism-vs)

感染培養之菌種(含群組標頭,需人工複核)。

抗凝劑 ATC (Anticoagulant)

透析抗凝劑之 WHO ATC 代碼;『不使用』以 SNOMED CT #260413007 表述。

抗凝劑 值集 (anticoagulant-vs)

透析使用之抗凝劑。

教育程度 v3 (Education Level)

病患教育程度之 HL7 v3 EducationLevel 代碼。

教育程度 值集 (education-level-vs)

病患教育程度。

照護場域 ActCode (Care Setting)

門診 / 住院之 HL7 v3 ActCode。

物質 SNOMED CT (Substance)

透析液鹼基等物質之 SNOMED CT(Substance 階層)。

生活活動評估 值集 (functional-status-vs)

生活活動評估(類 Karnofsky 量表 10–100)。

病患類別 值集 (patient-category-vs)

健保 / 自費 等病患類別。

病毒標記檢驗結果 值集 (viral-marker-result-vs)

HBsAg / Anti-HCV 檢驗結果 (陽性/陰性/未做)。

糖尿病型式 值集 (dm-type-vs)

糖尿病型式 (IDDM/NIDDM)。

緊急透析原因 值集 (emergency-dialysis-reason-vs)

緊急透析原因(複選)。

職業 值集 (occupation-vs)

病患職業別。

處置 SNOMED CT (Procedure)

血管通路重建方式等處置之 SNOMED CT(Procedure 階層)。

血管通路型態 SNOMED CT (Vascular Access Type)

血管通路型態之 SNOMED CT 代碼(廔管 / 人工血管 / 透析導管)。長期與短期導管皆對應 #397849009。

血管通路型態 值集 (hd-vascular-access-type-vs)

血液透析血管通路型態。

血管通路失敗原因 值集 (access-failure-reason-vs)

血管通路失敗原因。

血管通路左右 值集 (access-side-vs)

血管通路所在側別 (左/右)。

血管重建方式 值集 (access-rebuild-method-vs)

原有血管之重建方式。

透析器型號對應 (Dialyzer Model) 值集 (dialyzer-model-vs)

透析器(人工腎臟)廠牌與型號對應代碼。

透析方式 SNOMED CT (Dialysis Modality)

血液透析治療方式之 SNOMED CT 代碼。

透析方式 值集 (dialysis-modality-vs)

血液透析治療方式 (HD/HDF/PE 等)。

透析時間點 值集 (hd-dialysis-timing-vs)

透析前/後測量時間點。

透析液鹼基 值集 (dialysate-base-vs)

透析液鹼基 (Acetate/Bicarbonate/Lactate)。

透析照護場域 值集 (hd-care-setting-vs)

門診/住院。

透析狀態 SNOMED CT (Dialysis Status)

長期透析 / 移植 / 死亡等狀態之 SNOMED CT 代碼(僅涵蓋有對應者)。

透析狀態 值集 (dialysis-status-vs)

病患透析治療狀態(長期HD/PD/移植/轉院/死亡等)。

透析適應症種類 值集 (dialysis-indication-vs)

開始透析之適應症種類。

透析體重量測 LOINC (HD Body Weight)

血液透析體重量測之 LOINC:透析前 / 後體重與乾體重(量測 / 估計)。

通路側別 SNOMED CT (Access Side)

血管通路所在側別(左 / 右)之 SNOMED CT 代碼。

連絡人關係 值集 (contact-relationship-vs)

緊急連絡人與病患之關係。

鐵劑給藥途徑 值集 (iron-route-vs)

鐵劑給藥途徑 (口服/IV/兩者)。

Terminology: Code Systems

These define new code systems used by systems conforming to this implementation guide.

ABO 血型 (abo-blood-group)

ABO 血型。

EPO 種類 (epo-type)

紅血球生成素 (EPO) 種類。

一般狀況評估 (general-status)

一般工作/生活狀況評估。

住院原因大類 (admission-reason-major)

住院原因大類 (A–T)。

住院原因細類 (admission-reason)

住院原因細類。

其他系統性疾病 (systemic-disease)

併存之其他系統性疾病(複選)。

動靜脈廔管位置 (fistula-location)

動靜脈廔管位置(前臂/上臂/大腿/小腿/其他)。

原發病大類 (primary-renal-disease-major)

末期腎病原發病大類 (A–I)。

原發病細類 (primary-renal-disease)

末期腎病原發病細類。

合併症 (comorbidity)

透析病患之合併症(複選)。

導管置入位置 (catheter-location)

長期/短期導管置入位置(內頸/鎖股下/股靜脈/其他)。

尿毒症狀 (uremic-symptom)

合併之尿毒症狀(複選)。

感染發生原因 (infection-cause)

感染發生原因。

感染種類 (infection-type)

透析相關感染種類。

感染結果 (infection-outcome)

感染治療結果。

感染菌種 (infection-organism)

感染培養之菌種(含群組標頭,需人工複核)。

抗凝劑 (anticoagulant)

透析使用之抗凝劑。

教育程度 (education-level)

病患教育程度。

生活活動評估 (functional-status)

生活活動評估(類 Karnofsky 量表 10–100)。

病患類別 (patient-category)

健保 / 自費 等病患類別。

病毒標記檢驗結果 (viral-marker-result)

HBsAg / Anti-HCV 檢驗結果 (陽性/陰性/未做)。

糖尿病型式 (dm-type)

糖尿病型式 (IDDM/NIDDM)。

緊急透析原因 (emergency-dialysis-reason)

緊急透析原因(複選)。

職業 (occupation)

病患職業別。

血管通路型態 (Vascular Access Type)

血液透析血管通路型態。對應 KiDiT HD造管之自體/人工動靜脈廔管、長期/短期導管。

血管通路失敗原因 (access-failure-reason)

血管通路失敗原因。

血管通路左右 (access-side)

血管通路所在側別 (左/右)。

血管重建方式 (access-rebuild-method)

原有血管之重建方式。

透析器型號對應 (Dialyzer Model) (dialyzer-model)

透析器(人工腎臟)廠牌與型號對應代碼。

透析方式 (dialysis-modality)

血液透析治療方式 (HD/HDF/PE 等)。

透析時間點 (HD Dialysis Timing)

標記測量值相對於血液透析療程的時間點(透析前/透析後/上次透析後/乾體重)。

透析液鹼基 (dialysate-base)

透析液鹼基 (Acetate/Bicarbonate/Lactate)。

透析照護場域 (HD Care Setting)

本次透析之照護場域(門診/住院)。對應 KiDiT 透析紀錄『門診/住院』。

透析狀態 (dialysis-status)

病患透析治療狀態(長期HD/PD/移植/轉院/死亡等)。

透析適應症種類 (dialysis-indication)

開始透析之適應症種類。

連絡人關係 (contact-relationship)

緊急連絡人與病患之關係。

鐵劑給藥途徑 (iron-route)

鐵劑給藥途徑 (口服/IV/兩者)。

Terminology: Concept Maps

These define transformations to convert between codes by systems conforming with this implementation guide.

EPO 種類對照表 (KiDiT → WHO ATC)

KiDiT『EPO 種類』本地碼對應 WHO ATC(ATC 將各 epoetin 統歸 B03XA01)。

抗凝劑對照表 (KiDiT → WHO ATC / SNOMED CT)

KiDiT『抗凝劑』本地碼對應 WHO ATC;『不使用』對應 SNOMED CT #260413007。

教育程度對照表 (KiDiT → HL7 v3 EducationLevel)

KiDiT『教育程度』對應 HL7 v3 EducationLevel(『1 無』無對應碼)。

照護場域對照表 (KiDiT → HL7 v3 ActCode)

KiDiT『門診/住院』對應 HL7 v3 ActCode。

血管通路型態對照表 (本地 → SNOMED CT)

本地血管通路型態代碼對應 SNOMED CT。SNOMED 無長期 / 短期導管之分,皆對應 Dialysis catheter。

透析方式對照表 (KiDiT → SNOMED CT)

KiDiT『透析方式』本地碼對應 SNOMED CT。

透析狀態對照表 (KiDiT → SNOMED CT)

KiDiT『狀態』對應 SNOMED CT(僅涵蓋有對應者;未歸類 -/./⁄/0、轉院 5、痊癒 6、放棄 7、不明原因退出 8 無國際對應)。

通路側別對照表 (KiDiT → SNOMED CT)

KiDiT『左右』對應 SNOMED CT 側別。

Example: Example Instances

These are example instances that show what data produced and consumed by systems conforming with this implementation guide might look like.

範例:住院(血管通路功能不良)

虛構之住出院範例。

範例:原發腎臟疾病(糖尿病腎病變)

虛構之原發腎臟疾病範例。

範例:導管出口處感染

虛構之透析相關感染範例。

範例:檢驗 - 血色素 (Hb)

虛構之透析前血色素檢驗範例。

範例:理想乾體重

虛構之理想乾體重範例。

範例:生活活動評估

虛構之生活活動評估範例。

範例:自體動靜脈廔管建立

虛構之血管通路造管範例。

範例:血液透析文件 Bundle

虛構之血液透析病歷 document Bundle,首筆為 Composition,其餘為被參照之資源。

範例:血液透析治療紀錄

虛構之單次透析治療紀錄範例。

範例:血液透析病患 王小明

虛構之血液透析病患範例。

範例:血液透析病歷文件 (Composition)

虛構之血液透析病歷文件骨架。

範例:血液透析處方

虛構之血液透析處方範例。

範例:透析器 Asahi Rexeed-15L

虛構之透析器裝置範例。

範例:透析院所

虛構之透析院所,作為文件作者。