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 Drop-Down Question (or a set of radio buttons)

 

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

A drop-down allows you to pre-define a number of options, of which a user may select only one.

To add a drop-down, simply drag and drop the 'Drop-down List' field from the left hand side of the form builder (pink) to the '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:

 

Drop-down 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 'What kind of 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 'SchoolKind' 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 drop-down field as the title within a form (see previous section on title)

 

Adding Options to your Drop-down list.

To add an option, open the, 'options' section and click the 'Add option' button from within the 'Field properties' section.

You can add any number of options, however each one MUST contain a 'Label' and a 'Value'

Option Label - This will be the text presented to a user as an option in the drop down list
Option Value - This will be what is stored in the database if the user chooses this option.

We have specified these separately so that you can codify data entering the database however you wish.

 

Advanced Field Properties

Drop-down Advanced

Default: Allows you to specify a default value which is entered into the database if a user does not input a value. For dropdowns you must anter a number that refers to the number of the option you have defined.

So if (as above) we defined three options - Boys, Girls and Mixed and we wanted the default value to be 'Girls' we would enter the number 2 in the default box.

Jumps: We will cover this in the Instructions sections on 'Jumps'

When the project is loaded onto a handset, the user is presented with a simple drop-down list containing the options you have entered. Clicking one chooses this option and allows the user to progress within the form as follows:

drop1

 

 

 

 

arrow

 

 

 

 

 

drop2

Again, if this field is required, the user will not be able to progress in a form without entering a value.

Radio Buttons

Radio Buttons are conceptually identical to drop-down lists, in that you specify a number of options for which a user may only select one. The only difference is that all choices are presented to a user, on screen, at the same time. The choice of which one to use is really based on personal preference. For this reason, the instructions above can be equally applied to both drop-downs and radio buttons.

 

Next | Adding a Check-box question