SharePoint 中的社交和协作功能的面向开发人员的新增内容

项目
03/21/2023

了解我的网站的新的和已更改的社会和协作功能和 SharePoint 中的社区网站开发方案。 SharePoint 中的社交和协作功能使用户能够轻松地进行沟通并始终了解最新信息。个人网站和工作组网站中改进的好友动态订阅源可帮助用户了解他们所关心的人员和内容的最新动态。新社区网站功能提供丰富的社区体验，可让用户轻松查找和共享信息以及查找与其具有共同爱好的人员。

有关 SharePoint 中新的社交和协作功能的深入概述，请参阅 TechNet 上 SharePoint 中的社交计算新增功能。有关使用社会和协作功能编程的详细信息，请参阅 SharePoint 中的社交和协作功能。

SharePoint 中新增和变化的“我的网站”功能

我的网站社交 API 包括用户配置文件和社会数据，还包含许多新功能和已更改的功能。 "我的网站"和团队网站的新功能提供源内的交互式对话体验，使用户能够更轻松地与好友保持联系，并了解与其有关的内容。

SharePoint 上的“新闻源”页面进行了上述多项改进，包括方便用户快速发布微博帖子的文本框，以及包含用户关注人员和内容的帖子和最新动态的交互式对话源。

Social 命名空间包含用于源和微博帖子以及密切关注人员和内容的主 API。有关详细信息，请参阅 Microsoft.SharePoint.Client.Social （针对 .NET 客户端对象模型）、 SP.Social（针对 JavaScript 对象模型）和 Microsoft.Office.Server.Social （针对服务器对象模型）。

注意

Microsoft.Office.Server.ActivityFeed 命名空间中的 API 已弃用。请参阅已弃用和已删除的“我的网站”社交 API 和功能。

SharePoint 包括新客户端 API，您可以将这些 API 与好友动态订阅源结合使用，通过它们密切关注人员和内容，以及在联机、本地和移动开发中检索用户属性。如有可能，应在 SharePoint 开发中使用客户端 API，而不要使用服务器对象模型或 Web 服务。客户端 API 包括托管客户端对象模型、JavaScript 对象模型和代表性状态传输 (REST) 服务。如果您正在开发 SharePoint 外接程序，则必须使用客户端 API。

并不是客户端 API 中 Microsoft.Office.Server.UserProfiles 程序集中的所有服务器端功能均可供使用。例如，对 Microsoft.Office.Server.Audience 命名空间、Microsoft.Office.Server.ReputationModel 命名空间或 Microsoft.Office.Server.SocialData 命名空间中的 API 没有客户端访问权限。若要查看哪些 API 可供使用，请参阅 Microsoft.SharePoint.Client.Social 命名空间和 Microsoft.SharePoint.Client.UserProfiles 命名空间。

有关如何访问“我的网站”社交客户端 API 的信息，请参阅 SharePoint 中的社交功能入门。有关 SharePoint 中的 API 集以及何时使用它们的详细信息，请参阅在 SharePoint 中选择正确的 API 集。

使用 ProfileLoader.CreatePersonalSiteEnqueueBulk 方法为多个用户提供个人网站和 OneDrive for Business（仅 SharePoint Online 上的我的网站主机管理员）

我的网站主机管理员可以使用 ProfileLoader.CreatePersonalSiteEnqueueBulk 方法，以编程方式为 SharePoint Online 上的多个用户配置个人网站，其中包括 OneDrive for Business 等功能和网站页面。

以下代码示例在控制台应用程序中使用 .NET 客户端对象模型。在运行示例之前，添加对 Microsoft.SharePoint.Client.dll、Microsoft.SharePoint.Client.Runtime.dll 和 Microsoft.SharePoint.Client.UserProfiles.dll 的引用，并更改 userName、 passwordStr 和 serverUrl 变量的占位符值。 serverUrl 变量必须为 SharePoint Online 管理中心的 URL。

注意

若要获取所需的客户端 DLL，请下载 SharePoint Online 客户端组件 SDK。


using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Security;
using Microsoft.SharePoint.Client;
using Microsoft.SharePoint.Client.UserProfiles;

namespace CreatePersonalSiteBulkConsole
{
    class Program
    {
        static void Main(string[] args)
        {
            string userName = "administrator@contoso.onmicrosoft.com";
            string passwordStr = "password";
            string serverUrl = "https://contoso-admin.sharepoint.com/";

            using (var clientContext = new ClientContext(serverUrl))
            {
                SecureString password = new SecureString();
                Array.ForEach(passwordStr.ToCharArray(), c => password.AppendChar(c));

                var credentials = new SharePointOnlineCredentials(userName, password);

                clientContext.Credentials = credentials;

                var web = clientContext.Web;
                clientContext.Load(web);
                clientContext.ExecuteQuery();
                ProfileLoader loader = ProfileLoader.GetProfileLoader(clientContext);

                if (loader == null)
                {
                    throw new InvalidOperationException("Failed to get ProfileLoader");
                }

                string[] userEmails = { "usera@contoso.onmicrosoft.com", "userb@contoso.onmicrosoft.com" };
                loader.CreatePersonalSiteEnqueueBulk(userEmails);
                loader.Context.ExecuteQuery();
            }
        }
    }
}

要将 CreatePersonalSiteEnqueueBulk 方法与 Windows PowerShell 一起使用，请首先更改以下命令中的占位符值（SharePoint Online 管理中心的 URL 和用户名），然后在 SharePoint Management Shell 中运行命令。


$webUrl = "https://yoursharepointadmin.sharepoint.com"
$ctx = New-Object Microsoft.SharePoint.Client.ClientContext($webUrl)

$web = $ctx.Web
$username = "admin@myadmin.sharepoint.com"
$password = read-host -AsSecureString

$ctx.Credentials = New-Object Microsoft.SharePoint.Client.SharePointOnlineCredentials($username,$password)

$ctx.Load($web)
$ctx.ExecuteQuery()

[System.Reflection.Assembly]::LoadWithPartialName("Microsoft.SharePoint.Client.UserProfiles")

$loader =[Microsoft.SharePoint.Client.UserProfiles.ProfileLoader]::GetProfileLoader($ctx)

#To get profile
$profile = $loader.GetUserProfile()
$ctx.Load($profile)
$ctx.ExecuteQuery()
$profile 
#To enqueue profile
$loader.CreatePersonalSiteEnqueueBulk(@("user1@domain.com")) 
$loader.Context.ExecuteQuery()

有关详细信息，请参阅使用 Windows PowerShell 管理 SharePoint。

针对 SharePoint 中的用户和用户属性的新对象

SharePoint 包括表示用户和用户属性的新对象：

SocialActor 对象表示用户 (和其他实体，) 源和后续活动。
PersonProperties 对象包含常规用户属性和用户配置文件属性。

注意

服务器对象模型版本是 SPSocialActor 对象和 PersonProperties 对象。

SharePoint 还包括一个新的客户端 UserProfile 对象，该对象提供可用于为当前用户创建个人网站的方法。不过，它并不包含服务器端 UserProfile 对象中的所有用户属性。若要通过客户端代码访问所有用户属性，请使用 PeopleManager.GetMyProperties 或 PeopleManager.GetPropertiesFor 方法（用户配置文件属性存储在 PersonProperties.UserProfileProperties 属性中），也可以使用 PeopleManager.GetUserProfilePropertiesFor 或 PeopleManager.GetUserProfilePropertyFor 方法。

新客户端人员选取器控件

客户端人员选取器控件是一种 HTML 和 JavaScript 控件，可支持跨浏览器选取人员、组和声明。可以使用与服务器端版本的控件相同的设置来配置该选取器，这些设置包括控件特定属性（如允许多个用户或用户和组）以及 Web 应用程序级配置设置（如 Active Directory 域服务参数或锁定特定林）。有关详细信息，请参阅在 SharePoint 托管的 SharePoint 外接程序中使用客户端人员选取器控件。

SharePoint 已弃用以下“我的网站”社交 API 和功能：

Microsoft.Office.Server.ActivityFeed 命名空间中的 API 已弃用。 Social 命名空间提供在 SharePoint 中以编程方式用于好友动态订阅源的 API。对于向后兼容性，SharePoint 2010 中的 ActivityEvent 项作为不可答复的事件在 SharePoint 源中显示。（管理中心中必须启用遗留事件迁移）。
我的网站 RSS 源 (ActivityFeed.aspx) 替换为 REST 服务中的新 API、客户端对象模型和 JavaScript 对象模型。若要迁移使用此 API（最好为客户端 API）的自定义 SharePoint 2010 代码，请用对新 API 的调用替换对 ActivityFeed.aspx 的所有请求，并处理以 JavaScript 对象表示法 (JSON) 格式返回的源数据。
“近期活动”Web 部件被新的“新闻源”Web 部件所取代，后者支持多线程对话和动态源检索。

注意

不支持自定义“新闻源”Web 部件或其他源 Web 部件（如团队网站上的“网站源”Web 部件）。如果确实要自定义这些 Web 部件（例如，使用 JavaScript 重写），请注意，自定义可能会中断 SharePoint 更新。
“社交评论”Web 部件已被弃用。
以下活动事件不再自动通知源：配置文件更新、即将到来的生日、即将到来的工作场所周年日、新成员资格以及更改经理。但是，可以为这些活动创建自定义事件接收器。尚未添加任何新的社会事件。
隐私枚举中的以下字段已弃用：联系人、组织和经理。 SharePoint 仅提供“专用(只有我)”和“公用(所有人)”隐私设置。在用户更改前，将保留现有隐私设置。若要迁移使用此 API 的自定义 SharePoint 2010 代码，请替换所有对弃用隐私字段的引用。
通过 SocialFollowingManager 访问的关注人员 API 取代了 SharePoint Server 2010 中的同事功能。 “同事”页面被“我关注的人员”页面所取代。方便用户对同事进行分组的组功能不再可用。
SharePoint 中的组织配置文件已过时，弃用了以下类型： OrganizationProfile、 OrganizationProfileManager、 OrganizationMembershipType、 OrganizationNotFoundException、 OrganizationProfileChange、 OrganizationProfileChangeQuery、 OrganizationProfileMembershipChange 和 OrganizationProfileValueCollection。
"我的链接"功能在 SharePoint 中已被弃用。

SharePoint 中的新社区网站功能

新社区网站功能包括新网站模板和改进的讨论体验。声望、类别、特色讨论、问题发布类型和最佳答复使社区成员可轻松查找流行的讨论、相关信息和具有相似兴趣的人。成员在参与社区时建立声望。

社区网站功能不公布针对开发的特定。若要扩展社区网站功能，请使用 SharePoint 网站并直接列出 API。例如，可使用 SharePoint API 来自定义网站和列表模板、从社区为好友动态订阅源创建自定义活动、将声望信息集成到搜索结果中、自定义信誉模型或创建工作流来主持讨论。

下面的列表包含有关使用社区网站功能进行开发的信息：

社区网站使用 Community 网站模板 ( Id = 62)。该网站模板不适用于公共模板。讨论板列表的模板类型为 DiscussionBoard (value = 108) 。
激活社区网站功能会激活 CommunityEventReceiver 事件接收器。
若要自定义客户端呈现的列表视图，您必须使用 JavaScript 重写来替换该视图。无法通过 SharePoint API 扩展列表视图。有关详细信息，请参阅使用客户端呈现在 SharePoint 外接程序中自定义列表视图。
社区网站使用异步事件来恒心对象。如果异步事件在后台运行，则在尝试更新列表或列表项时，可能遇到保存冲突，并且对象句柄可能过期。

一种解决方法是处理"更新"调用返回的异常，在重新尝试调用前刷新示例，并循环多次重试，如下面的代码示例所示。

  
int retries = 1;
while (retries <= 10)
{
    try
    {
        spListItem.IconOverlay = urlString;
        spListItem.Update();
        break;
    }
    catch (SPException saveConflict)
    {
        spListItem = web.Lists.GetItemById(spListItem.ID);
        retries++;
        if (retries > 10) throw;
        System.Threading.Thread.Sleep(1000);
    }
}

通过

SharePoint 中新增和变化的“我的网站”功能

使用 ProfileLoader.CreatePersonalSiteEnqueueBulk 方法为多个用户提供个人网站和 OneDrive for Business（仅 SharePoint Online 上的我的网站主机管理员）

针对 SharePoint 中的用户和用户属性的新对象

新客户端人员选取器控件

SharePoint 中的新社区网站功能

另请参阅

其他资源

通过

SharePoint 中的社交和协作功能的面向开发人员的新增内容

SharePoint 中新增和变化的“我的网站”功能

新的 Social 命名空间提供了用于社交源以及关注人员和内容的 API

SharePoint 中用于社交源、关注人员和内容以及用户属性的新客户端 API

使用 ProfileLoader.CreatePersonalSiteEnqueueBulk 方法为多个用户提供个人网站和 OneDrive for Business（仅 SharePoint Online 上的 我的网站 主机管理员）

针对 SharePoint 中的用户和用户属性的新对象

新客户端人员选取器控件

已弃用和已删除的我的网站社交 API 和功能

SharePoint 中的新社区网站功能

另请参阅

其他资源

使用 ProfileLoader.CreatePersonalSiteEnqueueBulk 方法为多个用户提供个人网站和 OneDrive for Business（仅 SharePoint Online 上的我的网站主机管理员）