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



Form Logic - Jump Questions

the jump="" attribute can be used within a <select1>, <select> or <radio> tag to define questions within a form to 'jump to' if an item is selected or not.

 

<select1 ref="Question1" jump=”Question6,1”>  
 
 <label>Please choose an answer?</label>

	<item> 
		<label>answer One</label> 
		<value>answer1</value> 
	</item> 

	<item> 
		<label>answer Two</label> 
		<value>answer2</value> 
	</item> 

	<item> 
		<label>answer three</label> 
		<value>answer3</value> 
	</item> 
 
</select1>

The example above shows a simple, three choice <select1> question which has the attribute ref="Question1" (Remember, the ref="" attribute specifies a unique reference for a particular question). In this example, we want to specify that, if a user chooses answer one, they will then jump ahead to the question which has the attribute ref="Question6" . All other choices will proceed to the next question in the form.

The jump="" attribute allows you to specify a condition which is acted upon when a user submits a question.

 

Specifying a single jump clause

The format for specifying a jump is as follows:

jump="ref of question to jump to,clause"

The clause defines whether a particular choice is made or not, and is based on the numbering of the items from 1 to n, where n is the last item.

In the example above, the 'question to jump to' is specified as 'Question6' which refers to the ref="" attribute of the question further in the form. The clause is set as '1' which means jump if the user choices item 1.

 

Specifying multiple jump clauses

The jump="" attribute can accept multiple 'questiontojumpto,clause' instances separated by commas.

So in our example, if we wished to specify that, as well as the clause on item1, that we wanted to jump to Question 10 if the user chooses item 3, we can use the following:

jump="Question6,1,Question10,3"

etc.

 

Specifying a jump clause if an item is NOT chosen

We can use the '!' character within a clause to specify to jump to a particular question if an item is NOT chosen.

So in our example, if we now wish to specify that all answers EXCEPT item 1 should jump the user forward to Question 6, we can use:

jump="Question6,!1"

Again, this can be used when specifying multiple clauses

 

A common example - specifying 'other' and capturing a users input.

Quite often within a <select1>, <select> or <radio> question one may define a number of <item>'s and the final choice would be 'other'. In these cases, where it is not possible to define all possible choices in a list, you may wish the user to enter text to describe their 'other' choice. This can be done using a jump questions based on your questions ref="" attributes.

Consider the following three question form:

<select1 ref="colourquestion" jump=”namequestion,!3”>  
 
 <label>What is your favourite colour?</label>

	<item> 
		<label>Red</label> 
		<value>red</value> 
	</item> 

	<item> 
		<label>Yellow</label> 
		<value>Yellow</value> 
	</item> 

	<item> 
		<label>other</label> 
		<value>other</value> 
	</item> 
 
</select1>

<input ref="otheranswer">
		
		<label>Please specify other</label> 
		
</input>

<input ref="namequestion">
		
		<label>What is your name?</label> 
		
</input>

Three questions are listed. Firstly, a <select1> which asks the user 'What is your favourite colour?' with three choices - red, yellow or other. The second, is a simple text input asking the user to 'Please specify other'. The third is another text input asking 'what is your name'

We only want the user to be presented with the second question (Please specify other) if they choose the 'other' item in the first question.

We achieve this by using the jump= attribute as follows:

jump="namequestion,!3"

Simply, this specifies to jump to the question with ref="namequestion" if the user DOES NOT choose item 3

The following screenshots show how this would be presented to a user and the possible choices

 

Using jump="" to capture a users input for an 'other' item

 

jump1
arrowdown arrowdown
jump2
jump4
  arrowdown

 

 

 

 

jumps to

arrowdown

jump5
  arrowdown
jump3
jump3

 

Any combintation of jumps can be specified per question providing a flexible method for defining logic and flow within a particular form.

Next | Linking Forms