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

Другое · 7 мин

Обработка проведения документа в 1С: где искать и как проверить

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

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

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

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

Где искать код проведения в конфигурации

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

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

Порядок поиска кода проведения
  1. 1
    Открыть конфигуратор и ветку «Документы»
  2. 2
    Выбрать нужный документ и открыть модуль объекта
  3. 3
    Найти процедуру ОбработкаПроведения
  4. 4
    Сравнить результат проведения до и после изменений

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

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

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

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

Как посмотреть и проверить проведение

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

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

Движения естьПроведение отработало

Проверьте корректность сумм и периодов

Движений нетДокумент не проведен или проведение отложено

Проверьте флаг проведения и журнал сообщений

Ошибка при проведенииКод проведения прервался

Смотрите текст ошибки и стек вызовов

Массовое проведение и внешние обработки

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

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

Ошибки и ограничения при изменении проведения

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

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

Если проведение не срабатывает: порядок проверки

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

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

Итог

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

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

Нужно ли пользователю открывать конфигуратор, чтобы провести документ?

Нет. Обычное проведение выполняется из формы документа командами «Провести» или «Отменить проведение». Конфигуратор нужен только для просмотра или изменения кода проведения.

Где именно находится процедура проведения?

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

Что делать, если после проведения нет движений?

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

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

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