This page is part of the 臺灣核心實作指引(TW Core IG) (v0.3.1: Releases) based on FHIR (HL7® FHIR® Standard) R4. This is the current published version in its permanent home (it will always be available at this URL). For a full list of available versions, see the Directory of published versions
Official URL: https://twcore.mohw.gov.tw/ig/twcore/StructureDefinition/MedicationStatement-twcore | Version: 0.3.1 | |||
Active as of 2024-10-22 | Computable Name: TWCoreMedicationStatement |
此臺灣核心-用藥聲明(TW Core MedicationStatement) Profile說明本IG如何進一步定義FHIR的MedicationStatement Resource以呈現用藥聲明的詳細資料。
病人正在用藥的紀錄。一份用藥聲明 (MedicationStatement) 可能表明病人目前正在、曾經或將來會使用藥品。此資訊的來源可能是病人、重要他人(如家庭成員或配偶)或臨床醫生。病人就診或住院期間的病史記錄過程是獲取此類資訊的常見場景。藥品資訊可能來自病人的記憶、處方瓶或病人、臨床醫師或其他方維護的藥品清單。
用藥聲明 (medication statement) 與給藥(medication administration)之間的主要區別在於:給藥具有完整的用藥資訊,並且基於實際由給藥者提供的用藥資訊為基礎。相對而言,用藥聲明通常較為籠統,不會具體記錄用藥的日期或時間,實際上,我們只知道有來源報告說病人目前正在服用這種藥品,但關於用藥的時間、劑量、比例甚至藥物產品的詳細資訊可能不完整、缺失或不太精確。正如前面所提到的,用藥聲明的資訊可能來自病人的記憶、處方瓶或病人、臨床醫生或其他人維護的藥品清單。相比之下,給藥紀錄則更為正式,包含了詳細的用藥資訊。
用藥聲明 (MedicationStatement) 的常見應用包括:
用藥聲明 (MedicationStatement) 可用於記錄物質濫用(substance abuse)或其他作用劑(agents)的使用,例如:煙草或酒精。需要這類紀錄的情境是當這些物質需要被包含在臨床決策支援系統的檢核中—像是藥物相互作用的檢核,它將被視為正在服用的藥品清單的一部分。若目標是為了紀錄社交史並加入額外資訊,像是戒菸的願望、每日使用量、及負面的健康影響,則建議將這些資訊記錄為檢驗檢查 (Observation),以便於後續填入社交史中。
這個resource本身不直接產生藥品清單,但它可以產生個人的用藥聲明,這些聲明後續可在 List resource 中被用來構建不同類型的藥品清單。值得注意的是,其他類型的藥品清單也可透過其他Pharmacy resources,像是MedicationRequest、MedicationAdministration來建立。
用藥聲明不屬於「開立處方 -> 調劑 -> 給藥」過程中的一部分,而是病人、其重要他人或臨床醫生所報告的情況,指出開立處方、調劑或給藥的一個或多個動作已經發生,從而認為病人正在使用、已經使用或將要使用某種特定的藥品。
從FHIR工作流程的視角來看,MedicationStatement是一個事件類型的resource——詳見Workflow Event。
用藥聲明 (MedicationStatement) resource 用於記錄病人報告的藥品或物質使用情況,包括正在使用、未使用、過去使用過或未來可能使用的。它也可用於記錄從其他記錄(如MedicationRequest)中衍生的藥品使用情況。該聲明不用於開立醫令請求藥品、供應品或設備。當需要請求藥品、供應品或設備,且有關於其使用的病人或指示時,應使用藥品請求(MedicationRequest)、供應品請求(SupplyRequest) 或設備請求(DeviceRequest)。
藥品領域包括多個相關resources
Resource | 說明 |
---|---|
MedicationRequest(藥品請求) | 一個關於供應藥品及病人服藥或用藥指示的醫令。 |
MedicationDispense(配藥或調劑藥品) | 提供一批藥品,旨在隨後由病人使用或服用(通常是回應處方)。 |
MedicationAdministration(給藥) | 當病人實際使用藥品或者以其他方式給予病人藥品時。 |
MedicationStatement (用藥聲明) | 這是一項紀錄,記錄了病人服用藥品或藥品已經給予病人,其中紀錄是基於病人或另一位臨床醫生的報告。藥品聲明不是「處方開立->配藥->給藥」過程中的一部分,而是一個報告,表明這樣的過程(或至少其一部分)確實發生了,從而認為病人已經接受了特定的藥品。 |
這個 resource 與藥品請求(MedicationRequest)、配藥或調劑藥品(MedicationDispense) 和給藥( MedicationAdministration) 不同。這些 resources 分別指向特定的事件 — 處方、藥品的具體提供或給藥。用藥聲明 (MedicationStatement) 是一個更廣泛的聲明,涵蓋更長的時間範圍,且與特定事件無關。任何前述三種類型的 resource 實例的存在,都可以用來推斷一份用藥聲明。然而,用藥聲明也可以基於其他資訊來取得,包括病人或護理人員的聲明、實驗室檢驗的結果等。
這個 resource 被醫療不良事件(AdverseEvent)、目標(Goal)、用藥聲明(MedicationStatement)和檢驗檢查(Observation)參照。
Usage:
Description of Profiles, Differentials, Snapshots and how the different presentations work.
This structure is derived from MedicationStatement
Name | Flags | Card. | Type | Description & Constraints | ||||
---|---|---|---|---|---|---|---|---|
MedicationStatement | 0..* | MedicationStatement | 病人正在服用的藥品紀錄 | |||||
id | 0..1 | id | 不重複的ID用以識別儲存在特定FHIR Server中的MedicationStatement紀錄,通常又稱為邏輯性ID。 | |||||
meta | 0..1 | Meta | 此MedicationStatement Resource的metadata | |||||
implicitRules | 0..1 | uri | 創建此內容所依據的一組規則 | |||||
language | 0..1 | code | 用以表述MedicationStatement Resource內容的語言。 Binding: CommonLanguages (preferred): 人類語言;鼓勵使用CommonLanguages代碼表中的代碼,但不強制一定要使用此代碼表,你也可使用其他代碼表的代碼或單純以文字表示。
Example Value: zh-TW | |||||
text | 0..1 | Narrative | MedicationStatement Resource之內容摘要以供人閱讀 | |||||
identifier | S | 0..* | Identifier | 用藥聲明的外部識別碼 | ||||
basedOn | 0..* | Reference(TW Core MedicationRequest | TW Core CarePlan | TW Core ServiceRequest) | 此用藥聲明是為了達成或實現哪個計劃、提案或醫令 | |||||
partOf | 0..* | Reference(MedicationAdministration | TW Core MedicationDispense | TW Core MedicationStatement | TW Core Procedure | TW Core Observation Laboratory Result) | 參照事件的一部分 | |||||
status | S | 1..1 | code | active | completed | entered-in-error | intended | stopped | on-hold | unknown | not-taken Binding: Medication Status Codes (required): 指明用藥聲明的當前狀態;應填入所綁定值集中的其中一個代碼 | ||||
statusReason | 0..* | CodeableConceptTW | 當前狀態的原因 Binding: SNOMEDCTDrugTherapyStatusCodes (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | |||||
category | S | 0..1 | CodeableConceptTW | 藥品使用的類型 Binding: Medication usage category codes (preferred): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | ||||
Slices for medication[x] | S | 1..1 | 所提供的藥品 Slice: Unordered, Open by type:$this | |||||
medicationCodeableConcept | CodeableConcept(CodeableConceptTW) | |||||||
medicationReference | Reference(TW Core Medication) | |||||||
medication[x]:medicationReference | 0..1 | Reference(TW Core Medication) | What medication was taken | |||||
medication[x]:medicationCodeableConcept | 0..1 | CodeableConceptTW | 所提供的藥品。此資料項目為可擴充綁定預設國際標準值集,但實作者可視實務專案需求只綁定以下slices中的任一值集。目前未只限定綁定預設值集是因為尚無slice值集與預設國際標準值集的代碼對應表,待後續有相對的代碼對應表後將建議採用國際標準值集作為唯一綁定值集並針對該值集進行擴充與管理,以利進行跨國與跨系統之資料交換。 | |||||
Slices for coding | 0..* | CodingTW | 由專門術語系統(terminology system)定義的代碼 Slice: Unordered, Open by pattern:$this | |||||
coding:fda-medication-tw | S | 0..1 | CodingTW | 此為臺灣食品藥物管理署(TFDA)維護之藥品代碼,涵蓋範圍相對完整,可免費使用,可優先選用此代碼。 Binding: 臺灣食藥署藥品及醫療器材代碼值集 (required): 應填入所綁定值集中的其中一個代碼。 | ||||
coding:nhi-medication-tw | S | 0..1 | CodingTW | 此為中央健康保險署(NHI)維護之藥品代碼,主要針對申報使用,更新頻率相對頻繁,可免費使用,可依情境選用此代碼。 Binding: 臺灣健保署用藥品項代碼值集 (required): 應填入所綁定值集中的其中一個代碼。 | ||||
coding:nhi-medication-ch-herb-tw | 0..1 | CodingTW | 此為中央健康保險署(NHI)維護之中藥藥品代碼,主要針對申報使用,更新頻率相對頻繁,可免費使用,可依情境選用此代碼。 Binding: 臺灣健保署中藥用藥品項值集 (required): 應填入所綁定值集中的其中一個代碼。 | |||||
coding:rxnorm-medication-us-core | S | 0..1 | CodingTW | RxNorm為美國Unified Medical Language System®中的藥品代碼,取得UMLS®授權即可免費使用,可依情境選用此代碼。 Binding: RxNorm藥品代碼值集 (required): 應填入所綁定值集中的其中一個代碼。 | ||||
coding:atc-medication-code | S | 0..1 | CodingTW | ATC代碼的版權為世界衛生組織(WHO)Collaborating Centre for Drug Statistics Methodology,可免費使用,可依情境選用此代碼。 Binding: 臺灣食藥署藥品藥理治療分類ATC碼值集 (required): 應填入所綁定值集中的其中一個代碼。 | ||||
coding:snomedct-medication-codes | S | 0..1 | CodingTW | 此為SNOMED CT代碼,若機構已有購買相關授權,亦可使用。 Binding: SNOMEDCTMedicationCodes (required): 可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。 | ||||
subject | S | 1..1 | Reference(TW Core Patient | Group) | 指明目前正在使用的藥品。這可能是一個連結到代表藥品詳細資訊的resource,或者是一個帶有代碼的簡單屬性,從已知藥品清單中表明藥品的代碼。 | ||||
context | S | 0..1 | Reference(TW Core Encounter | EpisodeOfCare) | 與此用藥聲明相關的就醫事件(Encounter / Episode) | ||||
effective[x] | S | 0..1 | dateTime, Period | 用藥的日期/時間或間隔 | ||||
dateAsserted | 0..1 | dateTime | 此聲明是何時提出的? | |||||
informationSource | 0..1 | Reference(TW Core Patient | TW Core Practitioner | TW Core PractitionerRole | TW Core RelatedPerson | TW Core Organization) | 提供有關服用此藥品資訊的個人或機構 | |||||
derivedFrom | 0..* | Reference(Resource) | 額外的補充資料 | |||||
reasonCode | 0..* | CodeableConceptTW | 指明目前正在使用的藥品 Binding: Condition/Problem/DiagnosisCodes (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | |||||
reasonReference | 0..* | Reference(TW Core Condition | TW Core Observation Laboratory Result | TW Core DiagnosticReport) | 證明目前正在/曾經用藥原因之Condition或Observation | |||||
note | 0..* | Annotation | 有關此聲明的更多資訊 | |||||
dosage | S | 0..* | Dosage | 藥品目前正被/曾經被服用或應該如何服用的細節 | ||||
sequence | S | 0..1 | integer | 劑量指示的順序 | ||||
text | S | 0..1 | string | 純文字表述的劑量指示,例如:SIG。 | ||||
additionalInstruction | 0..* | CodeableConceptTW | 對病人的補充指示或警告-例如:「隨餐服用」,「可能引起嗜睡」 Binding: SNOMEDCTAdditionalDosageInstructions (extensible): 一個編碼的概念,確定額外的指示,如「與水一起服用」或「避免操作重型機器」;可參考所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | |||||
patientInstruction | S | 0..1 | string | 以病人或消費者為導向的指示 | ||||
timing | S | 0..1 | Timing | 應該何時給藥;時間的寫法請參照Timimg datatype。 | ||||
event | 0..* | dateTime | 事件發生的時間 | |||||
repeat | S | 0..1 | Element | 事件定期重複發生的時間 | ||||
bounds[x] | 0..1 | Duration, Range, Period | 時間或期間長度/長度範圍,或(開始和/或結束)限制 | |||||
count | S | 0..1 | positiveInt | 重複的次數 | ||||
countMax | 0..1 | positiveInt | 重複的最大次數 | |||||
duration | S | 0..1 | decimal | 此事件持續多久時間 | ||||
durationMax | 0..1 | decimal | 此事件持續多久時間 (最長時間/最大值) | |||||
durationUnit | S | 0..1 | code | s | min | h | d | wk | mo | a - 單位時間 (unit of time,UCUM) Binding: UnitsOfTime (required): 時間的單位(單位來自UCUM);應填入UnitsOfTime值集中的其中一個代碼 | ||||
frequency | S | 0..1 | positiveInt | 此事件於每一期間的發生頻率 | ||||
frequencyMax | 0..1 | positiveInt | 此事件於每一期間的最大發生頻率 | |||||
period | S | 0..1 | decimal | 此事件於特定時間區間所發生的頻率 | ||||
periodMax | 0..1 | decimal | 時間區間的上限(3-4小時) | |||||
periodUnit | S | 0..1 | code | s | min | h | d | wk | mo | a - 單位時間 (unit of time,UCUM) Binding: UnitsOfTime (required): 時間的單位(單位來自UCUM);應填入UnitsOfTime值集中的其中一個代碼 | ||||
dayOfWeek | S | 0..* | code | mon | tue | wed | thu | fri | sat | sun Binding: DaysOfWeek (required): 應填入DaysOfWeek值集中的其中一個代碼 | ||||
timeOfDay | S | 0..* | time | 一天中的活動時間 | ||||
when | 0..* | code | 事件發生的時間區間之代碼 Binding: EventTiming (required): 與時程表有關的真實世界事件;應填入EventTiming值集中的其中一個代碼 | |||||
offset | 0..1 | unsignedInt | 事件的分鐘數(之前或之後) | |||||
code | S | 0..1 | CodeableConceptTW | BID | TID | QID | AM | PM | QD | QOD | + Binding: TimingAbbreviation (preferred): 已知/確定的時間模式之代碼;鼓勵使用TimingAbbreviation值集中的代碼,但不強制一定要使用此值集,你也可使用其他值集的代碼或單純以文字表示。 | ||||
coding | 0..* | CodingTW | 由專門術語系統(terminology system)定義的代碼。此資料項目為可擴充綁定預設國際標準值集,但實作者可視實務專案需求只綁定以下slices中的任一值集。目前未只限定綁定預設值集是因為尚無slice值集與預設國際標準值集的代碼對應表,待後續有相對的代碼對應表後將建議採用國際標準值集作為唯一綁定值集並針對該值集進行擴充與管理,以利進行跨國與跨系統之資料交換。 Binding: HL7 TimingAbbreviation + 臺灣健保署藥品使用頻率值集 (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | |||||
text | S | 0..1 | string | 概念的文字標記法 | ||||
asNeeded[x] | 0..1 | boolean, CodeableConcept | 「根據(對x的)需要」服用
Binding:一個編碼概念,指明在服用或用藥之前應滿足或評估的先決條件。例如:「疼痛」、「性行為前30分鐘」、「發作時」等;可參考SNOMEDCTMedicationAsNeededReasonCodes值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。 Binding: SNOMEDCTMedicationAsNeededReasonCodes (extensible): 一個編碼概念,指明在服用或用藥之前應滿足或評估的先決條件。例如:「疼痛」、「性行為前30分鐘」、「發作時」等;應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | |||||
site | 0..1 | CodeableConcept | 用藥之身體部位 Binding: SNOMEDCTAnatomicalStructureForAdministrationSiteCodes (extensible): 一個編碼概念,描述藥品進入或在身體上的位置;可參考所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | |||||
route | S | 0..1 | CodeableConceptTW | 藥品應如何進入體內 | ||||
coding | 0..* | CodingTW | 由專門術語系統(terminology system)定義的代碼。此資料項目為可擴充綁定預設國際標準值集,但實作者可視實務專案需求只綁定以下slices中的任一值集。目前未只限定綁定預設值集是因為尚無slice值集與預設國際標準值集的代碼對應表,待後續有相對的代碼對應表後將建議採用國際標準值集作為唯一綁定值集並針對該值集進行擴充與管理,以利進行跨國與跨系統之資料交換。 Binding: SNOMED CT + 臺灣健保署給藥途徑值集 (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | |||||
text | S | 0..1 | string | 概念的文字標記法 | ||||
method | 0..1 | CodeableConceptTW | 用藥的技術 Binding: SNOMEDCTAdministrationMethodCodes (extensible): 一個編碼概念,描述用藥的技術;可參考所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | |||||
doseAndRate | 0..* | Element | 用藥量 | |||||
type | 0..1 | CodeableConceptTW | 特定劑量或比率種類 Binding: DoseAndRateType (example): 可參考DoseAndRateType值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。 | |||||
dose[x] | S | 0..1 | Range, SimpleQuantity | 每一劑量的藥量 | ||||
rate[x] | S | 0..1 | Ratio, Range, SimpleQuantity | 每時間單位內的用藥量 | ||||
maxDosePerPeriod | 0..1 | Ratio | 每時間單位內用藥的上限 | |||||
maxDosePerAdministration | 0..1 | SimpleQuantity | 每次用藥的上限 | |||||
maxDosePerLifetime | 0..1 | SimpleQuantity | 病人一生中用藥的上限 | |||||
Documentation for this format |
Path | Conformance | ValueSet | URI | |||
MedicationStatement.language | preferred | CommonLanguages
http://hl7.org/fhir/ValueSet/languages from the FHIR Standard | ||||
MedicationStatement.status | required | Medication Status Codeshttp://hl7.org/fhir/ValueSet/medication-statement-status|4.0.1 from the FHIR Standard | ||||
MedicationStatement.statusReason | extensible | SNOMEDCTDrugTherapyStatusCodeshttp://hl7.org/fhir/ValueSet/reason-medication-status-codes from the FHIR Standard | ||||
MedicationStatement.category | preferred | Medication usage category codeshttp://hl7.org/fhir/ValueSet/medication-statement-category from the FHIR Standard | ||||
MedicationStatement.medication[x]:medicationCodeableConcept.coding:fda-medication-tw | required | TWMedicationFDAhttps://twcore.mohw.gov.tw/ig/twcore/ValueSet/medication-fda-tw from this IG | ||||
MedicationStatement.medication[x]:medicationCodeableConcept.coding:nhi-medication-tw | required | TWMedicationNHI (a valid code from 臺灣健保署健保用藥品項代碼)https://twcore.mohw.gov.tw/ig/twcore/ValueSet/medication-nhi-tw from this IG | ||||
MedicationStatement.medication[x]:medicationCodeableConcept.coding:nhi-medication-ch-herb-tw | required | TWCHHerbMedicationNHI (a valid code from 臺灣健保署中藥用藥品項)https://twcore.mohw.gov.tw/ig/twcore/ValueSet/nhi-medication-ch-herb-tw from this IG | ||||
MedicationStatement.medication[x]:medicationCodeableConcept.coding:rxnorm-medication-us-core | required | TWMedicationRXNORMhttps://twcore.mohw.gov.tw/ig/twcore/ValueSet/medication-rxnorm-tw from this IG | ||||
MedicationStatement.medication[x]:medicationCodeableConcept.coding:atc-medication-code | required | TWMedcationATChttps://twcore.mohw.gov.tw/ig/twcore/ValueSet/medcation-atc-tw from this IG | ||||
MedicationStatement.medication[x]:medicationCodeableConcept.coding:snomedct-medication-codes | required | SNOMEDCTMedicationCodeshttp://hl7.org/fhir/ValueSet/medication-codes from the FHIR Standard | ||||
MedicationStatement.reasonCode | extensible | Condition/Problem/DiagnosisCodeshttp://hl7.org/fhir/ValueSet/condition-code from the FHIR Standard | ||||
MedicationStatement.dosage.additionalInstruction | extensible | SNOMEDCTAdditionalDosageInstructionshttp://hl7.org/fhir/ValueSet/additional-instruction-codes from the FHIR Standard | ||||
MedicationStatement.dosage.timing.repeat.durationUnit | required | UnitsOfTimehttp://hl7.org/fhir/ValueSet/units-of-time|4.0.1 from the FHIR Standard | ||||
MedicationStatement.dosage.timing.repeat.periodUnit | required | UnitsOfTimehttp://hl7.org/fhir/ValueSet/units-of-time|4.0.1 from the FHIR Standard | ||||
MedicationStatement.dosage.timing.repeat.dayOfWeek | required | DaysOfWeekhttp://hl7.org/fhir/ValueSet/days-of-week|4.0.1 from the FHIR Standard | ||||
MedicationStatement.dosage.timing.repeat.when | required | EventTiminghttp://hl7.org/fhir/ValueSet/event-timing|4.0.1 from the FHIR Standard | ||||
MedicationStatement.dosage.timing.code | preferred | TimingAbbreviationhttp://hl7.org/fhir/ValueSet/timing-abbreviation from the FHIR Standard | ||||
MedicationStatement.dosage.timing.code.coding | extensible | TWMedicationFrequencyHL7https://twcore.mohw.gov.tw/ig/twcore/ValueSet/medication-frequency-hl7-tw from this IG | ||||
MedicationStatement.dosage.asNeeded[x] | extensible | SNOMEDCTMedicationAsNeededReasonCodeshttp://hl7.org/fhir/ValueSet/medication-as-needed-reason from the FHIR Standard | ||||
MedicationStatement.dosage.site | extensible | SNOMEDCTAnatomicalStructureForAdministrationSiteCodeshttp://hl7.org/fhir/ValueSet/approach-site-codes from the FHIR Standard | ||||
MedicationStatement.dosage.route.coding | extensible | TWMedicationPathSCThttps://twcore.mohw.gov.tw/ig/twcore/ValueSet/medication-path-sct-tw from this IG | ||||
MedicationStatement.dosage.method | extensible | SNOMEDCTAdministrationMethodCodeshttp://hl7.org/fhir/ValueSet/administration-method-codes from the FHIR Standard | ||||
MedicationStatement.dosage.doseAndRate.type | example | DoseAndRateTypehttp://hl7.org/fhir/ValueSet/dose-rate-type from the FHIR Standard |
Name | Flags | Card. | Type | Description & Constraints | ||||
---|---|---|---|---|---|---|---|---|
MedicationStatement | 0..* | MedicationStatement | 病人正在服用的藥品紀錄 | |||||
id | Σ | 0..1 | id | 不重複的ID用以識別儲存在特定FHIR Server中的MedicationStatement紀錄,通常又稱為邏輯性ID。 | ||||
meta | Σ | 0..1 | Meta | 此MedicationStatement Resource的metadata | ||||
implicitRules | ?!Σ | 0..1 | uri | 創建此內容所依據的一組規則 | ||||
language | 0..1 | code | 用以表述MedicationStatement Resource內容的語言。 Binding: CommonLanguages (preferred): 人類語言;鼓勵使用CommonLanguages代碼表中的代碼,但不強制一定要使用此代碼表,你也可使用其他代碼表的代碼或單純以文字表示。
Example Value: zh-TW | |||||
text | 0..1 | Narrative | MedicationStatement Resource之內容摘要以供人閱讀 | |||||
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored | ||||
identifier | SΣ | 0..* | Identifier | 用藥聲明的外部識別碼 | ||||
basedOn | Σ | 0..* | Reference(TW Core MedicationRequest | TW Core CarePlan | TW Core ServiceRequest) | 此用藥聲明是為了達成或實現哪個計劃、提案或醫令 | ||||
partOf | Σ | 0..* | Reference(MedicationAdministration | TW Core MedicationDispense | TW Core MedicationStatement | TW Core Procedure | TW Core Observation Laboratory Result) | 參照事件的一部分 | ||||
status | ?!SΣ | 1..1 | code | active | completed | entered-in-error | intended | stopped | on-hold | unknown | not-taken Binding: Medication Status Codes (required): 指明用藥聲明的當前狀態;應填入所綁定值集中的其中一個代碼 | ||||
statusReason | 0..* | CodeableConceptTW | 當前狀態的原因 Binding: SNOMEDCTDrugTherapyStatusCodes (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | |||||
category | S | 0..1 | CodeableConceptTW | 藥品使用的類型 Binding: Medication usage category codes (preferred): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | ||||
Slices for medication[x] | SΣ | 1..1 | 所提供的藥品 Slice: Unordered, Closed by type:$this Binding: SNOMEDCTMedicationCodes (example): A coded concept identifying the substance or product being taken. | |||||
medicationCodeableConcept | CodeableConcept(CodeableConceptTW) | |||||||
medicationReference | Reference(TW Core Medication) | |||||||
medication[x]:medicationReference | Σ | 0..1 | Reference(TW Core Medication) | What medication was taken | ||||
medication[x]:medicationCodeableConcept | 0..1 | CodeableConceptTW | 所提供的藥品。此資料項目為可擴充綁定預設國際標準值集,但實作者可視實務專案需求只綁定以下slices中的任一值集。目前未只限定綁定預設值集是因為尚無slice值集與預設國際標準值集的代碼對應表,待後續有相對的代碼對應表後將建議採用國際標準值集作為唯一綁定值集並針對該值集進行擴充與管理,以利進行跨國與跨系統之資料交換。 Binding: SNOMEDCTMedicationCodes (example): A coded concept identifying the substance or product being taken. | |||||
Slices for coding | S | 0..* | CodingTW | 由專門術語系統(terminology system)定義的代碼 Slice: Unordered, Open by pattern:$this | ||||
coding:fda-medication-tw | S | 0..1 | CodingTW | 此為臺灣食品藥物管理署(TFDA)維護之藥品代碼,涵蓋範圍相對完整,可免費使用,可優先選用此代碼。 Binding: 臺灣食藥署藥品及醫療器材代碼值集 (required): 應填入所綁定值集中的其中一個代碼。 | ||||
coding:nhi-medication-tw | S | 0..1 | CodingTW | 此為中央健康保險署(NHI)維護之藥品代碼,主要針對申報使用,更新頻率相對頻繁,可免費使用,可依情境選用此代碼。 Binding: 臺灣健保署用藥品項代碼值集 (required): 應填入所綁定值集中的其中一個代碼。 | ||||
coding:nhi-medication-ch-herb-tw | S | 0..1 | CodingTW | 此為中央健康保險署(NHI)維護之中藥藥品代碼,主要針對申報使用,更新頻率相對頻繁,可免費使用,可依情境選用此代碼。 Binding: 臺灣健保署中藥用藥品項值集 (required): 應填入所綁定值集中的其中一個代碼。 | ||||
coding:rxnorm-medication-us-core | S | 0..1 | CodingTW | RxNorm為美國Unified Medical Language System®中的藥品代碼,取得UMLS®授權即可免費使用,可依情境選用此代碼。 Binding: RxNorm藥品代碼值集 (required): 應填入所綁定值集中的其中一個代碼。 | ||||
coding:atc-medication-code | S | 0..1 | CodingTW | ATC代碼的版權為世界衛生組織(WHO)Collaborating Centre for Drug Statistics Methodology,可免費使用,可依情境選用此代碼。 Binding: 臺灣食藥署藥品藥理治療分類ATC碼值集 (required): 應填入所綁定值集中的其中一個代碼。 | ||||
coding:snomedct-medication-codes | S | 0..1 | CodingTW | 此為SNOMED CT代碼,若機構已有購買相關授權,亦可使用。 Binding: SNOMEDCTMedicationCodes (required): 可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。 | ||||
text | SΣ | 0..1 | string | 概念的文字表示法 | ||||
subject | SΣ | 1..1 | Reference(TW Core Patient | Group) | 指明目前正在使用的藥品。這可能是一個連結到代表藥品詳細資訊的resource,或者是一個帶有代碼的簡單屬性,從已知藥品清單中表明藥品的代碼。 | ||||
context | SΣ | 0..1 | Reference(TW Core Encounter | EpisodeOfCare) | 與此用藥聲明相關的就醫事件(Encounter / Episode) | ||||
effective[x] | SΣ | 0..1 | 用藥的日期/時間或間隔 | |||||
effectiveDateTime | dateTime | |||||||
effectivePeriod | Period | |||||||
dateAsserted | Σ | 0..1 | dateTime | 此聲明是何時提出的? | ||||
informationSource | 0..1 | Reference(TW Core Patient | TW Core Practitioner | TW Core PractitionerRole | TW Core RelatedPerson | TW Core Organization) | 提供有關服用此藥品資訊的個人或機構 | |||||
derivedFrom | 0..* | Reference(Resource) | 額外的補充資料 | |||||
reasonCode | 0..* | CodeableConceptTW | 指明目前正在使用的藥品 Binding: Condition/Problem/DiagnosisCodes (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | |||||
reasonReference | 0..* | Reference(TW Core Condition | TW Core Observation Laboratory Result | TW Core DiagnosticReport) | 證明目前正在/曾經用藥原因之Condition或Observation | |||||
note | 0..* | Annotation | 有關此聲明的更多資訊 | |||||
dosage | S | 0..* | Dosage | 藥品目前正被/曾經被服用或應該如何服用的細節 | ||||
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
sequence | SΣ | 0..1 | integer | 劑量指示的順序 | ||||
text | SΣ | 0..1 | string | 純文字表述的劑量指示,例如:SIG。 | ||||
additionalInstruction | 0..* | CodeableConceptTW | 對病人的補充指示或警告-例如:「隨餐服用」,「可能引起嗜睡」 Binding: SNOMEDCTAdditionalDosageInstructions (extensible): 一個編碼的概念,確定額外的指示,如「與水一起服用」或「避免操作重型機器」;可參考所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | |||||
patientInstruction | SΣ | 0..1 | string | 以病人或消費者為導向的指示 | ||||
timing | SΣ | 0..1 | Timing | 應該何時給藥;時間的寫法請參照Timimg datatype。 | ||||
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
event | Σ | 0..* | dateTime | 事件發生的時間 | ||||
repeat | SΣC | 0..1 | Element | 事件定期重複發生的時間 tim-1: if there's a duration, there needs to be duration units tim-2: if there's a period, there needs to be period units tim-4: duration SHALL be a non-negative value tim-5: period SHALL be a non-negative value tim-6: If there's a periodMax, there must be a period tim-7: If there's a durationMax, there must be a duration tim-8: If there's a countMax, there must be a count tim-9: If there's an offset, there must be a when (and not C, CM, CD, CV) tim-10: If there's a timeOfDay, there cannot be a when, or vice versa | ||||
bounds[x] | Σ | 0..1 | 時間或期間長度/長度範圍,或(開始和/或結束)限制 | |||||
boundsDuration | Duration | |||||||
boundsRange | Range | |||||||
boundsPeriod | Period | |||||||
count | SΣ | 0..1 | positiveInt | 重複的次數 | ||||
countMax | Σ | 0..1 | positiveInt | 重複的最大次數 | ||||
duration | SΣ | 0..1 | decimal | 此事件持續多久時間 | ||||
durationMax | Σ | 0..1 | decimal | 此事件持續多久時間 (最長時間/最大值) | ||||
durationUnit | SΣ | 0..1 | code | s | min | h | d | wk | mo | a - 單位時間 (unit of time,UCUM) Binding: UnitsOfTime (required): 時間的單位(單位來自UCUM);應填入UnitsOfTime值集中的其中一個代碼 | ||||
frequency | SΣ | 0..1 | positiveInt | 此事件於每一期間的發生頻率 | ||||
frequencyMax | Σ | 0..1 | positiveInt | 此事件於每一期間的最大發生頻率 | ||||
period | SΣ | 0..1 | decimal | 此事件於特定時間區間所發生的頻率 | ||||
periodMax | Σ | 0..1 | decimal | 時間區間的上限(3-4小時) | ||||
periodUnit | SΣ | 0..1 | code | s | min | h | d | wk | mo | a - 單位時間 (unit of time,UCUM) Binding: UnitsOfTime (required): 時間的單位(單位來自UCUM);應填入UnitsOfTime值集中的其中一個代碼 | ||||
dayOfWeek | SΣ | 0..* | code | mon | tue | wed | thu | fri | sat | sun Binding: DaysOfWeek (required): 應填入DaysOfWeek值集中的其中一個代碼 | ||||
timeOfDay | SΣ | 0..* | time | 一天中的活動時間 | ||||
when | Σ | 0..* | code | 事件發生的時間區間之代碼 Binding: EventTiming (required): 與時程表有關的真實世界事件;應填入EventTiming值集中的其中一個代碼 | ||||
offset | Σ | 0..1 | unsignedInt | 事件的分鐘數(之前或之後) | ||||
code | S | 0..1 | CodeableConceptTW | BID | TID | QID | AM | PM | QD | QOD | + Binding: TimingAbbreviation (preferred): 已知/確定的時間模式之代碼;鼓勵使用TimingAbbreviation值集中的代碼,但不強制一定要使用此值集,你也可使用其他值集的代碼或單純以文字表示。 | ||||
coding | S | 0..* | CodingTW | 由專門術語系統(terminology system)定義的代碼。此資料項目為可擴充綁定預設國際標準值集,但實作者可視實務專案需求只綁定以下slices中的任一值集。目前未只限定綁定預設值集是因為尚無slice值集與預設國際標準值集的代碼對應表,待後續有相對的代碼對應表後將建議採用國際標準值集作為唯一綁定值集並針對該值集進行擴充與管理,以利進行跨國與跨系統之資料交換。 Binding: HL7 TimingAbbreviation + 臺灣健保署藥品使用頻率值集 (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | ||||
text | SΣ | 0..1 | string | 概念的文字標記法 | ||||
asNeeded[x] | Σ | 0..1 | 「根據(對x的)需要」服用
Binding:一個編碼概念,指明在服用或用藥之前應滿足或評估的先決條件。例如:「疼痛」、「性行為前30分鐘」、「發作時」等;可參考SNOMEDCTMedicationAsNeededReasonCodes值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。 Binding: SNOMEDCTMedicationAsNeededReasonCodes (extensible): 一個編碼概念,指明在服用或用藥之前應滿足或評估的先決條件。例如:「疼痛」、「性行為前30分鐘」、「發作時」等;應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | |||||
asNeededBoolean | boolean | |||||||
asNeededCodeableConcept | CodeableConcept | |||||||
site | Σ | 0..1 | CodeableConcept | 用藥之身體部位 Binding: SNOMEDCTAnatomicalStructureForAdministrationSiteCodes (extensible): 一個編碼概念,描述藥品進入或在身體上的位置;可參考所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | ||||
route | S | 0..1 | CodeableConceptTW | 藥品應如何進入體內 Binding: SNOMEDCTRouteCodes (example): A coded concept describing the route or physiological path of administration of a therapeutic agent into or onto the body of a subject. | ||||
coding | S | 0..* | CodingTW | 由專門術語系統(terminology system)定義的代碼。此資料項目為可擴充綁定預設國際標準值集,但實作者可視實務專案需求只綁定以下slices中的任一值集。目前未只限定綁定預設值集是因為尚無slice值集與預設國際標準值集的代碼對應表,待後續有相對的代碼對應表後將建議採用國際標準值集作為唯一綁定值集並針對該值集進行擴充與管理,以利進行跨國與跨系統之資料交換。 Binding: SNOMED CT + 臺灣健保署給藥途徑值集 (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | ||||
text | SΣ | 0..1 | string | 概念的文字標記法 | ||||
method | 0..1 | CodeableConceptTW | 用藥的技術 Binding: SNOMEDCTAdministrationMethodCodes (extensible): 一個編碼概念,描述用藥的技術;可參考所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | |||||
doseAndRate | Σ | 0..* | Element | 用藥量 | ||||
type | 0..1 | CodeableConceptTW | 特定劑量或比率種類 Binding: DoseAndRateType (example): 可參考DoseAndRateType值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。 | |||||
dose[x] | SΣ | 0..1 | 每一劑量的藥量 | |||||
doseRange | Range | |||||||
doseQuantity | Quantity(SimpleQuantity) | |||||||
rate[x] | SΣ | 0..1 | 每時間單位內的用藥量 | |||||
rateRatio | Ratio | |||||||
rateRange | Range | |||||||
rateQuantity | Quantity(SimpleQuantity) | |||||||
maxDosePerPeriod | Σ | 0..1 | Ratio | 每時間單位內用藥的上限 | ||||
maxDosePerAdministration | Σ | 0..1 | SimpleQuantity | 每次用藥的上限 | ||||
maxDosePerLifetime | Σ | 0..1 | SimpleQuantity | 病人一生中用藥的上限 | ||||
Documentation for this format |
Path | Conformance | ValueSet | URI | |||
MedicationStatement.language | preferred | CommonLanguages
http://hl7.org/fhir/ValueSet/languages from the FHIR Standard | ||||
MedicationStatement.status | required | Medication Status Codeshttp://hl7.org/fhir/ValueSet/medication-statement-status|4.0.1 from the FHIR Standard | ||||
MedicationStatement.statusReason | extensible | SNOMEDCTDrugTherapyStatusCodeshttp://hl7.org/fhir/ValueSet/reason-medication-status-codes from the FHIR Standard | ||||
MedicationStatement.category | preferred | Medication usage category codeshttp://hl7.org/fhir/ValueSet/medication-statement-category from the FHIR Standard | ||||
MedicationStatement.medication[x] | example | SNOMEDCTMedicationCodeshttp://hl7.org/fhir/ValueSet/medication-codes from the FHIR Standard | ||||
MedicationStatement.medication[x]:medicationCodeableConcept | example | SNOMEDCTMedicationCodeshttp://hl7.org/fhir/ValueSet/medication-codes from the FHIR Standard | ||||
MedicationStatement.medication[x]:medicationCodeableConcept.coding:fda-medication-tw | required | TWMedicationFDAhttps://twcore.mohw.gov.tw/ig/twcore/ValueSet/medication-fda-tw from this IG | ||||
MedicationStatement.medication[x]:medicationCodeableConcept.coding:nhi-medication-tw | required | TWMedicationNHI (a valid code from 臺灣健保署健保用藥品項代碼)https://twcore.mohw.gov.tw/ig/twcore/ValueSet/medication-nhi-tw from this IG | ||||
MedicationStatement.medication[x]:medicationCodeableConcept.coding:nhi-medication-ch-herb-tw | required | TWCHHerbMedicationNHI (a valid code from 臺灣健保署中藥用藥品項)https://twcore.mohw.gov.tw/ig/twcore/ValueSet/nhi-medication-ch-herb-tw from this IG | ||||
MedicationStatement.medication[x]:medicationCodeableConcept.coding:rxnorm-medication-us-core | required | TWMedicationRXNORMhttps://twcore.mohw.gov.tw/ig/twcore/ValueSet/medication-rxnorm-tw from this IG | ||||
MedicationStatement.medication[x]:medicationCodeableConcept.coding:atc-medication-code | required | TWMedcationATChttps://twcore.mohw.gov.tw/ig/twcore/ValueSet/medcation-atc-tw from this IG | ||||
MedicationStatement.medication[x]:medicationCodeableConcept.coding:snomedct-medication-codes | required | SNOMEDCTMedicationCodeshttp://hl7.org/fhir/ValueSet/medication-codes from the FHIR Standard | ||||
MedicationStatement.reasonCode | extensible | Condition/Problem/DiagnosisCodeshttp://hl7.org/fhir/ValueSet/condition-code from the FHIR Standard | ||||
MedicationStatement.dosage.additionalInstruction | extensible | SNOMEDCTAdditionalDosageInstructionshttp://hl7.org/fhir/ValueSet/additional-instruction-codes from the FHIR Standard | ||||
MedicationStatement.dosage.timing.repeat.durationUnit | required | UnitsOfTimehttp://hl7.org/fhir/ValueSet/units-of-time|4.0.1 from the FHIR Standard | ||||
MedicationStatement.dosage.timing.repeat.periodUnit | required | UnitsOfTimehttp://hl7.org/fhir/ValueSet/units-of-time|4.0.1 from the FHIR Standard | ||||
MedicationStatement.dosage.timing.repeat.dayOfWeek | required | DaysOfWeekhttp://hl7.org/fhir/ValueSet/days-of-week|4.0.1 from the FHIR Standard | ||||
MedicationStatement.dosage.timing.repeat.when | required | EventTiminghttp://hl7.org/fhir/ValueSet/event-timing|4.0.1 from the FHIR Standard | ||||
MedicationStatement.dosage.timing.code | preferred | TimingAbbreviationhttp://hl7.org/fhir/ValueSet/timing-abbreviation from the FHIR Standard | ||||
MedicationStatement.dosage.timing.code.coding | extensible | TWMedicationFrequencyHL7https://twcore.mohw.gov.tw/ig/twcore/ValueSet/medication-frequency-hl7-tw from this IG | ||||
MedicationStatement.dosage.asNeeded[x] | extensible | SNOMEDCTMedicationAsNeededReasonCodeshttp://hl7.org/fhir/ValueSet/medication-as-needed-reason from the FHIR Standard | ||||
MedicationStatement.dosage.site | extensible | SNOMEDCTAnatomicalStructureForAdministrationSiteCodeshttp://hl7.org/fhir/ValueSet/approach-site-codes from the FHIR Standard | ||||
MedicationStatement.dosage.route | example | SNOMEDCTRouteCodeshttp://hl7.org/fhir/ValueSet/route-codes from the FHIR Standard | ||||
MedicationStatement.dosage.route.coding | extensible | TWMedicationPathSCThttps://twcore.mohw.gov.tw/ig/twcore/ValueSet/medication-path-sct-tw from this IG | ||||
MedicationStatement.dosage.method | extensible | SNOMEDCTAdministrationMethodCodeshttp://hl7.org/fhir/ValueSet/administration-method-codes from the FHIR Standard | ||||
MedicationStatement.dosage.doseAndRate.type | example | DoseAndRateTypehttp://hl7.org/fhir/ValueSet/dose-rate-type from the FHIR Standard |
Id | Grade | Path(s) | Details | Requirements |
dom-2 | error | MedicationStatement | If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty() | |
dom-3 | error | MedicationStatement | 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 | MedicationStatement | 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 | MedicationStatement | If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty() | |
dom-6 | best practice | MedicationStatement | 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() | |
tim-1 | error | MedicationStatement.dosage.timing.repeat | if there's a duration, there needs to be duration units : duration.empty() or durationUnit.exists() | |
tim-2 | error | MedicationStatement.dosage.timing.repeat | if there's a period, there needs to be period units : period.empty() or periodUnit.exists() | |
tim-4 | error | MedicationStatement.dosage.timing.repeat | duration SHALL be a non-negative value : duration.exists() implies duration >= 0 | |
tim-5 | error | MedicationStatement.dosage.timing.repeat | period SHALL be a non-negative value : period.exists() implies period >= 0 | |
tim-6 | error | MedicationStatement.dosage.timing.repeat | If there's a periodMax, there must be a period : periodMax.empty() or period.exists() | |
tim-7 | error | MedicationStatement.dosage.timing.repeat | If there's a durationMax, there must be a duration : durationMax.empty() or duration.exists() | |
tim-8 | error | MedicationStatement.dosage.timing.repeat | If there's a countMax, there must be a count : countMax.empty() or count.exists() | |
tim-9 | error | MedicationStatement.dosage.timing.repeat | If there's an offset, there must be a when (and not C, CM, CD, CV) : offset.empty() or (when.exists() and ((when in ('C' | 'CM' | 'CD' | 'CV')).not())) | |
tim-10 | error | MedicationStatement.dosage.timing.repeat | If there's a timeOfDay, there cannot be a when, or vice versa : timeOfDay.empty() or when.empty() |
Name | Flags | Card. | Type | Description & Constraints | ||||
---|---|---|---|---|---|---|---|---|
MedicationStatement | 0..* | MedicationStatement | 病人正在服用的藥品紀錄 | |||||
id | Σ | 0..1 | id | 不重複的ID用以識別儲存在特定FHIR Server中的MedicationStatement紀錄,通常又稱為邏輯性ID。 | ||||
meta | Σ | 0..1 | Meta | 此MedicationStatement Resource的metadata | ||||
implicitRules | ?!Σ | 0..1 | uri | 創建此內容所依據的一組規則 | ||||
language | 0..1 | code | 用以表述MedicationStatement Resource內容的語言。 Binding: CommonLanguages (preferred): 人類語言;鼓勵使用CommonLanguages代碼表中的代碼,但不強制一定要使用此代碼表,你也可使用其他代碼表的代碼或單純以文字表示。
Example Value: zh-TW | |||||
text | 0..1 | Narrative | MedicationStatement Resource之內容摘要以供人閱讀 | |||||
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 | 用藥聲明的外部識別碼 | ||||
basedOn | Σ | 0..* | Reference(TW Core MedicationRequest | TW Core CarePlan | TW Core ServiceRequest) | 此用藥聲明是為了達成或實現哪個計劃、提案或醫令 | ||||
partOf | Σ | 0..* | Reference(MedicationAdministration | TW Core MedicationDispense | TW Core MedicationStatement | TW Core Procedure | TW Core Observation Laboratory Result) | 參照事件的一部分 | ||||
status | ?!SΣ | 1..1 | code | active | completed | entered-in-error | intended | stopped | on-hold | unknown | not-taken Binding: Medication Status Codes (required): 指明用藥聲明的當前狀態;應填入所綁定值集中的其中一個代碼 | ||||
statusReason | 0..* | CodeableConceptTW | 當前狀態的原因 Binding: SNOMEDCTDrugTherapyStatusCodes (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | |||||
category | S | 0..1 | CodeableConceptTW | 藥品使用的類型 Binding: Medication usage category codes (preferred): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | ||||
Slices for medication[x] | SΣ | 1..1 | 所提供的藥品 Slice: Unordered, Closed by type:$this Binding: SNOMEDCTMedicationCodes (example): A coded concept identifying the substance or product being taken. | |||||
medicationCodeableConcept | CodeableConcept(CodeableConceptTW) | |||||||
medicationReference | Reference(TW Core Medication) | |||||||
medication[x]:medicationReference | Σ | 0..1 | Reference(TW Core Medication) | What medication was taken | ||||
medication[x]:medicationCodeableConcept | 0..1 | CodeableConceptTW | 所提供的藥品。此資料項目為可擴充綁定預設國際標準值集,但實作者可視實務專案需求只綁定以下slices中的任一值集。目前未只限定綁定預設值集是因為尚無slice值集與預設國際標準值集的代碼對應表,待後續有相對的代碼對應表後將建議採用國際標準值集作為唯一綁定值集並針對該值集進行擴充與管理,以利進行跨國與跨系統之資料交換。 Binding: SNOMEDCTMedicationCodes (example): A coded concept identifying the substance or product being taken. | |||||
id | 0..1 | string | 唯一可識別ID,以供資料項目間相互參照。 | |||||
extension | 0..* | Extension | 擴充的資料項目 Slice: Unordered, Open by value:url | |||||
Slices for coding | S | 0..* | CodingTW | 由專門術語系統(terminology system)定義的代碼 Slice: Unordered, Open by pattern:$this | ||||
coding:fda-medication-tw | S | 0..1 | CodingTW | 此為臺灣食品藥物管理署(TFDA)維護之藥品代碼,涵蓋範圍相對完整,可免費使用,可優先選用此代碼。 Binding: 臺灣食藥署藥品及醫療器材代碼值集 (required): 應填入所綁定值集中的其中一個代碼。 | ||||
coding:nhi-medication-tw | S | 0..1 | CodingTW | 此為中央健康保險署(NHI)維護之藥品代碼,主要針對申報使用,更新頻率相對頻繁,可免費使用,可依情境選用此代碼。 Binding: 臺灣健保署用藥品項代碼值集 (required): 應填入所綁定值集中的其中一個代碼。 | ||||
coding:nhi-medication-ch-herb-tw | S | 0..1 | CodingTW | 此為中央健康保險署(NHI)維護之中藥藥品代碼,主要針對申報使用,更新頻率相對頻繁,可免費使用,可依情境選用此代碼。 Binding: 臺灣健保署中藥用藥品項值集 (required): 應填入所綁定值集中的其中一個代碼。 | ||||
coding:rxnorm-medication-us-core | S | 0..1 | CodingTW | RxNorm為美國Unified Medical Language System®中的藥品代碼,取得UMLS®授權即可免費使用,可依情境選用此代碼。 Binding: RxNorm藥品代碼值集 (required): 應填入所綁定值集中的其中一個代碼。 | ||||
coding:atc-medication-code | S | 0..1 | CodingTW | ATC代碼的版權為世界衛生組織(WHO)Collaborating Centre for Drug Statistics Methodology,可免費使用,可依情境選用此代碼。 Binding: 臺灣食藥署藥品藥理治療分類ATC碼值集 (required): 應填入所綁定值集中的其中一個代碼。 | ||||
coding:snomedct-medication-codes | S | 0..1 | CodingTW | 此為SNOMED CT代碼,若機構已有購買相關授權,亦可使用。 Binding: SNOMEDCTMedicationCodes (required): 可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。 | ||||
text | SΣ | 0..1 | string | 概念的文字表示法 | ||||
subject | SΣ | 1..1 | Reference(TW Core Patient | Group) | 指明目前正在使用的藥品。這可能是一個連結到代表藥品詳細資訊的resource,或者是一個帶有代碼的簡單屬性,從已知藥品清單中表明藥品的代碼。 | ||||
context | SΣ | 0..1 | Reference(TW Core Encounter | EpisodeOfCare) | 與此用藥聲明相關的就醫事件(Encounter / Episode) | ||||
effective[x] | SΣ | 0..1 | 用藥的日期/時間或間隔 | |||||
effectiveDateTime | dateTime | |||||||
effectivePeriod | Period | |||||||
dateAsserted | Σ | 0..1 | dateTime | 此聲明是何時提出的? | ||||
informationSource | 0..1 | Reference(TW Core Patient | TW Core Practitioner | TW Core PractitionerRole | TW Core RelatedPerson | TW Core Organization) | 提供有關服用此藥品資訊的個人或機構 | |||||
derivedFrom | 0..* | Reference(Resource) | 額外的補充資料 | |||||
reasonCode | 0..* | CodeableConceptTW | 指明目前正在使用的藥品 Binding: Condition/Problem/DiagnosisCodes (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | |||||
reasonReference | 0..* | Reference(TW Core Condition | TW Core Observation Laboratory Result | TW Core DiagnosticReport) | 證明目前正在/曾經用藥原因之Condition或Observation | |||||
note | 0..* | Annotation | 有關此聲明的更多資訊 | |||||
dosage | S | 0..* | Dosage | 藥品目前正被/曾經被服用或應該如何服用的細節 | ||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
extension | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
sequence | SΣ | 0..1 | integer | 劑量指示的順序 | ||||
text | SΣ | 0..1 | string | 純文字表述的劑量指示,例如:SIG。 | ||||
additionalInstruction | 0..* | CodeableConceptTW | 對病人的補充指示或警告-例如:「隨餐服用」,「可能引起嗜睡」 Binding: SNOMEDCTAdditionalDosageInstructions (extensible): 一個編碼的概念,確定額外的指示,如「與水一起服用」或「避免操作重型機器」;可參考所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | |||||
patientInstruction | SΣ | 0..1 | string | 以病人或消費者為導向的指示 | ||||
timing | SΣ | 0..1 | Timing | 應該何時給藥;時間的寫法請參照Timimg datatype。 | ||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
extension | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
event | Σ | 0..* | dateTime | 事件發生的時間 | ||||
repeat | SΣC | 0..1 | Element | 事件定期重複發生的時間 tim-1: if there's a duration, there needs to be duration units tim-2: if there's a period, there needs to be period units tim-4: duration SHALL be a non-negative value tim-5: period SHALL be a non-negative value tim-6: If there's a periodMax, there must be a period tim-7: If there's a durationMax, there must be a duration tim-8: If there's a countMax, there must be a count tim-9: If there's an offset, there must be a when (and not C, CM, CD, CV) tim-10: If there's a timeOfDay, there cannot be a when, or vice versa | ||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
extension | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
bounds[x] | Σ | 0..1 | 時間或期間長度/長度範圍,或(開始和/或結束)限制 | |||||
boundsDuration | Duration | |||||||
boundsRange | Range | |||||||
boundsPeriod | Period | |||||||
count | SΣ | 0..1 | positiveInt | 重複的次數 | ||||
countMax | Σ | 0..1 | positiveInt | 重複的最大次數 | ||||
duration | SΣ | 0..1 | decimal | 此事件持續多久時間 | ||||
durationMax | Σ | 0..1 | decimal | 此事件持續多久時間 (最長時間/最大值) | ||||
durationUnit | SΣ | 0..1 | code | s | min | h | d | wk | mo | a - 單位時間 (unit of time,UCUM) Binding: UnitsOfTime (required): 時間的單位(單位來自UCUM);應填入UnitsOfTime值集中的其中一個代碼 | ||||
frequency | SΣ | 0..1 | positiveInt | 此事件於每一期間的發生頻率 | ||||
frequencyMax | Σ | 0..1 | positiveInt | 此事件於每一期間的最大發生頻率 | ||||
period | SΣ | 0..1 | decimal | 此事件於特定時間區間所發生的頻率 | ||||
periodMax | Σ | 0..1 | decimal | 時間區間的上限(3-4小時) | ||||
periodUnit | SΣ | 0..1 | code | s | min | h | d | wk | mo | a - 單位時間 (unit of time,UCUM) Binding: UnitsOfTime (required): 時間的單位(單位來自UCUM);應填入UnitsOfTime值集中的其中一個代碼 | ||||
dayOfWeek | SΣ | 0..* | code | mon | tue | wed | thu | fri | sat | sun Binding: DaysOfWeek (required): 應填入DaysOfWeek值集中的其中一個代碼 | ||||
timeOfDay | SΣ | 0..* | time | 一天中的活動時間 | ||||
when | Σ | 0..* | code | 事件發生的時間區間之代碼 Binding: EventTiming (required): 與時程表有關的真實世界事件;應填入EventTiming值集中的其中一個代碼 | ||||
offset | Σ | 0..1 | unsignedInt | 事件的分鐘數(之前或之後) | ||||
code | S | 0..1 | CodeableConceptTW | BID | TID | QID | AM | PM | QD | QOD | + Binding: TimingAbbreviation (preferred): 已知/確定的時間模式之代碼;鼓勵使用TimingAbbreviation值集中的代碼,但不強制一定要使用此值集,你也可使用其他值集的代碼或單純以文字表示。 | ||||
id | 0..1 | string | 唯一可識別ID,以供資料項目間相互參照。 | |||||
extension | 0..* | Extension | 擴充的資料項目 Slice: Unordered, Open by value:url | |||||
coding | S | 0..* | CodingTW | 由專門術語系統(terminology system)定義的代碼。此資料項目為可擴充綁定預設國際標準值集,但實作者可視實務專案需求只綁定以下slices中的任一值集。目前未只限定綁定預設值集是因為尚無slice值集與預設國際標準值集的代碼對應表,待後續有相對的代碼對應表後將建議採用國際標準值集作為唯一綁定值集並針對該值集進行擴充與管理,以利進行跨國與跨系統之資料交換。 Binding: HL7 TimingAbbreviation + 臺灣健保署藥品使用頻率值集 (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | ||||
text | SΣ | 0..1 | string | 概念的文字標記法 | ||||
asNeeded[x] | Σ | 0..1 | 「根據(對x的)需要」服用
Binding:一個編碼概念,指明在服用或用藥之前應滿足或評估的先決條件。例如:「疼痛」、「性行為前30分鐘」、「發作時」等;可參考SNOMEDCTMedicationAsNeededReasonCodes值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。 Binding: SNOMEDCTMedicationAsNeededReasonCodes (extensible): 一個編碼概念,指明在服用或用藥之前應滿足或評估的先決條件。例如:「疼痛」、「性行為前30分鐘」、「發作時」等;應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | |||||
asNeededBoolean | boolean | |||||||
asNeededCodeableConcept | CodeableConcept | |||||||
site | Σ | 0..1 | CodeableConcept | 用藥之身體部位 Binding: SNOMEDCTAnatomicalStructureForAdministrationSiteCodes (extensible): 一個編碼概念,描述藥品進入或在身體上的位置;可參考所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | ||||
route | S | 0..1 | CodeableConceptTW | 藥品應如何進入體內 Binding: SNOMEDCTRouteCodes (example): A coded concept describing the route or physiological path of administration of a therapeutic agent into or onto the body of a subject. | ||||
id | 0..1 | string | 唯一可識別ID,以供資料項目間相互參照。 | |||||
extension | 0..* | Extension | 擴充的資料項目 Slice: Unordered, Open by value:url | |||||
coding | S | 0..* | CodingTW | 由專門術語系統(terminology system)定義的代碼。此資料項目為可擴充綁定預設國際標準值集,但實作者可視實務專案需求只綁定以下slices中的任一值集。目前未只限定綁定預設值集是因為尚無slice值集與預設國際標準值集的代碼對應表,待後續有相對的代碼對應表後將建議採用國際標準值集作為唯一綁定值集並針對該值集進行擴充與管理,以利進行跨國與跨系統之資料交換。 Binding: SNOMED CT + 臺灣健保署給藥途徑值集 (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | ||||
text | SΣ | 0..1 | string | 概念的文字標記法 | ||||
method | 0..1 | CodeableConceptTW | 用藥的技術 Binding: SNOMEDCTAdministrationMethodCodes (extensible): 一個編碼概念,描述用藥的技術;可參考所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | |||||
doseAndRate | Σ | 0..* | Element | 用藥量 | ||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
extension | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
type | 0..1 | CodeableConceptTW | 特定劑量或比率種類 Binding: DoseAndRateType (example): 可參考DoseAndRateType值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。 | |||||
dose[x] | SΣ | 0..1 | 每一劑量的藥量 | |||||
doseRange | Range | |||||||
doseQuantity | Quantity(SimpleQuantity) | |||||||
rate[x] | SΣ | 0..1 | 每時間單位內的用藥量 | |||||
rateRatio | Ratio | |||||||
rateRange | Range | |||||||
rateQuantity | Quantity(SimpleQuantity) | |||||||
maxDosePerPeriod | Σ | 0..1 | Ratio | 每時間單位內用藥的上限 | ||||
maxDosePerAdministration | Σ | 0..1 | SimpleQuantity | 每次用藥的上限 | ||||
maxDosePerLifetime | Σ | 0..1 | SimpleQuantity | 病人一生中用藥的上限 | ||||
Documentation for this format |
Path | Conformance | ValueSet | URI | |||
MedicationStatement.language | preferred | CommonLanguages
http://hl7.org/fhir/ValueSet/languages from the FHIR Standard | ||||
MedicationStatement.status | required | Medication Status Codeshttp://hl7.org/fhir/ValueSet/medication-statement-status|4.0.1 from the FHIR Standard | ||||
MedicationStatement.statusReason | extensible | SNOMEDCTDrugTherapyStatusCodeshttp://hl7.org/fhir/ValueSet/reason-medication-status-codes from the FHIR Standard | ||||
MedicationStatement.category | preferred | Medication usage category codeshttp://hl7.org/fhir/ValueSet/medication-statement-category from the FHIR Standard | ||||
MedicationStatement.medication[x] | example | SNOMEDCTMedicationCodeshttp://hl7.org/fhir/ValueSet/medication-codes from the FHIR Standard | ||||
MedicationStatement.medication[x]:medicationCodeableConcept | example | SNOMEDCTMedicationCodeshttp://hl7.org/fhir/ValueSet/medication-codes from the FHIR Standard | ||||
MedicationStatement.medication[x]:medicationCodeableConcept.coding:fda-medication-tw | required | TWMedicationFDAhttps://twcore.mohw.gov.tw/ig/twcore/ValueSet/medication-fda-tw from this IG | ||||
MedicationStatement.medication[x]:medicationCodeableConcept.coding:nhi-medication-tw | required | TWMedicationNHI (a valid code from 臺灣健保署健保用藥品項代碼)https://twcore.mohw.gov.tw/ig/twcore/ValueSet/medication-nhi-tw from this IG | ||||
MedicationStatement.medication[x]:medicationCodeableConcept.coding:nhi-medication-ch-herb-tw | required | TWCHHerbMedicationNHI (a valid code from 臺灣健保署中藥用藥品項)https://twcore.mohw.gov.tw/ig/twcore/ValueSet/nhi-medication-ch-herb-tw from this IG | ||||
MedicationStatement.medication[x]:medicationCodeableConcept.coding:rxnorm-medication-us-core | required | TWMedicationRXNORMhttps://twcore.mohw.gov.tw/ig/twcore/ValueSet/medication-rxnorm-tw from this IG | ||||
MedicationStatement.medication[x]:medicationCodeableConcept.coding:atc-medication-code | required | TWMedcationATChttps://twcore.mohw.gov.tw/ig/twcore/ValueSet/medcation-atc-tw from this IG | ||||
MedicationStatement.medication[x]:medicationCodeableConcept.coding:snomedct-medication-codes | required | SNOMEDCTMedicationCodeshttp://hl7.org/fhir/ValueSet/medication-codes from the FHIR Standard | ||||
MedicationStatement.reasonCode | extensible | Condition/Problem/DiagnosisCodeshttp://hl7.org/fhir/ValueSet/condition-code from the FHIR Standard | ||||
MedicationStatement.dosage.additionalInstruction | extensible | SNOMEDCTAdditionalDosageInstructionshttp://hl7.org/fhir/ValueSet/additional-instruction-codes from the FHIR Standard | ||||
MedicationStatement.dosage.timing.repeat.durationUnit | required | UnitsOfTimehttp://hl7.org/fhir/ValueSet/units-of-time|4.0.1 from the FHIR Standard | ||||
MedicationStatement.dosage.timing.repeat.periodUnit | required | UnitsOfTimehttp://hl7.org/fhir/ValueSet/units-of-time|4.0.1 from the FHIR Standard | ||||
MedicationStatement.dosage.timing.repeat.dayOfWeek | required | DaysOfWeekhttp://hl7.org/fhir/ValueSet/days-of-week|4.0.1 from the FHIR Standard | ||||
MedicationStatement.dosage.timing.repeat.when | required | EventTiminghttp://hl7.org/fhir/ValueSet/event-timing|4.0.1 from the FHIR Standard | ||||
MedicationStatement.dosage.timing.code | preferred | TimingAbbreviationhttp://hl7.org/fhir/ValueSet/timing-abbreviation from the FHIR Standard | ||||
MedicationStatement.dosage.timing.code.coding | extensible | TWMedicationFrequencyHL7https://twcore.mohw.gov.tw/ig/twcore/ValueSet/medication-frequency-hl7-tw from this IG | ||||
MedicationStatement.dosage.asNeeded[x] | extensible | SNOMEDCTMedicationAsNeededReasonCodeshttp://hl7.org/fhir/ValueSet/medication-as-needed-reason from the FHIR Standard | ||||
MedicationStatement.dosage.site | extensible | SNOMEDCTAnatomicalStructureForAdministrationSiteCodeshttp://hl7.org/fhir/ValueSet/approach-site-codes from the FHIR Standard | ||||
MedicationStatement.dosage.route | example | SNOMEDCTRouteCodeshttp://hl7.org/fhir/ValueSet/route-codes from the FHIR Standard | ||||
MedicationStatement.dosage.route.coding | extensible | TWMedicationPathSCThttps://twcore.mohw.gov.tw/ig/twcore/ValueSet/medication-path-sct-tw from this IG | ||||
MedicationStatement.dosage.method | extensible | SNOMEDCTAdministrationMethodCodeshttp://hl7.org/fhir/ValueSet/administration-method-codes from the FHIR Standard | ||||
MedicationStatement.dosage.doseAndRate.type | example | DoseAndRateTypehttp://hl7.org/fhir/ValueSet/dose-rate-type from the FHIR Standard |
Id | Grade | Path(s) | Details | Requirements |
dom-2 | error | MedicationStatement | If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty() | |
dom-3 | error | MedicationStatement | 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 | MedicationStatement | 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 | MedicationStatement | If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty() | |
dom-6 | best practice | MedicationStatement | 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() | |
tim-1 | error | MedicationStatement.dosage.timing.repeat | if there's a duration, there needs to be duration units : duration.empty() or durationUnit.exists() | |
tim-2 | error | MedicationStatement.dosage.timing.repeat | if there's a period, there needs to be period units : period.empty() or periodUnit.exists() | |
tim-4 | error | MedicationStatement.dosage.timing.repeat | duration SHALL be a non-negative value : duration.exists() implies duration >= 0 | |
tim-5 | error | MedicationStatement.dosage.timing.repeat | period SHALL be a non-negative value : period.exists() implies period >= 0 | |
tim-6 | error | MedicationStatement.dosage.timing.repeat | If there's a periodMax, there must be a period : periodMax.empty() or period.exists() | |
tim-7 | error | MedicationStatement.dosage.timing.repeat | If there's a durationMax, there must be a duration : durationMax.empty() or duration.exists() | |
tim-8 | error | MedicationStatement.dosage.timing.repeat | If there's a countMax, there must be a count : countMax.empty() or count.exists() | |
tim-9 | error | MedicationStatement.dosage.timing.repeat | If there's an offset, there must be a when (and not C, CM, CD, CV) : offset.empty() or (when.exists() and ((when in ('C' | 'CM' | 'CD' | 'CV')).not())) | |
tim-10 | error | MedicationStatement.dosage.timing.repeat | If there's a timeOfDay, there cannot be a when, or vice versa : timeOfDay.empty() or when.empty() |
This structure is derived from MedicationStatement
Summary
Must-Support: 32 elements
Structures
This structure refers to these other structures:
Slices
This structure defines the following Slices:
Differential View
This structure is derived from MedicationStatement
Name | Flags | Card. | Type | Description & Constraints | ||||
---|---|---|---|---|---|---|---|---|
MedicationStatement | 0..* | MedicationStatement | 病人正在服用的藥品紀錄 | |||||
id | 0..1 | id | 不重複的ID用以識別儲存在特定FHIR Server中的MedicationStatement紀錄,通常又稱為邏輯性ID。 | |||||
meta | 0..1 | Meta | 此MedicationStatement Resource的metadata | |||||
implicitRules | 0..1 | uri | 創建此內容所依據的一組規則 | |||||
language | 0..1 | code | 用以表述MedicationStatement Resource內容的語言。 Binding: CommonLanguages (preferred): 人類語言;鼓勵使用CommonLanguages代碼表中的代碼,但不強制一定要使用此代碼表,你也可使用其他代碼表的代碼或單純以文字表示。
Example Value: zh-TW | |||||
text | 0..1 | Narrative | MedicationStatement Resource之內容摘要以供人閱讀 | |||||
identifier | S | 0..* | Identifier | 用藥聲明的外部識別碼 | ||||
basedOn | 0..* | Reference(TW Core MedicationRequest | TW Core CarePlan | TW Core ServiceRequest) | 此用藥聲明是為了達成或實現哪個計劃、提案或醫令 | |||||
partOf | 0..* | Reference(MedicationAdministration | TW Core MedicationDispense | TW Core MedicationStatement | TW Core Procedure | TW Core Observation Laboratory Result) | 參照事件的一部分 | |||||
status | S | 1..1 | code | active | completed | entered-in-error | intended | stopped | on-hold | unknown | not-taken Binding: Medication Status Codes (required): 指明用藥聲明的當前狀態;應填入所綁定值集中的其中一個代碼 | ||||
statusReason | 0..* | CodeableConceptTW | 當前狀態的原因 Binding: SNOMEDCTDrugTherapyStatusCodes (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | |||||
category | S | 0..1 | CodeableConceptTW | 藥品使用的類型 Binding: Medication usage category codes (preferred): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | ||||
Slices for medication[x] | S | 1..1 | 所提供的藥品 Slice: Unordered, Open by type:$this | |||||
medicationCodeableConcept | CodeableConcept(CodeableConceptTW) | |||||||
medicationReference | Reference(TW Core Medication) | |||||||
medication[x]:medicationReference | 0..1 | Reference(TW Core Medication) | What medication was taken | |||||
medication[x]:medicationCodeableConcept | 0..1 | CodeableConceptTW | 所提供的藥品。此資料項目為可擴充綁定預設國際標準值集,但實作者可視實務專案需求只綁定以下slices中的任一值集。目前未只限定綁定預設值集是因為尚無slice值集與預設國際標準值集的代碼對應表,待後續有相對的代碼對應表後將建議採用國際標準值集作為唯一綁定值集並針對該值集進行擴充與管理,以利進行跨國與跨系統之資料交換。 | |||||
Slices for coding | 0..* | CodingTW | 由專門術語系統(terminology system)定義的代碼 Slice: Unordered, Open by pattern:$this | |||||
coding:fda-medication-tw | S | 0..1 | CodingTW | 此為臺灣食品藥物管理署(TFDA)維護之藥品代碼,涵蓋範圍相對完整,可免費使用,可優先選用此代碼。 Binding: 臺灣食藥署藥品及醫療器材代碼值集 (required): 應填入所綁定值集中的其中一個代碼。 | ||||
coding:nhi-medication-tw | S | 0..1 | CodingTW | 此為中央健康保險署(NHI)維護之藥品代碼,主要針對申報使用,更新頻率相對頻繁,可免費使用,可依情境選用此代碼。 Binding: 臺灣健保署用藥品項代碼值集 (required): 應填入所綁定值集中的其中一個代碼。 | ||||
coding:nhi-medication-ch-herb-tw | 0..1 | CodingTW | 此為中央健康保險署(NHI)維護之中藥藥品代碼,主要針對申報使用,更新頻率相對頻繁,可免費使用,可依情境選用此代碼。 Binding: 臺灣健保署中藥用藥品項值集 (required): 應填入所綁定值集中的其中一個代碼。 | |||||
coding:rxnorm-medication-us-core | S | 0..1 | CodingTW | RxNorm為美國Unified Medical Language System®中的藥品代碼,取得UMLS®授權即可免費使用,可依情境選用此代碼。 Binding: RxNorm藥品代碼值集 (required): 應填入所綁定值集中的其中一個代碼。 | ||||
coding:atc-medication-code | S | 0..1 | CodingTW | ATC代碼的版權為世界衛生組織(WHO)Collaborating Centre for Drug Statistics Methodology,可免費使用,可依情境選用此代碼。 Binding: 臺灣食藥署藥品藥理治療分類ATC碼值集 (required): 應填入所綁定值集中的其中一個代碼。 | ||||
coding:snomedct-medication-codes | S | 0..1 | CodingTW | 此為SNOMED CT代碼,若機構已有購買相關授權,亦可使用。 Binding: SNOMEDCTMedicationCodes (required): 可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。 | ||||
subject | S | 1..1 | Reference(TW Core Patient | Group) | 指明目前正在使用的藥品。這可能是一個連結到代表藥品詳細資訊的resource,或者是一個帶有代碼的簡單屬性,從已知藥品清單中表明藥品的代碼。 | ||||
context | S | 0..1 | Reference(TW Core Encounter | EpisodeOfCare) | 與此用藥聲明相關的就醫事件(Encounter / Episode) | ||||
effective[x] | S | 0..1 | dateTime, Period | 用藥的日期/時間或間隔 | ||||
dateAsserted | 0..1 | dateTime | 此聲明是何時提出的? | |||||
informationSource | 0..1 | Reference(TW Core Patient | TW Core Practitioner | TW Core PractitionerRole | TW Core RelatedPerson | TW Core Organization) | 提供有關服用此藥品資訊的個人或機構 | |||||
derivedFrom | 0..* | Reference(Resource) | 額外的補充資料 | |||||
reasonCode | 0..* | CodeableConceptTW | 指明目前正在使用的藥品 Binding: Condition/Problem/DiagnosisCodes (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | |||||
reasonReference | 0..* | Reference(TW Core Condition | TW Core Observation Laboratory Result | TW Core DiagnosticReport) | 證明目前正在/曾經用藥原因之Condition或Observation | |||||
note | 0..* | Annotation | 有關此聲明的更多資訊 | |||||
dosage | S | 0..* | Dosage | 藥品目前正被/曾經被服用或應該如何服用的細節 | ||||
sequence | S | 0..1 | integer | 劑量指示的順序 | ||||
text | S | 0..1 | string | 純文字表述的劑量指示,例如:SIG。 | ||||
additionalInstruction | 0..* | CodeableConceptTW | 對病人的補充指示或警告-例如:「隨餐服用」,「可能引起嗜睡」 Binding: SNOMEDCTAdditionalDosageInstructions (extensible): 一個編碼的概念,確定額外的指示,如「與水一起服用」或「避免操作重型機器」;可參考所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | |||||
patientInstruction | S | 0..1 | string | 以病人或消費者為導向的指示 | ||||
timing | S | 0..1 | Timing | 應該何時給藥;時間的寫法請參照Timimg datatype。 | ||||
event | 0..* | dateTime | 事件發生的時間 | |||||
repeat | S | 0..1 | Element | 事件定期重複發生的時間 | ||||
bounds[x] | 0..1 | Duration, Range, Period | 時間或期間長度/長度範圍,或(開始和/或結束)限制 | |||||
count | S | 0..1 | positiveInt | 重複的次數 | ||||
countMax | 0..1 | positiveInt | 重複的最大次數 | |||||
duration | S | 0..1 | decimal | 此事件持續多久時間 | ||||
durationMax | 0..1 | decimal | 此事件持續多久時間 (最長時間/最大值) | |||||
durationUnit | S | 0..1 | code | s | min | h | d | wk | mo | a - 單位時間 (unit of time,UCUM) Binding: UnitsOfTime (required): 時間的單位(單位來自UCUM);應填入UnitsOfTime值集中的其中一個代碼 | ||||
frequency | S | 0..1 | positiveInt | 此事件於每一期間的發生頻率 | ||||
frequencyMax | 0..1 | positiveInt | 此事件於每一期間的最大發生頻率 | |||||
period | S | 0..1 | decimal | 此事件於特定時間區間所發生的頻率 | ||||
periodMax | 0..1 | decimal | 時間區間的上限(3-4小時) | |||||
periodUnit | S | 0..1 | code | s | min | h | d | wk | mo | a - 單位時間 (unit of time,UCUM) Binding: UnitsOfTime (required): 時間的單位(單位來自UCUM);應填入UnitsOfTime值集中的其中一個代碼 | ||||
dayOfWeek | S | 0..* | code | mon | tue | wed | thu | fri | sat | sun Binding: DaysOfWeek (required): 應填入DaysOfWeek值集中的其中一個代碼 | ||||
timeOfDay | S | 0..* | time | 一天中的活動時間 | ||||
when | 0..* | code | 事件發生的時間區間之代碼 Binding: EventTiming (required): 與時程表有關的真實世界事件;應填入EventTiming值集中的其中一個代碼 | |||||
offset | 0..1 | unsignedInt | 事件的分鐘數(之前或之後) | |||||
code | S | 0..1 | CodeableConceptTW | BID | TID | QID | AM | PM | QD | QOD | + Binding: TimingAbbreviation (preferred): 已知/確定的時間模式之代碼;鼓勵使用TimingAbbreviation值集中的代碼,但不強制一定要使用此值集,你也可使用其他值集的代碼或單純以文字表示。 | ||||
coding | 0..* | CodingTW | 由專門術語系統(terminology system)定義的代碼。此資料項目為可擴充綁定預設國際標準值集,但實作者可視實務專案需求只綁定以下slices中的任一值集。目前未只限定綁定預設值集是因為尚無slice值集與預設國際標準值集的代碼對應表,待後續有相對的代碼對應表後將建議採用國際標準值集作為唯一綁定值集並針對該值集進行擴充與管理,以利進行跨國與跨系統之資料交換。 Binding: HL7 TimingAbbreviation + 臺灣健保署藥品使用頻率值集 (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | |||||
text | S | 0..1 | string | 概念的文字標記法 | ||||
asNeeded[x] | 0..1 | boolean, CodeableConcept | 「根據(對x的)需要」服用
Binding:一個編碼概念,指明在服用或用藥之前應滿足或評估的先決條件。例如:「疼痛」、「性行為前30分鐘」、「發作時」等;可參考SNOMEDCTMedicationAsNeededReasonCodes值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。 Binding: SNOMEDCTMedicationAsNeededReasonCodes (extensible): 一個編碼概念,指明在服用或用藥之前應滿足或評估的先決條件。例如:「疼痛」、「性行為前30分鐘」、「發作時」等;應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | |||||
site | 0..1 | CodeableConcept | 用藥之身體部位 Binding: SNOMEDCTAnatomicalStructureForAdministrationSiteCodes (extensible): 一個編碼概念,描述藥品進入或在身體上的位置;可參考所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | |||||
route | S | 0..1 | CodeableConceptTW | 藥品應如何進入體內 | ||||
coding | 0..* | CodingTW | 由專門術語系統(terminology system)定義的代碼。此資料項目為可擴充綁定預設國際標準值集,但實作者可視實務專案需求只綁定以下slices中的任一值集。目前未只限定綁定預設值集是因為尚無slice值集與預設國際標準值集的代碼對應表,待後續有相對的代碼對應表後將建議採用國際標準值集作為唯一綁定值集並針對該值集進行擴充與管理,以利進行跨國與跨系統之資料交換。 Binding: SNOMED CT + 臺灣健保署給藥途徑值集 (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | |||||
text | S | 0..1 | string | 概念的文字標記法 | ||||
method | 0..1 | CodeableConceptTW | 用藥的技術 Binding: SNOMEDCTAdministrationMethodCodes (extensible): 一個編碼概念,描述用藥的技術;可參考所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | |||||
doseAndRate | 0..* | Element | 用藥量 | |||||
type | 0..1 | CodeableConceptTW | 特定劑量或比率種類 Binding: DoseAndRateType (example): 可參考DoseAndRateType值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。 | |||||
dose[x] | S | 0..1 | Range, SimpleQuantity | 每一劑量的藥量 | ||||
rate[x] | S | 0..1 | Ratio, Range, SimpleQuantity | 每時間單位內的用藥量 | ||||
maxDosePerPeriod | 0..1 | Ratio | 每時間單位內用藥的上限 | |||||
maxDosePerAdministration | 0..1 | SimpleQuantity | 每次用藥的上限 | |||||
maxDosePerLifetime | 0..1 | SimpleQuantity | 病人一生中用藥的上限 | |||||
Documentation for this format |
Path | Conformance | ValueSet | URI | |||
MedicationStatement.language | preferred | CommonLanguages
http://hl7.org/fhir/ValueSet/languages from the FHIR Standard | ||||
MedicationStatement.status | required | Medication Status Codeshttp://hl7.org/fhir/ValueSet/medication-statement-status|4.0.1 from the FHIR Standard | ||||
MedicationStatement.statusReason | extensible | SNOMEDCTDrugTherapyStatusCodeshttp://hl7.org/fhir/ValueSet/reason-medication-status-codes from the FHIR Standard | ||||
MedicationStatement.category | preferred | Medication usage category codeshttp://hl7.org/fhir/ValueSet/medication-statement-category from the FHIR Standard | ||||
MedicationStatement.medication[x]:medicationCodeableConcept.coding:fda-medication-tw | required | TWMedicationFDAhttps://twcore.mohw.gov.tw/ig/twcore/ValueSet/medication-fda-tw from this IG | ||||
MedicationStatement.medication[x]:medicationCodeableConcept.coding:nhi-medication-tw | required | TWMedicationNHI (a valid code from 臺灣健保署健保用藥品項代碼)https://twcore.mohw.gov.tw/ig/twcore/ValueSet/medication-nhi-tw from this IG | ||||
MedicationStatement.medication[x]:medicationCodeableConcept.coding:nhi-medication-ch-herb-tw | required | TWCHHerbMedicationNHI (a valid code from 臺灣健保署中藥用藥品項)https://twcore.mohw.gov.tw/ig/twcore/ValueSet/nhi-medication-ch-herb-tw from this IG | ||||
MedicationStatement.medication[x]:medicationCodeableConcept.coding:rxnorm-medication-us-core | required | TWMedicationRXNORMhttps://twcore.mohw.gov.tw/ig/twcore/ValueSet/medication-rxnorm-tw from this IG | ||||
MedicationStatement.medication[x]:medicationCodeableConcept.coding:atc-medication-code | required | TWMedcationATChttps://twcore.mohw.gov.tw/ig/twcore/ValueSet/medcation-atc-tw from this IG | ||||
MedicationStatement.medication[x]:medicationCodeableConcept.coding:snomedct-medication-codes | required | SNOMEDCTMedicationCodeshttp://hl7.org/fhir/ValueSet/medication-codes from the FHIR Standard | ||||
MedicationStatement.reasonCode | extensible | Condition/Problem/DiagnosisCodeshttp://hl7.org/fhir/ValueSet/condition-code from the FHIR Standard | ||||
MedicationStatement.dosage.additionalInstruction | extensible | SNOMEDCTAdditionalDosageInstructionshttp://hl7.org/fhir/ValueSet/additional-instruction-codes from the FHIR Standard | ||||
MedicationStatement.dosage.timing.repeat.durationUnit | required | UnitsOfTimehttp://hl7.org/fhir/ValueSet/units-of-time|4.0.1 from the FHIR Standard | ||||
MedicationStatement.dosage.timing.repeat.periodUnit | required | UnitsOfTimehttp://hl7.org/fhir/ValueSet/units-of-time|4.0.1 from the FHIR Standard | ||||
MedicationStatement.dosage.timing.repeat.dayOfWeek | required | DaysOfWeekhttp://hl7.org/fhir/ValueSet/days-of-week|4.0.1 from the FHIR Standard | ||||
MedicationStatement.dosage.timing.repeat.when | required | EventTiminghttp://hl7.org/fhir/ValueSet/event-timing|4.0.1 from the FHIR Standard | ||||
MedicationStatement.dosage.timing.code | preferred | TimingAbbreviationhttp://hl7.org/fhir/ValueSet/timing-abbreviation from the FHIR Standard | ||||
MedicationStatement.dosage.timing.code.coding | extensible | TWMedicationFrequencyHL7https://twcore.mohw.gov.tw/ig/twcore/ValueSet/medication-frequency-hl7-tw from this IG | ||||
MedicationStatement.dosage.asNeeded[x] | extensible | SNOMEDCTMedicationAsNeededReasonCodeshttp://hl7.org/fhir/ValueSet/medication-as-needed-reason from the FHIR Standard | ||||
MedicationStatement.dosage.site | extensible | SNOMEDCTAnatomicalStructureForAdministrationSiteCodeshttp://hl7.org/fhir/ValueSet/approach-site-codes from the FHIR Standard | ||||
MedicationStatement.dosage.route.coding | extensible | TWMedicationPathSCThttps://twcore.mohw.gov.tw/ig/twcore/ValueSet/medication-path-sct-tw from this IG | ||||
MedicationStatement.dosage.method | extensible | SNOMEDCTAdministrationMethodCodeshttp://hl7.org/fhir/ValueSet/administration-method-codes from the FHIR Standard | ||||
MedicationStatement.dosage.doseAndRate.type | example | DoseAndRateTypehttp://hl7.org/fhir/ValueSet/dose-rate-type from the FHIR Standard |
Key Elements View
Name | Flags | Card. | Type | Description & Constraints | ||||
---|---|---|---|---|---|---|---|---|
MedicationStatement | 0..* | MedicationStatement | 病人正在服用的藥品紀錄 | |||||
id | Σ | 0..1 | id | 不重複的ID用以識別儲存在特定FHIR Server中的MedicationStatement紀錄,通常又稱為邏輯性ID。 | ||||
meta | Σ | 0..1 | Meta | 此MedicationStatement Resource的metadata | ||||
implicitRules | ?!Σ | 0..1 | uri | 創建此內容所依據的一組規則 | ||||
language | 0..1 | code | 用以表述MedicationStatement Resource內容的語言。 Binding: CommonLanguages (preferred): 人類語言;鼓勵使用CommonLanguages代碼表中的代碼,但不強制一定要使用此代碼表,你也可使用其他代碼表的代碼或單純以文字表示。
Example Value: zh-TW | |||||
text | 0..1 | Narrative | MedicationStatement Resource之內容摘要以供人閱讀 | |||||
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored | ||||
identifier | SΣ | 0..* | Identifier | 用藥聲明的外部識別碼 | ||||
basedOn | Σ | 0..* | Reference(TW Core MedicationRequest | TW Core CarePlan | TW Core ServiceRequest) | 此用藥聲明是為了達成或實現哪個計劃、提案或醫令 | ||||
partOf | Σ | 0..* | Reference(MedicationAdministration | TW Core MedicationDispense | TW Core MedicationStatement | TW Core Procedure | TW Core Observation Laboratory Result) | 參照事件的一部分 | ||||
status | ?!SΣ | 1..1 | code | active | completed | entered-in-error | intended | stopped | on-hold | unknown | not-taken Binding: Medication Status Codes (required): 指明用藥聲明的當前狀態;應填入所綁定值集中的其中一個代碼 | ||||
statusReason | 0..* | CodeableConceptTW | 當前狀態的原因 Binding: SNOMEDCTDrugTherapyStatusCodes (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | |||||
category | S | 0..1 | CodeableConceptTW | 藥品使用的類型 Binding: Medication usage category codes (preferred): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | ||||
Slices for medication[x] | SΣ | 1..1 | 所提供的藥品 Slice: Unordered, Closed by type:$this Binding: SNOMEDCTMedicationCodes (example): A coded concept identifying the substance or product being taken. | |||||
medicationCodeableConcept | CodeableConcept(CodeableConceptTW) | |||||||
medicationReference | Reference(TW Core Medication) | |||||||
medication[x]:medicationReference | Σ | 0..1 | Reference(TW Core Medication) | What medication was taken | ||||
medication[x]:medicationCodeableConcept | 0..1 | CodeableConceptTW | 所提供的藥品。此資料項目為可擴充綁定預設國際標準值集,但實作者可視實務專案需求只綁定以下slices中的任一值集。目前未只限定綁定預設值集是因為尚無slice值集與預設國際標準值集的代碼對應表,待後續有相對的代碼對應表後將建議採用國際標準值集作為唯一綁定值集並針對該值集進行擴充與管理,以利進行跨國與跨系統之資料交換。 Binding: SNOMEDCTMedicationCodes (example): A coded concept identifying the substance or product being taken. | |||||
Slices for coding | S | 0..* | CodingTW | 由專門術語系統(terminology system)定義的代碼 Slice: Unordered, Open by pattern:$this | ||||
coding:fda-medication-tw | S | 0..1 | CodingTW | 此為臺灣食品藥物管理署(TFDA)維護之藥品代碼,涵蓋範圍相對完整,可免費使用,可優先選用此代碼。 Binding: 臺灣食藥署藥品及醫療器材代碼值集 (required): 應填入所綁定值集中的其中一個代碼。 | ||||
coding:nhi-medication-tw | S | 0..1 | CodingTW | 此為中央健康保險署(NHI)維護之藥品代碼,主要針對申報使用,更新頻率相對頻繁,可免費使用,可依情境選用此代碼。 Binding: 臺灣健保署用藥品項代碼值集 (required): 應填入所綁定值集中的其中一個代碼。 | ||||
coding:nhi-medication-ch-herb-tw | S | 0..1 | CodingTW | 此為中央健康保險署(NHI)維護之中藥藥品代碼,主要針對申報使用,更新頻率相對頻繁,可免費使用,可依情境選用此代碼。 Binding: 臺灣健保署中藥用藥品項值集 (required): 應填入所綁定值集中的其中一個代碼。 | ||||
coding:rxnorm-medication-us-core | S | 0..1 | CodingTW | RxNorm為美國Unified Medical Language System®中的藥品代碼,取得UMLS®授權即可免費使用,可依情境選用此代碼。 Binding: RxNorm藥品代碼值集 (required): 應填入所綁定值集中的其中一個代碼。 | ||||
coding:atc-medication-code | S | 0..1 | CodingTW | ATC代碼的版權為世界衛生組織(WHO)Collaborating Centre for Drug Statistics Methodology,可免費使用,可依情境選用此代碼。 Binding: 臺灣食藥署藥品藥理治療分類ATC碼值集 (required): 應填入所綁定值集中的其中一個代碼。 | ||||
coding:snomedct-medication-codes | S | 0..1 | CodingTW | 此為SNOMED CT代碼,若機構已有購買相關授權,亦可使用。 Binding: SNOMEDCTMedicationCodes (required): 可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。 | ||||
text | SΣ | 0..1 | string | 概念的文字表示法 | ||||
subject | SΣ | 1..1 | Reference(TW Core Patient | Group) | 指明目前正在使用的藥品。這可能是一個連結到代表藥品詳細資訊的resource,或者是一個帶有代碼的簡單屬性,從已知藥品清單中表明藥品的代碼。 | ||||
context | SΣ | 0..1 | Reference(TW Core Encounter | EpisodeOfCare) | 與此用藥聲明相關的就醫事件(Encounter / Episode) | ||||
effective[x] | SΣ | 0..1 | 用藥的日期/時間或間隔 | |||||
effectiveDateTime | dateTime | |||||||
effectivePeriod | Period | |||||||
dateAsserted | Σ | 0..1 | dateTime | 此聲明是何時提出的? | ||||
informationSource | 0..1 | Reference(TW Core Patient | TW Core Practitioner | TW Core PractitionerRole | TW Core RelatedPerson | TW Core Organization) | 提供有關服用此藥品資訊的個人或機構 | |||||
derivedFrom | 0..* | Reference(Resource) | 額外的補充資料 | |||||
reasonCode | 0..* | CodeableConceptTW | 指明目前正在使用的藥品 Binding: Condition/Problem/DiagnosisCodes (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | |||||
reasonReference | 0..* | Reference(TW Core Condition | TW Core Observation Laboratory Result | TW Core DiagnosticReport) | 證明目前正在/曾經用藥原因之Condition或Observation | |||||
note | 0..* | Annotation | 有關此聲明的更多資訊 | |||||
dosage | S | 0..* | Dosage | 藥品目前正被/曾經被服用或應該如何服用的細節 | ||||
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
sequence | SΣ | 0..1 | integer | 劑量指示的順序 | ||||
text | SΣ | 0..1 | string | 純文字表述的劑量指示,例如:SIG。 | ||||
additionalInstruction | 0..* | CodeableConceptTW | 對病人的補充指示或警告-例如:「隨餐服用」,「可能引起嗜睡」 Binding: SNOMEDCTAdditionalDosageInstructions (extensible): 一個編碼的概念,確定額外的指示,如「與水一起服用」或「避免操作重型機器」;可參考所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | |||||
patientInstruction | SΣ | 0..1 | string | 以病人或消費者為導向的指示 | ||||
timing | SΣ | 0..1 | Timing | 應該何時給藥;時間的寫法請參照Timimg datatype。 | ||||
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
event | Σ | 0..* | dateTime | 事件發生的時間 | ||||
repeat | SΣC | 0..1 | Element | 事件定期重複發生的時間 tim-1: if there's a duration, there needs to be duration units tim-2: if there's a period, there needs to be period units tim-4: duration SHALL be a non-negative value tim-5: period SHALL be a non-negative value tim-6: If there's a periodMax, there must be a period tim-7: If there's a durationMax, there must be a duration tim-8: If there's a countMax, there must be a count tim-9: If there's an offset, there must be a when (and not C, CM, CD, CV) tim-10: If there's a timeOfDay, there cannot be a when, or vice versa | ||||
bounds[x] | Σ | 0..1 | 時間或期間長度/長度範圍,或(開始和/或結束)限制 | |||||
boundsDuration | Duration | |||||||
boundsRange | Range | |||||||
boundsPeriod | Period | |||||||
count | SΣ | 0..1 | positiveInt | 重複的次數 | ||||
countMax | Σ | 0..1 | positiveInt | 重複的最大次數 | ||||
duration | SΣ | 0..1 | decimal | 此事件持續多久時間 | ||||
durationMax | Σ | 0..1 | decimal | 此事件持續多久時間 (最長時間/最大值) | ||||
durationUnit | SΣ | 0..1 | code | s | min | h | d | wk | mo | a - 單位時間 (unit of time,UCUM) Binding: UnitsOfTime (required): 時間的單位(單位來自UCUM);應填入UnitsOfTime值集中的其中一個代碼 | ||||
frequency | SΣ | 0..1 | positiveInt | 此事件於每一期間的發生頻率 | ||||
frequencyMax | Σ | 0..1 | positiveInt | 此事件於每一期間的最大發生頻率 | ||||
period | SΣ | 0..1 | decimal | 此事件於特定時間區間所發生的頻率 | ||||
periodMax | Σ | 0..1 | decimal | 時間區間的上限(3-4小時) | ||||
periodUnit | SΣ | 0..1 | code | s | min | h | d | wk | mo | a - 單位時間 (unit of time,UCUM) Binding: UnitsOfTime (required): 時間的單位(單位來自UCUM);應填入UnitsOfTime值集中的其中一個代碼 | ||||
dayOfWeek | SΣ | 0..* | code | mon | tue | wed | thu | fri | sat | sun Binding: DaysOfWeek (required): 應填入DaysOfWeek值集中的其中一個代碼 | ||||
timeOfDay | SΣ | 0..* | time | 一天中的活動時間 | ||||
when | Σ | 0..* | code | 事件發生的時間區間之代碼 Binding: EventTiming (required): 與時程表有關的真實世界事件;應填入EventTiming值集中的其中一個代碼 | ||||
offset | Σ | 0..1 | unsignedInt | 事件的分鐘數(之前或之後) | ||||
code | S | 0..1 | CodeableConceptTW | BID | TID | QID | AM | PM | QD | QOD | + Binding: TimingAbbreviation (preferred): 已知/確定的時間模式之代碼;鼓勵使用TimingAbbreviation值集中的代碼,但不強制一定要使用此值集,你也可使用其他值集的代碼或單純以文字表示。 | ||||
coding | S | 0..* | CodingTW | 由專門術語系統(terminology system)定義的代碼。此資料項目為可擴充綁定預設國際標準值集,但實作者可視實務專案需求只綁定以下slices中的任一值集。目前未只限定綁定預設值集是因為尚無slice值集與預設國際標準值集的代碼對應表,待後續有相對的代碼對應表後將建議採用國際標準值集作為唯一綁定值集並針對該值集進行擴充與管理,以利進行跨國與跨系統之資料交換。 Binding: HL7 TimingAbbreviation + 臺灣健保署藥品使用頻率值集 (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | ||||
text | SΣ | 0..1 | string | 概念的文字標記法 | ||||
asNeeded[x] | Σ | 0..1 | 「根據(對x的)需要」服用
Binding:一個編碼概念,指明在服用或用藥之前應滿足或評估的先決條件。例如:「疼痛」、「性行為前30分鐘」、「發作時」等;可參考SNOMEDCTMedicationAsNeededReasonCodes值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。 Binding: SNOMEDCTMedicationAsNeededReasonCodes (extensible): 一個編碼概念,指明在服用或用藥之前應滿足或評估的先決條件。例如:「疼痛」、「性行為前30分鐘」、「發作時」等;應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | |||||
asNeededBoolean | boolean | |||||||
asNeededCodeableConcept | CodeableConcept | |||||||
site | Σ | 0..1 | CodeableConcept | 用藥之身體部位 Binding: SNOMEDCTAnatomicalStructureForAdministrationSiteCodes (extensible): 一個編碼概念,描述藥品進入或在身體上的位置;可參考所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | ||||
route | S | 0..1 | CodeableConceptTW | 藥品應如何進入體內 Binding: SNOMEDCTRouteCodes (example): A coded concept describing the route or physiological path of administration of a therapeutic agent into or onto the body of a subject. | ||||
coding | S | 0..* | CodingTW | 由專門術語系統(terminology system)定義的代碼。此資料項目為可擴充綁定預設國際標準值集,但實作者可視實務專案需求只綁定以下slices中的任一值集。目前未只限定綁定預設值集是因為尚無slice值集與預設國際標準值集的代碼對應表,待後續有相對的代碼對應表後將建議採用國際標準值集作為唯一綁定值集並針對該值集進行擴充與管理,以利進行跨國與跨系統之資料交換。 Binding: SNOMED CT + 臺灣健保署給藥途徑值集 (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | ||||
text | SΣ | 0..1 | string | 概念的文字標記法 | ||||
method | 0..1 | CodeableConceptTW | 用藥的技術 Binding: SNOMEDCTAdministrationMethodCodes (extensible): 一個編碼概念,描述用藥的技術;可參考所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | |||||
doseAndRate | Σ | 0..* | Element | 用藥量 | ||||
type | 0..1 | CodeableConceptTW | 特定劑量或比率種類 Binding: DoseAndRateType (example): 可參考DoseAndRateType值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。 | |||||
dose[x] | SΣ | 0..1 | 每一劑量的藥量 | |||||
doseRange | Range | |||||||
doseQuantity | Quantity(SimpleQuantity) | |||||||
rate[x] | SΣ | 0..1 | 每時間單位內的用藥量 | |||||
rateRatio | Ratio | |||||||
rateRange | Range | |||||||
rateQuantity | Quantity(SimpleQuantity) | |||||||
maxDosePerPeriod | Σ | 0..1 | Ratio | 每時間單位內用藥的上限 | ||||
maxDosePerAdministration | Σ | 0..1 | SimpleQuantity | 每次用藥的上限 | ||||
maxDosePerLifetime | Σ | 0..1 | SimpleQuantity | 病人一生中用藥的上限 | ||||
Documentation for this format |
Path | Conformance | ValueSet | URI | |||
MedicationStatement.language | preferred | CommonLanguages
http://hl7.org/fhir/ValueSet/languages from the FHIR Standard | ||||
MedicationStatement.status | required | Medication Status Codeshttp://hl7.org/fhir/ValueSet/medication-statement-status|4.0.1 from the FHIR Standard | ||||
MedicationStatement.statusReason | extensible | SNOMEDCTDrugTherapyStatusCodeshttp://hl7.org/fhir/ValueSet/reason-medication-status-codes from the FHIR Standard | ||||
MedicationStatement.category | preferred | Medication usage category codeshttp://hl7.org/fhir/ValueSet/medication-statement-category from the FHIR Standard | ||||
MedicationStatement.medication[x] | example | SNOMEDCTMedicationCodeshttp://hl7.org/fhir/ValueSet/medication-codes from the FHIR Standard | ||||
MedicationStatement.medication[x]:medicationCodeableConcept | example | SNOMEDCTMedicationCodeshttp://hl7.org/fhir/ValueSet/medication-codes from the FHIR Standard | ||||
MedicationStatement.medication[x]:medicationCodeableConcept.coding:fda-medication-tw | required | TWMedicationFDAhttps://twcore.mohw.gov.tw/ig/twcore/ValueSet/medication-fda-tw from this IG | ||||
MedicationStatement.medication[x]:medicationCodeableConcept.coding:nhi-medication-tw | required | TWMedicationNHI (a valid code from 臺灣健保署健保用藥品項代碼)https://twcore.mohw.gov.tw/ig/twcore/ValueSet/medication-nhi-tw from this IG | ||||
MedicationStatement.medication[x]:medicationCodeableConcept.coding:nhi-medication-ch-herb-tw | required | TWCHHerbMedicationNHI (a valid code from 臺灣健保署中藥用藥品項)https://twcore.mohw.gov.tw/ig/twcore/ValueSet/nhi-medication-ch-herb-tw from this IG | ||||
MedicationStatement.medication[x]:medicationCodeableConcept.coding:rxnorm-medication-us-core | required | TWMedicationRXNORMhttps://twcore.mohw.gov.tw/ig/twcore/ValueSet/medication-rxnorm-tw from this IG | ||||
MedicationStatement.medication[x]:medicationCodeableConcept.coding:atc-medication-code | required | TWMedcationATChttps://twcore.mohw.gov.tw/ig/twcore/ValueSet/medcation-atc-tw from this IG | ||||
MedicationStatement.medication[x]:medicationCodeableConcept.coding:snomedct-medication-codes | required | SNOMEDCTMedicationCodeshttp://hl7.org/fhir/ValueSet/medication-codes from the FHIR Standard | ||||
MedicationStatement.reasonCode | extensible | Condition/Problem/DiagnosisCodeshttp://hl7.org/fhir/ValueSet/condition-code from the FHIR Standard | ||||
MedicationStatement.dosage.additionalInstruction | extensible | SNOMEDCTAdditionalDosageInstructionshttp://hl7.org/fhir/ValueSet/additional-instruction-codes from the FHIR Standard | ||||
MedicationStatement.dosage.timing.repeat.durationUnit | required | UnitsOfTimehttp://hl7.org/fhir/ValueSet/units-of-time|4.0.1 from the FHIR Standard | ||||
MedicationStatement.dosage.timing.repeat.periodUnit | required | UnitsOfTimehttp://hl7.org/fhir/ValueSet/units-of-time|4.0.1 from the FHIR Standard | ||||
MedicationStatement.dosage.timing.repeat.dayOfWeek | required | DaysOfWeekhttp://hl7.org/fhir/ValueSet/days-of-week|4.0.1 from the FHIR Standard | ||||
MedicationStatement.dosage.timing.repeat.when | required | EventTiminghttp://hl7.org/fhir/ValueSet/event-timing|4.0.1 from the FHIR Standard | ||||
MedicationStatement.dosage.timing.code | preferred | TimingAbbreviationhttp://hl7.org/fhir/ValueSet/timing-abbreviation from the FHIR Standard | ||||
MedicationStatement.dosage.timing.code.coding | extensible | TWMedicationFrequencyHL7https://twcore.mohw.gov.tw/ig/twcore/ValueSet/medication-frequency-hl7-tw from this IG | ||||
MedicationStatement.dosage.asNeeded[x] | extensible | SNOMEDCTMedicationAsNeededReasonCodeshttp://hl7.org/fhir/ValueSet/medication-as-needed-reason from the FHIR Standard | ||||
MedicationStatement.dosage.site | extensible | SNOMEDCTAnatomicalStructureForAdministrationSiteCodeshttp://hl7.org/fhir/ValueSet/approach-site-codes from the FHIR Standard | ||||
MedicationStatement.dosage.route | example | SNOMEDCTRouteCodeshttp://hl7.org/fhir/ValueSet/route-codes from the FHIR Standard | ||||
MedicationStatement.dosage.route.coding | extensible | TWMedicationPathSCThttps://twcore.mohw.gov.tw/ig/twcore/ValueSet/medication-path-sct-tw from this IG | ||||
MedicationStatement.dosage.method | extensible | SNOMEDCTAdministrationMethodCodeshttp://hl7.org/fhir/ValueSet/administration-method-codes from the FHIR Standard | ||||
MedicationStatement.dosage.doseAndRate.type | example | DoseAndRateTypehttp://hl7.org/fhir/ValueSet/dose-rate-type from the FHIR Standard |
Id | Grade | Path(s) | Details | Requirements |
dom-2 | error | MedicationStatement | If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty() | |
dom-3 | error | MedicationStatement | 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 | MedicationStatement | 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 | MedicationStatement | If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty() | |
dom-6 | best practice | MedicationStatement | 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() | |
tim-1 | error | MedicationStatement.dosage.timing.repeat | if there's a duration, there needs to be duration units : duration.empty() or durationUnit.exists() | |
tim-2 | error | MedicationStatement.dosage.timing.repeat | if there's a period, there needs to be period units : period.empty() or periodUnit.exists() | |
tim-4 | error | MedicationStatement.dosage.timing.repeat | duration SHALL be a non-negative value : duration.exists() implies duration >= 0 | |
tim-5 | error | MedicationStatement.dosage.timing.repeat | period SHALL be a non-negative value : period.exists() implies period >= 0 | |
tim-6 | error | MedicationStatement.dosage.timing.repeat | If there's a periodMax, there must be a period : periodMax.empty() or period.exists() | |
tim-7 | error | MedicationStatement.dosage.timing.repeat | If there's a durationMax, there must be a duration : durationMax.empty() or duration.exists() | |
tim-8 | error | MedicationStatement.dosage.timing.repeat | If there's a countMax, there must be a count : countMax.empty() or count.exists() | |
tim-9 | error | MedicationStatement.dosage.timing.repeat | If there's an offset, there must be a when (and not C, CM, CD, CV) : offset.empty() or (when.exists() and ((when in ('C' | 'CM' | 'CD' | 'CV')).not())) | |
tim-10 | error | MedicationStatement.dosage.timing.repeat | If there's a timeOfDay, there cannot be a when, or vice versa : timeOfDay.empty() or when.empty() |
Snapshot View
Name | Flags | Card. | Type | Description & Constraints | ||||
---|---|---|---|---|---|---|---|---|
MedicationStatement | 0..* | MedicationStatement | 病人正在服用的藥品紀錄 | |||||
id | Σ | 0..1 | id | 不重複的ID用以識別儲存在特定FHIR Server中的MedicationStatement紀錄,通常又稱為邏輯性ID。 | ||||
meta | Σ | 0..1 | Meta | 此MedicationStatement Resource的metadata | ||||
implicitRules | ?!Σ | 0..1 | uri | 創建此內容所依據的一組規則 | ||||
language | 0..1 | code | 用以表述MedicationStatement Resource內容的語言。 Binding: CommonLanguages (preferred): 人類語言;鼓勵使用CommonLanguages代碼表中的代碼,但不強制一定要使用此代碼表,你也可使用其他代碼表的代碼或單純以文字表示。
Example Value: zh-TW | |||||
text | 0..1 | Narrative | MedicationStatement Resource之內容摘要以供人閱讀 | |||||
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 | 用藥聲明的外部識別碼 | ||||
basedOn | Σ | 0..* | Reference(TW Core MedicationRequest | TW Core CarePlan | TW Core ServiceRequest) | 此用藥聲明是為了達成或實現哪個計劃、提案或醫令 | ||||
partOf | Σ | 0..* | Reference(MedicationAdministration | TW Core MedicationDispense | TW Core MedicationStatement | TW Core Procedure | TW Core Observation Laboratory Result) | 參照事件的一部分 | ||||
status | ?!SΣ | 1..1 | code | active | completed | entered-in-error | intended | stopped | on-hold | unknown | not-taken Binding: Medication Status Codes (required): 指明用藥聲明的當前狀態;應填入所綁定值集中的其中一個代碼 | ||||
statusReason | 0..* | CodeableConceptTW | 當前狀態的原因 Binding: SNOMEDCTDrugTherapyStatusCodes (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | |||||
category | S | 0..1 | CodeableConceptTW | 藥品使用的類型 Binding: Medication usage category codes (preferred): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | ||||
Slices for medication[x] | SΣ | 1..1 | 所提供的藥品 Slice: Unordered, Closed by type:$this Binding: SNOMEDCTMedicationCodes (example): A coded concept identifying the substance or product being taken. | |||||
medicationCodeableConcept | CodeableConcept(CodeableConceptTW) | |||||||
medicationReference | Reference(TW Core Medication) | |||||||
medication[x]:medicationReference | Σ | 0..1 | Reference(TW Core Medication) | What medication was taken | ||||
medication[x]:medicationCodeableConcept | 0..1 | CodeableConceptTW | 所提供的藥品。此資料項目為可擴充綁定預設國際標準值集,但實作者可視實務專案需求只綁定以下slices中的任一值集。目前未只限定綁定預設值集是因為尚無slice值集與預設國際標準值集的代碼對應表,待後續有相對的代碼對應表後將建議採用國際標準值集作為唯一綁定值集並針對該值集進行擴充與管理,以利進行跨國與跨系統之資料交換。 Binding: SNOMEDCTMedicationCodes (example): A coded concept identifying the substance or product being taken. | |||||
id | 0..1 | string | 唯一可識別ID,以供資料項目間相互參照。 | |||||
extension | 0..* | Extension | 擴充的資料項目 Slice: Unordered, Open by value:url | |||||
Slices for coding | S | 0..* | CodingTW | 由專門術語系統(terminology system)定義的代碼 Slice: Unordered, Open by pattern:$this | ||||
coding:fda-medication-tw | S | 0..1 | CodingTW | 此為臺灣食品藥物管理署(TFDA)維護之藥品代碼,涵蓋範圍相對完整,可免費使用,可優先選用此代碼。 Binding: 臺灣食藥署藥品及醫療器材代碼值集 (required): 應填入所綁定值集中的其中一個代碼。 | ||||
coding:nhi-medication-tw | S | 0..1 | CodingTW | 此為中央健康保險署(NHI)維護之藥品代碼,主要針對申報使用,更新頻率相對頻繁,可免費使用,可依情境選用此代碼。 Binding: 臺灣健保署用藥品項代碼值集 (required): 應填入所綁定值集中的其中一個代碼。 | ||||
coding:nhi-medication-ch-herb-tw | S | 0..1 | CodingTW | 此為中央健康保險署(NHI)維護之中藥藥品代碼,主要針對申報使用,更新頻率相對頻繁,可免費使用,可依情境選用此代碼。 Binding: 臺灣健保署中藥用藥品項值集 (required): 應填入所綁定值集中的其中一個代碼。 | ||||
coding:rxnorm-medication-us-core | S | 0..1 | CodingTW | RxNorm為美國Unified Medical Language System®中的藥品代碼,取得UMLS®授權即可免費使用,可依情境選用此代碼。 Binding: RxNorm藥品代碼值集 (required): 應填入所綁定值集中的其中一個代碼。 | ||||
coding:atc-medication-code | S | 0..1 | CodingTW | ATC代碼的版權為世界衛生組織(WHO)Collaborating Centre for Drug Statistics Methodology,可免費使用,可依情境選用此代碼。 Binding: 臺灣食藥署藥品藥理治療分類ATC碼值集 (required): 應填入所綁定值集中的其中一個代碼。 | ||||
coding:snomedct-medication-codes | S | 0..1 | CodingTW | 此為SNOMED CT代碼,若機構已有購買相關授權,亦可使用。 Binding: SNOMEDCTMedicationCodes (required): 可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。 | ||||
text | SΣ | 0..1 | string | 概念的文字表示法 | ||||
subject | SΣ | 1..1 | Reference(TW Core Patient | Group) | 指明目前正在使用的藥品。這可能是一個連結到代表藥品詳細資訊的resource,或者是一個帶有代碼的簡單屬性,從已知藥品清單中表明藥品的代碼。 | ||||
context | SΣ | 0..1 | Reference(TW Core Encounter | EpisodeOfCare) | 與此用藥聲明相關的就醫事件(Encounter / Episode) | ||||
effective[x] | SΣ | 0..1 | 用藥的日期/時間或間隔 | |||||
effectiveDateTime | dateTime | |||||||
effectivePeriod | Period | |||||||
dateAsserted | Σ | 0..1 | dateTime | 此聲明是何時提出的? | ||||
informationSource | 0..1 | Reference(TW Core Patient | TW Core Practitioner | TW Core PractitionerRole | TW Core RelatedPerson | TW Core Organization) | 提供有關服用此藥品資訊的個人或機構 | |||||
derivedFrom | 0..* | Reference(Resource) | 額外的補充資料 | |||||
reasonCode | 0..* | CodeableConceptTW | 指明目前正在使用的藥品 Binding: Condition/Problem/DiagnosisCodes (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | |||||
reasonReference | 0..* | Reference(TW Core Condition | TW Core Observation Laboratory Result | TW Core DiagnosticReport) | 證明目前正在/曾經用藥原因之Condition或Observation | |||||
note | 0..* | Annotation | 有關此聲明的更多資訊 | |||||
dosage | S | 0..* | Dosage | 藥品目前正被/曾經被服用或應該如何服用的細節 | ||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
extension | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
sequence | SΣ | 0..1 | integer | 劑量指示的順序 | ||||
text | SΣ | 0..1 | string | 純文字表述的劑量指示,例如:SIG。 | ||||
additionalInstruction | 0..* | CodeableConceptTW | 對病人的補充指示或警告-例如:「隨餐服用」,「可能引起嗜睡」 Binding: SNOMEDCTAdditionalDosageInstructions (extensible): 一個編碼的概念,確定額外的指示,如「與水一起服用」或「避免操作重型機器」;可參考所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | |||||
patientInstruction | SΣ | 0..1 | string | 以病人或消費者為導向的指示 | ||||
timing | SΣ | 0..1 | Timing | 應該何時給藥;時間的寫法請參照Timimg datatype。 | ||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
extension | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
event | Σ | 0..* | dateTime | 事件發生的時間 | ||||
repeat | SΣC | 0..1 | Element | 事件定期重複發生的時間 tim-1: if there's a duration, there needs to be duration units tim-2: if there's a period, there needs to be period units tim-4: duration SHALL be a non-negative value tim-5: period SHALL be a non-negative value tim-6: If there's a periodMax, there must be a period tim-7: If there's a durationMax, there must be a duration tim-8: If there's a countMax, there must be a count tim-9: If there's an offset, there must be a when (and not C, CM, CD, CV) tim-10: If there's a timeOfDay, there cannot be a when, or vice versa | ||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
extension | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
bounds[x] | Σ | 0..1 | 時間或期間長度/長度範圍,或(開始和/或結束)限制 | |||||
boundsDuration | Duration | |||||||
boundsRange | Range | |||||||
boundsPeriod | Period | |||||||
count | SΣ | 0..1 | positiveInt | 重複的次數 | ||||
countMax | Σ | 0..1 | positiveInt | 重複的最大次數 | ||||
duration | SΣ | 0..1 | decimal | 此事件持續多久時間 | ||||
durationMax | Σ | 0..1 | decimal | 此事件持續多久時間 (最長時間/最大值) | ||||
durationUnit | SΣ | 0..1 | code | s | min | h | d | wk | mo | a - 單位時間 (unit of time,UCUM) Binding: UnitsOfTime (required): 時間的單位(單位來自UCUM);應填入UnitsOfTime值集中的其中一個代碼 | ||||
frequency | SΣ | 0..1 | positiveInt | 此事件於每一期間的發生頻率 | ||||
frequencyMax | Σ | 0..1 | positiveInt | 此事件於每一期間的最大發生頻率 | ||||
period | SΣ | 0..1 | decimal | 此事件於特定時間區間所發生的頻率 | ||||
periodMax | Σ | 0..1 | decimal | 時間區間的上限(3-4小時) | ||||
periodUnit | SΣ | 0..1 | code | s | min | h | d | wk | mo | a - 單位時間 (unit of time,UCUM) Binding: UnitsOfTime (required): 時間的單位(單位來自UCUM);應填入UnitsOfTime值集中的其中一個代碼 | ||||
dayOfWeek | SΣ | 0..* | code | mon | tue | wed | thu | fri | sat | sun Binding: DaysOfWeek (required): 應填入DaysOfWeek值集中的其中一個代碼 | ||||
timeOfDay | SΣ | 0..* | time | 一天中的活動時間 | ||||
when | Σ | 0..* | code | 事件發生的時間區間之代碼 Binding: EventTiming (required): 與時程表有關的真實世界事件;應填入EventTiming值集中的其中一個代碼 | ||||
offset | Σ | 0..1 | unsignedInt | 事件的分鐘數(之前或之後) | ||||
code | S | 0..1 | CodeableConceptTW | BID | TID | QID | AM | PM | QD | QOD | + Binding: TimingAbbreviation (preferred): 已知/確定的時間模式之代碼;鼓勵使用TimingAbbreviation值集中的代碼,但不強制一定要使用此值集,你也可使用其他值集的代碼或單純以文字表示。 | ||||
id | 0..1 | string | 唯一可識別ID,以供資料項目間相互參照。 | |||||
extension | 0..* | Extension | 擴充的資料項目 Slice: Unordered, Open by value:url | |||||
coding | S | 0..* | CodingTW | 由專門術語系統(terminology system)定義的代碼。此資料項目為可擴充綁定預設國際標準值集,但實作者可視實務專案需求只綁定以下slices中的任一值集。目前未只限定綁定預設值集是因為尚無slice值集與預設國際標準值集的代碼對應表,待後續有相對的代碼對應表後將建議採用國際標準值集作為唯一綁定值集並針對該值集進行擴充與管理,以利進行跨國與跨系統之資料交換。 Binding: HL7 TimingAbbreviation + 臺灣健保署藥品使用頻率值集 (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | ||||
text | SΣ | 0..1 | string | 概念的文字標記法 | ||||
asNeeded[x] | Σ | 0..1 | 「根據(對x的)需要」服用
Binding:一個編碼概念,指明在服用或用藥之前應滿足或評估的先決條件。例如:「疼痛」、「性行為前30分鐘」、「發作時」等;可參考SNOMEDCTMedicationAsNeededReasonCodes值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。 Binding: SNOMEDCTMedicationAsNeededReasonCodes (extensible): 一個編碼概念,指明在服用或用藥之前應滿足或評估的先決條件。例如:「疼痛」、「性行為前30分鐘」、「發作時」等;應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | |||||
asNeededBoolean | boolean | |||||||
asNeededCodeableConcept | CodeableConcept | |||||||
site | Σ | 0..1 | CodeableConcept | 用藥之身體部位 Binding: SNOMEDCTAnatomicalStructureForAdministrationSiteCodes (extensible): 一個編碼概念,描述藥品進入或在身體上的位置;可參考所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | ||||
route | S | 0..1 | CodeableConceptTW | 藥品應如何進入體內 Binding: SNOMEDCTRouteCodes (example): A coded concept describing the route or physiological path of administration of a therapeutic agent into or onto the body of a subject. | ||||
id | 0..1 | string | 唯一可識別ID,以供資料項目間相互參照。 | |||||
extension | 0..* | Extension | 擴充的資料項目 Slice: Unordered, Open by value:url | |||||
coding | S | 0..* | CodingTW | 由專門術語系統(terminology system)定義的代碼。此資料項目為可擴充綁定預設國際標準值集,但實作者可視實務專案需求只綁定以下slices中的任一值集。目前未只限定綁定預設值集是因為尚無slice值集與預設國際標準值集的代碼對應表,待後續有相對的代碼對應表後將建議採用國際標準值集作為唯一綁定值集並針對該值集進行擴充與管理,以利進行跨國與跨系統之資料交換。 Binding: SNOMED CT + 臺灣健保署給藥途徑值集 (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | ||||
text | SΣ | 0..1 | string | 概念的文字標記法 | ||||
method | 0..1 | CodeableConceptTW | 用藥的技術 Binding: SNOMEDCTAdministrationMethodCodes (extensible): 一個編碼概念,描述用藥的技術;可參考所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。 | |||||
doseAndRate | Σ | 0..* | Element | 用藥量 | ||||
id | 0..1 | string | Unique id for inter-element referencing | |||||
extension | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||
type | 0..1 | CodeableConceptTW | 特定劑量或比率種類 Binding: DoseAndRateType (example): 可參考DoseAndRateType值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。 | |||||
dose[x] | SΣ | 0..1 | 每一劑量的藥量 | |||||
doseRange | Range | |||||||
doseQuantity | Quantity(SimpleQuantity) | |||||||
rate[x] | SΣ | 0..1 | 每時間單位內的用藥量 | |||||
rateRatio | Ratio | |||||||
rateRange | Range | |||||||
rateQuantity | Quantity(SimpleQuantity) | |||||||
maxDosePerPeriod | Σ | 0..1 | Ratio | 每時間單位內用藥的上限 | ||||
maxDosePerAdministration | Σ | 0..1 | SimpleQuantity | 每次用藥的上限 | ||||
maxDosePerLifetime | Σ | 0..1 | SimpleQuantity | 病人一生中用藥的上限 | ||||
Documentation for this format |
Path | Conformance | ValueSet | URI | |||
MedicationStatement.language | preferred | CommonLanguages
http://hl7.org/fhir/ValueSet/languages from the FHIR Standard | ||||
MedicationStatement.status | required | Medication Status Codeshttp://hl7.org/fhir/ValueSet/medication-statement-status|4.0.1 from the FHIR Standard | ||||
MedicationStatement.statusReason | extensible | SNOMEDCTDrugTherapyStatusCodeshttp://hl7.org/fhir/ValueSet/reason-medication-status-codes from the FHIR Standard | ||||
MedicationStatement.category | preferred | Medication usage category codeshttp://hl7.org/fhir/ValueSet/medication-statement-category from the FHIR Standard | ||||
MedicationStatement.medication[x] | example | SNOMEDCTMedicationCodeshttp://hl7.org/fhir/ValueSet/medication-codes from the FHIR Standard | ||||
MedicationStatement.medication[x]:medicationCodeableConcept | example | SNOMEDCTMedicationCodeshttp://hl7.org/fhir/ValueSet/medication-codes from the FHIR Standard | ||||
MedicationStatement.medication[x]:medicationCodeableConcept.coding:fda-medication-tw | required | TWMedicationFDAhttps://twcore.mohw.gov.tw/ig/twcore/ValueSet/medication-fda-tw from this IG | ||||
MedicationStatement.medication[x]:medicationCodeableConcept.coding:nhi-medication-tw | required | TWMedicationNHI (a valid code from 臺灣健保署健保用藥品項代碼)https://twcore.mohw.gov.tw/ig/twcore/ValueSet/medication-nhi-tw from this IG | ||||
MedicationStatement.medication[x]:medicationCodeableConcept.coding:nhi-medication-ch-herb-tw | required | TWCHHerbMedicationNHI (a valid code from 臺灣健保署中藥用藥品項)https://twcore.mohw.gov.tw/ig/twcore/ValueSet/nhi-medication-ch-herb-tw from this IG | ||||
MedicationStatement.medication[x]:medicationCodeableConcept.coding:rxnorm-medication-us-core | required | TWMedicationRXNORMhttps://twcore.mohw.gov.tw/ig/twcore/ValueSet/medication-rxnorm-tw from this IG | ||||
MedicationStatement.medication[x]:medicationCodeableConcept.coding:atc-medication-code | required | TWMedcationATChttps://twcore.mohw.gov.tw/ig/twcore/ValueSet/medcation-atc-tw from this IG | ||||
MedicationStatement.medication[x]:medicationCodeableConcept.coding:snomedct-medication-codes | required | SNOMEDCTMedicationCodeshttp://hl7.org/fhir/ValueSet/medication-codes from the FHIR Standard | ||||
MedicationStatement.reasonCode | extensible | Condition/Problem/DiagnosisCodeshttp://hl7.org/fhir/ValueSet/condition-code from the FHIR Standard | ||||
MedicationStatement.dosage.additionalInstruction | extensible | SNOMEDCTAdditionalDosageInstructionshttp://hl7.org/fhir/ValueSet/additional-instruction-codes from the FHIR Standard | ||||
MedicationStatement.dosage.timing.repeat.durationUnit | required | UnitsOfTimehttp://hl7.org/fhir/ValueSet/units-of-time|4.0.1 from the FHIR Standard | ||||
MedicationStatement.dosage.timing.repeat.periodUnit | required | UnitsOfTimehttp://hl7.org/fhir/ValueSet/units-of-time|4.0.1 from the FHIR Standard | ||||
MedicationStatement.dosage.timing.repeat.dayOfWeek | required | DaysOfWeekhttp://hl7.org/fhir/ValueSet/days-of-week|4.0.1 from the FHIR Standard | ||||
MedicationStatement.dosage.timing.repeat.when | required | EventTiminghttp://hl7.org/fhir/ValueSet/event-timing|4.0.1 from the FHIR Standard | ||||
MedicationStatement.dosage.timing.code | preferred | TimingAbbreviationhttp://hl7.org/fhir/ValueSet/timing-abbreviation from the FHIR Standard | ||||
MedicationStatement.dosage.timing.code.coding | extensible | TWMedicationFrequencyHL7https://twcore.mohw.gov.tw/ig/twcore/ValueSet/medication-frequency-hl7-tw from this IG | ||||
MedicationStatement.dosage.asNeeded[x] | extensible | SNOMEDCTMedicationAsNeededReasonCodeshttp://hl7.org/fhir/ValueSet/medication-as-needed-reason from the FHIR Standard | ||||
MedicationStatement.dosage.site | extensible | SNOMEDCTAnatomicalStructureForAdministrationSiteCodeshttp://hl7.org/fhir/ValueSet/approach-site-codes from the FHIR Standard | ||||
MedicationStatement.dosage.route | example | SNOMEDCTRouteCodeshttp://hl7.org/fhir/ValueSet/route-codes from the FHIR Standard | ||||
MedicationStatement.dosage.route.coding | extensible | TWMedicationPathSCThttps://twcore.mohw.gov.tw/ig/twcore/ValueSet/medication-path-sct-tw from this IG | ||||
MedicationStatement.dosage.method | extensible | SNOMEDCTAdministrationMethodCodeshttp://hl7.org/fhir/ValueSet/administration-method-codes from the FHIR Standard | ||||
MedicationStatement.dosage.doseAndRate.type | example | DoseAndRateTypehttp://hl7.org/fhir/ValueSet/dose-rate-type from the FHIR Standard |
Id | Grade | Path(s) | Details | Requirements |
dom-2 | error | MedicationStatement | If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty() | |
dom-3 | error | MedicationStatement | 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 | MedicationStatement | 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 | MedicationStatement | If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty() | |
dom-6 | best practice | MedicationStatement | 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() | |
tim-1 | error | MedicationStatement.dosage.timing.repeat | if there's a duration, there needs to be duration units : duration.empty() or durationUnit.exists() | |
tim-2 | error | MedicationStatement.dosage.timing.repeat | if there's a period, there needs to be period units : period.empty() or periodUnit.exists() | |
tim-4 | error | MedicationStatement.dosage.timing.repeat | duration SHALL be a non-negative value : duration.exists() implies duration >= 0 | |
tim-5 | error | MedicationStatement.dosage.timing.repeat | period SHALL be a non-negative value : period.exists() implies period >= 0 | |
tim-6 | error | MedicationStatement.dosage.timing.repeat | If there's a periodMax, there must be a period : periodMax.empty() or period.exists() | |
tim-7 | error | MedicationStatement.dosage.timing.repeat | If there's a durationMax, there must be a duration : durationMax.empty() or duration.exists() | |
tim-8 | error | MedicationStatement.dosage.timing.repeat | If there's a countMax, there must be a count : countMax.empty() or count.exists() | |
tim-9 | error | MedicationStatement.dosage.timing.repeat | If there's an offset, there must be a when (and not C, CM, CD, CV) : offset.empty() or (when.exists() and ((when in ('C' | 'CM' | 'CD' | 'CV')).not())) | |
tim-10 | error | MedicationStatement.dosage.timing.repeat | If there's a timeOfDay, there cannot be a when, or vice versa : timeOfDay.empty() or when.empty() |
This structure is derived from MedicationStatement
Summary
Must-Support: 32 elements
Structures
This structure refers to these other structures:
Slices
This structure defines the following Slices:
Other representations of profile: CSV, Excel, Schematron
以下概述了此Profile所需的RESTful FHIR互動功能。有關TW Core IG支援的RESTful互動功能的完整清單,請參閱TW Core Server能力聲明。
建議應該(SHOULD) 支援透過查詢參數 _id
查詢所有MedicationStatement:
(如何透過token查詢)
GET [base]/MedicationStatement?_id=[id]
GET [base]/MedicationStatement/[id]
例子:
(1) GET [base]/MedicationStatement?_id=med-sta-example
(2) GET [base]/MedicationStatement/med-sta-example
建議應該(SHOULD) 支援透過查詢參數 status
查詢所有MedicationStatement:
(如何透過token查詢)
GET [base]/MedicationStatement?status=[code]
例子:
(1) GET [base]/MedicationStatement?status=active
建議應該(SHOULD) 支援透過查詢參數 medication
查詢所有MedicationStatement:
(如何透過reference查詢)
GET [base]/MedicationStatement?medication={Type/}[id]
例子:
(1) GET [base]/MedicationStatement?medication=Medication/med-example
建議應該(SHOULD) 支援透過查詢參數 subject
查詢所有MedicationStatement:
(如何透過reference查詢)
GET [base]/MedicationRequest?subject={Type/}[id]
例子:
(1) GET [base]/MedicationStatement?subject=Patient/pat-example