Localización en el modelo de complementos de SharePoint

Importante

Los complementos de SharePoint alcanzaron la finalización de su vida útil en SharePoint Online el 2 de abril de 2026. Tanto los complementos hospedados por SharePoint como los hospedados por el proveedor se retiran y ya no funcionan en SharePoint Online, incluidas las nubes de administración pública. Las instrucciones de uso, implementación y desarrollo de complementos se conservan como referencia histórica y para escenarios de SharePoint Server aplicables, no para nuevas soluciones de SharePoint Online.

Los complementos de SharePoint Server implementados a través de un catálogo de aplicaciones local no se retiran por este cambio. La adquisición de complementos de SharePoint en el marketplace público finalizó el 2 de abril de 2026 para SharePoint Server.

Esta retirada no retira las API de REST DE SHAREPOINT, CSOM, JSOM o SharePoint Framework (SPFx). Para SharePoint Online, use SPFx para las extensiones de la interfaz de usuario y Microsoft Entra ID para la autenticación en aplicaciones externas. Consulte el anuncio de retirada y las instrucciones de migración de complementos.

El enfoque que adopte para implementar la localización de complementos es diferente en el nuevo modelo de complementos de SharePoint que con el código de plena confianza. En un escenario típico de código de plena confianza (FTC)/solución de granja de servidores, la localización de componentes personalizados como elementos web, controles de usuario y controles web se implementó con una combinación de archivos de recursos, código administrado por .Net, propiedades y código declarativo. Todos los artefactos se empaquetaron en características implementadas a través de soluciones de SharePoint.

En un escenario de modelo de complemento de SharePoint, se usa JavaScript o las funcionalidades de localización asociadas a la tecnología web con la que se compilan los complementos para implementar la localización. En función del recurso localizado, también puede usar archivos de recursos clásicos, por ejemplo, cuando necesite localizar elementos implementados en la web de complementos mediante elementos del marco de características en la definición del complemento.

Directrices importantes

Como regla general, nos gustaría proporcionar las siguientes directrices de alto nivel para implementar la localización.

  • Debe instalar los paquetes de idioma adecuados en los entornos locales de SharePoint y de Office 365 para permitir a los usuarios crear sitios web en un idioma y una referencia culturales específicos.
  • El uso de JavaScript para implementar la localización en complementos de SharePoint también es un enfoque que puede usar para localizar contenido en elementos de complemento del Editor de scripts.

Escenarios de localización

Hay dos escenarios distintos en los que puede necesitar implementar la localización de un complemento.

  • Complementos hospedados en SharePoint
  • Complementos hospedados por el proveedor

Componentes o activos web de complemento

En este escenario, la localización se aplica al complemento a través de JavaScript.

  • Los complementos hospedados en SharePoint no tienen acceso a los archivos de recursos basados en servidor en los servidores de SharePoint, pero usted tiene acceso en los archivos .resx del elemento de característica.
  • El enfoque para localizar un complemento hospedado en SharePoint y un complemento de Office es muy similar porque ambos usan JavaScript.

¿Cuándo es una buena opción?

Si va a crear un complemento hospedado en SharePoint, lo mejor es usar JavaScript, ya que puede implementar la localización con JavaScript e implementar todos los archivos JavaScript necesarios para admitir la localización con el complemento hospedado en SharePoint. También puede aprovechar este enfoque si el complemento hospedado por el proveedor contiene también complementos Web específicos.

Introducción

En el escenario 2 de Core.JavaScriptCustomization (ejemplo de O365 PnP)), se muestra cómo usar JavaScript para localizar el texto de un complemento, así como los atributos asociados a los elementos HTML del complemento.

Los complementos Localizar SharePoint también muestran cómo usar JavaScript para localizar activos en la web de complementos.

Componentes remotos

En este escenario, la localización se aplica al complemento a través de las tecnologías de localización asociadas a la tecnología web que hospeda el complemento.

  • Cuando se usa ASP.NET para implementar el complemento, se usan archivos de recursos y archivos JavaScript para localizarlo.
  • Cuando se usa otra tecnología como PHP, Python o Ruby para implementar el complemento, se usan las capacidades de localización asociadas a esas plataformas.

¿Cuándo es una buena opción?

Cuando crea un complemento hospedado por el proveedor, el uso de la tecnología de localización que viene con la plataforma de alojamiento web es la mejor opción, porque está creando el complemento de una manera que no introduce código personalizado ni complejidad adicional.

Introducción

En los artículos siguientes se describe cómo localizar complementos hospedados por el proveedor con archivos de recursos y JavaScript.

Ejemplos de PnP

Se aplica a

  • Office 365 multiempresa (MT)
  • Office 365 dedicado (D)
  • SharePoint 2013 local