Тип: Строка. Содержит глобальный ключ контакта, идентифицирующий его во внешнем сервисе хранения контактов.
Полное описание, параметры и ограничения
ДанныеКонтактаУчетнойЗаписи.ГлобальныйКлючКонтакта (AccountContactData.GlobalContactKey)
ДанныеКонтактаУчетнойЗаписи (AccountContactData)
ГлобальныйКлючКонтакта (GlobalContactKey)
Доступен, начиная с версии 8.3.4.
Использование:
Чтение и запись.
Описание:
Тип: Строка.
Содержит глобальный ключ контакта, идентифицирующий его во внешнем сервисе хранения контактов.
Доступность:
Мобильный клиент, сервер, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.3.4.
Методическая информация
Практические примеры
Связать свой черновик контакта с локальной записью без добавления
Конструктор карточки связывает данные и настоящую запись ОС, но сам не создаёт контакт в адресной книге.
Где и как запускать
Полный клиентский модуль собственной мобильной управляемой формы. Не вставляйте процедуры внутрь другой процедуры.
Подготовка
Только мобильный клиент/мобильное приложение 1С на собственном тестовом устройстве и отдельная пустая конфигурация УчебнаяКонфигурацияСинтаксиса. Настольный клиент не заменяет этот API.
Вручную разрешите доступ к контактам только своему учебному приложению. Поддержка метода не доказывает разрешение ОС.
Изменения адресной книги выполняйте только в отдельном локальном учебном профиле без синхронизации и реальных контактов. Не используйте корпоративные/личные учётные записи.
Создайте отдельную управляемую форму для каждого урока. Полный код вставляется на уровне модуля; команды и указанные строковые реквизиты создаются вручную.
Рецепты изменения/удаления при ручном запуске реально меняют адресную книгу ОС. Здесь они не исполнялись, runtime-проверка 1С не заявляется.
&НаКлиенте
Процедура ВыполнитьПример(Команда)
Менеджер = Новый МенеджерКонтактов;
ЛокальнаяЗапись = Менеджер.ПолучитьЛокальнуюУчетнуюЗаписьКонтактов();
Данные = Новый ДанныеКонтакта;
Данные.Имя = "Учебный персонаж Книга";
Данные.Фамилия = "Вымышленный";
Данные.Заметка = "Черновик в памяти, без телефонов и адресов";
Карточка = Новый ДанныеКонтактаУчетнойЗаписи(Данные, ЛокальнаяЗапись, "");
Сообщить(Карточка.ДанныеКонтакта.Имя = "Учебный персонаж Книга");
Сообщить(Карточка.УчетнаяЗапись.Идентификатор = ЛокальнаяЗапись.Идентификатор);
Сообщить(Карточка.УчетнаяЗапись.ИсточникУчетнойЗаписи = ЛокальнаяЗапись.ИсточникУчетнойЗаписи);
Сообщить(ПустаяСтрока(Карточка.ГлобальныйКлючКонтакта));
КонецПроцедурыРазбор по шагам
Создайте команду ВыполнитьПример. Настоящую локальную учётную запись получаем от менеджера; конструктор УчетнаяЗаписьКонтактов не выдумываем.
ДанныеКонтакта содержат поля человека, а ДанныеКонтактаУчетнойЗаписи — данные, запись и глобальный ключ. Это разные объекты.
Третий аргумент карточки — строка глобального ключа. Для своего нового черновика он пуст, а не случайный UUID вместо ключа внешнего сервиса.
ДобавитьКонтакт не вызывается. ЛокальныйКлючКонтакта пока отсутствует: он появляется как результат реального добавления, не как имя человека.
Как проверить результат
Четыре логических сравнения дают Истина.
В адресной книге не появился новый человек; существующие записи не читались по одному и не менялись.
Ожидаемый результат
Показана реальная структура карточки с собственными вымышленными данными и без записи ОС.
На что обратить внимание
Не присваивайте идентификатор/источник учётной записи: это свойства только для чтения.
Пустой глобальный ключ не является разрешением синхронизации или удаления произвольного контакта.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.