Specifications

Crestron e-control Mail SW-MAIL
47 •• Composing e-Mail Installation & Reference Guide — Doc. 5798
record from the interactive message scroller (see below). These values are replaced
continually until the SendNow signal is issued.
Note that the name and address are actually added to the list only when the SetAddr
signal is issued. At that moment, the name most recently sent via SetRcptName is
paired with the address and added to the recipient list.
When the Allow multiple recipients option is in effect (checkbox in e-mailer signal
block definition window is checked), the recipient list can be any length. It is
constructed by setting the name and address repeatedly, either with (SetRcptName
and) SetAddr, or with LookupRcpt (see below); or picking a record from the
interactive recipient scroller (see below).
When the Allow multiple recipients option is not in effect, only a single recipient is
replaced by any subsequent use of the SetAddr or LookupRcpt signals, or picking a
record from the interactive recipient scroller, until the SendNow signal is issued.
Recipient Lookup
The term recipient as used here
refers to both the name and the
e-mail address of the recipient.
A practical method of setting both the name and address is to look it up in an
“address book” database table. The LookupRcpt analog signal looks up and adds to
the recipient list the name and address found in record ID = n of table
eMail_Addr (where n is the signal value). As described above, these values either
add to (build) a recipient list, or are replaced by subsequent sets/lookups/picks until
the SendNow signal is issued, depending on the state of the Allow multiple
recipients option.
Message Lookup
The term message as used here
refers to both the subject and the
body of the e-mail message.
A similar method of setting both the subject and body is to look it up in a message
table in the database. The LookupMsg analog signal looks up the subject and body
found in record ID = n of table eMail_Msg (where n is the signal value). As
described above, these values are replaced by subsequent sets/lookups/picks until the
SendNow signal is issued.
When a message is selected with a LookupMsg signal (or when a user manually
picks a message from a scroller — see below), the e-mailer signal block records the
subject and body from the selected record. If the Echo Lookups option is in effect,
the subject and body are echoed back to the control system (using the EchoSubj and
EchoBody signals).
Implicit Recipient Name & Address
If a recipient has not yet been explicitly specified, an implicit (default) name and
address is echoed. Where these defaults come from depends on the value of the
defaultAddr field and the contents of the fields in the record in the eMail_Addr
table referenced by this value.
If a positive, non-zero value is present in the defaultAddr field, the name and address
from the record in the eMail_Addr table referenced by this value is recorded. If
either (or both) fields are null, then one (or both) e-mailer signal block defaults are
recorded instead.