Контакт (contact)

Содержание

Описание
Ограничения
Поля
См. также
- API
- Логические роли

Описание

Контакт адресной книги.
Применяется в приложениях и сервисах, осуществляющих регулярную коммуникацию с одним и тем же набором абонентов: селекторные совещания, оповещения и т.д.
Может синхронизироваться с LDAP в сценариях по расписанию.

Ограничения

Коллекция доступна только в рабочих доменах.

Поля

Структура сущности

{
  "id": uuid,
  "autokey": int,
  "displayname": str,
  "department": str,
  "jobtitle": str,
  "number": str,
  "numlocal": str,
  "numpublic": str,
  "mobile": str,
  "mobile2": str,
  "mobile3": str,
  "roomnum": str,
  "roomnum2": str,
  "roomnum3": str,
  "email": str,
  "email2": str,
  "email3": str,
  "photo": str,
  "opts": {
    "title": str,
    "comment": str,
    "groups": array<str>,
    "priority": int | null
  },
  "ext": {
    "ct": date,
    "lwt": date
  }
}

Описание характеристик спецификации

Table 1. Поля
Спецификация	Описание
Поле: `id` Режим: `inout` Тип: `uuid` По умолчанию: generated	Идентификатор. Может быть задан при создании, иначе генерируется системой.
Поле: `autokey` Режим: `out` Тип: `int` По умолчанию: generated	Порядковый номер. Генерируется автоматически и является ключевым полем, по которому производится связка. Не подлежит изменению. При создании сущности должен отсутствовать или быть равным `-1`. Применяется для ассоциации с другими сущностями.
Поле: `displayname` Режим: `in` Тип: `str` По умолчанию: required	Отображаемое имя
Поле: `department` Режим: `in` Тип: `str` По умолчанию: empty	Подразделение. Не используется системой. Только для хранения и проектного использования.
Поле: `jobtitle` Режим: `in` Тип: `str` По умолчанию: empty	Должность. Не используется системой. Только для хранения и проектного использования.
Поле: `number` Режим: `in` Тип: `str` По умолчанию: required	Основной номер телефона.
Поле: `numlocal` Режим: `in` Тип: `str` По умолчанию: empty	Дополнительный номер телефона (внутренний). Не используется системой. Только для хранения и проектного использования.
Поле: `numpublic` Режим: `in` Тип: `str` По умолчанию: empty	Дополнительный номер телефона (внешний). Не используется системой. Только для хранения и проектного использования.
Поле: `mobile` Режим: `in` Тип: `str` По умолчанию: empty	Основной номер мобильного телефона. Не используется системой. Только для хранения и проектного использования.
Поле: `mobile2` Режим: `in` Тип: `str` По умолчанию: empty	Дополнительный номер мобильного телефона 2. Не используется системой. Только для хранения и проектного использования.
Поле: `mobile3` Режим: `in` Тип: `str` По умолчанию: empty	Дополнительный номер мобильного телефона 3. Не используется системой. Только для хранения и проектного использования.
Поле: `roomnum` Режим: `in` Тип: `str` По умолчанию: empty	Зарезервированный номер конференц-комнаты. Не используется системой. Только для хранения и проектного использования.
Поле: `roomnum2` Режим: `in` Тип: `str` По умолчанию: empty	Зарезервированный номер конференц-комнаты 2. Не используется системой. Только для хранения и проектного использования.
Поле: `roomnum3` Режим: `in` Тип: `str` По умолчанию: empty	Зарезервированный номер конференц-комнаты 3. Не используется системой. Только для хранения и проектного использования.
Поле: `email` Режим: `in` Тип: `str` По умолчанию: empty	Основной ящик электронной почты. Не используется системой. Только для хранения и проектного использования.
Поле: `email2` Режим: `in` Тип: `str` По умолчанию: empty	Дополнительный ящик электронной почты. Не используется системой. Только для хранения и проектного использования.
Поле: `email3` Режим: `in` Тип: `str` По умолчанию: empty	Дополнительный ящик электронной почты. Не используется системой. Только для хранения и проектного использования.
Поле: `photo` Режим: `in` Тип: `str` По умолчанию: empty	Фотография. Не используется системой. Только для хранения и проектного использования.
Поле: `opts` Режим: `in` Тип: `object` Составное поле
Поле: `opts.title` Режим: `in` Тип: `str` По умолчанию: empty	Произвольный заголовок
Поле: `opts.comment` Режим: `in` Тип: `str` По умолчанию: empty	Произвольный комментарий
Поле: `opts.groups` Режим: `inout` Тип: `array<str>` По умолчанию: empty	Коды групп контактов (поле `code`), включающих данный контакт. Автоматически связывается с аналогичным полем групп и может изменяться системой.
Поле: `opts.priority` Режим: `in` Тип: `int \| null` По умолчанию: `null`	Личный приоритет контакта, применяемый при построении списка для оповещения. Синхронизирован с приоритетами групп.
Поле: `ext` Режим: `inout` Тип: `object` Составное поле	Позволяет расширять состав произвольными ключами и значениями
Поле: `ext.ct` Режим: `out` Тип: `date` По умолчанию: generated	Время создания объекта
Поле: `ext.lwt` Режим: `out` Тип: `date` По умолчанию: generated	Время последней модификации объекта

См. также

API

/rest/v1/addressbook/contacts

Логические роли

mdc и sdc хранят контакты.
svc производит с помощью сценариев синхронизацию контактов с LDAP.