Usar páginas de aplicación de elemento único en SharePoint Online

  • Artículo

Las páginas de aplicación de elemento único proporcionan una función para hospedar elementos web de SharePoint Framework o aplicaciones de Microsoft Teams en SharePoint Online con un diseño bloqueado. Los usuarios finales no pueden modificar ni configurar la página que usa el diseño de página de aplicación de elemento único.

Las páginas de aplicación tienen las siguientes características:

  • Las páginas de aplicación de elemento único no pueden ser editadas por los usuarios finales con el explorador
  • Actualmente solo permiten hospedar un elemento web único o una aplicación de Microsoft Teams
  • Los usuarios finales pueden crear nuevas páginas de aplicaciones con la experiencia Nuevo>Página disponible en sitios modernos.
  • Los desarrolladores pueden cambiar el diseño de página mediante programación de diseño de página normal a página de aplicación de elemento único
  • No hay ninguna experiencia nueva en una página de aplicación de elemento único. Los usuarios finales pueden crear páginas de artículos o páginas de aplicación de elemento único con la experiencia de Nueva/página presente en la cinta de cualquier página de artículo moderno.

Las páginas de aplicación se muestran como opción en la función de creación de páginas modernas al elegir el diseño de página utilizado para su página Todos los elementos web, que se han configurado para estar disponibles también como una página de aplicación, están disponibles en la función Crear página.

El elemento web puede configurarse para mostrarse como una página de aplicación. Esta configuración se realiza en el archivo de manifiesto del elemento web ajustando el valor supportedHosts. El elemento web se mostrará como opción en la interfaz de usuario del próximo selector de páginas de aplicación, si el valor supportedHosts contiene el valor "SharePointFullPage".

El siguiente manifiesto de elemento web muestra un escenario donde el elemento web se incluye para estar en todas las plataformas admitidas al actualizar todos los valores diferentes para el parámetro supportedHosts.

{
  // ...

  "requiresCustomScript": false,
  "supportedHosts": ["SharePointWebPart", "SharePointFullPage", "TeamsTab"],

  "preconfiguredEntries": [{
    // ...
  }]
}

¿Cómo aprovisionar la página de aplicación de elemento único en su espacio empresarial?

Como desarrollador, las dos formas más comunes de aprovisionar páginas de aplicación de elemento único son PnP de PowerShell o la CLI de Microsoft 365.

Puede usar PowerShell PnP para actualizar el diseño de página de la página existente con la siguiente secuencia de comandos.

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.

También puede usar la CLI de Microsoft 365 para actualizar el diseño de página de la página existente con la siguiente secuencia de comandos.

Nota:

La CLI de Microsoft 365 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.

Connect-PnPOnline -Url https://contoso.sharepoint.com/sites/marketing
Set-PnPPage -Identity "Page" -LayoutType SingleWebPartAppPage

Consulte la documentación de PowerShell de PnP para obtener detalles completos y ejemplos sobre este cmdlet.

Tendrá que ajustar el nombre del espacio empresarial y de la página en función de su entorno.