Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Forms consist of one or more steps, each of which contains form elements. The form elements are the basis of the form's interface. By default, Interactive Forms contains eighteen elements that you can use to build the interface of each step in a form. In addition to the form elements, there are also Handlers, Prehandlers, and Routers that you can define that can execute actions based on what a visitor enters in a form step.


Note

The number of form elements can also be extended by a developer to offer more form options. This section only describes the use of the default Interactive Forms form elements.

In This Topic

Table of Contents
maxLevel2


...

Opening Interactive Forms

Forms in XperienCentral are created using the Interactive Forms component. To open the Interactive Forms user interface, navigate to Configuration > Interactive Forms.

...

To create a new form, follow these steps, navigate to Forms > New.


Image RemovedImage Added


The "Forms" interface consists of the following parts:

  • The title of the form. This is the title of the form as it appears in the "Forms" pane.
  • Palette containing the form elements used in steps to define the content of the form.
  • The step pane in which form elements are arranged.
  • The version of the form you are viewing.
  • The state of the form. There are three possible states: Development, Active, and Inactive.
  • The title of the step.
  • Toggle between showing all or a subset of form element properties.

Changing the Title of an Interactive Form

  1. Highlight "New Form" in the "Title" text box.
  2. Enter a title for the form.
  3. Click [Apply] or press <Alt-S>. Notice that the title of the form is now reflected in the "Forms" pane.

In This Topic

Table of Contents
maxLevel2


...

Adding Form Elements to a Step

...

For example, clicking the Date form element adds it to the step:


Image RemovedImage Added


To add a form element using drag and drop, click the form element with the left mouse button and keep the left mouse button depressed, drag the form element with help of the "Helper" block onto the "Step" pane and onto the dotted rectangle and then release the left mouse button to drop the form element onto the step.

...

Note

Application Managers

  • The directories where uploads may be stored must first be configured in the General tab of the Setup Tool. By default, no valid file upload directories are configured. See file_upload_valid_directories for more information.
  • By default, the Upload File element has the Check File Type and Check File Extension validations assigned to it. These cannot be removed and for security reasons, GX strongly recommends that you fill in the valid fields for these validations.

...

Note

If the last step in the form has the purpose of thanking the visitor for completing the form, then do not place a "Back" button on this last step. For each visitor, Interactive Forms keeps track of the visited steps, but will clean up this information when showing the last step of a form. If the visitor clicks a "Back" button on the last step, then he they will be routed back to step 1 because at that point the history of visited steps is not available anymore.

...

PropertyDescription
TitleThe text that appears next to the password input field in the step pane and in the form on the frontend.
Show titleSpecifies whether to show the title of the form element in the step pane and in the form on the frontend.
Design templateSpecifies the design template to use to render the form element on the frontend. This property will only be available if there are two or more design template for the form element.
Identifier

The unique identifier to use for this form element. The unique identifier is used in expressions for (pre)filling and (pre)conditions. Click here for information about renaming an identifier.


Note

GX Software strongly recommends that all form fragment identifiers be unique.


PreconditionThe precondition decides in what situations the form element will be visible to the website visitor.
CSS classnameSpecifies the CSS class to use for rendering the form element. This option allows you to alter the how selected form elements appear in the form without globally altering the presentation.
Fragment TagA unique tag to identify the form fragment. This tag is rendered in the form fragment presentation as a custom data attribute of the form fragment itself. The attribute name is data-fragment-tag. When filling out this property for a form fragment, the attribute is added to the presentation and can be used by external applications like GX Software's BlueConic.



Back to top


...

Using the

...

Interactive Forms Clipboard

You can copy one or more form elements to the Interactive Forms Clipboard and then paste them in the current form or in another form/form section. You can also copy handlers, routers and conditions. To use the Interactive Forms Clipboard, follow these steps:

  1. Hover the mouse over the "copy" icon in the upper right corner of a form element:
    Image Removed

    Image Added  


  2. Click the ‘Copy to Clipboard’ icon. In Firefox, an animation showing a copy of the form element being moved to the Clipboard plays. For example:
    Image Removed
    A copy of the form element is now stored in the Clipboard and the Clipboard icon turns light blue to indicate it contains one or more items.

Pasting from the Interactive Forms Clipboard

  1. To place paste a form element, handler, router or condition from the Clipboard in a form step in a form, click the Clipboard icon. Notice that as you hover the mouse over the Clipboard icon, a tool tip appears that informs you how many elements are currently on the Clipboard:
    Image Removed

    Image Added


    After you click the Clipboard icon, the contents of the Clipboard and the Clipboard menu display. For example:
    Image Removed

    Image Added



  2. Select the form element from the menu item that you want to paste in the form. The form element will be placed after the last form element in the current step.
  3. To paste all elementsitems, select "Place all elements" from the menu.
  4. To empty the Clipboard, select "Empty clipboard" from the menu.



Back to top

...