Wait For Validation

<< Click to Display Table of Contents >>

Navigation:  Trigger Actions > Available Action Types > Outgoing Messages >

Wait For Validation

Waits for a validation URL to be accessed before proceeding with the remaining actions for the Trigger.

 

The Validation Action is used to provide a human validation response in the form of a unique URL that must be accessed. ThinkAutomation will pause execution of the Actions for the current message until the validation is performed. It will move on to process the next message whilst waiting for the validation of a previous one. A single Trigger can contain multiple Validation actions. This action can optionally show a form containing any number of input fields. If any fields are specified then the user must complete the form before validating the message. The results of the form are passed back to the Trigger and can be used in subsequent actions

 

action-validation

 

For each Validation request ThinkAutomation creates a unique Validation URL. You must send an email or SMS containing the %msg_validationurl% field replacement to someone or provide the URL in some other manner (write it to a HTML file for example). When the recipient receives this email they click the URL to validate the message. Once validated the remaining actions setup on the Trigger are then executed for that specific message. Validation URLs are secured using a one-way hash, so a user could not validate the wrong message by manually changing the URL.

 

You can either use separate Send An Email or Send An SMS Message actions to send you own message containing the %msg_validationurl% field (send before the Wait For Validation action itself) or enable the Send Validation Request Email option to include the email sending within the Validation action itself. You then need to specify the From, To, Subject and Body. The Body text must contain %msg_validationurl% somewhere.

 

Max Wait Time (Mins)

 

This is the maximum number of minutes that ThinkAutomation should wait for the validation. It defaults to 2880 (48 hours).

 

Timeout/No Accept Action

 

You must specify what ThinkAutomation should do if a validation response is not received before the Max Wait Time or the user clicks the 'Not Accept' button if the Show Accept/Not Accept Buttons option is enabled.

 

The options are:

1. Don't Execute Remaining Actions & Save Message In Message Store.

2. Execute Remaining Actions & Save Message In Message Store.

3. Don't Execute Remaining Actions & Drop Message From Message Store.

4. Pass To Another Trigger & Drop Message From Message Store.

 

You can use the Pass To option to execute another Trigger in the event that the Validation is rejected or expires.

 

Validation Page Text

 

This is the message that will be displayed in the users browser when they click on the Validation URL to validate a message. It can contain %field% replacements. You can specify custom text for the following:

 

Message

The main message that is displayed at the top of the validation page. You can use HTML tags in this entry.

Header

The heading text. If you set this value to [none] then the header will be hidden. If not specified the default will be used.

Title

The page title (the <title> tag). If not specified the default will be used.

Accepted

The message this is displayed when the validation is accepted. If not specified the default will be used. HTML tags can be used.

Not Accepted

The message that is displayed when the validation is rejected (the Do Not Accept/Cancel button is clicked). If not specified the default will be used. HTML tags can be used.

Accept Button

The Accept Button text.

Do Not Accept Button

The Do Not Accept button text.

 

Show Accept/Not Accept Buttons

 

If this option is enabled then the Validation page will show Accept & Not Accept buttons below the Validation Page Message. The user must click the Accept button to validate the message. If the Do Not Accept button is clicked then the message is rejected and the Timeout/Not Accepted Action performed. If this option is not enabled then the user only needs to click the Validation URL to validate the message (unless input fields are used - see below). You should adjust the Validation Page Message accordingly.

 

Ask For Input Fields

 

In addition to displaying a message, ThinkAutomation can optionally show a form containing any number of input fields. If any fields are specified then the user must complete the form before validating the message. The results of the form are passed back to the Trigger and can be used in subsequent actions. Click Add Field to add a new input field.

 

action-validation-input

 

Enter a Name and Prompt Text. The Field Type can be Text, Number, Date, Time or Boolean. For text field types you can specify the Max Length. The Multi-Line option allows you to define the maximum lines. The Password Entry option allows you to mask the input.

 

The Edit Mask can be used to supply a regular expression to use as an input mask to format and limit what can be entered.

 

Assigning To A Field

 

You must then select a ThinkAutomation field or variable to assign the entered value to. Select the field/variable from the Assign Entered Value To drop down. Once a message is validated and the Trigger continues execution you will be able to make use of input values in subsequent actions.

 

A simple example would be a single field that asks 'Do you want to process this message' - with a Y/N choice. The value can be assigned to a Variable called 'Continue'. After the Validation Action you can add a conditional End Processing Action: 'If %Continue% Is Not Equal To Y End Processing'

 

The Attributes tab enables you to set additional attributes for the field:

 

action-validation-input2

 

You can specify a Default value that will be assigned to the field if the visitor does not enter anything.

 

The Case option enables you to change the Case of the field value.

 

The Validate option enables you to apply validation against the field value:

Cannot Be Blank Or Zero - the visitor must enter something.

Must Be In The Numeric Range - for number fields the value must be in the specified range.

Must Be A Valid Email Address - you can specify that the field will only accept a valid email address.

Must Be In List - you can specify a list of possible values that are allowed. Separate the choices with a | character. If the list starts with a ~ character then the list will be presented as a drop-down list. Otherwise the list will be presented as Radio buttons.

 

The Skin selector can be used to change the appearance of the input fields form.

 

Notes: The ThinkAutomation Web Services must be configured and the Web Services URL correctly specified in the program options for the validation URL to work correctly.

 

See Also: Customizing The Validation Response Page

ThinkAutomation © Parker Software 2016