Whitebeam Object Definition

Site Map
 
Home
 
Application Guide
Reference
  Installation
  Configuration
  XML Markup
  JavaScript Classes
  ROM
  Templates
  Environment
  Dev Process
  Tools
  External Links
  Example libraries
Community
Contact Whitebeam
To-Do
Download
Credits
Licence
Whitebeam Users
 
 
 

Whitebeam Object Definition

Method Description

qaRunner.submitPage()

Submit returned questionnaire answers to the database.

Syntax

number = qaRunner.submitPage(answerDef)

Parameters

The 'qaRunner.submitPage' method takes 1 parameter:

Name Type/Value Range/Length Description
answerDefstruct qaRunner.undefinedsee definition Required. An object which results from submitting a questionnaire form.

Results

The 'qaRunner.submitPage' method returns number:

Type/Value Range/Length Description
number   The pageID of the answer File, -1 for failure or 0 if a mandatory question was not answered, but the submit was otherwise OK.

Remarks

If the provided object has an attribute of "finish", then the state of the questionnaire is set to "Complete".

The submit function will not attempt to erase answers to questions which are currently disabled. This means that the user can go back to a previous page, change an answer, and retain entered values. When the last page is submitted (ie. the Finish button is pushed) then all questions disabled at that point will have their answers expunged from the answerFile XML.
Whitebeam release 1.3.36
(loadtime : 9ms)