====== medAL-reader User Guide ======

{{ :medal-reader:timci_medal-reader_user_guide_printdoublesided_17may2022.pdf | TIMCI medAL-reader 1.1.0 user guide (EN)}}

{{ :medal-reader:3_guide_de_l_utilisateur_de_timci_medal-reader_1.1.0.pdf | TIMCI medAL-reader 1.1.0 guide de l'utilisateur (FR)}}

===== Purpose and Scope =====

This page gathers information on how to use the medAL-reader application on Android devices.




===== Prerequisite =====

Make sure to own an Android device with the //medAL-reader// app. Follow the steps given [[tablet-setup|here]] to setup your Android tablet.




===== Material =====

You will need the following material:

  * An Android device with medAL-reader app




===== Run medAL-reader application =====

These steps show how to open the medAL-reader app:

  - Make sure your tablet is charged and unlock it.
  - Navigate to the apps screen (swipe the screen from bottom to top while on Android home screen).
  - From there, the apps should be ordered in alphabetical order. Navigate until you find ''medAL-reader''.
  - Click on the application.




===== Login =====

These steps show hot to login to the application:

  - Open medAL-//reader//. You should arrive to the ''Connect to medAL-//data//'' page.
  - Connect to medAL-//reader//.
  - On medAL-//reader//, in the ''Server address'' field, enter your medAL-data address. The ''Device ID'' represents your device's //auth ID// found in medAL-data.
  - Click on ''Login''. 
  - A new window will open showing medAL-data. Login with your credentials.
  - Click on ''Authorize''.




===== Create a New Patient and Start the Consultation =====

Follow these steps to create a new patient and start its consulation:

  - From medAL-reader’s home screen, click on ''scan QR-code'' or ''New patient'' and fill in all the mandatory registration information (marked by an *).
  - Click on ''next'' on the bottom right of the screen. This will take you to the beginning of the consultation. 
  - You may continue and follow steps as requested by the application (and always fill the questions marked by an *).




===== Create a Consultation for an Existing Patient =====

Follow these steps to create a new consultation for an already existing patient:

  - From the home screen, you must click on the ''Patient list'' button.
  - You may search / filter to find your patient.
  - Click on it, then press ''Add Consultation''. This will take you to the beginning of the consultation. 




===== Push Medical Data to medAL-data Server =====

If you get an alert indicating that the medical data has not been synchronized, follow these steps to push medical cases to the medAL-data server:

  - go to the medAL-reader’s side menu
  - Hit the ''Synchronize'' button.
  - Follow the instructions.