使用 SharePoint 中的社交功能开始进行开发

开始编程实现 SharePoint 社交源和微博帖子、关注人员和内容(文档、网站和标签),以及开始使用用户配置文件。

如何在应用和解决方案中使用社交功能?

设置开发环境

社交功能的开发方案

使用社交功能编程的方法

用于使用社交功能编程的 API

用于访问社交功能的应用程序权限请求

其他资源

我如何能够使用 SharePoint 应用程序和解决方案中的社交功能?

SharePoint 应用程序和解决方案中的社交功能可以帮助人员相互联系、沟通和协作以及查找、跟踪和共享重要的内容和信息。 你可以添加新的社交功能或扩展 SharePoint 中已有的功能。 例如,你可以创建一个应用程序使你能够查找和关注与你有共同兴趣的人,创建源数据的自定义可视化,或将自定义活动发布到源。

本文介绍的功能与人员、源和个人网站与工作组网站上的以下功能相关。 社区网站提供的丰富的论坛体验和信誉模型并不公开某个特定 API,因此你可以直接使用 SharePoint 网站并列出 API 来扩展该功能。 有关详细信息,请参阅新建社区网站功能

开始开发前,应确定代码的运行位置、运行代码的 SharePoint 环境以及代码功能。 确定这些因素有助于选择要创建的应用种类以及要使用的一个或多个 API。 有关可帮助你做出决定的信息,请参阅在 SharePoint 和 SharePoint 外接程序中与 SharePoint 解决方案中选择正确的 API 集

设置开发环境

若要开始使用社交功能进行开发,需要安装以下产品/服务:

  • SharePoint 或 SharePoint Online

  • Visual Studio 2012 或 Visual Studio 2013(带 Visual Studio 2013 的 Office 开发人员工具)或更高版本

有关更多指导,请参阅为 SharePoint 设置常规开发环境和在 SharePoint 中配置社交计算功能

SharePoint 中社交功能的开发方案

社交功能的高级开发方案包括使用好友动态订阅源、关注他人和内容(文档、网站及标记)和使用用户属性。 表 1 包含文章链接,这些文章介绍了用于访问每一种方案的功能的主要 API 和常见编程任务。

下列文章介绍用于特定开发方案的主要 API 和编程任务:

在 SharePoint 中使用社交功能编程的方法

在你设置好开发环境并选择了方案后,你可以开始使用社交功能进行编程。 表 1 包含文章链接,这些文章说明如何使用社交功能执行基本的编程任务。

表 1. 使用社交功能开发的操作方法文章

功能区域 说明
如何:了解通过使用 SharePoint 中的 .NET 客户端对象模型读取和写入好友动态订阅源 执行多个详细步骤,使用 .NET 客户端对象模型创建可以读取和写入好友动态订阅源的应用程序。
如何:了解通过使用 SharePoint 中的 REST 服务读取和写入好友动态订阅源 执行多个详细步骤,使用 REST 服务创建可以读取和写入好友动态订阅源的应用程序。
如何:使用 SharePoint 中的 .NET 客户端对象模型创建和删除帖子以及检索好友动态订阅源 了解如何使用 .NET 客户端对象模型创建和删除微博帖子以及检索好友动态订阅源。
如何:使用 SharePoint 中的 JavaScript 对象模型创建和删除帖子以及检索好友动态订阅源 了解如何使用 JavaScript 对象模型创建和删除微博帖子,并检索社交源。
如何:在 SharePoint 中向帖子添加提及内容、标签以及网站和文档的链接 了解如何向微博帖子添加 SocialDataItem 对象,这些对象在社交源中呈现为提及内容、标签和链接。
如何:在 SharePoint 中向帖子嵌入图像、视频和文档 了解如何向微博帖子添加 SocialAttachment 对象,这些对象在社交源中呈现为嵌入图片、视频和文档。
如何:使用 SharePoint 中的 .NET 客户端对象模型关注好友 了解如何通过 .NET 客户端对象模型使用关注好友功能。
如何:在 SharePoint 中使用 JavaScript 对象模型关注好友 了解如何通过 JavaScript 对象模型使用关注好友功能。
如何:使用 SharePoint 中的 .NET 客户端对象模型关注文档和网站 了解如何通过 .NET 客户端对象模型使用关注内容功能。
如何:在 SharePoint 中使用 REST 服务关注文档、网站和标签 了解如何通过 REST 服务使用关注内容功能。
如何:使用 SharePoint 中的 .NET 客户端对象模型检索用户配置文件属性 了解如何使用 .NET 客户端对象模型检索用户配置文件属性。
如何:在 SharePoint 中使用 JavaScript 对象模型检索用户配置文件属性 了解如何使用 JavaScript 对象模型检索用户配置文件属性。
如何:通过使用 SharePoint 中的服务器对象模型来处理用户配置文件和组织配置文件 学习如何使用服务器对象模型创建、检索和管理用户配置文件及其属性。

使用 SharePoint 社交功能进行编程的 API

虽然应用程序和解决方案以不同的方式访问 SharePoint,但在你访问 SharePoint 后,你将以基本相同的方式使用 API。 表 2 显示了对源、关注和SharePoint 中的用户配置文件功能进行编程的 API 以及服务器上源文件的路径。

表 2. 用于对社交功能编程的 API

API 名称 源和路径
.NET 客户端对象模型 Microsoft.SharePoint.Client.UserProfiles.dll
in %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\ISAPI
Silverlight 客户端对象模型 Microsoft.SharePoint.Client.UserProfiles.Silverlight.dll
in %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\LAYOUTS\ClientBin
移动设备客户端对象模型 Microsoft.SharePoint.Client.UserProfiles.Phone.dll
in %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\LAYOUTS\ClientBin
JavaScript 对象模型 SP.UserProfiles.js
in %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\LAYOUTS
代表性状态传输 (REST) 服务 http://<site url>/_api/social.feed
http://<site url>/_api/social.following
http://<site url>/_api/SP.UserProfiles.PeopleManager
服务器对象模型 Microsoft.Office.Server.UserProfiles.dll
in %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\ISAPI

注意

通过客户端 API,并不能使用 Microsoft.Office.Server.UserProfiles 程序集中的所有服务器端功能。 若要查看哪些 API 可供使用,请参阅 Microsoft.SharePoint.Client.Social 命名空间和 Microsoft.SharePoint.Client.UserProfiles 命名空间。

用于在 SharePoint 加载项中访问社交功能的应用权限请求

SharePoint 加载项必须向安装用户请求获取访问 SharePoint 资源所需的权限。 例如,发布到源的应用(至少)应请求获取对源执行写入操作的权限。 应用需要的权限是在 Visual Studio 中的 AppManifest.xml 文件内进行指定。

应用程序权限请求局限于 SharePoint 部署环境。 表 3 显示了用于访问社交功能的范围名称(和相应的范围 URI)以及可用权限。 有关详细信息,请参阅 SharePoint 中的外接程序权限、SharePoint中的外接程序授权策略类型和在 SharePoint 中规划应用程序权限管理

表 3. SharePoint 中社交功能的应用权限范围和可用权限

作用域名称 说明 可用权限
用户配置文件
http://sharepoint/social/tenant
用于访问所有用户配置文件的权限请求范围。 只能更改个人资料图片;对于 SharePoint 外接程序,所有其他用户配置文件属性都是只读的。必须由租户管理员安装。 读取、写入、管理、完全控制
核心
http://sharepoint/social/core
用于访问用户关注的内容和微博功能使用的共享元数据的权限请求范围。 此范围仅适用于支持关注内容的个人网站。 如果应用程序安装在任何其他类型的网站上,则使用租户范围。 读取、写入、管理、完全控制
新闻源
http://sharepoint/social/microfeed
用于访问用户源或团队源的权限请求范围。 此范围适用于支持微博的个人网站或适用于激活"网站源"功能的工作组网站。 如果应用程序安装在任何其他类型的网站上,则使用租户范围。 读取、写入、管理、完全控制
http://sharepoint/social/trimming 此权限请求范围用于确定是否在应用程序的社交源中显示经过安全修整的内容。 如果未授予这种高信任权限,有些内容(例如应用程序没有权限的文件和网站的相关活动)将从返回到应用程序的源数据中修整掉,即使用户有足够的权限也是如此。 必须手动将此权限添加到应用程序的清单文件中。 读取、写入、管理、完全控制

你在请求应用程序权限时,需要考虑的内容

在指定社交功能的应用程序权限时,你应了解以下注意事项:

  • 不允许为 Office 商店 应用程序指定 FullControl 权限。 仅允许为 Office 商店 应用程序指定 ReadWriteManage 权限。

  • 你可以使用核心、新闻源或租户 ( http://sharepoint/content/tenant) 范围来指定源和关注功能的权限。 租户范围表示在其中安装应用程序的整个租赁,它包括核心和新闻源范围。 因此,如果你的应用程序已指定它在租户范围内需要的权限,你就不需要请求核心或新闻源范围的权限。

  • 在开发期间,如果你得到一条"SocialListNotFound: 你的个人网站中没有好友动态列表"或"未找到文件"消息,请使用租户范围。 如果你希望在应用程序中使用核心或新闻源范围,可以通过从应用程序目录中打开应用程序来测试权限。

  • “核心”范围适用于支持关注内容的个人网站。 “新闻源”范围适用于支持微博的个人网站,或已激活网站源功能的团队网站。 如果将在其他任何类型网站上安装应用,必须使用“租户”范围。 请参阅 SharePoint 加载项的租赁和部署范围

  • 请求用户配置文件范围的权限的应用程序必须由租户管理员安装,不能在 SharePoint Online 的 Office 365 小型企业高级版中安装。

  • 如果不符合社交和微博功能的许可或功能启用要求,则用户会收到一条消息,指示无法安装该应用程序。

  • 在 SharePoint 外部启动的应用程序可以发出对权限( Full Control 除外)的临时请求。 有关详细信息,请参阅 SharePoint 加载项的授权代码 OAuth 流

另请参阅

概念文章

参考文档