Вызывается при чтении объекта на сервере.
Синтаксис
ПриЧтенииНаСервере(<ТекущийОбъект>)Полное описание, параметры и ограничения
Расширение формы клиентского приложения для набора записей.ПриЧтенииНаСервере (Managed form extension for record set.OnReadAtServer)
Расширение формы клиентского приложения для набора записей (Managed form extension for record set)
ПриЧтенииНаСервере (OnReadAtServer)
Доступен, начиная с версии 8.2.
Синтаксис:
ПриЧтенииНаСервере(<ТекущийОбъект>)
Параметры:
<ТекущийОбъект>
Тип: РегистрСведенийНаборЗаписей.<Имя регистра сведений>, РегистрНакопленияНаборЗаписей.<Имя регистра накопления>, РегистрБухгалтерииНаборЗаписей.<Имя регистра бухгалтерии>, РегистрРасчетаНаборЗаписей.<Имя регистра расчета>.
Объект, который будет прочитан.
Описание:
Вызывается при чтении объекта на сервере.
Доступность:
Тонкий клиент, веб-клиент, сервер, толстый клиент, мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.2.
Методическая информация
Практические примеры
Разобрать ПриЧтенииНаСервере на собственном управляемом наборе
Форма относится к конкретному собственному регистру, открывается с документированным параметром Отбор и работает только со своим новым UUID-ключом.
Где и как запускать
Модуль настоящей управляемой формы УчебныйНабор собственного независимого регистра сведений; точная клиентская / серверная директива указана в коде.
Подготовка
В отдельной учебной конфигурации создайте свой независимый непериодический регистр сведений УчебныеНаборыФормы: измерение Ключ (Строка 40, Основной отбор Истина), ресурс Количество (Число 12.2 со знаком).
Мастером создайте у этого регистра именно управляемую форму набора записей УчебныйНабор, сохранив её настоящий основной реквизит и таблицу строк. Не заменяйте её формой записи или произвольной общей формой.
В УчебныйНабор добавьте реквизиты РазрешитьЗапись и ОтменитьВТранзакции (Булево), СчетчикСобытий (Число 10.0), СтатусУрока (Строка 200), выведите их на форму. Отдельный инициализатор относится к этой форме.
В своей внешней обработке с управляемой формой создайте команду ОткрытьСвойНабор. Дополнительный блок открытия и серверной подготовки поместите только в её модуль; он создаёт свою запись и передаёт форме настоящий параметр Отбор.
Открывайте форму только этой командой. Новый UUID-ключ ограничивает набор одной собственной записью; не открывайте без отбора рабочий регистр и не подставляйте чужое имя.
В свойствах самой формы УчебныйНабор назначьте событие ПриЧтенииНаСервере основному обработчику. Элемент в эту сигнатуру не добавляется.
Измените только собственную строку и используйте стандартную команду Записать. Для события чтения достаточно открыть форму указанной командой. Каждый урок самостоятельный: остальные учебные события не обязательны.
&НаСервере
Процедура ПриЧтенииНаСервере(ТекущийОбъект)
СчетчикСобытий = СчетчикСобытий + 1;
СтатусУрока = "Прочитан свой набор; строк: " + Строка(ТекущийОбъект.Количество());
Сообщить(СтатусУрока);
КонецПроцедурыОтдельная форма своей обработки: подготовить запись и открыть свой набор с отбором
&НаКлиенте
Процедура ОткрытьСвойНабор(Команда)
СвойКлюч = ПодготовитьСвойНабор();
ОтборНабора = Новый Структура("Ключ", СвойКлюч);
ПараметрыОткрытия = Новый Структура("Отбор", ОтборНабора);
ОткрытьФорму("РегистрСведений.УчебныеНаборыФормы.Форма.УчебныйНабор", ПараметрыОткрытия);
КонецПроцедуры
&НаСервереБезКонтекста
Функция ПодготовитьСвойНабор()
СвойКлюч = Строка(Новый УникальныйИдентификатор);
Набор = РегистрыСведений.УчебныеНаборыФормы.СоздатьНаборЗаписей();
Набор.Отбор.Ключ.Установить(СвойКлюч);
Запись = Набор.Добавить();
Запись.Ключ = СвойКлюч;
Запись.Количество = 3;
Набор.Записать();
Возврат СвойКлюч;
КонецФункцииФорма УчебныйНабор: инициализация собственных учебных реквизитов
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
РазрешитьЗапись = Ложь;
ОтменитьВТранзакции = Ложь;
СчетчикСобытий = 0;
СтатусУрока = "Свой набор открыт по уникальному ключу";
КонецПроцедурыРазбор по шагам
Создаём собственный регистр и настоящую управляемую форму набора мастером.
Отдельная обработка создаёт одну свою строку и открывает форму с нужным отбором.
Выполняем указанную команду / действие и различаем чтение, отказ до транзакции, событие внутри и событие после транзакции.
Как проверить результат
При открытии / повторном чтении показан реальный собственный набор, ограниченный Ключ, а не весь регистр.
Это событие чтения, не записи; обработчик не вызывает Записать и не создаёт новые строки.
Ожидаемый результат
Метод / событие показано на собственном реально открываемом наборе с точным контекстом и ограниченным отбором.
На что обратить внимание
Запись набора с пустым отбором опасна: урок открывает только свой набор по новому уникальному Ключ.
Форма записи, форма набора записей и произвольная общая форма не имеют одинакового расширения.
Код 1С при сборке HTML не исполнялся; учебные и рабочие записи агентом не менялись.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.