Deployment Guide
About Customizing SMTP Email Receipt Fields
The behavior of email receipt operations can be customized with certain guest account fields. You do this on a per-user
basis.
l smtp_enabled – This field may be set to a non-zero value to enable sending an email receipt. If unset, the default
value from the email receipt configuration is used. The special values “_Auto” (Always auto-send guest receipts by
email), “_AutoField” (Auto-send guest receipts by email with a special field set), “_Click” (Display a link enabling
a guest receipt via email), and “_Cc” (Send an email to a list of fixed addresses) may also be used.
l smtp_subject – This field specifies the subject line for the email message. Template variables appearing in the value
will be expanded. If the value is “default”, the default subject line from the email receipt configuration is used.
l smtp_template_id – This field specifies the print template ID to use for the email receipt. If blank or unset, the
default value from the email receipt configuration is used.
l smtp_receipt_format – This field specifies the email format to use for the receipt. It may be one of “plaintext” (No
skin – plain text only), “html_embedded” (No skin – HTML only), “receipt” (No skin – Native receipt format),
“default” (Use the default skin), or the plugin ID of a skin plugin to specify that skin. If blank or unset, the default
value from the email receipt configuration is used.
l smtp_email_field – This field specifies the name of the field that contains the visitor’s email address. If blank or
unset, the default value from the email receipt configuration is used. Additionally, the special value “_None”
indicates that the visitor should not be sent any email.
l smtp_auto_send_field – This field specifies the name of the field that contains the auto-send flag. If blank or unset,
the default value from the email receipt configuration is used. Additionally, the special values “_Disabled” and “_
Enabled” may be used to never send email or always send email, respectively.
l smtp_cc_list – This field specifies a list of additional email addresses that will receive a copy of the visitor account
receipt. If the value is “default”, the default carbon-copy list from the email receipt configuration is used.
l smtp_cc_action – This field specifies how to send copies of email receipts. It may be one of “never”, “always_cc”,
“always_bcc”, “conditional_cc”, or “conditional_bcc”. If blank or unset, the default value from the email receipt
configuration is used.
The logic used to send an email receipt is:
l If email receipts are disabled, take no action.
l Otherwise, check the auto-send field.
n If it is “_Disabled” then no receipt is sent.
n If it is “_Enabled” then continue processing.
n If it is any other value, assume the auto-send field is the name of another guest account field. Check the value
of that field, and if it is zero or the empty string then no receipt is sent.
l Determine the email recipients:
n Address the email to the value specified by the email field in the visitor account. If the email field is “_None”
then do not send an email directly to the visitor.
n Depending on the value of the Send Copies setting, add the email addresses from the Copies To: list to the
email’s “Cc:” or “Bcc:” list.
l If there are any “To:”, “Cc:” or “Bcc:” recipients, generate an email message using the specified print template and
send it to the specified recipient list.
l smtp_warn_before_subject – This field overrides what is specified in the subject line under Logout Warnings on
the email receipt. If the value is “default”, the default subject line under the Logout Warnings section on the email
receipt configuration is used.
Dell Networking W-ClearPass Guest 6.3 | User Guide Configuration | 269