education_survey_tool_android_app_systems_administrator_manual
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
education_survey_tool_android_app_systems_administrator_manual [2020/07/09 05:16] – [Installing the app for a new inspector] ghachey | education_survey_tool_android_app_systems_administrator_manual [2023/11/17 16:57] (current) – old revision restored (2023/11/17 10:17) ghachey | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Education Survey Tool Android App Systems Administrator Guide ====== | + | ====== |
===== Setting up the Tablet ===== | ===== Setting up the Tablet ===== | ||
- | The tablet can be setup any number of ways to support this app. However, the recommended setup is to have an Owner account first created by the organization' | + | The tablet can be setup generally in two different ways: |
- | * Using a Google G Suite email account. This is a more advanced corporate setup that enable | + | * Using a Google G Suite email account |
- | * Using a dedicated system email account. For example, you could create a Gmail account just for this called | + | * Using a dedicated system email account. For example, you could create a Gmail account just for this called |
- | Then for any school inspector that will be conducting surveys with the app you create a new user with their work email (e.g. staff1@googledomainname.com). | + | Then for any school inspector that will be conducting surveys with the app you create a new user with their work or personal |
To start with a clean state you should do a Factory Reset of the Android tablet before you create your owner user with admin email. | To start with a clean state you should do a Factory Reset of the Android tablet before you create your owner user with admin email. | ||
Line 15: | Line 15: | ||
<note warning> | <note warning> | ||
- | Once your tablet is setup in a clean state with your dedicated system admin user by your systems administrator you are ready. From this account the organization' | + | ==== Setting |
- | <note tip> | + | While not required this can become useful by more clearly identifying the tablet. Especially useful when using the advanced merging offline feature of the app. It is recommended to configure the name of the tablet |
- | ===== Installing the app for a new inspector ===== | + | {{ : |
- | Let's say you have a new inspector called John Doe that will be tasked with conducting surveys. Get the tablet that the new staff will be using and add his/her user account with their email. Adding a new account in Android can be done like below (or slightly differently if you have a different version of Android). | + | ==== Google G Suite Email Account Setup ==== |
- | Drag down the top menu and click on the little user icon. | + | If you are using Google G Suite the first thing to do is allow installation from unknown apps has a policy. You do this like follows. |
- | {{ : | + | {{ : |
- | Click '' | + | {{ : |
- | {{ : | + | {{ : |
- | and follow the steps as you would install a normal user using the work email of the new staff. | + | {{ : |
- | Then you must install | + | Then you create your staff user on the tablet just as you would create a normal |
- | {{ : | + | {{ : |
- | You need to locate | + | Then request a Pacific EMIS member |
- | {{ : | + | ==== Google Normal Email Account ==== |
+ | |||
+ | If you are using a standard Google account the setup will be as usual with an Android device. Simply create a user for your new staff and install that app. | ||
+ | |||
+ | <note tip> | ||
+ | |||
+ | ===== Installing the app for a new inspector ===== | ||
+ | |||
+ | Let's say you have a new inspector called John Doe that will be tasked with conducting surveys. You have already created the user on the tablet as per the previous section. The app will be shared with the new user by a member of the Pacific EMIS team. You can access it in your Google Drive as shown below. | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | You need to locate the most recent release or the one you are told to install. Typically, it will be the one as shown below and not in the release archive folders. | ||
+ | |||
+ | {{ : | ||
Click on the apk file to install it. | Click on the apk file to install it. | ||
- | {{ : | + | {{ : |
You will be prompt to accept installation from unknown sources. | You will be prompt to accept installation from unknown sources. | ||
- | {{ : | + | {{ : |
You enable install from unknown source setting. | You enable install from unknown source setting. | ||
- | {{ : | + | {{ : |
Then you can proceed with the app installation as shown in following three photos. | Then you can proceed with the app installation as shown in following three photos. | ||
- | {{ : | + | {{ : |
- | {{ : | + | {{ : |
- | {{ : | + | {{ : |
Start the Pacific EMIS Education Survey Tool app and give it all permissions requested. | Start the Pacific EMIS Education Survey Tool app and give it all permissions requested. | ||
- | {{ : | + | {{ : |
Select the context (name of your EMIS) and proceed. | Select the context (name of your EMIS) and proceed. | ||
- | {{ : | + | {{ : |
Click on the link to login with Google account. This will link the new staff email with all the work done in the app and provide an audit trail of all data collected. | Click on the link to login with Google account. This will link the new staff email with all the work done in the app and provide an audit trail of all data collected. | ||
- | {{ : | + | {{ : |
The installation and basic setup is complete | The installation and basic setup is complete | ||
+ | ===== Verifying Software Version and License ===== | ||
- | ===== Android Centralized Configuration ===== | + | From the home page click on '' |
- | The configuration for the Education Survey Tool Android App can be done in a centralized way using Firebase. Anyone that was given the permission can access it at [[https:// | + | {{ : |
+ | |||
+ | |||
+ | |||
+ | |||
+ | ===== Configuration ===== | ||
+ | |||
+ | There are two ways to configure the app: | ||
+ | |||
+ | - Locally by clicking on the settings in the home page. You will need the Master password. | ||
+ | - Centralized | ||
+ | |||
+ | ==== Local Settings ==== | ||
+ | |||
+ | Local settings configure a single tablet and app, the one you are in. You go into settings from the home page by clicking on '' | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | You will be prompt | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | There are many settings most of which will have been set automatically through the remote centralized settings. However, you typically use the local settings to change a tablet' | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | With this setting you can flip from Development (testing/ | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | This means all the surveys created on the tablet after you put it into Production will be made available into the Production EMIS of your country. When the tablet is in Development mode all the created surveys will be available in the Pacific EMIS on the software developers workstations for testing (which you may be given access also if needed. | ||
+ | |||
+ | <note warning> | ||
+ | |||
+ | Other important features you can find in the settings are the Update data shown below. You only need to do this on the tablet at the installation once. It downloads from the Pacific EMIS database the list of schools, teachers and subjects for use in dropdowns fields in surveys to improve data quality. You can also click on those if you know you data has changed (e.g. new teachers). | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | Other settings are described below. They are typically set centrally and remotely but it can be overridden locally on individual tablets: | ||
+ | |||
+ | * **Logotype**: | ||
+ | * **Change master password**: password used for operations not normally done by normal users. | ||
+ | * **Name**: title on the home page | ||
+ | * **Contact**: | ||
+ | * **Operating mode**: important and most commonly configured locally on tablets (see above) | ||
+ | * **Import schools from CSV**: | ||
+ | * **Update schools from EMIS API**: loads all the schools into the tablet with a programmatic call to the EMIS backend | ||
+ | * **Update teachers from EMIS API**: loads all the teachers into the tablet with a programmatic call to the EMIS backend | ||
+ | * **Update subjects from EMIS API**: loads all the subjects into the tablet with a programmatic call to the EMIS backend | ||
+ | * **Templates of surveys**: view the structure of the currently loaded surveys | ||
+ | * **Load Production Certificate**: | ||
+ | * **Tablet ID**: a unique identifier of the tablet the app is running on. A read only setting. | ||
+ | * **DEBUG: show storage**: view the cloud account files useful mostly for administrators and developers. | ||
+ | |||
+ | |||
+ | ==== Centralized Configuration ==== | ||
+ | |||
+ | Most settings are better configured centrally has it will be much easier: all your tablets will sync and get the latest configuration. For example, if you want to change the contact person you change it centrally and it gets synced to all tablets. This is done using Firebase, a Google service. Anyone that was given the permission can access it at [[https:// | ||
For a very brief overview of how to manage the configuration in Firebase refer to [[firebase_configuration|Firebase Configuration]] | For a very brief overview of how to manage the configuration in Firebase refer to [[firebase_configuration|Firebase Configuration]] | ||
+ | |||
+ | <note tip>You rarely need to change those.</ | ||
+ | |||
+ | Details of the configuration can be found at [[Pacific EMIS Education Survey Tool Android App Configuration]] | ||
+ | |||
===== Troubleshooting ===== | ===== Troubleshooting ===== | ||
+ | |||
+ | ==== Verifying Version Installed ==== | ||
+ | |||
+ | When seeing errors it is important to know how to get the version of the app that is installed. This is how you do it. | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | {{ : | ||
+ | |||
==== Re-installing app may trigger error ==== | ==== Re-installing app may trigger error ==== | ||
Line 90: | Line 176: | ||
First go into the Google Playstore and click on the menu as shown below. | First go into the Google Playstore and click on the menu as shown below. | ||
- | {{ :: | + | {{ :: |
Then click on play protect as shown below. | Then click on play protect as shown below. | ||
- | {{ :: | + | {{ :: |
Then click on the settings button top right as shown below. | Then click on the settings button top right as shown below. | ||
- | {{ :: | + | {{ :: |
Then turn off the scan as shown below. | Then turn off the scan as shown below. | ||
- | {{ :: | + | {{ :: |
- | + | ||
- | + | ||
- | ===== Cloud Integration with Google Drive (Obsolete? | + | |
- | <note warning> | ||
- | Currently the documentation for this is minimal and can be found at | ||
- | * https:// |
education_survey_tool_android_app_systems_administrator_manual.1594271815.txt.gz · Last modified: 2021/02/02 02:10 (external edit)