HL7 FHIR 模組說明 - Level 4 Medications - Medication

 官方文件： 

• http://www.hl7.org/fhir/medication.html (R4)
• http://hl7.org/fhir/2021May/medication.html (R5)

簡述：

淺顯易懂，就是放藥品資訊的地方。注意，他沒有服藥相關資訊，就是單純的代表一種藥的編碼，廠商、樣式、成分、包裝，批量等資訊。

欄位討論：

• code [0..1]: CodeableConcept
• 藥品代碼。
• 可以用來當作藥品代碼的編碼系統有很多。其中以RxRorm較多。
• 參考：SNOMED CT Medication Codes (Example)
• http://snomed.info/sct 
• concept is-a 410942007 (Drug or medicament)
• concept is-a 373873005 (Pharmaceutical / biologic product)
• concept is-a 106181007 (Immunologic substance)
• status [0..1]: code
• 此藥品狀態。
• 限定：Medication status codes (Required#{active | inactive | entered-in-error}
• {可用，不可用，輸入有錯}
• manufacturer [0..1]: Reference(Organization)
• 製造生產商。
• form [0..1]: CodeableConcept
• 藥品形式。粉末、錠、膠囊等。
• 參考：SNOMED CT Form Codes (Example)
• http://snomed.info/sct 
• concept is-a 421967003 (Drug dose form)
• amount [0..1]: Ratio
• 每一份包裝的數量。
• 注意，他的資料型態是Ratio，就會有分子與分母。若為每一份，所以分母為1。
• Ingredient [0..*]: BackboneElement
• 藥品成分清單。
• 欄位討論：
• item[x] [1..1]: {CodeableConcept | Reference(Substance | Medication)}
• 成分代碼。
• 像複方藥，成分也可能是藥。
• IsActive [0..1]: boolean
• 是否可用。
• Strength [0..1]: Ratio
• 強度。此成分所佔的比率。
• batch [0..1]: BackboneElement
• 批量相關資訊。
• 欄位討論：
• lotNumber [0..1]: string
• 批量序號。
• expirationDate [0..1]: dateTime
• 到期日

HL7 FHIR 模組說明 - Level 4 Medications - MedicationRequest - Dosage

延續前一篇提到MedicationRequest.dosageInstruction的資料型態是Dosage。他有點複雜，需要專頁來說明。其實，他並不適合放在這，Dosage在R4，他是被很尷尬的獨立成一篇。

到了R5，重新架構了資料型態，將Dosage歸入Special Purpose Types中(R4是隱晦在文件中)，感覺就舒服多了。

言歸正傳，這邊討論的是R4版本。其實與R5就欄位內容是一樣的，只是R4是繼承BackboneElement，而R5是繼承BackboneType(實際上就是Element)。至於兩者有何差異，不在本篇討論範圍。(迫不及待想知道，那就參考R5的Type Framework)。

====================================

官方文件：Dosage - FHIR v4.0.1 (hl7.org)

簡述：

關於藥物服用的指引。

欄位討論：

• sequency [0..1]: integer
• MedicationRequest.dosageInstruction是[0..*]，表示一張MequestionRequest所要求的一種藥，可以有多筆用藥說明。
• 這個欄位就是用來當序號的。
• text [0..1]: string
• 非結構描述用藥資訊。
• additionalInstruction [0..*]: CodeableConcept
• 關於服用此藥物的注意事項或指引。
• 參考：SNOMED CT Additional Dosage Instructions (Example) 
• Code System http://snomed.info/sct
• Concept is-a 419492006
• 例如：
• 311504000  With or after food
• 418639000  Warning. May cause drowsiness
• 419303009  With plenty of water
• patientInstruction [0..1]: string
• 針對此病患提供額外服藥指引。
• timing [0..1]: Timing
• 服藥資訊與時間有關者。
• Timing這個資料型態在R4比Dosage更尷尬。他是被放在General-Purpose DataType中，卻是唯一繼承於BackboneElement者。
• 到了R5，就與Dosage一樣，繼承於BackboneType。但是，仍放在General-Purpose DataType。
• 為什麼？因為BackboneElement已經不繼承於DataType而是直接繼承於Element。
• 這個資料型態有點複雜，可參考之前的文章HL7 FHIR 資料型態篇 - Complex Types - 時間類。
• asNeeded[x] [0..1] {Boolean | CodeableConcept}
• 註記此要是否為需要時才服用。而非定時服用。
• 若能提供更清楚原因時，可參考：SNOMED CT Medication As Needed Reason Codes (Example)
• Code System http://snomed.info/sct
• Concept is-a 404684003
• 例如：
• 122003  Choroidal hemorrhage
• 184004  Withdrawal arrhythmia
• site [0..1]: CodeableConcept
• 身體的哪個部位來接收此藥物。
• 參考：SNOMED CT Anatomical Structure for Administration Site Codes (Example)
• Code System http://snomed.info/sct
• Concept is-a 91723000 (Anatomical structure)
• route [0..1]: CodeableConcept
• 使用什麼途徑將藥進入身體(在什麼地方，就看site)。
• 參考：SNOMED CT Route Codes (Example)
• Code System http://snomed.info/sct
• Concept is-a 284009009 (Route of administration values)
• 例如：
• 26643006  Oral use
• 47625008  Intravenous use
• method [0..1]: CodeableConcept
• 以什麼方法技術來使用藥進行服藥。 
• 參考：SNOMED CT Administration Method Codes (Example)
• Code System http://snomed.info/sct
• Concept is-a 422096002 (Dosing instruction fragment)
• 例如：
• 419747000 Chew
• 421521009 Swallow
• 421538008 Instill
• 422145002 Inject
• 421682005 Dissolve
• doseAndRate [0..*]: Element
• 服藥資訊與數量/速率有關者。
• 注意他的資料型態是Element。而非常見的BackboneElement。
• 欄位討論：
• type [0..1]: CodeableConcept
• 數量/速率的值是怎麼來的。
• 參考：DoseAndRateType (Example)
• Code System http://terminology.hl7.org/CodeSystem/dose-rate-type
• Concept is calculated
• Concept is ordered
• dose[x] [0..1]: { Range | SimpleQuantity }
• 每一劑的使用數量(可數)。
• 是範圍值，還是特定值。
• 每一個值要提供單位。常用之Code System為http://unitsofmeasure.org。
• rate[x] [0..1]: {Ratio | Range | SimpleQuantity}
• 每一劑使用之速率(不可數)
• 例如掉點滴。
• maxDosePerPeriod [0..1]: Ratio
• 每單位時間內的最大劑量
• maxDosePerAdministrtion [0..1]: SimpleQuantity
• 每次服藥之最大劑量。
• maxDosePerLifetime [0..1]: SimpleQuantity
• 病患此身最大使用劑量。

HL7 FHIR 模組說明 - Level 4 Medications - MedicationRequest

官方文件：http://hl7.org/fhir/medicationrequest.html。

簡述：

這個其實不能被視為等同開立處方籤，因為我們對處方籤的概念是一張單子上，會列出很多筆藥。依據欄位內容定義，Medication[1..1]僅能描述一種藥，所以，他是醫師開立一項藥品的請求單。

他會經由EMR系統啟動一系列的流程，進而產生其他的本系列有關之Resource。

欄位討論：

• 他繼承於DomainResource。（大部分的Resource都會繼承於DomainResource，但有些不是，例如Bundle，Binary...。）

• status [1..1]: code
• 限定：Medicationrequest status (Required) --> http://hl7.org/fhir/ValueSet/medicationrequest-status#{active | on-hold | cancelled | completed | entered-in-error | stopped | draft | unknown}
• 從CDS Hooks的角度來說，開立一張訂單，要經過查核後才能確認。此時，收到MedicationRequest的狀態就會是draft。active是指此Request可能還有些步驟未完成。Completed表示所有步驟接已完成。
• intent [1..1]: code
• 限定：Medication request intent (Required) --> http://hl7.org/fhir/ValueSet/medicationrequest-intent#{proposal | plan | order | original-order | reflex-order | filler-order | instance-order | option}
• 這份Request的意圖。一般而言，都是放order。
• category [0..*]: CodeableConcept
• 此Resource用於何處。
• 參考：Medication request category codes (Example)  --> http://terminology.hl7.org/CodeSystem/medicationrequest-category。
• 門診、住院、社區照護、出院。
• priority [0..*]: code
• 此Resource的優先序。
• 限定：Request priority (Required) --> http://hl7.org/fhir/ValueSet/request-priority#{routine | urgent | asap | stat}
• {常規 | 緊急 | 愈快愈好 | 立刻} 低-->高
• doNotPerform [0..1]: boolean
• 若為true，反而是告知此MedicationRequest不要執行。
• reported[x] [0..1]: {boolean | Reference(Patient | Practitioner | PractitionRole | RelatedPerson | Organization)}
• 設定此MedicationRequest是報告，而非主要紀錄。
• 主要紀錄是當時情境。報告是事後情境，那就會有一份引發此報告的來源。 
• medication[x] [1..1]: {CodeableConcept | Reference(Medication)}
• 這份MedicationRequest所指稱的藥品資料。
• 因為是Choice資料型態，所以要注意抓回來的是哪一種資料型態。
• 這個是依紀錄不同，千萬別以為同一台FHIR Server都會給固定資料型態。
• 無論哪種，最終目標還要抓到code。
• 但要注意，這個code是哪種sytem。
• 國外會用RxNorm。
• subject [1..1]: Reference(Patient | Group)
• 這份MedicationRequest為誰|那哪些人而申請的。
• Group類似Bundle的功能，用來打包其他Resource。但是有很大差異。Group只能打包固定六種類的東西(person | animal | practitioner | device | medication | substance)。可接受固定的Resource(Patient | Practitioner | PractitionerRole | Device | Medication | Substance | Group)
• encounter [0..1]: Reference(Encounter)
• encounter在國外的定義是很複雜。只要有醫病交流之情境，就可以產生一份Encounter，所以Encounter會有Location。很多個Encounter會衍生自同一個Appointment。
• 此處就是紀錄這份MedicationRequest是發生在哪一次的Encounter。
• supportingInformation [0..*]: Reference(Any)
• 其他有關開立處方之支持性資源。
• authoredOn [0..1]: dateTime
• 此MedicationRequest開立日期。
• requester [0..1]: Reference(Practitioner | PractitionerRole | Organization | Patient | RelatedPerson | Device)
• 提出此處方需求之來源。
• performer [0..1]: Reference(Practitioner | PractitionerRole | Organization | Patient | Device | RelatedPerson | CareTeam)
• 執行處方的人。
• 也就是會拿藥去餵subject的人。
• performerType [0..1]: CodeableConcept
• 適合來執行此處方的角色要求。
• 參考：Procedure Performer Role Codes (Example) -->  http://hl7.org/fhir/ValueSet/performer-role
• CodeSystem
• http://snomed.info/sct | 223366009(Healthcare professional)
• recorder [0..1]: Reference(Practitioner | PractitionerRole)
• 真正開立此MedicationRequest的人。
• 注意不要與requester混淆，這個是想要處方的人，所以才會有Patient。
• 而此處是有資格開立處方的人，當然只能是有醫師資格的人。
• reasonCode [0..*]: CodeableConcept
• 定義開立或不開立此藥的原因或指示。
• 參考：Procedure Performer Role Codes (Example) --> http://hl7.org/fhir/ValueSet/condition-code
• CodeSystem
• http://snomed.info/sct | 404684003 (Clinical finding)
• http://snomed.info/sct | #160245001 (No current problems or disability)
• reasonReference [0..*]: Reference(Condition | Observation)
• 用來支持證明需要開立這份MedicationRequest的Condition或Observation。
• 一般而言，這個Condition的category會是encounter-diagnosis。
• basedOn [0..*]: Reference(CarePlan | MedicationRequest | ServiceRequest | ImmunizationRecommendation)
• 是基於哪一個流程中所開立的MedicationRequestion。也就是，為了滿足哪一個流程而開立。
• dosageInstruction [0..*]: Dosage
• 如何服用此藥物的指示。
• Dodage資料型態有點複雜，得專頁說明。

P.S. 實在無法把所有欄位都描述說明。有些沒碰到過，還真不知道是幹嘛用的。我也不是/不能搞翻譯，就我所知盡量分享了。

HL7 FHIR 模組說明 - Level 4 Medications Module

本系列要討論的是FHIR Level 4 Medications 相關的Resource。

本系列的Resource主要用於：

• 處方籤相關流程，如開立、配藥、給藥、服藥等紀錄。
• 紀錄防疫，評估接種疫苗時間點等。
• 藥品資訊與用藥知識。

Resource 主要分成兩大類：Medications與Immunizations。

Medications 系列簡單地說就是：

開藥-->配藥-->服藥 

(MedicationRequest-->MedicationDispense-->MedicationAdministration)

藥資訊-->藥更多資訊

(Medication--> MedicationKnowledge)

在吃什麼藥

(MedicationStatement)

Immunizations系列簡單地說就是：

打疫苗前-->打了什麼疫苗-->打疫苗後

(ImmunizationRecommendation-->Immunization-->ImmunizationEvaluation)

說實在，要介紹Resource的內容，真的是吃力不討好。講多了像翻譯，講少了還不如自己去看。

所以，這系列僅會針對重要的欄位進行說明。一些背景知識，就不再多加說明。網路上搜尋，中文的資料也越來越多了。（我寫的東西，已經不在搜尋的前幾條中，這是好現象吧。）