Redirect action
Use the Redirect action to redirect to a form, or a URL or open the new message window of the user's email client.
You can create a Redirect action for an event such as a button-click, to redirect the user to a form, URL, another page, the original page, or to a pop-up window.
You can also use a form field or variable to dynamically redirect the user at runtime, based on a URL that you specify.
When redirecting a control or a form, you can pass data from the original page to the destination page by mapping the fields on the source page to the required fields on the destination page.
-
On the form modeling bar, click
Actions and click
New.
The New action dialog box is displayed.
- On the Type list, select Redirect.
- Change the default Name (Redirect1) to something meaningful.
- Optional. Enter a Description for the action.
- Optional. Select Multilingual to configure a unique action for each language separately. See Configure multilingual actions.
-
On the
Redirect to list, select one of the options to configure where to redirect
and how to display the form.
Option Description Form
Use this option to redirect to another form:
-
On the Target list, select the required form.
- Map the initialization variables by selecting the global variables or providing static values in the Value fields.
For a phone or tablet version of the form, ensure that the selected form has the same control names and initialization variables as in its desktop form.URL
Use this option to redirect to an external form/URL or new email:
-
In the Target box, enter the target location for the form.
-
Create custom initialization variables if required:
- In the Variable name box enter a name for the variable.
- Provide a dynamic or static value in the Value box.
- Click Add.
You can use the redirect action to open an email program by using the Mailto option in the URL. For example; mailto: someone@test.com. You can define the default subject, body, cc, and bcc by adding initialization variables of those names and corresponding values.Origin
Use this option to redirect back to the original page where the current page was launched.
If the form is on the first page and has no origin, no redirect occurs; it remains on the same page.To traverse through the form history, select Use breadcrumb trail. (Default: Clear. For forms that drill down into subjob properties and case fragments, the default setting is selected in the Redirect action.)
Consider a scenario where Form A redirects to Form B, which in turn redirects to Form C.
-
If Use breadcrumb trail is clear, return to origin from Form C will bring you to Form B, and return to origin from Form B will bring you to Form C. This means that you continue to navigate between the current and the previous form as the origin of one form is always the previous form.
-
If Use breadcrumb trail is selected, return to origin from Form C will bring you to Form B, and return to origin from Form B will bring you to Form A. This helps you to find your way back to the start of the process (origin form) and not just the previous step (previous form).
Dynamic
Select this option to specify a dynamic redirect target:
-
Select the required form variable, global variable, or form field, in the Target box.
-
Create custom initialization variables if required:
- In the Variable name box, enter a name for the variable.
- Provide a dynamic or static value in the Value box.
- Click Add.
When a form name is extracted from a column or a form field, it is prefixed with 'http://' if necessary. For example, www.kofax.com would become http://www.kofax.com.
Once you enter the URL (at runtime), press ENTER to refresh the embedded page.
-
-
To select a Window type where the redirected form should appear, select one of the options for
Display in.
Option Description Same window Redirects the form to the same window.
Popup window Displays the form as a pop-up. You can further configure the pop-up window for a better display of information. See Configure a Pop-up window.
New window Displays the form in a new window.
Current view The current view of the form opens; a toolbar appears at the top that includes a Back button at the left.
-
If you select to redirect back to "Origin", the options for "Display in" are not available for non-touch and desktop forms.
-
For mobile and tablet forms (touch), only the Same window and Current view options are available.
-
When redirecting within the current view, the forms must be within the same context, that is in the same site, using the same header and footer, and using the same navigation.
-
The Selection changed event is not supported on a drop-down list for a touch form if the form is redirected to the same window or within the current view.
-
-
Select
Ignore redirect confirmation if you want the redirect action to leave the
page without displaying a confirmation message. In such a case, the activity is not canceled. But, for a Capture activity, the
cache is not cleared.
If you clear this option, the activity is canceled for Ordinary and Capture activity forms, and the documents are removed from the cache for a Capture activity form.
For any Redirect action that comes after completing, saving, or canceling an activity, "Ignore redirect confirmation" must be selected, otherwise, an error occurs. The activity is only canceled on redirect if the Redirect Confirmation prompt is displayed and if you have chosen to leave the form.
-
Click
OK.
The newly created action is added to the table.
- Click Add.
-
Associate the action with the control to trigger this action. See
Configure actions for form control
events. Alternatively, to call this action for a form event, associate the action with the form. See
Associate an action with a form.
When a touch-enhanced form is redirected to another form with a header, at runtime:
-
The form loads in the main area of the screen.
-
The header appears.
-
A Back button appears in the toolbar to navigate to the parent form.
-
Configure a pop-up window
-
Select the pop-up window
Type as Modeless or Modal (default: Modal).
- Modeless: Allows the user to click outside the pop-up window to close the pop-up window and return to the main form.
- Modal: Prevents the user from clicking on the main form unless they have closed the pop-up window.
- Specify the Width and Height of the pop-up window (default: 800x500).
-
On the
Control to return data and close list, select a control to populate data
and close the pop-up to return to the main form.
Populating data is supported only by a single pop-up.
- Map the initialization variables by selecting dynamic variables or providing static values.
- Click Save.
See also: