1С: как добавить шаблон текста

Шаблоны текста в 1С позволяют вставлять готовые фрагменты кода или текста по короткому сокращению: набираете несколько символов, нажимаете пробел или Ctrl+Q — и среда разработки подставляет полную конструкцию «Если…Тогда…КонецЕсли», обход выборки запроса или типовой комментарий. Это заметно ускоряет работу в модуле и снижает количество синтаксических ошибок.

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

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

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

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

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

Как добавить новый шаблон: пошаговая инструкция

Основной сценарий — создание собственного шаблона через встроенный редактор. Действия одинаковы для большинства версий платформы 8.3.

1. 1
   Откройте конфигуратор и перейдите: Сервис → Шаблоны текста (или нажмите Ctrl+Shift+T в окне модуля).
2. 2
   В окне шаблонов выберите нужный файл .st в выпадающем списке или создайте новый файл командой «Новый файл».
3. 3
   Нажмите кнопку «Добавить» (значок с плюсом) — откроется форма редактирования шаблона.
4. 4
   Заполните поле «Сокращение» — короткое слово без пробелов, по которому шаблон будет вызываться.
5. 5
   Введите текст шаблона в большое поле. Для заменяемых частей используйте квадратные скобки: [ИмяПеременной].
6. 6
   Установите флажок «Включать в контекстное меню», если шаблон должен быть доступен по правой кнопке мыши.
7. 7
   Нажмите «ОК» и сохраните файл шаблонов (кнопка «Сохранить» или Ctrl+S).
8. 8
   Проверьте работу: откройте любой модуль, наберите сокращение и нажмите пробел или Ctrl+Q.

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

Заменяемые части и автоматические параметры

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

Для каждого [Строка] Из [Коллекция] Цикл
|
КонецЦикла;

Символ вертикальной черты | задаёт позицию курсора после того, как все заменяемые части заполнены. Одинаковые имена в скобках связываются: ввели значение один раз — оно подставилось во все повторы этого имени в шаблоне.

Способы вызова шаблона в модуле

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

Способы вставки шаблона

Автозамена по пробелу

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

Ctrl+Q

Универсальная команда «Подставить шаблон»: работает независимо от настройки автозамены, разворачивает набранное сокращение или открывает список.

Ctrl+Shift+T и выбор из списка

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

Контекстное меню

Правая кнопка мыши в модуле → «Шаблоны текста». Удобно для редко используемых шаблонов.

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

Перенос шаблонов на другой компьютер или базу

Шаблоны хранятся вне информационной базы, поэтому при смене компьютера или переустановке платформы они теряются. Чтобы перенести наработки, достаточно скопировать файл .st и подключить его на новом месте: Сервис → Параметры → «Тексты модулей» → «Шаблоны текста» → добавить файл в список.

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

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

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

Как проверить, что шаблон работает правильно

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

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

Вызов по сокращению

Норма

Набрали сокращение, шаблон развернулся полностью, без обрезанных строк

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

Подставляется только часть текста или ничего не происходит

Заменяемые части

Норма

Первая часть подсвечена, Tab переключает между всеми частями, повторы имени заполняются синхронно

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

Курсор стоит в конце, подсветки нет, повторы не связаны

Сохранение

Норма

После закрытия и повторного открытия конфигуратора шаблон на месте

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

Шаблон исчезает — файл не сохранён или недоступен для записи

Полезно сразу протестировать шаблон на реальном фрагменте кода: вставить, заполнить все заменяемые части и выполнить синтаксическую проверку модуля (кнопка с галочкой на панели инструментов). Это гарантирует, что в шаблоне нет опечаток, которые потом будут тиражироваться по всем модулям.

Частые вопросы

Где физически лежит файл шаблонов текста?

Точный путь зависит от версии платформы и настроек профиля. Актуальное расположение видно в конфигураторе: Сервис → Параметры → вкладка «Тексты модулей» → раздел «Шаблоны текста». Там же можно указать собственный каталог, например внутри папки с резервными копиями настроек.

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

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

Почему автозамена срабатывает, когда не нужно?

Сокращение шаблона совпадает со словом, которое вы набираете в обычном коде. Варианты решения: переименовать сокращение на более редкое, отключить автоматическую замену по пробелу и вызывать шаблоны только через Ctrl+Q, либо установить режим автозамены «С подсказкой».

Как поделиться шаблонами с коллегой?

Скопируйте свой файл .st и передайте коллеге любым способом. Он подключает файл через Сервис → Параметры → «Шаблоны текста» → добавление в список. Никаких дополнительных настроек базы не требуется, шаблоны не зависят от конфигурации.

Работают ли шаблоны текста в режиме «Предприятие»?

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

Что делать, если файл шаблонов повредился?

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