Personnes et contacts dans EWS dans Exchange

Découvrez les personnages, le magasin de contacts unifié et comment utiliser des contacts à l’aide de l’API managée EWS ou EWS dans Exchange.

Les contacts sont des éléments dans Exchange qui stockent des informations sur un individu, un groupe ou une organisation. Les contacts peuvent inclure des noms et des adresses e-mail, ainsi que d’autres informations, notamment des adresses de messagerie instantanée, des adresses physiques, des anniversaires, des informations sur la famille et une photo ou une image qui représente le contact.

Les informations de contact sont stockées dans l’un des deux emplacements suivants :

• services de domaine Active Directory (AD DS), si le contact se trouve au sein de l’organisation.

• Le dossier Contacts ou un autre dossier dans la boîte aux lettres d’un utilisateur, si le contact se trouve en dehors de l’organisation.

Plusieurs éléments de contact peuvent représenter une seule personne. Exchange utilise des personnages pour rassembler ces différents éléments de contact. Un personnage est une agrégation d’informations de contact pour le même individu provenant de différentes sources. En plus des informations de contact dans Exchange, les personnages peuvent également être agrégés à partir des informations du cache de destinataires pour la boîte aux lettres, d’un dossier masqué pour les contacts de messagerie instantanée appelé QuickContacts et de sources de données tierces. Le magasin de contacts unifié dans Exchange permet aux clients de messagerie instantanée d’utiliser cette agrégation . la seule différence est que le magasin de contacts unifié n’agrège pas les informations d’AD DS, comme illustré dans la figure 1.

Figure 1. Sources d’informations de contact pour les personnages et pour le magasin de contacts unifié

Tableau 1. Méthodes d’API managée EWS et opérations EWS pour travailler avec des contacts

Si vous voulez...	Utiliser cette méthode d’API managée EWS	Utiliser cette opération EWS
Créer un contact	Instanciez un nouvel objet Contact et utilisez Contact.Save	CreateItem
Copier un contact	Contact.Copy	CopyItem
Déplacer un contact	Contact.Move	MoveItem
Mettre à jour un contact existant	Contact.Bind et Contact.Update	UpdateItem
Supprimer un contact	Contact.Bind et Contact.Delete	DeleteItem
Rechercher un contact	ExchangeService.FindItems	FindItem
Rechercher des contacts	S/O	FindPeople
Développer un groupe de distribution	ExchangeService.ExpandGroup	ExpandDL
Résoudre un nom ambigu	ExchangeService.ResolveName	ResolveNames
Obtenir un personnage	S/O	GetPersona
Utiliser des photos de contact	Contact.SetContactPicture, Contact.GetContactPictureAttachment ou Contact.RemoveContactPicture	GetUserPhoto ou GetAttachment

Personas

Jusqu’à récemment, les contacts étaient généralement stockés dans un emplacement unique, généralement sur un client de messagerie. Aujourd’hui, il est de plus en plus courant de stocker des contacts dans de nombreux emplacements différents, par exemple sur un téléphone, sur un site de réseau social, dans un dossier Contacts dans une boîte aux lettres Exchange ou dans le service d’annuaire d’une organisation. Avec la prolifération des informations de contact, il est possible que plusieurs contacts qui représentent la même personne contiennent des informations différentes; Par exemple, un contact peut inclure un numéro de téléphone professionnel et un autre un numéro de téléphone personnel, ou un contact stocké dans un dossier Contacts peut avoir un nom différent de celui de la même personne stockée sur votre téléphone.

Dans Exchange Online, Exchange Online dans le cadre de Office 365 et les versions locales d’Exchange à partir d’Exchange 2013, les contacts de différentes sources qui représentent la même personne sont associés les uns aux autres, de la même façon que les messages électroniques sont agrégés en conversations, au moyen d’un ID de lien commun. Lorsque des informations de contact agrégées sont retournées par un serveur Exchange, elles incluent un ensemble d’attributs pour chaque contact, tels qu’un dossier source, un nom d’affichage, un ID et un ID source. La somme des propriétés et des attributs retournés est appelée persona, et l’ensemble des propriétés retournées est appelé forme du personnage.

Étant donné que les informations qui composent un personnage ne sont pas stockées dans un emplacement unique et que ces informations peuvent changer à tout moment, un personnage est créé uniquement lorsque vous effectuez une demande à un serveur Exchange. Vous utilisez l’opération FindPeople EWS pour effectuer une demande de recherche de personnage. Votre demande peut inclure un ordre de tri et peut être filtrée en fonction d’une chaîne de requête pour vous aider à trouver le personnage correct en triant et en filtrant les résultats. Par exemple, vous pouvez récupérer le nom d’affichage et un ensemble de toutes les adresses e-mail associées à un contact spécifique à partir du dossier Contacts, d’un compte Hotmail, d’un compte LinkedIn et du service d’annuaire d’une entreprise, ou vous pouvez récupérer un ensemble de tous les personnages qui ont des adresses de messagerie instantanée. La liaison de contacts à des personnages est automatiquement basée sur un algorithme qui reconnaît une relation entre les contacts stockés sur différents appareils.

Remarque

L’API managée EWS n’implémente pas cette fonctionnalité.

Tableau 2. Opérations EWS pour travailler avec des personnages

Nom de l’opération	Description
FindPeople	Retourne tous les personnages disponibles à partir d’un dossier de contacts spécifié ou récupère les contacts qui correspondent à une chaîne de requête spécifiée.
GetPersona	Retourne un ensemble de propriétés associées à un personnage spécifique, telles que toutes les adresses de messagerie instantanée ou les noms d’affichage d’un ID de personnage spécifié.

Vous pouvez utiliser les opérations GetPersona et FindPeople pour récupérer efficacement les informations de contact à partir de plusieurs sources. Étant donné que tous les éléments liés à un personnage sont associés à un ID de lien, vous pouvez utiliser ces opérations dans un large éventail d’applications qui utilisent des données de contact. Voici quelques exemples :

• Application de téléphone mobile qui utilise l’opération GetPersona lorsqu’un utilisateur appelle un contact, puis propose des numéros de téléphone supplémentaires à appeler si personne ne répond.

• Application qui utilise l’opération FindPeople pour analyser les messages de boîte de réception à la recherche d’adresses e-mail afin de déterminer si elles se trouvent dans un personnage existant. Les adresses qui ne sont pas déjà associées à un personnage peuvent être utilisées pour créer des prospects ou lister toutes les communications récentes avec la personne représentée par ce personnage.

• Application de messagerie pour Outlook qui offre différentes salutations selon que la correspondance est formelle ou informelle. Les salutations formelles sont fournies par les noms d’affichage du service d’annuaire et les salutations informelles proviennent du nom d’affichage qui provient des contacts de réseau social.

Magasin de contacts unifié

Les personnages ne sont pas limités à un client de messagerie. Si vous développez un client de messagerie instantanée, vous pouvez vous demander tout ou partie des éléments suivants :

• Comment puis-je provisionner des applications clientes Lync avec un ensemble par défaut d’éléments de contact de messagerie instantanée ?

• Comment faire gérer les listes de contacts et de groupes de messagerie instantanée ?

• Comment faire gérer l’accès client Lync personnalisé aux contacts de messagerie instantanée et aux groupes de messagerie instantanée ?

Le magasin de contacts unifié fonctionne en arrière-plan dans Exchange pour agréger les données de contact d’Exchange et d’autres sources en une seule entité, ou persona. Bien que les opérations EWS que vous utilisez pour accéder au magasin de contacts unifié soient spécifiques aux contacts de messagerie instantanée, vous pouvez utiliser le magasin de contacts unifié dans Exchange pour travailler avec des personnages dans tous les types d’applications. N’oubliez pas que le magasin de contacts unifié ne peut pas accéder aux données de contact AD DS.

Les contacts de messagerie instantanée sont stockés dans un dossier masqué appelé QuickContacts. Vous pouvez utiliser les opérations AddNewImContactToGroup et AddImContactToGroup pour ajouter des contacts aux groupes stockés dans ce dossier masqué. Et comme vous pouvez utiliser le magasin de contacts unifié pour regrouper des contacts de messagerie instantanée, vous pouvez accéder à des groupes de contacts et les mettre à jour plus facilement.

Remarque

L’API managée EWS n’implémente pas cette fonctionnalité.

Tableau 3. Opérations EWS pour accéder au magasin de contacts unifié

Nom de l’opération	Description
AddNewImContactToGroup	Ajoute un nouveau contact de messagerie instantanée à un groupe de messagerie instantanée, jusqu’à un maximum de 1 000 contacts.
AddImContactToGroup	Ajoute un contact de messagerie instantanée existant à un groupe de messagerie instantanée, jusqu’à un maximum de 1 000 contacts.
AddImGroup	Ajoute un nouveau groupe de messagerie instantanée, jusqu’à un maximum de 64 groupes.
AddDistributionGroupToImList	Ajoute un nouveau groupe de distribution à un groupe de messagerie instantanée, jusqu’à un maximum de 64 groupes.
GetImItemList	Récupère une liste de groupes de messagerie instantanée et de personnes de contact de messagerie instantanée.
GetImItems	Récupère des informations sur des groupes de messagerie instantanée et des personnes de contact de messagerie instantanée spécifiques.
RemoveContactFromImList	Supprime un contact d’un groupe de messagerie instantanée.
RemoveImContactFromGroup	Supprime un contact de messagerie instantanée d’un groupe de messagerie instantanée.
RemoveDistributionGroupFromImList	Supprime un groupe de distribution d’un groupe de messagerie instantanée.
RemoveImGroup	Supprime un groupe de messagerie instantanée.
SetImGroup	Modifie le nom complet d’un groupe de messagerie instantanée.

Dans cette section

• Traiter des contacts par lots à l’aide d’EWS dans Exchange

• Résoudre les noms ambigus à l’aide d’EWS dans Exchange 2013

• Obtenir des photos d’utilisateur à l’aide d’EWS dans Exchange

Voir aussi

• Développer des clients de service web pour Exchange

• Commencer à utiliser les services web dans Exchange

• Vue d'ensemble de la conception client EWS pour Exchange