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

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

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

Стандартная поставка платформы уже содержит десятки готовых шаблонов: конструкции «Если…Тогда», циклы «Для…Цикл», шаблоны запросов, описания процедур и функций. Поверх них можно создавать собственные шаблоны, объединять их в файлы и переносить между рабочими местами.

Что такое шаблоны текста и где они работают

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

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

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

Самый быстрый способ — автозамена. Убедитесь, что в «Сервис → Параметры → Модули → Контекстная подсказка» включено использование шаблонов. Затем в модуле наберите сокращение, например «Процедура» или «Если», и нажмите пробел. Платформа развернёт сокращение в полноценную конструкцию и поставит курсор на первую позицию для ввода.

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

Третий вариант — контекстное меню: правый клик в модуле → «Шаблоны текста». По сути это тот же список, что и по Ctrl+Shift+Q, но вызывается мышью. Для часто используемых шаблонов эффективнее всё же запомнить сокращения — скорость набора заметно вырастает.

1. 1
   Откройте модуль в конфигураторе и поставьте курсор в нужное место
2. 2
   Наберите сокращение шаблона или нажмите Ctrl+Shift+Q
3. 3
   Выберите нужный шаблон из списка и подтвердите ввод
4. 4
   Заполните позиции подстановки: имена переменных, условия, тексты
5. 5
   Проверьте синтаксис модуля через «Конфигурация → Проверка конфигурации» или Ctrl+F7 в модуле

Навигация по позициям подстановки

После вставки шаблона курсор встаёт на первую редактируемую позицию — обычно это имя процедуры, условие или переменная. Переход между такими позициями выполняется клавишей Tab (вперёд) и Shift+Tab (назад). Это ключевой приём: не нужно трогать мышь, вся правка шаблона делается последовательным вводом.

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

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

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

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

В диалоге добавления задайте сокращение (короткое, без пробелов — именно его вы будете набирать), полное имя и текст шаблона. Внутри текста используйте угловые скобки для позиций подстановки, например <ИмяПеременной>. После сохранения шаблон сразу доступен во всех модулях.

// Пример текста собственного шаблона обработчика ошибки
Попытка
	<КодОперации>
Исключение
	ЗаписьЖурналаРегистрации("<ИмяСобытия>",
		УровеньЖурналаРегистрации.Ошибка,,,
		ОписаниеОшибки());
	ВызватьИсключение;
КонецПопытки;

Практическая рекомендация: делайте сокращения короткими, но не пересекающимися с ключевыми словами языка, если не хотите, чтобы шаблон срабатывал при обычном наборе. Например, сокращение «поп» для «Попытка…Исключение» удобнее, чем просто «по» — меньше ложных срабатываний.

Настройка, файлы шаблонов и перенос между машинами

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

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

Когда шаблоны не помогают: ограничения и альтернативы

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

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

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

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

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

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

После настройки или создания шаблона выполните короткую проверку: откройте тестовый общий модуль, наберите сокращение и убедитесь, что текст разворачивается, курсор встаёт на позиции подстановки, а Tab корректно переключает между ними. Затем заполните позиции и выполните синтаксическую проверку модуля.

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

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