| Info |
|---|
This documentation refers to an older version of the OpenMRS reference application. You can find the latest at OpenMRS Reference Application 2.x Implementer Documentation |
...
| Note |
|---|
This page is outdated and no longer receives updates! |
| Table of Contents |
|---|
Overview
OpenMRS 2.2 is the latest release of our new Reference Application, a state of the art implementation of OpenMRS, which may serve as a solid base for new implementations. It is designed using the latest UI 2.x and App Framework, which make it easy to add new functionality as small apps in a similar fashion to mobile applications. The Reference Application comes with a number of apps out of the box. Currently we provide apps, which enable you to:
register patients
start and end visits
list patients with active visits
admit/transfer/discharge patients
take clinical notes
capture patient vitals
display patient summary and visit history.
capture allergies
Enter forms from the patient dashboard
...
Try It Out!
Hosted UAT Test Server
| Anchor | ||||
|---|---|---|---|---|
|
You can explore the latest released version of the Reference Application by going to http://uat01.openmrs.org:8080/openmrs/ and signing in with the following credentials:
username: | doctor | nurse | clerk | sysadmin |
|---|---|---|---|---|
password: | Doctor123 | Nurse123 | Clerk123 | Sysadmin123 |
Each user has access to different parts of the application and we encourage you to explore them all.
...
For all features of the reference application to work well, you will need to make the configurations below:
To register a patient, the logged in user needs to have an associated provider account, meaning no patient registration will be possible if there is no user that has a provider account and yes this includes super user. Go to System Administration - Advanced Administration - Manage Users - Add User to add a new user. Remember to assign them appropriate privileges. Next go to System Administration - Advanced Administration - Manage Providers - Add Provider and add a new provider for the previously created person.
Advanced Configuration
You can find more info about configuring the reference application here.
...
When you first open up the Reference Application you will see a login screen.
...
You can login as a system developer with full privileges by giving the default username admin and password Admin123. You also need to select Location for this session. Locations are configurable from Advanced Administration - Manage locations. In order for a location to appear on a login screen you need to open it up and select a checkbox next to the Login location tag.
...
You can see all apps that are available in your installation by logging in as a system developer and opening the home page.
...
Less privileged users do not see all apps, because they are hidden if they don't have privileges to use them. We have defined a set of application and organizational roles, which you can use, modify or create new as needed. Organizational roles inherit from application roles. Roles start from "Application:" or "Organizational:", e.g. "Application: Writes Clinical Notes" or "Organizational: Doctor". You can view all roles by signing in as an administrator and going to System Administration - Advanced Administration and Manage roles.
...
The registration app is available under the Register a patient button from the home page. It is seen by users having the "Application: Registers patients" role. 
...
The registration form supports keyboard navigation. You can go to a next field by hitting the TAB or ENTER key. Going backwards is possible with SHIFT + TAB.
...
The system also searches for similar patients based on the information you entered so that you can review them and avoid creating duplicates. As soon as a duplicate is found you will see a bar at the top that there are similar patients found and you can click the Review patient(s) button to see them.
...
If you want to change or add more fields to the form, you can go to System Administration - Advanced Administration - Settings - Layout and edit Address Template.
...
If the search field is empty, you see a listing of recently viewed patients. As soon as you start typing and enter at least the number of characters set as the value of the Min Search Characters global property on the settings page, you will see results changing live for what you entered. Note that when searching by patient identifier you need to enter the full patient identifier because partial searches only work when searching by patient name.
...
Patient Summary
Once you open up a patient you see a clinical summary.
...
The header has basic demographic details, which you can edit by clicking the Edit button. There's also Show Contact Info, which expands a section with contact details when clicked. If a patient has an active visit you can see a green bar in the header saying when it started and also patient's current location.
...
A diagnosis that was entered as free-text is displayed in quotes. Each kind of diagnosis is displayed only once. See also Visit Notes.
Vitals
The box shows the last captured vitals. See also Capture Vitals.
...
On the right you can find a box with actions. General Actions are:
Start Visit - start a visit if there is no active visit yet
Add Past Visit - enter a retrospective visit
Merge Visits - merge past visits
Chart Search - search for patient chart
Any forms which are marked as showing up under General Action section
Schedule a New Appointment
Request Appointment
Current Visit Actions are displayed if there is an active visit and they include:
End visit - end a visit
Visit Note - enter a visit note
Admit to Inpatient / Exit from Inpatient - change a type of visit
Transfer to Ward/Service - transfer to a defined location (displayed only when in an inpatient visit)
Capture vitals - enter patient's vitals
Note: Some actions may not be visible based on privileges of the currently logged in user.
...
It is accessible from the Visits box on Patient Summary. You can either open up a specific visit or click Show more info to display the latest visit.
...
You can see it has the same patient header as Patient Summary. Right below on the left you can see a list of visits with date and diagnoses captured during a particular visit. The most recent visit is displayed at the top. You can click at any visit to see its details on the right. It has Visit Actions buttons if a visit is active and a list of encounters, which you can view by clicking show details. It is possible to edit them with the pencil icon or delete with the x icon.
Only encounters that are specifically configured as "editable" can be edited. This is how it's done for the built-in reference application forms. There is currently not a way to edit your own forms. In order to edit an encounter, you either need to have the privilege "Task: emr.patient.encounter.edit", or else have participated in the encounter.
...
It is accessible from both the home page via the Capture Vitals app or directly from Current Visit Actions on both Patient Summary and Patient Visits. The app is designated for a standalone capture vitals station. It allows you to quickly find a patient, enter vitals and continue repeating this process. The action available from Current Visits Actions allows you to capture vitals for the currently displayed patient and return to the summary.
...
The form for capturing vitals has basic validation. It calculates BMI from Height and Weight. It supports keyboard navigation in the same way as the registration form.
...
It is accessible from the Patient Dashboard, by clicking the pencil beside allergies. If there are any existing allergies, it shows them in the list. If the patient has no known allergies, this can be specified by clicking the green "No Known Allergies" button.
...
When you click to "Add New Allergy", it allows you to select the allergy type; drug, food or environmental. You can click the allergen, and then specify the reaction it causes and the severity. You can also add a comment if you like. After you click save, 
...
Visit Notes
The form for entering visit notes is accessible from Patient Summary and Patient Visits. It is listed under Current Visits Actions.
...
First you enter a primary diagnosis by starting to type in the Add presumed or confirmed diagnosis field. It has an auto-suggest feature which finds diagnosis concepts, but also has the Non-coded selection with the value you entered. You need to pick from the auto-suggest list to add the diagnosis, which then appears on the right under Primary Diagnosis. If you repeat these steps, your selections will appear under Secondary Diagnoses.
...
For an example look at the setup in the demo data. See Demo.
Configure Metadata
There is now a new App called Configure Metadata on the main apps screen. If you want to configure a custom form to appear in the new UI, this is where you go.
...
Manage Forms
Under the Configure Metadata screen, there is now a new app to "Manage Forms". This is a new feature in OpenMRS 2.1. It is now possible to add custom forms to the new user interface without any custom programming! When you initially enter Manage Forms, it shows you a list of forms that exist in the system. Obviously, before you can configure where a custom form will appear in the system, you must create the form. Both HTML and XForms are supported, but they must be created through the legacy user interface, under System Administration - Advanced Administration.
...
After you've created your custom form that you want to add to the new user interface / patient dashboard, you can click "Add" in the UI column next to the form name, as seen in the screenshot above. Clicking "Add" opens up the configuration screen for that form.
...
There is a rich user interface, as seen above, for configuring where and how your form will appear. Let's discuss these settings individually.
...
Under the System Administration App, you will find system administration tools. This currently includes the Style Guide, especially useful to programmers, It also includes Advanced Administration which returns you from the new user interface to the legacy user interface. This is useful for configuring legacy settings and modules that don't yet have a user interface in the new UI; like Reporting and Facility Data Module for example. You also manage concepts and forms through this link.
...
OpenMRS Atlas
New to the OpenMRS 2.1 user interface is the OpenMRS Atlas configuration configuration. When the implementation is first established, you must link ownership with an OpenMRS ID. Click Click “Sign in with your OpenMRS ID” and provide your OpenMRS ID and password. If If your browser is already logged in to OpenMRS ID, it will use that account automatically when you click "Sign in".
...
You can then drag your marker to the physical location of your site. Double-clicking on the site will allow you to view the details. Clicking the pencil icon will allow you to edit the details.
...
You can then choose to turn on Automatic Updates. This will allow the world to see the progress your uses are making with data entry; specifically the number of patients, encounters and observations you have entered into your system. Rest assured, no patient identifiable information is shared.
...