Показывает окно оповещения, в котором может располагаться текст с пояснением, картинка. Для оповещений со статусом Важное окно автоматически скрывается через 10 секунд. Одновременно может быть показано несколько оповещений. Нажатие на окно оповещения либо вызывает процедуру, определенную в описании оповещения, либо выполняет переход по навигационной ссылке. Для оповещений со статусом Информация окно постепенно затухает и исчезает с экрана. Одновременно может быть показано только одно оповещение. В окне может располагаться ссылка, нажатие на которую либо вызывает процедуру, определенную в описании оповещения, либо выполняет переход по навигационной ссылке.
Синтаксис
ПоказатьОповещениеПользователя(<Текст>, <ДействиеПриНажатии>, <Пояснение>, <Картинка>, <СтатусОповещенияПользователя>, <КлючУникальности>)Полное описание, параметры и ограничения
Глобальный контекст.ПоказатьОповещениеПользователя (Global context.ShowUserNotification)
Глобальный контекст (Global context)
ПоказатьОповещениеПользователя (ShowUserNotification)
Доступен, начиная с версии 8.2.
Синтаксис:
ПоказатьОповещениеПользователя(<Текст>, <ДействиеПриНажатии>, <Пояснение>, <Картинка>, <СтатусОповещенияПользователя>, <КлючУникальности>)
Параметры:
<Текст> (необязательный)
Тип: Строка.
Текст оповещения.
<ДействиеПриНажатии> (необязательный)
Тип: Строка, ОписаниеОповещения.
Если тип Строка, то она содержит навигационную ссылку, по которой будет выполнен переход при нажатии на окно оповещения. После перехода окно оповещения будет закрыто.
Если тип ОписаниеОповещения, то содержит описание процедуры, которая будет вызвана при нажатии на окно оповещения c параметрами:
<ДополнительныеПараметры> - значение, которое было указано при создании объекта ОписаниеОповещения.
После вызова процедуры окно оповещения будет закрыто.
При использовании этого параметра рекомендуется установить текст, содержащий указание на необходимость реакции пользователя на оповещение.
<Пояснение> (необязательный)
Тип: Строка.
Пояснение оповещения.
<Картинка> (необязательный)
Тип: Картинка.
Картинка, которая будет показана в оповещении.
<СтатусОповещенияПользователя> (необязательный)
Тип: СтатусОповещенияПользователя.
Параметр определяет важность оповещения пользователя.
Статус устанавливается в зависимости от критичности информации для пользователя.
В режимах интерфейса Версия8_2 и Версия8_2РазрешитьТакси данный параметр игнорируется.
Значение по умолчанию: Информация.
<КлючУникальности> (необязательный)
Тип: Строка.
Ключ уникальности оповещения. Если ключ задан и существует открытое оповещение с таким же ключом, то оно будет заменено на новое. Если параметр не указан или имеет тип Неопределено, то оповещение считается уникальным.
В режимах интерфейса Версия8_2 и Версия8_2РазрешитьТакси данный параметр игнорируется.
Значение по умолчанию: Неопределено.
Описание:
Показывает окно оповещения, в котором может располагаться текст с пояснением, картинка.
Для оповещений со статусом Важное окно автоматически скрывается через 10 секунд. Одновременно может быть показано несколько оповещений. Нажатие на окно оповещения либо вызывает процедуру, определенную в описании оповещения, либо выполняет переход по навигационной ссылке.
Для оповещений со статусом Информация окно постепенно затухает и исчезает с экрана. Одновременно может быть показано только одно оповещение. В окне может располагаться ссылка, нажатие на которую либо вызывает процедуру, определенную в описании оповещения, либо выполняет переход по навигационной ссылке.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, толстый клиент, мобильное приложение (клиент).
См. также:
ПредставлениеНавигационнойСсылки, свойство НавигационнаяСсылка
Глобальный контекст, метод ПолучитьНавигационнуюСсылку
Использование в версии:
Доступен, начиная с версии 8.2.
Описание изменено в версии 8.5.1.
Методическая информация
Практические примеры
Показать оповещение о расчёте и открыть его пояснение по нажатию
Всплывающее сообщение относится только к собственному расчёту в памяти. Обработчик нажатия получает один дополнительный контекст, а не результат вопроса.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
Создайте отдельную учебную внешнюю обработку с пустой управляемой основной формой. Каждую задачу запускайте в своей копии формы.
Не добавляйте вручную реквизит ЗначениеПримера, поле ПолеПримера и команду УчебноеДействие: их создаст код.
В свойствах формы → События свяжите ПриСозданииНаСервере с одноимённой процедурой. Вставьте весь модуль, включая клиентские и серверные процедуры.
Сохраните учебную EPF и откройте через Файл → Открыть в тонком или толстом клиенте Windows. Рабочие данные не читаются и не записываются.
Используйте новую пустую учебную базу и отдельную копию EPF для каждой задачи. Команды не должны обращаться к рабочим данным, внешним сервисам или процедурам записи.
Основной пример выполняется в тонком/толстом клиенте Windows. Доступность веб-клиента оговаривается отдельно; наличие Асинх в имени не гарантирует веб-доступность.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Новые = Новый Массив;
ТипРеквизита = Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(12, 2));
Новые.Добавить(Новый РеквизитФормы("ЗначениеПримера", ТипРеквизита));
ЭтаФорма.ИзменитьРеквизиты(Новые);
ЭтаФорма.ЗначениеПримера = 3;
Поле = Элементы.Добавить("ПолеПримера", Тип("ПолеФормы"));
Поле.Вид = ВидПоляФормы.ПолеВвода;
Поле.ПутьКДанным = "ЗначениеПримера";
Поле.Заголовок = "Учебное количество";
КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
КомандаДействия.Действие = "УчебноеДействие";
КомандаДействия.Заголовок = "Проверить учебное количество";
КомандаДействия.Подсказка = "Действие только над данными учебной формы";
КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"));
Кнопка.ИмяКоманды = КомандаДействия.Имя;
Кнопка.Заголовок = КомандаДействия.Заголовок;
КонецПроцедуры
&НаКлиенте
Процедура УчебноеДействие(Команда)
Если ЗначениеПримера < 1 Или ЗначениеПримера > 100 Тогда
Сообщить("Сначала введите количество от 1 до 100");
Возврат;
КонецЕсли;
Контекст = Новый Структура("Количество,Цена,Сумма", ЗначениеПримера, 200, ЗначениеПримера * 200);
Нажатие = Новый ОписаниеОповещения("ПояснитьУчебныйРасчет", ЭтаФорма, Контекст);
ПоказатьОповещениеПользователя("Учебный расчёт готов — нажмите для пояснения", Нажатие,
"Расчёт только в памяти, документ не записан", , СтатусОповещенияПользователя.Информация,
"УчебныйРасчет-" + Строка(ЭтаФорма.УникальныйИдентификатор));
КонецПроцедуры
&НаКлиенте
Процедура ПояснитьУчебныйРасчет(Контекст) Экспорт
Сообщить(СтрШаблон("Снимок расчёта: %1 × %2 = %3", Контекст.Количество, Контекст.Цена, Контекст.Сумма));
КонецПроцедуры
Разбор по шагам
Проверяем количество, затем сохраняем отдельный снимок количества/цены/суммы в контексте.
В ДействиеПриНажатии передаём ОписаниеОповещения, не URL и не ссылку на рабочий документ.
Нажатие вызывает процедуру с ОДНИМ ДополнительныеПараметры.
Ключ уникальности включает UUID своей формы: повторное оповещение с тем же ключом заменяет предыдущее в поддерживаемом режиме интерфейса.
В обработчике показываем сохранённый снимок, а не изменившееся после расчёта поле формы.
Как проверить результат
При 3 нажатие выводит 3 × 200 = 600.
После появления оповещения измените количество на 4: нажатие на старое оповещение всё ещё объясняет снимок 3/600; новый запуск покажет 4/800.
Ожидаемый результат
Показано осмысленное клиентское оповещение с пояснением и неизменным контекстом расчёта.
На что обратить внимание
Это не отправка сообщения в систему взаимодействия и не уведомление другого пользователя.
В старых интерфейсах Версия8_2 ключ уникальности и статус могут игнорироваться.
Пока пользователь нажимает оповещение, форма-владелец callback должна оставаться открытой.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.