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