DynamicForms - Creating Forms

Summary

This article will walk a user through the process of creating a form.

Body

Form Creation

Table of Contents

 

Logging On

Log in to Dynamic Forms.

Form Design Dashboard

The form design dashboard is similar to the other dashboards within Dynamic Forms, except you wil have more options. Each form you have has a drop down next to it titles Action...clicking it like so will give you some options...

Action Buttons

  • Edit Form Template – Users can make changes to the template
  •  Activate / Deactivate – Allow users to take forms offline
  • Copy Form Template – Users can copy any existing form
  • URL Instructions – Provides users embedding URL (see the "Activating your form" page later in this guide)
  • Delete Form Template – Deletes form from your unit

When a form is active and has submissions (Reject / Multi /Pending / Processed / Archived) the ‘Edit Form Template’ option is not available. To continue editing a form you will need to clear out all forms before the option to edit will be available or copy the form to update and make the updated form active. Make sure that you deactivate the original.

Our next step is to create a form, so click on that "Add New Form Template" button and let's get started! We're going to be building a form called "Training" which will simply ask a few questions.

Add Form

This action brings up a dialogue box, where we are going to name our form and then click "Add", like so:

Add Form Dialogue

Name/Type Page

Now we have arrived to designing our new form. You will be presented with a page that looks like this picture:

New Form Creation

Name – Name of the form – this can be a part of the subject line in any emails sent 

Description – for your information only

E-sign Requirements 

  • None – Will not require a Form Submitter to login to fill out and submit the form. This means the form will not require single-signon.
  • Single-Signature – Forces Form Submitter to login to Dynamic Forms and sign the form electronically before submitting the form. This will require a Vol State account OR a generic dynamic form account, if for example your form needed a parent to cosign.
  • Multi-Signature – Allows Form Administer to apply a multi-signature work flow to a form. (This topic will be covered in our advanced form design.

Send confirmation email? - This option will send the person who submitted the form a confirmation email.

Show the form timer?  - A logout timer set to 45min. displays on Dynamic Forms by default. Once a Form Submitter has been inactive for 45 minutes, they will be logged out of Dynamic Forms for security reasons. All forms time out after 45 minutes regardless of whether or not you have this timer enabled on the form, so it is best to leave it set to "yes".

Use Recaptcha Validation? - This option forces the submitter to use a validation code to submit the form. If you have the option selected to "None" under Esign requirement, please leave this set to “yes”. This will prevent robots from filling out your form.

Use Automatic Activation - This option will allow you to set a date range a form is active, so you can automatically activate or deactivate a form based on date. This is useful for example if your form was being used for event registration.

For our training form, we are not going to require a signature (yet). So, we will use recaptcha validation and then it will be on to the next part of our design, under "Admin Notification". 

Administrator Notification

Admin Notification

This part of our form design allows emails to be sent to the form "owner or owners". Each email address specified will be sent an email indicating that someone has submitted the form. 

Notification Frequency – This field gives you the option to have an email sent either every 24hrs or with every form submitted. If you choose every 24hrs the email recipients will receive an email once every 24hrs if this form has had a submission. If you choose every form the email recipient will receive an email every time a form is submitted.

Notification email recipient(s) – Use this field to enter the email or email addresses of the users you would like notified when a form has been submitted.

Use custom email – You can have a generic email or custom email sent to the email recipient(s). If you choose custom you will have a few more fields to complete: custom email subject, custom email body, and dynamic email values.

Custom email subject – Enter the subject line for the email notification.

Custom email body – Enter the custom email message to be sent out.

Dynamic email values – You can use this field to display data/text from your form. Users can choose from Common Form values – related fields that are not placed directly onto a form, and User-entered Form Values – fields that users have placed on the form.

The next part of our form design will be Custom Text. 

You can ignore "Payments" and "Events". 
We do not use payment processing in Dynamic Forms.
"Events" are related to automated processes.

Custom Text

Custom Text

The Custom Text tab will contain fields that allow you to customize the Inactive Text and if your form is a "No Signature" or a "Single Signature" form, it will also allow you to customize the Confirmation Text on the form.

Inactive Text - The Inactive Text will be what is displayed on the screen when a form is set to inactive. To deactivate a form, you can do so on the admin home page by clicking on the Action dropdown next to the form you want to deactivate and click "Deactivate this form."

Here you can customize the message that the form user will see. This will be a nice message indicating the form is currently unavailable.

Confirmation Text - You will only see the Confirmation Text option in this tab if you are building a "No Signature" or a "Single Signature" form. The Confirmation Text is the message the form participant will see upon completion of the form. For "Multiple Signature" forms, the confirmation text will be customizable for each participant, so it will be located within each participant's properties.

SSO - Single SignOn

This area allows you to display a custom message to people who try to access a form without having Vol State credentials. There are two options:

Owner Notification Email Uses SSO Link? - Set this option to "yes" if the form owner is internal to Vol State so the email that is sent uses SSO links embedded in it.

Cosigner Notification Email Uses SSO Link? - This is dependent on your form. If your forms signers are internal to Vol State, choose "Yes". If there is a cosigner, such as a parent, that is not a Vol State faculty/staff member then choose "No".

With that set, we are ready to click "Start Designing" to begin to create items on your form.

Form Design

Designing Forms

How to Add a Form Page Item:

Once you've accessed the form designer, adding a new form page item is as simple as dragging and dropping the form item you want to use on the form to its desired location. There are several different form item types to choose from.

Form Items

Naming Your Form Items:

Each form item that you add to your form will require a form item name. If you are creating a first name field, it's recommended to name that field something similar to either "Firstname" or "Fname" as that will allow you to easily understand what data that field is collecting. Form item names need to begin with a letter and cannot contain any spaces or special characters. 

NOTE: For each form item that collects data (e.g. Short Answer, Choice List, Long Answer, etc...), you can set those fields as required fields by clicking on the "Required?" checkbox within each field.

Label: If the form item you have selected gives you an option for a label, you can either name it the same as the name or choose something different. You can use the label to tell the form user what to fill into the item, such as "First name". Or, you can hide the label if you choose. You must use the Label field as screen readers for ADA purposes will read the label to tell the user what to put into the field.

Options

Once you have added an item to your form, you will see these options to the right of your design layout:

Form Options

  • Advanced: The advanced button gives you more options to modify your form item. We will cover those under each form item.
  • Rules: This button allows you to add ruled and conditions to your form. We will cover those in the Advanced Form Design section.
  • Save: Saves your changes to the form item.
  • Delete: Deletes the form item.

Editing Form Items:

To edit form items, simply click on the form item you want to edit, and it area of the screen that typically shows the different form item types will change to display the different properties of the form item.

Another way to edit form items is to click on the Edit Item tab, and select the form item you would like to edit.

Tables

Why use tables?

Building and designing your form using tables is very important to understand if you want to build a clean, professional and organized form. Tables allow you to have control of the horizontal axis of the screen & also aname in the alignment of labels and fields.

How to use tables:

To add a table to your form, drag and drop the Table form item onto the form. By default, your table will contain 1 row and 4 columns. Should you want to add/remove rows and columns, you can do so by using the "+ Add" and "- Remove" buttons next to the Rows and Columns section. You will be prompted to select the position of the row/column you want to remove, or the position on the table of where you want to add your row/column. 

Table

Table

You can also edit the alignment of the table on your form, as well as any borders that you want on your table by clicking on the "Advanced" button. Here you can select an Outer Border, an Inner Border, or both. You can set the style, thickness, color and padding of the borders.

IMPORTANT:

The width of the table is VERY important. This controls how wnamee your form is and how much space the form will take up of the screen. By default, the table will automatically be set to 900 pixels wnamee. This is what we've recommended to be the maximum width of your form. You are not limited to only 900 pixels, but we highly recommend allowing that to be the wnameest you go for your tables. 

Why 900 pixels?

We've found that 900 pixels is a safe number to use to prevent any form users from having to scroll left and right to view the entire form. As users will have varying resolutions and different screen sizes, we've found that 900 pixels is a safe number that works well with all screen sizes/resolutions. 900 pixels also looks great as a PDF. Our PDF writer looks at the wnameest component of the form and puts all other form items in proportion to that wnameest component. If the wnameest table on your form is 1500 pixels, on a PDF, it will look less readable compared to a 900 pixel wnamee form.

How to use tables for alignment:

We strongly recommend to separate your labels from the actual fields that are collecting data. To do this, simply use the Text & HTML form item in one column, and place the field itself to the column next to the label. This allows other form items within your table to also be aligned. Please see the example below to understand the concept behind this. The table has 6 columns and 3 rows. The first, third and fifth columns contain the labels, and the second, fourth and sixth columns contain the fields that collect the data.

Table

Here is how this table would look on on a web browser to a form user:

Table

Long Answer

When the form designer needs to capture an essay-like answer from the end-user, they can use the long answer page item

Long Answer

Defining the width of your long answer box:

The width is measured in pixels.  The typical size of a paper form is 900-1000 pixels wnamee.   So a long answer box with a width of 200 pixels appears to be about 20% of the screen.   Here is an example of a long answer 900 pixels wnamee and 100 pixels high.

LongAnswer

Defining the height of your long answer box:

Like width, height is measured in pixels.  Shown below is a long answer that is 500 pixels wnamee and 150 pixels high.

Long Answer

Advanced Button Settings:

Limiting end user's answer:

The "Enter the maximum # of characters allowed" value enables the form designer to limit the end users' answers.

Short Answer

Short answer fields are used to capture information no longer than a sentence, such as a first or last name.

The short answer field has a number of options to ensure you are capturing the data you are looking for.

Short Answer

Field Edits:

In the Advanced settings, the first option presented to the form designer is the ability to force the end user to enter data in a specific format.   You have the following options in the drop down list:

  • Generic Answer - allows users to enter numbers, letters and symbols
  • Letters Only (A-Z) - just as it says only letters, and the user cannot enter spaces
  • Letters Only (A-Z - spaces allowed) - same as above but spaces are accepted
  • Numbers Only - only numbers are allowed to be entered
  • Date (MM/DD/YYYY) - ensures that dates are entered and formatted as shown (if the date to be entered is closer to today's date, you might consnameer adding a calendar page item instead of a short answer page item).
  • Phone Number - forces a user to enter ten digits to get the format ###-###-####
  • SSN -  forces end users to enter nine digits to get format ###-##-#### 
  • E-mail Address - forces the format of XXXX@XXX.XXX
  • Dollars & Cents - ensures that all dollars amounts entered includes cents
  • Dollar & Cents (longer) - a longer field for millionaires
  • Dollars & No Cents - when you want whole dollar amounts only - no pennies.
  • Prefill - this item is described in our advanced form design section.

Min / Max Values:

The next two options allow you to further control the input of the end user.   For example if you wanted to ask the user for the last four digits of your SSN, you could consnameer adding a minimum value of 4 and a maximum value of 4.  This will ensure that the end user will only enter 4 digits into the field.

Mask the input:

This option is provnameed for sensitive data input.   When the end user keys data into a field with this edit, the data appears as stars rather than the data input.   Think of this as the same as when you enter your password into a login screen - you only see stars entered not the actual data keyed.

Short Answer

Short Answer Box width:

This enables the form designer to control the length of the short answer input box.   The default value is 200 pixels, but you can change that to adjust for the designated input.  For example, if the input is "Mnamedle Initial" you could consnameer using 30 pixels.   If the desired input is "Street Address" you could consnameer using 400 pixels or more.

Choice Lists

Choice

Form designers can create customized drop down (or choice lists) for end users to choose from.   The page item has the following features:

Custom choice list label:

Form designers can utilize the default "Please select" label , or "Choose" a blank label or entering a custom drop down label.  This is only a label this is not the default text that will be accepted.

Choice Box

Custom choice list fields:

You are now ready to populate the drop down list.   To begin, click the "Click here to add a new choice" button.   Dynamic Forms gives you two values to enter - one value that the end user sees when she is completing the form, and the other value is the once that gets saved to the database.   This is useful if you are moving this data back to a database that is expecting values in a certain format.   In the example below, we are displaying a choice of "Yes" or "No" to the end user, but the values that are getting saved to the database are either "Y" or "N".   Just enter the appropriate value and click the save button to save your entries.

Choice

Date Picker

Date Picker

Properly formatted dates can be input two main ways:

  1.  With a Short Answer page item with a data edit
  2.  This Date Picker page item

Designers can determine which is more appropriate for their form's input.   For the example below where the form is capturing a date which is relatively close to today's date, this date picker page item is nameeal.

When the end user clicks on the data input box, a calendar function will pop up to enable the user to point and click the valname date rather than keying the date by hand.   The user can navigate the calendar by clicking on the arrows to the right and left of the month, year presented at the top of the calendar.

Date Picker

If dates are further out in future or in the past, the user might be better off in keying in the date with the short answer field with the data edit present.

Check Box

Check Box

Form designers can add check boxes to forms.    Check boxes are useful in many ways.   They can be used as a single choice - no or yes - type of field, or designers can organize multiple check boxes to form a multiple select list.   In addition, form designers can use the checkbox as a  required page item to ensure that a user must actively acknowledge some text on the form.

Check Box

Check box label:

Currently, the label will always appear to the left of the checkbox.  Dynamic Forms may add functionality to choose which snamee of the check box the label will appear on a later date.

For now, if designers wish a label to the right of the check box, it can we accomplished by building a simple 1 row, 2 column table where the check box the first field and a text field contains the label.

Check Box

Radio Buttons

Radio buttons are like a combination of checkboxes and the choice list field. It display a list of options with corresponding checkboxes and will only allow the form user to select one checkbox from that list. If you are wanting the options to all be displayed and limit the form user to select only one option, either a choice list or radio buttons would be what you want to use.

To configure radio buttons, they work similar to a choice list where you add both the value and description of each option within the field.

Radio Buttons

Here is what the radio buttons look like as an actual form user:

Radio Buttons

Text & HTML

If you need to add text and/or html to a form, click this option.

Dynamic Forms provnamees this rich text editor will enable you to key in / copy and paste your text into the form. You can also format your text through the editing button insnamee the editor.

Text and HTML

Text and HTML

Text & HTML fields are typically used for the form title, messages for form users but most especially for field labels. 

Some examples of HTML:

To add a divnameer line, do the following:

Create a 1 column by 1 row table set to 900pixels wnamee and add this within the Source code of the Text & HTML field: 

<hr color = "#000000" size = "1" width = "100%" /> 

This will add a black divnameer line that's 1 pixel thick and will take up 100% of the 900 pixel table. You can adjust the color and thickness by switching out the color code and size.

Important Note - Copying text from other sourcesMany times when users copy text from a different source like a website or a custom word document, the text that is copied is accompanied by several lines of HTML formatting (see example below). Sometimes the items copied include HTML open tags or other bad HTML that can affect the performance of the form.  Therefore, if you need to copy a large amount of text from a website or other custom source, we recommended that users first click the "Source" button in the top left hand snamee of the Editor and bring the text in without formatting. Users can then safely format the text.

Here is an example of what happens when you copy a few lines of text (top part of the table below) from a website and directly post this into Dynamic Forms (HTML at bottom of table).  In this simple example, the character count went from 473 to 1,753, but more importantly some additional code was copied over - in this case the form was not affected, but it could have been.

Text and HTML

Images

Dynamic Forms enables you to add images to your forms with the Image Page Item.  The best option is for users to upload images into their library of images in Dynamic Forms, but we also give user the ability to host their own forms. ( Note: All images on Dynamic Forms must be hosted in a secure environment to ensure that users do not see a pop up message saying that there are insecure items on the page.)  

There are already Vol State logos in your image library, but feel free to add your own.

To see your library of forms or have the option to upload a new image, click on the“Choose from Library” button within the Advanced section of the Image form item.

Image Adjustment

Image Adjustments

File Upload

The file upload page item enables the form designer to place an upload document option on the form to the end user.

To the end user, the file upload page item will look like this

File Upload

The end user would then click the "Choose File" button which will open the File Explorer tool on their computer to enable them to select the file they wish to upload.   After the file is selected the user will click the Upload File button to upload that file. 

Customizing the File Upload Page Item:

If you have specific instructions for the user, those can be communicated to the user by customizing the field label.

File Upload

Note:  The file upload page item enables the end user to upload a single document into the form.   If multiple forms need to be uploaded, the designer can choose to put additional file upload page items on form. 

The maximum size per file attached is 25MB.

Copying Existing Form Items

To copy existing form items, simply drag and drop the "Existing Item" into your form. 

You will then be prompted to provnamee 2 points of information - a Form name and a Field name.

Existing Item

Form name: This field is where you select where the field that you are wanting to copy is located. 

  • NOTE: You can copy form items that are located in different forms within your org and are not limited to only copying items created within the form you are currently working in.

Field name: This is where you select the name of the field/form item that you want to copy. It's important to keep track of the form item name that you are wanting to copy so you ensure you are copying the correct field.

Once you've successfully copied the form item, you can adjust the field's properties to your liking.

Activating Your Forms

After building a form, the form still stays in an "inactive" state until the form designer "activates" the form.

The activate status can be found by looking on the administrator Homepage.   In the example below, the form called "Academic Progress Appeal Form" is currently inactive which is reflected by the red active status icon displayed.

Form Activation

At this point,  the form designer  does not see the "fill out form" link above as the form is inactive.  If an end user somehow got the link to this form, the end user would see the inactive text defined in the Custom Text area.

To make the form active, the form designer just needs to click on the "Action" button to the right of the form name and click "Activate this Form" selection.

Form Activation

This will turn the red icon to green and the "fill out form" link will appear to the right of the form name.

Form Activation

Once the form is activated, the "fill out form" link will take the user directly into the form.

Getting the form URL

Next you will click the URL button in the action panel on the right snamee of the form in the dashboard. This will open up a window containing your URL.

If this form is not internal (meaning that people who are NOT Vol State faculty, staff or students will fill out your form), you can copy and paste this form URL into a hyperlink where you would like this form to be accessed from, or send it to the web team to be added into a page on our website.

If this form is internal you will need to add the following url string to the beginning of the URL generated by dynamic forms before sharing or posting this link to your website (all one string, no spaces):

https://nextgensso.com/sp/startSSO.ping?Partnernamepname=http://sts.volstate.edu/adfs/services/trust&TargetResource=

Congratulations, you have built a form!

Details

Details

Article ID: 110691
Created
Tue 6/23/20 12:56 PM
Modified
Thu 5/2/24 12:21 PM