Office.Entities interface

Представляет коллекцию объектов, обнаруженных в электронном сообщении или сведениях о встрече. Только в режиме чтения.

Объект Entities — это контейнер для массивов сущностей, возвращаемых методами getEntities и getEntitiesByType, если элемент (электронное сообщение или сведения о встрече) содержит одну или несколько сущностей, обнаруженных сервером. Эти сущности можно использовать в коде, чтобы предоставить дополнительные контекстные сведения (например, отобразить адрес на карте или открыть приложение для набора телефонного номера, обнаруженного в элементе).

Если в элементе нет сущностей типа, указанного в свойстве, это свойство возвращает значение null. Например, если сообщение содержит почтовый адрес и номер телефона, свойства addresses и phoneNumbers будут содержать данные, а остальные свойства вернут значение null.

Чтобы строка распознавалась как адрес, она должна содержать почтовый адрес в США с такими элементами, как номер дома, название улицы, город, штат и почтовый индекс.

Чтобы строка распознавалась как номер телефона, она должна содержать номер телефона в формате, принятом в Северной Америке.

Распознавание сущностей опирается на встроенное распознавание языка, основанное на компьютерном осмыслении больших объемов данных. Распознавание сущности является недетерминированным, и успех иногда зависит от конкретного контекста в элементе.

Когда массивы свойств возвращаются методом, только свойство для указанной сущности содержит данные; все остальные свойства getEntitiesByType являются null.

Комментарии

Минимальный уровень разрешений: ReadItem

Применимый режим Outlook: Чтение

Свойства

addresses

Получает физические (почтовые) адреса, обнаруженные в сообщении электронной почты или встрече.

contacts

Получает контакты, обнаруженные в адресе электронной почты или встрече.

emailAddresses

Получает адреса электронной почты, обнаруженные в сообщении электронной почты или встрече.

meetingSuggestions

Получает предложения о собраниях, обнаруженные в сообщении электронной почты.

phoneNumbers

Получает номера телефона, обнаруженные в сообщении электронной почты или встрече.

taskSuggestions

Получает предложения задач, обнаруженные в сообщении электронной почты или встрече.

urls

Получает URL-адреса в Интернете, присутствующие в сообщении электронной почты или встрече.

Сведения о свойстве

addresses

Получает физические (почтовые) адреса, обнаруженные в сообщении электронной почты или встрече.

addresses: string[];

Значение свойства

string[]

Примеры

var item = Office.context.mailbox.item;
var addresses = item.getEntitiesByType(Office.MailboxEnums.EntityType.Address);

contacts

Получает контакты, обнаруженные в адресе электронной почты или встрече.

contacts: Contact[];

Значение свойства

Примеры

var item = Office.context.mailbox.item;
var contacts = item.getEntitiesByType(Office.MailboxEnums.EntityType.Contact);

emailAddresses

Получает адреса электронной почты, обнаруженные в сообщении электронной почты или встрече.

emailAddresses: string[];

Значение свойства

string[]

Примеры

var item = Office.context.mailbox.item;
var emailAddresses = item.getEntitiesByType(Office.MailboxEnums.EntityType.EmailAddress);

meetingSuggestions

Получает предложения о собраниях, обнаруженные в сообщении электронной почты.

meetingSuggestions: MeetingSuggestion[];

Значение свойства

Примеры

var item = Office.context.mailbox.item;
var meetingSuggestions = item.getEntitiesByType(Office.MailboxEnums.EntityType.MeetingSuggestion);

phoneNumbers

Получает номера телефона, обнаруженные в сообщении электронной почты или встрече.

phoneNumbers: PhoneNumber[];

Значение свойства

Примеры

var item = Office.context.mailbox.item;
var phoneNumbers = item.getEntitiesByType(Office.MailboxEnums.EntityType.PhoneNumber);

taskSuggestions

Получает предложения задач, обнаруженные в сообщении электронной почты или встрече.

taskSuggestions: string[];

Значение свойства

string[]

Примеры

var item = Office.context.mailbox.item;
var taskSuggestions = item.getEntitiesByType(Office.MailboxEnums.EntityType.TaskSuggestion);

urls

Получает URL-адреса в Интернете, присутствующие в сообщении электронной почты или встрече.

urls: string[];

Значение свойства

string[]

Примеры

var item = Office.context.mailbox.item;
var urls = item.getEntitiesByType(Office.MailboxEnums.EntityType.Url);