mail Tag

Format: <mail to [ subject ] [ from ] [ cc ] [ bcc ] > heitml </mail>

Purpose: Sends a message to the email address specified in the to parameter.

Anything you type between the opening and closing mail tags is processed in HTML mode where the resulting string output is not sent to the browser, as usual, but to the underlying MTA (Mail Transfer Agent).

The MTA is the sendmail program on UNIX, and SMTP (Simple Mail Transfer Protocol) or MAPI (Microsoft Messaging Application Programming Interface) on Windows.

The mail Tag can also accept the following optional parameters:

subject: A short description that indicates what the message is about.
from: The email address of the person sending the message.
cc: List of email addresses that received copies of the message.
bcc: Hidden list of email addresses that received copies of the message. (i.e. The primary recipient of the email does not see who else may have received the message.

According to RFC 822, an email address can take either of the following forms:

name@domain
or
Display_name <name@domain>

The to, from, cc, and bcc parameters all accept email addresses in either of the two formats previous illustrated. However, the cc and bcc parameters can accept multiple email addresses separated by commas.

Configuration: For the mail Tag to function properly with those MTA's, you have to properly setup the configuration parameters sendmailprog, mailusemapi, mailservice, mailprofile and mailpassword.

Here are a few practical examples:

Example 1:

Email Address enclosed by Quotes
<mail to="cecile@aol.com">
    Message goes here.
</mail>

Example 2:

In Quotes together with a Name
<mail to="Cecile Provot <cecile@aol.com>">
    Message goes here.
</mail>

Example 3:

Email assigned from an object field
<mail to=r.Email>
    Message goes here.
</mail>

Note: The mail Tag is Case Sensitive, which means that heitml will not recognize it if you use capital letters (e.g. <MAIL to>). The parameters (to, from, subject, etc.) are not Case Sensitive.

This page was dynamically generated by the web application development tool RADpage of H.E.I.
© 1996-2017 H.E.I. All Rights Reserved.



Homepage
Intro/Features
Component Guide
Programming
  Language Guide
  Language Ref.
    General Design
    Lexical Structure
    Expressions
    Objects
    Methods
    Classes
    heitml Tags
      ? Tag
      assign Tag
      break Tag
      callenv Tag
      dbdatabase Tag
      dbquery Tag
      dbupdate Tag
      def Tag
      defautoclose Tag
      defbody Tag
      defclass Tag
      defcontpara Tag
      defenv Tag
      defhtml Tag
      definpara Tag
      defpara Tag
      defremovecdata Tag
      deftranspara Tag
      defwysiwyg Tag
      for Tag
      forin Tag
      forsep Tag
      if Tag
      elsif Tag
      else Tag
      include Tag
      includeonce Tag
      inherit Tag
      let Tag
      mail Tag
      return Tag
      shell Tag
      while Tag
      writefile Tag
      \ Tag
    heitml Functions
    Advanced Functions
    Database Access
    Global Variables
    Form Fields
    Server Variables
    Sessions
    heitml Syntax
  Component Ref.
  Class Library
  User Components
  Tryout Form
  Tutorial
  New Features
  heitml 1
User Guide
FAQ
Mailinglist
Discussion Group
Services
Pricing/Register
Download
Frame
 
Contact
 
 
 
Search: