Partager via

XML pour les amis

  • Article

L’élément friends dans le schéma XML du fournisseur Osc (Microsoft Outlook Social Connector) permet à un fournisseur OSC de spécifier des informations pour une liste de personnes associées à un utilisateur Outlook dans le réseau social. Si le fournisseur OSC prend en charge la synchronisation mise en cache, cette liste de personnes contient uniquement les amis de l’utilisateur Outlook sur le réseau social. Si l’OSC prend en charge la synchronisation à la demande ou hybride, cette liste peut contenir des amis et des non-amis de l’utilisateur Outlook.

Chaque personne de la liste est représentée en tant qu’élément de personne dans le schéma XML, qui prend en charge des détails tels que le prénom, le nom et les adresses e-mail. Les fournisseurs OSC utilisent les éléments amis et personne , quelle que soit la façon dont ils veulent que l’OSC synchronise les informations sur les amis à partir du réseau social. Notez que les éléments enfants de la personne sont similaires à certaines des propriétés d’un contact Outlook, ce qui facilite le stockage des amis dans un dossier de contacts Outlook spécifique au réseau social, si le réseau social prend en charge la synchronisation en cache ou hybride des amis dans un dossier de contacts Outlook.

Exemples de scénarios

Les exemples de scénarios suivants montrent les appels de l’API d’extensibilité du fournisseur OSC qu’un fournisseur OSC implémente et que le OSC effectue pour obtenir des informations d’ami. Les informations sont exprimées dans des chaînes XML conformes au schéma XML du fournisseur OSC.

Pour obtenir un exemple de code XML d’amis, consultez Exemple de xml d’amis. Pour plus d’informations sur la synchronisation des informations des amis, consultez Synchronisation des amis et des activités.

Scénario 1 : obtenir une liste d’amis

Scénario 1 : OSC obtient une liste d’amis, un objet ISocialPerson et une image pour chaque ami :

  1. Un fournisseur OSC qui prend en charge l’affichage d’amis à partir du site de réseau social et qui permet à l’OSC de mettre en cache les informations d’ami indique que pour l’OSC à l’aide des éléments getFriends et cacheFriends , qui sont des éléments enfants de l’élément capabilities .

  2. Le fournisseur OSC implémente également les méthodes ISocialProvider ::GetCapabilities, ISocialSession ::GetPerson, ISocialPerson ::GetFriendsAndColleagues et ISocialPerson ::GetPicture .

  3. L’OSC appelle ISocialProvider ::GetCapabilities pour case activée la valeur des éléments suivants : getFriends pour vérifier que le fournisseur OSC prend en charge l’affichage d’amis à partir du réseau social, et cacheFriends pour vérifier que le fournisseur prend en charge la mise en cache des amis.

  4. L’OSC appelle ISocialSession ::GetPerson pour obtenir un objet ISocialPerson pour l’utilisateur Outlook.

  5. L’OSC appelle ISocialPerson ::GetFriendsAndColleagues pour obtenir la liste d’amis de l’utilisateur Outlook renvoyée dans la chaîne du paramètre personCollection . La chaîne personCollection est conforme à la définition de schéma XML pour l’élément friends dans le schéma XML.

  6. Pour chaque ami dans la chaîne XML personCollection , l’OSC obtient la valeur de l’élément userID pour appeler ISocialSession ::GetPerson afin d’obtenir un objet ISocialPerson pour cet ami.

  7. Pour chaque ami dans la chaîne XML personCollection , l’OSC appelle ISocialPerson ::GetPicture pour obtenir une ressource image pour cet ami.

    La CVMO peut effectuer d’autres appels sur l’objet ISocialPerson pour obtenir des activités et des détails (par exemple, des adresses de courrier) pour cet ami.

Scénario 2 : synchroniser les amis

Scénario 2 : OSC synchronise les amis de manière dynamique :

  1. Un fournisseur OSC qui prend en charge la synchronisation à la demande des amis et des non-amis l’indique à l’OSC à l’aide des éléments getFriends et dynamicContactsLookup . Le fournisseur OSC définit également l’élément hashFunction . Les trois éléments sont des éléments enfants de fonctionnalités.

  2. Le fournisseur OSC implémente également la méthode ISocialSession2 ::GetPeopleDetails .

  3. L’OSC appelle ISocialProvider ::GetCapabilities pour case activée les valeurs de getFriends et dynamicContactsLookup pour vérifier que le fournisseur OSC prend en charge les amis et la synchronisation à la demande des amis et des non-amis. L’OSC prend également note de la valeur de hashFunction prise en charge par le fournisseur OSC.

  4. Pour chaque utilisateur affiché dans le volet Personnes, l’OSC collecte l’adresse e-mail de l’utilisateur et la chiffre à l’aide de la fonction de hachage spécifiée dans hashFunction. Cela forme une chaîne XML conforme à la définition de schéma XML pour l’élément hashedAddresses .

  5. L’OSC appelle ISocialSession2 ::GetPeopleDetails, en fournissant cette chaîne XML d’adresses hachées en tant que paramètre personAddresses , afin d’obtenir dynamiquement les détails mis à jour pour les personnes dans le paramètre personsCollection . La chaîne du paramètre personsCollection est conforme à la définition de schéma XML pour l’élément friends dans le schéma XML.

Éléments parents et enfants

Voici les deux éléments de niveau supérieur dans le schéma friends .

Élément Description
Amis
Représente l’élément racine d’une liste d’éléments person . ISocialPerson ::GetFriendsAndColleagues, ISocialSession ::FindPerson et ISocialSession2 ::GetPeopleDetails retournent des chaînes XML qui sont conformes à la définition de schéma de l’élément friends.
person
Représente une personne dans une liste d’éléments person . La méthode ISocialPerson ::GetDetails retourne une chaîne XML conforme à la définition de schéma de l’élément person .

Le tableau suivant décrit chaque élément enfant de l’élément person dans le schéma XML du fournisseur OSC.

Pour obtenir une définition complète du schéma XML du fournisseur OSC, y compris les éléments requis ou facultatifs, voir Outlook Social Connector Provider XML Schema.

Élément Description
adresse
Adresse postale physique de la personne.
Anniversaire
Date anniversaire d’un événement pour la personne.
askmeabout
Sujets d’intérêt ou d’expertise de la personne.
Anniversaire
Date de naissance de la personne.
businessAddress
Adresse postale physique de l’espace de travail de la personne.
businessCity
Ville pour le lieu de travail de la personne.
businessCountryOrRegion
Pays ou région du lieu de travail de la personne.
businessState
État ou province du lieu de travail de la personne.
businessZip
Code postal de l’espace de travail de la personne.
Cellule
Numéro de téléphone mobile de la personne.
Ville
Ville de l’adresse physique de la personne.
company
Nom de la société associée à la personne.
countryOrRegion
Pays ou région de l’adresse physique de la personne.
creationTime
Heure de création du profil de la personne sur le réseau social.
emailAddress
Adresse e-mail principale de la personne.
emailAddress2
Adresse e-mail secondaire de la personne.
emailAddress3
Adresse e-mail tertiaire de la personne.
expirationTime
Heure à laquelle les données de profil de la personne expirent sur le réseau social.
fileAs
Chaîne par laquelle la personne doit être classée en tant que contact dans un fichier de contacts Outlook.
firstName
Prénom ou prénom de la personne.
friendStatus
Ami status de cette personne avec l’utilisateur connecté sur le réseau social. Doit être l’une des valeurs suivantes : friend, nonfriend, pending, pendingin, pendingout.
Fullname
Nom complet de la personne.
Sexe
Sexe de la personne. Doit être l’une des valeurs suivantes : mâle, femelle, non spécifié.
HomePhone
Numéro de téléphone personnel de la personne.
index
Emplacement de l’adresse hachée de la personne dans le paramètre de chaîne personsAddresses passé à un appel à la méthode ISocialSession2 ::GetPeopleDetails . Il indique également le code XML de la personne dans la chaîne personsCollection retournée par GetPeopleDetails.
Industries
Les industries dans laquelle la personne est engagée.
interests
Intérêts ou passe-temps de la personne.
lastModificationTime
Heure à laquelle le profil de la personne a été modifié pour la dernière fois sur le réseau social.
lastName
Nom ou nom de famille de la personne.
location
Emplacement de la personne.
Pseudo
Nom plus court ou nom inventé de la personne.
otherAddress
Autre adresse postale de la personne.
otherCity
Ville de l’autre adresse de la personne.
otherCountryOrRegion
Pays ou région de l’autre adresse de la personne.
otherState
État ou province de l’adresse alternative de la personne.
otherZip
Code postal de l’adresse alternative de la personne.
Téléphone
Numéro de téléphone du contact principal de la personne.
pictureUrl
URL d’une photo de profil de la personne.
Relation
Relation de cette personne avec l’utilisateur connecté.
schools
Les écoles où la personne va ou où elle est allée.
skills
Compétences personnelles de la personne.
state
État ou province de l’adresse physique de la personne.
title
Désignation ajoutée au nom de la personne.
Userid
ID permettant d’identifier la personne sur le réseau social.
webProfilePage
Adresse de la page web qui contient un profil de la personne.
site internet
Site web de la personne.
workPhone
Numéro de téléphone professionnel de la personne.
Zip
Code postal ou code postal de l’adresse physique de la personne.

Voir aussi