Configurare la ricerca di Microsoft 365 Multi-Geo

Configurare la ricerca multi-geografica

Il tenant multi-geografico avrà funzionalità di ricerca aggregate che consentono a una query di ricerca di restituire risultati da qualsiasi posizione all'interno del tenant.

Per impostazione predefinita, le ricerche da questi punti di ingresso restituiscono risultati aggregati, anche se ogni indice di ricerca si trova all'interno della posizione geografica pertinente:

• OneDrive
• Delve
• Home page di SharePoint
• Centro ricerche

Inoltre, le funzionalità di ricerca multi-geo possono essere configurate per le applicazioni di ricerca personalizzate che usano l'API di ricerca di SharePoint.

Vedere Configurare la ricerca per OneDrive Multi-Geo per istruzioni che includono eventuali limitazioni e differenze.

Convalida della configurazione di Microsoft 365 Multi-Geo

Ecco alcuni casi di utilizzo di base che è opportuno includere nel piano di convalida prima della distribuzione di Microsoft 365 Multi-Geo su vasta scala all'interno dell'azienda. Dopo aver completato i test e i casi di utilizzo aggiuntivi di interesse per l'azienda, è possibile procedere con l'aggiunta di utenti nel gruppo pilota iniziale.

OneDrive:

Selezionare OneDrive dall'icona di avvio delle app di Microsoft 365 e verificare di essere indirizzati automaticamente alla posizione geografica appropriata per l'utente, in base al file PDL dell'utente. OneDrive dovrebbe ora iniziare il provisioning in tale posizione. Una volta effettuato il provisioning, provare a caricare e scaricare alcuni documenti.

App OneDrive Per dispositivi mobili:

Accedere all'app onedrive per dispositivi mobili con le credenziali dell'account di test. Verificare che sia possibile visualizzare i file di OneDrive e interagire con essi dal dispositivo mobile.

sincronizzazione OneDrive client:

Verificare che il client sincronizzazione OneDrive rilevi automaticamente la posizione geografica di OneDrive all'accesso. Se è necessario scaricare il client di sincronizzazione, è possibile fare clic su Sincronizza nella libreria di OneDrive.

Applicazioni di Office:

Verificare che sia possibile accedere a OneDrive accedendo da un'applicazione di Office, ad esempio Word. Aprire l'applicazione di Office e selezionare OneDrive - <TenantName>. Office rileverà la posizione di OneDrive e mostrerà i file che è possibile aprire.

Condivisione:

Provare a condividere i file di OneDrive. Verificare che la selezione utenti mostri tutti gli utenti di SharePoint indipendentemente dalla posizione geografica .

In un ambiente multi-geografico, ogni posizione Geography ha il proprio indice di ricerca e centro ricerche. Quando un utente effettua una ricerca, la query viene inviata a tutti gli indici e i risultati restituiti vengono aggregati.

Ad esempio, un utente in una posizione Geography può cercare il contenuto archiviato in un'altra posizione Geography o per il contenuto in un sito di SharePoint limitato a una posizione geografica diversa. Se l'utente ha accesso a tale contenuto, la ricerca mostrerà il risultato.

Quali client di ricerca funzionano in un ambiente multi-geografico?

Questi client possono restituire risultati da tutte le posizioni Geography:

• OneDrive
• Delve
• Home page di SharePoint
• Centro ricerche
• Applicazioni di ricerca personalizzate che utilizzano l'API del servizio di ricerca di SharePoint

OneDrive

Non appena l'ambiente Multi-Geo è stato configurato, gli utenti che cercano in OneDrive ottengono risultati da tutte le posizioni geography .

Delve

Non appena l'ambiente Multi-Geo è stato configurato, gli utenti che cercano in Delve ottengono risultati da tutte le posizioni geography .

Il feed di Delve e la scheda profilo mostrano solo le anteprime dei file archiviati in una posizione centrale. Per i file archiviati in posizioni geografiche satellite , viene invece visualizzata l'icona per il tipo di file.

Home page di SharePoint

Non appena l'ambiente Multi-Geo è stato configurato, gli utenti visualizzeranno notizie, siti recenti e seguiti da più posizioni geography nella home page di SharePoint. Se usano la casella di ricerca nella home page di SharePoint, otterranno risultati uniti da più posizioni geography .

Centro ricerche

Dopo aver configurato l'ambiente multi-geografico, ogni Centro ricerche continua a visualizzare solo i risultati della propria posizione geografica . Gli amministratori devono modificare le impostazioni di ogni Centro ricerche per ottenere risultati da tutte le posizioni geography . Successivamente, gli utenti che cercano nel Centro ricerche ottengono risultati da tutte le posizioni geography .

Applicazioni di ricerca personalizzate

Come di consueto, le applicazioni di ricerca personalizzate interagiscono con gli indici di ricerca usando le API REST di ricerca di SharePoint esistenti. Per ottenere risultati da tutte o da alcune posizioni Geography , l'applicazione deve chiamare l'API e includere i nuovi parametri di query Multi-Geo nella richiesta. In questo modo viene attivato un ventola fuori dalla query in tutte le posizioni Geography .

Cosa c'è di diverso nella ricerca in un ambiente multi-geografico?

Alcune delle funzionalità di ricerca già note potrebbero funzionare diversamente in un ambiente multi-geografico.

Cosa non è supportato per la ricerca in un ambiente multi-geografico?

Alcune delle funzionalità di ricerca già note non sono supportate in un ambiente multi-geografico.

Come funziona la ricerca in un ambiente multi-geografico?

Tutti i client di ricerca usano le API REST del servizio di ricerca di SharePoint per interagire con gli indici di ricerca.

1. Un client di ricerca chiama l'endpoint REST Ricerca con la proprietà di query EnableMultiGeoSearch= true.
2. La query viene inviata a tutte le posizioni Geography nel tenant.
3. I risultati della ricerca di ogni posizione Geography vengono uniti e classificati.
4. Il client ottiene risultati della ricerca unificati.

Si noti che Microsoft non unisce i risultati della ricerca fino a quando non si ricevono i risultati da tutte le posizioni geografiche. Questo significa che le ricerche multi-geo hanno una latenza maggiore rispetto alle ricerche in un ambiente che ha una sola posizione geografica.

Fare in modo che un Centro ricerche mostri i risultati di tutte le posizioni geografiche

Ogni Centro ricerche dispone di diverse verticali ed è necessario configurarle singolarmente.

1. Assicurarsi di avere eseguito questi passaggi con un account che dispone dell'autorizzazione per modificare la pagina dei risultati della ricerca e la web part Risultati della ricerca.

2. Andare alla pagina dei risultati della ricerca (vedere l'elenco delle pagine di risultati della ricerca).

3. Selezionare la verticale da configurare, fare clic sull'icona a ingranaggio Impostazioni nell'angolo superiore destro e quindi fare clic su Modifica pagina. La pagina dei risultati di ricerca verrà aperta in modalità di modifica.

   

4. Nella web part Risultati della ricerca, spostare il puntatore sull'angolo in alto a destra della web part, fare clic sulla freccia, quindi fare clic su Modifica web part nel menu. Si apre il riquadro degli strumenti della web part Risultati della ricerca sotto la barra multifunzione in alto a destra nella pagina.

   

5. Nella riquadro degli strumenti della web part, nella sezione Impostazioni, in Impostazioni controllo risultati, selezionare Mostra risultati Multi-Geo affinché la web part Risultati della ricerca mostri i risultati di tutte le posizioni geografiche.

6. Fare clic su OK per salvare la modifica e chiudere il riquadro degli strumenti della web part.

7. Verificare le modifiche apportate alla web part Risultati della ricerca facendo clic su Controllo nella scheda Pagina del menu principale.

8. Pubblicare le modifiche usando il collegamento fornito nella nota in alto nella pagina.

Fare in modo che le applicazioni di ricerca personalizzate mostrino risultati di tutte o di alcune posizioni geografiche

Le applicazioni di ricerca personalizzate ottengono risultati da tutte o alcune posizioni Geography specificando i parametri di query con la richiesta all'API REST di Ricerca di SharePoint. A seconda dei parametri della query, la query viene eseguita in tutte le posizioni Geography o in alcune posizioni geografiche. Ad esempio, se è sufficiente eseguire una query su un subset di posizioni Geography per trovare informazioni rilevanti, è possibile controllare la ventola solo su questi. Se la richiesta ha esito positivo, l'API REST di ricerca di SharePoint restituisce i dati della risposta.

Requisito

Per ogni posizione geografica, è necessario assicurarsi che a tutti gli utenti dell'organizzazione sia stato concesso il livello di autorizzazione Lettura per il sito Web radice, ad esempio contosoAPAC.sharepoint.com/ e contosoEU.sharepoint.com/. Informazioni sulle autorizzazioni.

Parametri di query

EnableMultiGeoSearch: valore booleano che specifica se la query deve essere eseguita sugli indici di altre posizioni geografiche del tenant multi-geografico. Impostare su true per estendere la query, su false per non estendere la query. Se non si include questo parametro, il valore predefinito è false, tranne quando si esegue una chiamata all'API REST su un sito che usa il modello Centro ricerche organizzazione. In tal caso, il valore predefinito è true. Se si usa questo parametro in un ambiente non multi-geografico, il parametro viene ignorato.

ClientType - Questa è una stringa. Immettere un nome univoco di client per ogni applicazione di ricerca. Se non si include questo parametro, la query non viene estesa a diverse posizioni geografiche.

MultiGeoSearchConfiguration: si tratta di un elenco facoltativo delle posizioni geografiche nel tenant multi-geografico a cui eseguire la query quando EnableMultiGeoSearch è true. Se non si include questo parametro o lo si lascia vuoto, la query non viene estesa a diverse posizioni geografiche. Per ogni posizione geografica, immettere quanto segue, in formato JSON:

Se si omette DataLocation o EndPoint o se un oggetto DataLocation è duplicato, la richiesta ha esito negativo. È possibile ottenere informazioni sull'endpoint delle posizioni geografiche di un tenant usando Microsoft Graph.

Dati di risposta

MultiGeoSearchStatus: proprietà restituita dall'API di ricerca di SharePoint in risposta a una richiesta. Il valore della proprietà è una stringa e fornisce le informazioni seguenti sui risultati restituiti dall'API di ricerca di SharePoint:

Query che usa il servizio REST

Con una richiesta GET, specificare i parametri di query nell'URL. Con una richiesta POST, si passano i parametri di query nel corpo in formato JSON (JavaScript Object Notation).

Intestazioni di richiesta

Esempio di richiesta GET estesa a tutte le posizioni geografiche

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

Esempio di richiesta GET estesa ad alcune posizioni geografiche

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"}]'

Esempio di richiesta POST estesa a tutte le posizioni geografiche

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

Esempio di richiesta POST estesa ad alcune posizioni geografiche

    {
        "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
                        }
                    }
                ]
            }
        }
    }

Query che usa CSOM

Ecco una query CSOM di esempio eseguita in tutte le posizioni geography:

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