Éléments XML des fonctionnalités

Les tableaux de cette rubrique décrivent les éléments enfants des fonctionnalités XML et sont regroupés par zones qu’ils prennent en charge. La valeur par défaut de chaque élément capabilities est false. Si l’élément n’est pas spécifié dans le code XML des fonctionnalités retourné par la méthode ISocialProvider ::GetCapabilities , la valeur de l’élément est égale à false.

Pour obtenir une description générale du xml des fonctionnalités , consultez XML pour les fonctionnalités. Pour obtenir un exemple de xml de fonctionnalités , consultez Exemple XML de fonctionnalités. Pour obtenir une définition complète du schéma XML du fournisseur Osc (Microsoft Outlook Social Connector), y compris les éléments obligatoires ou facultatifs, voir Outlook Social Connector Provider XML Schema.

Fonctionnalités de prise en charge des amis

Le tableau suivant présente les éléments qui s’appliquent à n’importe quelle forme de synchronisation d’amis ou de non-amis.

Élément	Description
doNotFollowPerson	Indique si le fournisseur prend en charge l’appel de méthode ISocialSession ::UnFollowPerson . followPerson et doNotFollowPerson sont des fonctionnalités indépendantes d’un fournisseur OSC. Un fournisseur OSC peut indiquer la possibilité d’ajouter une personne en tant qu’ami (définir followPerson sur true) ou de supprimer une personne en tant qu’ami sur un compte de réseau social ( affectez à doNotFollowPerson la valeur true). En général, être en mesure de suivre n’implique pas de pouvoir arrêter de suivre. followPerson est une fonctionnalité qui ne doit pas être mal interprétée comme une action pour suivre une personne spécifique ou chaque personne sur le compte de réseau social. followPerson étant true n’implique pas que doNotFollowPerson a la valeur false.
followPerson	Indique si le fournisseur prend en charge l’appel de méthode ISocialSession ::FollowPerson . L’OSC vérifie sicacheFriends a la valeur true (synchronisation en cache des amis), dynamicContactsLookup a la valeur true (synchronisation à la demande des amis et des non-amis), ou si cacheFriends et dynamicContactsLookup ont la valeur true (synchronisation hybride des amis et des non-amis). Si le fournisseur définit followPerson sur true, l’OSC affiche un badge réseau dans le volet Personnes pour les personnes que l’utilisateur suit et active la commande on <NetworkName> dans le menu Ajouter (+) dans le volet Personnes. Si le fournisseur définit followPerson sur false, le badge réseau n’est pas affiché et la commande on <NetworkName> est masquée.
getFriends	Indique si le fournisseur prend en charge l’appel de méthode ISocialPerson ::GetFriendsAndColleagues ou ISocialSession2 ::GetPeopleDetails . Si le fournisseur définit getFriends sur true, l’OSC utilise la valeur cacheFriends ou dynamicContactsLookup pour déterminer si le réseau social autorise le stockage des amis en tant qu’éléments de contact Outlook ou en mémoire. Si le fournisseur définit getFriends sur false, le réseau social ne prend pas en charge les amis et les méthodes ISocialPerson ::GetFriendsAndColleagues et ISocialSession2 ::GetPeopleDetails , et l’OSC ignore les valeurs de cacheFriends et dynamicContactsLookup.

Les éléments suivants s’appliquent uniquement à la synchronisation en cache des amis ou à la synchronisation hybride des amis et des non-amis. Pour plus d’informations sur la synchronisation des amis, consultez Synchronisation des amis et des activités.

Élément	Description
cacheFriends	Indique si le fournisseur OSC autorise le stockage d’amis en tant qu’éléments de contact Outlook. L’OSC vérifie cacheFriends uniquement si getFriends a la valeur true. Si le fournisseur définit cacheFriends sur true, l’OSC synchronise les amis en mettant en cache et crée un dossier de contacts spécifique au réseau dans le magasin par défaut de l’utilisateur pour les contacts amis. Le nom du dossier de contacts spécifique au réseau est la valeur de la propriété ISocialProvider ::SocialNetworkName . Si le fournisseur définit cacheFriends sur false, l’OSC ne crée pas de dossier de contacts spécifique au réseau pour que les contacts amis stockent des amis.
contactSyncRestartInterval	Détermine l’intervalle de nouvelles tentatives, en minutes, entre les tentatives de synchronisation des informations des amis à partir du réseau social, si une erreur de synchronisation se produit. L’OSC utilise cet élément uniquement si le fournisseur OSC prend en charge la synchronisation mise en cache ou la synchronisation hybride des amis dans un dossier de contacts spécifique au réseau social (cacheFriends a la valeur true). L’intervalle de nouvelle tentative par défaut est de 30 minutes, sauf si la valeur par défaut est remplacée par la ContactSyncRestartInterval clé sous HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\SocialConnector. Si le fournisseur définit contactSyncRestartInterval, la valeur du fournisseur remplace l’intervalle de nouvelle tentative par défaut de 30 minutes ou la valeur de la clé de Registre. Pour plus d’informations sur la synchronisation des informations sur les amis et les non-amis à la demande, consultez Synchronisation des amis et des activités.

Les éléments suivants s’appliquent uniquement à la synchronisation à la demande ou à la synchronisation hybride d’amis et de non-amis.

Élément	Description
dynamicContactsLookup	Indique si le fournisseur OSC prend en charge l’appel ISocialSession2 ::GetPeopleDetails pour la synchronisation à la demande des amis et des non-amis. L’OSC vérifie dynamicContactsLookup uniquement si getFriends a lavaleur true. Le paramètre par défaut pour dynamicContactsLookup est false. Si le fournisseur OSC spécifie dynamicContactsLookup sur true et getFriends sur true, l’OSC appelle ISocialSession2 ::GetPeopleDetails chaque fois que le volet Personnes est actualisé. Le volet Personnes est actualisé lorsque l’utilisateur sélectionne un autre utilisateur dans le volet Personnes ou un autre élément dans la fenêtre de l’Explorateur Outlook, ou ouvre une fenêtre d’inspecteur Outlook. La recherche dynamique des contacts garantit que l’utilisateur voit toujours les dernières images utilisateur et informations de profil dans le volet Personnes, mais augmente le nombre d’appels du fournisseur au réseau social. Si le fournisseur définit dynamicContactsLookup sur false, l’OSC n’appelle pas ISocialSession2 ::GetPeopleDetails pour actualiser le volet Personnes.
showOnDemandContactsWhenMinimized	Indique si l’OSC doit effectuer la synchronisation à la demande pour les amis et les non-amis lorsque le volet Personnes est réduit.

Fonctionnalités de prise en charge des activités

L’élément suivant s’applique à toute forme de synchronisation des activités prises en charge par le fournisseur OSC.

Élément

Description

getActivities

Indique si le fournisseur prend en charge les appels de méthode ISocialSession2 ::GetActivitiesEx ou ISocialPerson ::GetActivities . Si le fournisseur définit getActivities sur true, l’OSC utilise la valeur cacheActivities ou dynamicActivitiesLookupEx pour déterminer si le site de réseau social autorise le stockage des activités en tant qu’éléments RSS Outlook ou en tant qu’activités en mémoire. Si le fournisseur définit getActivities sur false, le réseau social ne prend pas en charge les activités et les méthodes ISocialSession2 ::GetActivitiesEx et ISocialPerson ::GetActivities , et l’OSC ignore les valeurs de cacheActivities et dynamicActivitiesLookupEx.

L’élément suivant s’applique uniquement à la synchronisation mise en cache ou à la synchronisation hybride des activités.

Élément

Description

cacheActivities

À compter d’Outlook Social Connector 2013, l’OSC ignore cet élément, car les fournisseurs ne peuvent plus synchroniser les activités en les mettant en cache dans un dossier masqué dans le magasin de l’utilisateur. Si le fournisseur prend en charge les activités, il doit prendre en charge la synchronisation des activités à la demande. Le fournisseur définit cacheActivities sur false et définit dynamicActivitesLookupEx sur true. L’OSC synchronise les activités à la demande et met en cache les activités en mémoire. Le cache de mémoire des activités est actualisé sur un intervalle de 30 minutes.

Les éléments suivants s’appliquent uniquement à la synchronisation à la demande ou à la synchronisation hybride des activités.

Élément	Description
dynamicActivitiesLookup	Déconseillé dans OSC 1.1. À compter de OSC 1.1, l’OSC n’appelle plus ISocialSession ::GetActivities et ignore la valeur de dynamicActivitiesLookup. Pour prendre en charge la recherche d’activités à la demande, définissez cacheActivities sur false et getActivities et dynamicActivitiesLookupEx sur true, et l’OSC appelle ISocialSession2 ::GetActivitiesEx.
dynamicActivitiesLookupEx	Indique si le fournisseur OSC prend en charge l’appel ISocialSession2 ::GetActivitiesEx pour la synchronisation à la demande des activités. Si le fournisseur OSC prend en charge la synchronisation des activités à la demande, il définit getActivities et dynamicActivitiesLookupEx sur true, et cacheActivities sur false. L’OSC appelle ISocialSession2 ::GetActivitiesEx chaque fois que le volet Personnes est actualisé. Le volet Personnes est actualisé lorsque l’utilisateur modifie l’élément sélectionné dans la fenêtre de l’Explorateur Outlook ou ouvre une fenêtre d’inspecteur Outlook. La recherche dynamique des activités garantit que l’utilisateur verra toujours les dernières activités dans le volet Personnes, mais augmentera le nombre d’appels du fournisseur vers le réseau social. Si le fournisseur définit dynamicActivitiesLookupEx sur false, l’OSC n’appelle pas ISocialSession2 ::GetActivitiesEx pour les personnes affichées dans le volet Personnes.
showOnDemandActivitiesWhenMinimized	Indique si l’OSC doit effectuer une synchronisation à la demande pour les activités lorsque le volet Personnes est réduit.

Fonctionnalités courantes pour la prise en charge de la synchronisation à la demande ou hybride d’amis, de non-amis et d’activités

Élément

Description

hashFunction

Spécifie la fonction de hachage prise en charge par le fournisseur OSC. Pour protéger les informations d’identification personnelle des utilisateurs qui ne se trouvent pas sur le réseau social ou l’application métier du fournisseur, l’OSC transmet les adresses e-mail hachées à ISocialSession2 ::GetPeopleDetails et ISocialSession2 ::GetActivitiesEx. Si dynamicContactsLookup est défini sur true ou que dynamicActivitiesLookupEx a la valeur true, le fournisseur doit définir hashFunction sur l’une des valeurs autorisées : SHA1, MD5 ou CRC32MD5. Si hashFunction est manquant ou spécifie une valeur incorrecte, l’OSC retourne une erreur. SHA1 est l’algorithme de hachage sécurisé 1 de l’Internet Engineering Task Force (IETF) des États-Unis défini par [RFC3174] . Par exemple, la valeur hachée SHA1 de l’adresse melissa@contoso.com e-mail est bb81577b567262a21a4df5f6e335c1250acd7b50. MD5 est un algorithme de Message-Digest MD5 défini par [RFC1321]. Par exemple, la valeur de hachage MD5 de l’adresse melissa@contoso.com e-mail est c8c39e61ca1662477b39b83d7b0a0615. CRC32MD5 est une combinaison de CRC32 et MD5 définies comme suit : Normalisez l’adresse e-mail en supprimant les espaces blancs de début et de fin et en convertissant tous les caractères en minuscules. Calculez la valeur CRC32 pour l’adresse e-mail normalisée et utilisez la représentation entière décimale de cette valeur. Si votre implémentation retourne des entiers signés, vous devez convertir l’entier signé en entier non signé. Calculez la valeur MD5 pour l’adresse e-mail normalisée et utilisez la représentation hexadécimale de cette valeur (en minuscules pour A à F). Combinez ces deux valeurs avec un trait de soulignement. Par exemple, la valeur hachée CRC32MD5 de l’adresse melissa@contoso.com e-mail est 2149665315_c8c39e61ca1662477b39b83d7b0a0615.

Fonctionnalités de prise en charge de l’authentification et de la configuration de compte

Élément	Description
allowChangesToAutoConfigure	Indique si le réseau social permet à l’utilisateur de modifier les paramètres de configuration automatique, par exemple en fournissant une URL différente pour se connecter.
createAccountUrl	Si le fournisseur définit hideHyperlinks sur false, lorsque l’utilisateur clique sur Cliquez ici pour créer un compte dans la boîte de dialogue Configuration du compte , l’URL spécifiée par createAccountUrl s’ouvre dans le navigateur par défaut.
displayUrl	Indique si l’OSC doit afficher la zone de texte Adresse URL du réseau social dans la boîte de dialogue de configuration du compte.
forgotPasswordUrl	Si le fournisseur définit hideHyperlinks sur false, lorsque l’utilisateur clique sur Vous avez oublié votre mot de passe ? dans la boîte de dialogue Configuration du compte , l’URL spécifiée par forgotPasswordUrl s’ouvre dans le navigateur par défaut.
hideHyperlinks	Indique si l’OSC doit masquer les liens hypertexte Cliquez ici pour créer un compte et Vous avez oublié votre mot de passe ? dans la boîte de dialogue de configuration du compte. OSC 1.0 ignore ce paramètre et les liens hypertexte sont toujours masqués. OSC 1.1 observe la valeur de ce paramètre.
hideRememberMyPassword	Indique si l’OSC doit masquer la zone Mémoriser mon mot de passe case activée dans la boîte de dialogue de configuration du compte. Si le fournisseur définit hideRememberMyPassword sur true, l’OSC agit comme si la case Mémoriser mon mot de passe n’était pas cochée et n’enregistrera pas le mot de passe. Si le fournisseur définit hideRememberMyPassword sur false, l’OSC affiche la zone Mémoriser mon mot de passe case activée dans la boîte de dialogue de configuration du compte.
supportsAutoConfigure	Indique si l’OSC doit appeler la fonction GetAutoConfiguredSession sur l’interface ISocialProvider pour tenter la configuration automatique et se connecter au réseau social pour l’utilisateur.
useLogonCached	Indique si le fournisseur OSC prend en charge l’appel ISocialSession2 ::LogonCached pour se connecter avec des informations d’identification mises en cache. Si le fournisseur définit useLogonCached sur true, l’OSC ignore le paramètre de useLogonWebAuth et l’OSC appelle ISocialSession2 ::LogonCached pour l’authentification. Si le fournisseur définit dynamicActivitiesLookupEx sur false, l’OSC n’appelle pas ISocialSession2 ::LogonCached pour l’authentification.
useLogonWebAuth	Indique si l’OSC doit utiliser l’authentification basée sur les formulaires et la méthode ISocialSession ::LogonWeb . Si le fournisseur définit useLogonWebAuth sur false, l’OSC utilise l’authentification de base et appelle la méthode ISocialSession ::Logon . Si le fournisseur définit useLogonWebAuth sur true, l’OSC utilise l’authentification basée sur les formulaires et appelle ISocialSession ::LogonWeb.

En fonction des fonctionnalités XML retournées par le fournisseur dans la méthode ISocialProvider ::GetCapabilities , la boîte de dialogue de configuration du compte change. Par exemple, la figure 1 montre la boîte de dialogue de configuration de compte pour un exemple TestProvider.

Figure 1. Exemple TestProvider dans la boîte de dialogue de configuration de compte

Voir aussi

• XML pour les fonctionnalités