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

Разработка и Конфигурация · 10 мин

Как включить шаблон текста в 1С

Как включить шаблоны текста в 1С: включение подстановки, работа с файлами .st, сочетание Ctrl+Q, создание собственных шаблонов и решение типичных проблем.

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

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

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

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

Шаблон текста — это фрагмент кода с заранее заданной структурой. Например, шаблон «Если» разворачивается в полную конструкцию «Если … Тогда … КонецЕсли;», а шаблон «Процедура» создаёт заготовку с описанием, заголовком и окончанием процедуры. Курсор автоматически встаёт в позицию, где нужно ввести переменную часть.

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

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

Включение контекстной подсказки и автоподстановки

Основная настройка находится в параметрах конфигуратора. Откройте меню Сервис → Параметры, перейдите на вкладку Модули и выберите раздел Контекстная подсказка. Здесь собраны переключатели, управляющие подстановкой шаблонов, ключевых слов и свойств объектов.

Убедитесь, что включены опции автоматической подстановки при наборе текста и подстановка по Ctrl+Q. Если флажки сняты, шаблоны не будут разворачиваться ни автоматически, ни по комбинации клавиш. После изменения настроек нажмите «ОК» — перезапуск конфигуратора обычно не требуется.

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

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

Подключение файлов шаблонов

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

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

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

Как пользоваться шаблонами в модуле

Базовый сценарий: наберите начало имени шаблона (например, «для», «если», «пока») и нажмите Ctrl+Q. Если вариант один — он развернётся сразу; если несколько — появится список для выбора стрелками и Enter.

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

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

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

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

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

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

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

Стандартные и собственные шаблоны

Стандартные шаблоны платформы

Подходят для базовых конструкций языка; обновляются вместе с платформой, редактировать их напрямую не рекомендуется.

Собственные файлы .st

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

Типичные проблемы и их решение

Чаще всего жалоба звучит так: «Ctrl+Q не работает». Причин несколько, и проверять их стоит по порядку: включена ли контекстная подсказка в параметрах, подключены ли файлы .st, не перехвачена ли комбинация клавиш другой программой (некоторые утилиты и раскладки клавиатуры занимают Ctrl+Q).

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

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

Типичные ошибки
01
Редактирование стандартного файла шаблонов — после обновления платформы изменения теряются.
02
Хранение собственного .st в каталоге платформы — при переустановке файл можно удалить вместе с программой.
03
Снятый флажок стандартных шаблонов при отсутствии своих файлов — список оказывается пустым, и кажется, что функция сломана.
04
Проверка Ctrl+Q в режиме «Предприятие» — там механизм не работает, и это не признак неисправности.
Контрольные точки

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

Подстановка по Ctrl+Q в модуле
Норма

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

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

Ничего не происходит или появляется пустой список

Панель «Шаблоны текста»
Норма

В дереве видны стандартные и собственные шаблоны

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

Панель пуста — файлы .st не подключены

Автоподстановка при наборе
Норма

После ввода начала имени появляется подсказка

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

Подсказки нет — проверьте параметры контекстной подсказки

Ограничения и безопасная работа

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

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

FAQ

Почему Ctrl+Q не срабатывает, хотя подсказка включена?

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

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

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

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

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

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

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

Шаблон разворачивается не полностью или с ошибкой — в чём причина?

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

Нужно ли перезапускать конфигуратор после изменения настроек?

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

Итог

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

Шаблоны текста включаются в два шага: активируйте контекстную подсказку в параметрах конфигуратора и подключите файлы .st через окно «Шаблоны текста». Работает механизм только в модулях конфигуратора, вызывается по Ctrl+Q, а собственные шаблоны храните в отдельном файле с резервной копией.