Utilisation des sites dans un environnement multigéographique

Les sites SharePoint se trouvent dans différents emplacements géographiques par défaut et satellites d’un client multigéographique. Quand votre solution personnalisée doit utiliser des sites SharePoint, et quand vous déployez des applications, il est important de tenir compte des emplacements géographiques existant dans votre client multigéographique.

Déployer des applications sur les clients multigéographiques

Quand vous déployez des applications, telles que des compléments SharePoint ou des composants WebPart côté client SharePoint basés sur SharePoint Framework, n’oubliez pas que les applications sont déployées au niveau de l’emplacement géographique.

Quand vous déployez une application sur l’emplacement géographique par défaut, cette application n’est pas disponible dans les emplacements géographiques satellites. Pour en savoir plus, consultez l’article relatif à la gestion des applications et des compléments dans un client multigéographique.

Nous vous recommandons de déployer et de mettre à jour vos applications d’entreprise dans tous les emplacements. Ainsi, tous les utilisateurs peuvent accéder à l’application.

Énumérer les collections de sites

Pour énumérer toutes les collections de sites du client, utilisez la méthode GetSitePropertiesFromSharePointByFilters du modèle CSOM sur une instance d’objet Tenant. Étant donné que chaque emplacement géographique dispose d’un centre d’administration client, vous devez énumérer les collections de sites par emplacement géographique et concaténer les résultats pour obtenir une liste unique de collections de sites à l’échelle du locataire.

Pour effectuer une énumération de site à l’échelle du client :

• Recherchez tous les emplacements géographiques et les URL des sites d’administration du client associées.
• Créez une boucle qui passe en revue tous les emplacements géographiques et crée un objet Tenant avec l’URL du site d’administration de l’emplacement géographique.
  • Utilisez l’appel de méthode GetSitePropertiesFromSharePointByFilters sur l’objet Tenant pour obtenir les collections de sites de cet emplacement géographique.
  • Ajoutez les collections de sites à une liste.
• Renvoyez la liste des collections de sites.

Pour en savoir plus, consultez l’exemple MultiGeo.SiteEnumeration.

Pour obtenir des informations complémentaires sur les autorisations et la configuration de votre application, consultez l’article relatif à la configuration d’un exemple d’application multigéographique.

Effectuer des opérations au niveau du client

L’objet Tenant sert également à configurer les paramètres au niveau du client, tels que les paramètres du réseau de distribution de contenu (CDN), ainsi que les paramètres du site au niveau du client, tels que la restriction liée à l’emplacement multigéographique du site. Pour effectuer des opérations au niveau du client :

• Recherchez tous les emplacements géographiques et les URL des sites d’administration du client associées.
• Pour mettre à jour les paramètres au niveau du client, passez en revue les emplacements géographiques et apportez les modifications nécessaires à chaque emplacement géographique.
• Pour mettre à jour les paramètres de site au niveau du client :
  • Utilisez la propriété GeoLocation de l’objet Site pour obtenir l’emplacement géographique du site.
  • Utilisez la méthode du client GetSitePropertiesByUrl pour obtenir le site, apporter des modifications et appeler Update sur l’objet SiteProperties récupéré.

Pour savoir comment obtenir un site à l’aide de la méthode GetSitePropertiesByUrl et empêcher le site d’être déplacé en définissant la propriété RestrictedToRegion, consultez l’exemple MultiGeo.RestrictSiteToGeoLocation.

Identifier les sites en enregistrant l’ID du site

Dans un client multigéographique, les sites peuvent être déplacés d’un emplacement géographique à l’autre, ce qui entraînera la modification de l’URL de ce site. Ainsi, nous vous déconseillons d’enregistrer l’URL du site comme clé unique pour identifier un site. Il est préférable d’enregistrer l’ID du site, car il ne change pas, quel que soit l’emplacement géographique où le site est hébergé.

Voir aussi

• OneDrive et SharePoint Online Multi-Géo