Edit Submit Email Message
No problem Terry!!
Below the third email button is a textfield that displays the script. You can scroll up and down and examine it:
This example is a bit involved, so I will try and break it down into sections:
The fields
You can see the textfields on the form for the name, email address, message, etc. The script looks at the value in these fields and uses this in the email script.
Setting up the variables
It can help to set up script variables. These are temporary holding points for values. These only exist for that script. For example vEmail, which will hold the email address.
// First check if there are null values, then construct email using script
var vEmail;
var vSubject;
var vBody;
var vName;
var vCC = "";
var vFormat = subFormat.rawValue;
var errorMessage = "You have not provided enough information:";
Checking the textfields and preparing a custom error message
The next section is a bit long. It basically works through all of the fields to make sure that they are not null. If they are then it adds to the error message. Otherwise it sets the value of the relevant variable to the value of the associated field. You will see the same approach being used for each field.
// Check email address field and build error message
if (emailAddress.rawValue == null)
{
errorMessage = errorMessage + "\n - please provide an email address.";
}
else
{
vEmail = emailAddress.rawValue;
}
// Check if there is a cc email address inputted
if (ccEmail.rawValue != null)
{
vCC = "&cc=" + ccEmail.rawValue;
// vCC is put at the end of the mailto string because it starts with a &
}
// Check subject line field and extend error message
if (subjectLine.rawValue == null)
{
errorMessage = errorMessage + "\n - please provide a subject line.";
}
else
{
vSubject = subjectLine.rawValue;
}
// Check your name field and extend error message
if (yourName.rawValue == null)
{
errorMessage = errorMessage + "\n - please provide your name.";
}
else
{
vName = yourName.rawValue;
}
// Check message line field, if null build a custom body message
if (messageLine.rawValue == null)
{
vBody = "Hi " + recipient.rawValue + ", \n\nThis email contains our submission in " + subFormat.rawValue + " format. \n\nPlease double click the attachment to open our submission. \n\nRegards, \n\n" + vName;
}
else
{
vBody = messageLine.rawValue;
}
Get ready to send email
We are nearly ready to send out the email. The last if statement checks that the minimum fields are not null. If any of the fields are null, then it displays the error message. Note that in the if statement the pipe (||) is JavaScript for OR.
// If fields required for script are null, warn user and do not initiate email
if (emailAddress.rawValue == null || subjectLine.rawValue == null || yourName.rawValue == null)
{
xfa.host.messageBox(errorMessage, "Sending an email", 0, 0); // Send out a custom error message if any of these fields are null
}
else
{
// Everything is OK, send email
event.target.submitForm({cURL:"mailto: "+ vEmail +"?subject=" + vSubject +"&body=" + vBody + vCC,cSubmitAs:vFormat,cCharset:"utf-8"});
}
That's it!!!!
The last line is the event.target.submitForm, which follows strict syntax for the variables. You can see that we are using the variables for the values.
This script is in the click event of the submit button. You can view the script in the Script Editor. If this is not visible at the top of the LC Designer window, then you can access it from the Windows menu. If it is only one line high, then grab the bottom bar and make it bigger. You need to see about 10 lines at a time.
The script is a bit involved, but don't be put off, there are a few methods here which are worthwhile exploring.
Come back if you need help,
Niall
Related Conversations
