Вызывается при нажатии на гиперссылку в сообщении системы взаимодействия, заданную в свойстве Действия.
Синтаксис
ПриВыбореДействияСообщенияСистемыВзаимодействия(<Сообщение>, <Действие>)Полное описание, параметры и ограничения
Глобальный контекст.ПриВыбореДействияСообщенияСистемыВзаимодействия (Global context.OnCollaborationSystemMessageActionChoice)
Глобальный контекст (Global context)
ПриВыбореДействияСообщенияСистемыВзаимодействия (OnCollaborationSystemMessageActionChoice)
Не рекомендуется использовать, начиная с версии 8.3.25.
Рекомендуется использовать:
ПриНажатииКнопкиПанелиКнопокСообщенияСистемыВзаимодействия
Доступен, начиная с версии 8.3.18.
Синтаксис:
ПриВыбореДействияСообщенияСистемыВзаимодействия(<Сообщение>, <Действие>)
Параметры:
<Сообщение>
Тип: СообщениеСистемыВзаимодействия.
Сообщение, в котором нажата гиперссылка действия. В обработчик передается копия объекта.
<Действие>
Тип: Произвольный.
Действие, заданное для нажатой гиперссылки.
Описание:
Вызывается при нажатии на гиперссылку в сообщении системы взаимодействия, заданную в свойстве Действия.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер, интеграция.
Использование в версии:
Доступен, начиная с версии 8.3.18.
Не рекомендуется использовать, начиная с версии 8.3.25.
Описание изменено в версии 8.3.25.
Методическая информация
Практические примеры
ПриВыбореДействияСообщенияСистемыВзаимодействия: своё учебное приложение
Настоящий контракт события, собственный источник данных и явное место подключения обработчика.
Где и как запускать
Модуль управляемого приложения собственной учебной конфигурации.
Подготовка
Собственная отдельная учебная конфигурация и учебный пользователь. Основной код поместите в модуль управляемого приложения, если явно не указано событие формы.
Событие вызывает платформа при указанном действии пользователя. Не проверяйте его ручным вызовом процедуры вместо назначения события.
BSL, сетевые службы, сообщения и действия интерфейса при сборке HTML не выполнялись.
Редкий совместимый старый API Действия: для нового кода платформа рекомендует ПанельКнопок. Этот урок нужен именно для существующих гиперссылок сообщений, а не заменяет новым событием старый контракт.
Собственная подключённая система взаимодействия, свой зарегистрированный бот УчебныеКнигиБот. Дополнительный код — событие создания обсуждения в модуле бота. Создайте собственное учебное обсуждение с этим ботом и нажмите Пояснить сумму у его сообщения.
Ручной опыт отправляет ровно собственную учебную памятку. Не включайте этот обработчик у рабочего бота; при сборке HTML сообщение не отправлялось.
Процедура ПриВыбореДействияСообщенияСистемыВзаимодействия(Сообщение, Действие)
Если Действие <> "УчебныеКниги.Сумма" Тогда
Возврат;
КонецЕсли;
Сообщить("Собственная памятка: 3 × 250 = " + Строка(3 * 250));
Сообщить("Сообщение не перезаписано обработчиком действия");
КонецПроцедурыМодуль своего бота: источник сообщения с настоящей гиперссылкой действия
Процедура ПриСозданииОбсужденияСистемыВзаимодействия(ИдентификаторОбсуждения, ДополнительныеПараметры)
Сообщение = СистемаВзаимодействия.СоздатьСообщение(ИдентификаторОбсуждения);
Сообщение.Текст = "Учебная книга: 3 × 250";
Сообщение.Действия.Добавить("УчебныеКниги.Сумма", "Пояснить сумму");
Сообщение.Записать();
КонецПроцедурыРазбор по шагам
Создайте указанный собственный источник / форму / общий модуль.
Назначьте обработчик правильному событию.
Вызовите описанное действие интерфейса и проверьте реальный параметр / результат.
Как проверить результат
Значение действия в сообщении и в обработчике одинаково: УчебныеКниги.Сумма. Произвольные чужие действия не исполняются.
В обработчик передаётся копия сообщения. Она не сохраняется заново и не создаёт рекурсивную рассылку.
Ожидаемый результат
Событие разобрано на ограниченном собственном сценарии, без выполнения входных строк как кода.
На что обратить внимание
BSL при сборке HTML не исполнялся. Не смешивайте клиентский callback с серверным модулем и не создавайте второй одноимённый обработчик в том же модуле.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.