Page Comparison

Overview

...

Reference Application 2.10.0  is a 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 3.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:

...

You can find more info about configuring the reference application here.

Features

As mentioned previously the Reference Application is built of small apps. There are a couple of apps provided out of the box and we expect to improve them and increase their number over time. The apps that come with the Reference Application focus on basic functionality. They are designed and developed in a way that satisfies as many use cases as possible and also can be adjusted to specific needs. In this paragraph we will describe features that come with the Reference Application and their configuration options.

...

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. (For more details see here.) 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.

...

The Reference Application is partially translated into several languages. (To see how to contribute translations, or just see the current status, see Translating the Reference Application.)

Each user account has a "default locale" that is applied when they log in. The administrator can set this when creating a user account, or a user can change it on their own from My Account (under their username in the header):

...

If you want to integrate the Address Hierarchy Module or add custom person attributes, you can find directions for Registration App Configuration.

...

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.

...

Note: You can now add custom forms in the actions section.  See Manage Forms to add your own action items.

...

Under the Configure Metadata screen, there is now a new app to "Manage Forms".  It is 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.

...

Show If - Do you want to display the form only if the patient has certain characteristics?  Perhaps you would only want a maternal health form to be visible on the patient dashboard of a female patient.  You would use something like "patient.person.gender=='F' && patient.person.birthdate < '2001-01-01T00:00:00.000+0000' && patient.person.dead==false".  Or show if males with an active visit "visit.active && patient.person.gender=='M' ". Or show if the patient has a current visit and they are currently admitted, "visit.active && visit.admitted". For more information on what properties are available, see the Conditionally displaying Apps and Extensions page.

If you are replacing a built-in form, with a new custom form, you can view the configuration of the integrated forms in the source code.

...

This allows implementers to add or remove applications to/from the system without having to build a module. This is done by configuring a JSON definition.  For more information see System Administration: Manage Apps.

Viewing And Managing Accounts

...

Note: Some Setting (formerly Global Property from 1.8 downwards) values are truncated to fit in the allocated space, clicking the pencil icon should take you to the edit screen from where you can see the entire value. On the listing page, hovering over the name cell should display the description also.

• Built-In Reports

  What this module does

  Built-in reports OWA provides basic reporting and give some insight into your data in Reference Application distribution. Data can be seen visually how they have spread and it gives an overview about the present data.

  Currently there are some basic reports available. If anyone wants to add more sophisticated reports, it's really easy and there are some common components that can be reused from the OWA when it  comes to displaying the data.

  Documentation / How-To

  You need to have the Reference Metadata module 2.7.0 or higher installed in your OpenMRS server. This module includes the report definitions which the built-in reports OWA is being displaying. 

  Currently there are 10 basic reports have configured. 

  • Number or Visits
  • Number of Patient Registrations
  • Number of Admissions per service area
  • Number of Transfers per service area
  • Number of Discharges per service area
  • Number of Visit Notes
  • List of Diagnosis’s made and quantity
  • List of Providers (grouped by active/retired)
  • List of Users (grouped by active/retired)
  • List of new Patient Registrations

  You can see those reports under Administration -> Manage Report Definitions -> Report Administration once you install the Reference Metadata module 2.7.0 or higher.

  After ensuring that the reports are properly configured with the Reference Metadata module installation, you can upload the  openmrs-owa-built-in-reports to your OpenMRS server.

  Then you can open up the owa from Administration -> Open Web Apps Module -> Manage Apps  -> Built In Reports. 

  Downloads

  https://github.com/JudeNiroshan/openmrs-owa-built-in-reports

  Screenshots

  List of Users in the OpenMRS system has visualized as follows:

  

  
  

  List of Diagnosis in the entire system is available as below:

  

  
  

  When there is no data in OpenMRS for any of the reports, it will be indicated to the user like below:

  

   

  More MetaData Management in Admin UI

  OpenMRS Legacy Module contains a lot of administrative functionalities which are needed to manage the reference application. Most of this administrative functionalities contain a legacy model and less experience to the users. So OpenMRS Community wanted to migrate those administrative features to the Modern Open web app view.

  More Metadata Management in AdminUI project is one of those projects which are designed to migrate some of these administrative functionalities to the modern open web app view. In the More Meta data Management in AdminUI project, We focused on this following functionalities,
  1. Manage Modules - This feature will be used to manage the modules in the OpenMRS reference application.
  2. System Information - This feature will be used to display the System information about the OpenMRS server and the system.
  3. Manage Scheduler - This feature will be used to manage the tasks in the OpenMRS reference application.

  These features are implemented as Open Web Apps with the modern view to the users.

  Implementation

  Those features are implemented as an Open Web App and included into the SysAdmin Open Wep App. 

  Used technologies for the developments, 

  • Front End Development : HTML, CSS, Angular JS, jQuery
  • Back End Development: Java, REST API

  

  Manage Modules

  This feature will be used to manage the modules in the OpenMRS reference application. Users can use this implementation for this following functionalities,

  Features of the Manage Modules

  
  

  Functionalities	Modification	New/ Existing/ Modified Feature
  1. List all the installed Module	New Icons used to indicate the module status	Modified Feature
  2. Start the module	No Modifications	Existing Feature
  3. Stop the module	Confirmation Pop up will be shown with the dependent modules details to alert the user	Modified Feature
  4. Delete/Unload the module	Confirmation Pop up will be shown with the dependent modules details to alert the user	Modified Feature
  5. Check updates	Module updates will be checked with OpenMRS AddOns and listed in the new page for the user selection.	Modified Feature
  6. Check one module update	Check the update with OpenMRS AddOns and indicate the update status	New Feature
  7. Start All Modules	No Modifications	Existing Feature
  8. Add/Upgrade Modules	Implemented Drag and Drop feature	Modified Feature
  9. Search Modules	Connected with OpenMRS Addons and user can search the module independently	Modified Feature
  10. Search Module Information	User can view the detailed information about the searched module	New Feature
  11. Module Information View	Used to display the module information with required modules, aware of modules, and depend on module details	New Feature
  12. View not installed module information	Connected with OpenMRS add-ons and indicate the user about the installation features.	New Feature

  
  

  System Information

  This feature will be used to display the System information about the OpenMRS server and the system. Users can use this feature to get this following information,

  1. OpenMRS Information

  2. Operating System Information

  3. Java Runtime Information

  4. User Information

  5. Memory Information

  6. Database Information

  7. Module Information

  New Features

  1. Divided the existing System Information under different set of categories to increase the usability

  2. Used some new kind of Icons to illustrate the Information Category properly

  3. Modified Module Information Section with some new ideas.

  Manage Scheduler

  This feature will be used to manage the tasks in the OpenMRS reference application. Users can use this implementation for this following functionalities,

  Features of the Manage Modules

  
  

  Functionalities	Modification	New/Existing/Modified Feature
  1.List all the installed Module	New Icons and UI used to indicate the module status	Modified Feature
  2. Schedule Task	No Modifications	Existing Feature
  3. Shutdown Task	Confirmation Pop up will be shown to alert the user	Modified Feature
  4. Reschedule Task	It will reschedule the existing task in the system	New Feature
  5. Delete Task	Confirmation Pop up will be shown to alert the user	Modified Feature
  6. Reschedule All Tasks	It will reschedule all the tasks in the system	New Feature
  7. Shutdown All Tasks	It will shut down all the tasks in the system	New Feature
  8. Startup Tasks	It will reschedule all the tasks in the system	New Feature
  9. Refresh Tasks	It will refresh the list of registered tasks	Existing Feature
  10. Add New Task Definition	Used to create new Task Definition Implemented new UI for this functionality	Modified Feature
  11. Edit Task Definition	Used to edit existing Task Definition Implemented new UI for this functionality	Modified Feature

  
    More Info here  wiki  and this blog

• OWA  included in RA - System Administration, Add-on Manager and Cohort Builder

  See this RA-1427

• Biometrics Support in Registration App

  See These Tickets  ( RA-1406 ,RA-1407 ,RA-1391 ,RA-1395 ,RA-1397 )

• Sticky Note on the Patient Dashboard

  See RA-1287  

• Ability to edit implementation forms  

  See Ticket and try it out at  qa-refapp

• Pre-built Reporting Tools

  See RA-1257  and  RA-1258

...

New to the OpenMRS 2.1 user interface is the OpenMRS Atlas  configuration.  When the implementation is first established, you must link ownership with an OpenMRS ID.  Click “Sign in with your OpenMRS ID” and provide your OpenMRS ID and password.  If your browser is already logged in to OpenMRS ID, it will use that account automatically when you click "Sign in". 

...

FontAwesome (5) has a much richer set of icons to to provide more unique and appropriate icons .

see how to use Font Awesome5  Icons

Bootstrap Integration Into the Reference Application

...