Magpi Android App User Guide


 


This guide will show you how to use the Magpi Android App to deploy and fill out

electronic forms created with the Magpi online form designer


Installing Magpi for Android

Glossary of Useful Terms

Logging in to Android Magpi

The Magpi Home Screen

Downloading Forms from the Web

The Form Menu

Collecting Data with Magpi

Answering a Question

Swiping Left and Right

Required Questions

Reaching the End of a Form

The Up Button

Exiting a Form Before Finishing

Subforms

Submitting Records to the Magpi.com Server

Reviewing Records Saved In the Mobile Device

Editing Saved Records

Deleting Saved Records

Settings

Logging Out from Magpi

Uninstalling Magpi from the Android Mobile Device

Supported Devices

Additional Languages

Hierarchy of the Magpi App

Support




Installing Magpi for Android

There are two ways to install Magpi onto your Android device:

  1. install from the Google Play store

  2. install from an apk file (an Android installation file)

We very strongly recommend method #1, because this is the only way that you will receive automatic updates and bug fixes.

If you download and install an apk manually, you won’t know about new versions and may run into problems in your version that have already been fixed in the latest version (Magpi is always being improved, with new features added and bugs being fixed).

Here is the link for Magpi on the Google Play store:

https://play.google.com/store/apps/details?id=org.magpi.android&hl=en

And here is the link for the latest apk:

http://bitly.com/magpi-android-latest

With the apk file you can download it directly in your mobile device browser, or else download to your desktop or laptop and later transfer the file to your mobile device via bluetooth or on a memory card.

Whether you install via Google Play (recommended) or via the apk file directly, after installation you should see the Magpi app icon on your applications screen.


Glossary of Useful Terms

form - a “form” is a list of questions produced at the Magpi.com web application. Sometimes this is also called a questionnaire, or a survey.

record - a “record” is the complete set of data from one completed form. That is, a data record consists of all the answers to the questions in the form. When uploaded and viewed online at Magpi.com, a data record will comprise one row in the data file.

upload - an “upload” is the transmission of one data record to the Magpi.com web servers.



Logging in to Android Magpi


  

Tapping on the Magpi app icon will launch the application and bring you to the login screen (at right).

On the Magpi login screen you will need to enter your Magpi credentials, which are created when you register for Magpi at www.magpi.com.

If you have not yet registered with Magpi, you will need to first go to www.magpi.com and click the button marked “Sign Up for Free”. The registration process takes less than one minute.

After registering, you can log into the Magpi app using the same email address and password you used for registration.




Important: if you will be collecting data offline, make sure to choose the “Keep me logged in” option.



 

The Magpi Home Screen


On the Magpi home screen (also called the “Form List”) you can see:

  • a list of “All Forms”: all the forms to which you have access: forms you have created and forms that others have shared with you

  • a button to view your “Favorite Forms”: forms that you have designated as favorites.

  • a button to view the app settings

  • a reminder to “pull to refresh”: if you put your finger down near the top of the form list and slide it downward and release, this signals the app to contact the Magpi server and see if there are any new or modified forms (obviously, this can only work if you have an internet connection).



Paid Magpi subscribers do not need to “pull to refresh”, as any new forms or changes to forms are automatically synchronized to their devices.

    

Downloading Forms from the Web

In older versions of Magpi, users had to manually download each form they wanted to use on a mobile device.

In the current version of Magpi, this is no longer necessary: when you log into the app it automatically downloads all forms available to the logged-in user.



The Form Menu


If you tap on any form in your form list, you will see the options available for that form. Options can include:

  • Add Record: begin entering data in a new, blank form

  • Review Data: look at previously entered data records

  • Upload Data: send previously entered data records to your account at Magpi.com

  • Export Data: send previously entered data records to a file on the device’s memory card

  • Favorite: make the selected form one of your favorites

In the image at right you can see the options available after tapping on form “1testnewlogicform”.




Not all options are available for every form. For example, if you have not yet collected any data with a form, the option to “Review Data”, or “Upload Data” or “Export Data”, will not be available (because there is no data to review or upload or export).



Collecting Data with Magpi


To begin filling in a Magpi form, just

  1. tap the form name in the form list

  2. select Add Record in the menu that pops up.

This will bring you to the Question List, a screen showing you all the questions in the form (at right).

To begin entering data, just tap on the question you want to answer..









Answering a Question

Tapping on question #2 in the question list shown above will open that question (“Male or female”) on the screen, as shown at right.

The user can tap the desired answer and then swipe to move to the next question.

Other types of questions will include a popup keyboard, to enter text or numbers, or a date picker.



Swiping Left and Right

Users familiar with touchscreen phones will understand the idea of “swiping” to move to the next or previous screen.

For example, to move to the next screen, the user would “swipe left” by placing a fingertip on the right side of the screen and moving it from the right to the left.

To move back (to the previous question), the user would “swipe right” by placing a fingertip on the left side of the screen and moving it from the left to the right.


Required Questions

Sometimes you can try to go to the next question without answering the question on the screen, and a message pops up saying “Sorry, this answer is required”. This is because the designer of the form can designate some or all questions as “required”: you will not be able to move forward to the next question without answering the current question.


Reaching the End of a Form

When you are entering data into a form, and you swipe past the last question of that form, you will see the End-Form Menu, with five options (at right):

  • Add new record: this brings you to a new, blank copy of the same form

  • Upload data: this immediately tries to upload the just-entered data to the Magpi web servers

  • Review answers: this brings you to the question list, so that you can see all the answers you entered

  • Go back to Last Question

  • Go to Form List

 

The Up Button

In the upper-left corner of the screen you will see a Magpi logo with a caret next to it (a < character). On Android devices, this is called the “up button”. Tapping the up button will move you backwards through the app hierarchy (see “Hierarchy of the Magpi App”, below).

If you are viewing a single question, tapping the up button brings you back to the question list.

If you are viewing the question list, tapping the up button brings you back to the form list.


Exiting a Form Before Finishing

Sometimes you may want to exit a form before you have finished entering all the data (for example, by tapping the up button). In that case, you will see this dialog:


The dialog allows you to choose one of three options:

  • Save: this saves the partial record (so you can upload, review, or edit it later) and exits the form

  • Cancel: this puts you back into the form

  • Discard: this deletes the partial record and exits the form



Subforms

Magpi’s Android app now has the ability to display subforms for data collection. Subforms (sometimes called “rosters” or “child forms”) allow the user to embed one form within another.

A common example of when subforms can be used is when doing a household survey. It is common to ask a set of questions pertaining to the entire household (e.g. water source), and then to display (on paper) a table in which to list each member of the household (or each child, or each pregnant woman, etc).

Another user might be to collect information first about a facility (e.g. a pharmacy) and then use a subform to collect information about the stock levels for each stocked item.

On paper a household form might look like this:


Such a form (really a combination of a household form and a child subform) on a mobile device would first display the initial household questions (interviewer name, household head, “did any children sleep in this household”) and would then allow the data collector to enter data for each child.

The data collector could repeat the child questions as many times as needed.

The image at right shows the view on a phone when the user has reached the beginning of a subform section.

In the example at right, the subform is for residents of the household. You can see that the user has already answered the resident questions (e.g. name, age, gender, vaccination status) for 1 resident.

The buttons on the screen perform the following functions:

  • Add resident record - this goes to the first question of a new subform record (“name”)

  • Review resident data - this allows the user to review and edit previously-saved subform records

  • Previous - this jumps to the main form question immediately preceeding the subform

  • Next - this jumps to the main form question immediately after the subform. This would be used, for example, when the data collector had entered information for all the household residents and wished to proceed with the rest of the main household form.


Note that the word “resident” in the example above is specified by the form designer when creating the subform question. This can be seen below in a screenshot from the Magpi.com form designer showing the same question as displayed above:

 

By using the appropriate word, the form designer can create a natural-sounding subform screen.



Submitting Records to the Magpi.com Server 

There are three ways that you can upload records to the server:

  1. By selecting “Upload data automatically” in the Settings screen (See Magpi Settings, below) - this will make Magpi try periodically to upload any unsent data in the background.

  2. By selecting “Upload data” after finishing a record (see Reaching the End of a Form, above).

  3. By tapping a form in the form list, then selecting Upload Data from the form menu (see The Form Menu, above).



Reviewing Records Saved In the Mobile Device

 

Once a record has been entered and saved to the device, it can be opened again later for viewing and editing. This might be necessary if you want to make a correction to a previously saved record.

To view the saved records, go to the Form List and tap on the form for which you would like to review data. Then, when the form menu pops up, choose Review Data. That will bring up a list of all the records for that form (at right).

Each entry in the record review list shows the date and time that the record was first saved, along with the answers to the first few questions.

Editing Saved Records

Tapping on any of the records will allow you to review or edit each question (just as if you were filling out the form for the first time).

Deleting Saved Records

Tapping and holding on any of the records (this is called a “long press”) will allow you to delete that record.






Settings

By tapping the Settings button from the Form List, you can access various settings for Magpi, including:

  • turning on automatic data upload

  • logging out of the app

  • changing the sort order of the form list

  • hiding or showing skip patterns

  • changing the app language

You can also view the version number for the app, which can be useful information for our support team if you run into a problem.


Logging Out from Magpi 

You can log out from the Settings screen.



Uninstalling Magpi from the Android Mobile Device 

To uninstall Magpi Mobile from your Android device, go to the Android Settings > Application > Manage Applications and select Magpi. Press or click the uninstall button, this will uninstall Magpi Mobile from the mobile device and also delete any saved forms.



Supported Devices 

Magpi will run on any Android device running Android 2.2 or higher.

We recommend installing Magpi from the Google Play store: https://play.google.com/store/apps/details?id=org.magpi.android&hl=en



Additional Languages

Magpi Mobile is available in English, Spanish, French and Swahili. Additional language versions of our Android app can be produced on request (extra charges may apply).


Hierarchy of the Magpi App

 




Support

Free support is available to all Magpi users at support.magpi.com

At that site, users can:

  1. read support articles

  2. create support tickets (requests for assistance)

  3. review the status of their tickets

Users can also create a support ticket by emailing support@magpi.com or by clicking the black Magpi Support tab located on the right at www.magpi.com after logging in.





[Please note that Magpi was previously referred to as EpiSurveyor. There may be cases that still refer to "EpiSurveyor".  If you see one, please let us know so we can update it. Thanks!]

 

Click this http://bitly.com/magpi-android-guide to download this complete user guide doc.