Esportare e importare le impostazioni di configurazione di ricerca personalizzata
In qualità di amministratore di SharePoint e versioni successive in Microsoft 365, è possibile esportare e importare impostazioni di configurazione della ricerca personalizzate tra tenant, raccolte siti e siti. Le impostazioni esportate e importate includono tutte le regole di query personalizzate, le origini dei risultati, i tipi di risultati, i modelli di classificazione e le impostazioni di ricerca del sito. È anche possibile esportare impostazioni di configurazione della ricerca personalizzate da un'applicazione del servizio di ricerca e importarle in tenant, raccolte siti o siti. Non è possibile esportare le impostazioni di configurazione predefinite.
Panoramica
Quando si esportano impostazioni di configurazione della ricerca personalizzate, SharePoint crea un file di configurazione della ricerca in formato XML. Questo file di configurazione della ricerca include tutte le impostazioni di configurazione della ricerca personalizzata esportabili a livello di tenant, raccolta siti o sito da cui si avvia l'esportazione. Un file di configurazione della ricerca per una raccolta siti non contiene le impostazioni di configurazione della ricerca dei singoli siti all'interno della raccolta siti.
Quando si importa un file di configurazione della ricerca, SharePoint crea e abilita ogni impostazione di configurazione della ricerca personalizzata nel tenant, nella raccolta siti o nel sito da cui si avvia l'importazione.
Questa tabella mostra le impostazioni che è possibile esportare o importare. Per ogni impostazione, sono disponibili dipendenze da altre impostazioni di configurazione della ricerca personalizzate. Se le impostazioni di configurazione di ricerca personalizzate dipendono da un'impostazione a un livello diverso, ad esempio se una regola di query di un sito dipende da un'origine dei risultati a livello di raccolta siti, è necessario esportare e importare le impostazioni a tutti i livelli appropriati.
| Impostazione di configurazione di ricerca personalizzata | Dipendenza da altre impostazioni di configurazione di ricerca personalizzate |
|---|---|
| Regole di query. Includono blocchi dei risultati, risultati alzati di livello e segmenti di utenti. | Origini dei risultati, tipi di risultati, schema di ricerca, modello di classificazione. |
| Origini dei risultati | Schema di ricerca |
| Tipi di risultati | Schema di ricerca, origini dei risultati, modelli di visualizzazione |
| Schema di ricerca | Nessuna |
| Modello di classificazione | Schema di ricerca |
Condizioni che possono causare l'esito negativo dell'importazione
Se il file di configurazione di ricerca e la destinazione dell'importazione includono impostazioni con lo stesso nome, l'importazione del file di configurazione di ricerca non riesce quando viene rilevata questa impostazione. Esistono tuttavia eccezioni:
Se il file di configurazione di ricerca viene reimportato, le impostazioni con lo stesso nome in questo file e nella destinazione non impediscono il completamento dell'importazione.
Le proprietà gestite con lo stesso nome impediscono il completamento dell'importazione se le impostazioni delle singole proprietà gestite sono identiche alla proprietà nel file di configurazione di ricerca e nella proprietà di destinazione.
Le proprietà gestite con lo stesso nome non causano un errore di importazione se gli alias e i mapping alle proprietà sottoposte a ricerca per indicizzazione sono diversi nella proprietà gestita nel file di configurazione della ricerca e nella proprietà gestita di destinazione. L'importazione aggiunge gli alias e i mapping nella proprietà gestita nel file di configurazione della ricerca agli alias e ai mapping nella proprietà gestita di destinazione.
Se il file di configurazione di ricerca contiene nomi di proprietà gestite o alias contenenti caratteri non validi, l'importazione non riesce quando viene rilevato questo nome di proprietà gestita o alias.
I nomi di proprietà gestite e gli alias di uno schema di ricerca devono essere univoci per un sito e per la relativa raccolta siti padre. Questo significa che:
Se il file di configurazione di ricerca contiene una proprietà gestita con lo stesso nome di un alias di una proprietà gestita nel sito di destinazione o nella relativa raccolta siti padre, l'importazione non riesce.
Se il file di configurazione di ricerca contiene una proprietà gestita con un alias con lo stesso nome di una proprietà gestita nel sito di destinazione o nella relativa raccolta siti padre, l'importazione non riesce.
Nota
Le impostazioni di ricerca personalizzate create e abilitate da SharePoint prima dell'importazione non sono riuscite, rimangono abilitate.
Se l'importazione non riesce, rimuovere la condizione che ha generato l'errore e reimportare il file di configurazione di ricerca. Se ad esempio la colonna Note indica che è già presente una regola di query con lo stesso nome di quella che si sta tentando di importare, rimuovere questa regola di query dalla destinazione o dal file di importazione e quindi reimportare il file. Vedere Caratteri non validi che causano errori di importazione più avanti in questo articolo.
Esportare le impostazioni di configurazione della ricerca personalizzate da un tenant
Passare a Altre caratteristiche nella nuova interfaccia di amministrazione di SharePoint e accedere con un account con autorizzazioni di a amministratore per l'organizzazione.
Nota
In Office 365 gestito da 21Vianet (Cina), accedere all'interfaccia di amministrazione di Microsoft 365, passare all'interfaccia di amministrazione di SharePoint e aprire la pagina Altre funzionalità.
In Cerca selezionare Apri.
Selezionare Esporta configurazione ricerca.
Nella finestra di dialogo selezionare Salva.
Esportare impostazioni di configurazione di ricerca personalizzate da un sito
Nel sito selezionare
e quindi selezionare Impostazioni sito. Se le impostazioni del sito non sono visualizzate, selezionare Informazioni sul sito e quindi selezionare Visualizza tutte le impostazioni del sito.Nella sezione Ricerca della pagina Impostazioni sito selezionare Esportazione configurazione.
Nella finestra di dialogo selezionare Salva.
Esportare impostazioni di configurazione di ricerca personalizzate da una raccolta siti
Nel sito selezionare
e quindi selezionare Impostazioni sito. Se le impostazioni del sito non sono visualizzate, selezionare Informazioni sul sito e quindi selezionare Visualizza tutte le impostazioni del sito.Nella sezione Amministrazione raccolta siti della pagina Impostazioni sito selezionare Esporta configurazione ricerca.
Nella finestra di dialogo selezionare Salva.
Importare le impostazioni di configurazione della ricerca personalizzata in un tenant
Passare a Altre caratteristiche nella nuova interfaccia di amministrazione di SharePoint e accedere con un account con autorizzazioni di a amministratore per l'organizzazione.
Nota
In Office 365 gestito da 21Vianet (Cina), accedere all'interfaccia di amministrazione di Microsoft 365, passare all'interfaccia di amministrazione di SharePoint e aprire la pagina Altre funzionalità.
In Cerca selezionare Apri.
Nella pagina Importa configurazione ricerca passare al file da importare.
Selezionare Importa.
Nella pagina Elenco configurazioni di ricerca verificare che:
Il file di configurazione di ricerca importato sia presente nell'elenco con lo stato Importazione completata.
Se il file non è stato importato correttamente, nella colonna Note vengono forniti altri dettagli sull'operazione.
La colonna Ambito mostra che le impostazioni importate si trovano al livello corretto, ovvero al livello in cui si intende importare il file. Ad esempio, se le impostazioni sono state importate a livello di raccolta siti anziché a livello di sito, queste informazioni verranno visualizzate nella colonna Ambito . La colonna Ambito mostra a quale livello sono state abilitate le impostazioni di configurazione della ricerca. I livelli sono: tenant (tenant), raccolta siti (SPSite) o livello di sito (SPWeb).
Importare impostazioni di configurazione di ricerca personalizzate in un sito
Nel sito selezionare
e quindi selezionare Impostazioni sito. Se le impostazioni del sito non sono visualizzate, selezionare Informazioni sul sito e quindi selezionare Visualizza tutte le impostazioni del sito.Nella sezione Ricerca della pagina Impostazioni sito selezionare Importazione configurazione.
Nella pagina Importa configurazione ricerca passare al file da importare.
Selezionare Importa.
Nella pagina Elenco configurazioni di ricerca verificare che:
Il file di configurazione di ricerca importato sia presente nell'elenco con lo stato Importazione completata.
Se il file non è stato importato correttamente, la colonna Note fornisce altri dettagli sull'operazione eseguita.
La colonna Ambito mostra che le impostazioni importate si trovano al livello corretto, ovvero al livello in cui si intende importare il file. Ad esempio, se le impostazioni sono state importate a livello di raccolta siti anziché a livello di sito, queste informazioni verranno visualizzate nella colonna Ambito . La colonna Ambito mostra a quale livello sono state abilitate le impostazioni di configurazione della ricerca. I livelli sono: tenant (tenant), raccolta siti (SPSite) o livello di sito (SPWeb).
Importare impostazioni di configurazione di ricerca personalizzate in una raccolta siti
Nel sito selezionare
e quindi selezionare Impostazioni sito. Se le impostazioni del sito non sono visualizzate, selezionare Informazioni sul sito e quindi selezionare Visualizza tutte le impostazioni del sito.Nella sezione Amministrazione raccolta siti della pagina Impostazioni sito selezionare Importazione configurazione ricerca.
Nella pagina Importa configurazione ricerca passare al file da importare.
Selezionare Importa.
Nella pagina Elenco configurazioni di ricerca verificare che:
Il file di configurazione della ricerca importato è incluso nell'elenco e il relativo stato è Importato correttamente.
Se il file non è stato importato correttamente, la colonna Note fornisce altri dettagli sull'operazione eseguita.
La colonna Ambito mostra che le impostazioni importate si trovano al livello corretto, ovvero al livello in cui si intende importare il file. Ad esempio, se le impostazioni sono state importate a livello di raccolta siti anziché a livello di sito, queste informazioni verranno visualizzate nella colonna Ambito . La colonna Ambito mostra a quale livello sono state abilitate le impostazioni di configurazione della ricerca. I livelli sono: tenant (tenant), raccolta siti (SPSite) o livello di sito (SPWeb).
Caratteri non validi che causano l'esito negativo dell'importazione
Se le proprietà gestite o gli alias includono uno dei caratteri elencati, l'importazione dello schema di ricerca personalizzato contenente queste proprietà non verrà completata.
| Carattere | Nome |
|---|---|
| spazio | |
| : | due punti |
| ; | punto e virgola |
| , | virgola |
| ( | parentesi aperta |
| ) | parentesi chiusa |
| [ | parentesi quadra aperta |
| ] | parentesi quadra chiusa |
| { | parentesi graffa aperta |
| } | parentesi graffa chiusa |
| % | percentuale |
| $ | segno di dollaro |
| _ | sottolineatura |
| + | segno di addizione |
| ! | punto esclamativo |
| * | asterisco |
| = | segno di uguale |
| & | e commerciale |
| ? | punto interrogativo |
| @ | chiocciola |
| # | cancelletto |
| \ | barra rovesciata |
| ~ | tilde |
| < | parentesi uncinata aperta |
| > | parentesi uncinata chiusa |
| | | Pipe |
| ` | accento grave |
| ^ | accento circonflesso |
| ' | sequenza di escape |
| " | sequenza di escape |
Problema noto
Impossibile caricare l'elenco di configurazione della ricerca
Quando si importano i file di configurazione della ricerca nella pagina delle impostazioni di ricerca dell'amministratore del tenant, si potrebbe riscontrare un problema per cui l'elenco di configurazione della ricerca non è stato visualizzato correttamente e potrebbe essere visualizzato un errore "File non trovato".
Questo problema impedisce solo all'interfaccia utente di visualizzare l'elenco dei file di configurazione di ricerca importati e non interrompe la funzionalità Di importazione . La configurazione della ricerca verrà importata correttamente.
Poiché non è possibile controllare lo stato del file di configurazione della ricerca importato dall'interfaccia utente, è possibile scegliere un modo alternativo per accedere all'elenco, ad esempio l'API CSOM di SharePoint o l'API REST di SharePoint Online.
Impossibile importare il file XML di configurazione della ricerca non aggiornato
Se il file di configurazione della ricerca è stato esportato molto tempo fa, l'importazione potrebbe non riuscire.
Se il file di configurazione della ricerca esportato non è aggiornato, è necessario esportare prima una nuova configurazione di ricerca e quindi usarla per importare l'elenco dei file di configurazione della ricerca.