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

Другое · 8 мин

Метод объекта в 1C: практическое руководство

Метод объекта в 1C: процедура или функция конфигурационного объекта, которая вызывается в контексте экземпляра и может изменять его данные.

Метод объекта в 1C — это именованный блок кода, который принадлежит конкретному экземпляру конфигурационного объекта: справочнику, документу, элементу плана счетов или другому объекту прикладного решения. Он объявляется в модуле объекта и вызывается через имя переменной, в которой находится этот экземпляр, например Объект.Метод(). Такой метод имеет прямой доступ к реквизитам, табличным частям и свойствам того объекта, для которого он определен.

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

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

Метод объекта и обычная процедура: в чем разница

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

Сценарий: метод справочника

Для справочника «Контрагенты» можно создать метод РассчитатьСкидку(), который смотрит на реквизит «Категория контрагента» и возвращает процент скидки. Вызов из формы или другого модуля выглядит как обращение к выбранному элементу справочника: Контрагент.РассчитатьСкидку(). Метод сам использует данные этого контрагента, поэтому вызывающему коду не нужно передавать категорию вручную.

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

Где объявляются методы объектов и как они видны

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

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

Сценарий: метод документа и проведение

В документе «Реализация товаров» метод может проверять остатки на складе перед проведением. Если метод вызывается в момент проведения, он может изменять реквизиты документа и создавать движения по регистрам накопления. Однако само сохранение и проведение документа остаются ответственностью платформы и процедур проведения, а метод лишь выполняет заданную в конфигурации логику.

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

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

Вызов метода объекта: клиент, сервер и контекст

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

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

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

Изменение данных и проверка результата

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

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

Ограничения, риски и типичные ошибки

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

Типичные ошибки
01
Вызов метода несуществующего объекта приводит к ошибке выполнения
02
Смешивание клиентского и серверного контекста вызывает ограничения доступа к данным
03
Изменение реквизитов объекта без записи не сохраняет изменения в базе

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

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

Итог

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

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

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

Может ли метод объекта вызывать другие методы того же объекта?

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

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

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

Можно ли вызывать метод объекта из обычного модуля?

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

Что делать, если метод объекта работает некорректно?

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