Localização no modelo de Suplemento do SharePoint

Importante

Os suplementos do SharePoint atingiram o fim da vida útil no SharePoint Online em 2 de abril de 2026. Os suplementos hospedados no SharePoint e hospedados pelo provedor foram desativados e não funcionam mais no SharePoint Online, incluindo nuvens governamentais. As diretrizes de desenvolvimento, implantação e uso de suplementos são mantidas para referência histórica e para cenários aplicáveis do Servidor do SharePoint, não para novas soluções do SharePoint Online.

Os suplementos do Servidor do SharePoint implantados por meio de um catálogo de aplicativos local não são desativados por essa alteração. A aquisição de Suplementos do SharePoint do marketplace público terminou em 2 de abril de 2026 para o Servidor do SharePoint.

Essa desativação não desativa APIs REST do SharePoint, CSOM, JSOM ou SPFx (Estrutura do SharePoint). Para o SharePoint Online, use SPFx para extensões de interface do usuário e o Microsoft Entra ID para autenticação para aplicativos externos. Consulte o anúncio de desativação e as diretrizes de migração de suplemento.

A abordagem adotada para implementar a localização de Suplementos é diferente no novo modelo de Suplemento do SharePoint do que era com o Código de Confiança Total. Em um cenário típico de FTC (Código de Confiança Total)/Solução de Farm, a localização de componentes personalizados, como Web Parts, Controles de Usuário e Controles da Web, foi implementada com uma combinação de arquivos de recurso, código gerenciado .NET, propriedades e código declarativo. Todos os artefatos foram empacotados em recursos implantados por meio de soluções do SharePoint.

Em um cenário de modelo de suplemento do SharePoint, você usa JavaScript ou os recursos de localização associados à tecnologia da Web com a qual você cria seus suplementos para implementar a localização. Dependendo do recurso localizado, você também pode usar arquivos de recursos clássicos, por exemplo, quando precisar localizar elementos implantados na Web do suplemento usando elementos da estrutura de recursos na definição do suplemento.

Diretrizes de alto nível

Como regra geral, gostaríamos de fornecer as seguintes diretrizes de alto nível para implementar a localização.

  • Você deve instalar os pacotes de idiomas apropriados em seus ambientes locais do SharePoint e do Office 365 para permitir que os usuários criem sites em um idioma e cultura específicos.
  • Usar JavaScript para implementar localização em Suplementos do SharePoint também é uma abordagem que você pode usar para localizar conteúdo em Partes de Suplemento do Editor de Scripts.

Cenários de localização

Há dois cenários distintos em que talvez seja necessário implementar a localização de um Suplemento.

  • Suplementos hospedados no SharePoint
  • Suplementos hospedados pelo provedor

Componentes da Web ou ativos de suplementos

Nesse cenário, a localização é aplicada ao Suplemento via JavaScript.

  • Os suplementos hospedados no SharePoint não têm acesso aos arquivos de recurso baseados no servidor nos servidores do SharePoint, mas você tem acesso aos arquivos *.resx do elemento de recurso.
  • A abordagem para localizar um suplemento hospedado no SharePoint e um suplemento do Office é muito semelhante, pois ambos usam JavaScript.

Quando isso é apropriado?

Quando você está criando um suplemento hospedado no SharePoint, usar JavaScript é a melhor opção, pois você pode implementar a localização com JavaScript e implantar todos os arquivos JavaScript necessários para dar suporte à localização com o suplemento hospedado no SharePoint. Você também poderá aproveitar essa abordagem se o suplemento hospedado pelo provedor contiver também um site de suplemento específico.

Guia de Introdução

O cenário 2 no Core.JavaScriptCustomization (exemplo de PnP do O365)) demonstra como usar o JavaScript para localizar o texto em um suplemento, bem como atributos associados aos elementos HTML no suplemento.

Os Suplementos Localizar do SharePoint também demonstram como usar o JavaScript para localizar ativos na Web do suplemento.

Componentes remotos

Nesse cenário, a localização é aplicada ao Suplemento por meio das tecnologias de localização associadas à tecnologia da Web que hospeda o Suplemento.

  • Quando ASP.NET é usado para implementar o Suplemento, arquivos de recurso e arquivos JavaScript são usados para localizá-lo.
  • Quando outra tecnologia, como PHP, Python ou Ruby, é usada para implementar o suplemento, os recursos de localização associados a essas plataformas são usados.

Quando isso é apropriado?

Ao criar um Suplemento hospedado pelo Provedor, usar a tecnologia de localização que vem com a plataforma de hospedagem na Web é a melhor opção, pois você está criando o Suplemento de uma maneira que não introduz código personalizado ou complexidade adicional.

Guia de Introdução

Os artigos a seguir descrevem como localizar Suplementos hospedados pelo provedor com arquivos de recurso e JavaScript.

Exemplos de PnP

Aplicável a

  • Office 365 Multilocatário (MT)
  • Office 365 dedicado (D)
  • SharePoint 2013 local
  • Última atualização a