К статье
Практический материал

Другое · 7 мин

Создание текстового шаблона в 1С

Создание и использование текстовых шаблонов в 1С: где хранятся общие макеты, как ставить маркеры, подставлять данные, проверять результат и избегать ошибок.

Текстовый шаблон в 1С — это заготовка фразы или документа, в которой переменные части заменяются на актуальные данные из информационной базы. Используется для писем клиентам, уведомлений, актов, спецификаций и других выходящих сообщений.

В типовых конфигурациях шаблоны чаще всего оформляются как общие макеты типа «Текст», хотя в некоторых решениях встречаются отдельные справочники или регистры с текстовыми полями. Место хранения зависит от конфигурации и версии платформы.

Перед созданием шаблона уточните, где система ожидает текст: в печатной форме, в отправке по электронной почте, в SMS или в печатном бланке. От этого зависит способ подстановки данных и проверки результата.

Самостоятельная правка шаблонов безопасна, если вы не меняете структуру конфигурации и не затрагиваете регламентированные формы. Иначе возможны ошибки при обновлении или потеря данных.

Где хранятся текстовые шаблоны в 1С

Основное место хранения — раздел «Общие макеты» конфигурации. Макет типа «Текст» хранится внутри базы конфигурации и доступен для редактирования в режиме конфигуратора, а не в обычном пользовательском интерфейсе.

В управляемом приложении и в классическом приложении порядок вызова макета может отличаться. Уточните в документации к конфигурации, какой объект отвечает за получение текста и как он передаётся в печатную форму или сообщение.

Доступ к макету настраивается через права пользователей и роли. Если роль не включает чтение общего макета, шаблон не откроется у пользователя даже при правильно написанном коде.

Создание общего макета типа Текст

Откройте конфигурацию в режиме разработки, перейдите в раздел «Общие макеты» и создайте новый макет. Укажите тип «Текст», задайте понятное имя и сохраните изменения. После этого макет становится доступен для программного использования.

Порядок действий
  1. 1
    Откройте конфигурацию и раздел «Общие макеты»
  2. 2
    Создайте макет типа «Текст» с понятным именем
  3. 3
    Напишите текст с маркерами для подстановки
  4. 4
    Сохраните макет и обновите конфигурацию
  5. 5
    Проверьте подстановку на тестовых данных

В теле макета напишите постоянный текст и вставьте маркеры для заменяемых значений. Маркеры часто оформляют в виде конструкций с решёткой, например #Контрагент# или #Дата#, но точный синтаксис зависит от используемых в конфигурации средств обработки строк.

После сохранения макета выполните обновление конфигурации и проверьте, что новый объект не вызвал ошибок синтаксиса. Только после этого можно подключать шаблон к рабочим процедурам.

Маркеры и подстановка данных

Маркер — это заполнитель, который программа заменяет на реальное значение из документа, справочника или регистра. Например, вместо #НомерДоговора# в итоговом тексте должен появиться номер текущего договора.

Общий макет типа ТекстХранит шаблон в конфигурации

Открывается в режиме конфигуратора, не в обычном пользовательском интерфейсе

МаркерыЗаменяемые фрагменты

Проверяйте их написание и соответствие данным

Подстановка обычно выполняется средствами работы со строками: поиск маркера и замена на значение. В разных конфигурациях могут использоваться свои функции или объекты шаблонов, поэтому уточните доступные инструменты в справочной информации по вашей конфигурации.

Если в шаблоне есть даты, суммы или проценты, форматируйте их перед подстановкой в соответствии с требованиями получателя. Иначе в письме или документе может появиться неудобный для чтения вид числа или даты.

Вставка шаблона в печатную форму или рассылку

Получите общий макет программно, извлеките его текст, выполните замену маркеров и передайте результат в целевой объект: печатную форму, письмо, сообщение или печатный бланк. Способ вывода зависит от типа задачи.

Для рассылок проверьте, что кодировка текста соответствует каналу отправки, а длина сообщения не превышает ограничений почтовой или SMS-службы. В печатных формах убедитесь, что текст помещается в отведённую область.

Если шаблон используется в нескольких местах, храните его в одном общем макете, а не дублируйте текст в разных процедурах. Это упрощает поддержку и снижает риск расхождения версий.

Проверка результата и ограничения

После подключения шаблона проведите тестовую генерацию на выборочных данных. Убедитесь, что все маркеры заменены, нет лишних пробелов и переносов, а данные соответствуют исходному документу.

Обычный текстовый макет не поддерживает сложное форматирование, изображения и таблицы внутри текста. Для оформленных документов с логотипами и разметкой используйте печатные формы или макеты другого типа, если конфигурация это позволяет.

Контрольные точки

Как проверить результат

Все маркеры заменены
Норма

В тексте нет необработанных меток

Тревожный признак

Остались конструкции вида #Имя#

Права пользователя
Норма

Макет доступен для чтения

Тревожный признак

Ошибка доступа при открытии документа

Поведение шаблонов может различаться между версиями платформы 1С и конфигураций. Перед массовым использованием проверьте шаблон на той же версии, которая установлена в производственной базе.

Типичные ошибки при работе с шаблонами

Опечатка в маркере приводит к выводу метки вместо значения, что делает документ некорректным. Изменение макета без проверки на тестовых данных может сломать рассылку или печатную форму для всех пользователей.

Типичные ошибки
01
Опечатка в маркере приводит к выводу метки вместо значения
02
Изменение макета без проверки на тестовых данных ломает рассылку

Не храните конфиденциальные данные в открытом текстовом макете, если к макету имеют доступ широкие группы пользователей. Чувствительную информацию выводите отдельно, с учётом прав доступа.

Не правьте шаблон прямо в рабочей базе без резервной копии. Ошибка в тексте или коде подстановки может повлиять на уже сформированные документы и требовать повторной обработки.

Итог

Что важно запомнить

Шаблон создаётся в конфигураторе, заполняется маркерами, подключается через процедуры и проверяется на тестовых данных перед вводом в эксплуатацию.

Можно ли редактировать текстовый шаблон без конфигуратора?

Обычно нет: общие макеты типа «Текст» править в режиме конфигуратора. Некоторые конфигурации могут вынести тексты в справочники или настройки, доступные пользователям, но это зависит от конкретного решения.

Что делать, если маркер не заменился на значение?

Проверьте точное написание маркера в шаблоне и в коде подстановки, убедитесь, что данные существуют в выбранном документе, и протестируйте замену на тестовой выборке перед массовой отправкой.

Поддерживают ли текстовые шаблоны форматирование и таблицы?

Обычный макет типа «Текст» предназначен для простого текста без сложного оформления. Для таблиц, изображений и разметки используйте печатные формы или другие типы макетов, предусмотренные конфигурацией.

Нужно ли резервное копирование перед правкой шаблона?

Да, перед изменением общих макетов или конфигурации создайте резервную копию базы. Это позволит откатить изменения, если правка нарушит работу печатных форм или рассылок.

Как проверить, что шаблон доступен пользователю?

Откройте документ или запустите рассылку под учётной записью пользователя с ограниченными правами. Если текст подставился без ошибок доступа, права на общий макет настроены верно.