Patient Programs

View and Manage Patient Programs

You can manage Patients by programs in Open mSupply. This involves some special settings. Please see Patients for more information on how to view and create patients.

To use Patient Programs, 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+.

Store preference

You will also need to enable the user permissions shown below on the central server:

This is an example of the permissions required for a user to view and manage program specific features. The permissions required may vary depending on your configurations.

User permissions

The Patient Programs module is highly customisable and may look different depending on your configurations. Please contact your administrator for customisations.

Patients List

A new column named Program Enrolments will be added to the patient list to show the programs that the patient is enrolled in if the patient programs module has been enabled.

Program Enrolments

Viewing a Patient

There are four tabs on the patient detail page:

Patient Details: This tab contains the patient details.

The patient detail page will look very different from the standard patient detail page. This view is highly customisable and can be tailored to specific needs. Please contact your administrator if you would like to customise this view.

Patient detail

Programs: This tab contains the programs that the patient is enrolled in.

Clicking on a program will take you to the patient's program enrolment details. See Program Enrolment for more information.

This program tab will display 5 columns:

Column	Description
Program	The name of the program
Enrolment Patient ID	The patient's program ID
Additional Info	Displays program specific information. E.g. LTFU lost to follow up
Program Status	The status of the program
Enrolment Date	The date the patient was enrolled in the program

Programs

Encounters: This tab contains the encounters that the patient has had.

Clicking on an encounter will take you to the encounter details. See Encounter for more information.

This encounters tab will display 6 columns:

Column	Description
Type	The encounter type
Program	The program the encounter is associated with
Date	The date of the encounter appointment
Start	The start time of the encounter appointment
End	The end time of the encounter appointment
Additional Info	Displays additional information about the encounter. E.g. Encounter Scheduled means that the appointment for this encounter has been scheduled.

Encounters

Contact Tracing: This tab contains the contact tracing information for the patient.

Clicking on a contact will take you to the contact details. See Contact Tracing for more information.

This contact tracing tab will display 7 columns:

Column	Description
Program	The name of the program this contact is associated with
Date Created	The date the contact was created
First name	First name of the contact
Last name	Last name of the contact
Gender	Gender of the contact
Relationship	The relationship of the contact to the patient
Age	The age of the contact

Contact Tracing

There is also a History button on the bottom left corner of the patient detail page. Clicking on this button will show you a simple history of changes made to the patient record.

Patient History

Program

Patients can be enrolled in a program that is relevant to their health condition. A patient can be enrolled in multiple programs.

Enrolling a Patient in a Program

To enrol a patient in a program, click on the Add Program button in the top right corner of the screen or click the down arrow next to the button and select Add Program if the button does not say Add Program. A new window will appear for you to select the program you want to enrol the patient in. Programs that the patient is already enrolled in will be greyed out.

Add Program

After selecting the program, another window will appear for you to enter program specific information.

In this example, we are enrolling the patient into the HIV Care and Treatment Program.

Program Enrolment

Encounter

An Encounter is a recorded visit of the patient and their treatment under a specific program.

Viewing the Encounter List

Go to Dispensary > Encounters to view the list of encounters.

Encounter Navigation

The list of encounters is divided into 8 columns:

Column	Description
Type	The encounter type
Program	The program the encounter is associated with
Date	The date of the encounter appointment
Start	The start time of the encounter appointment
End	The end time of the encounter appointment
Patient	The patient the encounter is associated with
Additional Info	Displays additional information about the encounter. E.g. Encounter Scheduled means that the appointment for this encounter has been scheduled.
Status	The status of the encounter

Clicking on an encounter will take you to the encounter details.

Encounter List

Add an Encounter

To add an Encounter for the patient, click the Add Encounter button on the top right corner of the screen. Click on the down arrow next to the button and select Add Encounter if the button does not say Add Encounter.

Add Encounter

A window will open for you to select the encounter (this selection will vary depending on what programs the patient is enrolled in), visit date, clinician and add notes for this encounter.

In the below example, we are creating a HIV Care Encounter

Add Encounter

If the encounter is within the last hour, then you will be re-directed to the encounter page, otherwise, you will be re-directed to the encounter tab in the patient detail view.

Every encounter document will look differently, however there are some common features:

The top of every encounter will contain common encounter details. Some of these details may be editable like Clinician and Visit Date and Time.

An encounter can have three statuses:

Pending: The encounter has been scheduled but not yet completed.
Visited: The encounter has been completed.
Cancelled: The encounter has been cancelled.

Encounter

The side panel (opened by clicking More on the top right corner) will contain additional information such as previous encounters.

Encounter

In this example, we are viewing the HIV Care Encounter

Encounter

Contact tracing

Contact tracing is the process of identifying people who might have been exposed to a disease through the patient. The contact can then be contacted, registered and enrolled into a matching program if needed.

Add a Contact

To add a contact for a patient, click the Add Contact button on the top right corner of the screen. Click on the down arrow next to the button and select Add Contact if the button does not say Add Contact.

Add Contact

A window will open, inviting you to select the type of contact you want to add. Currently, only HIV Partner Testing is available. Click Ok to proceed.

Add Contact

Edit a Contact

Edit Contact

Linking a Contact to a Patient

Once a contact has been added to mSupply, they can then be linked to patient who came into contact with them. Do this by clicking the Link to Patient button on the top right of the screen.

Link to Patient

This will open a search window where you can search for the patient you want by their first name, last name or patient ID. Once you have found the patient, click on the patient to link them to the contact.

Link to Patient

If the patient is already linked to the contact, but you want to change the patient because you linked the wrong patient, click the Unlink Patient button on the top right of the screen.

Unlink Patient