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



Defining Keys

 

Every form must have a key field as determined by the key="" attribute within the form tag.

The key field records input from a user which must be unique in every entry (ie instance of a form). For example, the following shows a one question form with the key field indicated.

 

<form num="1" name="School" key="SchoolID">
   
   <input ref="SchoolID"> 

    <label>School ID</label> 

	</input>

</form>

If a user enters a value which has already been recorded they will receive a warning

Autogenerated keys

You can specify that a key field is autogenerated using the genkey="" attribute. and link this to an input, as in the following example:

<form num="1" name="School" key="SchoolID">
   
   <input ref="SchoolID" genkey="true"> 

    <label>School ID</label> 

	</input>

</form>

In this case, a value will be automatically generated for each entry, consisting of the handsets IMEI number, concatenated to the current time in milliseconds, ensuring uniqueness.

For autogenerated keys, it is advisable to also use the hidden="true" attribute otherwise the user will see this string.

Keys becoe increasingly important when linking forms together as the key field from one form is included in the linked form.

Next | Form Logic