UgandaEMR User Manual
  • Introduction
  • Terminologies
  • System Setup and Configuration
    • UgandaEMR 1.x Installation
    • UgandaEMR 2.x Installation
    • UgandaEMR 3.x Installation
    • Linux Installation
    • Post-installation Configuration
  • Backup and Restoration
    • Linux backup
  • Upgrading UgandaEMR
    • Trouble Shooting
  • Configuring your installation
  • Managing User Accounts
  • Provider Management
    • Creating a New Provider
    • Making an existing user a provider
  • Patient Management
    • Finding Patient
    • Patient Registration
  • Fingerprint
    • Configuration
    • Search by Patient Fingerprint
    • Add Patient Fingerprint
  • Entering Client Information
    • HIV Testing Services Client Card
    • ART Card
    • HIV Exposed Infant Card
    • HIV Counseling and Testing Client Card
    • Maternal and Child Health Cards
    • Safe Male Circumcision
    • Outpatient Form
  • Reporting
    • UgandaEMR Reports
    • Cohort Builder
    • Data Export
    • Sending Report to DHIS2
    • Sending Metrics Report
    • Audit tool Reports
    • Troubleshooting Report Tips
  • Data Quality Checks
  • Patient Provider Notifications
    • Configurations
    • Message Customization
    • Patient Enrollment
    • Patient De-registration
  • Patient Flags
  • Program Workflows
    • Differentiated Service Delivery Models (DSDM)
    • HIV Recency Testing
    • ART Regimen Lines
    • Tuberculosis
    • COVID19
  • Troubleshooting Tips
  • Uninstalling UgandaEMR
    • Unistalling UgandaEMR older versions
  • Point of Care (POC)
    • Installation and Configuration
      • Roles
    • Work Flows
      • Reception
      • Triage
      • Clinician
        • HIV Clinic
      • Laboratory
      • Pharmacy
  • Data Exchange
    • ART Access Integration
    • Viral Load Integration
    • Send Aggregate Reports
    • Patient Data Upload
      • Uploading Viral Load Results
  • UgandaEMR Mobile
    • Introduction
    • Download Patients
  • Release Notes
    • 1.0.14
    • 1.0.16
    • 1.0.17
    • 2.0.0
    • 2.1.0
    • 3.0.0
    • 3.0.4
    • 3.1.0
    • 3.1.3
    • 3.2.0
    • 3.3.0
    • 3.3.7
    • 3.4.1
Powered by GitBook
On this page
  • Patient Registration
  • Editing Patient Registration Information
  • Merging Patients
  • Marking Patients as Dead
  • Marking a Dead Patient as alive
  • Common Errors
  • User is not a provider
  • Failed to save changes during patient registration

Was this helpful?

  1. Patient Management

Patient Registration

PreviousFinding PatientNextFingerprint

Last updated 2 years ago

Was this helpful?

Patient Registration

1.Login and on the home page click the Find Patient Link circled below

3.On clicking Create New Patient, you enter patient details as below;

Editing Patient Registration Information

1.Login and on the home page click the Find Patient Link circled below

2.In the Search Bar, type any patient identifiers to search for the patient, the record of the patient appears as shown below.

3.Click on the last action that has Edit Demographics as shown below;

4.Edit Patient Information by clicking on the pencil icon next to a section header where those details belong

5.Confirm the details and Save the information.

Merging Patients

Patient Merging in UgandaEMR refers to the act of “retiring” Patient B in favour of patient A. In such an event, the visits, encounters, observations and other underlying objects which belonged to patient B will be transferred to Patient A, and Patient B will be retired. In a multiple patient merge process, Patients A, B and C may be retired in favour of patient X. Patient Merging is useful in situations where duplicate records have been created for a single patient.

Note: Patient merging is uni-directional only. It does not allow the restoration of merged data i.e. you cannot reverse the process. Therefore patient merging shouldn’t be taken lightly and effected only if you are 100% sure that the patients are the same.

To merge patients;

  1. Click on the “Find Patients to Merge” link as shown below.

  2. Select a minimum of two patient attributes to search on and click “search” as shown in the image below.

  3. This displays a list of patients who match the attributes used in the search. Select two or more patients to continue.

  4. Select your preferred patient to keep and click “Merge Patients” button to continue

  5. A Dialog box displays asking you to confirm the Merge. Click “Ok” to confirm and complete the patient merging process or "Cancel" to abort the process.

    You should see a notification indicating that the process was completed successfully.

Marking Patients as Dead

1.To mark patient as dead, you will have to log into one of the clinics, i.e. SMC, ART, TB, MCH, OPD, Lab.

Marking a Dead Patient as alive

TBD

Common Errors

User is not a provider

Solution

The above means your User Account does not have privileges to provide care to a patient. You therefore have to add Provider role to the user account as indicated herein

Failed to save changes during patient registration

Solution

This problem is common with implementations that have been upgraded from 1.6.3 and is caused by null or empty string values for patient attributes during migrations.

The solution is as follows:

  1. Backup your database

  2. Run the following command:

DELETE FROM person_attribute WHERE value IS NULL OR value = '';

For Version 2.1.0 and above

  1. Go to start menu and search for Execute Mysql Script and click on it. This will pop up a dialog window

  2. Click install. This will prompt you to select a file.

  3. Select the Download file and click okay.

  4. Restart Computer.

2.In the Search Bar, type any patient identifiers to search for the patient, if no results are returned, click the Create new Patient link as shown below.

3.1.Patient Name 3.2.Gender 3.3.Birth date 3.4.Marital Status 3.5.Birth Location aka village in which patient was born 3.6.*Address: Where the patient lives. Please follow the same procedure as above

3.7.Phone Number: _______ 3.8._ Next of Kin:

3.9.* Confirm: Shows all the bio-data collected about the patient. 3.10. Saving The data: Click confirm to save, if not click cancel to edit. You should see a patient registration summary once saving is successful as below

Login as a user with administrator privileges and click the “Legacy System Administration” link as shown in the image below.

The "Preferred Patient" is the patient who "survives" in favour of the retired patient.

An example is; SMC; login at the "SMC clinic" session, as shown below.

2.A screen will open as shown below. Select the "Find Patient Record" option.

3.On the screen that appears, type the name or ID of the patient, as registered in the system.

4.Search for and find the client - Demo 123

Download a script from

https://sourceforge.net/projects/ugandaemr/files/2.1.0/scripts/clear_edit_error.sql/download
Register Patient Link
Register Patient Link
Patient Search Record
Edit Patient Demographics
Registration Summary
Find Patient to Meger
Search Patient
Patient List
Complete Patient Merge
Mark Patient Deceased
Check Patient Deceased
Save Changes
Patient Marked as Dead
User Not Provider Error
Failed to save changes
PatientName
Birthdate
Marital Status
Next of Kin
Legacy System Administration
SMC Clinic
Gender
Merge Patient
Patient Search Bar
Find Patient
birthlocation
Patient ID
Confirm
Patient Example