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



Validating data

 

Where possible, the inclusion of simple validation rules within form fields can help minimise issues with data gathered from users. Within EpiCollect+ we provide a number of methods for validating data which will be described below. These have been touched upon within the instructions for each form field but will be described in more detail below.

 

Required

If a field is set as Required, a user MUST enter a value (or add media) before proceeding in a form.

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).

Regular Expressions

Regular expressions are a very powerful way of pattern matching text and assuring that text entered into a field adheres to the pattern specify. Regular expressions are a common method used within programming to undertake such pattern matching and we provide the ability for this powerful method to be used within EpiCollect+

In essence regular expressions are a syntax that describe a pattern in shorthand. At first, regular expressions seem complex but they provide a very powerful way of pattern matching and can be used for many kinds of validation (email, phone numbers, post / ZIP codes / numerical ranges etc.) 

For a comprehensive introduction to the syntax we recommend visiting the website:

Regular-Expressions.info

And for a very good reference text we recommend:

O'Reilly - Regular Expressions Cookbook

When you have formulated your regular expression, simply enter it inot the in the Form Builder and when a user enters data into the field, their input will be checked , using your expression, and if incorrect they will be warned.

Minimum value - Only relevant for numeric inputs

Allow you to specify a minimum numerical value that a user must enter above.

Maximum value - Only relevant for numeric inputs

Allow you to specify a maximum numerical value that a user must enter above.

Note, you can set a range by defining both minimum and maximum values within numeric inputs.

 

The following table gives a summary of validation support within input fields.

  Text Media
  Plain Numeric Date Time Drop-down Radio Check-box Location Photo Video Audio Barcode
Required
Double Entry        
Regular Expression                  
Minimum value                      
Maximum value                      

Should you have any requests for further methods, please do not hesitate to contact us

We will now describe methods available for describing jump logic within forms - This allows you to define logic that, based on the answer a user enters for a particular question, will 'jump' them forward in a form.

Next | Jump Questions