Расширение формы клиентского приложения для набора записей.Записать

Записать свой набор штатным методом управляемой формы

Форма относится к конкретному собственному регистру, открывается с документированным параметром Отбор и работает только со своим новым UUID-ключом.

Подготовка

1. В отдельной учебной конфигурации создайте свой независимый непериодический регистр сведений УчебныеНаборыФормы: измерение Ключ (Строка 40, Основной отбор Истина), ресурс Количество (Число 12.2 со знаком).

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

3. В УчебныйНабор добавьте реквизиты РазрешитьЗапись и ОтменитьВТранзакции (Булево), СчетчикСобытий (Число 10.0), СтатусУрока (Строка 200), выведите их на форму. Отдельный инициализатор относится к этой форме.

4. В своей внешней обработке с управляемой формой создайте команду ОткрытьСвойНабор. Дополнительный блок открытия и серверной подготовки поместите только в её модуль; он создаёт свою запись и передаёт форме настоящий параметр Отбор.

5. Открывайте форму только этой командой. Новый UUID-ключ ограничивает набор одной собственной записью; не открывайте без отбора рабочий регистр и не подставляйте чужое имя.

6. В УчебныйНабор создайте собственную команду ЗаписатьСвойНабор и кнопку. Основной обработчик — модуль формы регистра, не модуль открывающей обработки.

7. Для записи измените свою строку Количество с 3 на 4 и нажмите собственную кнопку.

&НаКлиенте
Процедура ЗаписатьСвойНабор(Команда)
    ПараметрыЗаписи = Новый Структура("УчебнаяЗапись", Истина);
    Успешно = Записать(ПараметрыЗаписи);
    СтатусУрока = ?(Успешно, "Свой набор записан", "Запись своего набора отменена");
    Сообщить(СтатусУрока);
КонецПроцедуры

&НаКлиенте
Процедура ОткрытьСвойНабор(Команда)
    СвойКлюч = ПодготовитьСвойНабор();
    ОтборНабора = Новый Структура("Ключ", СвойКлюч);
    ПараметрыОткрытия = Новый Структура("Отбор", ОтборНабора);
    ОткрытьФорму("РегистрСведений.УчебныеНаборыФормы.Форма.УчебныйНабор", ПараметрыОткрытия);
КонецПроцедуры
&НаСервереБезКонтекста
Функция ПодготовитьСвойНабор()
    СвойКлюч = Строка(Новый УникальныйИдентификатор);
    Набор = РегистрыСведений.УчебныеНаборыФормы.СоздатьНаборЗаписей();
    Набор.Отбор.Ключ.Установить(СвойКлюч);
    Запись = Набор.Добавить();
    Запись.Ключ = СвойКлюч;
    Запись.Количество = 3;
    Набор.Записать();
    Возврат СвойКлюч;
КонецФункции

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
    РазрешитьЗапись = Ложь;
    ОтменитьВТранзакции = Ложь;
    СчетчикСобытий = 0;
    СтатусУрока = "Свой набор открыт по уникальному ключу";
КонецПроцедуры

Разбор по шагам

1. Создаём собственный регистр и настоящую управляемую форму набора мастером.

2. Отдельная обработка создаёт одну свою строку и открывает форму с нужным отбором.

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

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

1. При успешной записи метод возвращает Истина, а повторное открытие по тому же собственному ключу показывает 4.

2. Структуру ПараметрыЗаписи могут читать обработчики записи. Ложь и исключение не подменяются сообщением об успехе.

Ожидаемый результат

Метод / событие показано на собственном реально открываемом наборе с точным контекстом и ограниченным отбором.

На что обратить внимание

1. Запись набора с пустым отбором опасна: урок открывает только свой набор по новому уникальному Ключ.

2. Форма записи, форма набора записей и произвольная общая форма не имеют одинакового расширения.

3. Код 1С при сборке HTML не исполнялся; учебные и рабочие записи агентом не менялись.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.