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

Другое · 7 мин

Методы в 1С: что это, где используются и как вызывать

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

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

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

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

Что понимают под методами в 1С

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

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

Чем методы отличаются от функций и свойств

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

Функция — это независимая процедура, которую можно вызвать без привязки к конкретному объекту, например ТекущаяДата() или СтрДлина(). Метод всегда связан с объектом: объект.Метод(). Некоторые методы возвращают значение, некоторые нет, но ключевое отличие остаётся: метод вызывается у экземпляра объекта.

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

Где и как вызываются методы

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

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

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

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

Порядок проверки вызова метода

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

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

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

Типичные ошибки и ограничения

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

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

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

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

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

Тип объекта перед вызовом
Норма

Соответствует ожидаемому типу

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

Пустая ссылка или другой тип

Права и блокировка
Норма

Пользователь может изменять объект

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

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

Данные после вызова
Норма

Ожидаемое изменение зафиксировано

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

Данные не изменились без очевидной причины

Как выбрать подходящий способ вызова

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

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

Итог

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

Методы — это действия объектов в 1С, зависящие от типа и контекста. Перед вызовом проверяйте тип объекта, права и тестовую базу, особенно при изменении данных.

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

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

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

Что делать, если метод не найден?

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

Безопасно ли изменять данные через методы?

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

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

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