Documentation / How-To

Installation

1. Download the latest version from the latest version from the OpenMRS module repository and add it to your OpenMRS application using the the _Administration->Manage Modules Modules _page.
2. Go to to Administration->manage Smart app page >Manage SMART Apps page and add Smart app manifests to add smart apps to your installation by clicking add SMART app button.
3. Find some example SMART Apps from http://sandbox.smartplatforms.org
   1. There are two options for adding smart apps
      1. To add manifest from the local machine choose file and upload it.
      2. To add manifest from network enter url(url format should be format should be http://<somedomain>/<directory>/../<name of the file>.json) and upload it.
4. Got to  Administration->manage user app page and chose apps from available apps to appear at your patient dashboard.If you want to use SMART apps that use Problems data,go to Administration->Set up Problem Object and choose how to map OpenMRS problems into Smart problems. If you want to represent OpenMRS problems by Obs ,You have to go to Administration->Manage Global Property and enter smartcontainer.problem.addedConcept id and smartcontainer.problem.resolvedConcept id
5. Ensure that all your concept are mapped as follows
   1. Drug related concept are mapped to RxNorm
   2. Problem related concepts are mapped to SNOMED-CT
   3. Lab test related concept are mapped to LOINC
6. Finally go to patient dashboard,click the SMART app tab and launch SMART apps by clicking the iconUser Apps page and choose apps that should be shown on the patient dashboards.

Getting SMART

...

Apps

SMART apps are web apps,they webapps and need to be hosted on server and their a server either locally or externally. Their manifest file should be published in order to use it. Following are some way of doing this.

• Hosting in a serveryour own server
• Using SMART apps that are already hosted in public URL
• Installing smartapp module (This module has yet to be developed)

Hosting in a server

...

Using SMART apps that are already hosted in public URL

This method is a lot easier, but requires that your server have an internet connection available.

This zip file contains manifest files of the SMART sample apps that are hosted by smartplatform.org. Just download it, unzip and upload it.

SmartApps.zip

Hosting your own server

These instructions tell you how to build sample apps that are provided by http://smartplatform.org. It uses python and Django,so only and Django and only works for linux (Ubuntu) these instructions

are suitable.

• Ensure you have installed python 2python 2.7.

...

• • Code Block
    language bash
    sudo apt-get install python

...

• Install Django
  Install Django   

  • Code Block
    language bash
    sudo apt-get install python-django

   
  • get Get the source code ** If the Git is not installed install it

    • Code Block
      language bash
      sudo apt-get install git

  •   then Then get the code for the smart apps

    • Code Block
      language bash
      git clone[https://github.com/chb/smart_sample_apps.git] cd smart_sample_apps git submodule init git submodule update

       
  • copy settings.py.default to settings.py and update:
  • set  APP_HOME in settings in settings.py to to the complete path to the location where you've installed installed smart_sample_apps, e.g.   /web/smart_sample_apps
  • Start the server server

    • Code Block
      language bash
      cd /path/to/smart_sample_apps/ python manage.py runconcurrentserver 0.0.0.0:800

     
  • get the manifest

    ...

    • • go to

    ...

    • • /path/to/smart_sample_apps/static/framework/medilist/smart_manifest.json

    Using SMART apps that are already hosted in public URL

    Following zip file contains manifest files of the SMART sample apps that are hosted by smartplatform.org.Just download it ,unzip and upload it.

    SmartApps.zip

    ...

    Setup

    Problem Object

    If you want to use SMART apps that use Problems data, go to Administration->Set up Problem Object and choose how to map OpenMRS problems into Smart problems.

    • The "Problem Object" is only manipulatable on the patient dashboard (as of openmrs 1.9). Therefore, many implementations may not use this table and data. (active_list_problem)
    • The previous way of handling this was to create Observations under question concepts called Problem Added and Problem Resolved. The answer (obs.value_coded) to these observations are the problems a patient currently has.

    Mappings

    1. Ensure that all your concepts are mapped as follows
       1. Drug related concept are mapped to RxNorm
       2. Problem related concepts are mapped to SNOMED-CT
       3. Lab test related concept are mapped to LOINC

    The MVP concept database has all of the necessary mappings already included.