Office.Contact interface

Paquet:

outlook

Représente les détails d’un contact (similaire à ce qui se trouve sur un contact physique ou un carte professionnel) extraits du corps de l’élément. Mode Lecture uniquement.

La liste des contacts extraits du corps d’un message électronique ou d’un rendez-vous est retournée dans la contacts propriété de l’objet Entities retourné par la getEntities méthode ou getEntitiesByType de l’élément actif.

Remarques

Niveau d’autorisation minimal : restreint

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 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
*/

Propriétés

addresses	Tableau de chaînes contenant les adresses de messagerie et postales associées au contact. Pouvant accepter la valeur Null.
businessName	Chaîne contenant le nom de l’entreprise associée au contact. Pouvant accepter la valeur Null.
emailAddresses	Tableau de chaînes contenant les adresses de messagerie SMTP associées au contact. Pouvant accepter la valeur Null.
personName	Chaîne contenant le nom de la personne associée au contact. Pouvant accepter la valeur Null.
phoneNumbers	Tableau contenant un objet PhoneNumber pour chaque numéro de téléphone associé au contact. Pouvant accepter la valeur Null.
urls	Tableau de chaînes contenant les URL Internet associées au contact. Pouvant accepter la valeur Null.

Détails de la propriété

addresses

Tableau de chaînes contenant les adresses de messagerie et postales associées au contact. Pouvant accepter la valeur Null.

addresses: string[];

Valeur de propriété

string[]

businessName

Chaîne contenant le nom de l’entreprise associée au contact. Pouvant accepter la valeur Null.

businessName: string;

Valeur de propriété

string

emailAddresses

Tableau de chaînes contenant les adresses de messagerie SMTP associées au contact. Pouvant accepter la valeur Null.

emailAddresses: string[];

Valeur de propriété

string[]

personName

Chaîne contenant le nom de la personne associée au contact. Pouvant accepter la valeur Null.

personName: string;

Valeur de propriété

string

phoneNumbers

Tableau contenant un objet PhoneNumber pour chaque numéro de téléphone associé au contact. Pouvant accepter la valeur Null.

phoneNumbers: PhoneNumber[];

Valeur de propriété

Office.PhoneNumber[]

urls

Tableau de chaînes contenant les URL Internet associées au contact. Pouvant accepter la valeur Null.

urls: string[];

Valeur de propriété

string[]