Questionnaire

The Questionnaire is a special container that can hold either Choose One, Score by Category, or Select Multiple tools. The container displays the content of these tools in tabular format, as illustrated below. The "questions" appear in the first column, and the "answers" appear in subsequent columns. You also have the option of including a "Comment" column, in which the mobile user can enter any comments they wish.

The animated example below shows a Choose One questionnaire with a "Comment" column.

Questionnare Example

Note the following:

  • You may not mix question types (Choose One, Score by Category, and Select Multiple) within the same questionnaire.

  • The "answer" options must be exactly the same for all of the "questions." This includes the answer name as presented to the user and underlying value properties for the individual tools.

Properties

Questionnaire Label: This label appears at the top of the questionnaire in black.

Data name: Because this is a required field, doForms will default the Data name to match the Caption or Label. If these are blank, doForms will generate a generic Data name with a sequential number (such as "untitled10"). Since it is used throughout the system, it is recommended that you enter a descriptive Data name that is easily identifiable. Nondescript Data names are difficult to find and select at a later time (e.g., when performing a calculation).

Fit to screen width: This feature provides a level of device responsiveness as it attempts to force your container elements to fit within the available width of your device's screen. If Fit to screen width is not selected, then the container is allowed to stretch beyond the right border of your device's screen, which may be preferable if your grid contains a large number of elements.

  • Equally space columns: Attempts to divide the screen width of your device by the number of columns in your container.

  • Use caption length: This setting will attempt to use the width of each of the tool's Answers to set the width of the columns.

  • Adjust column width: (The Fit to screen checkbox must be selected in order to use this option.) This option gives you the most control over how the questionnaire's columns widths are set. When you select this option, column setting fields will appear in which you must enter values that equal 100%. For example, if you had a questionnaire with Question, Answer, and Comment columns, you might to allocate 30% of the screen to the Question column, 45% of the screen to the Answers, and 25% of the screen to the Comments. The example below shows how you would enter those settings:

    Adjust Column Width

    However, note that the width allocated to the Answers will be divided equally between all of the possible answers. So, if your questionnaire has three available answers, then the 45% of the screen (that we already allocated, above) will be divided equally between the three possible answers (i.e., 15% apiece).

Append comment field: This option allows form users to add a comment for each question/answer (e.g., a comment about why they thought a product was "Bad"). If you leave the Comment label field blank, the label for the Comment column will be "Comment." You can change this by entering your own label in the Comment label field (e.g., "More Info").

Appearance: doForms allows you to set a default set of appearance parameters. This eliminates the need for you to have to set colors and other parameters each time you add an element to your form. You can however override the default settings for any tool by simply picking the Custom option. You can also edit the default by clicking on the edit defaults option.

Justification: Allows you to apply text justification settings to certain elements of the tool. Choose the appropriate radio button for the Caption field as follows:

  • L: Left-justifies the text.

  • C: Center-justifies the text.

  • R: Right-justifies the text.

Remove Space: This parameter is used to remove the space just before and just after the tool. By removing space, two elements can be made to appear linked or as a single element.

Actions

Only display this question if
This is a very powerful option as it allows you to hide form elements, only exposing them if the answer to a question in your form meets the criteria you have set. Being able to hide fields unless they are needed makes form more user friendly. For example, if you have a Choose One question with the answers Yes and No, then you can say "Only display this form element if" the answer to the Choose One is "equal" to "Yes." You can combine criteria with other criteria, thus creating complex criteria for showing/hiding form elements.

Supported Tools

The Questionnaire supports the following tools:

Input