From f82cb604024a1a1b7faad5a9b5de683b6582a3a0 Mon Sep 17 00:00:00 2001 From: JensPenny Date: Thu, 27 Oct 2022 09:34:44 +0200 Subject: [PATCH 1/3] changed the formatting for glossary.md Changed the glossary md formatting. Formatting changes are seperate from the actual content-changes so we can discuss or merge them seperatly --- input/pagecontent/glossary.md | 29 ++++++++++++++++------------- 1 file changed, 16 insertions(+), 13 deletions(-) diff --git a/input/pagecontent/glossary.md b/input/pagecontent/glossary.md index d16fc403..c38b011f 100644 --- a/input/pagecontent/glossary.md +++ b/input/pagecontent/glossary.md @@ -1,3 +1,5 @@ +# Glossary + In this specification, the following terms and concepts are used: Do we have an explicit info on "status" like the treatment intended, actually being taken, etc. @@ -5,30 +7,31 @@ Do we have an explicit info on "status" like the treatment intended, actually be If we look at 2 treatments that contain the same medication, will we see duplicate lines? WE REALLY NEED TO MAKE THIS CLEAR IN THE DOCUMENTATION - WHEN THE SOFTWARE SEES 2 MEDICATION TREATEMENTS THAT CONTAIN THE SAME LINES, IT SHOULD NEVER SHOW THOSE LINES AS DIFFERENT. - Data objects -**Medication Record**: a collection of all past, future and current medication treatments for a patient. This does not necessarily incorporate adjacent information like allergies, lab results, etc. +### Medication Record +A collection of all past, future and current medication treatments for a patient. This does not necessarily incorporate adjacent information like allergies, lab results, etc. -**Medication Treatment**: a set of medications used in a given context - for example one disease, or one episode. +### Medication Treatment +A set of medications used in a given context - for example one disease, or one episode. -**Medication Treatment line**: One medication product that is used (or planned) for a patient, including the details on how the medication is or should be used (for example posology). +### Medication Treatment line +One medication product that is used (or planned) for a patient, including the details on how the medication is or should be used (for example posology). The same medication (line) can be associated with 2 treatments. A medication treatment line always is associated with a treatment, even if that treatment is not a prescription or even planned (for example self-reported OTC medication usage). -**Medication View**: a purpose-specific collection of medication lines (medication view lines) representing a distinct view on the data that is relevant for that purpose, for example a patient-friendly schedule view, or a physician's aggregated view,... +### Medication View +a purpose-specific collection of medication lines (medication view lines) representing a distinct view on the data that is relevant for that purpose, for example a patient-friendly schedule view, or a physician's aggregated view,... This differs from the Medication Treatment in that the medication treatment is the "original" information - what is known at a given time to be the medication treatments of the patient - whereas the view can be transversal to several treatments, or detailed as needed. -**Medication View line**: one entry in the medication view, representing a purpose-specific perspective on one or several medication treatment lines - for example a single line in a patient's schedule for the week. +### Medication View line +one entry in the medication view, representing a purpose-specific perspective on one or several medication treatment lines - for example a single line in a patient's schedule for the week. Because the medication view line (and medication view) are purpose-specific, there may be different medication view lines for the same medication treatment line. +Note that structure of the Medication View line is similar to that of the Medication Treatment line, but they are used differently. One to capture the original data, the other to represent the derived data. -**note that structure of the Medication View line is similar to that of the Medication Treatment line -but they are used differently - one to capture the original data, the other to represent the derived data* - -**Medication statement**: - -**Medication Reconciliation**: - -**Medication data collection** +### Medication statement +### Medication Reconciliation +### Medication data collection From 1ed78f59464141fd4400bf14af71844787ec496a Mon Sep 17 00:00:00 2001 From: JensPenny Date: Thu, 27 Oct 2022 09:59:07 +0200 Subject: [PATCH 2/3] Added medication reconcilliation --- input/pagecontent/glossary.md | 18 ++++++++++++++++-- 1 file changed, 16 insertions(+), 2 deletions(-) diff --git a/input/pagecontent/glossary.md b/input/pagecontent/glossary.md index c38b011f..547d0957 100644 --- a/input/pagecontent/glossary.md +++ b/input/pagecontent/glossary.md @@ -21,11 +21,11 @@ The same medication (line) can be associated with 2 treatments. A medication treatment line always is associated with a treatment, even if that treatment is not a prescription or even planned (for example self-reported OTC medication usage). ### Medication View -a purpose-specific collection of medication lines (medication view lines) representing a distinct view on the data that is relevant for that purpose, for example a patient-friendly schedule view, or a physician's aggregated view,... +A purpose-specific collection of medication lines (medication view lines) representing a distinct view on the data that is relevant for that purpose, for example a patient-friendly schedule view, or a physician's aggregated view,... This differs from the Medication Treatment in that the medication treatment is the "original" information - what is known at a given time to be the medication treatments of the patient - whereas the view can be transversal to several treatments, or detailed as needed. ### Medication View line -one entry in the medication view, representing a purpose-specific perspective on one or several medication treatment lines - for example a single line in a patient's schedule for the week. +One entry in the medication view, representing a purpose-specific perspective on one or several medication treatment lines - for example a single line in a patient's schedule for the week. Because the medication view line (and medication view) are purpose-specific, there may be different medication view lines for the same medication treatment line. Note that structure of the Medication View line is similar to that of the Medication Treatment line, but they are used differently. One to capture the original data, the other to represent the derived data. @@ -33,5 +33,19 @@ Note that structure of the Medication View line is similar to that of the Medica ### Medication statement ### Medication Reconciliation +The act of improving the overall **medication record**. This by reviewing the current **medication treatment lines**, or by merging different **medication treatments** into a new, updated and more complete or more correct medication treatment. + +Reconcilliations should happen in transitions of the care, for example when a patient goes on an intake in a hospital, or when a GP prescribes new medication. + +The process of reconciliation commonly has following steps[^1]: + +1. Develop the list of current medications for the patient +2. Develop a list of medication that needs to be prescribed +3. Compare these two lists +4. Make clinical decisions based on the comparison +5. Upload the medication record + ### Medication data collection + +[^1]: https://www.ncbi.nlm.nih.gov/books/NBK2648/: Medication reconcilliation source From 167c9d6dca46aafc0050ab8d0c29b2f3c5b93094 Mon Sep 17 00:00:00 2001 From: JensPenny Date: Mon, 14 Nov 2022 19:51:27 +0100 Subject: [PATCH 3/3] added to medicationview added medicationstatement --- input/pagecontent/glossary.md | 39 +++++++++++++------ .../medicationrecord-fhir-resources.md | 2 +- 2 files changed, 29 insertions(+), 12 deletions(-) diff --git a/input/pagecontent/glossary.md b/input/pagecontent/glossary.md index 547d0957..0bfde134 100644 --- a/input/pagecontent/glossary.md +++ b/input/pagecontent/glossary.md @@ -9,30 +9,43 @@ WE REALLY NEED TO MAKE THIS CLEAR IN THE DOCUMENTATION - WHEN THE SOFTWARE SEES Data objects -### Medication Record +## Medication Record + A collection of all past, future and current medication treatments for a patient. This does not necessarily incorporate adjacent information like allergies, lab results, etc. -### Medication Treatment +## Medication Treatment + A set of medications used in a given context - for example one disease, or one episode. -### Medication Treatment line -One medication product that is used (or planned) for a patient, including the details on how the medication is or should be used (for example posology). +## Medication Treatment line + +One medication product that is used (or planned) for a patient, including the details on how the medication is or should be used (for example posology). In short: a **medication treatment line** represents a single line of a treatment. The same medication (line) can be associated with 2 treatments. -A medication treatment line always is associated with a treatment, even if that treatment is not a prescription or even planned (for example self-reported OTC medication usage). +A medication treatment line always is associated with a treatment, even if that treatment is not a prescription or even planned (for example self-reported OTC medication usage). + +## Medication View -### Medication View A purpose-specific collection of medication lines (medication view lines) representing a distinct view on the data that is relevant for that purpose, for example a patient-friendly schedule view, or a physician's aggregated view,... -This differs from the Medication Treatment in that the medication treatment is the "original" information - what is known at a given time to be the medication treatments of the patient - whereas the view can be transversal to several treatments, or detailed as needed. +This differs from the Medication Treatment in that the medication treatment is the "original" information - what is known at a given time to be the medication treatments of the patient - whereas the view can be transversal to several treatments, or detailed as needed. + +There are two different subsets of medicationviews that will be named: + +1. **Core medication views** are views that are composed from the base **medication treatment lines**. This data is not manipulated or translated to another version of itself. +2. **Synthetic medication views** are views that are generated from the core medicationview. For example: the core medicationview can have some lines with the medication as a package, while others may contain a substance. A synthetic medication view could make the decision to translate the core view so all treatment lines are named by substance, and can use this as a different view. + +## Medication View line -### Medication View line One entry in the medication view, representing a purpose-specific perspective on one or several medication treatment lines - for example a single line in a patient's schedule for the week. Because the medication view line (and medication view) are purpose-specific, there may be different medication view lines for the same medication treatment line. Note that structure of the Medication View line is similar to that of the Medication Treatment line, but they are used differently. One to capture the original data, the other to represent the derived data. -### Medication statement +## Medication Statement + +The [base FHIR profile](https://hl7.org/fhir/medicationstatement.html) for the medication. The medication statement (or medication usage in [FHIR Release 4](http://hl7.org/fhir/R4)). + +## Medication Reconciliation -### Medication Reconciliation The act of improving the overall **medication record**. This by reviewing the current **medication treatment lines**, or by merging different **medication treatments** into a new, updated and more complete or more correct medication treatment. Reconcilliations should happen in transitions of the care, for example when a patient goes on an intake in a hospital, or when a GP prescribes new medication. @@ -45,7 +58,11 @@ The process of reconciliation commonly has following steps[^1]: 4. Make clinical decisions based on the comparison 5. Upload the medication record +## Medication data collection + +## Other references -### Medication data collection +* [functional description](functional-description.html) +* [medicationrecord fhir resources](medicationrecord-fhir-resources.md) [^1]: https://www.ncbi.nlm.nih.gov/books/NBK2648/: Medication reconcilliation source diff --git a/input/pagecontent/medicationrecord-fhir-resources.md b/input/pagecontent/medicationrecord-fhir-resources.md index ab844eb0..c040c290 100644 --- a/input/pagecontent/medicationrecord-fhir-resources.md +++ b/input/pagecontent/medicationrecord-fhir-resources.md @@ -25,7 +25,7 @@ Whether as a document or as a collection, the Medication Record can contain any * Medication Treatment Line can be associated with information from different origins: * **Prescriptions**, or any known change to a treatment, with the [MedicationRequest](http://hl7.org/fhir/medicationrequest.html) resource * **Dispenses**, with the [MedicationDispense](http://hl7.org/fhir/medicationdispense.html) resource - * **Administrations**, ttypically informed by the patient or by a nurse or other care giver, with the [MedicationAdministration](http://hl7.org/fhir/medicationadministration.html) resource + * **Administrations**, typically informed by the patient or by a nurse or other care giver, with the [MedicationAdministration](http://hl7.org/fhir/medicationadministration.html) resource * In some cases, a medication information can be obtained by a statement given by a patient (or related person) about the usage of the medication. This is done with the [MedicationStatement](http://hl7.org/fhir/medicationstatement.html) resource * A set of examples is provided in this document to show the combinations of these elements in realistic scenarios.