БСП Контактная информация - работа с контактной информацией в 1с

// Преобразует все входящие форматы контактной информации в XML.
// Параметры:
// ЗначенияПолей - Строка, Структура, Соответствие, СписокЗначений - описание полей контактной информации.
// Представление - Строка - представления. Используется, если невозможно определить представление из параметра.
// ЗначенияПолей (отсутствие поля "Представление").
// ОжидаемыйВид - СправочникСсылка.ВидыКонтактнойИнформации, ПеречислениеСсылка.ТипыКонтактнойИнформации -
// Используется для определения типа, если его невозможно вычислить по полю ЗначенияПолей.
// Возвращает Строка - XML данные контактной информации.
Результат = УправлениеКонтактнойИнформацией. КонтактнаяИнформацияВXML( ЗначенияПолей, Представление, ОжидаемыйВид);

// Возвращает признак того, является ли строка данных контактной информации XML данными.
// Параметры:
// Текст - Строка - Проверяемая строка.
// Возвращает Булево - результат проверки.
Результат = УправлениеКонтактнойИнформациейКлиентСервер. ЭтоКонтактнаяИнформацияВXML( Текст);

// Открывает подходящую форму контактной информации для редактирования или просмотра.
// Параметры:
// Параметры - Произвольный - результат функции ПараметрыФормыКонтактнойИнформации.
// Владелец - Произвольный - параметр для открываемой формы.
// Оповещение - ОписаниеОповещения - для обработки закрытия формы.
// Возвращаемое значение: необходимая форма.
Результат = УправлениеКонтактнойИнформациейКлиент. ОткрытьФормуКонтактнойИнформации( Параметры, Владелец, Оповещение);

// Конструктор для структуры параметров открытия формы контактной информации.
// Параметры:
// ВидКонтактнойИнформации - СправочникСсылка.ВидыКонтактнойИнформации - вид редактируемой информации,
// Значение - Строка - сериализованное значение полей контактной информации.
// Представление - Строка - необязательное представление.
Результат = УправлениеКонтактнойИнформациейКлиент. ПараметрыФормыКонтактнойИнформации( ВидКонтактнойИнформации, Значение, Представление, Комментарий, ТипКонтактнойИнформации);

// Предназначена для получения контактной информации для нескольких объектов.
// Параметры:
// МассивОбъектов - Массив - владельцы контактной информации, все элементы должны быть одного типа.
// ТипыКИ - Массив - необязательный, используется если не задан все типы.
// ВидыКИ - Массив - необязательный, используется если не задан все виды.
// Дата - Дата - необязательный, дата с которой действует запись контактной информации, используется при хранении истории изменения контактной информации.
// Если владелец хранит историю изменений, то при несоответствии параметра дате будет вызвано исключение.
// Возвращает Таблица значений - результат. Колонки:
// * Объект - Ссылка - владелец КИ.
// * Вид - СправочникСсылка.ВидыКонтактнойИнформации
// * Тип - ПеречислениеСсылка.ТипыКонтактнойИнформации
// * ЗначенияПолей - Строка - данные значений полей.
// * Представление - Строка - представление КИ.
// * ДействуетС - Дата - Дата с которой действует запись контактной информации, поле присутствует только для владельцев контактной информации которые хранят историю изменений.
Результат = УправлениеКонтактнойИнформацией. КонтактнаяИнформацияОбъектов( СсылкиИлиОбъекты, ТипыКонтактнойИнформации, ВидыКонтактнойИнформации, Дата);

// Получить значение определенного вида контактной информации у объекта.
// Параметры:
// Ссылка - ЛюбаяСсылка - ссылка на объект-владелец контактной информации (организация, контрагент, партнер и т.д.).
// ВидКонтактнойИнформации - СправочникСсылка.ВидыКонтактнойИнформации - параметры обработки.
// Возвращает Строка - строковое представление значения.
Результат = УправлениеКонтактнойИнформацией. КонтактнаяИнформацияОбъекта( СсылкаИлиОбъект, ВидИлиТипКонтактнойИнформации, Дата, ТолькоПредставление);

2024-06-24