Localização no modelo de suplemento do SharePoint
A abordagem que você adota para implementar a localização para suplementos é diferente no novo modelo de suplemento do SharePoint do que com o Código de Confiança Total. Em um cenário típico de FTC (Código de Confiança Total) / Farm Solution, a localização de componentes personalizados, como Web Parts, Controles de Usuário e Controles Web foi implementada com uma combinação de arquivos de recursos, código gerenciado .Net, propriedades e código declarativo. Todos os artefatos foram empacotados em recursos implantados por meio da SharePoint Solutions.
Em um cenário de modelo de suplemento do SharePoint, você usa o JavaScript ou os recursos de localização associados à tecnologia 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 para adicionar na Web usando elementos de estrutura de recursos na definição de suplemento.
Diretrizes de alto nível
Como regra geral, gostaríamos de fornecer as diretrizes de alto nível a seguir para implementar a localização.
- Você deve instalar os Pacotes de Idiomas apropriados em seus ambientes locais e Office 365 do SharePoint para permitir que os usuários criem sites em uma linguagem e cultura específicas.
- Usar o JavaScript para implementar a 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 Script.
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 pelo SharePoint
- Suplementos hospedados pelo provedor
Componentes ou ativos da Web de suplemento
Nesse cenário, a localização é aplicada ao Suplemento por meio do JavaScript.
- Os Suplementos hospedados pelo SharePoint não têm acesso a arquivos de recursos baseados em servidor nos servidores do SharePoint, mas você tem acesso no elemento de recurso *.resx files.
- A abordagem para localizar um Suplemento hospedado pelo SharePoint e um Suplemento do Office são muito semelhantes porque ambos usam JavaScript.
Quando isso é apropriado?
Quando você está criando um Suplemento hospedado no SharePoint, usar JavaScript é o seu melhor ajuste, 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 pelo SharePoint. Você também pode aproveitar essa abordagem se o suplemento hospedado pelo provedor contiver também suplementos específicos na Web.
Introdução
O cenário 2 no Core.JavaScriptCustomization (Exemplo O365 PnP)) demonstra como usar JavaScript para localizar o texto em um Suplemento, bem como atributos associados aos elementos HTML no Suplemento.
Os Suplementos de Localize do SharePoint também demonstram como usar o JavaScript para localizar ativos na Web de suplemento.
Componentes remotos
Nesse cenário, a localização é aplicada ao Suplemento por meio das tecnologias de localização associadas à tecnologia Web que hospeda o Suplemento.
- Quando ASP.NET é usado para implementar o Suplemento, arquivos de recursos e arquivos JavaScript são usados para localizá-lo.
- Quando outra tecnologia como PHP, Python ou Ruby é usada para implementar o Suplemento, as funcionalidades de localização associadas a essas plataformas são usadas.
Quando isso é apropriado?
Quando você está criando um Suplemento hospedado pelo Provedor, usar a tecnologia de localização que vem com a plataforma de hospedagem da Web é o melhor ajuste porque você está criando o Suplemento de uma maneira que não introduz código personalizado ou complexidade adicional.
Introdução
Os artigos a seguir descrevem como localizar suplementos hospedados pelo provedor com arquivos de recursos e JavaScript.
- Localizar suplementos do SharePoint (artigo MSDN)
- Localize os componentes web, host web e remotos de um suplemento (Exemplo de Código MSDN)
Links relacionados
- Localizar suplementos do SharePoint (artigo MSDN)
- Localize os componentes web, host web e remotos de um suplemento (exemplo do GitHub do Office Dev)
- Artigos de diretrizes em https://aka.ms/OfficeDevPnPGuidance
- Referências no MSDN em https://aka.ms/OfficeDevPnPMSDN
- Vídeos em https://aka.ms/OfficeDevPnPVideos
Exemplos de PnP
- Classe VariationsExtensions.cs (Amostra O365 PnP)
- Exemplos e conteúdo no Microsoft 365 Patterns and Practices (PnP)
Aplicável a
- Office 365 Multilocatário (MT)
- Office 365 dedicado (D)
- SharePoint 2013 local