SendMax

> [HTML Version](sendmax.html)

Важно\! Если требуется отправить сообщение в Max [группе пользователей](https://simple-scada.com/help/manual/newusergroup.html), то используйте метод [SendMax](sendmaxgroup.md) для группы.

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

````
SendMax(const AMessage: string; const ARecipients: 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. Возвращает nil, если при попытке создания сообщения возникла ошибка. К сообщению можно прикреплять вложения и отчеты.

| **Параметр** | **Описание** |
|------|------|
| AMessage | Текст сообщения |
| ARecipients | ChatID получателей (должны быть перечислены через запятую). Узнать ChatID получателя можно в [настройках отправки сообщений в Max](https://simple-scada.com/help/manual/index.html?maxset.html). Если в параметре ARecipients указать пустую строку (''), то сообщение будет отправлено списку получателей заданному в "Options.exe" -> раздел "Simple-Scada Server" -> "[Отправка сообщений в Max](https://simple-scada.com/help/manual/index.html?settings-simple-scada-server.html#max)".  |
| 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/sendmax.html?anchor=ex1)**

````
begin  
  // отправить сообщение в Max списку получателей заданному в Options.exe  
  SendMax('Авария котла\!');    
   
  // отправить сообщение в Max двум получателям  
  SendMax('Авария котла\!', '258579674, 568479675');                     
end.
````

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

````
var  
  aMax: TM\_Max;  
begin  
  aMax := 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/sendmax.html?anchor=ex3)**

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

````
**(./images/tog_code_1.png) 4. Отправка сообщения в Max с форматированием [(./images/link.png)](https://simple-scada.com/help/script/sendmax.html?anchor=ex4)**

````
begin   
  // отправить сообщение в Max с Markdown форматированием  
  SendMax('\*\*Жирный текст\*\*, \_Курсив\_, \[Ссылка\](https://simple-scada.com/), \`Форматированный код\`', '', mpmMarkdown);  
   
  // отправить сообщение в Max с HTML форматированием  
  SendMax('<b>Жирный текст</b>, <i>Курсив</i>, <a href="https://simple-scada.com/">Ссылка</a>, <code>Форматированный код</code>', '', mpmHTML);    
   
  // отправить сообщение в Max с переносом строки  
  SendMax('Строка 1.' + #13#10 + 'Строка 2.');                     
end.
````

````
**(./images/tog_code_1.png) 5. Отправка сообщения в Max с Emoji смайлами [(./images/link.png)](https://simple-scada.com/help/script/sendmax.html?anchor=ex5)**

Для отправки Emoji смайлов в Max, можно использовать Unicode значение смайла и функцию [Emoji](emoji.md). Значение Unicode для смайла можно найти в таблице [по ссылке](https://web-revenue.ru/sajtostroenie/tablica-emoji) - см. колонку "Юникод".

````
begin                              
  SendMax(Emoji('U+1F7E5') + ' Авария котла\!');  
  SendMax(Emoji('U+1F64E U+200D U+2640 U+FE0F') + ' Оператор авторизовался.');  
end.
````

````
****