Partager via

XML pour les activités

  • Article

Cette rubrique contient un exemple de scénario qui montre les appels de l’API d’extensibilité du fournisseur Outlook Social Connector (OSC) qu’un fournisseur OSC implémente et que le OSC effectue pour obtenir des informations sur les activités. Les informations sont exprimées dans des chaînes XML conformes au schéma XML du fournisseur OSC.

Le schéma XML du fournisseur OSC permet à un fournisseur OSC de définir des activités. Les informations d’activité peuvent inclure le réseau social d’où proviennent les éléments de flux d’activité, les détails de chaque élément de flux d’activité (tels que le propriétaire, le type et la date de publication de l’activité) et le modèle pour afficher l’activité. Pour prendre en charge l’affichage des activités dans le volet Personnes ou la carte de visite, le fournisseur OSC d’un réseau social doit implémenter et retourner le code XML des activités correct. Pour obtenir un exemple de code XML de flux d’activité, consultez Exemple xml de flux d’activité. Pour plus d’informations sur la synchronisation des activités des amis, consultez Synchronisation des amis et des activités. 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.

Dans le scénario suivant, l’OSC synchronise dynamiquement les activités d’une personne sélectionnée dans le volet Personnes et obtient des détails sur cette personne :

  1. Un fournisseur OSC qui prend en charge la synchronisation à la demande des activités l’indique à l’OSC en utilisant les éléments getActivities et dynamicActivitiesLookupEx . 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 les méthodes ISocialProvider ::GetCapabilities et ISocialSession2 ::GetActivitiesEx .

  3. L’OSC appelle ISocialProvider ::GetCapabilities pour case activée la valeur de getActivities et dynamicActivitiesLookupEx pour vérifier que le fournisseur OSC prend en charge la synchronisation à la demande des activités. L’OSC note également la valeur de l’élément hashFunction pris en charge par le fournisseur OSC.

  4. L’OSC actualise le volet Personnes ou la carte de visite pour permettre à l’utilisateur de voir les dernières activités de la personne sélectionnée. L’OSC chiffre l’adresse SMTP de la personne à l’aide de la fonction de hachage spécifiée dans l’élément hashFunction , formant une chaîne XML conforme à la définition de schéma XML pour l’élément hashedAddresses .

  5. L’OSC appelle ISocialSession2 ::GetActivitiesEx, en fournissant cette chaîne XML de l’adresse hachée en tant que paramètre hashedAddresses , afin d’obtenir une collection actuelle d’activités pour cette personne dans le paramètre activities . La chaîne de paramètre activities est conforme à la définition de schéma XML de l’élément activityFeed .

  6. En fonction de la définition de schéma XML pour activityFeed, l’OSC analyse davantage la chaîne d’activités pour connaître le type, la date de publication et d’autres informations sur chaque activité, et comment afficher l’activité.

  7. Pour obtenir des détails sur la personne sélectionnée, l’OSC appelle ISocialSession2 ::GetPeopleDetails, en fournissant la même chaîne XML d’adresses hachées que l’argument pour le paramètre personsAddresses . Les détails sur la personne sont retournés dans le paramètre personsCollection . Ces détails peuvent inclure firstName, lastName et emailAddress. Le paramètre personsCollection est conforme à la définition de schéma XML de l’élément person .

Vous trouverez plus d’informations sur la spécification de XML pour les activités dans les rubriques suivantes de cette section :

Voir aussi