Introduction to the program patient management module
The Open mSupply patient program allows users to collect general as well as program specific patient information. A patient can be enrolled into multiple patient programs such as an HIV program, a TB program or an immunisation program.
For every program enrolment there can be multiple patient encounters, e.g. doctor visits.
All data collected in the patient program module is stored in documents. For example, patient data is stored in a patient document, program enrolment data is stored in program enrolment documents and encounter data is stored in an encounter document.
All patient program related functionality can be found in the “Dispensary” menu item.
Enabling the patient management module
To use the module, ensure that your store is set to
Dispensary mode (see the virtual stores documentation for how to do this).
You will also need to enable the store preference for
Open mSupply: Uses program module.
This preference is compatible with Open mSupply
v1.2.0+ and mSupply
In order to use the program module, you'll first need to create and manage patients to dispense to.
To create a new patient file, click on 'dispensary' and then the 'patients' icon from the Dashboard:
This will bring up the 'Patient' page. To create a new patient click the “New Patient” button in the right top corner.
The patient creation is split into three steps:
- Entering of basic patient information such as name or date of birth
- Search for existing similar patients to avoid duplicated patient entries
- Entering full patient information and finalising the patient
After clicking the
New Patient button, you'll be shown a dialog window.
Enter in some of the patient details and click `OK & Next`` to bring up all matching patients, such as in the example below:
If one of the returned patients looks to have the correct details, simply click on that line and you'll be taken to the patient details. If none of them look correct, or if no results are returned, you'll want to create a new patient record.
Create button will create the new patient record, and you'll see a new screen, showing the patient details:
Navigating to the
Patients menu item will show a list of existing patients.
Searching for a Patient
In the list view, search bars are above the patient list that can be used to narrow and specify the search. You can search by both first and last name as well as by ID. This can be useful to quickly find patients with common names or if there is a large number of existing patients.
Patient Details View
Selecting a patient from the patient list will open the patient details view.
The information recorded here is customisable for a specific installation of Open mSupply. While there's a base set of data recorded, such as name and birth date, there is also a range of types of data which can be configured in addition to this. Your patient detail view will likely look slightly different to that shown above.
On the patient detail view there are three tabs:
- Details: shows the general patient information
- Programs: shows a list of program enrolments for the selected patient
- Encounters: shows a list of encounters for the selected patient
To view the list of programs which this patient is enrolled in, click the
In this list you can click on a specific program to edit details of the program enrolment, as shown below:
Encounters tab behaves in the same way. Clicking on it will show a list of encounters which have been recorded for this patient:
Clicking on an encounter in the list will then take you to the details page for that encounter. For example:
You can also view a simple history of changes made to the patient record, by clicking the
History button which is on the bottom left of the screen:
This will show a dialog window with a basic history view:
Click the down arrow beside an edit for more information.
Patients can be enrolled in a program relevant to the intervention and the patient's illness.
Programs are customisable and specific to each context and country. Examples of programs are HIV Testing & Counselling, HIV Care & Treatment, TB & Malaria programs. For each program you can have defined any number of fields which are entered when registering patients, containing information in defined formats, such as dates, text, drop down lists and the like.
Patient Program Enrolment
To enrol a patient into a program select the
Add Program button in the top right corner of the patient details view.
This will open a dialog window with a list of available patient programs. Programs which the patient is already enrolled in are greyed out and can’t be selected.
To enrol a patient into a program select the desired program from the list. This opens the program enrolment document where program specific information can be entered.
Note, the content of the program enrolment document is program specific and can be configured by the site administrator.
An 'Encounter' is the recorded visit of a patient, and their treatment, under a specific program.
To view the list of encounters, navigate to the
Encounters item under the
Clicking on this will bring up a list of encounters that have been recorded, and shows details about the encounter as you can see below:
Patient Program Encounters
Once a patient is enrolled in a program, an encounter for this program can be created.
Like programs, encounters are highly customisable and are tailored to a specific situation. The encounter has some basic information, such as date & time of the encounter, status and clinician; and a range of fields of information, divided into sections. These can be as simple or complex as you like.
To create an encounter, select
Add Encounter through the drop-down menu in the right top corner.
This will open a dialog window to create an encounter.
First, the program enrolment associated with the encounter must be selected.
Secondly, the encounter date must be selected. The encounter date can be in the past (for entering a finished encounter), or in the future (to schedule an encounter - AKA make an appointment).
Once an encounter is created, the full encounter document will open to allow encounter details to be entered.
Every encounter has an encounter header where common encounter details can be updated, e.g. the clinician who handles the encounter or the encounter status.
An encounter can have three statuses:
- Pending (this status can be displayed as scheduled or missed depdning on the current date)
More button in the right top of the encounter detail view opens a column with additional encounter information such as a summary of previous encounters and the option to add an encounter note.
You can easily view patient details while looking at an encounter. Simply click on the patient name at the top of the encounter header, as shown:
Export Patient List
The list of patients can be exported to a comma separated file. This will export the following patient details:
- National ID
- First name
- Last name
- Date of Birth
This can be done by clicking on the
Export button in the top right corner of the patient list view.
Reports will show you a list of reports that have been configured for your system.
You can click on the