Подключает обработчик уведомлений клиента, который будет вызван при получении указанных уведомлений.
Синтаксис
ПодключитьОбработчик(<Ключ>, <Обработчик>)Полное описание, параметры и ограничения
МенеджерУведомленийКлиента.ПодключитьОбработчик (ClientNotificationManager.AttachHandler)
МенеджерУведомленийКлиента (ClientNotificationManager)
ПодключитьОбработчик (AttachHandler)
Доступен, начиная с версии 8.3.26.
Синтаксис:
ПодключитьОбработчик(<Ключ>, <Обработчик>)
Параметры:
<Ключ> (обязательный)
Тип: Неопределено, Строка.
Ключ уведомлений, для которых будет вызван обработчик.
Если Неопределено, обработчик будет вызван для всех полученных уведомлений.
<Обработчик> (обязательный)
Тип: ОписаниеОповещения.
Содержит описание процедуры, которая будет вызвана при получении новых уведомлений со следующими параметрами:
<Данные> - тип Произвольный. Поддерживаются все типы, которые могут быть переданы на клиент в клиент-серверном вызове;
<ДополнительныеПараметры> - значение, которое было указано при создании объекта ОписаниеОповещения.
Описание:
Подключает обработчик уведомлений клиента, который будет вызван при получении указанных уведомлений.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, толстый клиент.
Использование в версии:
Доступен, начиная с версии 8.3.26.
Описание изменено в версии 8.3.27.
Методическая информация
Практические примеры
Подключить и отключить собственный обработчик уведомлений клиента
Обработчик получает данные уведомления и собственные дополнительные параметры. Отключаем только свой ключ.
Где и как запускать
Клиентский модуль формы: тонкий, веб-, мобильный или толстый клиент.
Подготовка
Вставьте блок в модуль собственной управляемой формы. Из клиентского обработчика кнопки вызовите первую процедуру без параметров. Если указано иное место вставки, используйте его. Экспортные обработчики оповещения вызывает платформа, не вызывайте их вручную.
Тонкий, веб-, мобильный или толстый клиент с настроенным сервисом уведомлений. Создайте две кнопки: подключить и отключить; отправку реализуйте отдельной серверной командой из соседнего примера.
&НаКлиенте
Процедура ПодключитьУчебныеУведомления()
Менеджер = УведомленияКлиента;
Обработчик = Новый ОписаниеОповещения("УчебноеУведомлениеПолучено", ЭтотОбъект, "Учебный экран");
Менеджер.ПодключитьОбработчик("learning.sum", Обработчик);
КонецПроцедуры
&НаКлиенте
Процедура УчебноеУведомлениеПолучено(Данные, Дополнительно) Экспорт
Сообщить(Дополнительно + ": " + Строка(Данные));
КонецПроцедуры
&НаКлиенте
Процедура ОтключитьУчебныеУведомления()
УведомленияКлиента.ОтключитьОбработчик("learning.sum");
КонецПроцедурыРазбор по шагам
Подключите оповещение на свой ключ.
Получите настоящее уведомление от сервера.
Отключите обработчик именно этого ключа.
Как проверить результат
Дополнительные параметры берутся из ОписаниеОповещения.
Отключение с learning.sum не отключает все чужие обработчики.
Ожидаемый результат
Своя форма обрабатывает уведомления выбранного ключа до явного отключения.
На что обратить внимание
Не вызывайте обработчик вручную для имитации доставки. Передача Неопределено при отключении отключает все обработчики.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.