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

Другое · 8 мин

Модуль менеджера и модуль объекта в 1С: в чем различие

Отличие модуля менеджера от модуля объекта в 1С: контекст конкретной записи, события жизненного цикла, серверное выполнение и место бизнес-логики для разработчика.

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

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

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

Модуль объекта: контекст записи и события

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

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

Модуль менеджера: управление набором объектов

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

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

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

Модуль объекта

Подходит для проверок и расчетов одной записи, событий записи и удаления, работы с ThisObject.

Модуль менеджера

Подходит для выбора, создания, массовой обработки и серверных операций над набором объектов без контекста одной записи.

Сценарий: работа с одним документом

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

Сценарий: подбор и создание объектов

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

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

Сравнение по ролям и контексту

Различие проще удерживать, если разделять ответственность: объект отвечает за себя, менеджер отвечает за группу объектов и общие правила доступа к ним.

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

Порядок действий
  1. 1
    Определите, относится ли задача к одной записи или к группе объектов.
  2. 2
    Выберите модуль объекта для событий записи и проверок экземпляра.
  3. 3
    Выберите модуль менеджера для выбора, создания и массовых операций.
  4. 4
    Проверьте контекст выполнения: клиент или сервер.
  5. 5
    Оттестируйте изменение на копии базы перед вводом в работу.

Где размещать проверки и расчеты

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

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

Ограничения и риски контекста выполнения

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

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

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

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

Есть ли в коде ссылка на текущую запись
Норма

Код в модуле объекта с контекстом записи

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

Код в менеджере без передачи объекта в параметры

Где выполняется логика
Норма

Соответствует клиентскому или серверному контексту

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

Серверная операция вызвана из клиентского кода без осторожности

Как проверить, в каком модуле вы редактируете

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

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

Рекомендации по выбору модуля

Начните с вопроса: с какой именно записью работает пользователь в данный момент? Если с одной — модуль объекта. Если со списком, группой или без конкретной записи — модуль менеджера. Смешивание ролей допустимо только через явную передачу объекта в параметры.

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

Итог

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

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

Можно ли писать проверку заполнения реквизита в модуле менеджера?

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

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

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

Что будет, если разместить событие ПриЗаписи в модуле менеджера?

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

Какой модуль безопаснее для массовой обработки документов?

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