Informazioni sulle trasformazioni di query

Si applica a
SharePoint Server 2019 Amministrazione centrale di SharePoint Server 2019 SharePoint Server 2016 Amministrazione centrale di SharePoint Server 2016 SharePoint Server 2013 SharePoint Server 2013 Enterprise SharePoint Foundation 2013

Per fornire risultati della ricerca appropriati per una query utente, a volte è necessario modificare la query. Si supponga, ad esempio, di creare un verticale di ricerca per le immagini. Quando qualcuno digita una query nel verticale Immagini, è necessario modificare la query in modo che restituisca solo i risultati della ricerca che sono Immagini.

Per modificare una query, usare il Generatore di query per configurare una trasformazione di query. È possibile configurare una trasformazione query per sostituire le proprietà di una query, ad esempio l'origine dei risultati che la query userà per ottenere i risultati della ricerca o l'ordinamento che userà quando visualizza i risultati della ricerca. La trasformazione sostituisce anche il testo della query usando un modello di query che è possibile configurare. Il modello di query è il testo che sostituirà il testo della query e il modello può contenere variabili di query.

Una variabile di query è un segnaposto per un valore. Quando una trasformazione sostituisce il testo di una query con il relativo modello di query, sostituisce anche le variabili di query nel modello con valori specifici.

Una trasformazione sostituisce le variabili di query contestuali con valori pertinenti al contesto di query. La tabella seguente mostra alcuni esempi di variabili di query contestuali.

Questa variabile di query contestuale viene sostituita da una trasformazione Con questo
{User.Name} Nome dell'utente che ha digitato la query
{Site.URL} Sito in cui l'utente ha digitato il valore
{Oggi} Data odierna

Una trasformazione sostituisce le variabili di query associate con un determinato testo presente nella query dell'utente. Nella tabella seguente vengono illustrati alcuni esempi di variabili di query associate.

Una trasformazione sostituisce questa variabile di query associata Con questo
{searchBoxQuery} Query digitata dall'utente
{searchTerms} Query digitata dall'utente, modificata dalla trasformazione più recente

È possibile usare una variabile di query associata quando si aggiunge una restrizione a una query, ad esempio quando si limita una query a un particolare tipo di contenuto. Ad esempio, per un verticale di ricerca Immagini, è possibile configurare una trasformazione di query che aggiunge "contenttype:picture" al testo della query usando il modello di query "{searchTerms} contenttype:picture". Se un utente digita la query "luna" in tale verticale, la trasformazione sostituisce "{searchTerms}" con "luna". Pertanto, la trasformazione della query modifica la query in "moon contenttype:picture".

È possibile configurare le trasformazioni di query in tre posizioni:

  • In una web part, ad esempio una web part Risultati ricerca. Configurare una trasformazione in una web part quando non è necessario apportare le stesse modifiche alle query altrove.

  • In una regola di query che specifica che determinate azioni verranno eseguite solo se vengono soddisfatte determinate condizioni. Due di queste azioni usano una trasformazione per modificare la query:

    • Aggiungere un blocco di risultati nella pagina dei risultati della ricerca. Questa azione crea una copia della query e la relativa trasformazione modifica solo la copia.
    • Modificare i risultati classificati. Questa azione modifica la query digitata dall'utente.
  • Nell'origine dei risultati usata dalla query per ottenere i risultati della ricerca.

Una query utente viene trasformata dalla web part, quindi dalle regole di query applicabili e infine dall'origine dei risultati. Pertanto, quando si configura una trasformazione in un'origine dei risultati, si sa che le modifiche alla trasformazione non verranno eliminate o sostituite, perché l'origine dei risultati trasforma la query per ultima. Ad esempio, per assicurarsi che un verticale di ricerca di Immagini restituisca solo immagini, è necessario configurare la trasformazione appropriata in un'origine dei risultati e quindi configurare la web part nel verticale di ricerca per l'uso di tale origine dei risultati.

Per altre informazioni, vedere Panoramica dell'elaborazione di query in TechNet.

Inizio pagina