Разработка сложных конфигураций на платформе 1С:Предприятие невозможна без понимания механизмов взаимодействия между объектами метаданных. Когда вы пишете внешний отчет, печатную форму или вызываете обработку из кода модуля, вам приходится решать задачу доставки данных от вызывающего объекта к целевому. Передача параметров в 1С — это базовый навык, от которого зависит корректность работы всего программного продукта.
Существует несколько контекстов, в которых требуется передача данных: вызов внешнего отчета из формы документа, запуск обработки в фоновом задании или открытие формы с предустановленными значениями полей. В каждом случае платформа предлагает свои инструменты, начиная от простой структуры значений и заканчивая сложными объектами ПараметрыСеанса. Неправильное использование типов или имен ключей часто приводит к трудноуловимым ошибкам выполнения, которые блокируют работу пользователей.
В этой статье мы детально разберем все основные способы передачи аргументов в подсистемы 1С. Мы рассмотрим синтаксические особенности методов СоздатьВнешнююПечатнуюФорму, Выполнить для обработок и работу с объектом ПараметрыФормы. Особое внимание уделим типизации данных и особенностям передачи составных типов, чтобы ваш код был устойчивым и читаемым.
Вызов внешних отчетов и печатных форм
Наиболее частая задача в практике разработчика — это формирование печатной формы документа или получение аналитического отчета. Для этого в платформе предусмотрены специальные методы объектов менеджеров. Ключевым моментом здесь является создание объекта типа Структура, который будет содержать все необходимые входные данные.
Рассмотрим классический пример вызова внешней печатной формы. Вам необходимо передать сам документ, для которого формируется форма, и дополнительные параметры, такие как дата вывода или выбор конкретного макета. Платформа строго контролирует типы передаваемых значений, поэтому нарушение типизации вызовет исключение.
ДокументОбъект = Документы.РеализацияТоваровУслуг.СоздатьМенеджерЗначения(СсылкаНаДокумент);
Параметры = Новый Структура("ОбъектПечати, ВыводитьПечать, ВыводитьДиалогНастроек", ДокументОбъект, Истина, Ложь);
ВнешняяПечатнаяФорма = Документы.РеализацияТоваровУслуг.СоздатьВнешнююПечатнуюФорму(Параметры, "Основная", Макет);
ВнешняяПечатнаяФорма.ПолучитьМакет().Печать();
Обратите внимание, что имя ключа "ОбъектПечати" является зарезервированным для многих стандартных механизмов печати. Изменение этого имени на произвольное, например "МойОбъект", приведет к тому, что механизм печати не найдет исходный документ и прервет выполнение с ошибкой. Всегда сверяйтесь со справкой по конкретному методу.
⚠️ Внимание: При передаче больших объемов данных в печатную форму (например, табличных частей с тысячами строк) старайтесь минимизировать состав структуры. Лишние поля увеличивают время сериализации данных, особенно если отчет выполняется в отдельном процессе.
Используйте типизированные структуры вместо обычных, если передаете параметры в строго типизированные методы. Это поможет отловить ошибки на этапе компиляции модуля, а не во время выполнения.
Запуск внешних обработок через метод Выполнить
Второй по популярности сценарий — запуск внешней обработки (.epf) или отчета (.erf) из кода. Для этого используется глобальный метод Выполнить или метод объекта обработки. Основное отличие от печати заключается в том, что внешняя обработка должна явно объявить принимаемые параметры в своем модуле объекта.
В модуле внешней обработки вы должны описать экспортную процедуру, которая будет точкой входа. Имя этой процедуры по умолчанию — ОсновнаяФормаСоздание или специальная процедура, указанная в свойствах метаданных. Аргументы передаются через структуру, где ключи должны точно совпадать с именами параметров, ожидаемых обработкой.
- 📂 Путь к файлу: Указывается полный путь к файлу обработки на диске клиента или сервера.
- 🔑 Имена ключей: Должны строго соответствовать именам параметров в модуле внешней обработки.
- 📦 Типы данных: Поддерживаются любые сериализуемые типы 1С, включая таблицы значений и массивы.
Если внешняя обработка предназначена для работы в файловом варианте базы, а вызывается из клиент-серверного варианта, могут возникнуть проблемы с доступом к файловой системе. В таких случаях рекомендуется предварительно выгружать обработку во временное хранилище и передавать ссылку на него.
☑️ Проверка перед запуском обработки
Использование объекта ПараметрыФормы
При открытии форм, особенно динамически создаваемых или внешних, часто требуется предварительная установка значений в поля формы. Для этих целей прекрасно подходит объект ПараметрыФормы. Это специализированная структура, которая позволяет не только передать значения, но и настроить видимость или доступность элементов при старте.
Синтаксис вызова формы с параметрами выглядит лаконично. Вы создаете объект ПараметрыФормы, заполняете его и передаете в метод Открыть или ОткрытьМодально. Платформа автоматически сопоставит ключи структуры с реквизитами формы.
Параметры = Новый ПараметрыФормы;
Параметры.Вставить("ПериодНачала", НачалоМесяца(ТекущаяДата()));
Параметры.Вставить("ПериодОкончания", КонецМесяца(ТекущаяДата()));
Параметры.Вставить("Организация", Константы.ОсновнаяОрганизация.Получить());
ОткрытьФорму("Отчет.Продажи.Форма.Отчет", Параметры, ЭтаФорма);
Важно понимать разницу между параметрами формы и обычными реквизитами. Параметры формы существуют только в момент её создания и первичной инициализации. После открытия формы изменить их через объект параметров уже нельзя, только через непосредственное обращение к реквизитам открытой формы.
⚠️ Внимание: Если вы передаете в параметры формы объект ссылки, убедитесь, что этот объект существует в базе данных на момент открытия формы. Передача битой ссылки (удаленного элемента) вызовет ошибку валидации при инициализации формы.
Особенность работы с параметрами в управляемых формах
В управляемом приложении параметры формы передаются на клиент только при первом открытии. При последующих обновлениях формы (например, по таймеру) параметры не пересылаются автоматически, если не использовать специальные приемы с командным интерфейсом.
Передача сложных типов и таблиц значений
Часто возникает необходимость передать в отчет или обработку не просто одно значение, а целый набор данных, например, список выбранных пользователем номенклатур или регистры сведений. Для этого идеально подходит тип ТаблицаЗначений. Это наиболее эффективный способ передачи табличных данных между модулями.
При создании таблицы значений в структуре параметров важно правильно определить колонки. Если принимающая сторона ожидает таблицу с определенной структурой, а вы передадите таблицу с другими колонками или типами данных, возникнет ошибка приведения типов. Рекомендуется явно описывать структуру таблицы перед заполнением.
| Тип параметра | Описание | Особенности передачи |
|---|---|---|
| Строка / Число | Примитивные типы | Передаются без ограничений, сериализуются мгновенно. |
| Ссылка | Ссылка на документ или справочник | Требует существования объекта в ИБ. Не подходит для временных объектов. |
| ТаблицаЗначений | Набор записей | Наиболее объемный тип. Требует внимания к типам колонок. |
| Массив | Список значений | Удобен для передачи списка идентификаторов. Не имеет именованных полей. |
Использование массивов допустимо, когда порядок элементов важен или когда нужно передать список простых значений (например, список UUID). Однако для передачи структурированных данных таблица значений остается безальтернативным лидером по удобству и производительности.
Таблица значений — это стандарт де-факто для передачи списков данных в 1С. Избегайте передачи массивов структур, если есть возможность использовать ТаблицуЗначений, так как работа с ними оптимизирована движком платформы.
Глобальные параметры сеанса и контекст
Иногда передача параметров через аргументы методов невозможна или неудобна, например, при глубокой вложенности вызовов или при работе с фоновыми заданиями. В таких случаях на помощь приходят ПараметрыСеанса. Это глобальное хранилище, доступное из любого места кода в рамках текущей сессии пользователя.
Запись в параметры сеанса выполняется через объект ПараметрыСеанса. Данные, записанные туда, сохраняются на протяжении всей жизни сеанса или до явной очистки. Это мощный инструмент, но его следует использовать с осторожностью, чтобы не создать "спагетти-код", где зависимости размазаны по всей конфигурации.
Особый случай — это запуск фоновых заданий (команда Фон). При запуске кода в отдельном потоке или процессе, параметры сеанса основной сессии не передаются автоматически. Вам необходимо явно собрать необходимые данные в структуру и передать их как аргумент в процедуру запуска фонового задания.
- 🚀 Изоляция: Фоновое задание работает в своем контексте, не видя переменных основного потока.
- 📝 Сериализация: Все параметры для фона должны быть сериализуемыми (нельзя передать форму или соединение).
- 🔄 Асинхронность: Результат работы не возвращается напрямую, только через запись в базу или файлы.
Помните, что злоупотребление глобальными параметрами усложняет отладку. Всегда старайтесь передавать данные явным образом через аргументы функций, если архитектура решения это позволяет.
Типичные ошибки и отладка передачи данных
Несмотря на кажущуюся простоту, передача параметров в 1С таит в себе ряд подводных камней. Самая распространенная ошибка — опечатка в имени ключа структуры. Поскольку структура является динамическим типом, компилятор не подскажет вам, что ключ "Органиазция" (с пропущенной буквой) не будет найден в принимающем коде. Это приведет к тому, что параметр просто не установится или примет значение Неопределено.
Еще одна частая проблема связана с типами данных. Если отчет ожидает число, а вы передали строку, содержащую число, в строгом режиме работы приложения это вызовет ошибку. В обычном режиме может произойти неявное преобразование, которое иногда работает не так, как ожидается, особенно с датами и булевыми значениями.
⚠️ Внимание: При передаче дат всегда проверяйте временную зону. Дата, переданная с клиента на сервер, может сместиться на количество часов поясного времени, если не использовать специальные методы работы с датами или если сервер и клиент находятся в разных часовых поясах.
Для отладки таких ситуаций рекомендуется использовать метод ПолучитьИменаСвойств для структуры параметров перед передачей, чтобы убедиться в наличии всех ключей. Также полезно выводить содержимое структур в журнал регистрации в формате JSON для анализа.
Секрет отладки структур
Используйте функцию СтрШаблон для быстрого вывода содержимого структуры в сообщение пользователю или в консоль отладчика. Это быстрее, чем проходить по структуре циклом вручную.
Часто задаваемые вопросы (FAQ)
Можно ли передавать в параметры неопределенные значения (Null)?
Да, в 1С аналогом Null является значение Неопределено. Вы можете смело вставлять его в структуру параметров. Принимающая сторона должна быть готова обработать этот случай, проверив тип значения перед использованием.
Как передать в отчет настройки отбора, выбранные пользователем в форме?
Лучший способ — сформировать объект СтруктураОтборов или ТаблицуЗначений с условиями отбора на клиенте, а затем передать эту таблицу в параметрах отчета. В отчете вы сможете применить эти отборы к выборке данных.
Что делать, если количество параметров слишком велико для структуры?
Если параметров очень много, рекомендуется сгруппировать их логически. Создайте несколько вложенных структур или передайте одну основную структуру, внутри которой будут другие структуры или таблицы значений. Это улучшит читаемость кода.
Влияет ли передача больших параметров на производительность?
Да, влияет. Передача больших таблиц значений или массивов между клиентом и сервером (или в фоновое задание) требует времени на сериализацию и передачу по сети. Старайтесь передавать только необходимые данные, а не полные копии больших регистров.
Можно ли передать в параметрах объект формы?
Нет, объекты форм не являются сериализуемыми. Вы не можете передать ссылку на открытую форму или её элемент управления в качестве параметра для другой обработки или отчета. Передавайте только данные (значения реквизитов).