SendMax

> [HTML Version](sendmaxgroup.html)

Важно\! Если требуется отправить сообщение в мессенджер Max одному или нескольким произвольным пользователям, то используйте отдельный метод [SendMax](sendmax.md).

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

````
function SendMax(const AMessage: string; const AMode: TM\_MaxParseMode = mpmNone; const ANotify: Boolean = True): TM\_Max;

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

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

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

| **Параметр** | **Описание** |
|------|------|
| AMessage | Текст сообщения |
| AMode | Необязательный параметр. Определяет тип разметки. Имеет тип [TM\_MaxParseMode](tmmaxparsemode.md). Мессенджер Max поддерживает ограниченное HTML/Markdown форматирование. Подробнее о форматировании сообщений в Max можно прочесть в официальной документации: [Markdown разметка](https://dev.max.ru/docs-api#Markdown), [HTML разметка](https://dev.max.ru/docs-api#HTML). |
| ANotify  | Необязательный параметр. Определяет, следует ли уведомить получателей о сообщении. |


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

**(./images/tog_code_1.png) 1. Отправка сообщения в Max для группы пользователей [(./images/link.png)](https://simple-scada.com/help/script/sendmaxgroup.html?anchor=ex1)**

````
begin  
  // отправка сообщения в Max всем пользователям группы ugOperators  
  ugOperators.SendMax('Авария котла\!');                   
end.
````

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

````
var  
  aMax: TM\_Max;  
begin  
  // создаем сообщение в Max для отправки всем пользователям группы ugOperators  
  aMax := ugOperators.SendMax('Руководство');    
  
  if aMax <> nil then                     // если сообщение успешно создано,  
    aMax.AttachFile('E:\\Manual.pdf');     // то прикрепляем файл "Manual.pdf"  
end.
````

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

````
var  
  aReport: TM\_Report;  
  aMax: TM\_Max;  
begin  
  aReport := ReportBuild('Отчет');            // строим отчет  
  
  // создаем сообщение в Max для отправки всем пользователям группы ugOperators  
  aMax := ugOperators.SendMax('');         
  if aMax <> nil then                         // если сообщение успешно создано,  
    aMax.AttachReport(aReport, 'Мой отчет');  // то прикрепляем к нему отчет с именем "Мой отчет"  
end.
````

````
****