Mise en route du développement de fonctionnalités sociales dans SharePoint

  • Article

Commencez à programmer avec les flux sociaux SharePoint et les publications de microblog, suivez les personnes et le contenu (documents, sites et étiquettes) et utilisez des profils utilisateur.

Comment puis-je utiliser des fonctionnalités sociales dans les applications et les solutions?

La configuration de l'environnement de développement

les scénarios de développement pour les fonctionnalités sociales

procédures pour la programmation avec les fonctionnalités sociales

API pour la programmation avec les fonctionnalités sociales

aux demandes d'autorisation pour l'accès aux fonctionnalités sociales

Ressources supplémentaires

Comment puis-je utiliser les fonctionnalités sociales dans les applications et solutions SharePoint ?

Les fonctionnalités sociales des applications et solutions SharePoint peuvent aider les utilisateurs à se connecter, à communiquer et à collaborer entre eux, et à rechercher, suivre et partager du contenu et des informations importants. Vous pouvez ajouter de nouvelles fonctionnalités de mise en réseau ou étendre les fonctionnalités déjà disponibles dans SharePoint. Par exemple, vous pouvez créer une application qui vous permet de rechercher et suivre les personnes qui ont un intérêt commun, créez une personnalisé de visualisation des données de flux ou publier des activités personnalisées au flux.

Les fonctionnalités décrites dans cet article s'alignent sur les personnes, les flux et les fonctionnalités suivantes que vous trouvez sur des sites d'équipe et des sites personnels. Le modèle de réputation et une expérience de forum sur les Sites de communauté n'exposent pas une API spécifique, afin que vous utilisiez un site SharePoint et les API de liste directement à étendre cette fonctionnalité. Pour plus d’informations, consultez Nouvelle fonctionnalité de site communautaire.

Avant de commencer le développement, vous devez savoir où votre code s'exécute, quel environnement SharePoint qu'il s'exécutera sur et quelles sont les fonctionnalités qu'il fournit. Ces facteurs vous aideront à choisir le type d'application à créer et les API ou d'API à utiliser. Voir Choisir l’ensemble d’API approprié dans les compléments SharePoint et SharePoint par rapport aux solutions SharePoint pour plus d’informations qui peuvent vous aider à décider.

Configuration de votre environnement de développement

Pour commencer à développer avec les fonctionnalités sociales, vous aurez besoin :

  • SharePoint ou SharePoint Online

  • Visual Studio 2012 ou Visual Studio 2013, avec les Outils de développement Office pour Visual Studio 2013 ou version ultérieure

Pour plus d’informations, voir Configurer un environnement de développement général pour SharePoint et Configurer les fonctionnalités de social computing dans SharePoint.

Scénarios de développement pour les fonctionnalités sociales dans SharePoint

Scénarios de développement de haut niveau pour les fonctionnalités sociales incluent utilisation des flux sociaux, les personnes suivantes et du contenu (documents, sites et balises) et l'utilisation de propriétés de l'utilisateur. Le tableau 1 contient des liens vers des articles qui décrivent les API principales qui vous permet d'accéder aux fonctionnalités pour chaque scénario et les tâches de programmation courantes.

Les articles suivants décrivent les API principal et les tâches de programmation pour le scénario de développement particulier :

Guide pratique pour la programmation avec les fonctionnalités de réseaux sociaux dans SharePoint

Après avoir configuré votre environnement de développement et choisissez votre scénario, vous pouvez commencer la programmation avec les fonctionnalités sociales. Le tableau 1 contient des liens vers des articles qui indiquent comment effectuer des tâches de programmation avec les fonctionnalités sociales.

Tableau 1. Articles de procédures pour le développement avec des fonctionnalités sociales

Fonctionnalité Description
Guide pratique pour apprendre à lire et écrire dans le flux social à l’aide du modèle objet client .NET dans SharePoint Passez en revue la procédure détaillée pour la création d'une application qui lit et écrit dans le flux de mise en réseau à l'aide du modèle d'objet client .NET.
Comment : en savoir plus lire et écrire dans le flux social en utilisant le service reste dans SharePoint Passez en revue la procédure détaillée pour la création d'une application qui lit et écrit dans le flux de mise en réseau à l'aide du service REST.
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 Découvrez comment créer et supprimer et des billets de microblog et récupérer des flux sociaux à l'aide du modèle d'objet client .NET.
Comment : créer et supprimer des publications et récupérer le flux social en utilisant le modèle d'objet JavaScript dans SharePoint Découvrez comment créer et supprimer et des billets de microblog et récupérer des flux sociaux à l'aide du modèle d'objet JavaScript.
Comment inclure des mentions, des balises et des liens vers des sites et des documents dans des publications dans SharePoint Découvrez comment ajouter des objets de SocialDataItem dans des billets de microblog, qui sont rendus en tant que liens dans les flux sociaux, les balises et les mentions.
Comment incorporer des images, des vidéos et des documents dans les publications dans SharePoint Découvrez comment ajouter des objets de SocialAttachment dans des billets de microblog, qui sont rendus en tant que documents dans les flux sociaux, des vidéos et des images incorporées.
Guide pratique pour suivre des personnes à l’aide du modèle objet client .NET dans SharePoint Apprenez à utiliser les fonctionnalités de personnes suivantes à l'aide du modèle d'objet client .NET.
Guide pratique pour suivre des personnes à l’aide du modèle objet JavaScript dans SharePoint Apprenez à utiliser les fonctionnalités de personnes suivantes en utilisant le modèle d'objet JavaScript.
Procédure : suivre des documents et des sites à l’aide du modèle d’objet client .NET dans SharePoint Apprenez à utiliser les fonctionnalités suivantes contenu à l'aide du modèle d'objet client .NET.
Procédure : suivre les documents, des sites et des balises à l'aide du service REST en SharePoint Apprenez à utiliser les fonctionnalités suivantes contenu en utilisant le service REST.
Procédure : Récupérer les propriétés de profil utilisateur à l'aide du modèle objet client .NET dans SharePoint Découvrez comment récupérer les propriétés de profil utilisateur à l'aide du modèle d'objet client .NET.
Procédure : Récupérer les propriétés de profil utilisateur à l'aide du modèle objet JavaScript dans SharePoint Découvrez comment récupérer les propriétés de profil utilisateur à l'aide du modèle d'objet JavaScript.
Comment travailler avec les profils utilisateur et les profils d'organisation en utilisant le modèle objet serveur dans SharePoint Découvrez comment créer, récupérer et gérer des propriétés et profils utilisateur à l'aide du modèle objet serveur.

API pour la programmation avec les fonctionnalités sociales SharePoint

Bien que les applications et solutions d'accès SharePoint différemment, une fois que vous effectuez l'accès SharePoint vous utilisez les API de mise en réseau de la même façon. Le tableau 2 présente les API pour la programmation avec les fonctionnalités de flux, de suivi et de profils utilisateur dans SharePoint, ainsi que les chemins d’accès aux fichiers sources sur le serveur.

Tableau 2. API pour la programmation avec les fonctionnalités sociales

Nom de l’API Source et le chemin d'accès
Modèle objet client .NET Microsoft.SharePoint.Client.UserProfiles.dll
dans %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\ISAPI
Modèle objet client Silverlight Microsoft.SharePoint.Client.UserProfiles.Silverlight.dll
dans %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\LAYOUTS\ClientBin
Modèle objet client mobile Microsoft.SharePoint.Client.UserProfiles.Phone.dll
dans %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\LAYOUTS\ClientBin
Modèle objet JavaScript SP.UserProfiles.js
dans %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\LAYOUTS
Service REST (Representational State Transfer) http://<site url>/_api/social.feed
http://<site url>/_api/social.following
http://<site url>/_api/SP.UserProfiles.PeopleManager
Modèle objet serveur Microsoft.Office.Server.UserProfiles.dll
dans %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\ISAPI

Remarque

Certaines fonctionnalités côté serveur dans l'assembly Microsoft.Office.Server.UserProfiles sont disponible à partir de l'API clientes. Pour les API disponibles, consultez l'espace de noms Microsoft.SharePoint.Client.Social et l'espace de noms Microsoft.SharePoint.Client.UserProfiles .

Demandes d'autorisation pour l'accès aux fonctionnalités sociales dans Compléments SharePoint

Un Complément SharePoint doit demander les autorisations qui lui sont nécessaires pour accéder aux ressources SharePoint à partir de l'utilisateur qui l'installe. Par exemple, une application qui publie dans le flux doit demander l'autorisation de Write (au minimum) au flux. Vous spécifiez les autorisations dont votre application a besoin dans le fichier AppManifest.xml dans Visual Studio.

Demandes d'autorisation sont limitées à l'environnement de déploiement de SharePoint. Le tableau 3 montre les noms d'étendue (avec une étendue correspondante URI) et les droits disponibles pour l'accès aux fonctionnalités sociales. Pour plus d’informations, voir Autorisations de complément dans SharePoint, Types de stratégie d’autorisation de complément dans SharePoint et Planifier la gestion des autorisations d’application dans SharePoint.

Tableau 3. Étendues d’autorisation d’application et droits disponibles pour les fonctionnalités sociales dans SharePoint

Nom de l’étendue Description Droits disponibles
Profils utilisateur
http://sharepoint/social/tenant		 Étendue de la demande d’autorisation utilisée pour accéder à tous les profils utilisateur. Seule l’image de profil peut être modifiée; toutes les autres propriétés de profil utilisateur sont en lecture seule pour les compléments SharePoint. Doit être installé par un administrateur de locataire. Lecture, Écriture, Gestion, Contrôle total
Noyau
http://sharepoint/social/core		 L'étendue de demande d'autorisation utilisé pour accéder à l'utilisateur suivi de contenu et partagées de métadonnées qui sont utilisée par les fonctionnalités de création de Microblogs. Cette étendue s'applique uniquement aux sites personnels qui prennent en charge la suite de contenu. Si l'application s'installe sur n'importe quel autre type de site, utilisez l'étendue de client. Lecture, Écriture, Gestion, Contrôle total
Les flux d’actualités
http://sharepoint/social/microfeed		 L'étendue de demande d'autorisation permettant d'accéder aux flux de l'utilisateur ou le flux de l'équipe. Cette étendue s'applique à des sites personnels qui prennent en charge les Microblogs ou à des sites d'équipe dans lequel la fonctionnalité de Flux de Site est activée. Si l'application s'installe sur n'importe quel autre type de site, utilisez l'étendue de client. Lecture, Écriture, Gestion, Contrôle total
http://sharepoint/social/trimming Cette étendue de demande d'autorisation permet de déterminer s'il faut afficher le contenu limités de sécurité dans le flux sociaux aux applications. Si cette autorisation de niveau de confiance élevé n'est pas accordée, certains contenus (tels que les activités sur les documents et les sites de l'application n'est pas autorisé à) est tronqué à partir des données de flux qui sont renvoyées à l'application, même si l'utilisateur dispose d'autorisations suffisantes. Cette autorisation doit être ajoutée manuellement au fichier de manifeste de l'application. Lecture, Écriture, Gestion, Contrôle total

Vous devez prendre en compte lors de la demande d'autorisations de l'application

Vous devez connaître les considérations suivantes lorsque vous spécifiez les autorisations de l'application pour les fonctionnalités de mise en réseau :

  • Les applications qui spécifient les droits FullControl ne sont pas autorisées pour les applications Office Store. Uniquement les droits Read, Writeet Manage sont autorisées pour les applications Office Store.

  • Vous pouvez spécifier des autorisations pour les flux et les fonctionnalités suivantes en utilisant le principal flux d'actualités et étendues du client ( http://sharepoint/content/tenant). L'étendue de client représente la totalité location où une application est installée, y compris les étendues principaux et de News. Afin que si votre application spécifie déjà les droits qui lui sont nécessaires au niveau du client, vous n'avez pas besoin de demander des autorisations dans l'étendue principale ou de News.

  • Lors du développement, utilisez l'étendue de client si vous obtenez un « SocialListNotFound : la liste Social n'existe pas dans votre site personnel » ou un message « Fichier introuvable ». Si vous souhaitez utiliser l'étendue de base ou de News dans votre application, vous pouvez tester les autorisations en ouvrant l'application à partir du catalogue d'applications.

  • L'étendue de base s'applique aux sites personnels qui prennent en charge la suite de contenu. L'étendue de News s'applique à des sites personnels qui prennent en charge les Microblogs ou à des sites d'équipe dans lequel la fonctionnalité de Flux de Site est activée. Si l'application sera installée sur un autre type de site, vous devez utiliser l'étendue de client. Voir Locations et étendues de déploiement des compléments pour SharePoint.

  • Applications qui demandent des droits de l'étendue de profils utilisateur doivent être installées par un administrateur de clients, et ils ne peuvent pas être installés dans la version d'Office 365 petite entreprise Premium de SharePoint Online.

  • Si la licence ou la fonctionnalité requise d'activation pour les fonctionnalités sociales et les blogs de billets courts n'est pas remplies, les utilisateurs obtiennent un message indiquant qu'ils ne peuvent pas installer l'application.

  • Les applications qui sont lancées en dehors de SharePoint peuvent demander une autorisation à la volée (à l’exception du contrôle total). Pour plus d’informations, reportez-vous à la rubrique Flux OAuth avec code d’autorisation pour les compléments SharePoint.

Voir aussi

Articles conceptuelles

Documentation de référence