Предусмотрено две одноименных функции: ОбщегоНазначения.СообщитьПользователю для вызова с сервера ОбщегоНазначенияКлиент.СообщитьПользователю для вызова с клиента

1. Для вызова с клиента

Формирует и выводит сообщение, которое может быть связано с элементом управления формы. См. ОбщегоНазначения.СообщитьПользователю

Синтаксис

Процедура СообщитьПользователю(Знач ТекстСообщенияПользователю,	Знач КлючДанных = Неопределено,
Знач Поле = "", Знач ПутьКДанным = "", Отказ = Ложь) Экспорт

Параметры

• ТекстСообщенияПользователю — Строка - текст сообщения.
• КлючДанных — ЛюбаяСсылка - объект или ключ записи информационной базы, к которому это сообщение относится.
• Поле — Строка - наименование реквизита формы.
• ПутьКДанным — Строка - путь к данным (путь к реквизиту формы).
• Отказ — Булево - выходной параметр, всегда устанавливается в значение Истина.

Пример вызова

1. Для вывода сообщения у поля управляемой формы, связанного с реквизитом объекта:
ОбщегоНазначенияКлиент.СообщитьПользователю(
 НСтр("ru = 'Сообщение об ошибке.'"), ,
 "ПолеВРеквизитеФормыОбъект",
 "Объект");
Альтернативный вариант использования в форме объекта:
ОбщегоНазначенияКлиент.СообщитьПользователю(
 НСтр("ru = 'Сообщение об ошибке.'"), ,
 "Объект.ПолеВРеквизитеФормыОбъект");
2. Для вывода сообщения рядом с полем управляемой формы, связанным с реквизитом формы:
ОбщегоНазначенияКлиент.СообщитьПользователю(
 НСтр("ru = 'Сообщение об ошибке.'"), ,
 "ИмяРеквизитаФормы");
3. Для вывода сообщения связанного с объектом информационной базы:
ОбщегоНазначенияКлиент.СообщитьПользователю(
 НСтр("ru = 'Сообщение об ошибке.'"), ОбъектИнформационнойБазы, "Ответственный",,Отказ);
4. Для вывода сообщения по ссылке на объект информационной базы:
ОбщегоНазначенияКлиент.СообщитьПользователю(
 НСтр("ru = 'Сообщение об ошибке.'"), Ссылка, , , Отказ);
Случаи некорректного использования:
 1. Передача одновременно параметров КлючДанных и ПутьКДанным.
 2. Передача в параметре КлючДанных значения типа отличного от допустимого.
 3. Установка ссылки без установки поля (и/или пути к данным).

Доступность

Тонкий клиент, Толстый клиент

2. Для вызова с сервера

Формирует и выводит сообщение, которое может быть связано с элементом управления формы. В фоновом задании длительной операции, если вызов выполнен вне транзакции, сообщение записывается в служебный регистр и отправляется сразу на клиент, если подключена система взаимодействия. В конце фонового задания длительной операции, а также при отправке прогресса, все сообщения извлекаются из очереди сообщений фонового задания, записываются в служебный регистр и отправляются сразу на клиент, если подключена система взаимодействия. АПК:142-выкл 4 необязательных параметра для совместимости с устаревшей процедурой ОбщегоНазначенияКлиентСервер.СообщитьПользователю.

Синтаксис

Процедура СообщитьПользователю(Знач ТекстСообщенияПользователю, Знач КлючДанных = Неопределено,	Знач Поле = "",
Знач ПутьКДанным = "", Отказ = Ложь) Экспорт

Параметры

• ТекстСообщенияПользователю — Строка - текст сообщения.
• КлючДанных — ЛюбаяСсылка - объект или ключ записи информационной базы, к которому это сообщение относится.
• Поле — Строка - наименование реквизита формы.
• ПутьКДанным — Строка - путь к данным (путь к реквизиту формы).
• Отказ — Булево - выходной параметр, всегда устанавливается в значение Истина.

Пример вызова

1. Для вывода сообщения у поля управляемой формы, связанного с реквизитом объекта:
ОбщегоНазначения.СообщитьПользователю(
 НСтр("ru = 'Сообщение об ошибке.'"), ,
 "ПолеВРеквизитеФормыОбъект",
 "Объект");
Альтернативный вариант использования в форме объекта:
ОбщегоНазначения.СообщитьПользователю(
 НСтр("ru = 'Сообщение об ошибке.'"), ,
 "Объект.ПолеВРеквизитеФормыОбъект");
2. Для вывода сообщения рядом с полем управляемой формы, связанным с реквизитом формы:
ОбщегоНазначения.СообщитьПользователю(
 НСтр("ru = 'Сообщение об ошибке.'"), ,
 "ИмяРеквизитаФормы");
3. Для вывода сообщения связанного с объектом информационной базы:
ОбщегоНазначения.СообщитьПользователю(
 НСтр("ru = 'Сообщение об ошибке.'"), ОбъектИнформационнойБазы, "Ответственный",,Отказ);
4. Для вывода сообщения по ссылке на объект информационной базы:
ОбщегоНазначения.СообщитьПользователю(
 НСтр("ru = 'Сообщение об ошибке.'"), Ссылка, , , Отказ);
Случаи некорректного использования:
 1. Передача одновременно параметров КлючДанных и ПутьКДанным.
 2. Передача в параметре КлючДанных значения типа отличного от допустимого.
 3. Установка ссылки без установки поля (и/или пути к данным).

Доступность

Сервер, Толстый клиент, Внешнее соединение