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  to Administration->manage user app page and chose apps from available apps to appear at your patient dashboard>Manage User Apps page and choose apps that should be shown on the patient dashboards.

1. 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.
   1. 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
2. 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
3. Finally go to patient dashboard,click the SMART app tab and launch SMART apps by clicking the icon.

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)

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.

Hosting in a server

Here i am going to provide instructions on 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 instructionsare suitable.

• Ensure you have installed python 2python 2.7.

            Open terminal and type        

  • • 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

    ...