Работа с сайтами в среде с поддержкой нескольких регионов

  • Статья

Сайты SharePoint охватывают географические расположения клиента с поддержкой нескольких регионов по умолчанию и спутниковые расположения. Когда пользовательское решение должно работать с сайтами SharePoint и развертывать приложения, важно знать о географических расположениях в клиенте с несколькими регионами.

Развертывание приложений в клиентах с несколькими регионами

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

При развертывании приложения в географическом расположении по умолчанию это приложение недоступно во вспомогательных географических расположениях. Дополнительные сведения см. в статье Управление приложениями и надстройками в клиенте с поддержкой нескольких регионов.

Рекомендуется развертывать и обновлять корпоративные приложения во всех расположениях. Это гарантирует, что приложение будет доступно всем пользователям.

Перечисление семейств веб-сайтов

Чтобы перечислить все семейства веб-сайтов клиента, используйте метод CSOM GetSitePropertiesFromSharePointByFilters в экземпляре Tenant объекта. Так как каждое географическое расположение имеет центр администрирования клиента, необходимо перечислить семейства веб-сайтов по географическому расположению и объединить результаты, чтобы получить единый список семейств веб-сайтов на уровне клиента.

Чтобы выполнить перечисление сайта на уровне клиента, выполните приведенные далее действия.

  • Поиск всех географических расположений и связанных с ними URL-адресов сайтов администрирования клиента.
  • Создайте цикл, который выполняет итерацию по географическим расположениям и создает Tenant объект с URL-адресом сайта администратора географического расположения.
    • GetSitePropertiesFromSharePointByFilters Используйте вызов метода для объекта , Tenant чтобы получить семейства веб-сайтов для этого географического расположения.
    • Добавьте семейства веб-сайтов в список.
  • Возвращает список семейств веб-сайтов.

Дополнительные сведения см. в примере MultiGeo.SiteEnumeration .

Дополнительные сведения о разрешениях и настройке приложения см. в разделе Настройка примера приложения с несколькими регионами.

Выполнение операций на уровне клиента

Объект Tenant также используется для настройки параметров на уровне клиента, таких как параметры CDN, и параметров сайта на уровне клиента, таких как ограничение географического расположения сайта. Чтобы выполнить операции на уровне клиента, выполните следующие действия:

  • Поиск всех географических расположений и связанных с ними URL-адресов сайтов администрирования клиента.
  • Чтобы обновить параметры на уровне клиента, выполните итерацию по географическим расположениям и внесите изменения в каждое географическое расположение.
  • Чтобы обновить параметры сайта на уровне клиента, выполните следующие действия.
    • GeoLocation Используйте свойство объекта , Site чтобы получить географическое расположение сайта.
    • GetSitePropertiesByUrl Используйте метод клиента, чтобы получить сайт, внести изменения и вызвать Update полученный SiteProperties объект.

Дополнительные сведения о том, как получить сайт с помощью GetSitePropertiesByUrl метода , а затем запретить перемещение сайта, задав RestrictedToRegion свойство, см. в примере MultiGeo.RestrictSiteToGeoLocation .

Определение сайтов путем сохранения идентификатора сайта

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

См. также