Utiliser des flux sociaux dans SharePoint

Découvrez les tâches de programmation courantes pour utiliser des flux sociaux et des billets de microblog dans SharePoint.

API pour utiliser des flux sociaux dans SharePoint

Dans les batteries de serveurs SharePoint locales, les flux sociaux interactifs sont conçus pour inviter les utilisateurs à partager des informations et rester en contact avec d’autres personnes et du contenu. De nombreuses fonctionnalités de flux sont affichées sur la page Flux d’actualités du site personnel de l’utilisateur. Les flux contiennent des collections de fils de discussion qui représentent des billets de microblog, des conversations, des mises à jour de statut et d’autres notifications.

SharePoint fournit les API suivantes, que vous pouvez utiliser pour manipuler les flux sociaux via un programme :

• 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 clientes quand vous le pouvez pour le développement SharePoint. Les API clientes comprennent les modèles objet client, le modèle objet JavaScript et le 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 inclut un objet gestionnaire que vous utilisez pour effectuer les tâches principales liées au flux. 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 URI de point de terminaison) où vous pouvez les trouver.

Tableau 1. API SharePoint utilisées pour utiliser des flux sociaux par programmation

Si vous utilisez le modèle objet serveur pour accéder au contenu du flux et que votre code n’est pas en cours d’exécution dans une instance SharePoint (en d’autres termes, si votre extension n’est pas installée dans le dossier LAYOUTS sur le serveur d’applications), utilisez un objet SPServiceContextScope dans votre code. L'exemple suivant illustre une des méthodes d'incorporation de l'objet SPServiceContextScope dans votre code.

using (SPSite site = new SPSite(<siteURL>))
{
    using (new Microsoft.SharePoint.SPServiceContextScope(SPServiceContext.GetContext(site)))
    {
        // code
    }
}

Tâches de programmation courantes pour l’utilisation des flux sociaux dans SharePoint

Le tableau 2 répertorie les tâches de programmation courantes pour l'utilisation des flux sociaux, ainsi que les membres que vous utilisez pour cela. Les membres proviennent du modèle objet client .NET (CSOM), du modèle objet JavaScript (JSOM), du service REST et du modèle objet serveur (SSOM).

Tableau 2. API pour les tâches de programmation courantes pour l’utilisation des flux sociaux dans SharePoint

SharePoint ne fournit pas d’API pour personnaliser directement la disposition ou le rendu des billets de microblog. SharePoint fournit uniquement les données et permet aux applications clientes inter-appareils et multiplateforme de définir des dispositions adaptées à leurs facteurs de forme et à leurs besoins. Dans le développement SharePoint, vous pouvez utiliser des remplacements JavaScript dans le rendu côté client, comme décrit dans Personnaliser un affichage de liste dans les compléments SharePoint à l’aide du rendu côté client.

Présentation des types de flux dans l’API Mon Site social

Les types de flux représentent des coupes de données de flux. Lorsque vous récupérez un flux de l'utilisateur actuel, vous pouvez spécifier un des types de flux suivants :

• Personal contient les mises à jour et les billets générés par un utilisateur. Sur Site Mon site, ce flux est visible sur la page À propos de moi d'un utilisateur.

• News contient les mises à jour et les billets générés par l'utilisateur actuel, ainsi que par les personnes et le contenu qu'il suit. Lorsque vous récupérez le type de flux News, utilisez l'option de tri ByModifiedTime pour obtenir les activités les plus récentes (mises en cache) des personnes suivies par l'utilisateur. Sur Site Mon site, ce flux est visible sur la page Échange de News d'un utilisateur.

• Timeline contient les mises à jour et les billets générés par l'utilisateur actuel, ainsi que par les personnes et le contenu qu'il suit. Timeline est particulièrement utile lorsque vous souhaitez obtenir le flux de données d'un intervalle de temps spécifique ou effectuer un tri avec l'option ByCreatedTime (qui inclut le plus grand échantillon de personnes).

• Likes contient des fils de discussion de référence avec une propriété PostReference qui représente un billet de l'utilisateur actuel a marqué avec l'attribut J'aime.

• Everyone contient les fils de discussion provenant de l'ensemble de l'organisation de l'utilisateur actuel.

Les modèles objet Serveur, Client et JavaScript fournissent la méthode GetFeed que vous pouvez utiliser pour récupérer chaque type de flux de l'utilisateur actuel et la méthode GetFeedFor que vous pouvez utiliser pour extraire le type de flux Personal (uniquement) d'un utilisateur spécifié. Les deux méthodes utilisent un objet SocialFeedOptions en tant que paramètre, qui vous permet de spécifier l'ordre du tri en fonction du temps, de la plage de dates et du nombre maximal de fils de discussion à renvoyer.

Si un fil de discussion contient plus de deux réponses, le serveur renvoie un résumé du fil de discussion qui contient uniquement les deux réponses les plus récentes. (L’attribut de thread IsDigest est appliqué aux synthèses de thread.) Si vous souhaitez obtenir toutes les réponses d’un thread, appelez la méthode GetFullThread à partir de l’objet gestionnaire de flux et transmettez l’identificateur de thread.

Voir aussi

• Articles conceptuels et pratiques

• Fonctions sociales et de collaboration dans SharePoint

• Mise en route du développement avec les fonctions sociales dans SharePoint

• Comment : créer et supprimer des messages et de récupérer le flux de mise en réseau à l'aide du modèle objet de client .NET en SharePoint

• Comment : créer et supprimer des publications et récupérer le flux social en utilisant le modèle d'objet JavaScript dans SharePoint

• Comment lire et écrire dans le flux social en utilisant le service REST dans SharePoint

• Comment inclure des mentions, des balises et des liens vers des sites et des documents dans des publications dans SharePoint

• Comment incorporer des images, des vidéos et des documents dans les publications dans SharePoint

• Threads de référence et threads de synthèse dans les flux sociaux SharePoint

• Documentation de référence de l’API

• Microsoft.SharePoint.Client.Social (modèle objet client)

• Espace de noms SP.Social (modèle objet JavaScript)

• Référence de l'API REST des flux sociaux pour SharePoint

• Microsoft.Office.Server.Social (modèle objet Serveur)