Тип: Строка. Содержит путь в форме, которая будет отображать сообщение, до объекта, связанного с этим сообщением.
Полное описание, параметры и ограничения
СообщениеПользователю.ПутьКДанным (UserMessage.DataPath)
СообщениеПользователю (UserMessage)
ПутьКДанным (DataPath)
Доступен, начиная с версии 8.2.
Использование:
Чтение и запись.
Описание:
Тип: Строка.
Содержит путь в форме, которая будет отображать сообщение, до объекта, связанного с этим сообщением.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.2.
Методическая информация
Практические примеры
Связать сообщение с ценой собственного товара
КлючДанных указывает настоящую ссылку объекта, а ПутьКДанным — реквизит его своей управляемой формы.
Где и как запускать
Серверный обработчик своей учебной базы. Это пример синтаксиса: здесь 1С, файлы, базы и сеть не запускались.
Подготовка
Создайте свой справочник Товары с числовым реквизитом Цена и товаром с кодом BOOK. Для отрицательной проверки вручную задайте ему учебную отрицательную цену.
В собственной управляемой форме товара основной реквизит называется Объект, поле связано с Объект.Цена. Выполняйте серверный фрагмент при работе с этой формой.
Товар = Справочники.Товары.НайтиПоКоду("BOOK");
Если Товар.Пустая() Тогда
ВызватьИсключение "Создайте свой учебный товар BOOK";
КонецЕсли;
ОбъектТовара = Товар.ПолучитьОбъект();
Если ОбъектТовара.Цена < 0 Тогда
Сообщение = Новый СообщениеПользователю;
Сообщение.Текст = "Цена товара не должна быть отрицательной";
Сообщение.КлючДанных = Товар;
Сообщение.ПутьКДанным = "Объект.Цена";
Сообщение.Сообщить();
КонецЕсли;Разбор по шагам
Находим настоящее собственное значение ссылки.
Читаем цену без записи объекта.
Сообщение связывается с объектом и точным путём своего поля.
Как проверить результат
При отрицательной цене показано адресное сообщение.
Для неотрицательной цены сообщение не создаётся.
Ожидаемый результат
Контрольный результат описывает будущую ручную проверку в подготовленном учебном окружении. Выполнение в 1С здесь не проверялось.
На что обратить внимание
Путь должен соответствовать реальной форме. Строка Объект.Цена не заменяет ссылку в КлючДанных, а произвольный текст не заменяет правильный ключ.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.