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 barcode Field

 

Adding a barcode field allows a user to scan a linear (1D) or Matrix (2D e.g. QR) barcode (using the devices camera) and extract and attach the encoded data to an entry.

To add a barcode field, simply drag and drop the 'Barcode' 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:

Barcode Field

 

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

 

Label - The Label should contain the Question/ text you would present to a user. In the example above we have added the label 'Please scan barcode'

ID - The ID can be viewed as the column heading under which audio clips will be stored in the database. In the example above we have set the ID to 'barcodeScan'

Required: Checking this means that a user MUST scan a barcode before continuing

Title: You can set a barcode field as your forms title field.

Any number of barcode fields can be added to a form in this way.

 

Advanced Field Properties

Barcode Advances

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

Regular Expression - This allows you to define a pattern which must be adhered to within the barcode scanned by the user (see section on Validation).

Double Entry - This will require that a user scans the barcode 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, and this point in the form is reached, the user is presented with the option to 'Tap to Read Barcode'. When doing so, the devices camera is launched, enabling the barcode to be read and data extracted as in the following screenshots:

 

barcode1

 

 

 

 

arrow

 

 

 

 

 

barcode2

 

 

 

 

arrow

barcode3


zxing

Within EpiCollect+ we utilise the open source barcode scanning library ZXing (See here) and wish to pay thanks to their development work.

ZXing must be installed on a mobile device for EpiCollect+ to undertake barcode scans.

Should a user try to scan without ZXing installed, and provided they are connected to a data network (2/3/4G or wireless), ZXIng will be automatically downloaded and installed from within EpiCollect+

Alternatively, a user can install ZXIng directly onto a device from the Google Play or byclicking here.

We have now finished detailing the types of fields you can add to a single form. We will now move on to indicate ways in which you can validate data to try to ensure that user inputs adhere as close as possible, to the kind of data you wish to capture.

 

Next | Validation