The Medication Tab allows the user to create new Drug Orders for the patient. Medication is referred to as Drugs in OpenMRS. It also displays the past and active medications for the patient. The screenshot below displays an instance of the same:
Medication Tab
"bahmniClinicalBillingTreatment": { "id": "bahmni.clinical.billing.treatment", "extensionPointId": "org.bahmni.clinical.consultation.board", "type": "link", "label": "Medications", "translationKey":"MEDICATIONS_BOARD_LABEL_KEY", "extensionParams": { "tabConfigName": "<tabConfigName>" }, "url": "treatment", "icon": "fa-user-md", "order": 7, "requiredPrivilege": "app:clinical:consultationTab" }, |
Please refer to the following link to know more about this configuration: https://github.com/bahmni/default-config/blob/master/openmrs/apps/clinical/extension.json
You can configure multiple medication tabs with each tab being drug specific. The name of the tab tabConfigName needs to be defined in extensionParams. Using this tabConfigName, the tab specific configurations needs to be put in medication.json. Please look at MedicationTab Configurations for more details. The following is example configuration that configures two medication tabs.
"bahmniClinicalBillingTreatment": { "id": "bahmni.clinical.billing.treatment", "extensionPointId": "org.bahmni.clinical.consultation.board", "type": "link", "label": "Medications", "translationKey":"MEDICATIONS_TAB_ONE_LABEL_KEY", "extensionParams": { "tabConfigName": "<tab1ConfigName>" }, "url": "treatment", "icon": "fa-user-md", "order": 7, "requiredPrivilege": "app:clinical:consultationTab" }, "bahmniClinicalBillingTreatment": { "id": "bahmni.clinical.billing.treatment", "extensionPointId": "org.bahmni.clinical.consultation.board", "type": "link", "label": "Medications", "translationKey":"MEDICATIONS_TAB_TWO_LABEL_KEY", "extensionParams": { "tabConfigName": "<tab2ConfigName>" }, "url": "treatment", "icon": "fa-user-md", "order": 8, "requiredPrivilege": "app:clinical:consultationTab" } |
Please refer to this page to setup the medication/drug data
Please see this documentation on wiki: medication.json
Check the Dispensing Drugs feature guide for a general understanding of this feature
The highlighted buttons in red below are the buttons used to dispense drugs.
When the logged in user has the specific privilege then these buttons show up.
Add this privilege for the logged in user.
bahmni:clinical:dispense | Bahmni drug order dispensing privilege |
Refer EMR Security and Access Control (OpenMRS) to get info on how to add privilege for a logged in user.
The two extra buttons "Open Quotation" and "Open Dispensed Quotation" can be configured to open a quotation for drugs which are not dispensed and a quotation for drugs which are dispensed.
"bahmniClinicalTreatmentLinks": { "id": "bahmni.clinical.treatment.links", "extensionPointId": "org.bahmni.clinical.treatment.links", "type": "link", "label": "Open <u>Q</u>uotation", "url": "http://192.168.33.10:8069/quotations/latest?patient_ref={{patient_ref}}&dispensed=false&location_ref={{location_ref}}", "shortcutKey": "q", "requiredPrivilege": "app:billing" }, "bahmniClinicalTreatmentDispensedLinks": { "id": "bahmni.clinical.treatment.links", "extensionPointId": "org.bahmni.clinical.treatment.links", "type": "link", "label": "Open <u>D</u>ispensed Quotation", "url": "http://192.168.33.10:8069/quotations/latest?patient_ref={{patient_ref}}&dispensed=true&location_ref={{location_ref}}", "shortcutKey": "q", "requiredPrivilege": "app:billing" } |
The above config should be added to clinical extension.json. The logged in user should have the privilege app:billing (For billing users to access prescription in MRS) |
When a Drug is stopped on the Medication Tab, the user can select the Stop Order Reason concept from the drop down menu and by default the order reason notes will be enabled. To conditionally disable the stop order reason notes based on the stop order reason concept selected, please refer below example:
Add the condition under clinical formCondition.js for the required Stop OrderReason Concept.
For example, to enable stop order reason notes for "Other" and "Adverse event" reason concepts:
"Medication Stop Reason": function (drugOrder, conceptName) { if(conceptName == "Other" || conceptName == "Adverse event"){ drugOrder.orderReasonNotesEnabled = true; return true; } else return false; } |
Key | Value | Mandatory |
---|---|---|
Medication Stop Reason | Conditionally enable or disable reason notes | Y |
conceptName | Name of the concept for which the reason notes should be enabled |
If the section "Medication Stop Reason" is not defined, by default reason notes will be enabled for all reason concepts. |
Please refer to Medications for further details about this configuration.
The Drug-o-gram or The Drug Regimen Display Control is a widget that displays all the drugs that the patient has been treated with. This gives the clinician a bird’s eye view of all of the patient’s current and past medications.
In this configuration the Drug-o-gram will not display “Stop” if a medicine is stopped and restarted the same day or the next or in a configurable time (provided in hours in the STOPING_INTERVAL_HOURS key of groovy file). TreatmentRegimenExtension.groovy is a sample groovy file which should be placed in this path bahmni-config/openmrs/treatmentRegimenExtension/TreatmentRegimenExtension.groovy
Using dosages as mixed fractions like 2¾ instead of 2.75 is possible for both uniform and variable doses by configuring the following json in the file medication.json in openmrs/apps/clinical/ directory in the configuration repo.
{ "commonConfig": { "doseFractions": [ { "value": 0.50, "label": "½" }, { "value": 0.33, "label": "⅓" }, { "value": 0.25, "label": "¼" }, { "value": 0.75, "label": "¾" } ] }, "tabConfig": { "tabOne": { "showDoseFractions": true "doseFractions": ["½","¾"] ] } |
The fractions have to be written in actual unicode characters like ¾ or ¼ not 3/4 or 1/4.
|
Screenshot
For more information on Display Controls that can be configured, please refer to this section.