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

Другое · 6 мин

Как передать параметр в обработку заполнения 1С

Как передать параметр в обработку заполнения 1C: при открытии, в модуле объекта и программно, проверка результата и типичные ошибки без программирования.

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

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

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

Откуда берётся параметр при открытии обработки

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

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

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

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

1c
Если Параметры.Свойство("Контрагент") Тогда
    Контрагент = Параметры.Контрагент;
КонецЕсли;

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

Передача параметра программно

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

Порядок действий
  1. 1
    Создайте структуру параметров
  2. 2
    Заполните нужные ключи значениями
  3. 3
    Откройте обработку, передав структуру
  4. 4
    Проверьте заполненные поля

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

Обычные и управляемые формы

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

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

Обычные формы

Подходят для типовых внешних обработок, параметр читается в модуле объекта

Управляемые формы

Подходят для современных конфигураций, параметр часто передаётся через контекст формы

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

Проверка результата и границы изменений

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

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

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

Поля заполнены после открытия
Норма

Значения соответствуют переданному параметру

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

Поля пустые или содержат значения по умолчанию

Работа без параметра
Норма

Обработка не выдаёт ошибку

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

Ошибка при отсутствии ключа в Параметры

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

Типичные ошибки и безопасная работа

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

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

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

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

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

Итог

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

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

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

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

Где искать переданный параметр в коде обработки?

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

Что делать, если после передачи параметра поля остаются пустыми?

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

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

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