Шаблоны текста в 1С: как создать и использовать

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

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

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

Что такое шаблон текста и где он хранится

Шаблон текста — это именованный фрагмент кода, который платформа подставляет в модуль по команде разработчика. Шаблон может содержать статичный текст, переменные части (теги замены) и инструкции автоподстановки, которые сами заполняют дату, имя пользователя или другие значения.

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

Как включить и подключить файл шаблонов

Откройте конфигуратор и перейдите в меню «Сервис → Параметры». На вкладке «Модули» найдите группу настроек «Шаблоны текста» (в разных версиях платформы она может называться «Тексты модулей» — «Шаблоны текста»). Здесь задаётся режим автозамены и список подключённых файлов.

Нажмите кнопку добавления и укажите путь к файлу .st. Стандартный файл поставки обычно лежит в каталоге установки платформы, в подкаталоге с шаблонами. Свой файл можно разместить в любой папке, к которой есть доступ на чтение, — например, в общем сетевом каталоге для всей команды.

1. 1
   Откройте «Сервис → Параметры» в конфигураторе
2. 2
   Перейдите на вкладку настроек модулей и найдите раздел шаблонов текста
3. 3
   Включите использование шаблонов, если флажок снят
4. 4
   Добавьте путь к своему .st-файлу в список файлов шаблонов
5. 5
   Перезапустите конфигуратор или заново откройте модуль и проверьте вызов шаблона

Как создать свой шаблон текста

Самый простой способ — открыть существующий .st-файл в текстовом редакторе или прямо в конфигураторе и добавить новый блок по образцу имеющихся. Файл имеет строгую структуру: заголовок с количеством шаблонов, затем блоки, каждый из которых начинается служебной строкой с именем и сокращением шаблона.

Альтернативный путь — использовать встроенный редактор шаблонов: в некоторых версиях платформы доступен пункт контекстного меню «Шаблоны текста» при редактировании модуля, откуда можно добавить новый шаблон в подключённый файл. Учтите, что файл должен быть доступен на запись, иначе сохранение не выполнится.

{1,0,
{"МойШаблон","ЦиклПоТЗ",0,0,""},
"Для каждого <?Строка> Из <?Таблица> Цикл
	
КонецЦикла;"}

Внутри текста шаблона используются теги замены в угловых скобках с вопросительным знаком: <?Имя>. После вставки шаблона курсор последовательно переходит к каждому тегу, и разработчик вводит нужное значение. Переход между тегами выполняется клавишей Tab или автоматически после ввода.

Как вызвать шаблон в модуле

Основной способ вызова — набрать в модуле сокращение шаблона (например, «Если» или собственное сокращение) и нажать Ctrl+Q. Платформа заменит сокращение полным текстом шаблона и поставит курсор на первый тег замены.

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

Контекстные шаблоны и автоподстановка

Платформа поддерживает контекстные шаблоны: они срабатывают только в определённых местах модуля — например, внутри процедуры, внутри цикла или в области запроса. Это позволяет иметь несколько шаблонов с одним сокращением, но разным содержимым в зависимости от контекста.

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

Типичные ошибки и ограничения

Частая проблема — шаблон не вызывается после подключения файла. Причины: файл не сохранён в нужной кодировке, в заголовке файла указано неверное количество шаблонов, конфигуратор не был перезапущен после изменения настроек. Проверяйте файл в первую очередь.

Ещё одна ошибка — редактирование стандартного файла поставки. При обновлении платформы он может быть перезаписан, и все собственные шаблоны пропадут. Собственные шаблоны всегда храните в отдельном файле.

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

После создания шаблона откройте любой модуль, наберите сокращение и нажмите Ctrl+Q. Признаки корректной работы: сокращение заменяется полным текстом, курсор встаёт на первый тег замены, переход между тегами работает.

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

FAQ: частые вопросы о шаблонах текста в 1С