Office.PhoneNumber interface

Пакет:

outlook

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

Массив объектов PhoneNumber, который содержит номера телефонов, обнаруженных в электронном сообщении, возвращается в свойстве phoneNumbers объекта Entities, который возвращается при вызове метода getEntities для выбранного элемента.

Комментарии

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

Применимый режим 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 phone numbers in the current item's body.
const phoneNumbers = item.getEntitiesByType(Office.MailboxEnums.EntityType.PhoneNumber);
console.log("There are " + phoneNumbers.length + " phone numbers.")
phoneNumbers.forEach(function (phoneNumber) {
    console.log("Phone number: " + JSON.stringify(phoneNumber.phoneString));
    console.log("Type: " + JSON.stringify(phoneNumber.type));
    console.log("Source text: " + JSON.stringify(phoneNumber.originalPhoneString));
});

Свойства

originalPhoneString	Получает текст элемента, который был распознан как номер телефона.
phoneString	Получает строку, содержащую номер телефона. Строка содержит только цифры номера телефона за исключением таких символов, как скобки и дефисы (если они существуют в исходном элементе).
type	Возвращает строку, определяющую тип номера телефона: "Домашний", "Рабочий", "Мобильный", "Не указано".

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

originalPhoneString

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

originalPhoneString: string;

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

string

phoneString

Получает строку, содержащую номер телефона. Строка содержит только цифры номера телефона за исключением таких символов, как скобки и дефисы (если они существуют в исходном элементе).

phoneString: string;

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

string

type

Возвращает строку, определяющую тип номера телефона: "Домашний", "Рабочий", "Мобильный", "Не указано".

type: string;

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

string