Поделиться через

Локализация в модели надстройки SharePoint

  • Статья

Подход, который вы используете для реализации локализации надстроек, в новой модели надстроек SharePoint отличается от подхода к коду полного доверия. В типичном сценарии с кодом полного доверия (FTC) или решением фермы локализация для пользовательских компонентов, таких как веб-части, пользовательские элементы управления и веб-элементы управления, была реализована с помощью сочетания файлов ресурсов, управляемого кода .NET, свойств и декларативного кода. Все артефакты были упаковывались в функции, развернутые с помощью решений SharePoint.

В сценарии модели надстроек SharePoint для реализации локализации используется JavaScript или возможности локализации, связанные с веб-технологией, с помощью этой веб-технологии. В зависимости от локализованного ресурса можно также использовать файлы классических ресурсов, например, когда необходимо локализовать элементы, развернутые в веб-сайте надстройки, с помощью элементов платформы компонентов в определении надстройки.

Рекомендации высокого уровня

Как правило, мы хотели бы предоставить следующие общие рекомендации по реализации локализации.

  • Необходимо установить соответствующие языковые пакеты в локальной среде SharePoint и средах Office 365, чтобы пользователи могли создавать веб-сайты на определенном языке и языке.
  • Использование JavaScript для реализации локализации в надстройках SharePoint также является подходом, который можно использовать для локализации содержимого в частях надстроек редактора скриптов.

Сценарии локализации

Существует два разных сценария, в которых может потребоваться реализовать локализацию для надстройки.

  • Надстройки, размещенные в SharePoint
  • Надстройки, размещенные у поставщика

Веб-компоненты или ресурсы надстройки

В этом сценарии локализация применяется к надстройке с помощью JavaScript.

  • Надстройки, размещенные в SharePoint, не имеют доступа к серверным файлам ресурсов на серверах SharePoint, но у вас есть доступ к resx-файлам элемента компонента .
  • Подход к локализации надстройки, размещенной в SharePoint, и надстройки Office очень похожи, так как оба они используют JavaScript.

Для каких случаев он подходит?

При создании надстройки, размещенной в SharePoint, лучше всего подходит использование JavaScript, так как вы можете реализовать локализацию с помощью JavaScript и развернуть все файлы JavaScript, необходимые для поддержки локализации с помощью надстройки, размещенной в SharePoint. Вы также можете воспользоваться этим подходом, если размещенная у поставщика надстройка содержит также определенный веб-сайт надстроек.

Приступая к работе

Сценарий 2 в Core.JavaScriptНастройка (пример O365 PnP)) демонстрирует использование JavaScript для локализации текста в надстройке, а также атрибутов, связанных с ЭЛЕМЕНТАМи HTML в надстройке.

В статье Локализация надстроек SharePoint также показано, как использовать JavaScript для локализации ресурсов в веб-сайте надстроек.

Удаленные компоненты

В этом сценарии локализация применяется к надстройке с помощью технологий локализации, связанных с веб-технологией, размещающей надстройку.

  • Если ASP.NET используется для реализации надстройки, файлы ресурсов и файлы JavaScript используются для ее локализации.
  • Если для реализации надстройки используются другие технологии, такие как PHP, Python или Ruby, используются возможности локализации, связанные с этими платформами.

Для каких случаев он подходит?

При создании надстройки, размещенной у поставщика, лучше всего подходит технология локализации, которая поставляется с платформой веб-хостинга, так как вы создаете надстройку таким образом, чтобы не создавать пользовательский код или дополнительные сложности.

Начало работы

В следующих статьях описывается локализация надстроек, размещенных у поставщика, с помощью файлов ресурсов и JavaScript.

Образцы PnP

Область применения

  • Office 365 Multi Tenant (MT)
  • Office 365 Dedicated (D)
  • Локальное развертывание SharePoint 2013