# Patient Registration

## Patient Registration

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

![Register Patient Link](/files/-M4y-PCZG2VDOHqO_riC)

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. ![Patient Search Bar](/files/-M4y-YHlhE8kefPbR8yZ)

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

3.1.*Patient Name*![PatientName](/files/-M4y-YHpi4Bt52Kn0AWW)\
3.2.*Gender* ![Gender](/files/-M4y-YHv5xerwX5yVuTE)\
3.3.*Birth date* ![Birthdate](/files/-M4y-YI0UmYSE8EbA3fr)\
3.4.*Marital Status*![Marital Status](/files/-M4y-YICKJ58263iXSQ-)\
3.5.*Birth Location* aka village in which patient was born![birthlocation](/files/-M4y-YIFy8vWa4lPVEIx)\
3.6.\*Address: Where the patient lives. Please follow the same procedure as above

3.7.*Phone Number: \_\_*\_\_\_\_\_\
3.8.\_ Next of Kin: ![Next of Kin](/files/-M4y-YIH2uFPTugTYTY_)

3.9.\* Confirm: Shows all the bio-data collected about the patient.![Confirm](/files/-M4y-YIJPIXStDQFg9uq)\
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 ![](/files/-M4y-YILLH_i-Z-4C6co)

## Editing Patient Registration Information

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

![Register Patient Link](/files/-M4y-PCZG2VDOHqO_riC)

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

![Patient Search Record](/files/WJ03SBrzG6oPYw3bkDNq)

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

![Edit Patient Demographics](/files/BjiJkFwCRSNHxywdjrVR)

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

![Registration Summary](/files/-M8PZs9xC5l7gVGJsX_y)

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. Login as a user with administrator privileges and click the “*Legacy System Administration*” link as shown in the image below. ![Legacy System Administration](/files/-M4y-YIN3WTIMcdPOJhB)
2. Click on the *“Find Patients to Merge*” link as shown below.

   ![Find Patient to Meger](/files/-M4y-YIPeJ3OsJRB26oh)
3. Select a minimum of two patient attributes to search on and click *“search”* as shown in the image below.

   ![Search Patient](/files/-M4y-YIRdy7OyxozZMd7)
4. This displays a list of patients who match the attributes used in the search. Select two or more patients to continue.

   ![Patient List](/files/-M4y-YITSMXqqiLtzraj)
5. Select your preferred patient to keep and click *“Merge Patients”* button to continue

   ![Merge Patient](/files/-M4y-YIVA_YTrYJ49UPz)\
   The "Preferred Patient" is the patient who "survives" in favour of the retired patient.
6. 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.

   ![Complete Patient Merge](/files/-M4y-YIXJvelh8baINNy)

## 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.

An example is; SMC; login at the "SMC clinic" session, as shown below.\
![SMC Clinic](/files/-M4y-YIZ5v1BZOPn4X3X)

2.A screen will open as shown below. Select the "Find Patient Record" option.\
![Find Patient](/files/-M4y-YIaSN0YiB8uirIv)

3.On the screen that appears, type the name or ID of the patient, as registered in the system.\
![Patient ID](/files/-M4y-YIcaVLpgb263Z0f)

4.Search for and find the client - Demo 123\
![Patient Example](/files/-M4y-YIe2cOMR3TSz0Ht)

![Mark Patient Deceased](/files/-M4y-YIgYwIY89d19_38) ![Check Patient Deceased](/files/-M4y-YIiVqrGFWixULR7)

![Save Changes](/files/-M4y-YIk0jIX7SmaTYBp)

![Patient Marked as Dead](/files/-M4y-YImwK6aRtFjL-Ys)

## Marking a Dead Patient as alive

TBD

## Common Errors

### User is not a provider

![User Not Provider Error](/files/-M4y-YIovg2xa8gGqK_m)

#### 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](broken://pages/-M4YKpw1ToPexgPxS_r4)

### Failed to save changes during patient registration

![Failed to save changes](/files/-M4y-YIqw0YxcAX_TthN)

#### 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. Download a script from <https://sourceforge.net/projects/ugandaemr/files/2.1.0/scripts/clear_edit_error.sql/download>
2. Go to start menu and search for Execute Mysql Script and click on it. This will pop up a dialog window
3. Click install. This will prompt you to select a file.
4. Select the Download file and click okay.
5. Restart Computer.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://mets-programme.gitbook.io/ugandaemr-documentation/patient-management/patient_registration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.