[Email_Send]
[Email_Send] queues an email message for sending. The email message is sent within a couple minutes by an automatic background process.
The current Email Queue can be viewed in Lasso Administration in the Monitor > Email section. Preferences can also be set here for whether emails should be logged, how many retries should be attempted per email, default host, and more.
The email tag requires that the -From and -Subject parameters have values. Either the -Body or -HTML parameter should also be specified. The -Body parameter will generate a plain text email. The -HTML parameter will generate an HTML email. Specifying both will send a multi-part/alternative email.
At least one of -To, -CC, and -BCC must contain valid email addresses. Multiple email addresses can be specified separated by commas, but use of the real name and email address is not supported.
The -Host parameter is required only if a default has not been established in Lasso Administration. If a -Username and -Password are specified they will be used for SMTP AUTH authorization at the specified host. The -Username, -Password, -Timeout, and -Port parameters will only be used if a -Host parameter is specified as well.
The optional -Attachments parameter can be set to the file path for a single file that should be included as an attachment to the email message or to an array of file paths. The attached file(s) should be within the Web server root and the path(s) should be specified relative to the current page or to the Web server root.
The optional -ExtraMIMEHeaders parameter can be set to an array of name/value pairs which define extra headers that should be included with the email message. For example, a "Reply To" header could be included in this way.
- Syntax
- Parameters
[Email_Send: -Host='Host Name',
-To='Recipient Email Address',
-From='Sender Email Address',
-Subject='Email Subject',
-Body='Email Body Text']
[Email_Send: -Host='Host Name',
-To='Recipient Email Address',
-CC='Recipient Email Address',
-BCC='Recipient Email Address',
-From='Sender Email Address',
-Subject='Email Subject',
-Body='Email Body Text']
[Email_Send: -Host='Host Name',
-To='Recipient Email Address',
-From='Sender Email Address',
-Subject='Email Subject',
-Body='Email Body Text',
-Attachments='Attachment Path',
-ExtraMIMEHeaders='Headers Pair Array']Examples
To send an email from a format file:
Use the [Email_Send] tag. The following example sends an email to administrator@example.com through the server mail.example.com each time the page is visited. The contents of the email is the current date and time.
[Email_Send: -Host='mail.example.com',
-To='administrator@example.com',
-From='administrator@example.com',
-Subject='A page visit!',
-Body=(Date_GetCurrentDate)]To send an email with the contents of a format file:
Use the [Email_Send] tag. The following example sends an email to administrator@example.com through the server mail.example.com each time the page is visited. The contents of the format file format.lasso is used as the body of the email message.
[Email_Send: -Host='mail.example.com',
-To='administrator@example.com',
-From='administrator@example.com',
-Subject='A page visit!',
-Body=(Include: 'format.lasso')]| Tag Link | [Email_Send] | Category | |
|---|---|---|---|
| Type | Process | Data Source | Any |
| Support | Preferred | Version | 5.0 |
| Output Type | None | Security | Tag |
| Implementation | LDML | Sets | Lasso 8.5, Lasso 8.0, Lasso 7.0, Lasso 6.0, Lasso 5.0 |
Please note that periodically LassoSoft will go through the notes and may incorporate information from them into the documentation. Any submission here gives LassoSoft a non-exclusive license and will be made available in various formats to the Lasso community.
LassoSoft Inc. > Home
©LassoSoft Inc 2015 | Web Development by Treefrog Inc | Privacy | Legal terms and Shipping | Contact LassoSoft