This is a legacy form building tool and will not be supported or updated in a future product release. For a fully supported form building tool, we recommend using OpenForms. For more information on OpenForms, see Use OpenForms with OpenCities and the OpenForms help centre.
Use the appropriate field type to create your form questions and collect response data. To select an input type, click on the '+' symbol and the field will appear below the input type area.
- Label field
- Textbox and Textarea fields
- Combobox field
- Checkbox and Checkbox Matrix fields
- RadioButton and Radio Matrix
- Date field
- File upload field
- Rank
Label field
Used to create section headers within the form. As the form is entered into the WYSIWYG area of a page, content can be added around the form. The label field is used to title sections within the form itself e.g. Section 1 - Contact Details, Section 2 - Employment Details etc.
Enter text by placing the cursor directly into the field. No response is required.
Textbox and Textarea fields
This field allows the respondent to provide a response using text.
- A Textbox input field is used to provide short, one line answers
- A Textarea input field is used for longer answers (paragraphs) which allows more response space to review text.
Place the cursor in the label area to enter the question text, then click on the pencil icon to the left to edit the field properties.
Field descriptions for textbox and textarea
| Field | Function/Description | |
| 1 | Value | Predefined value added to the response box |
| 2 | Required field | Assigns this as a mandatory field. If selected, ensure you fill in the Validation message field. |
| 3 | Number | Field will only accept numeric characters |
| 4 | No. of decimal | Number of characters accepted for this field |
| 5 | Field will only accept characters configured as an email address | |
| 6 | Respondent | Appears if Email is selected, to identify field as the Respondents email address. This is the address used for the Autoresponder message set up in Submission. |
| 7 | Max length | Number of characters accepted for this field |
| 8 | Regular expression | Code used to set the input response pattern. It is used to specify a set of strings or a character configuration for a particular purpose e.g. a request ID 'ABCD-1234' can be coded to only access the configuration of 4 letters, a dash and 4 numbers. |
| 9 | Validation message | Appears after form submission attempt to advise the respondent that they have not filled in a required field correctly. The form will not be submitted until they has satisfied the field response requirements e.g. mandatory field not completed or text used when field has been set to only accept numbers. |
| 10 | Description | Overview of field for internal use |
When you have completed the settings, click update to save and condense the settings window.
Settings screen for textarea and textbox fields
Combobox field
Create a list of selectable dropdown options.
Field descriptions for combobox
| Field | Function/Description | |
| 1 | Required field | Assign this field as mandatory |
| 2 | Graph | Allows you to represent the results as a pie or bar graph in the Reporting tab |
| 3 | Validation message | Message displayed to advise the respondent that they have not filled in this required field (if assigned) |
| 4 | Description | Overview of field |
| 5 | Options | Set up the drop down options by inserting 'Text' displayed on screen and the default 'Value' of the field. Tick 'Selected' if you want this item pre-selected by default. Click 'Add' to create more options. To delete use the settings drop down to the right of the field and to rearrange the options drag and drop them using the move item icon to the left of the field. |
Settings screen for combobox
Combobox display in live form
Checkbox and Checkbox Matrix fields
The Checkbox input type allows respondents to select multiple results from options using tick boxes. Settings are configured as per combobox
Checkbox display in live form
Note: Settings screen options are the same as the Combobox above.
Using the Checkbox field allows multiple results to a number of set questions, so the respondent can choose more than one options to answer the question.
Checkbox matrix
The most common use for Combobox Matrix is providing various ratings for the quality of a service or experience.
Settings screen for Checkbox matrix
Checkbox display in live form
RadioButton and Radio Matrix
The Radiobutton field works the same as the Combobox but only allows respondents to select one result from a group of options. The Edit field properties or settings are the same as Checkbox and Checkbox matrix.
Radiobutton display in live form
The Radiobox field option allows only one result for a number of set questions. The respondent can only choose one option to answer the question.
Radiobox matrix
The most common use for Radio Matrix is to provide definitive answers for the quality of a service or experience from preset options or levels.
The settings screen options are the same as the Checkbox Matrix.
Radiobutton matrix display in live form
Date field
The date field allows respondents to enter a single date from the calendar widget.
The settings for the Date field allows you to set this as a required field, and the date period available for the respondent to choose a single date from the calendar. If either are set make sure a validation message is used to explain these rules.
Settings screen for date field
Date display in live form
File upload field
The File uploader allows the respondent to add files to the form submission. In the settings, the file uploader can be assigned as a required field, the maximum file upload size and the specific file types permitted to be uploaded.
If any file is available for upload leave the filetype as is (with a * only). If you want to allocated a list of accepted file types, put the file type extension in the Filetype field and click 'Add' to include additional filetype if required.
Settings screen for assigning specific file types for upload
Rank
Allows the respondent to rank order to a list of options.
This option can be assigned as mandatory (requiring a validation message) and internal description. Options are configured in settings, and display with a number field beside it identifying, the options position number in the list. Fields can be dragged to different positions in the list if desired. The rank or position number can be changed by the respondent in the live environment.
Settings screen for rank field
Rank display in live form
