最大化新式列表和库的使用

项目
04/08/2023

本文讨论如何使用 SharePoint 新式用户界面时获得最大数量的列表和库。。

尚无法转换所有列表和库至新式体验，因为：

SharePoint 团队尚未将一些类型的列表和库生成为在新式用户界面中显示；例如，任务列表或事件列表。请等待 SharePoint 团队实现新式版本，或切换为一个等效选项。选项包括使用 Microsoft Planner 而不是经典的任务列表，或是使用 Office 365 组日历，而不是经典的 SharePoint 事件列表日历。
部分类型的列表和库虽可以使用新式用户界面显示，但却因配置或自定义不兼容而受阻；你可以在此处采取措施。

重要

新式化工具和所有其他 PnP 组件均为开源工具，由一个活跃社区提供支持服务。来自 Microsoft 官方支持渠道的开放源代码工具支持不提供任何 SLA。

新式用户介面可用列表模板

以下是 SharePoint 当前在新式用户界面中可以呈现的最常用的列表模板类型（自 2018 年 10 月起）：

列表 (100)
文档库 (101)
链接列表 (103)
通知列表 (104)
联系人列表 (105)
图片库 (109)
表单库 (115)
网站页面库 (119)
自定义网格 (120)
提升的链接列表 (170)
发布页面库 (850)
资产库 (851)
问题跟踪列表 (1100)

在本节中，你将了解如何识别未显示为新式列表的列表、原因以及如何进行修正（如果可能）。然而，在进入讨论之前，重要的是要知道，对于大多数租户，我们看到大多数列表都能作为新式列表进行加载，而没有发出任何警告。无法作为新式列表进行加载的列表将保留为经典体验（如日历或任务列表），你也可以通过修正它们来解除阻止，这将在本系列文章中进行讨论。无法作为新式列表进行加载的列表将 100％可用，并且完全受支持，它们应该不会阻止你为租户启用新式列表和库体验。

重要

SharePoint 将自动默认为新式列表和库，但也会在需要时自动回退。这将确保所有可以使用新式体验的列表都将显示为新式列表，而这些列表在使用时不能简单地切换为经典体验。

在新式用户介面中检测到列表和库不可用

若要检测哪些列表和库在新式用户界面中不可用，建议方法是运行 SharePoint 新式扫描程序。此工具会深入分析租户中的所有列表和库，并通过生成报告来详细说明哪些列表和库未使用新式用户界面显示。更重要的是，报告还说明了具体原因。根据扫描程序输出，可以通过修正列表和库来取消阻止它们，在下一章节中会提到。

取消阻止列表和库

导致列表受阻的原因可能有一个或多个，扫描程序输出详细说明了所有可能原因。下面列出了常见原因及其修正方法。

自定义不兼容

自定义不兼容是新式用户界面无法呈现列表的最常见原因，通常是由于下列操作之一引起：

使用 JSLink
使用嵌入 JavaScript 的用户自定义操作

若要修复这些阻止原因，可以删除自定义（如果不再与业务相关的话），也可以创建备用解决方案。有关构建与新式列表和库体验兼容的自定义项的详细信息，请参阅文章新式化自定义项。由于 Web 部件级别的 JSLink 确实会阻止页面使用新式列表和库经验，因此你需要删除此配置。你可以通过使页面处于编辑模式来手动执行此操作，具体方法是将 ?ToolPaneView=2&pagemode=edit 附加到页面 URL，然后更新 Web 部件属性。若要以编程方式执行此操作，你可以通过 LimitedWebPartManager 类获取 Web 部件，然后更新相应的属性，如下面的代码段所示。你可以将此代码段与本页后面显示的更完整的代码结合使用，以获得完整的解决方案。

webPart.Properties["JSLink"] = "";
webPart.SaveWebPartChanges();
cc.ExecuteQuery();

存在某些字段类型

BCS 外部数据、地理位置、编辑模式下的结果选择、图像、HTML 和摘要链接等一些字段类型尚未生成为使用新式用户界面显示。若要修正这些字段类型，可以应用下列方法：

从视图中删除字段。字段仍处于编辑模式，因此获得的是经典编辑体验，但至少视图是新式的。
将字段数据迁移到与新式用户界面兼容的新字段。
完全删除未使用的字段。

在站点或 web 级别阻止的新式和库用户界面

可以为完整的网站集（站点级别）或一个或多个网站（web 级别）阻止新式列表和库用户界面。通过禁用各自的站点或 Web 范围内的功能，可以修复此操作，如下面 PnP PowerShell 代码片段所示：

$minimumVersion = New-Object System.Version("2.24.1803.0")
if (-not (Get-InstalledModule -Name SharePointPnPPowerShellOnline -MinimumVersion $minimumVersion -ErrorAction Ignore))
{
    Install-Module SharePointPnPPowerShellOnline -MinimumVersion $minimumVersion -Scope CurrentUser
}
Import-Module SharePointPnPPowerShellOnline -DisableNameChecking -MinimumVersion $minimumVersion

Connect-PnPOnline -Url "<your site url>"

# Disable the modern list site level blocking feature
Disable-PnPFeature -Identity "E3540C7D-6BEA-403C-A224-1A12EAFEE4C4" -Scope Site
# Disable the modern list web level blocking feature
Disable-PnPFeature -Identity "52E14B6F-B1BB-4969-B89B-C4FAA56745EF" -Scope Web

注意

PnP PowerShell 是一种开放源代码解决方案，其中包含为其提供支持的活动社区。没有用于 Microsoft 开放源代码工具支持的 SLA。

在列表级别阻止的新式和库用户界面

可以定义列表以始终在列表级别运行经典体验（ListExperienceOptions 设置为 ClassicExperience）。若要撤销此操作，可以使用以下代码段：

// Load the list you want to update
var list = context.Web.Lists.GetByTitle(title);
context.Load(list);
context.ExecuteQuery();

// Possible options are Auto (= defaults to modern), NewExperience (= "modern") and ClassicExperience
list.ListExperienceOptions = ListExperience.Auto;

// Persist the changes
list.Update();
context.ExecuteQuery();

显示 BaseTemplate = 0 的列表

每个列表都有一个基本模板，但有时你可能会在扫描程序输出中看到基本模板值为 0 的列表。这是因为对于这些列表，没有标记为默认的视图，或者有时根本没有视图。对于这些列表，解决方法是导航到列表设置页面 (_layouts/15/listedit.aspx?List=%7B<list id>%7D) 并为列表提供视图。

自定义包含除列表 XSLTListViewWebPart 以外内容的列表视图页面

由于用户可以编辑经典列表视图和编辑页面，因此能够在列表视图页面上添加其他 Web 部件（举个例子）。如果你完成此操作，则新式用户界面中不再显示列表。若要修正此问题，可以采用的唯一方法是，从列表页面中删除已添加的 Web 部件。你可以通过转到列表并将 ?ToolPaneView=2&pagemode=edit 附加到列表 URL 来手动检查这些情况。这将使页面处于编辑模式，并且应该会显示其他 Web 部件并允许你删除它们。如果你想以编程方式执行相同的操作，则下面的代码段是一个很好的起始基础。此代码段基于 PnP 网站核心库，你可以通过 SharePointPnPCoreOnline nuget 包将它安装到 Visual Studio 项目。

using Microsoft.SharePoint.Client;
using Microsoft.SharePoint.Client.WebParts;
using OfficeDevPnP.Core;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Security;

namespace MultipleWebPartFixer
{
    class Program
    {
        static void Main(string[] args)
        {
            string siteUrl = "https://contoso.sharepoint.com/sites/demo";
            string userName = "joe@contoso.onmicrosoft.com";
            AuthenticationManager am = new AuthenticationManager();
            using (var cc = am.GetSharePointOnlineAuthenticatedContextTenant(siteUrl, userName, GetSecureString("Password")))
            {
                // Grab the list
                var list = cc.Web.Lists.GetByTitle("listtofix");
                list.EnsureProperties(l => l.RootFolder, l => l.Id);

                bool isNoScriptSite = cc.Web.IsNoScriptSite();

                if (isNoScriptSite)
                {
                    throw new Exception("You don't have the needed permissions to apply this fix!");
                }

                // get the current (allitems) form
                var files = list.RootFolder.FindFiles("allitems.aspx");
                var allItemsForm = files.FirstOrDefault();
                if (allItemsForm != null)
                {
                    // Load web part manager and web parts
                    var limitedWPManager = allItemsForm.GetLimitedWebPartManager(PersonalizationScope.Shared);
                    cc.Load(limitedWPManager);

                    // Load the web parts on the page
                    IEnumerable<WebPartDefinition> webParts = cc.LoadQuery(limitedWPManager.WebParts.IncludeWithDefaultProperties(wp => wp.Id, wp => wp.ZoneId, wp => wp.WebPart.ExportMode, wp => wp.WebPart.Title, wp => wp.WebPart.ZoneIndex, wp => wp.WebPart.IsClosed, wp => wp.WebPart.Hidden, wp => wp.WebPart.Properties));
                    cc.ExecuteQueryRetry();

                    List<WebPartDefinition> webPartsToDelete = new List<WebPartDefinition>();
                    if (webParts.Count() > 1)
                    {
                        // List all except the XsltListView web part(s)
                        foreach (var webPart in webParts)
                        {
                            if (GetTypeFromProperties(webPart.WebPart.Properties) != "XsltListView")
                            {
                                webPartsToDelete.Add(webPart);
                            }
                        }

                        if (webPartsToDelete.Count == webParts.Count() - 1)
                        {
                            foreach(var webPart in webPartsToDelete)
                            {
                                webPart.DeleteWebPart();
                            }
                            cc.ExecuteQueryRetry();
                            Console.WriteLine("List fixed!");
                        }
                        else
                        {
                            // Special case...investigation needed. Go to list and append ?ToolPaneView=2&pagemode=edit to the list url to check the page
                            Console.WriteLine("Go to list and append ?ToolPaneView=2&pagemode=edit to the list url to check this page");
                        }
                    }
                }
            }

            Console.WriteLine("Press enter to continue...");
            Console.ReadLine();
        }

        public static string GetTypeFromProperties(PropertyValues properties)
        {
            // Check for XSLTListView web part
            string[] xsltWebPart = new string[] { "ListUrl", "ListId", "Xsl", "JSLink", "ShowTimelineIfAvailable" };
            if (CheckWebPartProperties(xsltWebPart, properties))
            {
                return "XsltListView";
            }

            return "";
        }
        private static bool CheckWebPartProperties(string[] propertiesToCheck, PropertyValues properties)
        {
            bool isWebPart = true;
            foreach (var wpProp in propertiesToCheck)
            {
                if (!properties.FieldValues.ContainsKey(wpProp))
                {
                    isWebPart = false;
                    break;
                }
            }

            return isWebPart;
        }

        private static SecureString GetSecureString(string label)
        {
            SecureString sStrPwd = new SecureString();
            try
            {
                Console.Write(String.Format("{0}: ", label));

                for (ConsoleKeyInfo keyInfo = Console.ReadKey(true); keyInfo.Key != ConsoleKey.Enter; keyInfo = Console.ReadKey(true))
                {
                    if (keyInfo.Key == ConsoleKey.Backspace)
                    {
                        if (sStrPwd.Length > 0)
                        {
                            sStrPwd.RemoveAt(sStrPwd.Length - 1);
                            Console.SetCursorPosition(Console.CursorLeft - 1, Console.CursorTop);
                            Console.Write(" ");
                            Console.SetCursorPosition(Console.CursorLeft - 1, Console.CursorTop);
                        }
                    }
                    else if (keyInfo.Key != ConsoleKey.Enter)
                    {
                        Console.Write("*");
                        sStrPwd.AppendChar(keyInfo.KeyChar);
                    }

                }
                Console.WriteLine("");
            }
            catch (Exception e)
            {
                sStrPwd = null;
                Console.WriteLine(e.Message);
            }

            return sStrPwd;
        }
    }
}

通过