Esportare e importare le impostazioni di configurazione di ricerca personalizzata

In qualità di amministratore globale o amministratore di SharePoint 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 servizio di ricerca e importare le impostazioni 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.

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.

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

1. Passare a Altre caratteristiche nella nuova interfaccia di amministrazione di SharePoint e accedere con un account con autorizzazioni di a amministratore per l'organizzazione.

2. In Cerca selezionare Apri.

3. Selezionare Esporta configurazione ricerca.

4. Nella finestra di dialogo selezionare Salva.

Esportare impostazioni di configurazione di ricerca personalizzate da un sito

1. 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.

2. Nella sezione Ricerca della pagina Impostazioni sito selezionare Esportazione configurazione.

3. Nella finestra di dialogo selezionare Salva.

Esportare impostazioni di configurazione di ricerca personalizzate da una raccolta siti

1. 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.

2. Nella sezione Amministrazione raccolta siti della pagina Impostazioni sito selezionare Esporta configurazione ricerca.

3. Nella finestra di dialogo selezionare Salva.

Importare le impostazioni di configurazione della ricerca personalizzata in un tenant

1. Passare a Altre caratteristiche nella nuova interfaccia di amministrazione di SharePoint e accedere con un account con autorizzazioni di a amministratore per l'organizzazione.

2. In Cerca selezionare Apri.

3. Nella pagina Importa configurazione ricerca passare al file da importare.

4. Selezionare Importa.

5. Nella pagina Elenco configurazioni di ricerca verificare che:

6. 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.

7. 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

1. 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.

2. Nella sezione Ricerca della pagina Impostazioni sito selezionare Importazione configurazione.

3. Nella pagina Importa configurazione ricerca passare al file da importare.

4. Selezionare Importa.

5. Nella pagina Elenco configurazioni di ricerca verificare che:

6. 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.

7. 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

1. 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.

2. Nella sezione Amministrazione raccolta siti della pagina Impostazioni sito selezionare Importazione configurazione ricerca.

3. Nella pagina Importa configurazione ricerca passare al file da importare.

4. Selezionare Importa.

5. Nella pagina Elenco configurazioni di ricerca verificare che:

6. 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.

7. 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.

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.