Configurer la recherche pour Microsoft 365 Multi-Geo

Configurer la recherche multigéographique

Votre locataire multigéographique disposera de fonctionnalités de recherche agrégée permettant à une requête de recherche de retourner des résultats à partir de n’importe où dans le locataire.

Par défaut, les recherches effectuées à partir de ces points d’entrée retournent des résultats agrégés, même si chaque index de recherche se trouve dans son emplacement Geography approprié :

• OneDrive
• Delve
• Page d’accueil SharePoint
• Centre de recherche

En outre, les fonctionnalités de recherche multigéographique peuvent être configurées pour vos applications de recherche personnalisées qui utilisent l’API de recherche SharePoint.

Consultez Configurer la recherche pour OneDrive Multi-Geo pour obtenir des instructions, y compris les limitations et les différences.

Validation de la configuration de Microsoft 365 Multi-Geo

Voici certains cas d’utilisation de base que vous pourriez vouloir inclure dans votre plan de validation avant de déployer à grande échelle Microsoft 365 Multi-Geo dans votre entreprise. Une fois que vous avez terminé ces tests et les cas d’utilisation supplémentaires éventuels et pertinents pour votre entreprise, vous pouvez choisir de commencer à ajouter des utilisateurs à votre groupe pilote initial.

OneDrive :

Sélectionnez OneDrive dans le lanceur d’applications Microsoft 365 et vérifiez que vous êtes automatiquement dirigé vers l’emplacement Géographique approprié pour l’utilisateur, en fonction du PDL de l’utilisateur. OneDrive doit maintenant commencer l’approvisionnement à cet emplacement. Après l’approvisionnement, essayez de charger et de télécharger quelques documents.

Application mobile OneDrive :

Connectez-vous à votre application mobile OneDrive avec vos informations d’identification de compte de test. Vérifiez que vous pouvez voir vos fichiers OneDrive et interagir avec eux à partir de votre appareil mobile.

Client de synchronisation OneDrive :

Vérifiez que le client de synchronisation OneDrive détecte automatiquement votre emplacement OneDrive Geography lors de la connexion. Si vous devez télécharger le client de synchronisation, vous pouvez cliquer sur Synchroniser dans la bibliothèque OneDrive.

Applications Office :

Vérifiez que vous pouvez accéder à OneDrive en vous connectant à partir d’une application Office, telle que Word. Ouvrez l’application Office et sélectionnez OneDrive – <TenantName>. Office détecte votre emplacement OneDrive et affiche les fichiers que vous pouvez ouvrir.

Partage:

Essayez de partager des fichiers OneDrive. Vérifiez que le sélecteur de personnes affiche tous vos utilisateurs SharePoint, quel que soit leur emplacement géographique .

Dans un environnement multigéographique, chaque emplacement Geography a son propre index de recherche et son propre centre de recherche. Lorsqu’un utilisateur effectue une recherche, la requête est distribuée à tous les index et les résultats renvoyés sont fusionnés.

Par exemple, un utilisateur dans un emplacement Geography peut rechercher du contenu stocké dans un autre emplacement Geography , ou du contenu sur un site SharePoint limité à un autre emplacement Geography. Si l’utilisateur a accès à ce contenu, la recherche affiche le résultat.

Quels clients de recherche fonctionnent dans un environnement multigéographique ?

Ces clients peuvent retourner les résultats de tous les emplacements Geography :

• OneDrive
• Delve
• Page d’accueil SharePoint
• Centre de recherche
• Applications de recherche personnalisée qui utilisent l’API de recherche SharePoint

OneDrive

Dès que l’environnement multigéographique a été configuré, les utilisateurs qui effectuent une recherche dans OneDrive obtiennent les résultats de tous les emplacements Geography .

Delve

Dès que l’environnement multigéographique a été configuré, les utilisateurs qui effectuent une recherche dans Delve obtiennent les résultats de tous les emplacements Geography .

Le flux Delve et la fiche de profil n’affichent que les aperçus de fichiers stockés dans l’emplacement central. Pour les fichiers stockés dans des emplacements géographiques satellites , l’icône du type de fichier s’affiche à la place.

Page d’accueil SharePoint

Dès que l’environnement multigéographique a été configuré, les utilisateurs verront les actualités, les sites récents et suivis de plusieurs emplacements Geography sur leur page d’accueil SharePoint. S’ils utilisent la zone de recherche de la page d’accueil SharePoint, ils obtiendront des résultats fusionnés à partir de plusieurs emplacements Geography .

Centre de recherche

Une fois l’environnement multigéographique configuré, chaque centre de recherche continue d’afficher uniquement les résultats de son propre emplacement géographique . Les administrateurs doivent modifier les paramètres de chaque centre de recherche pour obtenir les résultats de tous les emplacements Geography . Ensuite, les utilisateurs qui effectuent une recherche dans le Centre de recherche obtiennent les résultats de tous les emplacements Geography .

Applications de recherche personnalisée

Comme d’habitude, les applications de recherche personnalisées interagissent avec les index de recherche à l’aide des API REST recherche SharePoint existantes. Pour obtenir des résultats à partir de tous ou de certains emplacements Geography , l’application doit appeler l’API et inclure les nouveaux paramètres de requête multigéographique dans la requête. Cela déclenche un ventilateur hors de la requête vers tous les emplacements Geography .

Qu’est-ce qui diffère de la recherche dans un environnement multigéographique ?

Certaines fonctionnalités de recherche auxquelles vous êtes habitué fonctionnent différemment dans un environnement multigéographique.

Quels sont les éléments qui ne sont pas pris en charge par la recherche dans un environnement multigéographique ?

Certaines fonctionnalités de recherche auxquelles vous êtes habitué ne sont pas prises en charge dans un environnement multigéographique.

Comment fonctionne la recherche dans un environnement Multi-Géo ?

Tous les clients de recherche utilisent les API REST de recherche SharePoint existantes pour interagir avec les index de recherche.

1. Un client de recherche appelle le point de terminaison REST de recherche avec la propriété de requête EnableMultiGeoSearch= true.
2. La requête est envoyée à tous les emplacements Geography dans le locataire.
3. Les résultats de la recherche de chaque emplacement Geography sont fusionnés et classés.
4. Le client obtient des résultats de recherche unifiés.

Notez que nous ne fusionnons pas les résultats de recherche avant d’avoir reçu les résultats de tous les emplacements géographiques. Cela signifie que les recherches géographiques multiples souffrent d’une latence supplémentaire par rapport aux recherches dans un environnement ne comportant qu’un seul emplacement géographique.

Obtenir un centre de recherche pour afficher les résultats de tous les emplacements géographiques

Chaque centre de recherche possède plusieurs secteurs verticaux et vous devez configurer chaque secteur vertical individuellement.

1. Vérifiez que vous effectuez ces étapes avec un compte doté d’autorisations pour modifier la page des résultats de la recherche et le composant WebPart Search Result.

2. Accédez à la page des résultats de la recherche (reportez-vous à la liste des pages des résultats de la recherche)

3. Sélectionnez le vertical à configurer, cliquez sur l’icône d’engrenage Paramètres dans le coin supérieur droit, puis cliquez sur Modifier la page. La page en question s’affiche en mode Édition.

   

4. Dans le composant WebPart de résultats de recherche, déplacez le pointeur vers le coin supérieur droit et cliquez sur la flèche, puis sur Modifier le composant WebPart dans le menu. Le volet des outils du composant WebPart des résultats de recherche s’ouvre sous le ruban en haut à droite de la page.

   

5. Dans le volet des outils du composant WebPart, dans la section Paramètres, sous Paramètres de contrôle des résultats, sélectionnez Afficher les résultats multigéographiques pour que le composant WebPart Résultats de la recherche affiche les résultats de tous les emplacements géographiques.

6. Cliquez sur OK pour enregistrer vos changements et fermer le volet des outils du composant WebPart.

7. Vérifiez les changements que vous avez apportés au composant WebPart Résultats de la recherche en cliquant sur Archiver sur l’onglet Page du menu principal.

8. Publiez les changements en utilisant le lien fourni dans la note en haut de la page.

Configurer des applications de recherche personnalisée pour qu’elles affichent les résultats de l’ensemble ou d’une partie des emplacements géographiques

Les applications de recherche personnalisée obtiennent les résultats de tous ou de certains emplacements Geography en spécifiant des paramètres de requête avec la requête adressée à l’API REST Recherche SharePoint. Selon les paramètres de requête, la requête est étendue à tous les emplacements Geography ou à certains emplacements géographiques. Par exemple, si vous avez uniquement besoin d’interroger un sous-ensemble d’emplacements Geography pour trouver des informations pertinentes, vous pouvez contrôler le ventilateur uniquement sur ceux-ci. Si la demande réussit, l’API REST Recherche SharePoint retourne les données de réponse.

Conditions requises

Pour chaque emplacement géographique, vous devez vous assurer que tous les utilisateurs de l’organisation ont reçu l’autorisation de lecture du site web racine (par exemple contosoAPAC.sharepoint.com/ et contosoEU.sharepoint.com/). En savoir plus sur les autorisations.

Paramètres de requête

EnableMultiGeoSearch : il s’agit d’une valeur booléenne qui spécifie si la requête doit être étendue aux index d’autres emplacements géographiques du locataire multigéographique. Définissez-la sur true pour étendre la requête et sur false pour ne pas l’étendre. Si vous n’incluez pas ce paramètre, la valeur par défaut est false, sauf lorsque vous effectuez un appel de l’API REST contre un site qui utilise le modèle Centre de recherche d’entreprise, dans ce cas, la valeur par défaut est true. Si vous utilisez ce paramètre dans un environnement qui n’est pas multigéographique, le paramètre est ignoré.

TypeClient : il s’agit d’une chaîne. Entrez un nom de client unique pour chaque application de recherche. Si vous n’incluez pas ce paramètre, la requête n’est pas étendue à d’autres emplacements géographiques.

MultiGeoSearchConfiguration : il s’agit d’une liste facultative des emplacements géographiques dans le locataire multigéographique vers lequel la requête doit être exécutée lorsque EnableMultiGeoSearch a lavaleur true. Si vous n’incluez pas ce paramètre ou que vous le laissez vide, la requête est étendue à d’autres emplacements géographiques. Pour chaque emplacement géographique, entrez les éléments suivants au format JSON :

Si vous omettez DataLocation ou EndPoint, ou si un DataLocation est dupliqué, la requête échoue. Vous pouvez obtenir des informations sur le point de terminaison des emplacements géographiques d’un locataire à l’aide de Microsoft Graph.

Données de réponse

MultiGeoSearchStatus : il s’agit d’une propriété que l’API Recherche SharePoint retourne en réponse à une requête. La valeur de la propriété est une chaîne et fournit les informations suivantes sur les résultats retournés par l’API Recherche SharePoint :

Requête à l’aide du service REST

Avec une requête GET, vous indiquez les paramètres de requête dans l'URL. Avec une requête POST, vous transmettez les paramètres de requête dans le corps au format JSON (JavaScript Object Notation).

En-têtes de demande

Exemple de demande GET étendue à tous les emplacements géographiques

https://<tenant>/_api/search/query?querytext='sharepoint'&Properties='EnableMultiGeoSearch:true'&ClientType='my_client_id'

Exemple de demande GET à distribuer à certains emplacements géographiques

https://<tenant>/_api/search/query?querytext='site'&ClientType='my_client_id'&Properties='EnableMultiGeoSearch:true, MultiGeoSearchConfiguration:[{DataLocation\\:"NAM"\\,Endpoint\\:"https\\://contosoNAM.sharepoint.com"\\,SourceId\\:"B81EAB55-3140-4312-B0F4-9459D1B4FFEE"}\\,{DataLocation\\:"CAN"\\,Endpoint\\:"https\\://contosoCAN.sharepoint-df.com"}]'

Exemple de demande POST étendue à tous les emplacements géographiques

    {
    "request": {
            "__metadata": {
            "type": "Microsoft.Office.Server.Search.REST.SearchRequest"
        },
        "Querytext": "sharepoint",
        "Properties": {
            "results": [
                {
                    "Name": "EnableMultiGeoSearch",
                    "Value": {
                        "QueryPropertyValueTypeIndex": 3,
                        "BoolVal": true
                    }
                }
            ]
        },
        "ClientType": "my_client_id"
        }
    }

Exemple de demande POST étendue à certains emplacements géographiques

    {
        "request": {
            "Querytext": "SharePoint",
            "ClientType": "my_client_id",
            "Properties": {
                "results": [
                    {
                        "Name": "EnableMultiGeoSearch",
                        "Value": {
                            "QueryPropertyValueTypeIndex": 3,
                            "BoolVal": true
                        }
                    },
                    {
                        "Name": "MultiGeoSearchConfiguration",
                        "Value": {
                        "StrVal": "[{\"DataLocation\":\"NAM\",\"Endpoint\":\"https://contoso.sharepoint.com\",\"SourceId\":\"B81EAB55-3140-4312-B0F4-9459D1B4FFEE\"},{\"DataLocation\":\"CAN\",\"Endpoint\":\"https://contosoCAN.sharepoint.com\"}]",
                            "QueryPropertyValueTypeIndex": 1
                        }
                    }
                ]
            }
        }
    }

Requête utilisant CSOM

Voici un exemple de requête CSOM qui est étendue à tous les emplacements Geography :

var keywordQuery = new KeywordQuery(ctx);
keywordQuery.QueryText = query.SearchQueryText;
keywordQuery.ClientType = <enter a string here>;
keywordQuery.Properties["EnableMultiGeoSearch"] = true;