Compartir a través de


Office.PhoneNumber interface

Representa un número de teléfono identificado en un elemento. Solo en modo Lectura.

Una matriz de objetos PhoneNumber que contiene los números de teléfono presentes en un mensaje de correo electrónico se devuelve en la propiedad phoneNumbers del objeto Entities que se devuelve al llamar al método getEntities en el elemento seleccionado.

Comentarios

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Lectura

Importante: Los complementos contextuales de Outlook basados en entidades se retirarán en el segundo trimestre de 2024. El trabajo para retirar esta característica comenzará en mayo y continuará hasta finales de junio. Después de junio, los complementos contextuales ya no podrán detectar entidades en elementos de correo para realizar tareas en ellos. También se retirarán las siguientes API.

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

Para ayudar a minimizar las posibles interrupciones, se seguirá admitiendo lo siguiente después de que se retiren los complementos contextuales basados en entidades.

  • Se está desarrollando una implementación alternativa del botón Unirse a la reunión , que se activa mediante complementos de reunión en línea. Una vez finalizada la compatibilidad con complementos contextuales basados en entidades, los complementos de reunión en línea pasarán automáticamente a la implementación alternativa para activar el botón Unirse a la reunión .

  • Las reglas de expresión regular seguirán siendo compatibles después de retirar los complementos contextuales basados en entidades. Se recomienda actualizar el complemento contextual para usar reglas de expresión regular como solución alternativa. Para obtener instrucciones sobre cómo implementar estas reglas, vea Usar reglas de activación de expresiones regulares para mostrar un complemento de Outlook.

Para obtener más información, vea Retirada de complementos contextuales de Outlook basados en entidades.

Ejemplos

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

Propiedades

originalPhoneString

Obtiene el texto que se identificó en un elemento como número de teléfono.

phoneString

Obtiene una cadena que contiene un número de teléfono. Esta cadena contiene solo los dígitos del número de teléfono y excluye caracteres como paréntesis y guiones si estos aparecen en el elemento original.

type

Obtiene una cadena que identifica el tipo de número de teléfono: Inicio, Trabajo, Móvil, Sin especificar.

Detalles de las propiedades

originalPhoneString

Obtiene el texto que se identificó en un elemento como número de teléfono.

originalPhoneString: string;

Valor de propiedad

string

phoneString

Obtiene una cadena que contiene un número de teléfono. Esta cadena contiene solo los dígitos del número de teléfono y excluye caracteres como paréntesis y guiones si estos aparecen en el elemento original.

phoneString: string;

Valor de propiedad

string

type

Obtiene una cadena que identifica el tipo de número de teléfono: Inicio, Trabajo, Móvil, Sin especificar.

type: string;

Valor de propiedad

string