Устанавливает обработчик события.
Синтаксис
УстановитьДействие(<ИмяСобытия>, <Действие>)Полное описание, параметры и ограничения
ДекорацияФормы.УстановитьДействие (FormDecoration.SetAction)
ДекорацияФормы (FormDecoration)
УстановитьДействие (SetAction)
Доступен, начиная с версии 8.2.
Синтаксис:
УстановитьДействие(<ИмяСобытия>, <Действие>)
Параметры:
<ИмяСобытия> (обязательный)
Тип: Строка.
Имя события, для которого устанавливается новое действие.
<Действие> (обязательный)
Тип: Строка.
Указывается имя обработчика.
Описание:
Устанавливает обработчик события.
Доступность:
Сервер, мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.2.
Методическая информация
Практические примеры
Оформить самостоятельную декорацию с учебным объяснением
Декорация не связана с реквизитом через ПутьКДанным. Её собственный заголовок показывает пояснение, а нажатие выполняет отдельный обработчик без СтандартнаяОбработка.
Где и как запускать
Полный модуль собственной управляемой формы внешней учебной обработки.
Подготовка
В своей отдельной конфигурации УчебнаяКонфигурацияСинтаксиса создайте новую внешнюю обработку с пустой управляемой основной формой. Открывайте её в тонком или толстом клиенте Windows 8.5.1.1343.
Вставьте весь модуль урока и назначьте событию ПриСозданииНаСервере одноимённый обработчик. Реквизиты и элементы вручную не добавляйте: они создаются программно.
Поле вида ПолеНадписи отображает значение реквизита. Декорация вида Надпись показывает свой заголовок без ПутьКДанным. Не заменяйте один вид другим.
Все значения вымышлены и находятся в памяти формы. Книга 3 × 250 = 750 не является сохранённой продажей, корректировка −50 не является бухгалтерской проводкой.
Раскладку, выделение отрицательных, копирование и нажатие нужно вручную проверить в своём клиенте/интерфейсе. Проверка присвоенных свойств не доказывает конкретные пиксели или цвет активной темы.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
НовыеРеквизиты = Новый Массив;
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Количество", Новый ОписаниеТипов("Число")));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Цена", Новый ОписаниеТипов("Число")));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Сумма", Новый ОписаниеТипов("Число")));
ЭтаФорма.ИзменитьРеквизиты(НовыеРеквизиты);
ЭтаФорма.Количество = 3;
ЭтаФорма.Цена = 250;
ЭтаФорма.Сумма = ЭтаФорма.Количество * ЭтаФорма.Цена;
Декорация = ЭтаФорма.Элементы.Добавить("УчебноеОбъяснение", Тип("ДекорацияФормы"));
Декорация.Вид = ВидДекорацииФормы.Надпись;
Декорация.Заголовок = "Учебный расчёт: 3 × 250 = 750. Нажмите для объяснения.";
Декорация.ВысотаЗаголовка = 2;
Декорация.ГоризонтальноеПоложение = ГоризонтальноеПоложениеЭлемента.Лево;
Декорация.ВертикальноеПоложение = ВертикальноеПоложениеЭлемента.Центр;
Декорация.Рамка = Новый Рамка(ТипРамкиЭлементаУправления.Одинарная, 1);
Декорация.ЦветРамки = Новый Цвет(150, 170, 190);
Декорация.ЦветФона = Новый Цвет(245, 249, 252);
Декорация.Гиперссылка = Истина;
Декорация.УстановитьДействие("Нажатие", "УчебноеОбъяснениеНажатие");
Сообщить(Декорация.ВысотаЗаголовка = 2);
Сообщить(Декорация.ГоризонтальноеПоложение = ГоризонтальноеПоложениеЭлемента.Лево);
Сообщить(Декорация.ВертикальноеПоложение = ВертикальноеПоложениеЭлемента.Центр);
Сообщить(Декорация.Гиперссылка);
Сообщить(Сумма = 750);
КонецПроцедуры
&НаКлиенте
Процедура УчебноеОбъяснениеНажатие(Элемент)
Если Элемент.Имя <> "УчебноеОбъяснение" Тогда
Возврат;
КонецЕсли;
Сообщить(СтрШаблон("Собственный расчёт: %1 × %2 = %3. В базу не записано.", Количество, Цена, Сумма));
КонецПроцедурыРазбор по шагам
Создать ДекорацияФормы вида Надпись, а не ПолеФормы. Заголовок принадлежит самому элементу.
Установить высоту заголовка в строках, явно левое горизонтальное выравнивание и вертикальный центр. Для этой декорации горизонтальное Авто запрещено.
Настроить рамку и фон. Назначить отдельное событие Нажатие; у его обработчика только Элемент.
При нажатии показать собственную формулу и напомнить, что записи базы нет. Не пытаться передать сюда обработчик поля с дополнительным аргументом.
Как проверить результат
Пять булевых сообщений Истина. На форме виден заголовок с формулой, нажатие показывает объяснение.
Если позже изменить Сумма, постоянный Заголовок сам не пересчитается: он не связан с данными, это принципиальное отличие декорации.
Ожидаемый результат
Новичок видит конкретную разницу между полем надписи и декорацией, включая оформление и событие.
На что обратить внимание
Декорация не имеет ПутьКДанным. Для автоматически отображаемого значения используйте поле надписи.
ВысотаЗаголовка=0 — автоматический подбор, не скрытие заголовка.
Нажатие декорации не имеет СтандартнаяОбработка; сигнатуры различаются даже при похожем внешнем виде.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Подготовить свою форму для тестов без рабочих данных
Полный fixture создаёт два поля, статус, выбор, собственную панель, меню и безопасные учебные надписи.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Только собственная пустая конфигурация УчебнаяКонфигурацияСинтаксиса. Для первого урока создайте новую внешнюю обработку УчебныйИнтерфейсТестирования с пустой основной управляемой формой Форма.
Запустите два отдельных тонких клиента собственной учебной базы: тестируемый с /TESTCLIENT -TPort15380, менеджер с /TESTMANAGER. Порт 15380 — собственный учебный; убедитесь, что на нём не работает другой клиент. Не подключайте менеджер к рабочей базе/чужому приложению.
В fixture назначьте событие ПриСозданииНаСервере одноимённому обработчику и вставьте весь модуль первого урока. Элементы и реквизиты вручную не создавайте. Откройте эту обработку в /TESTCLIENT.
Каждый следующий урок — полный отдельный модуль формы другой обработки менеджера /TESTMANAGER с командой ВыполнитьПример. Перед каждым тестом заново откройте fixture; не выполняйте тест на изменённом состоянии предыдущего урока.
Исходно первое поле Книга, второе Ручка, статус Готово, выбор book/Книга. Любые кнопки/ссылки действуют только на этой памяти формы; нет записи базы и внешних URL.
Это код штатного механизма тестирования 1С, не браузерная проверка HTML. В данном окружении выполнение UI-тестов в настоящей 1С не подтверждено.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
ЭтаФорма.АвтоЗаголовок = Ложь;
ЭтаФорма.Заголовок = "Учебная форма guide-owned-form-2026";
Новые = Новый Массив;
Для Каждого ИмяРеквизита Из СтрРазделить("Первое,Второе,УчебныйСтатус,УчебныйВыбор", ",") Цикл
Новые.Добавить(Новый РеквизитФормы(ИмяРеквизита, Новый ОписаниеТипов("Строка")));
КонецЦикла;
ЭтаФорма.ИзменитьРеквизиты(Новые);
Первое = "Книга";
Второе = "Ручка";
УчебныйСтатус = "Готово";
УчебныйВыбор = "book";
Для Каждого ИмяРеквизита Из СтрРазделить("Первое,Второе,УчебныйСтатус,УчебныйВыбор", ",") Цикл
ИмяПоля = "Поле" + ИмяРеквизита;
Если ИмяРеквизита = "УчебныйСтатус" Тогда
ИмяПоля = "ПолеУчебногоСтатуса";
ИначеЕсли ИмяРеквизита = "УчебныйВыбор" Тогда
ИмяПоля = "ПолеУчебногоВыбора";
КонецЕсли;
Поле = Элементы.Добавить(ИмяПоля, Тип("ПолеФормы"));
Поле.Вид = ВидПоляФормы.ПолеВвода;
Поле.ПутьКДанным = ИмяРеквизита;
Поле.Заголовок = ИмяРеквизита;
КонецЦикла;
Элементы.ПолеУчебногоСтатуса.ТолькоПросмотр = Истина;
Выбор = Элементы.ПолеУчебногоВыбора;
Выбор.СписокВыбора.Добавить("book", "Книга");
Выбор.СписокВыбора.Добавить("pen", "Ручка");
Выбор.РежимВыбораИзСписка = Истина;
Выбор.РедактированиеТекста = Ложь;
Выбор.КнопкаСпискаВыбора = Истина;
Панель = Элементы.Добавить("УчебнаяПанель", Тип("ГруппаФормы"));
Панель.Вид = ВидГруппыФормы.КоманднаяПанель;
Для Каждого ИмяКоманды Из СтрРазделить("УчебноеМеню,УчебноеЗакрытие", ",") Цикл
КомандаФормы = ЭтаФорма.Команды.Добавить(ИмяКоманды);
КомандаФормы.Действие = ИмяКоманды;
КомандаФормы.Заголовок = ИмяКоманды;
КомандаФормы.ИзменяетСохраняемыеДанные = Ложь;
Кнопка = Элементы.Добавить("Кнопка" + ИмяКоманды, Тип("КнопкаФормы"), Панель);
Кнопка.ИмяКоманды = КомандаФормы.Имя;
Кнопка.Заголовок = ИмяКоманды;
КонецЦикла;
Элементы.КнопкаУчебноеЗакрытие.КнопкаПоУмолчанию = Истина;
Надпись = Элементы.Добавить("УчебнаяНадпись", Тип("ДекорацияФормы"));
Надпись.Вид = ВидДекорацииФормы.Надпись;
Надпись.Заголовок = "Нажать собственную надпись";
Надпись.Гиперссылка = Истина;
Надпись.Подсказка = "Меняет только собственный учебный статус";
Надпись.УстановитьДействие("Нажатие", "УчебнаяНадписьНажатие");
Форматированная = Элементы.Добавить("УчебнаяФорматированнаяНадпись", Тип("ДекорацияФормы"));
Форматированная.Вид = ВидДекорацииФормы.Надпись;
Форматированная.Гиперссылка = Ложь;
Форматированная.Заголовок = Новый ФорматированнаяСтрока("Открыть учебное пояснение", , , , "guide-owned-link-001");
ЭтаФорма.УстановитьДействие("ОбработкаНавигационнойСсылки", "УчебнаяНавигационнаяСсылка");
ЭтаФорма.Модифицированность = Ложь;
КонецПроцедуры
&НаКлиенте
Процедура УчебноеМеню(Команда)
Значения = Новый СписокЗначений;
Значения.Добавить("book", "Книга");
Значения.Добавить("pen", "Ручка");
УчебныйСтатус = "Меню открыто";
ЭтаФорма.ПоказатьВыборИзМеню(Новый ОписаниеОповещения("УчебноеМенюЗавершено", ЭтотОбъект), Значения, Элементы.ПолеПервое);
КонецПроцедуры
&НаКлиенте
Процедура УчебноеМенюЗавершено(ВыбранныйЭлемент, ДополнительныеПараметры) Экспорт
Если ВыбранныйЭлемент = Неопределено Тогда
УчебныйСтатус = "Отмена меню";
Иначе
Если ТипЗнч(ВыбранныйЭлемент) <> Тип("ЭлементСпискаЗначений") Тогда
ВызватьИсключение "Результат учебного меню имеет неожиданный тип";
КонецЕсли;
Если ВыбранныйЭлемент.Значение <> "book" И ВыбранныйЭлемент.Значение <> "pen" Тогда
ВызватьИсключение "Получено не учебное значение";
КонецЕсли;
УчебныйСтатус = "Меню: " + ВыбранныйЭлемент.Значение;
КонецЕсли;
ЭтаФорма.Модифицированность = Ложь;
КонецПроцедуры
&НаКлиенте
Процедура УчебнаяНадписьНажатие()
УчебныйСтатус = "Надпись нажата";
ЭтаФорма.Модифицированность = Ложь;
КонецПроцедуры
&НаКлиенте
Процедура УчебнаяНавигационнаяСсылка(НавигационнаяСсылкаФорматированнойСтроки, СтандартнаяОбработка)
СтандартнаяОбработка = Ложь;
Если НавигационнаяСсылкаФорматированнойСтроки <> "guide-owned-link-001" Тогда
ВызватьИсключение "Ссылка не относится к собственному учебному сценарию";
КонецЕсли;
УчебныйСтатус = "Учебная ссылка обработана";
ЭтаФорма.Модифицированность = Ложь;
КонецПроцедуры
&НаКлиенте
Процедура УчебноеЗакрытие(Команда)
ЭтаФорма.Модифицированность = Ложь;
ЭтаФорма.Закрыть();
КонецПроцедурыРазбор по шагам
Сначала проверяется имя собственной пустой конфигурации, затем программно создаются четыре строковых реквизита и элементы.
Кнопка меню вызывает неблокирующий ПоказатьВыборИзМеню; callback имеет ВыбранныйЭлемент, ДополнительныеПараметры и Экспорт.
Обычная надпись использует Нажатие() без параметров. Форматированная надпись имеет Гиперссылка=Ложь, ссылку в пятом параметре конструктора и обработчик навигации на уровне формы.
Событие формы навигации имеет два параметра; СтандартнаяОбработка=Ложь запрещает штатный переход. Отдельное одноимённое событие декорации не назначается.
Кнопка закрытия по умолчанию закрывает только эту память формы. Она не подтверждает запись документа и не завершает клиент.
Как проверить результат
В точной форме четыре поля: Книга, Ручка, Готово, Книга для значения book. Есть две надписи и две собственные кнопки.
После самостоятельного ручного нажатия надписей меняется только статус; сайт или документ не открывается. Перед тестами заново откройте форму.
Ожидаемый результат
Готов полностью заполненный независимый fixture для обучения автоматизации форм.
На что обратить внимание
Не открывайте в рабочей конфигурации и не заменяйте собственные селекторы на первый объект приложения.
Успешное построение модуля статически не является подтверждением UI-теста в 1С.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.