Office.PhoneNumber interface

Paquet:

outlook

Représente un numéro de téléphone identifié dans un élément. Mode Lecture uniquement.

Un tableau d’objets PhoneNumber contenant des numéros de téléphone trouvés dans un message électronique est renvoyé dans la propriété phoneNumbers de l’objet Entities renvoyé lors de l’appel de la méthode getEntities pour l’élément sélectionné.

Remarques

Niveau d’autorisation minimal : élément de lecture

Mode Outlook applicable : Lecture

Important : les compléments Outlook contextuels basés sur des entités seront mis hors service au deuxième trimestre 2024. Le travail de mise hors service de cette fonctionnalité commencera en mai et se poursuivra jusqu’à la fin du mois de juin. Après juin, les compléments contextuels ne seront plus en mesure de détecter les entités dans les éléments de courrier pour effectuer des tâches sur ces derniers. Les API suivantes seront également mises hors service.

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

Pour réduire les interruptions potentielles, les éléments suivants seront toujours pris en charge une fois les compléments contextuels basés sur des entités mis hors service.

• Une autre implémentation du bouton Participer à une réunion , qui est activé par les compléments de réunion en ligne, est en cours de développement. Une fois la prise en charge des compléments contextuels basés sur des entités terminée, les compléments de réunion en ligne passent automatiquement à l’implémentation alternative pour activer le bouton Participer à une réunion .

• Les règles d’expression régulière continueront d’être prises en charge une fois les compléments contextuels basés sur des entités mis hors service. Nous vous recommandons de mettre à jour votre complément contextuel pour utiliser des règles d’expression régulière comme solution alternative. Pour obtenir des conseils sur la façon d’implémenter ces règles, voir Utiliser des règles d’activation d’expression régulière pour afficher un complément Outlook.

Pour plus d’informations, consultez Retrait des compléments Outlook contextuels basés sur des entités.

Exemples

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

Propriétés

originalPhoneString	Obtient le texte identifié dans un élément en tant que numéro de téléphone.
phoneString	Obtient une chaîne contenant un numéro de téléphone. Cette chaîne contient uniquement les chiffres du numéro de téléphone et exclut les caractères tels que les parenthèses et les caractères, s’ils existent dans l’élément d’origine.
type	Obtient une chaîne qui identifie le type de numéro de téléphone : Domicile, Travail, Mobile, Non spécifié.

Détails de la propriété

originalPhoneString

Obtient le texte identifié dans un élément en tant que numéro de téléphone.

originalPhoneString: string;

Valeur de propriété

string

phoneString

Obtient une chaîne contenant un numéro de téléphone. Cette chaîne contient uniquement les chiffres du numéro de téléphone et exclut les caractères tels que les parenthèses et les caractères, s’ils existent dans l’élément d’origine.

phoneString: string;

Valeur de propriété

string

type

Obtient une chaîne qui identifie le type de numéro de téléphone : Domicile, Travail, Mobile, Non spécifié.

type: string;

Valeur de propriété

string