Capture of form data

The capture of form data occurs when the visitor navigates from the scene containing the form, to another scene. e.g. a scene where the visitor is informed that all the data has been sent. For this to happen, the scene action must have its setting Submit Form checked.

Test your form thoroughly before publishing it, so that the correct data is captured. This is best done by test-running the project from the project list and then taking a look at Collected Data.

An quick example

This example will show you how to create a form to register for a newsletter. You can find more information on the respective form objects here.

1. Add two text fields to the first scene. These will be the text fields for the visitor's name and email.
2. Continue by adding a checkbox. This will be used to let the visitor decide if he or she wants to register for the newsletter.
3. Now set the properties for the form objects:
   1. Select the first text field and specify Name as the Unique ID and check Required.
   2. Select the other text field and specify E-mail as the Unique ID and check Required.
   3. Select the checkbox and specify Yes as the Unique ID and Newsletter as Group. For a checkbox it is the property Group that specifies the heading in the report and the Unique ID that specifies the value. This will all make sense later when we take a look at the report.

Now the actual form has been created and prepared for use. All that's left is to see that the form data is captured and to give the visitor some feedback at validation.

1. Add a new scene and name it Thanks. This is the scene that will be shown after the form has been submitted
2. Add a button to the scene with the form.
3. Add a click action for the button by selecting Scene Actions and then the scene you named Thanks.
4. Check Submit Form in the Actions Settings panel.

All done! Now the form will be submitted and the collected data will be available. Below is an example of how the report will look. Note how the report headings accord with the values set for Unique ID and Group:

Validation of form data

Validation of form fields is made if they have the Required  setting and if they have a validator selected (for example the one for e-mail). The default feedback given to the user at validation is text in a red box, with the form object's outer frame turning red. You can customise the style of this feedback through the various options in the Form Error Style dialog, available from the General Settings for the scene containing the form.