Как передать данные в обработку в 1С

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

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

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

Открытие обработки с параметрами через ОткрытьФорму

Стандартный способ в управляемом приложении — сформировать структуру с нужными значениями и передать её вторым аргументом в ОткрытьФорму(). Этот метод работает для внешних обработок и для обработок, встроенных в конфигурацию.

СтруктураПараметров = Новый Структура;
СтруктураПараметров.Вставить("ДокументСсылка", ТекущийДокумент);
СтруктураПараметров.Вставить("Период", НачалоМесяца(ТекущаяДатаСеанса()));

ОткрытьФорму("ВнешняяОбработка.МояОбработка.Форма", СтруктураПараметров, ЭтотОбъект);

Для обработки, встроенной в конфигурацию, путь выглядит иначе: Обработка.ЗаполнениеЦен.Форма. Первый аргумент — строка пути к форме, второй — структура параметров, третий — владелец формы (удобно для блокировки окна владельца и организации иерархии окон).

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

Получение параметров внутри обработки

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

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)

Если Параметры.Свойство("ДокументСсылка")
И ЗначениеЗаполнено(Параметры.ДокументСсылка) Тогда
ДокументОбъект = Параметры.ДокументСсылка;
ЗаполнитьТабличнуюЧасть(ДокументОбъект);
КонецЕсли;

КонецПроцедуры

Если обработка открывается и без параметров (например, из меню «Файл — Открыть»), задайте поведение по умолчанию: инициализируйте реквизиты пустыми значениями, чтобы форма не упала при обращении к незаполненным данным.

Передача таблиц значений через временное хранилище

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

&НаСервере
Функция ПодготовитьАдресДанных()
ТаблицаДанных = СформироватьТаблицу();
Возврат ПоместитьВоВременноеХранилище(ТаблицаДанных, Новый УникальныйИдентификатор);
КонецФункции

&НаКлиенте
Процедура ОткрытьОбработку(Команда)
Адрес = ПодготовитьАдресДанных();
Парам = Новый Структура("АдресДанных", Адрес);
ОткрытьФорму("ВнешняяОбработка.Разбор.Форма", Парам, ЭтотОбъект);
КонецПроцедуры

В обработке данные извлекаются методом ПолучитьИзВременногоХранилища(Адрес). После чтения хранилище желательно очистить вызовом УдалитьИзВременногоХранилища(), если данные больше не нужны — иначе они будут занимать память сеанса до закрытия формы-владельца.

Данные = ПолучитьИзВременногоХранилища(Параметры.АдресДанных);
Если ТипЗнч(Данные) = Тип("ТаблицаЗначений") Тогда
    ТаблицаФормы.Загрузить(Данные);
КонецЕсли;

Передача данных в обычном приложении

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

Обработка = ВнешниеОбработки.Создать("C:\Обработки\Заполнение.epf");
Обработка.ДокументОснование = ТекущийДокумент;

ФормаОбработки = Обработка.ПолучитьФорму("Форма");
ФормаОбработки.Открыть();

Здесь ДокументОснование — реквизит обработки, созданный в конфигураторе. Присваивание выполняется до открытия формы, иначе обработчик ПриОткрытии() увидит пустое значение. Этот подход проще, но требует, чтобы все передаваемые данные были заранее объявлены как реквизиты.

Передача данных из документа или справочника через команду

Типовой сценарий — кнопка «Заполнить» в форме документа, которая открывает обработку и передаёт ей ссылку на текущий объект. В модуле формы документа создаётся клиентская процедура, в которой ссылка берётся из реквизита Объект.Ссылка.

&НаКлиенте
Процедура ЗаполнитьЦены(Команда)

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

Парам = Новый Структура("ДокументСсылка", Объект.Ссылка);
ОткрытьФорму("Обработка.ЗаполнениеЦен.Форма", Парам, ЭтотОбъект);

КонецПроцедуры

Важный нюанс: если документ изменён, но не записан, обработка получит ссылку на старую версию данных из базы. Либо требуйте записи перед открытием, либо передавайте сами данные (табличные части) через временное хранилище, а не только ссылку.

Возврат результата из обработки обратно

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

&НаКлиенте
Процедура ОткрытьПодбор(Команда)
Оповещение = Новый ОписаниеОповещения("ПослеЗакрытияПодбора", ЭтотОбъект);
ОткрытьФорму("Обработка.Подбор.Форма", , ЭтотОбъект, , , , Оповещение);
КонецПроцедуры

&НаКлиенте
Процедура ПослеЗакрытияПодбора(Результат, ДопПараметры) Экспорт
Если Результат <> Неопределено Тогда
ОбработатьРезультат(Результат);
КонецЕсли;
КонецПроцедуры

Чтобы обработка вернула значение, в её коде форму закрывают методом Закрыть(Результат), передавая структуру, массив или адрес временного хранилища. Форма при этом должна открываться в режиме, допускающем возврат значения.

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

Типичные ошибки и их диагностика

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

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

FAQ