Office.PhoneNumber interface

Pacote:

outlook

Representa um número de telefone identificado em um item. Somente modo de leitura.

Uma matriz de objetos PhoneNumber que contém os números de telefone encontrados em uma mensagem de email é retornada na propriedade phoneNumbers do objeto Entities, que é retornado ao chamar o método getEntities no item selecionado.

Comentários

Nível mínimo de permissão: item de leitura

Modo outlook aplicável: Leitura

Importante: os suplementos contextuais do Outlook baseados em entidade serão desativados no segundo trimestre de 2024. O trabalho para aposentar esse recurso começará em maio e continuará até o final de junho. Após junho, os suplementos contextuais não poderão mais detectar entidades em itens de email para executar tarefas neles. As APIs a seguir também serão retiradas.

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

Para ajudar a minimizar possíveis interrupções, o seguinte ainda será suportado depois que os suplementos contextuais baseados em entidade forem retirados.

• Uma implementação alternativa do botão Ingressar Reunião , que é ativado por suplementos de reunião online, está sendo desenvolvida. Depois que o suporte para suplementos contextuais baseados em entidade terminar, os suplementos de reunião online farão a transição automática para a implementação alternativa para ativar o botão Ingressar Reunião .

• As regras de expressão regular continuarão a ser suportadas depois que os suplementos contextuais baseados em entidade forem retirados. Recomendamos atualizar seu suplemento contextual para usar regras de expressão regulares como uma solução alternativa. Para obter diretrizes sobre como implementar essas regras, consulte Usar regras regulares de ativação de expressão para mostrar um suplemento do Outlook.

Para obter mais informações, consulte Aposentadoria de suplementos contextuais do Outlook baseados em entidade.

Exemplos

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));
});

Propriedades

originalPhoneString	Obtém o texto que foi identificado em um item como um número de telefone.
phoneString	Obtém uma cadeia de caracteres que contém um número de telefone. Essa cadeia de caracteres contém apenas os dígitos do número de telefone e exclui os caracteres como parênteses e hifens, se existirem no item original.
type	Obtém uma cadeia de caracteres que identifica o tipo de número de telefone: Home, Work, Mobile, Unspecified.

Detalhes da propriedade

originalPhoneString

Obtém o texto que foi identificado em um item como um número de telefone.

originalPhoneString: string;

Valor da propriedade

string

phoneString

Obtém uma cadeia de caracteres que contém um número de telefone. Essa cadeia de caracteres contém apenas os dígitos do número de telefone e exclui os caracteres como parênteses e hifens, se existirem no item original.

phoneString: string;

Valor da propriedade

string

type

Obtém uma cadeia de caracteres que identifica o tipo de número de telefone: Home, Work, Mobile, Unspecified.

type: string;

Valor da propriedade

string