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

Другое · 7 мин

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

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

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

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

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

Когда передача параметров оправдана

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

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

Основные способы передачи параметров

Через реквизиты формы обработки

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

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

Через параметры вызова обработки

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

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

Через общие модули и глобальный контекст

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

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

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

Пример заполнения документа с параметрами

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

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

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

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

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

Значения реквизитов после обработки
Норма

Совпадают с переданными параметрами

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

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

Имена параметров и реквизитов
Норма

Идентичны в вызывающем коде и обработке

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

Различаются по регистру или написанию

Объект заполнения
Норма

Изменён целевой документ

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

Изменён другой объект или не изменён

Проверка результата и отладка

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

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

Типичные ошибки
01
Имя параметра в форме не совпадает с именем в коде заполнения — значение не доходит.
02
Передан пустой объект вместо ссылки — заполнение завершается без данных.
03
Изменение исходного документа внутри обработки — появляются лишние записи.

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

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

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

Альтернативы и границы самостоятельной работы

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

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

Итог

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

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

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

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

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

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

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

Безопасно ли передавать ссылку на документ в параметре?

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

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

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