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

Другое · 7 мин

Обращение к объекту из модуля менеджера 1С

Как в модуле менеджера 1С получить ссылку на объект, превратить её в объект, изменить реквизиты и проверить права доступа без риска блокировок.

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

Чтобы изменить данные конкретного элемента, нужно сначала получить на него ссылку, а затем превратить ссылку в объект. Без этого шага у кода нет доступа к реквизитам экземпляра, и попытка присвоить значение полю менеджера либо не скомпилируется, либо не приведёт к ожидаемому результату. В статье разобраны типичные пути получения ссылки, преобразование в объект, особенности контекста выполнения и способы проверки результата.

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

Что означает обращение к объекту из модуля менеджера

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

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

Отличие менеджера от объекта

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

Работа с менеджеромПоиск, отбор, создание ссылки

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

Работа с объектомИзменение реквизитов и запись

Проверяется, что ссылка преобразована в объект через ПолучитьОбъект()

Где получить ссылку на объект

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

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

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

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

Ссылка = Справочники.Контрагенты.НайтиПоНаименованию("ООО Пример");
Объект = Ссылка.ПолучитьОбъект();
Объект.Наименование = "ООО Новый Пример";
Объект.Записать();

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

Порядок действий
  1. 1
    Получить ссылку на нужный объект через поиск или параметр формы
  2. 2
    Преобразовать ссылку в объект методом получения объекта
  3. 3
    Изменить реквизиты и табличные части
  4. 4
    Выполнить запись объекта
  5. 5
    Повторно прочитать запись и проверить результат

Особенности серверного и клиентского контекста

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

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

Ограничения, права и одновременная работа

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

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

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

Частые ошибки и проверка результата

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

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

Итог

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

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

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

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

Почему получение объекта может вернуть пустоту?

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

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

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

Как убедиться, что запись прошла успешно?

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