You can apply validation rules to text or calendar field types. Validation rules ensure that the information entered by site visitors meets your criteria. For example, a validation rule specifies that a response to the Telephone field is 10 digits. If the response does not conform, an error message indicates the problem. The input must conform before the form can be submitted.
Validation rules are applied when a site visitor submits an entire form, not when the input is entered. If an invalid response is found, the error message that you define appears.
The site visitor must change his response to conform to the validation rule; then, the next field is checked and, if that is invalid, its error message appears, and so on.
NOTE: If you apply validation rules to more than one field, include the field name in the error message. For example, enter The name field only allows text. This is good practice because error messages only appear after a form is submitted. If the message does not identify the field, the user may not know which field needs correction.
If you want to change the visual indicator that a field’s response is invalid, see the following Ektron KB article: http://dev.ektron.com/kb_article.aspx?id=7070.
The postback message is HTML content, so can contain text or graphics. Typically, the message acknowledges a site visitor’s completion of the form. For most sample forms provided, sample text appears in the editor. Modify it as you wish, using Ektron’s editor to change the style sheet class, insert library items, and so on. You can also insert fields into the Postback Message that retrieve form information. For example, your postback message may be:
Thank you «Full Name» for completing the «[Form Title]».
When the message appears, it looks like this.
Thank you Jay Kohler for completing the breakroom survey.
When you click the Post back message tab and select Display a message, the Merge Field button () appears on the toolbar.
When you click that button, a dialog like the one below appears.
The list includes all fields on the form plus the following fields.
Click any field to insert it into the form. The postback message retrieves the field's value and displays it within the message.
You can apply conditions to any portion (or all) of a postback message. For example, you can display one paragraph if the user browsing your Web page is using a smart phone, and different text if the user is not on a smart phone. As another example, you could display a postback message only if the user is not logged into the Web site as an Ektron author.
The image below shows the message content after a condition is applied.
To designate a condition within a postback message, select it then click Conditional Section ().
Prerequisite: Obtain the folder and hyperlink name from your administrator who set up an action page.
To redirect submitted form data to an action page:
When you create polls and surveys, you can choose to display the results after a site visitors completes the form. The results can display in the same window or a new window. In addition, you can choose how to chart the data. See Chart Types.
To show site visitors poll/survey results:
WARNING! Data entered into a text box cannot be charted. For example, if one choice in a poll is Other, and the survey has a text box for site users to enter additional information, the text in the box is not charted. However, the fact that a user chose Other is charted.
If a form is set to store data in the database, you can run a report that displays the submitted data.
The submitted form data can be viewed in any of these formats.
The table of values shows the following information for each completed form.
The siteroot\Workarea\controls\forms\FormReportTotals.xslt
file has a largeListSize
property that affects this report's display. By default, this property's value is 5, but you can change it as desired.
If the number of form responses is less than the largeListSize
value, the report lists all responses. In the sample report above, the question Age range has 3 possible responses:
On the other hand, if the number of form responses exceeds the largeListSize
value, the report only displays responses that have data. A response accumulates data when a site visitor selects it.
The table of values shows the following information for each completed form.
The List of Submitted Values format provides the same information as the Table of Values, but is formatted vertically rather than horizontally. See Also: Table of Values
Displays the results of the form in an XML format. The following information is included:
<Title>
—title of the form blockWARNING! With polls you can create a new poll question to replace an existing poll question. By default the poll still has the same Title, ID, and other properties. You can change the title of a new poll question when you are editing the poll.
<Description>—
description of the form<SubmittedData>
—information that was submittedAfter you run a report, you can export its data to a Microsoft Excel spreadsheet file (.xls) for further analysis. If a form uses an XML structure, each XML tag becomes a column header in the spreadsheet.
While tasks typically help Ektron users track content activities, you can also assign a task to users or user groups whenever a form is submitted.
For example, your Web site offers a free product demonstration to anyone who completes a form. Whenever a site visitor submits the form, a task is assigned to your sales department’s administrative assistant who uses the form information to schedule a demonstration. The sales manager can review the task history to audit sales leads and ensure demonstration requests are being handled in a timely manner.
To set up a task that it is assigned to users or groups whenever a site visitor completes the form:
NOTE: You should be familiar with tasks before beginning this procedure. See Also: Assigning and Managing Tasks
When a site visitor completes and submits the form, Ektron creates a task and assigns it to users and groups you identified in Step 1. The task created upon form submission has the following information.
An email is automatically sent to every specified user who has a valid email address in the User Information Screen. The email’s subject line is the form name. The body of the email contains a name and a value submitted by the user for each field on the form.