Тип: УникальныйИдентификатор. Позволяет точно указать, к какой форме должно быть "привязано" сообщение. Если сообщение не имеет идентификатора назначения, тогда оно выводится и привязывается к активному окну.
Полное описание, параметры и ограничения
СообщениеПользователю.ИдентификаторНазначения (UserMessage.TargetID)
СообщениеПользователю (UserMessage)
ИдентификаторНазначения (TargetID)
Доступен, начиная с версии 8.2.
Использование:
Чтение и запись.
Описание:
Тип: УникальныйИдентификатор.
Позволяет точно указать, к какой форме должно быть "привязано" сообщение. Если сообщение не имеет идентификатора назначения, тогда оно выводится и привязывается к активному окну.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.2.
Методическая информация
Практические примеры
Привязать понятное сообщение проверки к полю учебной формы
Вместо исключения без указания места создаём СообщениеПользователю для конкретного реквизита и текущей формы. Никаких ссылок на рабочие объекты не требуется.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
Создайте отдельную учебную внешнюю обработку с пустой управляемой основной формой. Каждую задачу запускайте в своей копии формы.
Не добавляйте вручную реквизит ЗначениеПримера, поле ПолеПримера и команду УчебноеДействие: их создаст код.
В свойствах формы → События свяжите ПриСозданииНаСервере с одноимённой процедурой. Вставьте весь модуль, включая клиентские и серверные процедуры.
Сохраните учебную EPF и откройте через Файл → Открыть в тонком или толстом клиенте Windows. Рабочие данные не читаются и не записываются.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Новые = Новый Массив;
ТипРеквизита = Новый ОписаниеТипов("Строка", , Новый КвалификаторыСтроки(100));
Новые.Добавить(Новый РеквизитФормы("ЗначениеПримера", ТипРеквизита));
ЭтаФорма.ИзменитьРеквизиты(Новые);
ЭтаФорма.ЗначениеПримера = "";
Поле = Элементы.Добавить("ПолеПримера", Тип("ПолеФормы"));
Поле.Вид = ВидПоляФормы.ПолеВвода;
Поле.ПутьКДанным = "ЗначениеПримера";
Поле.Заголовок = "Название учебного товара";
КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
КомандаДействия.Действие = "УчебноеДействие";
КомандаДействия.Заголовок = "Проверить название";
КомандаДействия.Подсказка = "Действие только над данными учебной формы";
КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"));
Кнопка.ИмяКоманды = КомандаДействия.Имя;
Кнопка.Заголовок = КомандаДействия.Заголовок;
КонецПроцедуры
&НаКлиенте
Процедура УчебноеДействие(Команда)
Если Не ПустаяСтрока(ЗначениеПримера) Тогда
Сообщить("Название заполнено. Товар в базу не записан.");
Возврат;
КонецЕсли;
Сообщение = Новый СообщениеПользователю;
Сообщение.Текст = "Укажите название учебного товара.";
Сообщение.Поле = "ЗначениеПримера";
Сообщение.ИдентификаторНазначения = ЭтаФорма.УникальныйИдентификатор;
Сообщение.Сообщить();
КонецПроцедуры
Разбор по шагам
Проверяем фактический строковый реквизит, не заголовок визуального элемента.
СообщениеПользователю содержит текст ошибки и привязку к данным формы.
Поле задаётся путём реквизита ЗначениеПримера, а не именем элемента ПолеПримера.
ИдентификаторНазначения указывает текущую форму; сообщение не должно привязываться к другой открытой форме с похожими данными.
Метод Сообщить публикует подготовленное сообщение. До записи товара или вызова API выполнение не доходит.
Как проверить результат
На пустом поле кнопка выводит Укажите название учебного товара.
Привязка сообщения относится к реквизиту текущей формы; переход по сообщению должен указывать на её поле.
После ввода Книга выводится успешная проверка без создания товара.
Ожидаемый результат
Показано адресное сообщение валидации с точной связью реквизит → поле → форма.
На что обратить внимание
Поле — путь к данным, а не обязательно имя элемента интерфейса.
Сообщение не возвращает Отказ автоматически: реальная процедура записи должна отдельно запретить действие при ошибке.
В уроке нет объекта базы, поэтому КлючДанных и УстановитьДанные намеренно не заполняются фиктивными ссылками.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Проверить заполнение через собственное серверное событие формы
Метод ПроверитьЗаполнение вызывает зарегистрированное событие. В нём проверяем собственное целое количество 1…10 и явно устанавливаем Отказ при ошибке.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
В отдельной учебной базе платформы 8.5.1.1343 создайте внешнюю обработку УчебнаяФорма85 с пустой управляемой основной формой. Используйте тонкий клиент Windows.
В свойствах формы → События назначьте ПриСозданииНаСервере. Вставьте полный модуль урока, включая клиентские и серверные помощники, на уровне модуля.
Не создавайте вручную ЗначениеПримера, ПолеПримера и кнопку: код создаёт их полностью. Каждый урок запускайте в отдельной копии своей формы.
Сохраните свою EPF и откройте её в учебной базе. Собственное количество начинается с 3, цена книги задана в коде как 250; исходный расчёт равен 750.
Связанный реквизит помечен как СохраняемыеДанные для изучения поведения формы. Это признак реквизита формы, а не автоматическая запись книги, файла или документа в базу.
Команда расчёта имеет ИзменяетСохраняемыеДанные = Ложь. Уроки изменяют только свой интерфейс и значения собственной формы, не конфигурацию и не рабочие данные.
Запуск и вид в 1С не проверены. Компоновку, сочетания клавиш и расположение команд осмотрите вручную в указанном клиенте; не переносите настройки на рабочие формы без отдельной проверки.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Новые = Новый Массив;
ТипРеквизита = Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(2, 0, ДопустимыйЗнак.Неотрицательный));
Новые.Добавить(Новый РеквизитФормы("ЗначениеПримера", ТипРеквизита, "", "Количество книг", Истина));
ЭтаФорма.ИзменитьРеквизиты(Новые);
ЭтаФорма.ЗначениеПримера = 3;
Поле = Элементы.Добавить("ПолеПримера", Тип("ПолеФормы"));
Поле.Вид = ВидПоляФормы.ПолеВвода;
Поле.ПутьКДанным = "ЗначениеПримера";
Поле.Заголовок = "Количество собственных книг";
ЭтаФорма.ПроверятьЗаполнениеАвтоматически = Истина;
ЭтаФорма.УстановитьДействие("ОбработкаПроверкиЗаполненияНаСервере", "УчебнаяПроверкаНаСервере");
Сообщить(ЭтаФорма.ПолучитьДействие("ОбработкаПроверкиЗаполненияНаСервере") = "УчебнаяПроверкаНаСервере");
Поле.АвтоОтметкаНезаполненного = Ложь;
КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
КомандаДействия.Действие = "УчебноеДействие";
КомандаДействия.Заголовок = "Выполнить собственный учебный шаг";
КомандаДействия.Подсказка = "Действие только над данными учебной формы";
КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"));
Кнопка.ИмяКоманды = КомандаДействия.Имя;
Кнопка.Заголовок = КомандаДействия.Заголовок;
КонецПроцедуры
&НаКлиенте
Процедура УчебноеДействие(Команда)
ЭтаФорма.ОтключитьОтметкуНезаполненного();
Успех = ЭтаФорма.ПроверитьЗаполнение();
Сообщить("Результат собственной проверки: " + Строка(Успех));
Если Не Успех Тогда
Сообщить("Учебный расчёт не выполнен; исправьте количество");
Возврат;
КонецЕсли;
Если ТипЗнч(ЗначениеПримера) <> Тип("Число") Тогда
ВызватьИсключение "Собственное количество должно быть числом";
КонецЕсли;
Если ЗначениеПримера < 1 ИЛИ ЗначениеПримера > 10 ИЛИ ЗначениеПримера <> Цел(ЗначениеПримера) Тогда
ВызватьИсключение "Для учебного расчёта выберите целое количество от 1 до 10";
КонецЕсли;
Цена = 250;
Сумма = ЗначениеПримера * Цена;
Сообщить(Сумма >= 250 И Сумма <= 2500);
Сообщить(Сумма / Цена = ЗначениеПримера);
Сообщить(СтрШаблон("Собственные книги: %1 × %2 = %3", ЗначениеПримера, Цена, Сумма));
КонецПроцедуры
&НаСервере
Процедура УчебнаяПроверкаНаСервере(Отказ, ПроверяемыеРеквизиты)
Если ТипЗнч(ЗначениеПримера) <> Тип("Число") Тогда
Отказ = Истина;
Сообщить("Учебное количество должно быть числом");
Возврат;
КонецЕсли;
Если ЗначениеПримера < 1 ИЛИ ЗначениеПримера > 10 ИЛИ ЗначениеПримера <> Цел(ЗначениеПримера) Тогда
Отказ = Истина;
Элементы.ПолеПримера.ОтметкаНезаполненного = Истина;
Сообщение = Новый СообщениеПользователю;
Сообщение.Текст = "Для учебного расчёта нужно целое количество от 1 до 10";
Сообщение.Поле = "ЗначениеПримера";
Сообщение.ИдентификаторНазначения = ЭтаФорма.УникальныйИдентификатор;
Сообщение.Сообщить();
КонецЕсли;
КонецПроцедуры
Разбор по шагам
При создании регистрируем собственное событие серверным методом УстановитьДействие и проверяем его имя через ПолучитьДействие.
Кнопка снимает старые ручные отметки и вызывает ПроверитьЗаполнение. Метод обращается к серверу и вызывает назначенный обработчик.
Отказ — переданный обработчику булевый параметр. При значении вне 1…10 или дробном количестве явно устанавливаем его в Истина.
Сообщение привязано к пути реквизита ЗначениеПримера и идентификатору текущей формы. Имя визуального поля ПолеПримера не подставляем вместо пути данных.
При ошибке кнопка прекращает расчёт. Массив ПроверяемыеРеквизиты не очищается: урок не отключает другие системные проверки ради успешного результата.
Как проверить результат
После создания ожидается Истина для имени обработчика. При 3 кнопка сообщает успешную проверку и 750; при 0 — отказ и сообщение у поля, без расчёта.
После ошибки исправьте количество на 5 и нажмите снова: ручная отметка снимается, проверка успешна, сумма 1250. Поле допускает ввод 0, но правило расчёта его запрещает.
Ожидаемый результат
Проверка заполнения формы содержит реальное правило, адресное сообщение и явную остановку ошибочного действия.
На что обратить внимание
ПроверитьЗаполнение не знает автоматически вашего правила 1…10: его реализует назначенное событие.
ОтключитьОтметкуНезаполненного снимает только отметки полей с АвтоОтметкаНезаполненного = Ложь и не исправляет число в реквизите.
ПроверитьЗаполнение не записывает книгу. Для реальной операции правила и отказ дополнительно проверяются в соответствующем объекте конфигурации.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.