Suivre des personnes dans SharePoint

  • Article

Découvrez les tâches de programmation courantes pour les personnes suivantes dans SharePoint.

API pour les personnes suivantes dans SharePoint

Lorsqu’un utilisateur suit des personnes dans SharePoint, les publications de microblog que les personnes publient et les notifications relatives à leurs activités s’affichent dans le flux d’actualités de l’utilisateur. Les fonctionnalités relatives aux personnes suivantes peuvent être affichées dans les pages de flux d'actualités et les personnes que je suis.

SharePoint fournit les API suivantes que vous pouvez utiliser pour suivre des personnes par programmation :

  • Modèles objet client pour le code managé

    • Modèle objet client .NET

    • Modèle objet client Silverlight

    • Modèle objet client mobile

  • Modèle objet JavaScript

  • Service REST (Representational State Transfer)

  • Modèle objet serveur

Il est vivement recommandé d'utiliser des API client quand vous le pouvez pour le développement SharePoint. API clientes incluent les modèles objet client, un modèle d'objet JavaScript et un service REST. Pour plus d’informations sur les API dans SharePoint et quand les utiliser, voir Choisir l’ensemble d’API approprié dans SharePoint.

Chaque API comprend un objet gestionnaire que vous utilisez pour effectuer des tâches principales pour les personnes suivantes.

Remarque

[!REMARQUE] Les mêmes API sont utilisés pour suivre le contenu. Voir Suivre le contenu dans SharePoint pour obtenir une vue d’ensemble des tâches suivantes de contenu.

Le tableau 1 répertorie les objets gestionnaire et autres objets clés (ou ressources REST) inclus dans les API, ainsi que la bibliothèque de classes (ou point d'accès) où vous pouvez les trouver.

Remarque

[!REMARQUE] Silverlight et des modèles d'objet client mobile explicitement ne figurent pas dans le tableau 1 ou tableau 2 parce qu'ils fournissent les mêmes fonctionnalités de base en tant que modèle d'objet client .NET et utilisent les mêmes signatures. Le modèle d'objet client Silverlight est défini dans Microsoft.SharePoint.Client.UserProfiles.Silverlight.dll, et le modèle objet client mobile est défini dans Microsoft.SharePoint.Client.UserProfiles.Phone.dll.

Tableau 1. API SharePoint utilisées pour suivre des personnes par programmation

API Objets clés
Modèle objet client .NET
Voir : Guide pratique pour suivre des personnes à l’aide du modèle objet client .NET dans SharePoint		 Objet Manager : SocialFollowingManager
Espace de noms principal : Microsoft.SharePoint.Client.Social
Autres objets clés : SocialActor , SocialActorInfo , SocialActorType , SocialActorTypes
Bibliothèque de classes : Microsoft.SharePoint.Client.UserProfiles.dll
Modèle objet JavaScript
Voir : Guide pratique pour suivre des personnes à l’aide du modèle objet JavaScript dans SharePoint		 Objet Manager : SocialFollowingManager
Espace de noms principal : SP. Sociale
Autres objets clés : SocialActor, SocialActorInfo, SocialActorType, SocialActorTypes
Bibliothèque de classes : SP.UserProfiles.js
Service REST
Voir : Informations de référence sur l’API REST de personnes et de contenu suivantes pour SharePoint		 Ressource du responsable : social.following
URI du point de terminaison : <siteUri>/_api/social.following
Espace de noms principal (OData.md) : sp.social.SocialRestFollowingManager
Autres ressources clés : SocialActor, SocialActorInfo, SocialActorType, SocialActorTypes
Modèle objet serveur Objet Manager : SPSocialFollowingManager
Espace de noms principal : Microsoft.Office.Server.Social
Autres objets clés : SPSocialActor , SPSocialActorInfo , SPSocialActorType , SPSocialActorTypes
Bibliothèque de classes : Microsoft.Office.Server.UserProfiles.dll

Tâches de programmation courantes pour les personnes suivantes dans SharePoint

Le tableau 2 montre les tâches de programmation courantes pour les personnes suivantes ainsi que les membres que vous utilisez pour les exécuter. Les membres sont à partir du modèle d'objet client .NET (CSOM), le modèle d'objet JavaScript (JSOM), service REST et le modèle d'objet serveur (SSOM).

Remarque

[!REMARQUE] Les mêmes API sont utilisés pour suivre le contenu. Voir Suivre le contenu dans SharePoint pour obtenir une vue d’ensemble des tâches suivantes de contenu.

L'objet SocialFollowingManager consolide les fonctionnalités principales suivant contenu et les personnes suivantes pour l'utilisateur actuel. Toutefois, l'objet PeopleManager (voir tableau 3) fournit des fonctionnalités que SocialFollowingManager ne fournit pas, y compris les méthodes pour obtenir l'état des personnes suivantes d'autres utilisateurs.

Tableau 2. API pour les tâches courantes pour les personnes suivantes à l’aide de l’objet SocialFollowingManager

Tâche Members
Créer une instance d’un objet gestionnaire dans le contexte de l’utilisateur actuel CSOM : SocialFollowingManager
JSOM : SocialFollowingManager
RESTE: <siteUri>/_api/social.following
SSOM : SPSocialFollowingManager
Créer une instance d'un objet gestionnaire dans le contexte d'un utilisateur particulier CSOM : non implémenté
JSOM : non implémenté
REST : non implémenté
SSOM : SPSocialFollowingManager (surchargé)
Ont l'utilisateur actuel commencez à suivre (stop suit) une personne CSOM : Suivre ( StopFollowing )
JSOM : suivre ( stopFollowing)
REST : POST<siteUri>/_api/social.following/Follow (<siteUri>/_api/social.following/StopFollowing) et passez le paramètre d’acteur dans le corps de la demande
SSOM : Suivre ( StopFollowing )
Savoir si l'utilisateur actuel est suite à un utilisateur particulier CSOM : IsFollowed
JSOM : isFollowed
REST : POST<siteUri>/_api/social.following/my/IsFollowed et passez le paramètre d’acteur dans le corps de la demande
SSOM : IsFollowed
Obtenir les personnes qui vous suivent l'utilisateur actuel CSOM : GetFollowers
JSOM : getFollowers
REST : GET<siteUri>/_api/social.following/my/Followers
SSOM : GetFollowers
Obtenir les personnes qui suit l'utilisateur actuel CSOM : GetFollowed
JSOM : getFollowed
REST : GET<siteUri>/_api/social.following/my/Followed(types=1)
SSOM : GetFollowed
Obtenir le nombre de personnes qui suit l'utilisateur actuel CSOM : GetFollowedCount
JSOM : getFollowedCount
REST : GET<siteUri>/_api/social.following/my/FollowedCount(types=1)
SSOM : GetFollowedCount
Obtenir les personnes qui l'utilisateur actuel peut souhaiter à suivre CSOM : GetSuggestions
JSOM : getSuggestions
REST : GET<siteUri>/_api/social.following/my/Suggestions
SSOM : GetSuggestions

Le tableau 3 montre les membres PeopleManager que vous pouvez utiliser pour des fonctionnalités supplémentaires de personnes suivantes.

Tableau 3. API pour les tâches courantes pour les personnes suivantes à l’aide de l’objet PeopleManager

Tâche Members
Déterminer si la liste des personnes que je suis pour l'utilisateur actuel est publique CSOM : IsMyPeopleListPublic
JSOM : isMyPeopleListPublic
REST : IsMyPeopleListPublic
Exemple : GET<siteUri>/_api/SP.UserProfiles.PeopleManager/IsMyPeopleListPublic
SSOM : IsMyPeopleListPublic
Savoir si une personne suit l'utilisateur actuel CSOM : AmIFollowedBy
JSOM : amIFollowedBy
REST : AmIFollowedBy
Exemple : GET<siteUri>/_api/SP.UserProfiles.PeopleManager/AmIFollowedBy(accountName=@v)?@v='domain\\user'
SSOM : AmIFollowedBy
Obtenir les personnes qui suit un utilisateur particulier CSOM : GetPeopleFollowedBy
JSOM : getPeopleFollowedBy
REST : GetPeopleFollowedBy
Exemple : GET<siteUri>/_api/SP.UserProfiles.PeopleManager/GetPeopleFollowedBy(accountName=@v)?@v='domain\\user'
SSOM : GetPeopleFollowedBy
Obtenir les personnes qui vous suivent un utilisateur particulier CSOM : GetFollowersFor
JSOM : getFollowersFor
REST : GetFollowersFor
Exemple : GET<siteUri>/_api/SP.UserProfiles.PeopleManager/GetFollowersFor(accountName=@v)?@v='domain\\user'
SSOM : GetFollowersFor
Savoir si un utilisateur particulier suit un autre utilisateur CSOM : IsFollowing
JSOM : isFollowing
REST : IsFollowing (statique)
Exemple : GET<siteUri>/_api/SP_UserProfiles_PeopleManager_IsFollowing(possibleFollowerAccountName=@v,possibleFolloweeAccountName=@y)?@v='domain\\user'&amp;@y='domain\\user'
SSOM : IsFollowing

Fonctionnement des Suggestions de personnes sur SharePoint Online

Pour obtenir des Suggestions de personnes, les résultats sont basés sur établi activité personnes suivantes. Suggestions proposées lorsqu'un utilisateur suit une personne qui possède un mutual suivantes avec une autre personne qui a l'utilisateur n'est pas déjà suivant.

Informations relatives à la suivante sont indexées pendant les analyses de recherche. Après qu'une analyse est terminée, analyse de la recherche doit ensuite analyser l'analysée à la suite de suggestions des utilisateurs des informations et de sortie. Par défaut, la recherche s'exécute l'analyse une fois par jour.

Lorsqu'un utilisateur ouvre la page personnes que je suis, la méthode PeopleManager.GetMySuggestions() est appelée. GetMySuggestions recherche les suggestions de nouveau pour l'utilisateur actuel, met à jour les suggestions de l'utilisateur dans la base de données et présente les suggestions proposées dans la page.

Voir aussi