Compartir a través de

Localización en el modelo de complemento de SharePoint

El enfoque que se usa para implementar la localización para complementos es diferente en el nuevo modelo de complementos de SharePoint que con código de plena confianza. En un escenario típico de solución de granja de servidores o código de plena confianza (FTC), se implementó la localización de componentes personalizados, como elementos web, controles de usuario y controles web, con una combinación de archivos de recursos, código administrado de .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 del complemento 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 y Office 365 de SharePoint para permitir que los usuarios creen sitios web en un idioma y una referencia cultural 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 es posible que tenga que implementar la localización para un complemento.

  • Complementos hospedados en SharePoint
  • Complementos hospedados por el proveedor

Componentes o recursos web de complementos

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

  • Los complementos hospedados en SharePoint no tienen acceso a archivos de recursos basados en servidor en los servidores de SharePoint, pero 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?

Al crear un complemento hospedado en SharePoint, el uso de JavaScript es la mejor opción, ya que puede implementar la localización con JavaScript e implementar todos los archivos de 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 web de complemento específica.

Introducción

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

En Localize SharePoint Add-ins también se muestra cómo usar JavaScript para localizar recursos 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 funcionalidades de localización asociadas a esas plataformas.

¿Cuándo es una buena opción?

Al crear un complemento hospedado por el proveedor, el uso de la tecnología de localización que viene con la plataforma de hospedaje 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
  • Last updated on