Instructions

android

Introduction

Creating a project

Form Builder

Adding a Form
          Key Field
          Title

Text Fields
          Plain

          Numeric
          Date
          Time
          Drop-Down
          Radio 
            Check Boxes
          
Media Fields
           Location

           Photo
           Video
           Audio
           barcode

Validation
           Text
           RegEx   
           Double Entry

Form Logic
           Jumps


Linking Forms
           Hierarchy

           Branching

android


Installing EpiCollect+
Loading a Project


Collecting Data

Text Fields
          Plain

          Numeric
          Date
          Time
          Drop-Down
          Radio
             Check Boxes

Media Fields
           Location

           Photo
           Video
           Audio
           barcode

Saving Data

List/Sync data

Maps

Backing up data

Remote Data

Settings

android


Project Website

Map View

Multiple Forms

Downloading Data

android


Introduction

EpiCollect Markup

The Document
           <model>

The Form
           <form>


Text Fields
           <input>

          <select>
           <select1>
          <radio>
Setting defaults

Media Fields
           <location>
           <photo>
           <video>
           <audio>
           <barcode>

Defining keys

Form Logic
           Jumps


Linking Forms
           Hierarchy

           Branching
  
Validating



Adding a Numeric Question

 

In a similar fashion to adding a plain text field, you can drag and drop any number of Numeric fields to your form.

To add a numeric field, simply drag and drop the 'Numeric' field from the left hand side of the form builder (pink) to the middle 'Form' section (green) and release your mouse button.

You will immediately see that the 'Field Properties' section (blue) of the form builder now contains a number of options for you to define as in the following screenshot:

 

Numeric Field

The most important properties to define are the 'Label' and 'ID'

 

Label - The Label should contain the Question you would like a user to answer - For our demo project, we first enter the text 'How many pupils attend the school?'

ID - The ID can be viewed as the column heading under which users answers will be stored in the database. For our ID we have entered 'PupilNumber' The ID should contain no spaces and be a convenient short hand name for the variable you wish to collect.

Required: Checking this means that a user MUST enter data into this field before continuing.

Title: You can set a numeric field as the title within a form (see previous section on title).

Any number of numeric questions can be added in this way and the user, when trying to enter data, will be presented with the numerc keyboard on their device by default.

 

Advanced Field Properties

Numeric Advanced

Decimal : Requires that the user input is decimal.

Integer: Requires that the user input is a whole number (set as true by default).

Minimum Value: Allows you to define a number which the user must enter a value above.

Maximum Value: Allows you to define a number which the user must enter a value below.

Default: Allows you to specify a default value which is entered into the database if a user does not input a value.

Double Entry - This will require that a user enters their answer twice - the two values will be compared and if not identical, the user will be warned (similar in principle to when you are asked to re-enter an email address on a web form).

 

 

When the project is loaded onto a handset, the user is presented with a simple text box within which to enter their data as follows. Note that the numeric keyboard is presented by default and the uesr will not be allowed to enter plain text:

integer

If, for example, you have specified a minimum value (in the following example minimum value = 10), and the user attempts to enter a number below this value, he/she will be warned as follows:

min1

 

 

 

 

arrow

 

 

 

 

 

min2

 

We will now move on to add a Date field to the form

 

Next | Adding a date question