Webform emails and confirmation pages in the WMS


OVERVIEW

Target audience: Site Administrators, Site Managers, Site Editors

Webforms in the Web Management System (WMS) can generate an email when a form is submitted under appropriate circumstances.

note

NOTES:

  • Site Administrators and Site Managers can create webforms while Site Editors may edit but not publish webforms.
  • There are security issues to be aware of when collecting data with Webforms. For more information, see: Webform Security Considerations.
  • Instructions in this article require some familiarity with webform tokens.

    Before proceeding, see: Using tokens in WMS webforms.

In this article:

Webform emails

A webform can be set up to generate an email when a form is submitted. Emails can be sent to a specific address, or to an address associated with a component.

Note: The information submitted on the form can only be included in emails to McGill email addresses.

Specific address

On the WEBFORM tab:

    1. Click E-mails.
    2. Select the Address option.
    3. Enter the McGill email address.
    4. Click Add.

Sending to the user’s email

When a confirmation email is to be sent to the submitter of the form, it can be sent to the address that is provided in the E-mail component. 

On the WEBFORM tab:

    1. Click E-mails.
    2. Select the Component Value option.
    3. Select the field that collects the Email address (create email field if needed).
    4. Click Add.

Other components besides E-mail can be used to provide an email address:


Email messages

Email messages can be either default or customized.

Default template

The default template for McGill email addresses contains tokens that capture all the submission information with minimal formatting. Emails sent to non-McGill email addresses do not include the Submitted values.

Webform email confirmation template

Included E-mail values

The token [submission:values] includes all of the information from all of the fields. To exclude certain fields from the default message, uncheck them from the INCLUDED E-MAIL VALUES. Empty fields can also be excluded from the default message.

Included email values

info

IMPORTANT:

  • Form responses (user-submitted information) may only be emailed to McGill email addresses. Generic confirmation messages can be sent to off-campus email addresses e.g., "Your information has been received". You may also include user-supplied dates and times, plus any text which wasn't entered by the user (e.g., a confirmation email could include hidden fields or other session information based on the choices made by a user).
  • If any changes are made to the default template, it will automatically switch to a Custom template
  • The Markup component will be excluded from emails, even when they are visible and checked on the INCLUDED E-MAIL VALUES


Attachments

If your form requires the submission of files, they can be included as attachments in emailed results. If you choose this feature, be sure to set a maximum file upload size for each field small enough so that the email will be delivered. We cannot provide a size limit as that is determined by the email provider, here is an article on Microsoft’s support site.

To set up your email to attach an uploaded file, check the Include files as attachment checkbox.


Custom template

Email messages can be customized with basic formatting, additional tokens, and reader-friendly text.


Confirmation pages

A confirmation page can be shown to a user to show that their form has been submitted. Just like webform emails, confirmation pages can be extended and customized with tokens. However, HTML can also be leveraged to add visual elements and additional formatting.

Create a confirmation page:

  1. Click the Form settings button at the top of the screen.
  2. In the Confirmation message box, type the message the user will see after submitting the form such as a statement about when they can expect to receive a reply.
    Graphical user interface, text, application, emailDescription automatically generated
  3. In the Redirection location section, select one of the following: 
    • Confirmation page, if the message is to appear on a separate page. 
    • Custom URL, the user to a web page that already exists. 
    • No redirect (reload current page) if the confirmation message text is to appear at the top of the page containing the form (so the user is not brought to a different page.)
      Graphical user interface, textDescription automatically generated with medium confidence

To create a custom Confirmation page:

  1. Click the WEBFORM tab
  2. Click Form Settings
  3. Customize message under SUBMISSION SETTINGS

A custom Confirmation message can be created in the Form Settings options under SUBMISSION SETTINGS.


references

ADDITIONAL REFERENCES: