Trabalhar com sites em um ambiente com Multi-Geo

Os sites do SharePoint abrangem as localizações geográficas padrão e satélite de um locatário multi-geográfico. Quando sua solução personalizada precisa trabalhar com sites do SharePoint e, quando você implanta aplicativos, é importante estar ciente das localizações geográficas em seu locatário Multi-Geo.

Implantar aplicativos em locatários multi-geográficos

Quando você está implantando aplicativos, como Suplementos do SharePoint ou Web Parts do lado do cliente do SharePoint com base no Estrutura do SharePoint, você precisa levar em conta que os aplicativos são implantados no nível de localização geográfica.

Quando você implanta um aplicativo na localização geográfica padrão, esse aplicativo não está disponível nas localizações geográficas do satélite. Para obter mais informações, consulte Gerenciar aplicativos e suplementos em um locatário multi-geográfico.

Recomendamos que você implante e atualize seus aplicativos empresariais em todos os locais. Isso garante que o aplicativo esteja disponível para todos os usuários.

Enumerar coleções de sites

Para enumerar todas as coleções de sites de locatário, use o método CSOM GetSitePropertiesFromSharePointByFilters em uma Tenant instância de objeto. Como cada localização geográfica tem um centro de administração de locatário, você deve enumerar coleções de sites por localização geográfica e concatenar os resultados para obter uma única lista de coleções de sites em todo o locatário.

Para executar uma enumeração de site em todo o locatário:

• Encontre todos os locais geográficos e suas URLs de site de administrador de locatários associadas.
• Crie um loop que itere sobre as localizações geográficas e crie um Tenant objeto com a URL do site de administração do local geográfico.
  • Use a chamada de GetSitePropertiesFromSharePointByFilters método no Tenant objeto para obter as coleções do site para essa localização geográfica.
  • Anexe as coleções de sites a uma lista.
• Retorne a lista de coleções de sites.

Para obter mais informações, consulte o exemplo MultiGeo.SiteEnumeration .

Para obter mais informações sobre permissões e como configurar seu aplicativo, consulte Configurar um aplicativo de exemplo Multi-Geo.

Executar operações no nível do locatário

O Tenant objeto também é usado para configurar configurações no nível do locatário, como configurações de CDN e configurações de site no nível do locatário, como a restrição de localização geográfica do site. Para executar operações no nível do locatário:

• Encontre todos os locais geográficos e suas URLs de site de administrador de locatários associadas.
• Para atualizar as configurações no nível do locatário, itere sobre as localizações geográficas e faça a alteração por localização geográfica.
• Para atualizar as configurações do site no nível do locatário:
  • Use a GeoLocation propriedade do Site objeto para obter a localização geográfica do site.
  • Use o método locatário GetSitePropertiesByUrl para obter o site, fazer alterações e chamar Update o objeto recuperado SiteProperties .

Para obter mais informações sobre como obter um site usando o GetSitePropertiesByUrl método e, em seguida, restringir a movimentação do site definindo a RestrictedToRegion propriedade, consulte o exemplo MultiGeo.RestrictSiteToGeoLocation .

Identificar sites armazenando a ID do site

Em um locatário multi-geográfico, os sites podem ser movidos entre locais geográficos, o que implica que a URL desse site será alterada, portanto, não recomendamos armazenar a URL do site como uma chave exclusiva para identificar um site. É melhor armazenar a ID do site porque isso não é alterado, independentemente da localização geográfica em que o site está hospedado.

Confira também

• OneDrive e SharePoint Online com Multi-Geo