Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »

Overview

The File Browser module was designed to give users immediate and convenient access to patient records whose contents may not easily fit within the OpenMRS data model / application. For example, a new implementation may wish to give clinicians access to patient’s old paper charts by quickly scanning them instead of taking the time to manually back-enter this data. Other use cases include having a repository for patient notes saved as word documents, test results received in PDF format, or clinically relevant photographs.

The module accomplishes this by adding a tab to the patient dashboard containing a file browser. The browser automatically opens to a patient-specific folder stored on the server with a name equal to the patient’s preferred ID. In addition to downloading/viewing the files contained in this folder, the module allows users to upload files of any format and perform basic file-system operations such as renaming and deleting. 

How it works

The File Browser module creates a tab on the dashboard with an iframe pointed at a full-featured PHP file browsing/management script. The module passes the patient’s ID number to the script so that the proper folder opens by default. The module also ensures that the folder exists for the patient, and if not creates it (useful for new patients).

Installation Instructions

  1. Organize existing patient files into folders named by the preferred OpenMRS Identification number
  2. Setup a web server with PHP on the same machine as the OpenMRS server (Apache works great)
  3. Place patient folders somewhere in the webserver. Make sure that tomcat has permission to read/write this folder directly.
  4. Download and install the Simple Directory Listing PHP script by David Wan (link on this page)
  5. Install the File Browser Module through the module repository
  6. Set the global property filebrowser.url to the URL of the file browser PHP script and append ?cwdRelPath= then the pathname of the files on your webserver. For example, http://openmrs/SDL2.php?cwdRelPath=patientfiles/
  7. Set the global property filebrowser.patientfilepath to the local path containing the folders for the patients. For example: /www_root/patientfiles/
  8. Set the global property filebrowser.tabname whatever you want the tab to be called on your dashboard
  9. Make sure you have a backup routine for your files!

How to use it 

  1. Go to the patient dashboard
  2. Click the "File Browser" tab
  3. To view a file:
    1. Click on any file that you want to view, it will download and open
  4. For all other file operations:
    1. Click the small "login" link at the bottom of the file browser
    2. The default username is admin and password is test, this can be changed by directly editing the php file.
    3. Click the icon at the bottom for rename, upload, delete, etc.

http://modules.openmrs.org/modules/view.jsp?module=...

Screenshots

Release Notes

About

This module was developer by ____ for __.

  • No labels