Form Fields
Overview
Field Types
The ITAM Admin Portal Form Builder has an extensive array of Field Types designed to help you create a form that captures the data your organization needs as efficiently and effectively as possible. To get the most out of the effort put into building forms, it is essential to understand the various types of fields, their purpose, and the options they provide to fine-tune their use.
The Form Builder comes with 25 different field types to assist you in designing a form that will best meet your needs. Some fields provide information to the user, either about the form or the process. Others help manage and control the flow of the form. Many capture and validate a specific data type; some allow you to weigh the answers to simplify compliance validation.
On this page of the Admin Guide, we will cover the various field types and their intended use. On a subsequent page, we will discuss the Property Types configuring each field.
Shared Features
Many, and in some cases all, fields share some features. Many fields have the same types of properties to configure their use. The different Property Types are described on the Form Field Properties page.
Help Link
Most field options have a help link next to the field name to provide information about the field and its intended purpose and use. Simply click on the small question mark icon, and some information about the field will pop up on the screen.
Data Entry Fields
Data Entry fields are intended to capture user data. We have divided these into two different types: Simple and Complex. Simple Data fields are meant to capture small, uniform types of information like text or a number. Complex Data fields capture data with more structure, like multiple-choice or multiple-line data.
Simple Data
The Single Line Text field is meant to gather simple text information that can be entered and displayed on a single line.
Paragraph Text
This field is meant to capture more than a single line of text information from the respondent in your form. A single field will accept up to 65,535 characters, or about 18 full pages of text, but it can be limited to a set number of characters or words. It can also be set to accept Rich Text, allowing more formatting options.Name
The Name field allows you to quickly capture the aspect of a name without creating individual fields for the different parts. There are four formats to choose from:
| Name Format | Format Description |
|---|---|
| Normal | Displays options for the First and Last names |
| Normal + Title | Displays options for the Title, First and Last names, and Suffix |
| Full | Display options for the First, Middle, and Last names |
| Full + Title | Displays options for the Title, First, Middle, and Last names, and Suffix |
Phone
Time
This simplifies the collection of time-based information. It can be configured to include seconds and switched to 24-hour time.
Date
The Date field allows for capturing date information on a form. There are two options: US (MM/DD/YYYY) and International (DD/MM/YYYY). The field also includes a date-picker, allowing a date to be chosen from a calendar instead of entered manually.
Number
This field is a great choice when you want to collect or display numbers to your form respondent. You can limit the values to a certain number of digits. Leave the value blank or 0 if you don't want to set any limits.
Price
The Price field is designed to facilitate entering currency information and can be configured to accept the format for many different types of currency.
Website
This field allows the respondent to input a URL and perform simple syntactic validation to ensure it meets basic format requirements.
Signature
This field adds a signature option to a form.
File Upload
This Upload field grants the ability to upload files into ITAM and associate them with the form. Users will have the option of using a modified version of the File Manager when uploading files. Files uploaded to the field will be listed with a link to the file. ITAM will try to display or play the file if appropriate for known file types. An option to download the files will be provided.
Complex Data
Address
The Address field simplifies the collection of address information. It automatically provides fields for the various parts of an address. It can be configured to allow for US only, providing a dropdown of states or international, allowing the State/Province/Region information to be entered manually.
Checkboxes
The Checkboxes field presents various options for selecting any or all responses. Use the plus and minus buttons to add and delete choices. Click on the choice to make it selected by default. Each option requires a numeric value in the field adjacent to the response that may be used for risk-weighting or other analytical calculations.
Multiple Choice
The multiple-choice field allows a form to present various choice options where only one of the responses may be selected. Use the plus and minus buttons to add and delete choices. Click on the choice to make it the default selection. The numeric value associated with the field adjacent to the response may be used for risk-weighting or other analytical calculations of your choice.
Matrix Choice
The Matrix Choice field allows you to create multiple questions within one field, each with the same possible set of answers and scores. Each row represents a question to present to users with an optional Template ID. The questions can be as straightforward or as complex as needed. Use the plus and minus buttons to add and delete choices. Each column represents a possible answer to each question, similar to a survey where you rate your response to each question. It would be best if you also assigned a score that will be used for risk-weighting or other analytical calculations for each choice. There is also an option to bulk insert Rows and Columns.
Dropdown
The Dropdown field is similar to the Multiple Choice field type in that it presents a variety of choices where only one of the responses may be selected. However, it does so by using a dropdown to select and display the choice rather than radio buttons. Use the plus and minus buttons to add and delete choices. Click on the option to make it the default selection. Please enter a numeric value in the field adjacent to the response that may be used for risk-weighting or other analytical calculations of your choice.
Record ID
The Record ID field allows you to create an automatic Record ID associated with an entry. It is displayed as an auto-generated number with an optional prefix, which can be set via the Record Prefix property. The field is not updateable by the user. Including an appropriate Field Label and Guidelines For User information will keep this field from confusing your users.
Information Fields
Information Fields display information to the form user rather than gather information.
Syndication
The Syndication field allows you to display formatted messages, such as RSS feed information, within your form. It's a great way to display advertisements or vital information as often as required. Since it is fed from an external URL, it can include updated information without modifying the form.
Media Player
The Media Player field allows for displaying and playing media information, such as MP4 videos, external URL-based links to video content, MP3 audio content, and image files such as PNG, JPG, and GIF files. Display attributes are automatically scaled to the form's width, but a pop-up window feature allows for full-screen viewing. Display training content, advertisements, instructional and informational content, or anything relevant to your current module's form content for a rich multimedia experience.
Form Control Fields
One key element of form design is organizing the fields into a logical flow for the user. One common way to do that is to separate similar data into sections or pages to provide a visual grouping and help the user avoid being overwhelmed by a large page of data fields. These Form Control Fields allow the flow of a form to be broken up in different ways.
Control Group
A Control Group is a container for other fields. Fields placed in a Control Group are treated as a unit regarding some tracking and reporting features of ITAM. This is best used when multiple fields are used to capture the data meant to represent a single control. See this guide's Control Group section for more information about Control Groups.
Section Break
Section breaks divide your form into sections on the same page. Options to include preformatted text are present. This field is famous for narratives and informational sections in a form that makes it more descriptive and meaningful to your respondents.
Page Break
The Page Break field adds a page break to the form, separating the fields that follow it onto a separate page from the fields that proceed it.
Cascade Form
In addition to separating data into groups, sections, or pages, you can separate data into multiple connected forms. This field is a great choice when you want to connect multiple forms, creating a contiguous experience for your respondents. This powerful innovation allows you to simplify complex forms with common templates that you "stitch" or link together.
When you place this field anywhere in your main form, you are presented with a multiple-choice drop-down selector containing all the active forms in your current inventory. You can cascade multiple separate forms together. You can also cascade within a cascaded form, creating complex form nesting scenarios. The form fields will assume the name of the cascaded form name present in the drop-down form selector.
The results of the respondents' entries will stay with the specific forms cascaded together quite elegantly.
Any form connected by a cascade field will independently update data when a user enters information. In addition to the separate form data set, the updates flow upwards to the top-level cascade form data set. Bi-directional data management is possible with the top-level collation of all separate form data into one unified experience and report output.