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



Media Fields

<barcode> - allowing a user to scan a linear (1D) or Matrix (2D e.g. QR) barcode and extract and attach the encoded data to an entry.

 

<barcode ref="schoolbarcode"> 

    <label>Please scan barcode</label> 

</barcode>

The <barcode> tag presents a user with the ability to scan a 1D or 2D barcode. Data encoded within the barcode are extracted and placed in a standard text input.

The following screenshots indicate the flow presented to a user and the example shows scanning of a 1D barcode.

When tapping 'Tap to Read Barcode', the device's camera is launched, enabling the barcode to be read.

 

Capturing a barcode using the device's camera

 

barcode1

 

 

 

 

arrow

 

 

 

 

 

barcode2

 

 

 

 

arrow

barcode3

 

You can also add the required="true" attribute if neccessary.

Using regex="" with barcodes

Due to the type of data encoded within a barcode (text), the regex="" attribute can also be used within the <barcode> tag allowing you to specify a pattern that the encoded data must adhere to. This could prevent the wrong kind of barcode being scanned by mistake.

For example, you may have setup a project scanning the barcodes of books which encode their ISBN number. You could specify a regex pattern which checks that the barcode scanned contains a valid ISBN (eg see here)

Alternatively you may have a project where different samples are taken from patients within a hospital (blood or urine) and you wish to label different types of sample tubes with different kinds of barcode, to add laboratory results to your database post-processing. Your pre-printed blood barcodes may encode a set of integers preceded by the letter 'B' and your urine barcodes may contain a set of integers preceded by the letter 'U'. To avoid a user scanning a blood barcode when they should be recording a urine barcdode, you could specify a regex within the urine barcode input which checks, when scanning, that the data encoded in the barcode starts with 'U' and warn the user if it does not.

 

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 Android market or by clicking here.

Next | Defining keys