Excluirse de la experiencia de listas y bibliotecas modernas
En 2016, incluimos una nueva experiencia "moderna" para SharePoint, que ofrece extensibilidad, accesibilidad y un diseño receptivo para una revisión completa de la experiencia de usuario. Desde entonces, lo moderno es la base para la innovación en SharePoint y OneDrive, aunque el modo clásico sigue compatible y disponible. La mayoría de las listas y bibliotecas funciona perfectamente, pero también hay listas que no funcionan según lo esperado o pierden funcionalidad cuando se usa en la experiencia moderna. A menudo, esto se debe a las personalizaciones en la lista (por ejemplo, JSLink) o en la página de formulario de lista (por ejemplo, si se usaron varios elementos web). SharePoint detectará las personalizaciones más compatibles y mostrará las listas y bibliotecas afectadas con la experiencia clásica, mientras que las otras listas y bibliotecas del sitio se mostrarán con la experiencia moderna. Si no es aceptable cambiar entre las experiencias modernas y clásicas, tendrá la opción de excluir listas y bibliotecas de la experiencia moderna. En este artículo obtendrá información sobre las opciones de exclusión disponibles, cómo detectar listas y bibliotecas que podrían beneficiarse de la exclusión de la experiencia moderna y, por último, cómo controlar este proceso de la mejor manera.
Opciones para excluir listas y bibliotecas de la experiencia moderna
Exclusión a nivel de colección de sitios
Puede excluir una colección de sitios de la experiencia "moderna" habilitando una característica con el identificador E3540C7D-6BEA-403C-A224-1A12EAFEE4C4. Use el siguiente PowerShell PnP para habilitar o deshabilitar la característica necesaria:
# Connect to a site
$cred = Get-Credential
Connect-PnPOnline -Url https://[tenant].sharepoint.com/sites/siteurl -Credentials $cred
# Opt out from modern lists and libraries at site collection level
Enable-PnPFeature -Identity E3540C7D-6BEA-403C-A224-1A12EAFEE4C4 -Scope Site
# And again enable modern lists and libraries at site collection level
#Disable-PnPFeature -Identity E3540C7D-6BEA-403C-A224-1A12EAFEE4C4 -Scope Site
Exclusión a nivel de web
Puede excluir un sitio web de la experiencia "moderna" habilitando una característica con el identificador 52E14B6F-B1BB-4969-B89B-C4FAA56745EF. Use el siguiente PowerShell PnP para habilitar o deshabilitar la característica necesaria:
# Connect to a site
$cred = Get-Credential
Connect-PnPOnline -Url https://[tenant].sharepoint.com/sites/siteurl -Credentials $cred
# Opt out from modern lists and libraries at web level
Enable-PnPFeature -Identity 52E14B6F-B1BB-4969-B89B-C4FAA56745EF -Scope Web
# And again enable modern lists and libraries at web level
#Disable-PnPFeature -Identity 52E14B6F-B1BB-4969-B89B-C4FAA56745EF -Scope Web
Nota:
PnP PowerShell es una solución de código abierto con una comunidad activa que ofrece su soporte. No hay ningún contrato de nivel de servicio para el soporte de la herramienta de código abierto de Microsoft.
Exclusión a nivel de lista
Para controlar la experiencia a nivel de biblioteca, puede ir a Configuración de lista>Configuración avanzada y cambiar el comportamiento.
Lo mismo también puede hacerse con PowerShell PnP, como se muestra en este fragmento de código:
# Connect to a site
$cred = Get-Credential
Connect-PnPOnline -Url https://[tenant].sharepoint.com/sites/siteurl -Credentials $cred
# Get the list to update
$list = Get-PnPList -Identity "Shared Documents" -Includes ListExperienceOptions
# Set the list experience (0 = Auto, 1 = modern, 2 = classic)
$list.ListExperienceOptions = 2
$list.Update()
Invoke-PnPQuery
Nota:
- La configuración a nivel de biblioteca reemplaza la configuración a nivel de colección de sitios o web.
Cómo detectar listas y bibliotecas que podrían excluirse de la experiencia moderna
La exclusión de la experiencia moderna solo es necesario en algunos casos, como se describe en la introducción de este artículo. En el capítulo anterior le mostramos cómo realizar una exclusión, pero ¿cómo saber qué listas y bibliotecas podrían excluirse de la experiencia moderna?
El escáner de modernización de SharePoint proporcionará las respuestas necesarias: si ejecuta el escáner en modo "Examen completo" o en modo "Preparación de experiencia de lista moderna" se recopilarán todos los datos sobre las listas. Con el informe de Excel Preparación de lista de interfaz de usuario moderna generado, encontrará las listas con personalizaciones como se explica en el artículo Analizar y usar los datos de escáner.
Las listas que se encuentran ya se presentan en modo clásico por el mecanismo de reserva clásico de SharePoint. Pero si quiere ofrecer una experiencia de usuario clásica completa, debería excluir la colección de sitios completa de las listas y bibliotecas modernas. Para facilitar esta tarea, el escáner genera un archivo CSV denominado SitesWithCustomizations.csv que lista todas las colecciones de sitios que contienen una o varias listas que pueden excluirse.
Este archivo CSV es una lista sencilla de colección de sitios de URL sin un encabezado, como se muestra en el siguiente ejemplo:
"https://contoso.sharepoint.com/sites/siteA"
"https://contoso.sharepoint.com/sites/siteB"
"https://contoso.sharepoint.com/sites/siteC"
Cómo controlar mejor la exclusión de colecciones de sitios seleccionadas
Puede usar las opciones descritas anteriormente para excluir una colección de sitios, web o listas de las listas y bibliotecas modernas. Si ha usado el escáner para generar una lista de colecciones de sitios que podrían excluirse de la experiencia moderna, luego, puede usar el script de PowerShell PnP para realizar una exclusión.
<#
.SYNOPSIS
Enables or disables the modern list and library experience at site collection level. The script can handle a single site collection or a list of site collections provided via a CSV file.
To get the CSV file you can run the Modernization Scanner, version 2.3 or higher, and use the "Lists and Library" mode (see https://aka.ms/sppnp-modernizationscanner) or alternatively
create the file yourselves:
"https://contoso.sharepoint.com/sites/siteA"
"https://contoso.sharepoint.com/sites/siteB"
"https://contoso.sharepoint.com/sites/siteC"
.EXAMPLE
PS C:\> .\SetModernListUsage.ps1
#>
#region Logging and generic functions
function LogWrite
{
param([string] $log , [string] $ForegroundColor)
$global:strmWrtLog.writeLine($log)
if([string]::IsNullOrEmpty($ForegroundColor))
{
Write-Host $log
}
else
{
Write-Host $log -ForegroundColor $ForegroundColor
}
}
function LogError
{
param([string] $log)
$global:strmWrtError.writeLine($log)
}
function UsageLog
{
try
{
$cc = Get-PnPContext
$cc.Load($cc.Web)
$cc.ClientTag = "SPDev:ModernListUsage"
$cc.ExecuteQuery()
}
catch [Exception] { }
}
#endregion
function SiteCollectionUsesModernLists
{
param([string] $siteCollectionUrl,
[Boolean] $useModern,
$credentials,
$tenantContext,
[string] $adminUPN)
#region Ensure access to the site collection, if needed promote the calling account to site collection admin
# Check if we can access the site...if not let's 'promote' ourselves as site admin
$adminClaim = "i:0#.f|membership|$adminUPN"
$adminWasAdded = $false
$siteContext = $null
$siteCollectionUrl = $siteCollectionUrl.TrimEnd("/");
Try
{
LogWrite "User running script: $adminUPN"
LogWrite "Connecting to site $siteCollectionUrl"
$siteContext = Connect-PnPOnline -Url $siteCollectionUrl -Credentials $credentials -Verbose -ReturnConnection
}
Catch [Exception]
{
# If Access Denied then use tenant API to add current tenant admin user as site collection admin to the current site
if ($_.Exception.Response.StatusCode -eq "Unauthorized")
{
LogWrite "Temporarily adding user $adminUPN as site collection admin"
Set-PnPTenantSite -Url $siteCollectionUrl -Owners @($adminUPN) -Connection $tenantContext
$adminWasAdded = $true
LogWrite "Second attempt to connect to site $siteCollectionUrl"
$siteContext = Connect-PnPOnline -Url $siteCollectionUrl -Credentials $credentials -Verbose -ReturnConnection
}
else
{
$ErrorMessage = $_.Exception.Message
LogWrite "Error for site $siteCollectionUrl : $ErrorMessage" Red
LogError $ErrorMessage
return
}
}
#endregion
Try
{
#region Adding admin
# Check if current tenant admin is part of the site collection admins, if not add the account
$siteAdmins = $null
if ($adminWasAdded -eq $false)
{
try
{
# Eat exceptions here...resulting $siteAdmins variable will be empty which will trigger the needed actions
$siteAdmins = Get-PnPSiteCollectionAdmin -Connection $siteContext -ErrorAction Ignore
}
catch [Exception] { }
$adminNeedToBeAdded = $true
foreach($admin in $siteAdmins)
{
if ($admin.LoginName -eq $adminClaim)
{
$adminNeedToBeAdded = $false
break
}
}
if ($adminNeedToBeAdded)
{
LogWrite "Temporarily adding user $adminUPN as site collection admin"
Set-PnPTenantSite -Url $siteCollectionUrl -Owners @($adminUPN) -Connection $tenantContext
$adminWasAdded = $true
}
}
UsageLog
#endregion
#region Enable/disable the modern list experience at site collection level
if ($useModern)
{
LogWrite "Disabling the modern list blocking feature"
Disable-PnPFeature -Identity "E3540C7D-6BEA-403C-A224-1A12EAFEE4C4" -Scope Site -Force -Connection $siteContext
}
else
{
LogWrite "Enabling the modern list blocking feature"
Enable-PnPFeature -Identity "E3540C7D-6BEA-403C-A224-1A12EAFEE4C4" -Scope Site -Force -Connection $siteContext
}
#endregion
#region Cleanup updated permissions
LogWrite "Configuration is done, let's cleanup the configured permissions"
# Remove the added site collection admin - obviously this needs to be the final step in the script :-)
if ($adminWasAdded)
{
LogWrite "Remove $adminUPN from site collection administrators"
Remove-PnPSiteCollectionAdmin -Owners @($adminUPN) -Connection $siteContext
}
#endregion
LogWrite "Configuration done for site collection $siteCollectionUrl" Green
# Disconnect PnP Powershell from site
Disconnect-PnPOnline
}
Catch [Exception]
{
$ErrorMessage = $_.Exception.Message
LogWrite "Error: $ErrorMessage" Red
LogError $ErrorMessage
#region Cleanup updated permissions on error
# Configuration did not complete...remove the added tenant admin to restore site permissions as final step in the cleanup
if ($adminWasAdded)
{
try
{
# Final step, remove the added site collection admin
Remove-PnPSiteCollectionAdmin -Owners @($adminUPN) -Connection $siteContext
}
catch [Exception] { }
}
#endregion
LogWrite "Configuration failed for site collection $siteCollectionUrl" Red
}
}
#######################################################
# MAIN section #
#######################################################
# OVERRIDES
# If you want to automate the run and make the script ask less questions, feel free to hardcode these 2 values below. Otherwise they'll be asked from the user or parsed from the values they input
# Tenant admin url
$tenantAdminUrl = "" # e.g. "https://contoso-admin.sharepoint.com"
# If you use credential manager then specify the used credential manager entry, if left blank you'll be asked for a user/pwd
$credentialManagerCredentialToUse = ""
#region Setup Logging
$date = Get-Date
$logfile = ((Get-Item -Path ".\" -Verbose).FullName + "\ModernListUsage_log_" + $date.ToFileTime() + ".txt")
$global:strmWrtLog=[System.IO.StreamWriter]$logfile
$global:Errorfile = ((Get-Item -Path ".\" -Verbose).FullName + "\ModernListUsage_error_" + $date.ToFileTime() + ".txt")
$global:strmWrtError=[System.IO.StreamWriter]$Errorfile
#endregion
#region Load needed PowerShell modules
# Ensure PnP PowerShell is loaded
$minimumVersion = New-Object System.Version("3.4.1812.2")
if (-not (Get-InstalledModule -Name SharePointPnPPowerShellOnline -MinimumVersion $minimumVersion -ErrorAction Ignore))
{
Install-Module SharePointPnPPowerShellOnline -MinimumVersion $minimumVersion -Scope CurrentUser
}
Import-Module SharePointPnPPowerShellOnline -DisableNameChecking -MinimumVersion $minimumVersion
#endregion
#region Gather set modern list usage run input
# Url of the site collection to remediate
$siteCollectionUrlToConfigure = ""
$enableModern = $false
# Get the input information
$siteURLFile = Read-Host -Prompt "Input either single site collection URL (e.g. https://contoso.sharepoint.com/sites/teamsite1) or name of .CSV file (e.g. SitesWithCustomizations.csv) ?"
if (-not $siteURLFile.EndsWith(".csv"))
{
$siteCollectionUrlToConfigure = $siteURLFile
}
# If we are using a CSV, we'll need to get the tenant admin url from the user or use the hardcoded one
else
{
if ($tenantAdminUrl -eq $null -or $tenantAdminUrl.Length -le 0)
{
$tenantAdminUrl = Read-Host -Prompt "Input the tenant admin site URL (like https://contoso-admin.sharepoint.com)"
}
}
$enableModernString = Read-Host -Prompt "Do you want to enable modern lists and libraries for this site collection? Enter True for yes, False otherwise"
try
{
$enableModern = [System.Convert]::ToBoolean($enableModernString)
}
catch [FormatException]
{
$enableModern = $false
}
# We'll parse the tenantAdminUrl from site url (unless it's set already!)
if ($tenantAdminUrl -eq $null -or $tenantAdminUrl.Length -le 0)
{
if ($siteURLFile.IndexOf("/teams") -gt 0)
{
$tenantAdminUrl = $siteURLFile.Substring(0, $siteURLFile.IndexOf("/teams")).Replace(".sharepoint.", "-admin.sharepoint.")
}
else
{
$tenantAdminUrl = $siteURLFile.Substring(0, $siteURLFile.IndexOf("/sites")).Replace(".sharepoint.", "-admin.sharepoint.")
}
}
# Get the tenant admin credentials.
$credentials = $null
$adminUPN = $null
if(![String]::IsNullOrEmpty($credentialManagerCredentialToUse) -and (Get-PnPStoredCredential -Name $credentialManagerCredentialToUse) -ne $null)
{
$adminUPN = (Get-PnPStoredCredential -Name $credentialManagerCredentialToUse).UserName
$credentials = $credentialManagerCredentialToUse
}
else
{
# Prompts for credentials, if not found in the Windows Credential Manager.
$adminUPN = Read-Host -Prompt "Please enter admin UPN (e.g. admin@contoso.onmicrosoft.com)"
$pass = Read-host -AsSecureString "Please enter admin password"
$credentials = new-object management.automation.pscredential $adminUPN,$pass
}
if($credentials -eq $null)
{
Write-Host "Error: No credentials supplied." -ForegroundColor Red
exit 1
}
#endregion
#region Connect to SharePoint
# Get a tenant admin connection, will be reused in the remainder of the script
LogWrite "Connect to tenant admin site $tenantAdminUrl"
$tenantContext = Connect-PnPOnline -Url $tenantAdminUrl -Credentials $credentials -Verbose -ReturnConnection
#endregion
#region Configure the site(s)
if (-not $siteURLFile.EndsWith(".csv"))
{
# Remediate the given site collection
SiteCollectionUsesModernLists $siteCollectionUrlToConfigure $enableModern $credentials $tenantContext $adminUPN
}
else
{
$csvRows = Import-Csv $siteURLFile -Header SiteCollectionUrl
foreach($row in $csvRows)
{
if($row.SiteCollectionUrl -ne "")
{
$siteUrl = $row.SiteCollectionUrl
SiteCollectionUsesModernLists $siteUrl $enableModern $credentials $tenantContext $adminUPN
}
}
}
#endregion
#region Close log files
if ($global:strmWrtLog -ne $NULL)
{
$global:strmWrtLog.Close()
$global:strmWrtLog.Dispose()
}
if ($global:strmWrtError -ne $NULL)
{
$global:strmWrtError.Close()
$global:strmWrtError.Dispose()
}
#endregion