Как передать ссылку на объект в форму внешней обработки заполнения?

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

Пошаговое решение задачи передачи параметров

Для того чтобы передать данные между формами, мы будем использовать возможности платформы по передаче параметров через метод ОткрытьФорму. Рассмотрим этот процесс по шагам.

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

Реализация кода

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

Сначала рассмотрим код на стороне вызывающей формы (клиентская часть):

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

Теперь проанализируем, как принять эти данные в принимающей форме (серверная часть):

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

Важные рекомендации и нюансы

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

• Безопасность: Всегда используйте метод Параметры.Свойство() перед обращением к переданным данным. Это защитит вашу форму от ошибок в случаях, если её попытаются открыть из другого места, где параметры не были переданы.
• Оптимизация: Обращение к реквизитам через Ссылка.Реквизит на сервере — это дополнительный запрос к базе данных. Если данных нужно много, лучше один раз передать ссылку и выполнить запрос ВЫБРАТЬ в модуле обработки, чтобы получить все нужные сведения одной транзакцией.
• Альтернатива: Если вы используете механизмы БСП (Библиотека стандартных подсистем), обратите внимание на массив ОбъектыНазначенияМассив. Он автоматически заполняется системой и содержит ссылки на объекты, выделенные пользователем. Это более универсальный способ, чем обращение к ВладелецФормы, так как он работает даже для списков документов.
• Уникальность: Если вам требуется более гибкое управление формой, вместо ОткрытьФорму рассмотрите использование метода ПолучитьФорму. Он вернет объект формы, позволяя вам предварительно установить нужные свойства, обработчики или параметры до того, как пользователь увидит окно на экране.

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