СообщениеПользователю (UserMessage)

Доступен, начиная с версии 8.2.

Свойства:

ИдентификаторНазначения (TargetID)
КлючДанных (DataKey)
Поле (Field)
ПутьКДанным (DataPath)
Текст (Text)

Методы:

Сообщить (Message)
УстановитьДанные (SetData)

Конструкторы:

Описание:

Предназначен для хранения параметров сообщения, которые необходимо вывести пользователю.
Если сообщение еще не было показано пользователю (такое может быть при работе на стороне сервера, в фоновом задании, внешнем соединении или Web-сервисах), можно получить накопленные сообщения методом ПолучитьСообщенияПользователю.

В форме клиентского приложения, в случае выполнения просмотра сообщения, выполняется следующий механизм обработки:
Если у сообщения свойство КлючДанных заполнено и не совпадает с ключевым значением основного реквизита текущей формы (ссылкой объекта или ключом записи регистра сведений), то:

открывается новая форма объекта, соответствующая значению свойства КлючДанных;
если у сообщения свойство ПутьКДанным не заполнено, то в него проставляется имя основного реквизита открытой формы объекта;
вызывается показ сообщения в только что открытой форме;
выполняется перенос всех соответствующих сообщений из окна первой формы в новую форму (с таким же значением свойств КлючДанных, как у выбранного сообщения). При этом перенесенным сообщениям аналогичным образом проставляется свойство ПутьКДанным, если оно не установлено.

Доступность:

Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.

Пример:

Процедура ДействиеСОбъектом(ОбъектДанных)
    ...
    Сообщение = Новый СообщениеПользователю();
    Сообщение.Текст = НСтр("ru = 'В строке 11 табличной части Номенклатура не хватает "
     + "; en = 'In line 11 of tabular section Nomenclature is missing' ")
     + НедостающееКоличество + " " + ЕдиницаИзмеренияНоменклатуры;
    Сообщение.Поле = "Номенклатура[10].Количество";
    Сообщение.УстановитьДанные(ОбъектДанных);
    Сообщение.Сообщить();

КонецПроцедуры;

См. также:

Глобальный контекст, метод УстановитьСоответствиеОбъектаИРеквизитаФормы
Глобальный контекст, метод ПолучитьСоответствиеОбъектаИРеквизитаФормы
Глобальный контекст, метод ПолучитьСообщенияПользователю

Использование в версии:

Доступен, начиная с версии 8.2.

Методическая информация