Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Purpose and Benefits

This feature is used to receive and capture patient's information in the form of documents (patient's paper record scans, X-Ray images and other external documents). Bahmni allows you to upload these documents and associating it to specific visits of a patient. All these documents get attached to a patient's record and are viewable from the Visit dashboard.

Steps

Configure Patient Documents App

To configure the Patient Documents Module/App to appear on the Home page please add the config below to this path:  /bahmni/default-config/openmrs/apps/home/extension.json

Code Block
languagejs
linenumberstrue
"patientDocumentUpload": {
   "id": "bahmni.patient.document.upload",
   "extensionPointId": "org.bahmni.home.dashboard",
   "type": "link",
   "translationKey": "MODULE_LABEL_PATIENT_DOCUMENTS_KEY",
   "url": "../document-upload/?encounterType=Patient Document&topLevelConcept=Patient Document&defaultOption=Patient file",
   "icon": "icon-bahmni-documents",
   "order": 6,
   "requiredPrivilege": "app:patient-documents"
 },


Note
titleURL in the code snippet above

The url is :  "url": "../document-upload/?encounterType=<X>&topLevelConcept=<Y>&defaultOption=<Z>”,

  1. The extension filepath should be: extension-<X>.json
  2. <Y> is the top level concept in openMRS. This enables an auto-complete set while selecting Upload type:  Assign concept set name to "topLevelConcept" in the url.
  3. <Z> has to be a set member of ’<Y>’ which is the top level concept. It is the default option that appears in the UI for upload type.

Configure Active Patients Tab

To configure the active patients Tab on the first page, add the config below to this path:  /bahmni/default-config/openmrs/apps/documentUpload/extension-Patient Document.json

Code Block
languagejs
linenumberstrue
{
        "bahmniDocUploadPatientsSearchActivePatients":{
       "id": "bahmni.docUpload.patients.search.activePatients",
       "extensionPointId": "org.bahmni.patient.search",
       "type": "config",
       "extensionParams": {
           "searchHandler": "emrapi.sqlSearch.activePatients",
         "translationKey": "MODULE_LABEL_ACTIVE_PATIENTS_KEY",
           "forwardUrl" : "#/patient/{{patientUuid}}/document"
       },
       "label": "Active Patients",
       "order": 1,
       "requiredPrivilege": "app:patient-documents"
   },
   "bahmniDocUploadPatientsSearchAllPatients":{
       "id": "bahmni.docUpload.patients.search.allPatients",
       "extensionPointId": "org.bahmni.patient.search",
       "type": "config",
       "extensionParams": {
         "translationKey":"MODULE_LABEL_ALL_PATIENTS_KEY",
           "forwardUrl" : "#/patient/{{patientUuid}}/document"
       },
       "label": "All patients",
       "order": 2,
       "requiredPrivilege": "app:patient-documents"
   }
}


Note

One can also specify the “search handler” with other global properties for SQL search.



Configuring Patient Document Types

To configure the types against which a Patient Document can be uploaded, you may do the following

  1. Go to concept dictionary (.../openmrs/dictionary/index.htm) and search for 'Patient Document'
  2. You will find the concept 'Patient Document' has members that appear Document Upload module. 
  3. Add a concept (e.g. Hospitalisation Record) of type 'Misc' and datatype 'NA'.
  4. Add the newly created concept as member of 'Patient Document'
  5. Go back to Patient Document module and verify that the dropdown lists the newly added concept when you upload a file. 


Tip
iconfalse
titleOn this Page

Table of Contents
stylenone


Panel
titleColorwhite
titleBGColor#668D3C
titleFeature Details

Patient Documents Module - Feature Guide


Panel
titleColorwhite
titleBGColor#668D3C
titleUsage Details

Patient Documents Module - User Guide