Administering Drug Regimens

This documentation only applies to OpenMRS 1.9.x and prior versions. The regimens tab was removed as part of the Order Entry API upgrade in OpenMRS 1.10.

On the dashboard, the drug regimens tab is used to add/edit/remove the current medication received by the current patient. Standard drug regimens allow the user to add with only a few clicks the patient to the most usual drug configurations used in the health centre.

The standard regimens are set using the dashboard.regimen global properties. These can by edited from the Advanced Settings page, located in the Maintenance section of the Administration menu.

displayDrugSetIds lists the ways in which the drugs administered will be categorized. In the demo example, ANTIRETROVIRAL DRUGS and TUBERCULOSIS TREATMENT DRUGS are listed, so the drugs added to the patient belonging to any of these two categories will be shown separately.

It's important to note that both ANTIRETROVIRAL DRUGS and TUBERCULOSIS TREATMENT DRUGS are MedSet Concepts in the Concept Dictionary. So in order to make one of your own, group the drugs you want to display in a MedSet Concept (remember to check the "Is Set?" box while creating it, otherwise you won't be able to add your drugs as set members).

As in this example, the available drug combinations (ej: the pill, not the drug) should be listed with the Concept Drug Form (also in the Admin Page as Manage Drug Concepts)

And then, add the Concept Drugs...

...associating each one to a drug, a unit and a dosage, with it's minimum an maximum doses. The drugId (shown in the URL bar) is the unique Id for that drug. It will be used later for Standard Regimens, so write them down.

the displayFrequencies Setting (formerly Global Property from 1.8 downwards) is used to change/localize the available time spawns of the medications.

Finally, the standardRegimens consists of an XML text, with this basic layout.

				<frequency>2/day x 7 days/week</frequency>
		<displayName>3TC + d4T(30) + NVP (Triomune-30)</displayName>
		<canReplace>ANTIRETROVIRAL DRUGS</canReplace>

Each <regimenSuggestion> encloses a standard regimen, which consists in one or more <drugSuggestion> enclosed between <drugComponents> tags.

The <drugId> is the same drugID from the Concept Drug Management Form above.

The <displayName> is the the name to be shown in the dashboard.

Finally, the <canReplace> tag states the kind of previous regimens that this regimen can overwrite, based on a MedSet Concept. This way, it is not possible for an ANTIRETROVIRAL DRUGS drug regimen (such as the "3TC + d4T(30) + NVP (Triomune-30)")  to replace a TUBERCULOSIS TREATMENT DRUGS drug regimen or any other. It only can replace another ANTIRETROVIRAL DRUGS regimen.

Changing the stop treatment default reasons

In order to add or simply replace the default reasons to stop a drug treatment (in the demo, "OTHER NON-CODED" and "NONE")...
look for the concept whose id is written under the concept.reasonOrderStopped Global property, and modify its contents.
In the demo's case, concept #6098's name is "REASON ORDER STOPPED". Simply add your new motive as a new answer for this question concept.


This is documentation for the reworked order entry API, so it only applies to OpenMRS 2.1+ and OpenMRS Platform 1.10+