Konfigurowanie wyszukiwania wielu obszarów geograficznych platformy Microsoft 365

Artykuł
07/26/2024

Konfigurowanie wyszukiwania z wieloma lokalizacjami geograficznymi

Dzierżawa z wieloma lokalizacjami geograficznymi będzie miała zagregowane możliwości wyszukiwania, dzięki czemu zapytanie wyszukiwania będzie zwracać wyniki z dowolnego miejsca w dzierżawie.

Domyślnie wyszukiwania z tych punktów wejścia będą zwracać zagregowane wyniki, mimo że każdy indeks wyszukiwania znajduje się w odpowiedniej lokalizacji geografii :

OneDrive
Wkrocz
Strona główna programu SharePoint
Centrum wyszukiwania

Ponadto funkcje wyszukiwania wielu geograficznych można skonfigurować dla niestandardowych aplikacji wyszukiwania korzystających z interfejsu API wyszukiwania programu SharePoint.

Aby uzyskać instrukcje, w tym wszelkie ograniczenia i różnice, zapoznaj się z artykułem Configure Search for OneDrive Multi-Geo (Konfigurowanie wyszukiwania w usłudze OneDrive Multi-Geo ).

Weryfikowanie konfiguracji usługi Microsoft 365 Multi-Geo

Poniżej przedstawiono kilka podstawowych przypadków użycia, które warto uwzględnić w planie weryfikacji przed ogólnym wdrożeniem rozwiązania Microsoft 365 Multi-Geo w firmie. Po zakończeniu tych testów i wszelkich dodatkowych przypadkach użycia, które są istotne dla Twojej firmy, możesz przejść do dodawania użytkowników w początkowej grupie pilotażowej.

OneDrive:

Wybierz pozycję OneDrive w programie uruchamiania aplikacji platformy Microsoft 365 i upewnij się, że nastąpi automatyczne przekierowanie do odpowiedniej lokalizacji geografii dla użytkownika na podstawie biblioteki PDL użytkownika. Usługa OneDrive powinna teraz rozpocząć aprowizację w tej lokalizacji. Po aprowizowaniu spróbuj przekazać i pobrać niektóre dokumenty.

Aplikacja mobilna OneDrive:

Zaloguj się do aplikacji mobilnej OneDrive przy użyciu poświadczeń konta testowego. Upewnij się, że widzisz pliki usługi OneDrive i możesz wchodzić z nimi w interakcje z urządzenia przenośnego.

Klient synchronizacji usługi OneDrive:

Upewnij się, że klient synchronizacji usługi OneDrive automatycznie wykrywa lokalizację geografii usługi OneDrive podczas logowania. Jeśli musisz pobrać klienta synchronizacji, możesz kliknąć pozycję Synchronizuj w bibliotece usługi OneDrive.

Aplikacje pakietu Office:

Upewnij się, że możesz uzyskać dostęp do usługi OneDrive, logując się z poziomu aplikacji pakietu Office, takiej jak Word. Otwórz aplikację pakietu Office i wybierz pozycję OneDrive — <TenantName>. Pakiet Office wykryje lokalizację usługi OneDrive i wyświetli pliki, które można otworzyć.

Udostępnianie:

Spróbuj udostępnić pliki usługi OneDrive. Upewnij się, że selektor osób wyświetla wszystkich użytkowników programu SharePoint niezależnie od ich lokalizacji geograficznej .

W środowisku z wieloma lokalizacjami geograficznymi każda lokalizacja geograficzna ma własny indeks wyszukiwania i Centrum wyszukiwania. Gdy użytkownik wyszukuje, zapytanie jest rozsyłane do wszystkich indeksów, a zwrócone wyniki są scalane.

Na przykład użytkownik w jednej lokalizacji geografii może wyszukiwać zawartość przechowywaną w innej lokalizacji geografii lub zawartość w witrynie programu SharePoint, która jest ograniczona do innej lokalizacji geografii. Jeśli użytkownik ma dostęp do tej zawartości, wyszukiwanie będzie wyświetlać wynik.

Którzy klienci wyszukiwania działają w środowisku z wieloma lokalizacjami geograficznymi?

Ci klienci mogą zwracać wyniki ze wszystkich lokalizacji geografii:

OneDrive
Wkrocz
Strona główna programu SharePoint
Centrum wyszukiwania
Niestandardowe aplikacje wyszukiwania korzystające z interfejsu API wyszukiwania programu SharePoint

OneDrive

Po skonfigurowaniu środowiska Multi-Geo użytkownicy, którzy szukają danych w usłudze OneDrive, uzyskują wyniki ze wszystkich lokalizacji geografii .

Wkrocz

Po skonfigurowaniu środowiska Multi-Geo użytkownicy, którzy szukają danych w aplikacji Delve, uzyskują wyniki ze wszystkich lokalizacji geografii .

Kanał informacyjny Delve i karta profilu wyświetlają tylko podglądy plików przechowywanych w centralnej lokalizacji. W przypadku plików przechowywanych w lokalizacjach geografii satelitarnej zamiast tego jest wyświetlana ikona typu pliku.

Strona główna programu SharePoint

Po skonfigurowaniu środowiska Multi-Geo użytkownicy będą widzieć wiadomości, najnowsze i obserwowane witryny z wielu lokalizacji geografii na stronie głównej programu SharePoint. Jeśli użyją pola wyszukiwania na stronie głównej programu SharePoint, uzyskają scalone wyniki z wielu lokalizacji geografii .

Centrum wyszukiwania

Po skonfigurowaniu środowiska z wieloma lokalizacjami geograficznymi każde Centrum wyszukiwania nadal wyświetla wyniki tylko z własnej lokalizacji geografii . Administratorzy muszą zmienić ustawienia każdego centrum wyszukiwania , aby uzyskać wyniki ze wszystkich lokalizacji geografii . Następnie użytkownicy, którzy szukają w Centrum wyszukiwania, uzyskują wyniki ze wszystkich lokalizacji geografii .

Niestandardowe aplikacje wyszukiwania

Jak zwykle niestandardowe aplikacje wyszukiwania wchodzą w interakcje z indeksami wyszukiwania przy użyciu istniejących interfejsów API REST usługi SharePoint Search. Aby uzyskać wyniki ze wszystkich lub niektórych lokalizacji geografii , aplikacja musi wywołać interfejs API i uwzględnić nowe parametry zapytania multi-Geo w żądaniu. Spowoduje to wyzwolenie wentylatora z zapytania do wszystkich lokalizacji geografii .

Czym różni się wyszukiwanie w środowisku z wieloma lokalizacjami geograficznymi?

Niektóre funkcje wyszukiwania, które mogą być znane, działają inaczej w środowisku z wieloma obszarami geograficznymi.

Funkcja	Jak to działa	Obejście problemu
Promowane wyniki	Reguły zapytań można tworzyć z promowanymi wynikami na różnych poziomach: dla całego _Tenant_, zbioru witryn lub witryny. W środowisku z wieloma lokalizacjami geograficznymi zdefiniuj promowane wyniki na poziomie _Tenant_, aby podwyższyć poziom wyników do centrów wyszukiwania we wszystkich lokalizacjach _Geography_. Jeśli chcesz promować tylko wyniki w Centrum wyszukiwania, które znajduje się w lokalizacji _Geography_ zbioru witryn lub witryny, zdefiniuj promowane wyniki na poziomie zbioru witryn lub witryny. Te wyniki nie są promowane w innych lokalizacjach _Geography_.	Jeśli nie potrzebujesz różnych podwyższania poziomu wyników dla lokalizacji _Geography_, na przykład różnych reguł podróży, zalecamy zdefiniowanie promowane wyniki na poziomie _Tenant_.
Wyszukiwanie elementów uściślania	Funkcja wyszukiwania zwraca elementy uściślacze ze wszystkich lokalizacji _Geography_ elementu _Tenant_, a następnie agreguje je. Agregacja to najlepszy wysiłek, co oznacza, że liczba elementów uściślających może nie być w 100% dokładna. W przypadku większości scenariuszy opartych na wyszukiwaniu ta dokładność jest wystarczająca.	W przypadku aplikacji opartych na wyszukiwaniu, które zależą od kompletności elementu uściślającego, należy niezależnie wykonywać zapytania względem każdej lokalizacji _Geography_.
	Wyszukiwanie wielu obszarów geograficznych nie obsługuje dynamicznego zasobnika dla elementów uściślających numeryczne.	Użyj parametru "Discretize" dla elementów uściślania liczbowego.
Identyfikatory dokumentów	Jeśli tworzysz aplikację opartą na wyszukiwaniu, która zależy od identyfikatorów dokumentów, należy pamiętać, że identyfikatory dokumentów w środowisku z wieloma lokalizacjami geograficznymi nie są unikatowe w lokalizacjach _Geography_, są unikatowe dla lokalizacji _Geography_.	Dodaliśmy kolumnę identyfikującą lokalizację _Geography_. Użyj tej kolumny, aby osiągnąć unikatowość. Ta kolumna nosi nazwę "GeoLocationSource".
Liczba wyników	Na stronie wyników wyszukiwania są wyświetlane połączone wyniki z lokalizacji _Geography_, ale nie można stronicować ponad 500 wyników.
Wyszukiwanie hybrydowe	W środowisku hybrydowego programu SharePoint z wyszukiwaniem hybrydowym w chmurze zawartość lokalna jest dodawana do indeksu usługi Microsoft 365 centralnej lokalizacji.

Co nie jest obsługiwane w przypadku wyszukiwania w środowisku z wieloma lokalizacjami geograficznymi?

Niektóre funkcje wyszukiwania, które mogą być znane, nie są obsługiwane w środowisku obejmującym wiele obszarów geograficznych.

Funkcja wyszukiwania	Uwaga
Uwierzytelnianie tylko dla aplikacji	Uwierzytelnianie tylko dla aplikacji (uprzywilejowany dostęp z usług) nie jest obsługiwane w wyszukiwaniu wielu obszarach geograficznych.
Gości	Goście otrzymują tylko wyniki z lokalizacji _Geography_, z której szukają.

Jak działa wyszukiwanie w środowisku z wieloma lokalizacjami geograficznymi?

Wszyscy klienci wyszukiwania używają istniejących interfejsów API REST wyszukiwania programu SharePoint do interakcji z indeksami wyszukiwania.

Klient wyszukiwania wywołuje punkt końcowy REST wyszukiwania z właściwością zapytania EnableMultiGeoSearch= true.
Zapytanie jest wysyłane do wszystkich lokalizacji geografii w dzierżawie.
Wyniki wyszukiwania z każdej lokalizacji geografii są scalane i klasyfikowane.
Klient uzyskuje ujednolicone wyniki wyszukiwania.

Zwróć uwagę, że wyniki wyszukiwania nie są scalane, dopóki nie otrzymamy wyników ze wszystkich lokalizacji geograficznych. Oznacza to, że wyszukiwanie w wielu obszarach geograficznych ma dodatkowe opóźnienie w porównaniu z wyszukiwaniami w środowisku z tylko jedną lokalizacją geograficzną.

Uzyskiwanie Centrum wyszukiwania w celu wyświetlenia wyników ze wszystkich lokalizacji geograficznych

Każde centrum wyszukiwania ma kilka pionów i należy skonfigurować poszczególne pionowe osobno.

Upewnij się, że wykonasz te kroki przy użyciu konta, które ma uprawnienia do edytowania strony wyników wyszukiwania i składnika Web Part wyników wyszukiwania.
Przejdź do strony wyników wyszukiwania (zobacz listę stron wyników wyszukiwania)
Wybierz pionową do skonfigurowania, kliknij ikonę koła zębatego Ustawienia w prawym górnym rogu, a następnie kliknij pozycję Edytuj stronę. Strona wyników wyszukiwania zostanie otwarta w trybie edycji.
W składniku Web Part Wyniki wyszukiwania przenieś wskaźnik do górnego, prawego rogu składnika Web Part, kliknij strzałkę, a następnie kliknij pozycję Edytuj składnik Web Part w menu. Okienko narzędzia Składnik Web Part wyników wyszukiwania zostanie otwarte pod wstążką w prawym górnym rogu strony.
W okienku narzędzi składników Web Part w sekcji Ustawienia w obszarze Ustawienia kontrolki Wyniki wybierz pozycję Pokaż wyniki z wieloma lokalizacjami geograficznymi , aby pobrać składnik Web Part Wyniki wyszukiwania, aby wyświetlić wyniki ze wszystkich lokalizacji geograficznych.
Kliknij przycisk OK , aby zapisać zmianę i zamknąć okienko narzędzi składnika Web Part.
Sprawdź zmiany w składniku Web Part Wyniki wyszukiwania, klikając pozycję Zaewidencjonuj na karcie Strona menu głównego.
Opublikuj zmiany za pomocą linku podane w notatce w górnej części strony.

Pobieranie niestandardowych aplikacji wyszukiwania w celu wyświetlenia wyników ze wszystkich lub niektórych lokalizacji geograficznych

Niestandardowe aplikacje wyszukiwania pobierają wyniki ze wszystkich lub niektórych lokalizacji geografii , określając parametry zapytania za pomocą żądania do interfejsu API REST wyszukiwania programu SharePoint. W zależności od parametrów zapytania zapytanie jest rozsyłane do wszystkich lokalizacji geografii lub do niektórych lokalizacji geograficznych. Jeśli na przykład wystarczy wykonać zapytanie dotyczące podzestawu lokalizacji geografii w celu znalezienia odpowiednich informacji, możesz kontrolować wentylator tylko do tych. Jeśli żądanie zakończy się pomyślnie, interfejs API REST wyszukiwania programu SharePoint zwróci dane odpowiedzi.

Wymaganie

Dla każdej lokalizacji geograficznej należy upewnić się, że wszystkim użytkownikom w organizacji przyznano poziom uprawnień odczytu dla głównej witryny internetowej (na przykład contosoAPAC.sharepoint.com/ i contosoEU.sharepoint.com/). Dowiedz się więcej o uprawnieniach.

Parametry zapytania

EnableMultiGeoSearch — jest to wartość logiczna określająca, czy zapytanie ma zostać wyparte na indeksy innych lokalizacji geograficznych dzierżawy z wieloma lokalizacjami geograficznymi. Ustaw ją na wartość true , aby wyświetlić zapytanie; false , aby nie wyszukiwać zapytania. Jeśli nie uwzględnisz tego parametru, wartość domyślna to false, z wyjątkiem wywołania interfejsu API REST względem witryny korzystającej z szablonu Centrum wyszukiwania przedsiębiorstwa, w tym przypadku wartość domyślna ma wartość true. Jeśli używasz parametru w środowisku, które nie jest multi-geo, parametr jest ignorowany.

ClientType — jest to ciąg. Wprowadź unikatową nazwę klienta dla każdej aplikacji wyszukiwania. Jeśli ten parametr nie zostanie dołączony, zapytanie nie zostanie przełączane do innych lokalizacji geograficznych.

MultiGeoSearchConfiguration — jest to opcjonalna lista lokalizacji geograficznych w dzierżawie z wieloma obszarami geograficznymi, na których ma zostać wyświetlone zapytanie, gdy właściwość EnableMultiGeoSearch ma wartość true. Jeśli nie uwzględnisz tego parametru lub pozostawisz go pustym, zapytanie zostanie przesuwzone do wszystkich lokalizacji geograficznych. Dla każdej lokalizacji geograficznej wprowadź następujące elementy w formacie JSON:

Element	Opis
DataLocation	Lokalizacja _Geography_, na przykład NAM.
Punkt końcowy	Punkt końcowy do nawiązania połączenia, na przykład https://contoso.sharepoint.com
Identyfikator źródła	Identyfikator GUID źródła wyników, na przykład B81EAB55-3140-4312-B0F4-9459D1B4FFEE.

Jeśli pominięto pozycję DataLocation lub EndPoint lub jeśli datalocation zostanie zduplikowana, żądanie zakończy się niepowodzeniem. Informacje o punkcie końcowym lokalizacji geograficznych dzierżawy można uzyskać za pomocą programu Microsoft Graph.

Dane odpowiedzi

MultiGeoSearchStatus — jest to właściwość zwracana przez interfejs API wyszukiwania programu SharePoint w odpowiedzi na żądanie. Wartość właściwości jest ciągiem i zawiera następujące informacje o wynikach zwracanych przez interfejs API wyszukiwania programu SharePoint:

Value	Opis
Pełny	Pełne wyniki ze wszystkich lokalizacji _Geography_.
Częściowy	Częściowe wyniki z co najmniej jednej lokalizacji _Geography_. Wyniki są niekompletne z powodu błędu przejściowego.

Wykonywanie zapytań przy użyciu usługi REST

W żądaniu GET należy określić parametry zapytania w adresie URL. Za pomocą żądania POST przekazujesz parametry zapytania w treści w formacie JavaScript Object Notation (JSON).

Nagłówki żądań

Name (Nazwa)	Value
Typ zawartości	application/json; odata=verbose

Przykładowe żądanie GET wysyłane do wszystkich lokalizacji geograficznych

https:// \<tenant\>/\_api/search/query?querytext='sharepoint'&Properties='EnableMultiGeoSearch:true'&ClientType='my\_client\_id'

Przykładowe żądanie GET do wyszukiwania do niektórych lokalizacji geograficznych

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

Uwaga

Przecinki i dwukropki na liście lokalizacji geograficznych właściwości MultiGeoSearchConfiguration są poprzedzone znakiem ukośnika odwrotnego . Dzieje się tak, ponieważ żądania GET używają dwukropków do oddzielania właściwości i przecinków w celu oddzielenia argumentów właściwości. Bez ukośnika odwrotnego jako znaku ucieczki właściwość MultiGeoSearchConfiguration jest interpretowana nieprawidłowo.

Przykładowe żądanie POST, które jest rozsyłane do wszystkich lokalizacji geograficznych

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

Przykładowe żądanie POST, które jest rozsyłane do niektórych lokalizacji geograficznych

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

Wykonywanie zapytań przy użyciu modelu CSOM

Oto przykładowe zapytanie CSOM, które jest przeznaczone dla wszystkich lokalizacji geografii:

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

Udostępnij za pośrednictwem