Documentation / How-To
Installation
- Download the latest version from the OpenMRS module repository and add it to your OpenMRS application using the _Administration->Manage Modules _page.
- Go to Administration->manage Smart app page and add Smart app manifests to add smart apps to your installation by clicking add SMART app button.
- There are two options for adding smart apps
- To add manifest from the local machine choose file and upload it.
- To add manifest from network enter url(url format should be http://<somedomain>/<directory>/../<name of the file>.json) and upload it.
- There are two options for adding smart apps
- 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
- Ensure that all your concept are mapped as follows
- 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 need to be hosted on server and their manifest file should be published in order to use it.Following are some way of doing this.
- Hosting in a server
- Using SMART apps that are already hosted in public URL
- Installing smartapp module(This module has to be developed)
Hosting in a server
Here i am going to provide instructions on how to build sample apps that are provided by smartplatform.org.It uses python and Django,so only for linux(Ubuntu) these instructions
are suitable.
- Ensure you have installed python 2.7.
Open terminal and type
sudo apt-get install python
- Install Django
sudo apt-get install python-django
- get the source code** If the Git is not installed install it
sudo apt-get install git
- then get the code
git clone[https://github.com/chb/smart_sample_apps.git] cd smart_sample_apps git submodule init git submodule update
- then get the code
- copy settings.py.default to settings.py and update:
- set
APP_HOME in settings.py
to the complete path to the location where you've installedsmart_sample_apps
, e.g./web/smart_sample_apps
- Start the server
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.