Office.Contact interface
Représente les détails sur un contact (similaires à ce qui se trouve sur un contact physique ou une carte de visite) extraits du corps de l’élément. Mode Lecture uniquement.
La liste des contacts extraits du corps d’un e-mail ou d’un rendez-vous est renvoyée dans la contacts propriété de l’objet Entities renvoyée par la getEntities méthode ou getEntitiesByType de l’élément actuel.
Avertissement : les compléments Outlook contextuels basés sur une entité sont désormais mis hors service. Toutefois, les règles d’expression régulière restent prises en charge. 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 instructions sur la façon d’implémenter ces règles, voir Compléments contextuels Outlook.
Remarques
Niveau d’autorisation minimal : restreint
Mode Outlook applicable : Lecture
Utilisateur
- Office.AppointmentRead : getEntitiesByType, getFilteredEntitiesByName
- Office.Entities : contacts
- Office.MessageRead : getEntitiesByType, getFilteredEntitiesByName
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. Avertissement : les compléments Outlook contextuels basés sur une entité sont désormais mis hors service. Toutefois, les règles d’expression régulière restent prises en charge. 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 instructions sur la façon d’implémenter ces règles, voir Compléments contextuels Outlook. |
| business |
Chaîne contenant le nom de l’entreprise associée au contact. Pouvant accepter la valeur Null. Avertissement : les compléments Outlook contextuels basés sur une entité sont désormais mis hors service. Toutefois, les règles d’expression régulière restent prises en charge. 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 instructions sur la façon d’implémenter ces règles, voir Compléments contextuels Outlook. |
| email |
Tableau de chaînes contenant les adresses de messagerie SMTP associées au contact. Pouvant accepter la valeur Null. Avertissement : les compléments Outlook contextuels basés sur une entité sont désormais mis hors service. Toutefois, les règles d’expression régulière restent prises en charge. 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 instructions sur la façon d’implémenter ces règles, voir Compléments contextuels Outlook. |
| person |
Chaîne contenant le nom de la personne associée au contact. Pouvant accepter la valeur Null. Avertissement : les compléments Outlook contextuels basés sur une entité sont désormais mis hors service. Toutefois, les règles d’expression régulière restent prises en charge. 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 instructions sur la façon d’implémenter ces règles, voir Compléments contextuels Outlook. |
| phone |
Tableau contenant un objet Avertissement : les compléments Outlook contextuels basés sur une entité sont désormais mis hors service. Toutefois, les règles d’expression régulière restent prises en charge. 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 instructions sur la façon d’implémenter ces règles, voir Compléments contextuels Outlook. |
| urls | Tableau de chaînes contenant les URL Internet associées au contact. Pouvant accepter la valeur Null. Avertissement : les compléments Outlook contextuels basés sur une entité sont désormais mis hors service. Toutefois, les règles d’expression régulière restent prises en charge. 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 instructions sur la façon d’implémenter ces règles, voir Compléments contextuels Outlook. |
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.
Avertissement : les compléments Outlook contextuels basés sur une entité sont désormais mis hors service. Toutefois, les règles d’expression régulière restent prises en charge. 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 instructions sur la façon d’implémenter ces règles, voir Compléments contextuels Outlook.
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.
Avertissement : les compléments Outlook contextuels basés sur une entité sont désormais mis hors service. Toutefois, les règles d’expression régulière restent prises en charge. 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 instructions sur la façon d’implémenter ces règles, voir Compléments contextuels Outlook.
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.
Avertissement : les compléments Outlook contextuels basés sur une entité sont désormais mis hors service. Toutefois, les règles d’expression régulière restent prises en charge. 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 instructions sur la façon d’implémenter ces règles, voir Compléments contextuels Outlook.
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.
Avertissement : les compléments Outlook contextuels basés sur une entité sont désormais mis hors service. Toutefois, les règles d’expression régulière restent prises en charge. 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 instructions sur la façon d’implémenter ces règles, voir Compléments contextuels Outlook.
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.
Avertissement : les compléments Outlook contextuels basés sur une entité sont désormais mis hors service. Toutefois, les règles d’expression régulière restent prises en charge. 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 instructions sur la façon d’implémenter ces règles, voir Compléments contextuels Outlook.
phoneNumbers: PhoneNumber[];Valeur de propriété
urls
Tableau de chaînes contenant les URL Internet associées au contact. Pouvant accepter la valeur Null.
Avertissement : les compléments Outlook contextuels basés sur une entité sont désormais mis hors service. Toutefois, les règles d’expression régulière restent prises en charge. 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 instructions sur la façon d’implémenter ces règles, voir Compléments contextuels Outlook.
urls: string[];Valeur de propriété
string[]