Office.Entities interface

Пакет:

outlook

Предупреждение

Теперь этот API является нерекомендуемым.

Use regular expression rules instead.

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

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

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

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

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

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

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

Предупреждение. Поддержка контекстно-зависимых надстроек Outlook на основе сущностей прекращена. Однако правила регулярных выражений по-прежнему поддерживаются. Мы рекомендуем обновить контекстную надстройку, чтобы использовать правила регулярных выражений в качестве альтернативного решения. Рекомендации по реализации этих правил см. в статье "Контекстные надстройки Outlook".

Комментарии

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

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

Используется

• Office.AppointmentRead: getEntities, getSelectedEntities
• Office.MessageRead: getEntities, getSelectedEntities

Свойства

addresses	Получает физические (почтовые) адреса, обнаруженные в сообщении электронной почты или встрече. Предупреждение. Поддержка контекстно-зависимых надстроек Outlook на основе сущностей прекращена. Однако правила регулярных выражений по-прежнему поддерживаются. Мы рекомендуем обновить контекстную надстройку, чтобы использовать правила регулярных выражений в качестве альтернативного решения. Рекомендации по реализации этих правил см. в статье "Контекстные надстройки Outlook".
contacts	Получает контакты, обнаруженные в адресе электронной почты или встрече. Предупреждение. Поддержка контекстно-зависимых надстроек Outlook на основе сущностей прекращена. Однако правила регулярных выражений по-прежнему поддерживаются. Мы рекомендуем обновить контекстную надстройку, чтобы использовать правила регулярных выражений в качестве альтернативного решения. Рекомендации по реализации этих правил см. в статье "Контекстные надстройки Outlook".
emailAddresses	Получает адреса электронной почты, обнаруженные в сообщении электронной почты или встрече. Предупреждение. Поддержка контекстно-зависимых надстроек Outlook на основе сущностей прекращена. Однако правила регулярных выражений по-прежнему поддерживаются. Мы рекомендуем обновить контекстную надстройку, чтобы использовать правила регулярных выражений в качестве альтернативного решения. Рекомендации по реализации этих правил см. в статье "Контекстные надстройки Outlook".
meetingSuggestions	Получает предложения о собраниях, обнаруженные в сообщении электронной почты. Предупреждение. Поддержка контекстно-зависимых надстроек Outlook на основе сущностей прекращена. Однако правила регулярных выражений по-прежнему поддерживаются. Мы рекомендуем обновить контекстную надстройку, чтобы использовать правила регулярных выражений в качестве альтернативного решения. Рекомендации по реализации этих правил см. в статье "Контекстные надстройки Outlook".
phoneNumbers	Получает номера телефона, обнаруженные в сообщении электронной почты или встрече. Предупреждение. Поддержка контекстно-зависимых надстроек Outlook на основе сущностей прекращена. Однако правила регулярных выражений по-прежнему поддерживаются. Мы рекомендуем обновить контекстную надстройку, чтобы использовать правила регулярных выражений в качестве альтернативного решения. Рекомендации по реализации этих правил см. в статье "Контекстные надстройки Outlook".
taskSuggestions	Получает предложения задач, обнаруженные в сообщении электронной почты или встрече. Предупреждение. Поддержка контекстно-зависимых надстроек Outlook на основе сущностей прекращена. Однако правила регулярных выражений по-прежнему поддерживаются. Мы рекомендуем обновить контекстную надстройку, чтобы использовать правила регулярных выражений в качестве альтернативного решения. Рекомендации по реализации этих правил см. в статье "Контекстные надстройки Outlook".
urls	Получает URL-адреса в Интернете, присутствующие в сообщении электронной почты или встрече. Предупреждение. Поддержка контекстно-зависимых надстроек Outlook на основе сущностей прекращена. Однако правила регулярных выражений по-прежнему поддерживаются. Мы рекомендуем обновить контекстную надстройку, чтобы использовать правила регулярных выражений в качестве альтернативного решения. Рекомендации по реализации этих правил см. в статье "Контекстные надстройки Outlook".

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

addresses

Предупреждение

Теперь этот API является нерекомендуемым.

Use regular expression rules instead.

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

Предупреждение. Поддержка контекстно-зависимых надстроек Outlook на основе сущностей прекращена. Однако правила регулярных выражений по-прежнему поддерживаются. Мы рекомендуем обновить контекстную надстройку, чтобы использовать правила регулярных выражений в качестве альтернативного решения. Рекомендации по реализации этих правил см. в статье "Контекстные надстройки Outlook".

addresses: string[];

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

string[]

Примеры

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

contacts

Предупреждение

Теперь этот API является нерекомендуемым.

Use regular expression rules instead.

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

Предупреждение. Поддержка контекстно-зависимых надстроек Outlook на основе сущностей прекращена. Однако правила регулярных выражений по-прежнему поддерживаются. Мы рекомендуем обновить контекстную надстройку, чтобы использовать правила регулярных выражений в качестве альтернативного решения. Рекомендации по реализации этих правил см. в статье "Контекстные надстройки Outlook".

contacts: Contact[];

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

Office.Contact[]

Примеры

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

emailAddresses

Предупреждение

Теперь этот API является нерекомендуемым.

Use regular expression rules instead.

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

Предупреждение. Поддержка контекстно-зависимых надстроек Outlook на основе сущностей прекращена. Однако правила регулярных выражений по-прежнему поддерживаются. Мы рекомендуем обновить контекстную надстройку, чтобы использовать правила регулярных выражений в качестве альтернативного решения. Рекомендации по реализации этих правил см. в статье "Контекстные надстройки Outlook".

emailAddresses: string[];

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

string[]

Примеры

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

meetingSuggestions

Предупреждение

Теперь этот API является нерекомендуемым.

Use regular expression rules instead.

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

Предупреждение. Поддержка контекстно-зависимых надстроек Outlook на основе сущностей прекращена. Однако правила регулярных выражений по-прежнему поддерживаются. Мы рекомендуем обновить контекстную надстройку, чтобы использовать правила регулярных выражений в качестве альтернативного решения. Рекомендации по реализации этих правил см. в статье "Контекстные надстройки Outlook".

meetingSuggestions: MeetingSuggestion[];

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

Office.MeetingSuggestion[]

Примеры

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

phoneNumbers

Предупреждение

Теперь этот API является нерекомендуемым.

Use regular expression rules instead.

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

Предупреждение. Поддержка контекстно-зависимых надстроек Outlook на основе сущностей прекращена. Однако правила регулярных выражений по-прежнему поддерживаются. Мы рекомендуем обновить контекстную надстройку, чтобы использовать правила регулярных выражений в качестве альтернативного решения. Рекомендации по реализации этих правил см. в статье "Контекстные надстройки Outlook".

phoneNumbers: PhoneNumber[];

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

Office.PhoneNumber[]

Примеры

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

taskSuggestions

Предупреждение

Теперь этот API является нерекомендуемым.

Use regular expression rules instead.

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

Предупреждение. Поддержка контекстно-зависимых надстроек Outlook на основе сущностей прекращена. Однако правила регулярных выражений по-прежнему поддерживаются. Мы рекомендуем обновить контекстную надстройку, чтобы использовать правила регулярных выражений в качестве альтернативного решения. Рекомендации по реализации этих правил см. в статье "Контекстные надстройки Outlook".

taskSuggestions: string[];

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

string[]

Примеры

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

urls

Предупреждение

Теперь этот API является нерекомендуемым.

Use regular expression rules instead.

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

Предупреждение. Поддержка контекстно-зависимых надстроек Outlook на основе сущностей прекращена. Однако правила регулярных выражений по-прежнему поддерживаются. Мы рекомендуем обновить контекстную надстройку, чтобы использовать правила регулярных выражений в качестве альтернативного решения. Рекомендации по реализации этих правил см. в статье "Контекстные надстройки Outlook".

urls: string[];

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

string[]

Примеры

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