Crestron
e-control Mail SW-MAIL
32
••
Server Configuration In Depth
Installation & Reference Guide — Doc. 5798
messages table,
eMail_Msg,
and the canned recipients table,
eMail_Addr.
Binding these signal blocks in turn to the e-mailer signal block permits the signal
block to:
•
Automatically enable/disable the scrollers when the signal block is
enabled/disabled
•
Inform the signal block upon receiving a valid scroller pick
Once the signal block “knows about” the scrollers, simply picking items from the
scrollers has the following effects:
•
The e-Mail parameters are automatically set.
•
Such parameters are echoed to the control system for display.
Picking an item from the “message” scroller sets the subject and body. In addition,
each message has a reference to an ID of a record in the recipient table. If this
reference is non-null and if a name and address have not already been given, the
information from that record are echoed back to the control system and are used to
set the name and address.
Picking an item from the “recipient” scroller sets just the name and address.
Normally, these values overwrite any previously set name and address. However, see
the
Allow Multiple Recipients
option, described below.
It is permissible to have either scroller without the other; or neither. If neither
scroller is used, mail can still be composed from the tables via the two Lookup
signals; or verbatim using the various Set signals (see “Appendix C: ” on page 65).
Run-time properties
Three checkboxes appear in the
Properties
portion of the
e-Mailer Signal Block
Definition
window.
Allow Multiple Recipients
This option controls the number of recipients. When checked, a list is developed
until the mail is sent or the list is cleared. When this box is not checked (default),
each recipient specified replaces the last, such that an e-mail message is sent
exclusively to the most recently specified recipient.
Echo Lookups
This option controls feedback behavior for each e-mailer signal block. If the box is
checked, data from table lookups is sent back to the control system via the various
Echo
serial signals.
A subordinate option,
Show Indirection,
displays indirection for recipient name and
address by prefixing one or two right angle brackets (
>
) to the echoed recipient
name and/or address data, as follows:
•
When the recipient name and address is set from a record in the
eMail_Addr
table and a field is null (blank), the default is used and an angle bracket (
>
) is
prefixed to the echoed data.
•
When the data come indirectly from the
eMail_Addr
table (through a
reference in
eMail_Msg
table), an angle bracket is prefixed to the echoed
data.
Log SMTP sessions
This option is meant as a debugging aid when the e-mail host fails to respond. The
entire “conversation” with the server is logged in the main server window. Each line
of the conversation is preceded by the following string of characters: