add

src/content/docs/knowledge-base/Общие/(БСП) Подключение к подсистемам/Подключение к подсистеме Шаблоны сообщений.md

@@ -0,0 +1,94 @@
+---
+title: Подключение к подсистеме Шаблоны сообщений
+slug: общие-бсп-подключение-к-подсистемам/подключение-к-подсистеме-шаблоны-сообщений
+---
+
+## Настройка определяемых типов
+Включить в тип определяемого типа `ПредметШаблонаСообщения` объекты, для которых требуется использовать шаблоны сообщений
+
+## В модуле менеджера предметов шаблонов сообщений
+
+```bsl
+// СтандартныеПодсистемы.ШаблоныСообщений
+
+// Вызывается при подготовке шаблонов сообщений и позволяет переопределить список реквизитов и вложений.
+//
+// Параметры:
+//  Реквизиты - см. ШаблоныСообщенийПереопределяемый.ПриПодготовкеШаблонаСообщения.Реквизиты
+//  Вложения  - см. ШаблоныСообщенийПереопределяемый.ПриПодготовкеШаблонаСообщения.Вложения
+//  ДополнительныеПараметры - Структура - дополнительные сведения о шаблоне сообщений.
+//
+Процедура ПриПодготовкеШаблонаСообщения(Реквизиты, Вложения, ДополнительныеПараметры) Экспорт
+
+КонецПроцедуры
+
+// Вызывается в момент создания сообщений по шаблону для заполнения значений реквизитов и вложений.
+//
+// Параметры:
+//  Сообщение - Структура:
+//    * ЗначенияРеквизитов - Соответствие из КлючИЗначение - список используемых в шаблоне реквизитов:
+//      ** Ключ     - Строка - имя реквизита в шаблоне;
+//      ** Значение - Строка - значение заполнения в шаблоне.
+//    * ЗначенияОбщихРеквизитов - Соответствие из КлючИЗначение - список используемых в шаблоне общих реквизитов:
+//      ** Ключ     - Строка - имя реквизита в шаблоне;
+//      ** Значение - Строка - значение заполнения в шаблоне.
+//    * Вложения - Соответствие из КлючИЗначение:
+//      ** Ключ     - Строка - имя вложения в шаблоне;
+//      ** Значение - ДвоичныеДанные
+//                  - Строка - двоичные данные или адрес во временном хранилище вложения.
+//  ПредметСообщения - ЛюбаяСсылка - ссылка на объект являющийся источником данных.
+//  ДополнительныеПараметры - Структура -  дополнительная информация о шаблоне сообщения.
+//
+Процедура ПриФормированииСообщения(Сообщение, ПредметСообщения, ДополнительныеПараметры) Экспорт
+
+КонецПроцедуры
+
+// Заполняет список получателей SMS при отправке сообщения сформированного по шаблону.
+//
+// Параметры:
+//   ПолучателиSMS - ТаблицаЗначений:
+//     * НомерТелефона - Строка - номер телефона, куда будет отправлено сообщение SMS;
+//     * Представление - Строка - представление получателя сообщения SMS;
+//     * Контакт       - Произвольный - контакт, которому принадлежит номер телефона.
+//  ПредметСообщения - ЛюбаяСсылка - ссылка на объект, являющийся источником данных.
+//                   - Структура  - структура описывающая параметры шаблона:
+//    * Предмет               - ЛюбаяСсылка - ссылка на объект, являющийся источником данных;
+//    * ВидСообщения - Строка - вид формируемого сообщения: "ЭлектроннаяПочта" или "СообщениеSMS";
+//    * ПроизвольныеПараметры - Соответствие - заполненный список произвольных параметров;
+//    * ОтправитьСразу - Булево - признак мгновенной отправки;
+//    * ПараметрыСообщения - Структура - дополнительные параметры сообщения.
+//
+Процедура ПриЗаполненииТелефоновПолучателейВСообщении(ПолучателиSMS, ПредметСообщения) Экспорт
+
+КонецПроцедуры
+
+// Заполняет список получателей почты при отправке сообщения сформированного по шаблону.
+//
+// Параметры:
+//   ПолучателиПисьма - ТаблицаЗначений - список получается письма:
+//     * ВариантОтправки - Строка - вариант отправки для получателя письма: Кому, Копия, СкрытаяКопия, ОбратныйАдрес;
+//     * Адрес           - Строка - адрес электронной почты получателя;
+//     * Представление   - Строка - представление получателя письма;
+//     * Контакт         - Произвольный - контакт, которому принадлежит адрес электронной почты.
+//  ПредметСообщения - ЛюбаяСсылка - ссылка на объект, являющийся источником данных.
+//                   - Структура  - структура описывающая параметры шаблона:
+//    * Предмет               - ЛюбаяСсылка - ссылка на объект, являющийся источником данных;
+//    * ВидСообщения - Строка - вид формируемого сообщения: "ЭлектроннаяПочта" или "СообщениеSMS";
+//    * ПроизвольныеПараметры - Соответствие - заполненный список произвольных параметров;
+//    * ОтправитьСразу - Булево - признак мгновенной отправки письма;
+//    * ПараметрыСообщения - Структура - дополнительные параметры сообщения;
+//    * ПреобразовыватьHTMLДляФорматированногоДокумента - Булево - признак преобразование HTML текста
+//             сообщения содержащего картинки в тексте письма из-за особенностей вывода изображений
+//             в форматированном документе;
+//    * УчетнаяЗапись - СправочникСсылка.УчетныеЗаписиЭлектроннойПочты - учетная запись для отправки письма.
+//
+Процедура ПриЗаполненииПочтыПолучателейВСообщении(ПолучателиПисьма, ПредметСообщения) Экспорт
+
+КонецПроцедуры
+
+// Конец СтандартныеПодсистемы.ШаблоныСообщений
+```
+
+Если код процедур оставить незаполненными, то в шаблонах сообщений будут доступны реквизиты предмета и определенные в нем печатные формы. При наличии у предмета контактной информации список адресатов будет заполнен, в противном случае он будет пустой. Пример реализации этих процедур см. в демонстрационной конфигурации в справочнике
+
+## Подключить формы к подсистеме "Подключаемые команды"