Создает элемент данных контакта.
Синтаксис
Новый ЭлементДанныхКонтакта(<ТипДанных>, <Значение>)Полное описание, параметры и ограничения
ЭлементДанныхКонтакта.По умолчанию
ЭлементДанныхКонтакта (ContactDataItem)
По умолчанию
Доступен, начиная с версии 8.3.4.
Синтаксис:
Новый ЭлементДанныхКонтакта(<ТипДанных>, <Значение>)
Параметры:
<ТипДанных> (обязательный)
Тип: Строка, ТипНомераТелефонаДанныхКонтакта, ТипАдресаЭлектроннойПочтыДанныхКонтакта, ТипАдресаДанныхКонтакта, ТипВебАдресаДанныхКонтакта, ТипОтношенийДанныхКонтакта.
Указывает, как интерпретировать значение.
Например, тип данных Рабочий показывает, что в значении хранится номер рабочего телефона.
<Значение> (обязательный)
Тип: Строка, Дата, ДанныеАдреса.
Значение элемента данных контакта.
Описание:
Создает элемент данных контакта.
Использование в версии:
Доступен, начиная с версии 8.3.4.
Методическая информация
Практические примеры
Собрать адрес из структуры и добавить его в контакт
ДанныеАдреса заполняется конструктором, свойства объекта readonly. Индекс сохраняем строкой с ведущими нулями, а не числом.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Учебная база, серверный контекст. ДанныеКонтакта и связанные типы доступны на сервере: для этих задач не нужен мобильный телефон, разрешение на контакты или настоящая адресная книга.
Вся персона вымышлена: Учебный Ученик Тестович, организация Учебный магазин. Телефоны 000-000-01/02 — демонстрационные строки, адрес student@example.invalid учебный. Ничего не отправляйте и не звоните.
Код создаёт объекты только в памяти. Он не вызывает менеджер контактов устройства, синхронизацию, геокодирование, интернет или запись справочника Партнеры/КонтактныеЛица.
Контакт = Новый ДанныеКонтакта;
Контакт.Имя = "Учебный";
Контакт.Фамилия = "Ученик";
Контакт.Отчество = "Тестович";
ПоляАдреса = Новый Структура;
ПоляАдреса.Вставить("Страна", "Учебная страна");
ПоляАдреса.Вставить("Регион", "Учебный регион");
ПоляАдреса.Вставить("Город", "Учебный город");
ПоляАдреса.Вставить("Улица", "Учебная улица");
ПоляАдреса.Вставить("Дом", "1");
ПоляАдреса.Вставить("Индекс", "000001");
ПоляАдреса.Вставить("Представление", "Учебный город, Учебная улица, 1");
Адрес = Новый ДанныеАдреса(ПоляАдреса);
Контакт.Адреса = Новый Массив;
Контакт.Адреса.Добавить(Новый ЭлементДанныхКонтакта(ТипАдресаДанныхКонтакта.Рабочий, Адрес));
Сообщить(Адрес.Страна = "Учебная страна");
Сообщить(Адрес.Регион = "Учебный регион");
Сообщить(Адрес.Город = "Учебный город");
Сообщить(Адрес.Индекс = "000001");
Сообщить(Адрес.Представление = "Учебный город, Учебная улица, 1");
Сообщить(ТипЗнч(Контакт.Адреса[0].Значение) = Тип("ДанныеАдреса"));
Сообщить("Строка адреса платформы: " + Адрес.СтрокаАдреса);
Сообщить("Основная строка: " + Адрес.СтрокаАдресаОсновная);
Сообщить("Дополнительная строка: " + Адрес.СтрокаАдресаДополнительная);Разбор по шагам
Имена ключей конструктора Улица и Дом не заменяем на неподтверждённые ключи произвольного JSON.
Все части учебного адреса задаём до Новый ДанныеАдреса; затем свойства только читаем.
Массив Адреса хранит элементы, внутри Значение — объект ДанныеАдреса, а не строка.
Три строковых представления выводим фактически. Отдельные основная/дополнительная строки не используются свойствами ДанныеКонтакта согласно справке.
Как проверить результат
Шесть логических сообщений Истина; три адресных строки выведены как диагностика платформы.
Учебный индекс 000001 не потерял ведущие нули; никакой геокодер не подтвердил существование этого адреса.
Ожидаемый результат
Собственный неизменяемый адрес помещён в один рабочий адресный элемент.
На что обратить внимание
Это собственные учебные объекты, не контакт, уже полученный от операционной системы или сохранённый на устройстве.
Представление задаёт текст для человека, не нормализованный идентификатор ФИАС или координаты.
Не присваивайте Адрес.Город после создания: для изменения сформируйте новый объект из новой структуры.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Разделить день рождения и собственное событие контакта
ДеньРождения — отдельная дата. События — массив элементов со строковой подписью типа и значением Дата; напоминания этим не планируются.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Учебная база, серверный контекст. ДанныеКонтакта и связанные типы доступны на сервере: для этих задач не нужен мобильный телефон, разрешение на контакты или настоящая адресная книга.
Вся персона вымышлена: Учебный Ученик Тестович, организация Учебный магазин. Телефоны 000-000-01/02 — демонстрационные строки, адрес student@example.invalid учебный. Ничего не отправляйте и не звоните.
Код создаёт объекты только в памяти. Он не вызывает менеджер контактов устройства, синхронизацию, геокодирование, интернет или запись справочника Партнеры/КонтактныеЛица.
Контакт = Новый ДанныеКонтакта;
Контакт.Имя = "Учебный";
Контакт.Фамилия = "Ученик";
Контакт.Отчество = "Тестович";
Контакт.ДеньРождения = Дата(2000, 1, 1);
Контакт.События = Новый Массив;
Событие = Новый ЭлементДанныхКонтакта("Учебная встреча", Дата(2026, 10, 3));
Контакт.События.Добавить(Событие);
Если ТипЗнч(Событие.Значение) <> Тип("Дата") Тогда
ВызватьИсключение "Событие должно содержать дату";
КонецЕсли;
Сообщить(Контакт.ДеньРождения = Дата(2000, 1, 1));
Сообщить(Событие.ТипДанных = "Учебная встреча");
Сообщить(Событие.Значение = Дата(2026, 10, 3));
Сообщить(Контакт.События.Количество() = 1);Разбор по шагам
Дата рождения вымышленная и задаётся как дата, не строка 01.01.2000.
Для события ТипДанных — собственная строка, Значение — объект даты.
Тип проверяем до работы с датой; не создаём регламентного задания, календарной записи или уведомления.
Как проверить результат
Четыре сообщения Истина.
Дата события не заменила ДеньРождения и не запланировала напоминание.
Ожидаемый результат
У контакта есть отдельная вымышленная дата рождения и одно учебное событие.
На что обратить внимание
Это собственные учебные объекты, не контакт, уже полученный от операционной системы или сохранённый на устройстве.
Пример не рассчитывает возраст или ближайший день рождения с учётом календарных правил.
Поле даты не содержит автоматически временную зону и правила повторения события.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.