Overview
Data fields are the foundation of data collection in Element451. Applications, Event registrations, Appointments, Forms, and more use data fields to allow students to submit information about themselves. This guide is your key to configuring data fields in Element451.
Field Categories: Fields, Groupings, Custom, Markdown
Field Categories: Fields, Groupings, Custom, Markdown
When you 'Add a Field' to any form, you are presented with three categories of fields to select: fields, field groupings, and custom fields.
Fields
This tab contains single, pre-made fields. These are standard fields, such as name, date of birth, term, and major. These fields already have validation (covered in more detail below) and other options for you. For example, the country of citizenship field comes pre-populated with a list of countries, so you don't need to create that list for people to choose from.
Groupings
Grouped fields consist of multiple fields. Address is a good example. You would select the grouped address field rather than manually adding the individual fields (street address, city, state, etc.). Groupings are great for standard information but are limited in that the fields in the grouping can't interact with each other as they can with conditional logic (explained below).
Custom
Fields that you or your team members have already created. Event451 saves your fields here, so you don't have to recreate them. This is especially helpful for frequently used fields.
New, Markdown
Rather than a field for gathering information, this is a field for displaying text within a form. You can format the text with markdown tags.
Markdown fields are not designed for large amounts that span multiple paragraphs of text like those used in agreements. This field type is designed for shorter, clarifying, or informational text.
General
Once you've selected a field type from the list of pre-made fields or created a new field, you'll be able to customize it. This may mean adjusting settings or, in the case of new fields, entering them for the first time.
The General tab is where you'll enter the basic information required for your field and details about how it should be displayed. Depending on the type of field you selected, these options will be different.
General Section Configurations
General Section Configurations
Label: The title of the field that will be displayed on the form. E.g., First Name.
Description: This allows for an internal description of the field.
Required: The field must be filled out. If it's skipped, the form won't submit.
Hidden: The field will not be visible to the person completing the form. This option is useful when combined with a default value. This way, the person completing the form can't change the value. A great use case for this is when embedding RFI forms on your program pages.
Help Text: This appears with the field. Use it to help guide people about what they should enter or the format they should use. Examples are good ways to provide help text.
Default Value: Some fields allow you to have a value pre-populated. "Value" is simply the content in a field. For example, in a major field, the name of a major entered is the value. Explore the use case of using the profile type as the default value to create/update non-student profile information.
Size: How much of the screen should this field occupy? The choices are full, half, third, and fourth. You can have one, two, three, or four fields on a line, assuming the size of the other fields is set similarly.
New Line: When this is toggled to Yes, your field will start on a new line. When combining fields onto one line, toggle this to No.
Autocomplete: If you have autocomplete turned on, check the box next to the option you want to be pre-populated on the form.
Default Date: This is the equivalent of autocomplete for date fields. You can choose "today" or a time in the past or future. Since these dates change, selecting "today" will always fill in the day when the form is viewed.
Options: For fields like checkboxes, dropdown, and radio buttons that show a list of things for people to select from, you create the list by clicking Add Option and entering the information:
Label and Value: The label is displayed to the person filling out the form; the value is what will be saved in the system when the form is submitted.
Validation
Validation helps ensure that people enter the information you are looking for. For example, letters rather than numbers in a name field or a certain number of characters in a text area. Some things to keep in mind:
You can add multiple validations to a single field.
Validation options can be contingent upon other fields. For example, a field may only be required if another field chooses a certain option but can otherwise be skipped.
You do not need to add a mask validation to like SSN and phone number. Element451 has system validation that ensures those fields are entered correctly.
Validation Options Explained
Validation Options Explained
Required: A value is required in the field.
Required If: The person must provide a value in the field only if the parameters are met. When this option is chosen, you will be asked to choose the field and value(s) that will make this field required. For example, if you have a checkbox field with many choices and one of them is "Other, please explain," you can create a text field that is required if the "Other, please explain" option is checked to ensure that you get an explanation with the choice.
Letter Only: The entered value must be letters only, no numbers. This is used mainly in name fields to standardize input.
Letters + Spaces Only: The entered value can only contain letters and spaces.
Letters + Numbers Only: The entered value can only contain letters and numbers.
Letters + Dash Only: The entered value can only contain letters and dashes.
Numeric Only: The entered value can only contain numbers.
SSN: The entered value must be 9 digits, the value cannot be all one number, the value cannot be 123-45-6789, the value cannot have 00 as the middle number, and the value cannot have 0000 as the last number.
Email: The entered value must fit the pattern of accepted email addresses.
URL: The entered value must fit the pattern of a URL.
Max/Min Length: The entered value must be below the maximum or above the minimum number of characters. Combining the two can guarantee the length of what is entered in the field.
Person Name: The entered value can only contain letters, apostrophes, and hyphens.
Mask: The entered value must match a specific format, defined by you. Important: You should not add masks to special fields like SSN and phone number. Element451 has system validation that ensures those fields are entered correctly.
Before/After Date: For the date field, you can be sure the date value submitted is before or after a specified date.
Field Options
For fields that use options (checkbox, dropdown, and radio button), you can use a data source to populate the options rather than creating them manually. A list of majors is a good example of when you would want to use a data source rather than entering items individually. This not only saves time but also ensures accuracy and consistency.
To use a data source in a form, you must first create it by going to Data > Data Sources on the left-hand menu if the source hasn't been created yet.
Using a Data Source
Using a Data Source
Toggle Use values from data sources? to Yes.
Select the data source from the dropdown of all the available data sources. This list will include custom sources as well as system ones. Depending on the selected data source, you may see options to indicate:
Name Field: This is the field from the data source shown on the form. You can go to the data source (Data > Data Sources) to see what these options correspond to, as they will be different depending on the data source.
Value Field: This value will be saved when the form is submitted.
Filters
Filters
Use filtering in your application, form, or event registration when using any of these fields: majors, terms, degrees, campuses, and schools. This method restricts field options based on previous answers. For example, if your institution only accepts nursing applications for the fall, adding a filter would automatically adjust the form to reflect that requirement.
Conditional Logic
Conditional logic allows you to tailor the form based on user responses, making it more intuitive. You control which fields are displayed to the person based on their previous answers or selections of other fields in the form, making the form seem less daunting and more personalized. In other words, "show this field if..."
If conditions are not met, the field will be hidden.
Adding Conditional Logic
Adding Conditional Logic
When configuring your field, you'll see a Conditional Logic section.
Click Add Condition to get started adding your first condition.
Field: The other field on the form this one depends on.
Operator: The logical operator to use on the values we will specify next. These are classic logical operators.
Equals: Displays the field if the value in the specified field is exactly equal to a single value.
Does Not Equal: Displays the field if the value in the specified field is not equal to a single value.
In: Displays the field if it matches any values in a set. You can specify multiple values to look for with this operator.
Not In: Displays the field unless any of the values in the set are found in the specified field. You can specify multiple values with this operator.
Value(s): Specify what value (Equals or Does Not Equal) or set of values (In or Not In) your operator will be looking for. So, for example, if the field you're adding is a text field asking how many guests a person is bringing to the event, and the field this field is dependent on asks, "Are you bringing a guest?" the value would be Yes or No.
Important Notes
If the dependent field uses options (e.g., checkbox, radio button, dropdown), you can select the value from a list of the options for the field. If you can select multiple options with your operator, you can click the ones you want to include.
You can add multiple conditions to achieve the desired behavior.
Often, the best way to learn how your form fields interact is to try them out. Many of the modules where build forms allow you to preview.
Troubleshooting + FAQ
Q: What field type is best for adding an agreement statement or clause at the end of my application?
A: Markdown fields and other fields within Element451 are not designed for large amounts of text that span multiple paragraphs. Our recommendation if you were looking for a solution to display content similar to a 'terms and conditions' would be to include a short amount of text and link to another source (e.g., Do you agree to the following terms and conditions regarding payment of fees and student conduct? The full terms can be found at fire.edu/terms).