Overview
Reference Application 2.8.1 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:
...
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.
...
A patient can be admitted, discharged or transferred from Patient Summary or Patient Visits under Current Visit Actions.
Locations can be configured from System Administration - Advanced Administration - Manage Locations. You need to have a location marked with the Visit location tag, which has children marked with the Admission location or Transfer location tags.
For an example look at the setup in the demo data. See Demo.
Configure Metadata
Click on the Configure Metadata app on the main apps screen. If you want to add, edit, retire/restore or delete metadata in the new UI, this is where you go.
...
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.
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 for configuring metadata i.e add, create, retire/void, restore and delete metadata, as seen above you can also configure where and how your form will appear. Let's discuss these settings individually.
...
In the reference applications, user and provider accounts are linked to a person record and are managed from the same page. From the home page navigate to the account listing page by clicking System Administration -> Manage Accounts as seen in the screenshot above to view all the accounts.
- To add a new account, from the account listing page, click on the 'Add New Account' button, fill the form and save.
- To Edit an existing account, from the account listing page click the pencil icon beside the account you wish to edit.
...
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 detailsNew 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,
OpenMRS Information
Operating System Information
Java Runtime Information
User Information
Memory Information
Database Information
Module Information
New Features
Divided the existing System Information under different set of categories to increase the usability
Used some new kind of Icons to illustrate the Information Category properly
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
OWA included in RA - System Administration, Add-on Manager and Cohort Builder
See this RA-1427Biometrics 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-1287Ability to edit implementation forms
See Ticket and try it out at qa-refappPre-built Reporting Tools
See RA-1257 and RA-1258
...