Office.Contact interface

Пакет:
outlook

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

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

Use regular expression rules instead.

Представляет сведения о контакте (аналогичные тем, которые указаны на физическом контакте или деловой карте), извлеченные из текста элемента. Только в режиме чтения.

Список контактов, извлеченный из текста сообщения электронной почты или встречи, возвращается в свойстве contactsобъекта Entities , возвращаемом getEntities методом или getEntitiesByType текущего элемента.

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

Комментарии

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

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

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

Примеры

const item = Office.context.mailbox.item;
// Get an array of strings that represent contacts in the current item's body.
const contacts = item.getEntitiesByType(Office.MailboxEnums.EntityType.Contact);
console.log("There are " + contacts.length + " contacts.")
contacts.forEach(function (contact) {
    console.log("Person name: " + JSON.stringify(contact.personName));
    console.log("Business name: " + JSON.stringify(contact.businessName));
    console.log("Addresses: " + JSON.stringify(contact.addresses));
    console.log("Phone numbers: " + JSON.stringify(contact.phoneNumbers));
    console.log("Email addresses: " + JSON.stringify(contact.emailAddresses));
    console.log("Urls: " + JSON.stringify(contact.urls));
});

/* Example email that includes contact details of sender, John Smith:
Hi there,
I have received the package.

Thanks.
John Smith
Account Manager
Contoso Corporation
1 Contoso Way, Redmond, WA 98052
john.smith@contoso.com
111-111-1111
https://contoso.com/john.smith
*/

Свойства

addresses

Массив строк, содержащих почтовые адреса, связанные с контактом. Допускается значение null.

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

Строка, содержащая название организации, связанное с контактом. Допускается значение null.

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

Массив строк, содержащих электронные адреса SMTP, связанные с контактом. Допускается значение null.

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

Строка, содержащая имя человека, связанное с контактом. Допускается значение null.

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

Массив, содержащий объект PhoneNumber для каждого номера телефона, связанного с контактом. Допускается значение null.

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

Массив строк, содержащих URL-адреса Интернета, связанные с контактом. Допускается значение null.

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

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

addresses

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

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

Use regular expression rules instead.

Массив строк, содержащих почтовые адреса, связанные с контактом. Допускается значение null.

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

addresses: string[];

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

string[]

businessName

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

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

Use regular expression rules instead.

Строка, содержащая название организации, связанное с контактом. Допускается значение null.

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

businessName: string;

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

string

emailAddresses

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

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

Use regular expression rules instead.

Массив строк, содержащих электронные адреса SMTP, связанные с контактом. Допускается значение null.

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

emailAddresses: string[];

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

string[]

personName

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

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

Use regular expression rules instead.

Строка, содержащая имя человека, связанное с контактом. Допускается значение null.

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

personName: string;

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

string

phoneNumbers

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

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

Use regular expression rules instead.

Массив, содержащий объект PhoneNumber для каждого номера телефона, связанного с контактом. Допускается значение null.

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

phoneNumbers: PhoneNumber[];

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

Office.PhoneNumber[]

urls

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

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

Use regular expression rules instead.

Массив строк, содержащих URL-адреса Интернета, связанные с контактом. Допускается значение null.

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

urls: string[];

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

string[]