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