Søgeindstillinger ved en migrering

Indholdet kommer over med SharePoint Migration Tool (SPMT) eller et andet værktøj. Søgeindstillingerne gør ikke: de administrerede egenskaber og deres mapping, resultatkilderne, forespørgselsreglerne og webdelene, der bruger dem. SPMT understøtter ikke de fleste søgewebdele (Microsoft). Hvad der skal gøres, afhænger af, hvad søgningen skal bruges til bagefter.

Moderne søgning bruger det meste ikke#

Den moderne søgning i SharePoint Online er Microsoft Search, og den ser bort fra meget af det, den klassiske søgning var bygget på (Microsoft):

• Resultatkilder. “custom result sources at site collection or tenant level won’t affect the search result”, når Microsoft Search er slået helt til.
• Forespørgselsregler. Kun regler, der giver fremhævede resultater, virker i den moderne søgning, og fremhævede resultater for hele organisationen er erstattet af bogmærker (Microsoft). Regler, der skriver forespørgslen om, virker ikke.
• Sortable og Refinable på en administreret egenskab ændrer intet i Microsoft Search.

De betyder stadig noget for klassiske søgesider og for webdele, der går gennem SharePoints søge-API, fx PnP Modern Search med datakilden SharePoint Search. Første spørgsmål er derfor, hvad der skal overleve: en søgeside med filtre, en webdel på forsiden som i Driftsmeddelelser på forsiden med PnP Modern Search, eller bare at brugerne kan finde deres filer.

Eksport og import#

Søgeindstillinger kan eksporteres som en XML-fil og importeres et andet sted. Filen indeholder “all customized query rules, result sources, result types, ranking models and site search settings” og søgeskemaets egne ændringer (Microsoft). I SharePoint Online sker det under webstedsindstillingerne for en webstedssamling eller et websted. Fra en søgetjeneste i SharePoint Server kan filen også importeres i SharePoint Online, men eksporten fra tjenesten findes ikke i brugerfladen, kun gennem API’et (Microsoft).

Med PnP PowerShell (PnP):

 1Connect-PnPOnline -Url "https://<tenant>.sharepoint.com/sites/<websted>" -Interactive -ClientId "<klient-id>"
 2
 3# Hele webstedssamlingens indstillinger som XML
 4Get-PnPSearchConfiguration -Scope Site -Path ".\soegning.xml"
 5
 6# Kun de administrerede egenskaber og deres mapping, til at læse
 7Get-PnPSearchConfiguration -Scope Site -OutputFormat ManagedPropertyMappings
 8
 9# Ind i en anden webstedssamling
10Set-PnPSearchConfiguration -Scope Site -Path ".\soegning.xml"

-Scope er Web, Site eller Subscription, og standarden er Web. Ikke kørt.

Det, der driller ved importen:

• Standardindstillingerne kan ikke eksporteres, kun det, der er ændret.
• En webstedssamlings fil har ikke webstedernes indstillinger. De skal eksporteres hver for sig.
• Egenskaber med samme navn flettes. Deres aliasser og mapping lægges sammen med dem, der allerede findes.
• Navne med ugyldige tegn får importen til at fejle, også understregning.

Egne egenskaber skal mappes igen#

I SharePoint Server kan en administreret egenskab oprettes med den type og de indstillinger, den skal have. I SharePoint Online kan en ny egenskab kun være tekst eller ja/nej, og den kan ikke bruges som filter eller til sortering (Microsoft). En egenskab fra SharePoint Server, fx en dato, der blev brugt til at filtrere og sortere, skal i stedet mappes til en af de færdige:

Så skal forespørgsler og webdele, der brugte det gamle navn, skrives om til det nye. Et alias med det gamle navn kan måske spare det; det har jeg ikke efterprøvet.

Hvordan en mapping til en RefinableDate laves, står i Et datofilter i forespørgslen i PnP Modern Search.

Rækkefølgen#

1. Skriv ned, hvad der findes. Egenskaberne og deres mapping, resultatkilderne, reglerne og de sider og webdele, der bruger dem. -OutputFormat ManagedPropertyMappings giver egenskaberne fra SharePoint Online, og eksportfilen giver resten.
2. Migrér indholdet. En gennemsøgt egenskab fra en webstedskolonne findes først, når kolonnen har værdier, og indholdet er gennemsøgt. Kun webstedskolonner med værdier bliver automatisk til gennemsøgte og administrerede egenskaber (Microsoft). Mappingen kan altså ikke laves før migreringen.
3. Map og importer. Til de Refinable-egenskaber, der er valgt, og importér det, der stadig bruges.
4. Genindeksér. En ændret mapping slår først igennem, når indholdet er gennemsøgt igen. Webstedsindstillinger → Search and offline availability → Reindex site, eller for et bibliotek under de avancerede indstillinger (Microsoft). Med PnP: Request-PnPReIndexWeb.
5. Test med brugernes egne søgninger. En liste over det, der blev søgt efter før, og hvad der skulle komme frem. Søgningen kan ikke vurderes lige efter migreringen.

Det der driller#

• Refinable-egenskaberne er fælles for tenanten, når de mappes der. To løsninger, der hver bruger RefinableString00 til noget forskelligt, ødelægger hinanden. En liste over, hvilke der er brugt til hvad, er det eneste, der hjælper.
• Genindeksering belaster. Microsoft skriver: “Reindexing a site can cause a massive load on the search system.” Genindeksér de websteder, der har brug for det, ikke hele tenanten.
• Automatiske egenskaber skelner mellem store og små bogstaver (Microsoft).
• Tabellen over automatiske egenskaber (OWSTEXT, OWSDATE, OWSUSER osv.) står under SharePoint Server, og alle de automatiske egenskaber er tekst. Det rigtige navn i tenanten står i søgeskemaet.
• Filtrene i en søgeside er webdelens indstilling, ikke en del af søgeskemaet. De kommer ikke med i eksportfilen og skal sættes op igen på den nye side.