SharePoint Online: ¿Cómo implementar la página de error 404 personalizada no encontrada?

Requisito: Implementar una página de error de página personalizada no encontrada en SharePoint Online.

SharePoint Online: Cómo agregar una página de error personalizada 404 no encontrada

SharePoint Online viene con una página de error básica predeterminada "Página no encontrada" en la biblioteca "Páginas" en los sitios de publicación (https://crescent.sharepoint.com/Pages/PageNotFoundError.aspx), que se muestra automáticamente cuando un usuario intenta acceder a una página o archivo que no existe. Pero se puede personalizar para cumplir con requisitos comerciales específicos. En este artículo, exploraremos cómo implementar una página de error 404 Página no encontrada personalizada en SharePoint Online. Esta página de error funciona para toda la colección de sitios.

Puede personalizar aún más esta página, ubicada en “/Pages/PageNotFoundError.aspx” para agregar texto descriptivo, imágenes y marcas. En algunos casos, es posible que necesites crear tu propia página 404 y estos son los pasos:

Paso 1: Agregar nueva página de error de página no encontrada en SharePoint Online:

Podemos crear nuestra página personalizada y configurarla como una página de error de página no encontrada para cualquier colección de sitios de SharePoint Online. Estos son los pasos para crear una página de error 404 personalizada no encontrada:

1. Vaya a Contenido del sitio >> Elija la biblioteca de páginas y cree una nueva >> Página de error.
2. Personalice la página de error con sus estilos e imágenes y guárdela.

Paso 2: Establecer la página de error 404 predeterminada no encontrada:

Una vez que la página de error personalizada esté lista, el siguiente paso es configurar la página como página de error 404 no encontrada predeterminada. Esto se puede hacer a través de PowerShell o usando SharePoint Designer.

Opción 1: PowerShell para configurar una página de error personalizada en SharePoint Online:
Para configurar una página de error de página personalizada no encontrada, debemos actualizar la clave “vti_filenotfoundpage” en la bolsa de propiedades del sitio raíz objeto. Aquí está el script de PowerShell para configurar una página de error personalizada para una colección de sitios.

#Load SharePoint CSOM Assemblies
Add-Type -Path "C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\16\ISAPI\Microsoft.SharePoint.Client.dll"
Add-Type -Path "C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\16\ISAPI\Microsoft.SharePoint.Client.Runtime.dll"

#Set Variables
$SiteURL = "https://crescent.sharepoint.com/sites/marketing"
$CustomPageNotFoundURL = "/sites/marketing/Pages/404.aspx"

#Get Credentials to connect
$Cred = Get-Credential

Try {
    #Setup the context
    $Ctx = New-Object Microsoft.SharePoint.Client.ClientContext($SiteURL)
    $Ctx.Credentials = New-Object Microsoft.SharePoint.Client.SharePointOnlineCredentials($Cred.UserName,$Cred.Password)

    #Get the Root Web and its Property Bag
    $Web = $Ctx.Web
    $Ctx.Load($Web)
    $Ctx.Load($Web.AllProperties)
    $Ctx.ExecuteQuery()
    
    #Update the Key value in Property bag
    $Web.AllProperties["vti_filenotfoundpage"] = $CustomPageNotFoundURL
    $Web.Update()
    $Ctx.ExecuteQuery()
  
    Write-Host -f Green "Custom 404 Page Not Found Error page has been Set!"
}
Catch {
    write-host "Error: $($_.Exception.Message)" -foregroundcolor Red
}

También puede configurar la página de error 404 usando PnP PowerShell como:

Set-PnPPropertyBagValue -Key "vti_filenotfoundpage" -Value "/sites/Your-site-url/SitePages/Page-not-found.aspx"

Opción 2: usar SharePoint Designer para configurar la página de error de página personalizada no encontrada:
También puede utilizar el diseñador de SharePoint para configurar la página de error de página personalizada no encontrada: Aquí se explica cómo:

1. Abra su colección de sitios de SharePoint Online en SharePoint Designer 2013
2. Seleccione el objeto Sitio en la navegación del lado izquierdo, haga clic en el botón Opciones del sitio en la cinta

3. Asigne la propiedad “vti_filenotfoundpage” del sitio a una URL de página de error personalizada que haya creado. (Agregue una nueva entrada, si no existe)

   

4. Haga clic en el botón "Aceptar" para confirmar sus cambios.

¿Puedo implementar una página de error de página personalizada no encontrada sin activar la función de publicación?

¿Qué pasa con los sitios que no publican? ¿Cómo agregar páginas de error 404 personalizadas en sitios de grupo? Aquí es cómo:

• Navegue a su colección de sitios de SharePoint Online, elija cualquier biblioteca de documentos (por ejemplo, "Activos del sitio")
• Habilite el tipo de contenido: Haga clic en Configuración >> Configuración de biblioteca >> Configuración avanzada >> Configure "Sí" para la opción "Permitir la administración de tipos de contenido" y haga clic en "Aceptar" en la parte inferior de la página.
• Ahora, en la página Configuración de la biblioteca, en "Tipos de contenido", haga clic en el enlace "Agregar desde tipos de contenido de sitios existentes".
• Agregue el tipo de contenido "Página básica" a la Biblioteca. Ahora, regrese a la biblioteca >> Haga clic en “Nuevo” >> Página básica >> Asigne un nombre a su página de error (por ejemplo, 404) y haga clic en “Crear”
• ¡Agregue texto e imágenes descriptivos a la página y guárdelo!

Ahora tiene lista su página de error personalizada. Puede utilizar los métodos de PowerShell o SharePoint Designer descritos anteriormente para configurar la página de error de página personalizada no encontrada para SharePoint Online.

¿Cómo configurar una página de error 404 personalizada en sitios modernos de SharePoint Online?

El mismo procedimiento se aplica cuando desea implementar una página de error de página personalizada no encontrada en su sitio de equipo o sitios de comunicación modernos. Los sitios modernos de SharePoint Online le brindan solo el texto "404 NO ENCONTRADO" cuando intenta acceder a una página que no existe. Cree una página (¡no necesita tener habilitada la función de publicación! ¡Solo una página del sitio será suficiente!) y use este script de PowerShell para configurar la página como una página de error 404 predeterminada.

#Config Variables
$SiteURL = "https://crescent.sharepoint.com/sites/marketing"
$ErrorPageURL = "/sites/Marketing/SitePages/404-error.aspx" #Server Relative URL of the Error page

#Connect to PnP Online
Connect-PnPOnline -Url $SiteURL -Interactive

#Set 404 Error Page
Set-PnPPropertyBagValue -Key "vti_filenotfoundpage" -Value $ErrorPageURL

¡Asegúrese de haber habilitado el script personalizado para su colección de sitios! ¿Cómo habilitar un script personalizado en SharePoint Online?

En conclusión, personalizar la página de error 404 Página no encontrada en SharePoint Online es un proceso simple que puede mejorar enormemente la experiencia del usuario para los visitantes de su sitio. Al utilizar páginas de error personalizadas, puede ayudar a los usuarios a regresar a la página principal de su sitio y reducir la frustración cuando encuentran enlaces rotos o páginas faltantes. Ya sea administrador de SharePoint o propietario de un sitio, implementar una página de error 404 personalizada es una forma rápida y eficaz de mejorar su experiencia en SharePoint Online.