Patients
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 v7-07-00-beta9+
.
Patients
In order to use the program module, you'll first need to create and manage patients to dispense to.
Patient Registration
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.
Clicking the Create
button will create the new patient record, and you'll see a new screen, showing the patient details:
Patient List
Navigating to the Dispensary
→ 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 Programs
tab.
In this list you can click on a specific program to edit details of the program enrolment, as shown below:
The 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.
Programs
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.
Encounters
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 Dispensary
menu:
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)
- Visited
- Cancelled
The 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:
- ID
- 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
Navigating to Dispensary
> Reports
will show you a list of reports that have been configured for your system.
You can click on the Print
button beside a report to print it. The system may show a dialog window requesting more information to be entered first.