Office.Contact interface

  • Ссылка
Пакет:
outlook

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

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

Комментарии

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

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

Важно! Контекстные надстройки Outlook на основе сущностей будут прекращены во 2-м квартале 2024 г. Работа по прекращению использования этой функции начнется в мае и продолжится до конца июня. После июня контекстные надстройки больше не смогут обнаруживать сущности в почтовых элементах для выполнения задач над ними. Следующие API также будут прекращены.

  • Office.context.mailbox.item.getEntities - Office.context.mailbox.item.getEntitiesByType - Office.context.mailbox.item.getFilteredEntitiesByName - Office.context.mailbox.item.getSelectedEntities

Чтобы свести к минимуму возможные перебои, после прекращения использования контекстных надстроек на основе сущностей будет по-прежнему поддерживаться следующее.

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

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

Дополнительные сведения см. в разделе Прекращение использования контекстных надстроек 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.
businessName

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

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

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

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

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

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

addresses

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

addresses: string[];

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

string[]

businessName

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

businessName: string;

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

string

emailAddresses

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

emailAddresses: string[];

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

string[]

personName

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

personName: string;

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

string

phoneNumbers

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

phoneNumbers: PhoneNumber[];

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

Office.PhoneNumber[]

urls

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

urls: string[];

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

string[]