More Metadata Management in Admin UI project is one of the GSoC projects which are designed to migrate some of these administrative functionalities to the modern open web app view. In the System Administration OWA project, We focused on the following functionalities,
- Manage modules
- System Information
- Manage Scheduler
Used technologies for the developments,
- Front End Development : HTML, CSS, Angular JS, jQuery
- Back End Development: Java, REST API
This feature will be used to manage the modules in the OpenMRS reference application. Users can use this implementation for these following functionalities, Features of the Manage Modules
- List all the installed Module — New Icons used to indicate the module status
- Start the module
- Stop the module — Confirmation Popup will be shown with the dependent modules details to alert the user
- Delete/Unload the module — Confirmation Popup will be shown with the dependent modules details to alert the user
- Check updates — Module updates will be checked with OpenMRS AddOns and listed in the new page for
the user selection.
- Check one module update — Check the update with OpenMRS AddOns and indicate the update status
- Start All Modules — No Modifications
- Add/Upgrade Modules — Implemented Drag and Drop feature
- Search Modules — Connected with OpenMRS Add-ons and user can search the module independently
- Search Module Information — User can view the detailed information about the searched module
- Module Information View — Used to display the module information with required modules, aware of modules,
and depend on module details
- View not installed module information — Connected with OpenMRS add-ons and indicate the user about the installation features.
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
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
- List all the installed Module — New Icons and UI used to indicate the module status
- Schedule Task — No Modifications
- Shutdown Task — Confirmation Popup will be shown to alert the user
- Reschedule Task — It will reschedule the existing task in the system
- Delete Task — Confirmation Popup will be shown to alert the user
- Reschedule All Tasks — It will reschedule all the tasks in the system
- Shutdown All Tasks — It will shut down all the tasks in the system
- Startup Tasks — It will reschedule all the tasks in the system
- Refresh Tasks — It will refresh the list of registered tasks
- Add New Task Definition — Used to create new Task Definition, Implemented new UI for this functionality
- Edit Task Definition — Used to edit existing Task Definition, Implemented new UI for this functionality
How to run the SysAdmin OWA in the Reference Application
You should install these following modules to run the SysAdmin OWA in your reference application,
Requirements for the SysAdmin OWA - Version 1.0.0
- Open web app module - version 1.7 or greater
- Web Services REST module - version 2.21 or greater
If you do not have those modules, Please follow these commands to install them,
mvn openmrs-sdk:install -DartifactId=owa -Dversion=1.7-SNAPSHOT -DserverId=adminmodule
mvn openmrs-sdk:install -DartifactId=webservices.rest -Dversion=2.21 -DserverId=adminmodule
Please follow this steps to install and run the SysAdmin OWA in your Reference Application.
- Go to OpenMRS Add-Ons official website and Search for SysAdmin OWA
- Download the latest version of the SysAdmin OWA as the ZIP file
- Run your OpenMRS Server and log in as Admin user
- Go to Manage Open Web Apps page through the Administrative Page
- Upload this downloaded ZIP and install the OWA to the server.
- Now you have loaded the OWA and can see the updated list in the Manage Open Web app page
- Click on the SysAdmin OWA and start running.
Create OWA Icon in the homepage
If you want to add Icon to the home page, then follow this use full tutorial to add the Icon.
How to Contribute to the Project
You need the following skills to contribute this project,
- Better understanding of AngularJs and jQuery development
- REST Web Services and OpenMRS APIs
- Knowledge of HTML, CSS
- If you want to contribute on this backend, you want to work with JAVA.
Please go and download the project source code from the GitHub repository. Then follow the past discussion on the OpenMRS talk forum and understand the development flow.
Production build steps
You will need NodeJS 4+ installed to do this. See the how to install instructions here.
- Once you have NodeJS installed, you need to install Gulp and Bower (first time only) as follows:
npm install -g gulp bower
- Install the dependencies (first time only):
npm install && bower install
- Build the distributable using Gulp as follows:
This will create a file as
SystemAdminstration.zip in the
dist directory, which wants to be uploaded to the OpenMRS Open Web Apps module.
Please find these useful talk forums and other documentation regarding this project,
Related blog posts
- More Metadata Management in AdminUI - GSoC 2017 Project