Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This guide will show you how to install the SORMAS Android application on any compatible Android phone or tablet.

Mobile Device Requirements

Android device (phone/tablet) with the following specifications:

...

You will be shown a list of SORMAS Android application installation (.apk) files as hyperlinks.

...

  • Click on the appropriate version file to download. Wait for the download to complete.

  • Click Open to open the downloaded file.

  • Confirm that you want to install the app.

  • The app will now be installed.

Configure the Application

In this step, we will configure the application to connect to the SORMAS server.

  • Open the installed SORMAS application. Since this is the first time of opening the application, the application settings screen will open automatically.

...

To configure the app:

  • In the Server URL field enter: https://your-sormas-domain-name/sormas-rest. Replace your-sormas-domain-name with the domain name of your SORMAS server.

  • Choose your language

  • Click save on the top of the screen

  • You will now be redirected back to the login screen

Info

Note: Ensure that the Server URL value is correct. The SORMAS app cannot function with an incorrect Server URL.

Initial Login and Setup

  • On the Login screen, enter your username and password.

...

  • Click Sign In.

Info

NOTE (Only if the login is not successful):

If the login was not successful, please check the following:

  • Ensure that you have an active internet connection

  • Confirm that the Server URL entered is correct

See the next section, on how to find the Server URL configuration option.

  • If login is successful, the application will do an initial synchronization with the server.

...

  • Grant all permissions required by the application such as GPS access.

...

  • Configure a PIN code for authentication and offline login

  •  Enter a PIN and confirm the PIN to continue

...

  • You are now logged in and the setup is now complete.

  • Enjoy using the SORMAS android application.

Show full settings option

By default, the settings screen shows only the default options. To perform additional actions such as

  • Updating the Server URL

  • Logging out of the application

you have to the full settings options to show hidden fields and buttons.

To do this:

  • Navigate to SORMAS application menu

  • Click Settings at the bottom of the menu

  • Tap the SORMAS version label/text repeatedly

...

Other options such as a field to update the Server URL and also a log out button will now appear.

...