Автодополнение, синтакс-помощник и подсказки полей в конфигураторе 1С 8.3

Подсказки в конфигураторе 1С включаются в меню Сервис → Параметры → Модули, а вызываются вручную сочетанием Ctrl+Space прямо в тексте модуля. Подсказка по параметрам метода — Ctrl+Shift+Space, описание слова под курсором в синтакс-помощнике — Ctrl+F1. Этого хватает в девяти случаях из десяти: автоматический показ списка после точки обычно уже включён, его просто перехватывает что-то другое.

Подсказок в конфигураторе несколько, и настраиваются они в разных местах. Разработчику нужна контекстная подсказка в редакторе модулей. Пользователю базы — подсказки к полям документов и справочников, которые разработчик задаёт в свойствах объектов. Ниже оба уровня, от редактора кода до всплывающих пояснений на формах. Всё описано для платформы 8.3 с интерфейсом «Такси»; настройки редактора общие для любой конфигурации — БП, ЗУП, УТ или своей.

Какие подсказки есть в конфигураторе и чем они отличаются

Под словом «подсказка» в конфигураторе скрываются разные механизмы. Путаница между ними — главная причина вопросов «включил, а не работает ».

Первые четыре строки — инструменты программиста. Они ускоряют набор кода и избавляют от опечаток в именах реквизитов. Последние две разработчик заполняет для бухгалтеров и кладовщиков, чтобы те не звонили с вопросом «что писать в этом поле».

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

Контекстная подсказка — выпадающий список, который появляется после точки: Справочники. → список справочников, Запрос. → методы и свойства запроса. Настройка хранится в параметрах конфигуратора, а не в самой базе, поэтому действует для текущего пользователя Windows.

Шаг 1. Откройте параметры

1. Запустите базу в режиме «Конфигуратор».
2. Откройте меню Сервис → Параметры.
3. Перейдите на вкладку Модули.
4. Внутри неё найдите подраздел Контекстная подсказка.

Шаг 2. Проверьте флажки автоматического показа

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

💡 Задержку не стоит ставить нулевой. При 0 мс список выскакивает на каждой букве и мешает печатать. Комфортный диапазон — 300–700 мс: успеваете набрать начало имени, и список сразу отфильтрован.

Шаг 3. Примените и проверьте

1. Нажмите ОК.
2. Откройте любой модуль, например модуль объекта документа.
3. Наберите Справочники и поставьте точку.

Должен появиться список справочников конфигурации. Если его нет, нажмите Ctrl+Space вручную. Появился по сочетанию, но не сам — дело в флажке автоматического показа. Не появился вообще — переходите к разделу о неполадках.

Язык подсказок: русский или английский

На вкладке Общие тех же параметров есть выбор варианта встроенного языка. От него зависит, на каком языке подсказка предлагает ключевые слова и методы: Если … Тогда или If … Then. Если в списке внезапно появились английские имена, проверьте эту настройку. Код в модуле при этом не переводится, меняются только варианты подстановки.

Сочетания клавиш и расширенные приёмы для разработчика

Автоматический список — только начало. Опытный программист 1С пользуется ещё несколькими инструментами, которые включать не нужно — достаточно знать клавиши.

Подсказка о параметрах метода

Поставьте курсор внутрь скобок после имени метода и нажмите Ctrl+Shift+Space. Появится строка с перечнем параметров, текущий выделен. Для методов с несколькими вариантами вызова, вроде Найти или Вставить, стрелками перелистываются варианты синтаксиса.

Синтакс-помощник по слову под курсором

Курсор на имени метода → Ctrl+F1. Откроется синтакс-помощник сразу на нужной статье: описание, параметры, возвращаемое значение, доступность на клиенте и сервере. Полное окно доступно через меню Справка → Синтакс-помощник, там есть поиск по индексу.

💡 Строка «Доступность» в статье синтакс-помощника отвечает на частый вопрос, почему метод не находится в клиентском модуле: он может быть доступен только на сервере.

Переход к определению

Курсор на имени своей процедуры или функции → F12. Конфигуратор откроет модуль, где она объявлена. Удобно вместе с подсказкой: видно, какие параметры процедура ждёт и что внутри.

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

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

Пример шаблона обхода выборки запроса:

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

Набираете строку подстановки, жмёте Ctrl+Q — и вместо трёх строк печатаете одну.

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

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

Конфигуратор не знает тип переменной

Подсказка показывает методы, только если тип значения известен в момент набора. Платформа выводит его из присваивания:

Запрос = Новый Запрос;   // тип известен — после точки будут методы запроса
Запрос.                  // подсказка работает

Процедура Обработать(Документ)
	Документ.            // тип параметра неизвестен — подсказки по реквизитам нет
КонецПроцедуры

У параметров процедур, значений из ТаблицаЗначений и результатов функций с произвольным типом конфигуратор не знает, что лежит в переменной. Список будет пустым или покажет только общие свойства. Это не поломка, а ограничение редактора.

Обход для параметров: на время написания кода объявите локальную переменную с известным типом, например Ссылка = Документы.РеализацияТоваровУслуг.ПустаяСсылка();, наберите нужные обращения через неё, затем замените имя.

Сочетание Ctrl+Space перехвачено системой

Windows и программы-переключатели раскладки любят занимать Ctrl+Space. Китайская и японская раскладки используют его для своего метода ввода, некоторые переключатели — для смены языка. Конфигуратор нажатие просто не получает.

Проверка простая: если автоматический список после точки работает, а Ctrl+Space нет — перехват. Отключите это сочетание в параметрах языка Windows или в настройках переключателя.

Синтаксическая ошибка выше курсора

Незакрытая строка, лишняя кавычка или пропущенный КонецЕсли сбивают разбор модуля. Подсказка начинает работать странно: пропадает в одном месте и появляется в другом. Запустите проверку синтаксиса Ctrl+F7 и исправьте найденное.

Подсказка внутри текста запроса

Внутри строки Запрос.Текст = "…" автодополнение по таблицам базы не работает: для редактора это обычная строка. Для запросов пользуйтесь конструктором: правый клик внутри строки → Конструктор запроса. Он покажет все таблицы и поля.

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

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

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

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

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

Свойство «Подсказка» у реквизита

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

1. Откройте объект метаданных, например справочник Номенклатура, двойным щелчком.
2. На закладке Данные выделите реквизит.
3. Откройте палитру свойств (Alt+Enter).
4. Заполните поле Подсказка: коротко, что вводить и в каком формате.

Пример хорошей подсказки: «Код ТН ВЭД из 10 цифр, без пробелов. Обязателен для товаров под прослеживаемостью». Пример плохой: «Код ТН ВЭД» — он просто повторяет название поля.

Как подсказка отображается на форме

На управляемой форме у элемента есть свойство ОтображениеПодсказки. Оно определяет, как текст увидит пользователь:

• 🔹 Авто — платформа решает сама, обычно всплывающая подсказка при наведении;
• 🔹 Кнопка — рядом с полем появляется значок «?», текст по нажатию;
• 🔹 Всплывающая — текст при наведении мыши;
• 🔹 ОтображатьСверху, ОтображатьСнизу, ОтображатьСлева, ОтображатьСправа — текст постоянно виден рядом с полем;
• 🔹 Нет — подсказка скрыта.

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

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

Подсказки в отчётах

В отчётах на СКД подсказки нужны прежде всего к параметрам и отборам. Заголовки и подсказки параметров задаются в схеме компоновки и в реквизитах отчёта. Для параметра «Период» пояснять обычно нечего, а вот для отбора «Вариант учёта» или «Только с остатками» одна фраза снимает половину вопросов.

Справочная информация и внешние источники помощи

Когда короткой подсказки мало, у объекта есть полноценная справка. Её открывают в контекстном меню объекта метаданных в дереве конфигурации — пункт Справочная информация. Откроется редактор HTML-страницы, где можно писать текст, вставлять таблицы и картинки.

Чтобы справка открывалась пользователю по F1, проверьте два момента:

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

В режиме 1С:Предприятие пользователь нажимает F1 на форме документа — и видит вашу страницу.

Чем дополнить штатные подсказки

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

В EDT подсказка по параметрам процедуры работает, если в комментарии над процедурой описаны параметры и их типы в формате стандарта комментирования. В конфигураторе тот же комментарий полезен для коллег, но тип переменной редактор из него не выводит.

💡 Шаблоны текста хранятся в файле и легко передаются коллегам: экспортируйте их из окна Сервис → Шаблоны текста и подключите на другом рабочем месте. Так вся команда пишет циклы и запросы одинаково.

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