Функциональный блок SEND_EMAIL служит для отправки электронных писем при наличии доступа в Интернет. Этот функциональный блок может использоваться как внутри программы, так и непосредственно в дереве MasterSCADA.
Важно! Для возможности использования ФБ SEND_EMAIL в исполнительную систему должна входить опция MSRT4D-Send. Данная опция включена в базовый функционал лицензий Lite, Standard, Professional и Enterprise.
Вид в дереве |
Вид в редакторе FBD |
|
|
Входы и выходы ФБ:
Название |
Тип |
Назначение |
Входы |
||
Server |
STRING |
Сервер SMTP |
Port |
DINT |
Порт сервера. |
Login |
STRING |
Логин для авторизации на сервере. |
Password |
STRING |
Пароль для авторизации на сервере. После ввода значения, по умолчанию в среде разработки оно будет замаскировано звездочками. Инструкция по получению пароля размещена в следующем топике: Рекомендации по работе с ФБ SEND_EMAIL. |
Send |
BOOL |
Отправка сообщения по переднему фронту изменения значения на этом входе. По каждому импульсу, поступившему на вход Send, сообщение добавляется в очередь на отправку. Отправка проходит ассинхронно, по каждому отправленному сообщению выдается импульс на выход Sent (одновременно выдается ошибка по данному сообщению, если она возникла). |
SenderName |
STRING |
Указывается адрес почты отправителя до знака @. |
SenderMail |
STRING |
Адрес почты отправителя. |
Subject |
STRING |
Тема письма. |
Recipient |
STRING |
Адрес почты получателя. Если необходимо отправить письмо нескольким получателям, то необходимо писать их адреса через запятую и пробел. |
Message |
STRING |
Текст сообщения. |
Attachment |
STRING |
Полный путь к файлу, который требуется добавить к письму. Если к одному письму необходимо добавить несколько вложений, то в этом случае путь к ним указывается через точку с запятой (;). Например, C:\Users\Operator\Desktop\1.txt;C:\Users\Operator\Desktop\2.txt |
SecurityType |
UINT |
Задается тип шифрования SMTP: •0 - NO_SECURITY •1 - USE_TLS •2 - USE_SSL |
Выходы |
||
ErrStr |
STRING |
Текст ошибки |
Sent |
BOOL |
Принимает значение TRUE после оправки сообщения на 1 такт. |
Code |
DINT |
Код ошибки. Значение 0 обозначает отсутствие ошибки. |
QueueFull |
BOOL |
Показывает, когда очередь на отправку сообщений переполнена. |
Примеры текстов ошибок:
•Unable to initialise winsock2
•Wrong version of the winsock2
•Function send() failed
•Function recv() failed
•Function connect failed
•Unable to determine remote server
•Invalid winsock2 socket
•Function hostname() failed
•Function ioctlsocket() failed
•Improper IPv4 address
•Undefined message header
•Undefined mail sender
•Undefined message subject
•Undefined at least one reciepent
•Undefined recipent mail
•Undefined user login
•Undefined user password
•Invalid user login or password
•Server returned a bad digest MD5 response
•Unable to determine server name for digest MD5 response
•Server returned error after sending MAIL FROM
•Server returned error after sending EHLO
•Server returned error after sending AUTH PLAIN
•Server returned error after sending AUTH LOGIN
•Server returned error after sending AUTH CRAM-MD5
•Server returned error after sending AUTH DIGEST-MD5
•Server returned error after sending MD5 DIGEST
•Server returned error after sending DATA
•Server returned error after sending QUIT
•Server returned error after sending RCPT TO
•Error in message body
•Server has closed the connection
•Server is not ready
•Server not responding
•Attachment file does not exist
•Message is too big
•Bad login or password
•Undefined xyz SMTP response
•Lack of memory
•time() error
•RecvBuf is empty
•SendBuf is empty
•Specified line number is out of message size
•Server returned error after sending STARTTLS
•SSL problem
•Failed to send data block
•The STARTTLS command is not supported by the server
•AUTH LOGIN is not supported by the server
•Undefined error id
Примеры кодов:
•0 CSMTP_NO_ERROR
•100 WSA_STARTUP
•101 WSA_VER
•102 WSA_SEND
•103 WSA_RECV
•104 WSA_CONNECT
•105 WSA_GETHOSTBY_NAME_ADDR
•106 WSA_INVALID_SOCKET
•107 WSA_HOSTNAME
•108 WSA_IOCTLSOCKET
•109 WSA_SELECT
•110 BAD_IPV4_ADDR
•200 UNDEF_MSG_HEADER
•201 UNDEF_MAIL_FROM
•202 UNDEF_SUBJECT
•203 UNDEF_RECIPIENTS
•204 UNDEF_LOGIN
•205 UNDEF_PASSWORD
•206 BAD_LOGIN_PASSWORD
•207 BAD_DIGEST_RESPONSE
•208 BAD_SERVER_NAME
•209 UNDEF_RECIPIENT_MAIL
•300 COMMAND_MAIL_FROM
•301 COMMAND_EHLO
•302 COMMAND_AUTH_PLAIN
•303 COMMAND_AUTH_LOGIN
•304 COMMAND_AUTH_CRAMMD5
•305 COMMAND_AUTH_DIGESTMD5
•306 COMMAND_DIGESTMD5
•307 COMMAND_DATA
•308 COMMAND_QUIT
•309 COMMAND_RCPT_TO
•310 MSG_BODY_ERROR
•400 CONNECTION_CLOSED
•401 SERVER_NOT_READY
•402 SERVER_NOT_RESPONDING
•403 SELECT_TIMEOUT
•404 FILE_NOT_EXIST
•405 MSG_TOO_BIG
•406 BAD_LOGIN_PASS
•407 UNDEF_XYZ_RESPONSE
•408 LACK_OF_MEMORY
•409 TIME_ERROR
•410 RECVBUF_IS_EMPTY
•411 SENDBUF_IS_EMPTY
•412 OUT_OF_MSG_RANGE
•413 COMMAND_EHLO_STARTTLS
•414 SSL_PROBLEM
•415 COMMAND_DATABLOCK
•416 STARTTLS_NOT_SUPPORTED
•417 LOGIN_NOT_SUPPORTED
Смотрите также: