Form Actions‎ > ‎

Message

Action Form allows you to set actions to display confirmation and error messages after the user submits the form. With these actions you can use tokens, for example [Name], and My Tokens to apply a confirmation message in the Message text box. Every form should have a confirmation message in order to inform the user whether the form data was successfully sent or if there were any errors. 



Display Message

This action does exactly what it says. It displays a message after the form is submitted. What you can configure:
  • Message. In this text box you can input your message that will be displayed after the form is submitted. Example: "Thank you for contacting us. Your message was successfully sent." This field also supports My Tokens. This option is also one of the simplest and fastest ways for debugging. Populate it with tokens and see if a form is working correctly.
  • Action Buttons. Optionally, you can bind one or more buttons from the form. For example, you can add a button and set an action on it to redirect to another page or to download a file.    


Update Form Data (AJAX)

This action sends current context back to the browser, updating the form fields.

Display Error Message

This action displays a message if there are some errors while the user is trying to submit the form. It's similar to Display Message action except that you cannot add a button. This action, along with Display Message, can also be used in the section "On Validation Failed". Here's what you can configure:
  • Message. In this text box you can input your message that will be displayed if there are errors when the form is submitted. Example: "Errors occurred while sending the form. Please correct the errors and try again.This field also supports My Tokens.



Display Toast Message


This action displays a simple notification/information to a user in a small popupIt only fills the amount of space required for the message to be displayed and the current activity remains visible and interactive. Toasts automatically disappear after a set timeout. What you can configure: 
  • Heading - Optional heading to be shown on the toast. Supports My Tokens;
  • Message - the text contained by the Toast Message. Supports My Tokens;
  • Type - multiple types of messages: default, warning, success, error, info; 
  • Background Color - the color of the displayed message (eg. red #00ff00 rgb(0,0,255)). Each Type has a default background color, leave this option unset to use the default. Supports My Tokens.
  • Transition - it can be set on: fade, slide, plain; 
  • Allow toast close - Enable (x) to close the toast at will;
  • Hide  (with transition^) after (ms) - time in which the toast will close automatically. Time is in milliseconds. Supports My Tokens
  • Stack Length - 1 if there should be only one toast at a time or a number representing the maximum number of toasts to be shown at a time. Supports My Tokens;
  • Toast Position -  it can be set on: bottom (left, right, center), top (left, right, center), middle center;
  • Text Alignment - it can be set on: left, right, center;
  • Show Loader - displays a progress bar;
  • Loader Color - the color of the progress bar (eg. red #00ff00 rgb(0,0,255)). Supports My Tokens.



Send Plain Text as File Download

Action Form has the option to Send Plain Text as File Download. Go to Manage Form, add Field, Button, Message, Send Plain Text as File Download. You can use one of several file types: CSV, HTML, XML, TXT, XSL.

Some of them require specific formats to work. For example,

1. XML

<test>
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Fusce mattis a orci laoreet pretium. Mauris scelerisque vel enim ac dictum.
</test>


2. XSL

XSL
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

<xsl:template match="/">
  <xsl:for-each select="test">
    <xsl:element name="hello; test">
      <xsl:value-of select="Neque porro quisquam est qui dolorem ipsum quia dolor sit amet, consectetur, adipisci velit" />
    </xsl:element>
    <br />
  </xsl:for-each>
</xsl:template>

</xsl:stylesheet>


3. HTML-specific styles can be used for this format.


<body style="background-color:lightgrey">

<h1>This is a heading</h1>

<p>This is a paragraph.</p>

</body>

Additionally, MyTokens can be used as value of text.

For example, 

XSL
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

<xsl:template match="/">
  <xsl:for-each select="test">
    <xsl:element name="bla bla; test">
      <xsl:value-of select="[FirstName]" />
    </xsl:element>
    <br />
  </xsl:for-each>
</xsl:template>

</xsl:stylesheet>

if a field called First Name exists.

Also, expressions can be used besides the available formats, like for example docx.

If you want the browser to automatically start the file download, then check the Force download option. This option, however, is conditioned by the browser.

Display a message depending on a selected value of a check box

If you have two check boxes and for each one of them you want to display a different message depending on the user's selection, you can simply do the following steps in the Action Form:

Let's say the logic in this is:

If Checkbox = "Option A" Then

Display "A

Else

Display "B"

Steps:

1. add a Multiple Choice with Check box field on the form; 

2. set the Items you want to display (e.g. Yes, No); 

3. add a Static Text field to insert the wanted content; so when the first option is checked you should set the FieldID token of the check box in question equal to the value of the first Item "Yes", on Show (Bind Expressions):

[Sync] == "Yes" 

4. add another static box with a message which will display when the second option is selected and on Show field you have to set practically the same value as above but changed to the value of the other Item: 

[Sync] == "No" 

5. save these modifications and get back on the form page and select either one of the two options to see if the messages are properly displayed according to the selected item. 


Display a message/box when 'option 1' and 'option 1' + 'option 2' are checked

If you need to make a check box with, let's say, two options and when option 2 is checked you want to display a message, in order for the message to be also displayed when you check option 2 and option 1, you need to:

1. add a Multiple Choice with Check boxes field and set in Items 

option 1
option 2

2. add a text box field and on Bind Expressions Show box set:

[Checkbox] == 'option1'||[Checkbox] == 'option1,option2'

Display a message when more than one box is checked

1. Add Multiple choice with Check boxes field on your form > add as many items as you need;

2. Add a Static text field > set the message you want to display whenever Option1 is selected;

3. If you want the message to remain displayed when Option2 and Option3 are checked besides Option1 you can set on the Static text field on Show field the following: form.fields.Checkboxes.options[0].selected 

Display an error message when not all options are checked in Multiple Choice (with CheckBoxes) field

Solution1:

Add a Multiple Choice (with Checkboxes) with name Checkboxes and Items:item1, item2, item3
In a Submit Button add the Display Error Message action, in Condition add the syntax : _.isEqual([Checkboxes].sort(), ["item1","item2","item3",...].sort()) and in Message add: Please check all options, as illustrated below:


Solution2:

Add a Multiple Choice(with CheckBoxes) with name Checkboxes and Items:item1, item2, item3
In a Submit Button in Bind Expressions, in the On Change/ Click option add this syntax:


if(_.isEqual([Checkboxes].sort(), ["item1","item2","item3",...].sort()){
   return true;
} else {
   alert ("Please check all options");
   return false;
}


Show the items - and not the values from a DropDown with Checkboxes - in a Display Message action

Add a Multiple Choice (DropDown with Checkboxes) field with items:

item1|a
item2|b
item3|c

In Bind Expressions, in Value add this syntax: form.fields.Dropdowncheckboxes.value

Add a Hidden field and in Bind Expressions, at Value add this syntax: form.fields.Dropdowncheckboxes.text

On the button, add a Display Message action, then add in Message: 

Dropdowncheckboxes: [Dropdowncheckboxes]
Hidden: [Hidden]



Show the message from Display Message action to the left

In Display Message action, click on Toggle HTML and add this syntax:

<style>

.submit-confirm{
width:200px;
}

</style>
<p style="text-align: left;">This is some text in a paragraph.</p>