This is an old revision of the document!
Table of Contents
medAL-data User Guide
This page gathers all the informations needed to use the medAL-data web application as a user.
Register user
To register as a new user, follow these steps:
- Go to the url
<medal-data-url>/register
. - Enter your Full name, email, password, and confirm your password.
- Click on
Register
. - Setup Google Authentication. You can find the procedure here.
- Click on
Complete Registration
, you should now be logged in. - Finally, contact an administrator to assign your account to a given role.
Reset your own password
To reset your own password, make sure to be logged in to medAL-data and follow these steps:
- On the home page, click on
Change password
. - Enter our current password in the
Enter Current Password
field. - Enter your new desired password in the
Enter New Password
field. - Click on
Change password
.
Setup Google Authenticator
Install a compatible application
To setup two-factor authentication on your device, install a Google Authenticator compatible app. Some currently available apps are:
- Authy for iOS, Android, Chrome, OS X
- FreeOTP for iOS, Android and Pebble
- Google Authenticator for iOS
- Google Authenticator for Android
- Google Authenticator (port) on Windows Store
- Microsoft Authenticator for Windows Phone
- LastPass Authenticator for iOS, Android, OS X, Windows
- 1Password for iOS, Android, OS X, Windows
Add a New Session Using a Setup Key
To add a new session using a setup key, follow these steps (described using the application Google Authenticator for Android).
- Click on
+
. - Click on
Enter a setup key
. - Enter your account name and the key that was sent by email.
- Click on
Add
.
Add a New Session Using a QR Code
To add a new session using a setup key, follow these steps (described using the application Google Authenticator for Android).
- Click on
+
. - Click on
Scan a QR code
. - Scan the QR code.
Health Facility Setup
Health Facility Creation
To setup a health facility
- Open your browser and navigate to your medAL-data server URL.
- Login with a user having accesses to health facilities.
- Go to the
Health Facilities
section. - Click on
Create New Health Facility
:- Enter basic informations such as
Name
,Country
,Area
, enter your area,Longitude
andLatitude
. - Under
Architecture
, you can choose between the following values:Standalone
: The tablets will work by themselves and send data directly to medAL-data.Client Server
: The medAL-hub IP will need to be filled in so the tablets will connect to it to retrieve and send data.
- Under
medAL-hub IP
, enter your medAL-hub IP to allow the tablets to connect to it. - Under
Pin Code
, you can set the PIN code that the tablets will ask for when opening medAL-reader.
- Click on
Create New Health Facility
. - Your new health facility should appear in the list.
Algorithm Setup
You will now need to setup an algorithm for your health facility. Follow these steps:
- Look for your health facility in the healt facility's list.
- Click on
Algorithms
. - Under
Choose Algorithm
, choose the desired algorithm. - Under
Choose a version
, choose the desired version. - Click on
Assign
. This may take some time to process. - Once done, you can close the window.
Edit Health Facility
- Look for your health facility in the healt facility's list.
- Click on
Edit
. - You can edit some fields. Once done, click on
Submit
.