Difference between revisions of "Drupal Webform"
|Line 155:||Line 155:|
= E-mails =
= E-mails =
See the [[Drupal_Webform_Email_Templates|article on Drupal Webform Emails]].
See the [[Drupal_Webform_Email_Templates|article on Drupal Webform Emails]] .
= Form validation =
= Form validation =
Revision as of 14:59, 8 August 2014
Part of the documentation on Drupal.
We have set up new sites specifically dedicated to creating Webforms in a more secure, more up-to-date configuration. The process for creating and managing your Webforms is largely unchanged with the exception of the Creating a Webform, Confirmation Message, and Linking to your Webform sections.
Drupal's webform module allows you to set up an online form to collect data and send information to you via email or by downloading an Excel spreadsheet. This should not be used to collect sensitive data. Please review the sensitive data collection matrix to determine whether this is an appropriate system for your data collection needs.
- 1 Creating a Webform
- 2 Form Permissions
- 3 Adding Form Components
- 4 Form Settings
- 5 E-mails
- 6 Form validation
- 7 Results
- 8 Linking to your Webform
- 9 Closing or Deleting a Webform
- 10 Finding your Webforms
Creating a Webform
- If your department, office, or program does not already have a space for Webforms on forms.middlebury.edu or forms.miis.edu, we will need to do a little bit of work to create one for you so that it looks like your site on www.middlebury.edu or www.miis.edu and doesn't confuse visitors to your site. To request this, please submit a Helpdesk ticket through the Web Helpdesk interface.
- Go to https://forms.middlebury.edu/user or https://forms.miis.edu/user depending on which site you are planning to add your form to and log in with the username and password that you would normally use to edit in Drupal.
- Type the address of your department, office, or program's forms site in the address bar. You will have received this address in the response to your Helpdesk ticket in step 1.
- Create a new page for your Webform by clicking Add Sub-page in the Sub-pages section of the Edit Console at the top of the page.
- In the Page name textbox, type in the title of your form, as you would like it to appear in the left navigation menu then click the Create sub-page button at the bottom of the page.
- Click Add under Content in the Edit Console.
- Select Webform from the list of content types in the middle of the page.
- Enter a Title for your webform.
- In the Body section, put any information that you would like to appear before the form, such an instructions.
- Click Save
See Linking to your Webform for steps on creating a link from your department, office, or program site to this new form you've created, or the sections below in Adding Form Components to add fields to your form.
The setting of who can "read", or in this case submit, a piece of content in Drupal is made at the page level, rather than the content level. To ensure that your forms in Drupal can only be submitted by people with a Middlebury account:
- Click Settings in the Page section of the Edit Console.
- In the Permissions section of the page settings, make sure that the "Read" checkbox to the right of "Everyone" is unchecked.
- Add the "institution" group to the Group permissions and give it only "Read" access. The "institution" group can be found within "Groups" and then "General" in the group menu. This group contains everyone at Middlebury, MIIS, the Language Schools, Schools Abroad, etc. You may wish to use a different group if you only want this visible to faculty, staff, and/or students, but "institution" is the go-to group for all Middlebury-related people.
- Click the Save Settings button.
Adding Form Components
After you click the Save button when creating a new Webform, you will be taken to the form components page. If you are editing an existing Webform, you can get to this page by clicking the Edit link at the bottom of the form and then clicking Form components in the Edit Console.
To add a component:
- Give the component a unique name. The name:
- Appears in bold above the interactive part of the component, followed by a colon.
- Information on the 12 component types can be found below.
- You are now in the editing interface for the form component type you have chosen.
- You are returned to the "Form components" page.
To edit an existing component, go to the "Form components" tab in the editing interface for you form and click the "Edit" link next to the component you wish to change. This will bring you to the appropriate form component editing interface.
To reorder existing components, use the icons left of the component names to drag them into the correct order, then click the "Submit" button.
All component types have 3 common fields in their editing interfaces. The "Label" field inherits the name you assigned in the steps above, and is displayed above the interactive piece of your component. The "Default value" field allows you to have parts of your form already filled in. The "Description" field allows you to provide more information for users and is displayed below the interactive portion of the component. The unique portions of each component editing interface are discussed below.
This component type provides a place for users to submit a date: month, day, and year. You have control over what time zone is used and how you want users to provide a year, either a dropdown list or a text field.
This component will give users a text field to provide a valid email address, and only properly formatted addresses will be accepted. You also have the option of sending a copy of the submission email to this address.
This component allows you to group other components into boxes. You can choose to make each box collapsible. To put other components into a fieldset, when viewing the list of components, drag the component below the fieldset in the list and then to the right to indent it below the fieldset.
This component allows users to upload files with their submissions. You can control what file types are allowed, how large files can be, and where they are stored. Note: A "File" component must appear after the last "Pagebreak" component.
This component provides a common set of "Options" for a list of "Questions." Options appear across the top, questions down the left. Each spot in the grid has a radio button, and only one option may be chosen for each question. You are able to randomize the order of the options, questions, or both.
This component can be used to store information not shown to users submitting the form.
This component can be used to insert HTML code into your form.
This component is used to break your form into pages. The submit button will not be visible until a user completes the final page of the form. Note: If your form has a "File" component, it must appear after the last "Pagebreak" component.
The Pagebreak also lets you set a Conditional rule, which determines how people filling out the form will get to the page. This lets you have an answer to one question on your form lead to a set of other questions. This behavior is sometimes called branching logic. To use this, the Pagebreak must come after at least one other form component. To use this:
- Expand the Conditional rules field on the Pagebreak form component configuration screen.
- Select the Component whose value will determine whether to show the page.
- Select either Is one of or Is not one of to determine whether to show the page.
- Enter the Values that will determine whether to show this page.
- Click Submit.
This component allows users to respond to prompts. You can create single response questions (radio buttons, dropdown lists) as well as multiple response questions (checkboxes, multi-select lists).
The Select options component features a GUI interface for adding options. If you want to revert to the manual method for editing options, click the Manual entry link below the option boxes. The value of each item can be entered in the text field contained in each row. If you want to be sent a different value for an option than appears for the user (ex. "One" appears on the form and you are sent "1"), click the Customized keys (Advanced) checkbox and enter the value you wish to be sent in the text field to the left of the value displayed to the user.
The default option for this element can be set by clicking the radio button to the left of the appropriate value. Values can be rearranged by dragging the cross glyph to the left of these radio buttons. You can add a new row below any existing row by clicking the green cross glyph on the right and you can remove any row by clicking the red X glyph on the right. You can also choose to Randomize options by clicking that checkbox to display the options in a random order for each person visiting the form.
If you want to allow people submitting the form to supply their own option if an appropriate one does not appear in the list, check the Allow "Other..." option and enter the appropriate text in the Text for "Other..." option text field.
This component provides a box for users to type in. You can make this box resizable.
This component provides a single-line text field for users to type in.
This component type provides a place for users to submit a time. You can control what time zone is used, as well as whether to use 12-hour (am/pm) or 24-hour format.
This tab contains some of the advanced settings that were previously on the edit form. To get to this tab, after clicking Edit at the bottom of any Webform, click on the Webform tab in the Edit Console and then click on Form settings.
Who can read data submitted to this webform
This section allows you to add individuals or groups to grant permission to view submissions to this webform without granting those people access to edit the form or other content on your site. Keep in mind that any people or groups added here will have access to both the submitted data as well as any files.
Adding a person or group in this section does not automatically add them to the people who receive emails when the form is submitted. You must configure that separately as described in the E-mails documentation.
You can, optionally, add a message to appear after a user submits the form. Leaving this blank gives a default message of completion after a user submits the form. It is highly recommended that you use this space to provide a link back to your site on www.middlebury.edu or www.miis.edu.
A custom redirect URL will bring a user to that page after submitting the form. If you leave this blank or choose the confirmation message, the user will see that message instead. You can also choose not to redirect the user, which will reload the current form page when they submit the form.
This area allows you to limit user submissions. By default, a user can submit an unlimited number of responses, but you can restrict them to a specified number of submissions over a specified amount of time.
You can ignore the Available as block and Show complete form in teaser checkboxes as the way we have set up the Middlebury website make these options unnecessary. The option of interest here is Allow users to save a draft. This option is only useful if your form requires users to sign in before filling it out. If you use this option on a form that allows anonymous users to submit it, it may behave erratically. However, if you require people to sign in to fill out your form and this option is selected, they will be allowed to save a draft of their form submission. This will not send emails from the form, but they will be able to come back to the form at a later time and complete their form submission. This is a good option if you have a very long form, especially one that requires people to gather written materials or files before they submit it.
This section also allows you to change the text of the submit button, which is Submit by default.
When editing the webform, under Webform -> E-mails, any email addresses specified in "E-mail to" will receive an email when the form is submitted.
See the article on Drupal Webform Emails for more information.
Form validation allows you to create rules that will check the integrity of the data people have submitted. For example, if you have a field that collects a ZIP code, you may want to check that the value entered is between five and ten characters in length. If the person submitting the form enters a two digit ZIP code, they would receive a message letting them know of the issue and asking them to correct it and re-submit the form.
To Add a validation rule, click the Form validation tab in the Edit Console. Click on the type of rule to add to the form. There are explanations of each type of rule to their right. Enter a Rule name, which is just seen by you and helps you remember why you added this rule to the form. Then select the Components to which this rule applies and fill in any other values that help create the rule.
You can Edit or Delete existing validation rules by revisiting this tab at any time.
In the Download tab for form Results there are two options that can help you when exporting form information to Microsoft Excel or another analysis program. Select list options allows you to choose whether to use human-readable or shorter column headers. You can also choose to export multi-values fields as separate columns or as a compact, comma-delimited list. In the Included export components fieldset, you can decide which of the components to include, which is helpful if you are only interested in analyzing a sub-set of the form information.
If your webform accepted file uploaded, they will not be included in this export, but the CSV will have links to those files. If you would like to store the files locally, you can open the CSV and click on the links to download each of the submitted files to your local machine.
Linking to your Webform
To have a link to your new Webform appear in the left navigation menu of your site on www.middlebury.edu or www.miis.edu:
- Navigate to your regular site on www.middlebury.edu or www.miis.edu and log in.
- Click on Create sub-page in the Sub-pages section of the Edit console
- In the Page name textbox, type in the title of your form, as you would like it to appear in the left navigation menu and the last portion of the URL from the address of your form on the forms site in the Page URL textbox (e.g. if your form is at https://forms.middlebury.edu/academics/dept/spring-semester-form enter "spring-semester-form" in the Page URL textbox) and click the Create sub-page button.
- Click Add in the Contents section of the Edit Console.
- Click the Redirector link in the center section of the page.
- In the Destination URL textbox, enter the URL of the form on forms.middlebury.edu or forms.miis.edu and click Save.
Closing or Deleting a Webform
If you no longer need to collect information from your form, or if it is on www.middlebury.edu and you have already created a new version on forms.middlebury.edu, it is a good idea to close or delete the form. Doing this limits the chances that information from the form will be accidentally exposed, that the form will be used by spammers to flood your inbox, and will help our website perform better.
Backing up your Data
Closing a Webform
Closing a Webform will prevent additional submissions to the form, though it will still appear on your site with a message letting people know that it is now closed. This is useful for forms that you want to temporarily disable, but will allow submissions to in the future. To activate this option:
- Click Edit at the bottom of the Webform.
- Click on Form Settings in the Edit Console.
- In the Status of this form section, select Closed.
- Click Save configuration.
Deleting a Webform
If you no longer need the form, we would appreciate it if you would delete the content. You can do this by clicking Delete at the bottom of the Webform. This will move the Webform into a [Recycle Bin] page below the current page in the navigation menu. When the Webform is in the [Recycle Bin] editors can still access the data that was submitted to the Webform in the Results section, but new submissions will not be allowed and the form will not appear publicly on your site.
If you are truly satisfied that you will no longer need the Webform, there is a Delete permanently option available after you have put the Webform in the Recycle Bin. Once the form has been deleted permanently, it cannot be recovered and all submitted data (including files) are removed from the website database.
Finding your Webforms
We provide two lists that Webform editors can use to locate all of the forms on www.middlebury.edu they are responsible for editing.
http://www.middlebury.edu/middlebury_my_webforms will show all of the forms on the site that the currently logged in user has access to edit.
http://www.middlebury.edu/middlebury_our_webforms/###### will show all of the forms within a particular area of the site. Replace the "######" with the page ID of the portion of the site you want to look at. The page ID is the number in parentheses in the Edit Console.