Как сделать шаблоны текста в 1С

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

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

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

Где находятся шаблоны и как их включить

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

Чтобы шаблоны срабатывали при наборе кода, нужно включить автозамену. Откройте «Сервис → Параметры», перейдите на вкладку «Модули» и в разделе «Контекстная подсказка» установите флажок «Включить автозамену». Без этой настройки вставка шаблона возможна только вручную — через диалог выбора.

Основные сочетания клавиш при работе с шаблонами:

• Ctrl+Q — вставка шаблона по введённому имени (автозамена);
• Ctrl+Shift+Q — открытие списка шаблонов для выбора вручную;
• переход между параметрами вставленного шаблона — клавишей Tab или по клику.

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

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

Порядок создания:

1. Откройте «Текст → Шаблоны текста…» и нажмите кнопку добавления файла.
2. Укажите имя и расположение нового файла, например МоиШаблоны.st. Удобно хранить его в папке, доступной с рабочего места, либо в сетевом каталоге для команды.
3. Отметьте файл флажком, чтобы он стал активным.
4. Откройте файл на редактирование и добавьте первый шаблон.

1. 1
   Откройте окно «Шаблоны текста» и выберите свой файл .st
2. 2
   Нажмите «Добавить» и задайте имя шаблона, например «ОбходВыборки»
3. 3
   В поле текста введите код, пометив изменяемые места угловыми скобками: <Запрос>, <Выборка>
4. 4
   Сохраните файл и проверьте вставку: наберите имя шаблона в модуле и нажмите Ctrl+Q
5. 5
   Заполните параметры и убедитесь, что код компилируется

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

Синтаксис шаблона: параметры и автозамена

Каждый шаблон состоит из имени (строки автозамены) и текста для вставки. Имя должно быть коротким и уникальным — именно его вы набираете в редакторе перед нажатием Ctrl+Q.

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

Пример простого шаблона обхода результата запроса:

Выборка = <Запрос>.Выполнить().Выбрать();
Пока Выборка.Следующий() Цикл
<>
КонецЦикла;

Пустые угловые скобки <> обозначают позицию, куда встанет курсор для ввода тела цикла. Такой приём удобен для мест, где заранее неизвестно, что будет написано.

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

Практические сценарии использования

Типовые конструкции кода

Самый частый сценарий — шаблоны для повторяющихся конструкций: циклы, условия, попытки-исключения, обходы табличных частей, работа с запросами. Такие шаблоны экономят время и снижают число синтаксических ошибок: скобки, «КонецЕсли» и «КонецЦикла» уже стоят на месте.

Стандартные комментарии и заголовки

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

Шаблоны запросов

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

Перенос шаблонов и работа в команде

Файл .st — обычный файл, его можно скопировать на другой компьютер и подключить там через тот же диалог «Шаблоны текста». Для команды разработки удобно разместить общий файл в сетевом каталоге или в репозитории рядом с проектом и подключать его всем участникам.

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

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

Проверка результата и типичные ошибки

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

Ограничения механизма и альтернативы

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

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

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