Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
El enfoque que se usa para implementar controles personalizados en el código es diferente en el nuevo modelo de complemento de SharePoint que con el código de plena confianza. En un escenario típico de solución de granja de servidores o código de plena confianza (FTC), los controles personalizados se crearon como controles de usuario o controles web e se implementaron a través de soluciones de SharePoint.
En un escenario de modelo de complemento de SharePoint, JavaScript se inserta en páginas de SharePoint para implementar controles personalizados.
Directrices importantes
Como regla general, nos gustaría proporcionar las siguientes directrices de alto nivel para crear controles personalizados en el nuevo modelo de complemento de SharePoint.
- Use JavaScript incrustado para crear controles personalizados.
- Use el modelo de objetos del lado cliente (CSOM) de ECMA de SharePoint o las API REST de SharePoint/Office 365 para interactuar con los datos y servicios de SharePoint.
Opciones para insertar JavaScript en páginas de SharePoint
Tiene algunas opciones para insertar JavaScript en páginas de SharePoint.
- Uso de acciones de usuario personalizadas
- Inserción de JavaScript directamente en diseños de página
- Insertar JavaScript directamente en páginas maestras personalizadas (no se recomienda)
Uso de acciones de usuario personalizadas
En este patrón, se usan acciones de usuario personalizadas para insertar JavaScript en una página en tiempo de ejecución.
- Este enfoque es totalmente compatible y es un enfoque válido.
¿Cuándo es una buena opción?
Cuando necesite insertar JavaScript en todas las páginas de SharePoint, esta opción es una buena opción.
Introducción
En el siguiente artículo y vídeo adjunto se muestra cómo usar acciones de usuario personalizadas para insertar JavaScript en páginas de SharePoint.
- Core.EmbedJavaScript (ejemplo PnP de O365)
- OD4B. NavLinksInjection (ejemplo PnP de Office 365)
- Navegación entre la colección de sitios (vídeo de PnP de Office 365)
Inserción de JavaScript directamente en diseños de página
En este patrón, JavaScript se inserta directamente en diseños de página en sitios de publicación.
- Este enfoque es totalmente compatible y es un enfoque válido.
- Este enfoque funciona con sitios de publicación.
¿Cuándo es una buena opción?
Cuando necesite insertar JavaScript en diseños de página de SharePoint específicos en sitios de publicación en un escenario de WCM, esta opción es una buena opción.
Inserción de JavaScript directamente en páginas maestras personalizadas
En este patrón, JavaScript se inserta directamente en páginas maestras personalizadas.
- No se recomienda este enfoque.
- Este enfoque es un enfoque válido.
- Puede insertar JavaScript directamente en páginas maestras personalizadas, pero tenga en cuenta que esto provocará costos y desafíos adicionales a largo plazo con futuras actualizaciones.
- Si ha decidido usar páginas maestras personalizadas, esté preparado para aplicar cambios a las páginas maestras personalizadas cuando se apliquen actualizaciones importantes de funciones en Office 365.
¿Cuándo es una buena opción?
Cuando necesite insertar JavaScript por página maestra, esta es una buena opción, ya que le permite controlar en qué páginas maestras está insertado JavaScript.
Vínculos relacionados
- Navegación entre la colección de sitios (vídeo de PnP de Office 365)
- Artículos de orientación en https://aka.ms/OfficeDevPnPGuidance
- Referencias en MSDN en https://aka.ms/OfficeDevPnPMSDN
- Vídeos en https://aka.ms/OfficeDevPnPVideos
Ejemplos de PnP
- Core.EmbedJavaScript (ejemplo PnP de O365)
- OD4B. NavLinksInjection (ejemplo PnP de Office 365)
- Core.EmbedJavaScript.WeekNumbers (ejemplo PnP de O365)
- Core.EmbedJavaScriptJSOM (ejemplo PnP de O365)
- Core.JavaScriptCustomization (escenario PnP de O365 mediante el componente PnP Core)
- Ejemplos y contenido en Patrones y prácticas de Microsoft 365 (PnP)
Se aplica a
- Office 365 multiempresa (MT)
- Office 365 dedicado (D)
- SharePoint 2013 local