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 Form - Initial steps.

 

When clicking 'Edit Form' for the first time, you will be prompted to give your form a name, as in the screenshot below.

For our demo project we enter the for name 'School' and click 'OK'

When naming forms, please use alphanumeric characters only with NO SPACES.

 

form1

 

Adding a Key Field

For any form you create, you must define ONE field as being a Key field. Briefly, the key field acts as a unique identifier for each entry (ie a form filled in by a user) and therefore every time a user fills in a form, the value must be UNIQUE.

You can specify a particular question, or we provide the facility to include an autogenerated key field (which will consist of a unique string based on the MAC address of their handset and the current time in milliseconds, to ensure uniqueness).

After entering your form name, you will be see a prompt asking you whether you have a unique key question, as in the following screenshot.

No, I do not have a unique key question for this form, please generate one for me

Yes, I have a unique key question for this form.

primarykey

Selecting No will automoatically generate a key question (with a unique key value for every entry.

However, we want to use the schools name as the unique ID as every school has a unique name! Therefore we click 'Yes' and click OK which allows us to fill in the key question details as in the following screenshot:

primary key text

 

The Label for the key field is the question a user will see on the phone - we add 'What is the schools name?'

The ID can be thought of as the column heading in a database where the schoolnames will be stored. We name this 'SchoolName' and click OK

You will now enter the Form Builder proper and start building up your form. Within our demo the following screenshot is seen:

 

key done warning

You will see that the Middle section of the form builder now contains one field, which is our Key Field (indicated be the presence of a 'key' icon).

For our demo, we have defined that the 'SchoolName' Field as the Key field for this form. Because this field is a key field, the 'Required' checkbox is automatically selected.

You will notice that the Project Validation box now contains a warning indicating that the form does not contain a title field. As a reminder the title field is used when listing entries on a phone and should be something that is easy for an indicidual to recognise a specific entry. We check the title checkbox and save the project.

The following screenshot is now seen, indicating the project is valid:

key valid

 

 

We will now walk through each type of form field in detail starting with plain text.

 

Next | Adding a plain text question