Модуль ОбщегоНазначенияКлиентСервер

Клиент - серверные процедуры и функции (&НаКлиентеНаСервереБезКонтекста)

Оповещение пользователя

Процедура ДобавитьОшибкуПользователю()

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

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

Процедура СообщитьОшибкиПользователю()

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

Процедура СообщитьОшибкиПользователю(Ошибки, Отказ = Ложь) Экспорт

Функция ТекстОшибкиЗаполнения()

Формирует текст ошибок заполнения полей и списков.

Функция ТекстОшибкиЗаполнения(
    ВидПоля = "Поле",
    ВидСообщения = "Заполнение",
    ИмяПоля = "",
    НомерСтроки = "",
    ИмяСписка = "",
    ТекстСообщения = "") Экспорт

Функция ПутьКТабличнойЧасти()

Формирует путь к заданной строке НомерСтроки и колонке ИмяРеквизита табличной части ИмяТабличнойЧасти для выдачи сообщений в форме. Для совместного использования с процедурой СообщитьПользователю (для передачи в параметры Поле или ПутьКДанным).

Функция ПутьКТабличнойЧасти(
    Знач ИмяТабличнойЧасти,
    Знач НомерСтроки, 
    Знач ИмяРеквизита) Экспорт

Функции описания текущего окружения клиентского приложения и операционной системы.

Функция ЕстьРеквизитИлиСвойствоОбъекта()

Проверяет наличие реквизита или свойства у произвольного объекта без обращения к метаданным.

Функция ЕстьРеквизитИлиСвойствоОбъекта(Объект, ИмяРеквизита) Экспорт

Процедура ДополнитьТаблицу()

Дополняет таблицу значений - приемник данными из таблицы значений - источника. Типы ТаблицаЗначений, ДеревоЗначений, ТабличнаяЧасть не доступны на клиенте.

Процедура ДополнитьТаблицу(ТаблицаИсточник, ТаблицаПриемник) Экспорт

Процедура ДополнитьТаблицуИзМассива()

Дополняет таблицу значений Таблица значениями из массива Массив.

Процедура ДополнитьТаблицуИзМассива(Таблица, Массив, ИмяПоля) Экспорт

Процедура ДополнитьМассив()

Дополняет массив МассивПриемник значениями из массива МассивИсточник.

Процедура ДополнитьМассив(
    МассивПриемник, 
    МассивИсточник, 
    ТолькоУникальныеЗначения = Ложь) Экспорт

Процедура ДополнитьСтруктуру()

Дополняет структуру значениями из другой структуры.

Процедура ДополнитьСтруктуру(Приемник, Источник, Заменять = Неопределено) Экспорт

Процедура ДополнитьСоответствие()

Дополняет соответствие значениями из другого соответствия.

Процедура ДополнитьСоответствие(Приемник, Источник, Заменять = Неопределено) Экспорт

Процедура УдалитьВсеВхожденияЗначенияИзМассива()

Удаляет все вхождения переданного значения из массива.

Процедура УдалитьВсеВхожденияЗначенияИзМассива(Массив, Значение) Экспорт

Процедура УдалитьВсеВхожденияТипаИзМассива()

Удаляет все вхождения значений указанного типа.

Процедура УдалитьВсеВхожденияТипаИзМассива(Массив, Тип) Экспорт

Процедура УдалитьЗначениеИзМассива()

Удаляет одно значение из массива.

Процедура УдалитьЗначениеИзМассива(Массив, Значение) Экспорт

Функция СвернутьМассив()

Возвращает копию исходного массива с уникальными значениями.

Функция СвернутьМассив(Знач Массив) Экспорт

Функция РазностьМассивов()

Возвращает разность массивов. Разностью двух массивов является массив, содержащий все элементы первого массива, не существующие во втором массиве.

Функция РазностьМассивов(Знач Массив, Знач МассивВычитания) Экспорт

Функция СпискиЗначенийИдентичны()

Сравнивает элементы списков значений или массивов по значениям.

Функция СпискиЗначенийИдентичны(Список1, Список2) Экспорт

Функция ЗначениеВМассиве()

Создает массив и помещает в него переданное значение.

Функция ЗначениеВМассиве(Знач Значение) Экспорт

Функция КлючиСтруктурыВСтроку()

Получает строку, содержащую ключи структуры, разделенные символом разделителя.

Функция КлючиСтруктурыВСтроку(Структура, Разделитель = ",") Экспорт

Функция СвойствоСтруктуры()

Возвращает значение свойства структуры.

Функция СвойствоСтруктуры(
    Структура, 
    Ключ, 
    ЗначениеПоУмолчанию = Неопределено) Экспорт

Функция ПустойУникальныйИдентификатор()

Возвращает пустой уникальный идентификатор.

Возвращаемое значение:

УникальныйИдентификатор - 00000000-0000-0000-0000-000000000000

Функция ПустойУникальныйИдентификатор() Экспорт

Функции для работы с управляемыми формами.

Процедура УстановитьСвойствоЭлементаФормы()

Устанавливает свойство ИмяСвойства элемента формы с именем ИмяЭлемента в значение Значение. Применяется в тех случаях, когда элемента формы может не быть на форме из-за отсутствия прав у пользователя на объект, реквизит объекта или команду.

Процедура УстановитьСвойствоЭлементаФормы(
    ЭлементыФормы, 
    ИмяЭлемента, 
    ИмяСвойства, 
    Значение) Экспорт

Функция ЗначениеСвойстваЭлементаФормы()

Возвращает значение свойства ИмяСвойства элемента формы с именем ИмяЭлемента. Применяется в тех случаях, когда элемент формы может не быть на форме из-за отсутствия прав у пользователя на объект, реквизит объекта или команду.

Функция ЗначениеСвойстваЭлементаФормы(
    ЭлементыФормы, 
    ИмяЭлемента, 
    ИмяСвойства) Экспорт