SendMail

> [HTML Version](sendmailgroup.html)

Важно\! Если требуется отправить E-mail одному или нескольким произвольным пользователям, то используйте отдельный метод [SendMail](sendmail.md).

**Синтаксис**

````
function SendMail(const AFrom, ATheme, ABody: string): TM\_Mail;

````
**Описание**

Функция доступна во всех версиях, за исключением Minimal и Demo-64. Для отправки E-mail сообщений необходимо предварительно настроить параметры отправки через "Options.exe" -> раздел "Simple-Scada Server" -> "[Отправка E-mail сообщений](http://simple-scada.com/help/manual/index.html?settings-simple-scada-server.html#send_email)".

Отправляет E-mail сообщение всем [пользователям группы](https://simple-scada.com/help/manual/newusergroup.html), в [профиле](https://simple-scada.com/help/manual/new-user.html) которых заполнено поле "E-mail". Если пользователь [заблокирован](https://simple-scada.com/help/manual/usermanag.html?anchor=actpanel), то ему не будет отправлен E-mail. К сообщению можно прикреплять вложения и отчеты. Возвращает nil, если в группе нет пользователей для отправки или если при попытке создания сообщения возникла ошибка. Получить имя группы пользователей можно через меню "[Пользователи -> Редактировать](https://simple-scada.com/help/manual/editor-users.html)" - см. параметр "[Имя в скриптах](https://simple-scada.com/help/manual/newusergroup.html?anchor=basicset)".

Параметры:

- **ATheme** - тема письма. 

- **ABody** - текст письма. 

- **AFrom** - имя отправителя. 

**Пример кода**

**(./images/tog_code_1.png) 1. Отправка E-mail группе пользователей [(./images/link.png)](https://simple-scada.com/help/script/sendmailgroup.html?anchor=ex1)**

````
begin  
  // отправить E-mail всем пользователям группы ugOperators  
  ugOperators.SendMail('Simple-Scada', 'Авария котла\!', 'Превышена максимальная температура');  
end.
````

````
**(./images/tog_code_1.png) 2. Отправка E-mail с вложением для группы пользователей [(./images/link.png)](https://simple-scada.com/help/script/sendmailgroup.html?anchor=ex2)**

````
var  
  aMail: TM\_Mail;  
begin  
  // создаем e-mail сообщение для отправки всем пользователям группы ugOperators  
  aMail := ugOperators.SendMail('Simple-Scada', 'Mail с вложением', 'Руководство во вложении');  
    
  if aMail <> nil then                  // если сообщение успешно создано  
    aMail.AttachFile('E:\\Manual.pdf');  // то прикрепляем файл "Manual.pdf"  
end.
````

````
**(./images/tog_code_1.png) 3. Отправка E-mail с отчетом для группы пользователей [(./images/link.png)](https://simple-scada.com/help/script/sendmailgroup.html?anchor=ex3)**

````
var  
  aMail: TM\_Mail;  
  aReport: TM\_Report;  
begin  
  aReport := ReportBuild('Отчет');  // строим отчет  
   
  // создаем e-mail сообщение для отправки всем пользователям группы ugOperators  
  aMail := ugOperators.SendMail('Simple-Scada', 'Mail с отчетом', 'Отчет во вложении');   
  if aMail <> nil then                          // если сообщение успешно создано  
    aMail.AttachReport(aReport, 'Мой отчет');   // прикрепляем отчет "Мой отчет" к e-mail сообщению  
end.
````

````
****