Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Section
Column

There are two ways you can test your forms.

Method 1: Click the save and test icon from within the forms designer to save the changes to your form and automatically display the test popup window. Complete the form in the popup window to test it. When your testing is completed and the test mode screen is closed you will be returned to page in the forms/flow designers where you clicked the save and test icon if you need to make additional changes.

Method 2: Click the save and exit icon on the Forms Designer toolbar to save the changes to your form and exit the form designer. Then click the Test icon for the form on the Forms Home Page to enter Test Mode. Complete the form in the popup window to test it.

Both methods display the test mode popup which includes the Test Mode Views discussed below.

The Save and Test feature is not available for frevvo customers integrating with Confluence. The icon can be hidden with a configuration parameter.

Column
width240px

On This Page:

Table of Contents
maxLevel1

...

  • On the  designer , rules and PDF mapping pages.
  • An informational processing message as shown in the image is displayed after the icon is clicked until the test window opens.



  • if your form contains business rules they will be validated before the test popup displays and you will see this message:



  • If form/field validation errors are detected, closing the test popup returns you to the designer where you can quickly make corrections and retest. 

  • Save and Test checks for Rule and pdf mapping errors before the test popup displays. This gives the designer the option to correct first before saving and testing.

    • If rule validation errors are detected, the designer is notified and given the option to correct before the Test popup is displayed.



    • If PDF mapping errors are detected, a warning message with information about the error displays.



  • The form version increases by 1 every time you click on the save and test icon. It is reflected on the on the form edit page, when viewing/editing submissions and when you download/upload a form.

...

The first step to solving this issue is to understand which control(s) are causing this issue. The There are two ways to find the invalid controls:

Method 1

  1. Install the Firebug tool, http://getfirebug.com in the Firefox browser. This tool is a great way to find hidden controls which are invalid or required and empty.
  2. Test your form and enable the firebug tool.
  3. Open firebug's HTML tab and search for all instances of s-invalid using the search box in the tool's top-right corner. This will take you to the HTML of each control in the invalid state. The control's name can be found in that HTML.
  4. Now you can edit your form in the designer, find that control and fix the issue.

...


Note

If a required control is inside a hidden section, then that section will also be invalid and you will also see s-invalid in the section control's HTML. This s-invalid is not the root cause of your bug. You will have to continue searching with firebug further to get to the actual control inside the section control that is the root cause.

Method 2

  1. Install the Firebug tool, http://getfirebug.com in the Firefox browser.
  2. Test your form and enable the firebug tool.
  3. Click on the Console tab.
  4. Execute this JavaScript function   _frevvo.api.forms.controls.getControlErrors(); Calling this function returns a collection of objects that describe any invalid controls including the control id, control label and the error description. In the image, you can see the reported errors for an Email, Money and Date field that contain invalid data. The controls are inside of a hidden section and are not visible to the user who is trying to Submit/Continue the form/flow.

    Image Added

Test your form to verify that all your business rules are working as expected. For instance if you have a radio field "Billing address same as Shipping?" and select "no", you would expect the hidden Shipping Address section to become visible and required. Test each form field that has dynamic business rules to verify that they are working as you want. Also remember to test the negative cases, for example if you then click "yes" to the billing address question, make sure the Shipping Address section control becomes hidden and optional again. Note it's very important that hidden controls are not required as discussed above.

...