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/10/23 07:05] – [Cloud Integration with Google Drive (Obsolete?!)] 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. Two different ways here are possible: | + | The tablet can be setup generally in two different ways: |
| - | * Using a Google G Suite email account if you have the service with Google. This is a more advanced corporate setup that enable | + | * Using a Google G Suite email account if you have the service with Google. This is a more advanced corporate setup that enables |
| * Using a dedicated system email account. For example, you could create a Gmail account just for this called myorgname.staffname@gmail.com. This is simpler setup but the tablets are not centrally managed and secured. Each user would need normal " | * Using a dedicated system email account. For example, you could create a Gmail account just for this called myorgname.staffname@gmail.com. This is simpler setup but the tablets are not centrally managed and secured. Each user would need normal " | ||
| Line 14: | Line 14: | ||
| <note warning> | <note warning> | ||
| + | |||
| + | ==== Setting a Tablet Name ==== | ||
| + | |||
| + | 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 with the name of the inspector that will be using it. For example, if it is used by Mr. Team Leader with an email address like team.leader [at] gmail [dot] com. | ||
| + | |||
| + | {{ : | ||
| ==== Google G Suite Email Account Setup ==== | ==== Google G Suite Email Account Setup ==== | ||
| Line 29: | Line 35: | ||
| Then you create your staff user on the tablet just as you would create a normal user. But if correctly using your Google G Suite user accounts you should see the following at some point in the initial setup. This means you on a the right track. Simply follow the steps to complete the work tablet for this staff. | Then you create your staff user on the tablet just as you would create a normal user. But if correctly using your Google G Suite user accounts you should see the following at some point in the initial setup. This means you on a the right track. Simply follow the steps to complete the work tablet for this staff. | ||
| - | {{ : | + | {{ : |
| Then request a Pacific EMIS member to share the Education Survey App into your staff' | Then request a Pacific EMIS member to share the Education Survey App into your staff' | ||
| Line 43: | Line 49: | ||
| 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. | 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 | + | 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 ===== | ||
| + | |||
| + | From the home page click on '' | ||
| + | |||
| + | {{ : | ||
| + | |||
| + | |||
| Line 91: | Line 105: | ||
| - Centralized configuration online using Firebase. | - Centralized configuration online using Firebase. | ||
| - | ==== Local Setting, going into Production | + | ==== Local Settings |
| - | Local setting | + | Local settings |
| - | <note warning> | + | {{ : |
| - | You do it like this. | + | You will be prompt for the master password then '' |
| - | {{ : | + | {{ : |
| + | 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/ | ||
| - | {{ : | + | {{ : |
| - | When the tablet is in Development mode all the created surveys will be available in the EMIS on the software developers workstations for 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. |
| - | ==== Android Centralized Configuration ==== | + | |
| - | All other configuration | + | <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**: a legacy settings to load schools into the tablet (superseded by the Update schools from EMIS API below) | ||
| + | * **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: | ||
| 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.</ | <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 124: | 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. | ||
| - | {{ :: | + | {{ :: |
education_survey_tool_android_app_systems_administrator_manual.1603436711.txt.gz · Last modified: 2021/02/02 02:10 (external edit)