A1sS.GetTemplate

Возвращает текстовый шаблон по имени и подставляет параметры. На сервере — с обработкой ошибок; на тонком клиенте функция недоступна.

Сигнатура


Функция GetTemplate(TemplateName, Params = Неопределено, DefaultText = "") Экспорт // Строка

Поведение

Сервер: пытается получить шаблон по TemplateName; при ошибке возвращает DefaultText.
Тонкий клиент: генерирует исключение «Функция GetTemplate() недоступна на тонком клиенте…» — вызывайте с сервера.
Параметры: если передана Структура, плейсхолдеры вида {Ключ} заменяются на значения (через A1sS.Subst).

Примеры

1) Простой шаблон с подстановками


Парам = Новый Структура("Имя,Номер", "Иван", 42);
Текст = A1sS.GetTemplate("Email.OrderReady", Парам, "Здравствуйте, {Имя}! Ваш заказ №{Номер} готов.");
A1sS.Print(Текст);

2) Безопасный вызов с запасным текстом


Попытка
    Сообщение = A1sS.GetTemplate("SMS.Code", Новый Структура("Код", 1234), "Код: {Код}");
Исключение
    // На тонком клиенте: вызовите серверную процедуру формы, которая дергает GetTemplate
    Сообщение = "Код: 1234";
КонецПопытки;

3) Серверная обёртка для тонкого клиента


&НаСервере
Функция СформироватьПисьмо(Имя, Номер) Экспорт
    Парам = Новый Структура("Имя,Номер", Имя, Номер);
    Возврат A1sS.GetTemplate("Email.OrderReady", Парам, "Здравствуйте, {Имя}! Ваш заказ №{Номер} готов.");
КонецФункции

Советы

Форматируйте значения заранее (через Формат), если нужны точные правила вывода.
Имя шаблона (TemplateName) согласуйте с местом хранения (макеты/файлы/регистры).

Смотрите также

A1sS.Subst — подстановка параметров в текст.
A1sS.IsBlank — проверка пустых строк.