Page Comparison

...

...

Anchor
opening_a_form opening_a_form

Opening a Form

In the Interactive Forms dialog, interactive forms appear in the left-most column. Forms can be arranged in categories in order to make it easier to find and manage them, especially when your project contains a wide variety and/or large number of forms.

To open a form for editing, click it in the list. For example:

Image Removed
 Image Added

The form is opened in the right pane and is ready to be modified. As is the case with pages and page sections, only one user is allowed to have write access to an interactive form at the same time. To avoid conflicts between users, XperienCentral makes use of form locking. Whenever a user is busy modifying an interactive form or form section, all other users will see a visual indication that the form/form section is locked. When a form/form section is locked, its icon has a padlock attached to it. For example:

Image RemovedImage Added

In the image above, the form "Change Password" is being modified by another and is locked. If you click a form/form section that is locked, you will see the following message:

Image Removed
 Image Added

If you click [Preview], you can view the form/form section in read-only mode. If the icon for a form is red, that means that you do not have permission to edit that form due to the workflow assigned to your role. For example:

Image RemovedImage Added

Back to top

...

Managing Steps

This section describes how to manage steps. For complete information on step properties (handlers, routers, etc.) see Form Step Properties. Steps in a form flow from the first to the last in the order they are arranged from left to right. For example:

Image RemovedImage Added

Creating a New Step

To create a new step, click the plus button (+) above the step pane. A new, empty step will be created. By default the name of the new step is "Step x" where x is one value higher than the current number of steps in the form. For example, if there are four steps, the name of the new step will be "Step 5". The new step is placed after the last step in the form in the far right position. For example.

 Image Added Image Removed

Navigating Between Steps

To scroll between steps, click the left or right arrow above the step pane. Click on the tab of a step to set focus on that step. To select a step to navigate to from a list, click the step drop-down button above the step pane and select the step you want to jump to from the drop-down list.

...

1. To delete a step, click the "x" to the right of the step name.
2. Click [OK] at the prompt to confirm the operation.

Back to top

...

Managing a Form's State

As with content items, forms and form sections created with Interactive Forms have a specific workflow state that determines whether they can appear on the front-end frontend of your website. A form and form section can have one of the following three states:

The state of a form can be visually determined by the text that is used to render it in the "Forms" tree. The name of a form in the "Active" state appears as normal text. The name of a form in the "Inactive" or "Development" state appear in italic text. To change a form's workflow state, follow these steps:

1. Select the form from the "Forms" tree.
2. From the drop-down list next to "State" above the "Properties" pane, select the new state for the form.
3. Click [Apply] or press <Alt-S>.

Back to top 

...

Form Versions

You can create multiple versions of a form/form section, which makes it possible to modify a form or form section without it becoming unavailable or to be able to quickly switch between different versions. Only one version of a form/form section can be active at a time. To create a new version of a form/form section, follow these steps:

...

The forms/form section version summary shows the following:

Form Version Details

To see more details about a form version, you can click it in the list. After clicking the form version, the following details will appear: 

Switching Versions of a Form/Form Section

...

1. Select the form/form section from the "Forms" or "Form Sections" tree.
2. Click the "Version x of y" link above the "Properties" pane.
3. In the summary, click the name of the form version you want to switch to. The form/form section version you selected now displays.
4. To make this version of the form the active version, select "Active" from the "State" drop-down list.
5. Click [Apply]. In the form versions summary, the version you selected is now in the "Active" state and the previously active version of the form is automatically set to "Inactive" because only one version of a form can be active at a time.

Deleting a Form/Form Section Version

...

Anchor
deleting_a_form_version deleting_a_form_version

Deleting a Form/Form Section Version

To delete a version of a form or form section, follow the steps below. Note: To delete a form/form section and all its versions in one operation, see the section Deleting a Form.

1. Select the form/form section from the "Forms" or "Form Sections" tree.
2. Click the "Version x of y" link above the "Properties" pane.

3. Click the checkbox next to the version or versions of the form you want to delete.

   Note:

   
   
   

   Note
   You cannot select the currently active version of a form.

   
   
   

4. Click [Delete]. The version is deleted.
5. To select all versions (except the active one), click the checkbox next to "Name". This selects all versions except the currently active one.
6. Click [Delete].

Back to top 

...

Anchor
language_versions language_versions

Language Versions

Just as with pages and page sections, you can maintain forms/form sections in more than one language. This makes it possible to quickly and easily create a form/form section and then present it in multiple languages. When you create a form, you must select a language for the form. For each of the supported languages, the form also exists, however, when you first switch to a different language version of a form, the form elements have blank labels as does the form itself. Unlike pages and page sections, different language versions of a form always have the exact same form element structure and content. The only difference between language versions of a form are the language labels that appear above each form element. For example:

Image Removed  
Image Added

All language versions of a form share the same state. It is not possible, for example, to assign the state of "Active" to one language version of a form and "Inactive" to another. There are two ways to manage the labels for language versions of a form: In the form itself and using Language Labels. Both methods are described below. 

Managing Language Labels in a Form

...

Managing Labels using Language Labels

Another method of for managing form element labels for a language version is in the Language Labels dialog box. The advantage to this approach is that you can more quickly add/modify language labels for a form language version as well as for multiple versions of the form in the same language. In addition to the titles of the form elements, you can also quickly and easily manage the "Help Text" and "Extra Text".

...

1. Navigate to Language Labels > Language Labels.
2. From the "Language" drop-down list, select the language of the form you want to manage.
3. From the "Form" drop-down list, select form whose labels you want to manage.
4. Select the version of the form as well as the step containing the form elements whose labels you want to modify. The labels for the form appear. For each form element, the following is shown:
   • The unique identifier for the form element
   • The title of the form element
   • The "Help" and "Extra" text for the form element
5. Modify the field or fields that you want and then click [Apply]. The labels are changed for the language version and form version.

Back to top 

...

Duplicating a Form

With Interactive Forms you can create a duplicate of a form. All the form steps, form elements, and their properties are copied exactly. When you duplicate a form with multiple versions, only the currently active version will be duplicated. To create a duplicate of a form, follow these steps:

1. Select the form that you want to duplicate from the "Forms" tree.
2. Navigate to Forms > Duplicate. The form is duplicated. By default the name is "Duplicate of <form name>.

Back to top 

...

Anchor
deleting_a_form deleting_a_form

Deleting a Form

To delete a form, follow the steps below. Note: Following the steps below results in the deletion of a form and all its versions (if there are any). If you want to just delete a version of a form, see the section Deleting a form versionForm Version.

1. Select the form you want to delete from the "Forms" tree.
2. Navigate to Forms > Delete.
3. Click [OK] at the prompt to confirm the operation.

Back to top

...

Previewing a Form

To preview how a form will appear to a website visitor with your design template, follow the steps below. Note:

1. Select the form you want to preview from the "Forms" tree.
2. Navigate to Forms > Preview. A lightbox will appear with the name of the form.
3. Click the link for the form. The form as it will appear in your design template for visitors of your website will be shown.

Back to top

...

Form Overview

Form overviews show a summary of the handlers and routers in the steps of a form. The summary that appears in the overview is identical to the handler/router summary that appears in the "Step Property" pane. Note:

To see the overview of a form, follow these steps:

1. Select the form whose overview you want to see from the "Forms" tree.
2. Navigate to Forms > Overview. The overview appears. The name of the step(s) is shown in the gray box. The handlers and routers are shown below the step name. If a step has no handlers or routers, only a "-" is displayed
3. To navigate to a step, click its link. The overview of the form closes and the step you selected appears in the Interactive Forms interface.

Back to top 

...

Publication/Expiration Date

...

1. Click the date picker icon next to the "Publication Date" field:
   Image Removed
   
   Image Added
   
   
   
2. Select the day and month when the form/form section will be published.
3. Highlight the time of day in the "Time" field and enter a new time. For example:
   Image Removed
   
   Image Added
   
   
   
4. Click [Apply].
   
   
   

...

1. Click the date picker icon next to the "Expiration Date" field:
   Image Removed
   
   Image Added
   
   
   
2. Select the day and month when the form/form section will expire.
3. Enter the time of day that the form/form section will expire.
4. Click [Apply].

Back to top

...

Interactive Forms Workflow

...

In addition to assigning the activities that each role may perform globally for a specific workflow model, you can also assign the roles that are allowed to perform specific activities at the category level. For example, you can specify that all users may create a new form in the category "E-mail" while for the category "Financial" only Application Managers and Main Editors may create a new form. 

Selecting the Default Workflow for all Interactive Forms

The Interactive Forms component must have a workflow assigned to it. The default workflow that is assigned to the Interactive Forms component is used for all forms and form sections that do not use a custom workflow that is assigned to a category. Important Note:

To assign the default workflow model to the Interactive Forms component, follow these steps:

1. In the Interactive Forms module, navigate to Maintain > Workflow.
2. In the "Select Workflow Repository Model" section, select the default workflow model for interactive forms/form sections.
3. Click [Apply].

Anchor
adding_roles_to_activities adding_roles_to_activities

Adding Roles to Activities

Each activity that a user can perform in the Interactive Forms component has one or more default roles assigned to it. You can add a role to an activity in order to expand the class of users that may perform a specific task. The following are the three activities to which you can assign roles:

To add a role to an activity, follow these steps:

1. In the middle column of an activity section, expand the drop-down list and select the role you want to add to the activity. For example:
   Image Removed
   
   
   Image Added
   
   
   
   
2. Click [Apply]. The role is assigned to the activity. For example:
   Image Removed
   
   
   Image Added
   
   
   

Deleting a Role from an Activity

...

1. In the "Delete" column of an activity section, select the role that you want to delete. For example:
   Image Removed
   
2. Click [Apply]. The role is deleted from the activity.
3. 
   
   Image Added
   
   
4. Click [Apply]. The role is deleted from the activity.

Anchor
defining_a_custom_workflow_for_a_category defining_a_custom_workflow_for_a_category

Defining a Custom Workflow for a Category

You can create a customized workflow that is applied to all forms/form sections within a category. This allows you to define permissions for maintaining the forms/form sections within the category that are different from the default workflow used for all interactive forms. To create a custom workflow for a category, follow these steps:

1. Navigate to Maintain > Categories.
2. In the "Workflow" section, select "Define custom workflow".
3. Select the workflow repository model on which to base the custom workflow from the "Based on workflow repository model" drop-down list.
4. Follow the steps in the section Adding Roles to Activities for complete information about assigning roles to activities for the customized workflow for the category.
5. Click [Apply].

Back to top 

...

Anchor
prefilling_a_form_element prefilling_a_form_element

Prefilling a Form Element

...

1. Click the form element in the step pane which you want to prefill.
2. Expand the properties for the form element by clicking the expand button.
3. Under "Prefilling" select "1-Default" from the drop-down list.
4. In the text box, enter the string that you want to prefill the form element with.

On the website front-endfrontend, the form element will be prefilled with the text you enter. The website visitor can modify the text if they so desire.

...

1. Click the form element in the step pane which you want to prefill.
2. Expand the properties for the form element by clicking the expand button.
3. Under "Prefilling" select "2-Free Expression" from the drop-down list.
4. Type the free expression in the text box. For complete information on the Interactive Forms internal script and the use of free expressions, see the section Scripting in formsForms.

Back to top

...

Anchor
form_element_validations form_element_validations

Form Element Validations

...

• Period (.)
• Comma (,)
• Spaces

Note: This validation is specific to Dutch bank account numbers.

Check BSN

The Check BSN (Burger Service Number) validation checks to ensure that the BSN entered by the website visitor is valid. The BSN can contain only digits and must be nine digits long. Spaces and commas are also valid. If the BSN number does not comply with the required BSN number regulations, an error message appears in the form when the visitor attempts to submit it. Note: The BSN number is specific to The Netherlands.

Check Date

The Check Date validation checks to ensure that the date entered by the website visitor is valid. If the date entered by the website visitor us not valid, an error message appears in the form when the visitor attempts to submit it. A valid date is of the form "dd/mm/YYYY". The Check Date validation is assigned to the Date form element by default.

...

The Check File Type validation analyzes the file being handled by the form element to verify whether its content matches the expected content given the MIME type that is declared in the validation. This is a security feature which ensures that a file containing malicious code cannot be masked and, for example, uploaded to the web server. This validation is assigned by default to the Upload form elementForm Element.

Check ID Cardnumber

The Check ID Cardnumber validation checks whether the identification number entered by the website visitor is valid. A valid ID number begins with the letter "i" followed by a letter between "a" and "z" followed by 7 integers between zero and nine. Note: This validation is specific to the Dutch national identification card.

Check KvK Number

The KvK (Kamer van Koophandel) validation checks whether the KvK number entered by the website visitor is valid. A valid KvK number consists of 8 integers. KvK numbers are specific to incorporated Dutch entities.

Check Number

The Check Number validation checks whether the number entered by the website visitor is a valid integer containing no letters or other illegal characters. Decimal points are accepted and commas are not. The number can be positive or negative.

Check Number Range

The Check Number Range validation checks wither the number entered by the website visitor falls within the specified range. After adding the Check Number Range validation, two required fields appear entitled "minimumValue" and "maximumValue" appear. Enter the minimum and maximum values expected for the number the website visitor should enter and then click [Apply]. Integers are accepted as well as a decimal point. The range can also contain both positive and negative number.

Check Passport Number

The Check Passport Number validation checks whether the passport number entered by the website user is valid. A valid passport number must begin with two letters, the middle six characters letters or numbers, and the last character a number. This validation is specific to Dutch passport numbers.

Check Phone Number

The Check Phone Number validation checks whether the telephone number entered by the website visitor is valid. A valid telephone number begins with a "+" and country code or "00" and the country code followed by nine numbers. This validation is valid for Dutch landline and mobile telephone numbers only.

Check Postal Code

The Check Postal Code validation checks whether the postal code entered by the website visitor is valid. A valid postal code consists of six characters: four numbers followed by two letters. This validation is valid for Dutch postal codes only.

Check Regular Expression

The Check Regular Expression validation parses a regular expression entered by a website visitor in order to check whether it is a valid regular expression. For complete information on regular expressions see http://en.wikipedia.org/wiki/Regular_expression.

...

^([01][0-9][0-9]|2[0-4][0-9]|25[0-5])$

Compare with other Field

The Compare with other Field validation allows you to check whether the input in the current field is identical to that entered in another specific field. After adding the Compare with other Field validation, a required drop-down box entitled "Compare with" appears. Select the field whose input you want to compare to the current field from the drop-down list.

E-mail Format

The E-mail Format validation checks whether the email address entered by the website visitor is valid. The E-mail Format validation is assigned to the E-mail form element by default.

Required

The Required validation checks whether the website visitor has entered data into a field that is required. Note: Assigning this validation to a form element has the same effect as checking the option "Required field" of the form element.

Back to top 

...

Anchor
form_sections form_sections

Form Sections

A form section is a sub-form that you can reuse in two or more forms. This is especially useful when you have two or more forms that share identical sets of form elements (sections) — You only have to create the section once and then you can reuse it in multiple forms.

Image RemovedImage Added

Form sections contain only one step. Just like forms, form sections can have validations, handlers, routers, conditions, and so forth.

Form sections are created and managed in the "Form Sections" tab, located below the "Forms" tab. To open the "Form Sections" tab, click "Form Sections" in the lower left part of the Interactive Forms dialog box. When the "Form Sections" tab opens, you will see the same category tree structure that appears in the "Forms" tab. The number of form sections that belong to each category appears between parentheses. Managing form sections is identical to managing forms (besides having multiple steps).

A form section can only be modified by one user at a time. For avoid conflicts, XperienCentral locks a form section when it is being edited, which means that other users cannot open it and modify it. See Opening a Form for complete information. 

Back to top