Office.Contact interface
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. |
business |
Chaîne contenant le nom de l’entreprise associée au contact. Pouvant accepter la valeur Null. |
email |
Tableau de chaînes contenant les adresses de messagerie SMTP associées au contact. Pouvant accepter la valeur Null. |
person |
Chaîne contenant le nom de la personne associée au contact. Pouvant accepter la valeur Null. |
phone |
Tableau contenant un objet |
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é
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[]
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour