Добавляет в список ошибок новую ошибку пользователя для дальнейшей отправки с помощью процедуры СообщитьОшибкиПользователю(). Предназначена для накопления списка ошибок с последующей обработкой этого списка, перед тем как вывести пользователю. Полученный список ошибок можно, например, отсортировать по важности, очистить от дублей, а также вывести пользователю в ином виде, чем выводит метод СообщитьПользователю, например в табличный документ.

Синтаксис

Процедура ДобавитьОшибкуПользователю(
	Ошибки,
	ПолеОшибки,
	ТекстДляОднойОшибки,
	ГруппаОшибок = Неопределено,
	НомерСтроки = 0,
	ТекстДляНесколькихОшибок = "",
	ИндексСтроки = Неопределено) Экспорт

Параметры

• Ошибки — Неопределено - создать новый список ошибок.
  • Структура:
  • СписокОшибок - Массив из Структура: ** ПолеОшибки - Строка ** ТекстДляОднойОшибки - Строка ** ГруппаОшибок - Произвольный ** НомерСтроки - Число ** ТекстДляНесколькихОшибок - Строка
  • ГруппыОшибок - Соответствие
• ПолеОшибки — Строка - значение, которое задается в свойстве Поле объекта СообщениеПользователю. Для автоподстановки номера строки должна содержать "%1". Например, "Объект.ИНН" или "Объект.Пользователи[%1].Пользователь".
• ТекстДляОднойОшибки — Строка - текст ошибки для случая, когда ГруппаОшибок в коллекции только одна, например НСтр("ru = 'Пользователь не выбран.'").
• ГруппаОшибок — Произвольный - используется для выбора либо текста для одной ошибки, либо текста для нескольких ошибок, например, имя "Объект.Пользователи". Если значение не заполнено, тогда используется текст для одной ошибки.
• НомерСтроки — Число - значение от 0 ... , определяющее номер строки, который нужно подставить в строку ПолеОшибки и в ТекстДляНесколькихОшибок (подставляется НомерСтроки + 1).
• ТекстДляНесколькихОшибок — Строка - текст ошибки для случая, когда добавлено несколько ошибок с одинаковым свойством ГруппаОшибок, например, НСтр("ru = 'Пользователь в строке %1 не выбран.'").
• ИндексСтроки — Неопределено - совпадает со значением параметра НомерСтроки.
• Число — значение от 0 ... , определяющее номер строки, который нужно подставить в строку ПолеОшибки.

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

ОбщегоНазначенияКлиентСервер.ДобавитьОшибкуПользователю(Ошибки, ПолеОшибки, ТекстДляОднойОшибки, ГруппаОшибок, НомерСтроки, ТекстДляНесколькихОшибок, ИндексСтроки)

Доступность

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