OpenMRS Open Medical Records System

Transcription

1 OpenMRS Open Medical Records System INF5750 Saptarshi Purkayastha, Research Fellow, NTNU, Norway (using material from EHSDI course)

2 OpenMRS A free open source medical record system A web application written in Java with a MySQL/Postgres/< > backend A framework rather than a single program - its functionality is typically provided through custom "modules Modules are deployable on runtime without having to restart the web server or web application

3 A global community (Impl map) Last release had 72 developers. Overall more than 300+ developers have written code in opensource way

4

5 Core EMR domain objects Obs is short for observation It can be measurement or a question, e.g. What is a person's HIV status? Are they pregnant? What is their height? What is their weight?

6 Many EMR's start as spreadsheets, using a flat table to hold observations of patients, e.g. Observations Patients

7 Table gets unmanageably big as we keep adding new observations Gets really complicated when we want multiple records of the same observation type, e.g. weight change over time Wasted space when columns aren't used

8 Each observation becomes a concept and a value like a question and an answer PATIENTS CONCEPTS OBSERVATIONS

9 Concept name is very specific and includes units Concept id

10 Observations typically come from an event such as: The patient visits a clinician A form is submitted which records observations An event such as this is called an Encounter It describes a formal interaction between a provider and a patient Encounters can have many observations

11 Thus for a single encounter we want to store the following: Patient Provider Time/date Location Observations

12

13

14

15

16 Disease-specific EMR (MDR-TB) Credit: WHO-TB and PIH

17 Inpatient Care Credit: Andrey Kozhushkov, Ghislain Kouematchoua (Göttingen)

18 Credit: Dave Thomas Research Data Coordination

19 Adaptive Turnaround Documents Credit: Vibha Anand, Paul Biondich (Regenstrief)

20 Eligibility Across Institutions Credit: Monica Waggoner

21 Google Maps Integration Credit: Owais Ahmed, Aamir Khan

22 Credit: Brian Mckown (AMPATH) ID Cards and Barcodes

23 Mateme Touchscreen Registration Credit: Jeff Rafter (Baobab), Evan Waters (PIH)

24 Credit: Rowan Seymour iphone App

25 Notifiable Condition Detector Credit: Shaun Grannis, Regenstrief Institute

26

27 OpenMRS Development Primer

28 Controllers use Service interfaces implement The different layers interact with each other through interfaces, making it easier to change implementations Service implementations use DAO interfaces implement DAO implementations use Session factory

29 All of the DAO methods need valid sessions and transactions This code has to be in every method public List<Example> getexamples() { Session session = sessionfactory.opensession(); session.begintransaction(); List<Example> examples = session.createcriteria(example.class).list(); session.gettransaction().commit(); session.close(); return examples; }

30 Is an architecture which separates the data (model) the business logic (controller) the presentation (view) Model Classes, DB Controller Servlets View JSPs

31 Model Helper Classes Controller Servlet classes Attributes View JSPs Request Response Client

32 The controller receives the request from the client Parameters are read from the request Model classes used for any business logic Controller doesn't return any HTML JSP creates the response Get parameters from request Consult the model classes Set attributes on request or session Forward request to JSP

33 public void doget(httpservletrequest request, HttpServletResponse) { String name = request.getparameter("name"); 1 String password = request.getparameter("password"); User user = Security.login(name, password); 2 request.setattribute("curuser", user); 3 } RequestDispatcher view = request.getrequestdispatcher("/login.jsp"); view.forward(request, response); 4 Gets parameters from the view Consults the model for any business logic Sets attributes to be used by view Forwards the request to the view

34 This JSP can now return an HTML response using the attributes set by the controller <p>result is: <%= ((User)request.getAttribute("user")).getName() %> </p> However, this still requires Java code, which might be quite complex if we need to generate something like a table of results One alternative to this is...

35 This requires the usebean and getproperty actions, e.g. <p>result is: <%= ((User)request.getAttribute("curUser")).getName() %> </p> <p>result is: <jsp:usebean id="curuser" class="user" scope="request" /> <jsp:getproperty name="curuser" property="name" /> </p>

36 The sole purpose of a Validator is to validate the command object of a form View Errors Validator Any errors it finds, it sends back to the view Command FormController Success Request Success

37 Controllers beans are configured with validator beans in XML, e.g. <bean id="personvalidator" class="ehsdi.personvalidator" /> <bean id="personform" class="ehsdi.personformcontroller"> <property name="commandname"><value>person</value></property> <property name="formview"><value>/personform</value></property> <property name="successview"><value>person.list</value></property> <property name="validator"> <ref bean="personvalidator" /> </property> </bean> Controller will now automatically validate the person when form is submitted

38 What if submitted values cannot even be bound to the command object? Spring will create its own error message, which will be displayed by <form:errors>, e.g. Failed to convert property value of type [java.lang.string] to required... Error Age: Command Object xa!fsb Binder Person Validator

39 Submission Binding Validation Form Editors Command object Validators Edit Person Person Name: Bob Smith name: Bob Smith NameValidator DOB: 28/05/81 Custom DateEditor DOB: PersonValidator Married: Yes Custom BooleanEditor married: true One validator can invoke another

40 login.jsp... <openmrs:portlet url="login"/>... portlet tag is handled by PortletTag login.htm

41 login Gets url attribute PortletTag.java /portlets/login.portlet Creates portlet URL Requests portlet URL openmrs-servlet.xml urlmapping *.portlet PortletController Maps URL to controller PortletController.java /portlets/login.portlet /portlets/login Gets servlet_path attribute Removes.portlet Forwards to view... openmrs-servlet.xml jspviewresolver /portlets/login /portlets/login.jsp Maps view to JSP login.jsp Displays JSP!

42 Much more details (openmrs.org) Lots of details but very flexible and modular