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



The ecml document - structure and project information

ecml


The following ecML contains a very simple mockup of an EpiCollect+ project


 

1.	<ecml>
2. <meta>
> Contains metadata about project and server locations 3. </meta> 4. <form num=”1” name="myfirstform">
      Contains details about form 1
5. </form> 8. </ecml>

The entire document is wrapped using the opening (line 1) and closing (line 8) <ecml> tag. At the top of the document is the <meta> tag which includes within, meta information regarding your project (see below). Following the <meta> tag is where you describe your form (or forms). The example above shows a single form project and the opening <form> tag contains two simple attributes defining firstly, the number of the form (num="") and secondly, the name of the form (name="")

NOTE: Within your document, you MUST include the model section and at least one form.

 

The <model> tag

The <meta> tags contain meta information about your project including server location, the location of scripts which allow data to be received/sent to/from the server to/ from the mobile device.

The following example indicates a fully described <meta> section with the tags that you must include.

<model>
<submission projectName="myFirstProject" allowDownloadEdits="false" versionNumber="1.0"/>
<uploadToServer>http://myserver.com/myFirstProject/upload</uploadToServer>
<downloadFromServer>http://myserver.com/myFirstProject/download</downloadFromServer> <description>Can contain a HTML description of your project </description> </model>

The model above contains four tags, the first three of which are required and explained as follows

 

The <submission> tag

Contains the overall details of your project and has three possible attributes as follows:

projectName="" Contains the name of your project, and this will be seen by the user when they load onto a mobile device. This is a REQUIRED attribute

allowDownloadEdits="" States whether you would allow users to modify data they download from the central server on the mobile device. This is NOT REQUIRED and if not present, defaults to false.

versionNumber="" this contains the version number of your ECML document. Should you change anything about your project, we recommend updating this -Within the EpiCollect+ mobile app an attempt to load an existing project with a higher version number will prompt users to overwrite the existing project. This is a REQUIRED attribute

 

The <uploadToServer> tag

Indicates the location of the scripts on your webserver for uploading data from the mobile device (see section - setting up a server). This is a REQUIRED tag

<downloadFromServer>

Indicates the location of the scripts on your webserver for downloading data to the mobile device (see section - setting up a server). This is a REQUIRED tag

Next | The Form