Clinic
ODK Clinic v1.0, the app described below, has been deprecated, but the code is available here. Its replacement, ODK Clinic v2.0, was developed by the ODK team in collaboration with AMPATH. A demo video can be seen here. The code for v2.0 was created for a research project and is not suitable for public release. If you are interested in helping with a public release of ODK Clinic v2.0, contact Nafundi.
OpenMRS is an open source medical record system used in many developing countries. In most deployments of OpenMRS, clinicians fill out a paper form with patient data. They place that form into the patient's folder and every few days, data clerks enter that information into the OpenMRS server. Once in the server, the data is available for clinical studies, administrative reports and sometimes printed patient summaries. While this is an improvement over a purely paper-based system useful patient data (clinical alerts, lab tests, drug interactions) are not readily available to clinicians for decision making at the point of care.
To address this issue, the Open Data Kit (ODK) team has been working to bring mobile phone connectivity using ODK to OpenMRS. Our goal is to bring a simple and elegant OpenMRS experience to the phone. To this end, Clinic provides patient demographic and encounter history download.
We have much more functionality to add. If you are interested in helping with this ongoing effort, should join the ODK mailing list and help us bring mobile to OpenMRS. You should also check out other projects in this space!
- https://wiki.openmrs.org/display/docs/Mobile - List of all the OpenMRS mobile projects
- https://bitbucket.org/androidopenmrs/androidopenmrs/overview - Running the OpenMRS platform on an Android phone
- https://wiki.openmrs.org/display/docs/OpenMRS-jr - Download patients and complete forms on J2ME phones
- http://medic.frontlinesms.com/ - Connecting OpenMRS to SMS tools
- Please read all the instructions and notes before beginning.
- You will need an Android phone (like the T-Mobile G1, T-Mobile myTouch 3G, Verizon Droid, Google Nexus One) to install ODK Clinic. If you don't have an Android phone and you have some technical expertise, you can follow our instructions for installing the emulator.
- If you have installed a previous version of ODK Clinic, please uninstall it first. Go into Settings, Applications, Manage Applications, and find the old version and uninstall it. You can then proceed.
- From your phone's application drawer, choose Settings, then Applications. Make sure Unknown sources is checked.
- Return to the application drawer and choose Browser. Navigate to https://opendatakit.org/downloads/download-info/odk-clinic/ and select ODK Clinic vN.N.apk
- In the download window, you will see ODK_Clinic_vN.N.apk. Select it to install after you approve the security settings.
- When ODK Clinic is run for the first time, you will be prompted to enter the connection details of your OpenMRS server. Once you've correctly entered in the server details, press the back button on your Android phone. The default rwinkwavu.cs.washington.edu server will work well for demos.
- If you currently don't have any patients downloaded, ODK Clinic will automatically display the "Download Patients" window. Select a cohort from the list in the "Select Cohort" dialog box and download. If the list of cohorts is not up to date, press "Refresh" to update the list. Once ODK Clinic has downloaded all the patients from the cohort, you will be returned to the main screen.
- Downloaded patients can be searched for in the top search box. Patients can also be optionally found by barcode by clicking the barcode icon next to the search box and scanning the patient's barcode.
- Selecting patient will bring up a patient information screen, with a list of available patient observations. Clicking on a patient observation will bring up a screen providing a detailed view of the latest patient observations.
If you have not installed OpenMRS before, the OpenMRS Appliance is a great way to started. If you already have OpenMRS installed, you will need the Reporting Compatibility and XForms modules.
- Once you have downloaded the .omod files for a module, login to OpenMRS as an admin and click on the "Administration" tab.
- Under the "Modules" heading, click on the "Manage Modules" link.
- Click the "Browse..." button under the "Add Module" section, and browse to the .omod file you've downloaded. click the "Upload" button, and wait for OpenMRS to restart and load the module. If OpenMRS has successfully installed the module, then the module's name should be displayed under the "Manage Modules" section.
Patients are downloaded into ODK Clinic as part of a "cohort". To create a cohort, you will need the Reporting Compatibility module.
- Log into OpenMRS, click on the "Cohort Builder" tab in the main horizontal navigation bar (next to "Administration" tab).
- Under the "Search" heading, search for the patients which match the criteria for the cohort that you are creating. The various tabs allow you to search based on their respective properties, eg. you can search for a "Male" between the ages of "5" and "10" under the "Patient Attributes" tab.
- Once you've found a suitable cohort, you can save it by clicking on the save icon at the bottom of the list (next to the "Actions:" heading). A popup will appear. Enter the name of your cohort and a short description of it, and click the "Save" button.
Patient history is downloaded in ODK Clinic using the Medical History functionality in the XForms module.
- Log into OpenMRS, click on the "Administration" tab in the main horizontal navigation bar.
- Under the "XForms" heading, click on "Medical HIstory Fields".
- Search for the concepts you would like to appear on the phone. Drag them from the search result on the right, into the list on the left.
- Clinic has only been tested extensively with OpenMRS 1.6.
- Be careful when using Clinic with real patient data. Clinic does not currently encrypt the transfer or storage of data.