Gestire i verticali di ricerca

  • Articolo

I verticali di ricerca sono schede nella pagina dei risultati della ricerca che mostrano i risultati di un tipo specifico o da origini selezionate. Ad esempio, il verticale File mostra i risultati classificati come file e semplifica la ricerca di documenti da parte degli utenti. È possibile personalizzare i verticali in Microsoft Search per soddisfare le esigenze dell'organizzazione o dei singoli reparti. Microsoft Search ha due tipi di verticali, predefiniti o verticali predefiniti e personalizzati. I verticali predefiniti, ad esempio Tutti, File e Persone, consentono di accedere facilmente ai risultati di ricerca più usati.

È possibile gestire i verticali a due livelli:

  • Livello organizzazione : nella pagina dei risultati della ricerca viene visualizzato un verticale a livello di organizzazione quando gli utenti eseguono ricerche dalla pagina iniziale di SharePoint , da Microsoft Office e da Microsoft Search in Bing
  • Livello sito : viene visualizzato un verticale a livello di sito nella pagina dei risultati della ricerca quando gli utenti cercano in un sito di SharePoint. Ad esempio, è possibile abilitare i dipendenti del servizio clienti per cercare gli eventi imprevisti di gravità 1 direttamente dal sito di SharePoint del reparto.

Verticali predefinite

I verticali predefiniti sono presenti a livello di organizzazione in esperienze come SharePoint, Microsoft Office e Microsoft Search in Bing o a livello di sito di SharePoint nella pagina dei risultati della ricerca di ogni sito.

Ecco un riepilogo delle funzionalità di personalizzazione nei verticali predefiniti.

Tipo di personalizzazione Livello di organizzazione Livello sito
Rinomina verticale Sì Sì
Disabilita verticale Parziale Sì
Aggiunta di una query Parziale Sì

Verticali personalizzate

È possibile aggiungere i verticali di ricerca nell'esperienza di ricerca a livello di organizzazione o di sito per cercare contenuto da connettori Graph o SharePoint. I verticali personalizzati per il contenuto di SharePoint mostreranno i risultati del rispettivo ambito, in modo analogo agli altri verticali in tale ambito. Ad esempio, un verticale personalizzato nell'ambito dell'organizzazione visualizzerà tutti i risultati, mentre un verticale personalizzato con contenuto di SharePoint nel sito marketing visualizzerà i dati da tale sito. Lo stesso vale per i siti hub in cui verrà applicato lo stesso ambito dell'hub. 

Creare o modificare i verticali di ricerca

L'esperienza di gestione verticale è guidata dalla procedura guidata, vengono illustrati i passaggi per definire il nome, l'origine del contenuto e l'ambito del contenuto da cercare. È possibile usare un set limitato di KQL (Keyword Query Language) per definire l'ambito della ricerca verticale per una determinata origine di contenuto. I filtri possono anche essere aggiunti a verticali predefiniti e personalizzati a livello di organizzazione e sito. Per altre informazioni sui filtri, vedere Gestire i filtri.

Gestire i verticali a livello di organizzazione

  1. Nella interfaccia di amministrazione di Microsoft 365 passare alla pagina Verticali nella sezione Personalizzazione.
  2. Selezionare un verticale esistente e fare clic su Modifica o su Aggiungi per creare un nuovo verticale.
  3. Dopo aver eseguito i passaggi di configurazione, è possibile esaminare e salvare la verticale.

Gestire i verticali a livello di sito

  1. Nel sito di SharePoint in cui si desidera gestire i verticali aprire il pannello delle impostazioni facendo clic sull'ingranaggio.
  2. Selezionare Informazioni sul sito e quindi Selezionare Visualizza tutte le impostazioni del sito. 
  3. Cercare la sezione Microsoft Search e quindi selezionare Configura impostazioni di ricerca.
  4. Nel riquadro di spostamento passare a Esperienza personalizzata e quindi selezionare Verticali.
  5. Selezionare un verticale esistente e fare clic su Modifica o su Aggiungi per creare un nuovo verticale.
  6. Dopo aver impostato la configurazione, è possibile esaminare e salvare la verticale.

Visualizzare il verticale nella pagina dei risultati della ricerca

È necessario un layout dei risultati della ricerca per il rendering dei risultati del connettore Graph nella pagina verticale di ricerca. Assicurandosi che sia presente il layout dei risultati appropriato, è possibile abilitare il verticale di ricerca. Dopo aver abilitato o aggiornato un oggetto verticale, si verifica un ritardo di alcune ore prima di poter visualizzare le modifiche nella pagina di ricerca. È possibile aggiungere cacheClear=true all'URL in SharePoint e Office per visualizzare immediatamente le modifiche. In Bing aggiungere &features=uncachedVerticals all'URL verticale di lavoro per visualizzare immediatamente le modifiche.

Nota

I verticali aggiunti non sono visibili in SharePoint e Office quando vengono visualizzati dai Web browser per dispositivi mobili.

Opzioni di configurazione avanzate

Più connessioni in verticale

Un verticale di ricerca può visualizzare i risultati da più origini del connettore. Questa opzione offre flessibilità nella progettazione della pagina dei risultati della ricerca. Il processo di configurazione verticale consente agli amministratori di selezionare più connessioni nel passaggio "Origine contenuto".

Se si nominano con precisione il maggior livello di etichette semantica possibile, questa esperienza viene migliorata. Aggiungere etichette semantica nel punto di definizione e inserimento dello schema. Altre informazioni su come creare e gestire le etichette semantica. Ecco altre informazioni su come creare e gestire le etichette semantica.

Nota

  • È possibile aggiungere una connessione come origine di contenuto in un singolo verticale. Non è possibile usare connessioni in più verticali.

Per configurare una query per un verticale di ricerca in cui sono state aggiunte più origini di connessione, usare le proprietà di origine comuni per creare la query.

KQL (Keyword Query Language)

È possibile aggiungere una query a un oggetto verticale per limitare i risultati visualizzati nel verticale di ricerca usando il linguaggio KQL (Keyword Query Language) (supporto limitato). Questa pagina elenca le proprietà disponibili. È consigliabile usare parole chiave di testo libero e restrizioni delle proprietà con operatori booleani per la creazione di KQL. Gli operatori di classificazione dinamica come XRANK, operatori di prossimità e parole non sono supportati.

Ecco alcune query di esempio.

Scenario Query
Esclusione dei risultati dai siti di archivio NOT (path:http//contoso.sharepoint.com/archive OR path:http//contoso.sharepoint.com/CompanyArchive)
Esclusione dei risultati in base alla proprietà del tipo di file NOT(FileType:htm)

Usare le variabili nella sezione query KQL di un oggetto verticale per fornire dati dinamici come input per la query di un oggetto verticale. "Profile" e "query string" sono i tipi di variabili di query che è possibile usare.

Variabili di query del profilo

È possibile usare le variabili di query del profilo per contestualizzare i risultati della ricerca all'utente connesso. Le variabili di query del profilo recuperano i valori dal profilo dell'utente connesso. Ad esempio, per creare un verticale "Tickets" per consentire all'utente di trovare i ticket di supporto assegnati, è possibile specificare la query seguente nella sezione "Query" durante la creazione verticale nella pagina di amministrazione.

AssignedTo:{Profile.accounts.userPrincipalName}

In questo modo i risultati della ricerca verranno ritagliati in modo da visualizzare solo gli elementi assegnati alla persona che esegue la ricerca.

La risorsa profilo espone le proprietà come raccolte. Ad esempio, le informazioni relative agli indirizzi di posta elettronica vengono esposte tramite la raccolta di messaggi di posta elettronica, le posizioni di lavoro come raccolta di posizioni e così via. Tutte le proprietà disponibili nel profilo utente vengono esposte come variabili di query.

Si consideri un utente che dispone di tre indirizzi di posta elettronica disponibili nella raccolta di posta elettronica, come illustrato di seguito:

"emails": [{ 

        "address": "Megan.Bowen@contoso.com",
        "id": "xyz", 
        "source": { 
            "CreatedBy": "xyz", 
            "CreatedOn": "2222", 
            "Type": "official" 
        },
        "type": "main" 
    }, { 
        "address": "meganb@hotmail.com",
        "id": "abc", 
        "source": { 
            "CreatedBy": "abc",
            "CreatedOn": "3333", 
            "Type": "non-official",
        },
        "type": "work"
    }, { 
        "address": "meganb@outlook.com",
        "id": "pqr", 
        "source": { 
            "CreatedBy": "pqr", 
            "CreatedOn": "4444", 
            "Type": "personal" 
        },
        "type": "personal" 
    } 
]

  • La query MyProperty: {Profile.emails.address} verrà risolta in MyProperty: "Megan.Bowen@contoso.com".

  • Per risolvere tutti i valori dell'attributo address, usare la sintassi di espansione multivalore. La query {|MyProperty:{Profile.emails.address}} verrà risolta in ((MyProperty:"Megan.Bowen@contoso.com") OR (MyProperty: "meganb@hotmail.com") OR (MyProperty:"meganb@outlook.com")).

Usare l'operatore "|" per risolvere le variabili multivalore. Per altri esempi di espansione del profilo, vedere la tabella seguente.

# Sintassi Valore restituito
1 MyProperty:{Profile.emails.address} "Megan.Bowen@contoso.com"
2 MyProperty:{Profile.emails} {Profile.emails} Non verrà risolto perché i messaggi di posta elettronica sono un oggetto.
3 {? MyProperty:{Profile.emails}} Questa operazione non verrà risolta perché i messaggi di posta elettronica sono un oggetto . Il "?" l'operatore ignora le variabili di query che non si risolveno. Questa variabile verrà rimossa quando viene passata più in basso nello stack di query.
4 {|MyProperty: {Profile.emails.source.Type}} ((MyProperty:"official") OR (MyProperty:"nonofficial") OR (MyProperty:"personal"))

Variabili stringa di query

Le variabili stringa di query consentono di personalizzare i risultati della ricerca in base al modo in cui gli utenti interagiscono con i siti di SharePoint. Questa operazione viene eseguita aggiungendo coppie chiave-valore all'URL di ricerca. Si supponga, ad esempio, di avere un sito di SharePoint che fornisce informazioni su un progetto con una semplice web part che mostra le attività in corso. Facendo clic sulla web part "In corso", gli utenti vengono collegati al verticale di ricerca "Elementi di lavoro", in cui i risultati vengono affinati per visualizzare solo gli elementi contrassegnati come InProgress.

A tale scopo, specificare la query seguente nella sezione "Query" durante la creazione verticale nella pagina di amministrazione.

Status:{QueryString.state}

L'URL nella web part del pulsante del sito di SharePoint deve essere aggiornato per passare la coppia di valori chiave seguente https://{your-domain}.sharepoint.com/sites/{site-name}/_layouts/15/search.aspx/{vertical-ID}?state=InProgress

Lo stato della query:{QueryString.state} verrà risolto in status:InProgress.

Di seguito sono riportati altri esempi di espansione della stringa di query.

# Sintassi di query Sintassi URL Valore restituito
1 MyProperty:{QueryString.state} https://{dominio}.sharepoint.com/sites/{nome-sito}/_layouts/15/search.aspx/{VERTICAL-ID}?state=InProgress MyProperty:InProgress
2 MyProperty:{QueryString.state} OR MyProperty:{QueryString.priority} https://{dominio}.sharepoint.com/sites/{nome-sito}/_layouts/15/search.aspx/{vertical-ID}?state=InProgress&priority=1 MyProperty:InProgress OR MyProperty:1
3 {? MyProperty:{QueryString.state}} https://{dominio}.sharepoint.com/sites/{nome-sito}/_layouts/15/search.aspx/{vertical-ID}? State=InProgress In questo caso lo stato non verrà risolto perché querystring fanno distinzione tra maiuscole e minuscole. Il "?" l'operatore ignora le variabili di query che non si risolveno. Questa variabile verrà rimossa quando viene passata più in basso nello stack di query.
4 {|MyProperty: {QueryString.state}} https://{your-domain}.sharepoint.com/sites/{site-name}/_layouts/15/search.aspx/{vertical-ID}?state=InProgress,Closed (MyProperty:InProgress) OR (MyProperty:Closed)
Oggetto | l'operatore viene usato per risolvere le variabili muti-value. I valori per le variabili devono essere passati usando il separatore di virgole, come illustrato nella sintassi DELL'URL.
5 {MyProperty: {QueryString.state}} https://{your-domain}.sharepoint.com/sites/{site-name}/_layouts/15/search.aspx/{vertical-ID}?state=InProgress,Closed MyProperty:InProgress
In questo caso solo il primo valore di stato viene prelevato dall'URL perché la sintassi di query non lo definisce come variabile multivalore.

Limitazioni

  • La localizzazione della lingua non è applicabile ai nomi di verticali predefiniti dopo la modifica.
  • I verticali personalizzati non vengono visualizzati nella visualizzazione per dispositivi mobili di Microsoft Search.
  • L'aggiunta di query non è supportata nella Persone verticale.
  • La modifica verticale e i nuovi verticali non sono visibili agli utenti guest di un'organizzazione.
  • Il riordino verticale non è supportato.
  • La ridenominazione verticale per la scheda Tutti non è supportata in Microsoft Search in Bing.
  • Le variabili stringa di query possono essere usate solo nei siti di SharePoint.

Risoluzione dei problemi

Ecco un elenco di problemi comuni che potrebbero verificarsi e azioni per risolverli.

Problema Azione
Viene visualizzato un messaggio di errore "Qualcosa è andato storto" in verticale. Per completare l'installazione sono necessari sia i tipi verticali che i tipi di risultati. Assicurarsi che entrambi siano configurati per l'origine di contenuto.
Non viene visualizzata alcuna origine di contenuto nella pagina verticale. Assicurarsi di avere configurato connettori e dati indicizzati.