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

Другое · 9 мин

Процедуры и функции 1С: где найти и как использовать

Где искать процедуры и функции в 1С: синтакс-помощник, дерево конфигурации, модули объектов и общих модулей, глобальный контекст и подсказки разработчика.

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

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

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

Где ищутся встроенные процедуры и функции 1С

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

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

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

Встроенный элементДоступен без модуля

Ищется в синтакс-помощнике и подсвечивается редактором

Свой элементПринадлежит модулю

Ищется в дереве конфигурации по модулям

Глобальный контекстОбщая область видимости

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

Свои процедуры и функции в дереве конфигурации

Собственные процедуры и функции создаются разработчиком внутри модулей конфигурации. Каждый такой элемент принадлежит конкретному модулю: объекту справочника, документу, регистру, форме, общему модулю или другому объекту. Чтобы найти нужную процедуру, нужно знать, в каком модуле она описана.

Поиск по дереву конфигурации

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

В контекстном меню модуля есть команда перехода к определению процедуры или функции, если имя известно. Это позволяет быстро открыть место объявления и посмотреть параметры, переменные и алгоритм. Если процедура экспортируемая, она видна из других модулей; если не экспортируемая — только внутри своего модуля.

Порядок действий
  1. 1
    Определите, какой модуль содержит нужную процедуру или функцию
  2. 2
    Откройте дерево конфигурации и разверните соответствующий модуль
  3. 3
    Найдите имя процедуры или функции в тексте модуля
  4. 4
    Проверьте экспортность и сигнатуру перед вызовом

Глобальный контекст и общие модули

Глобальный контекст объединяет встроенные возможности платформы и некоторые общие элементы, доступные из любого места кода. Процедуры и функции из глобального контекста не требуют указания модуля при вызове. Это ускоряет написание кода, но требует точного знания имён и сигнатур.

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

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

Поиск через синтакс-помощник и подсказки кода

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

Поиск по коду конфигурации позволяет найти все места объявления и вызова процедуры или функции по имени. Это полезно, когда нужно понять, где используется существующий элемент, или найти дублирующую логику. Результаты поиска показывают модуль и строку, что упрощает навигацию.

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

Отличие процедур от функций и признаки результата

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

Признаком корректного нахождения процедуры или функции является успешное открытие её объявления, корректная подсказка сигнатуры и отсутствие ошибок компиляции при вызове. Если редактор не распознаёт имя, возможно, элемент не экспортирован, находится в недоступном модуле или опечатка в имени.

Контрольные точки

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

Открытие объявления
Норма

Редактор переходит к коду процедуры или функции

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

Имя не распознаётся или открывается другой элемент

Сигнатура вызова
Норма

Подсказка показывает параметры и тип результата

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

Количество или типы параметров не совпадают

Компиляция
Норма

Конфигурация сохраняется без ошибок синтаксиса

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

Появляются ошибки отсутствующей процедуры или функции

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

Частые ошибки и границы самостоятельной работы

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

Типичные ошибки
01
Искать свою процедуру только в синтакс-помощнике, хотя она в модуле конфигурации
02
Вызывать неэкспортную функцию из другого модуля, вызывая ошибку доступа
03
Пытаться присвоить результат вызова процедуры переменной

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

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

Итог

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

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

Часто задаваемые вопросы

Где найти встроенную процедуру или функцию 1С?

Встроенные элементы языка находятся в синтакс-помощнике и доступны из глобального контекста. Редактор кода подсказывает их при вводе и показывает сигнатуру вызова.

Как найти свою процедуру в конфигурации?

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

Можно ли вызвать неэкспортную функцию из другого модуля?

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

Что делать, если редактор не видит процедуру или функцию?

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

Нужно ли проверять режим выполнения перед вызовом?

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