EMAIL

This command sends emails to the email addresses you specify. You can also send an email and a photo to text message recipients.

Syntax

• EMAIL "to_address(es)", "from_address", "subject", "message_body", "host", "auto_send", "attach_chart"

to_address(es)

A valid email address must contain the '@' and '.' characters, and it must not contain any spaces. It can specify just the email address (such as "name@companyname.xxx" or "<name@companyname.xxx>") or a name and address (such as "firstname lastname <name@companyname.xxx>").

To specify multiple email addresses, use a comma (,) or a semicolon (;) to separate the addresses.

from_address

Valid options for this parameter will depend on the email program you use to send emails from GainSeeker, the security settings on your email server, and whether the EMAIL command is configured to auto-send email messages:

subject

The text string you specify here will appear in the Subject portion of the email message.

message_body

The text string you specify here will provide the body of the email message.

host

Valid options for this parameter will depend on the email program you use to send emails from GainSeeker and the security settings on your email server:

auto_send

• • • To send the email message automatically with no user intervention, set this parameter to "Y".

Tip: If the security settings for Microsoft Outlook force the user to click the Send button even when this option is used, you can download a free utility from http://www.mapilab.com/outlook/security/ that will allow GainSeeker emails to be sent automatically without user intervention.

• • • If this parameter is set to any other value (such as "N" or a blank string), the email program you use will display the email message to the user, who can edit all parts of the email before sending it. To send the email, the user must click the Send button.

attach_chart

• • • To include a .jpg of the chart for the current row of the template as an email attachment, set this parameter to "Y".

    • To attach a file to the email message, set this parameter to the file path and name of the file you want to attach. The file path and name must be at least four characters in length. If the file does not exist, an empty file with this name will be attached to the email.

Please Note:  When you use this option to attach a file (filename.ext), the program will delete all files named filename.* from the specified file path after the email has been sent. If you need to keep these files, make a copy of the file (such as filename01.ext) and attach the copy.

• • • To avoid attaching any files to this email, set this parameter to any string up to three characters long (such as "N" or a blank string).

• EMAIL "to_address", "from_address", "subject", "message_body", "host", "auto_send", "attach_chart", "email_login_name", "email_login_password"

If your email system requires its own login name and password for authentication, you can use the additional email_login_name and  email_login_password parameters to specify a valid login name and password for your email system.

Tip: If you have set up email login names and passwords for the GainSeeker login names, then you can substitute the ELOGIN_NAME and EPASSWORD commands for these parameters.

Return value

This command returns the number 0.

Notes

This command is commonly executed as Feedback when a real-time failure occurs during data entry.

Because of the third-party components used for sending email from GainSeeker, sending two emails in rapid succession sometimes results in the second email not being sent. To avoid this situation, you should insert a DELAY command between the two EMAIL commands to force a one-  to three-second pause between the two emails.

To email charts that include default headings, add one of the following lines to the Convert.db file:

If you add one of these lines to the Convert.db file, it will apply to all SPC data entry charts in all configurations.

See also: Configuring email settings for GainSeeker, email_timeout=

Examples

EMAIL "Engineering@companyname.com", "line1@companyname.com", "Urgent problem - Line 1", "Product out of control on Line 1", "mailserver.companyname.com", "Y", "Y"

EMAIL "Engineering@companyname.com", "<line1@companyname.com>", "Urgent problem - Line 1", "Product out of control on Line 1", "mailserver.companyname.com", "Y", "Y", "Line1", "Line1Password"

These examples send an email to Engineering from Line 1, with the current chart attached and no intervention from the user, via the email server named "mailserver.companyname.com".

The second example includes the email login name and password for authentication on the email server.

EMAIL "Engineering@companyname.com", EADDRESS, "Urgent problem - Line 1", "Product out of control on Line 1", ESERVER, "N", "Y", ELOGIN_NAME, EPASSWORD

This example sends an email to Engineering from Line 1, with the current chart attached, where the user can add or modify information before sending the email.

The "From" address, email server name, and email system login and password come from the email settings defined for whichever GainSeeker login name is logged in to GainSeeker and is running this template.

Email to Text

You can use your email account to send text messages to text message recipients.

• The text content should be plain text and no more than 160 characters, and not contain other elements such as a signature or logo.
• Because text messages do not have subject headers, you should leave the Subject line in the email blank.

Use the following formats* to send a text message to a recipient using your email account:

*formats as of this writing. You may want to send a test email to text or contact your carrier for more information.

**standard text messaging rates from your carrier may apply