Профессия — 1С

Шаблоны текста

рубрики: Разное | Дата: 15 июня, 2017

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

Диалоговое окно шаблонов текста

Открыть окно с шаблонами текста можно тремя способами

Выбрать в меню конфигуратора Сервис —> Шаблоны текста
Воспользоваться кнопкой на панели инструментов
С помощью горячих клавиш Shift+Ctrl+T

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

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

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

Примеры использования

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

Создание функции с помощью шаблона

Итак, в секции Управляюющие найдем вот такой шаблон — Функция модуля формы (Функ[ция]). Откроем его и посмотрим из чего он состоит

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

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

Выбираем НаСервере. И наконец нам предлагают указать имя функции. Назовем ее Тестовая.

В итоге в окне редактирования кода получаем вот такую заготовку для функции:




// <Описание функции>
//
// Параметры:
//  <Параметр1>  - <Тип.Вид> - <описание параметра>
//                 <продолжение описания параметра>
//  <Параметр2>  - <Тип.Вид> - <описание параметра>
//                 <продолжение описания параметра>
//
// Возвращаемое значение:
//   <Тип.Вид>   - <описание возвращаемого значения>
//
&НаСервере
Функция Тестовая()



КонецФункции // Тестовая()

Согласитесь, что время, сэкономленное на наборе кода весьма существенное.

Текст запроса с обходом результата с помощью шаблона

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

Здесь мы видим, что в имени шаблона нет никакой информации в скобках. Это означает, что ему не назначена строка автозамены, поэтому в код мы можем его добавить только перетаскиванием мышкой. После чего у нас открывается стандартный конструктор запроса. Создадим элементарный запрос, выбрав все элементы из справочника Склады.

После нажатия кнопки ОК получаем в окне редактирования текст запроса с обходом результата:




Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ
|	Склады.Ссылка
|ИЗ
|	Справочник.Склады КАК Склады";

Результат = Запрос.Выполнить();
Выборка = Результат.Выбрать();

Пока Выборка.Следующий() Цикл



КонецЦикла;

Остается только написать код внутри цикла.

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

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

Дадим ему имя МоиШаблоны и добавим новый шаблон МойКод в котором пропишем фамилию и воспользовавшись кнопкой Вставка добавим специальный запрос, который будет подставлять текущую дату и время.

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


//Иванов И.И. 15.06.2017 12:39:05

А в окне с шаблонами мы видим соответствующую новую папку

Добавление и удаление шаблонов

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

И в открывшемся диалоговом окне мы легко можем отредактировать состав списка.

На этом рассказ о шаблонах текста заканчиваю. Желаю всем быстрого кода.

Добавить комментарий Отменить ответ

2014 - 2023г. Профессия — 1С. Обмен опытом по программированию в 1С