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

Другое · 6 мин

Где в 1С находится код выполняемой функции

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

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

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

Функция в общем модулеКод находится в ветке «Общие модули»

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

Функция в объектеКод в модуле справочника, документа или другого объекта

Откройте модуль объекта в дереве конфигурации

Функция в формеКод в модуле формы управляемого или обычного приложения

Смотрите модуль формы, связанной с интерфейсом

Где искать модуль с кодом функции

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

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

Отличия модулей объектов, форм и общих модулей

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

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

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

Серверный и клиентский контекст выполнения

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

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

Как посмотреть выполняемый код в отладчике

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

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

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

Ограничения и риски при правке кода

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

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

Сравнение вариантов

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

Подходит, когда известно местонахождение функции; ограничение — требует знания структуры метаданных

Глобальный поиск по тексту

Подходит для поиска по имени функции; ограничение — может показать вызовы без объявления

Как проверить, что нужная функция найдена

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

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

Итог

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

Код функции находится в модуле конфигурации, а не в самом объекте; место зависит от типа модуля и контекста выполнения.

Как открыть модуль объекта в конфигураторе?

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

Что делать, если функция не находится в модуле объекта?

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

Может ли одна функция быть в нескольких модулях?

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

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

Не обязательно; перенос требуется только если логика должна выполняться на сервере или обращаться к серверным данным. Изменение контекста может повлиять на производительность и доступность функций.