Разработка и Конфигурация · 10 мин
Как включить синтакс-помощник в 1С
Как открыть и использовать синтакс-помощник в 1С: горячие клавиши, поиск по описанию, контекстная подсказка, настройка и типичные ошибки при работе.
Синтакс-помощник — встроенный справочный инструмент конфигуратора 1С, который содержит описание всех объектов встроенного языка, их свойств, методов, событий и конструкторов. Он нужен разработчику и внедренцу постоянно: уточнить сигнатуру метода, посмотреть пример использования, проверить, в каких контекстах (тонкий клиент, веб-клиент, сервер) доступна конкретная функция.
Инструмент доступен только в конфигураторе — в режиме «1С:Предприятие» его нет, поскольку он предназначен для разработки, а не для работы пользователей. Для открытия не требуются специальные права: достаточно запустить конфигуратор с учётной записью, имеющей доступ к разработке.
Ниже разобраны все способы вызова синтакс-помощника, приёмы поиска информации в нём, настройка отображения и типичные проблемы, с которыми сталкиваются начинающие разработчики.
Способы открыть синтакс-помощник
Основной способ — меню конфигуратора. Откройте конфигуратор, в верхнем меню выберите пункт «Справка», затем «Синтакс-помощник». Окно помощника откроется в отдельной панели, обычно в правой части окна конфигуратора, и останется доступным, пока вы работаете с модулями.
Быстрый способ — сочетание клавиш Ctrl+Shift+F1. Оно работает из любого окна конфигуратора и открывает помощник с корневого раздела содержания. Это удобно, когда нужно начать поиск «с нуля», не привязываясь к текущему коду.
Третий вариант — контекстный вызов. Поставьте курсор на имя метода, свойства или функции в тексте модуля и нажмите Ctrl+F1 (или выберите в контекстном меню правой кнопки мыши пункт «Синтакс-помощник»). Откроется описание именно этого элемента, что экономит время на ручном поиске.
- 1Запустите конфигуратор 1С и откройте нужную информационную базу
- 2Выберите в меню «Справка — Синтакс-помощник» или нажмите Ctrl+Shift+F1
- 3Для подсказки по конкретному методу поставьте на него курсор в модуле и нажмите Ctrl+F1
- 4Используйте вкладки «Содержание», «Индекс» и «Поиск» для навигации по описанию
Структура окна и навигация по разделам
Окно синтакс-помощника состоит из двух частей: слева — панель навигации с вкладками «Содержание», «Индекс» и «Поиск», справа — область отображения описания выбранного элемента. Размер панелей можно менять перетаскиванием границы, а само окно — закреплять или откреплять от основного окна конфигуратора.
Вкладка «Содержание» показывает дерево разделов: общие объекты, прикладные объекты, интерфейсные механизмы, работа с файлами и так далее. Разделы раскрываются иерархически — от объекта к его методам, свойствам и событиям. Это удобно, когда нужно изучить возможности целого объекта, например всех методов таблицы значений.
Вкладка «Индекс» — это алфавитный список всех элементов встроенного языка. Начните вводить имя метода — список автоматически прокрутится к подходящим позициям. Двойной щелчок открывает описание. Индекс полезен, когда вы помните название метода, но не знаете, к какому объекту он относится.
Поиск информации по описанию
Вкладка «Поиск» позволяет искать по тексту описаний, а не только по именам. Введите ключевое слово — например, «проведение» или «XML» — и помощник покажет все страницы, где оно встречается. Результаты можно сортировать и открывать двойным щелчком.
При поиске учитывайте, что встроенный язык 1С двуязычный: большинство методов имеют русское и английское написание (Найти / Find, НайтиПоНаименованию / FindByDescription). Если поиск по русскому варианту ничего не дал, попробуйте английский синоним, и наоборот.
На странице описания обращайте внимание на блок «Доступность» — там перечислено, в каких клиентах и режимах работает метод (тонкий клиент, веб-клиент, сервер, внешнее соединение). Это критично: метод, доступный только на сервере, вызовет ошибку при выполнении в клиентском контексте.
Контекстная подсказка в модуле
Контекстный вызов через Ctrl+F1 — самый продуктивный режим работы. Курсор может стоять на любом месте имени метода: помощник определит границы идентификатора и откроет соответствующую страницу. Если элемент относится к нескольким объектам (например, метод «Найти» есть у многих менеджеров), будет предложен список вариантов для выбора.
Дополнительно в редакторе модулей работает контекстная подсказка по Ctrl+Пробел: при вводе имени объекта и точки появляется список доступных методов и свойств. Выбранный элемент можно сразу изучить — кнопка вызова синтакс-помощника есть прямо в окне подсказки. Сочетание этих двух механизмов закрывает большинство потребностей при написании кода.
Учтите ограничение: контекстная подсказка и Ctrl+F1 корректно работают только для элементов встроенного языка и объектов конфигурации. Для переменных и процедур вашего собственного модуля помощник описания не покажет — там помогут переход к определению (F12 в новых версиях платформы) и всплывающие подсказки.
Настройка отображения и языка
По умолчанию синтакс-помощник показывает описания на языке, соответствующем языку конфигуратора. Если конфигурация разрабатывается с использованием английского варианта встроенного языка, проверьте настройки: «Сервис — Параметры», раздел, отвечающий за язык интерфейса и встроенного языка. Несовпадение языка кода и языка помощника затрудняет поиск.
Окно помощника можно сделать плавающим или закрепить в нужной части экрана — перетащите его за заголовок. При работе на двух мониторах удобно вынести помощник на второй экран, чтобы код и описание были видны одновременно. Конфигуратор запоминает расположение окон между сеансами.
Если панель помощника случайно закрыта, достаточно снова нажать Ctrl+Shift+F1 — окно вернётся в последнее сохранённое положение. Отдельной «включения» в настройках инструмент не требует: он встроен в платформу и не отключается.
Как проверить результат
Открывается окно с деревом содержания и вкладками «Индекс», «Поиск»
Окно не появляется или конфигуратор не реагирует на клавиши
Открывается страница описания именно этого метода
Открывается корневой раздел или появляется сообщение, что описание не найдено
Перечислены контексты: тонкий клиент, сервер и т.д.
Нужного контекста нет в списке — метод там не работает
Типичные ошибки и ограничения
Частая ошибка новичков — попытка открыть синтакс-помощник в режиме «1С:Предприятие». Там его нет по определению: это инструмент разработчика. Если вы работаете только в пользовательском режиме, запустите конфигуратор той же базы через ярлык или из стартера с параметром DESIGNER.
Вторая ошибка — поиск описания методов прикладной конфигурации в синтакс-помощнике. Помощник документирует только встроенный язык платформы. Методы общих модулей конкретной конфигурации (например, функции БСП) в нём не описаны — их смотрят в коде самих модулей и в комментариях разработчиков конфигурации.
Третья проблема — устаревшая версия платформы. Состав встроенного языка меняется от релиза к релизу: новые методы появляются, старые помечаются как устаревшие. Если в найденном примере кода используется метод, которого нет в вашем помощнике, скорее всего, платформа старше той, для которой написан пример. Обновление платформы в этом случае согласуйте с администратором — оно влияет на всех пользователей базы.
Как выбрать действие
Альтернативные источники справки
Синтакс-помощник — не единственный источник. В состав поставки платформы входит документация (руководство разработчика), доступная через меню «Справка». Она описывает не только синтаксис, но и архитектурные концепции: механизмы проведения, обмен данными, модель безопасности.
Встроенная подсказка редактора кода (Ctrl+Пробел, всплывающие описания при наведении) закрывает оперативные вопросы без открытия отдельного окна. Для глубокого изучения объектов конфигурации полезна палитра свойств и окно «Конфигурация — Открыть конфигурацию», где видны реальные типы реквизитов и табличных частей.
Для решения прикладных задач, выходящих за рамки синтаксиса, используются официальные ресурсы фирмы «1С» и документация конкретной конфигурации. Но по вопросам «какие параметры принимает метод» синтакс-помощник остаётся самым быстрым и всегда доступным офлайн-источником.
Что важно запомнить
Синтакс-помощник открывается в конфигураторе клавишами Ctrl+Shift+F1, контекстная подсказка по методу — Ctrl+F1. Работайте с вкладками «Содержание», «Индекс» и «Поиск», всегда проверяйте раздел «Доступность» метода и помните: помощник описывает только встроенный язык платформы, а не код вашей конфигурации.
Частые вопросы
Почему Ctrl+F1 не открывает описание метода?
Чаще всего курсор стоит не на имени элемента встроенного языка, а на переменной или процедуре вашего модуля — для них описания в помощнике нет. Также проверьте, что имя написано без опечатки: помощник ищет точное совпадение. Если метод точно платформенный, попробуйте найти его через вкладку «Индекс» вручную.
Можно ли пользоваться синтакс-помощником без конфигуратора?
Нет, это компонент конфигуратора. В режиме «1С:Предприятие» он недоступен. Если нужен справочник без запуска конфигуратора, используйте документацию из поставки платформы или официальные ресурсы разработчика.
Как искать метод, если не помню точное название?
Откройте вкладку «Индекс» и начните вводить предполагаемое начало имени — список прокрутится к совпадениям. Если и это не помогает, перейдите на вкладку «Поиск» и введите ключевое слово задачи, например «файл» или «запрос». Попробуйте оба языка: русский и английский вариант слова.
Почему в моём помощнике нет метода из примера в интернете?
Наиболее вероятная причина — версия платформы старше той, в которой метод появился. Проверьте версию через «Справка — О программе» в конфигураторе. Обратная ситуация тоже возможна: метод устарел и в новых версиях заменён другим — тогда в описании старого метода указана рекомендуемая замена.
Что означает блок «Доступность» в описании метода?
Он перечисляет контексты выполнения, где метод работает: тонкий клиент, веб-клиент, толстый клиент, сервер, внешнее соединение, мобильное приложение. Если нужного контекста нет в списке, вызов метода в нём приведёт к ошибке времени выполнения. Это особенно важно при разработке клиент-серверного кода, где часть логики выполняется на сервере.
Описывает ли синтакс-помощник методы общих модулей конфигурации?
Нет. Помощник документирует только встроенный язык платформы и типы, создаваемые платформой. Процедуры и функции общих модулей конкретной конфигурации изучайте непосредственно в их коде — там обычно есть комментарии с описанием параметров и возвращаемых значений.