Gestire i verticali di ricerca

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

È possibile gestire i verticali a due livelli:

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

Nota

Gli utenti guest invitati a SharePoint visualizzano le stesse modifiche verticali e verticali personalizzati degli utenti del tenant nativo.

Verticali predefiniti

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

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

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

Verticali personalizzati

È possibile aggiungere verticali di ricerca nell'esperienza di ricerca a livello di organizzazione o sito e cercare contenuti dai connettori di Microsoft 365 Copilot o da SharePoint. I verticali personalizzati per il contenuto di SharePoint mostrano i risultati del rispettivo ambito, in modo analogo agli altri verticali in tale ambito. Ad esempio, un verticale personalizzato nell'ambito dell'organizzazione mostra tutti i risultati, mentre un verticale personalizzato con contenuto di SharePoint nel sito Marketing mostra i dati di tale sito. Lo stesso accade per i siti hub in cui viene applicato lo stesso ambito hub. 

Creare o modificare i verticali di ricerca

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

Gestire i verticali a livello di organizzazione

  1. Nell'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 completato i passaggi di configurazione, è possibile rivedere e salvare il verticale.

Gestire i verticali a livello di sito

  1. Nel sito di SharePoint in cui si vogliono gestire i verticali, aprire il riquadro delle impostazioni facendo clic sull'ingranaggio.
  2. Seleziona Informazioni sito, quindi seleziona 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 rivedere e salvare il verticale.

Visualizzare il verticale nella pagina dei risultati della ricerca

Per eseguire il rendering dei risultati del connettore di Microsoft Copilot nella pagina verticale di ricerca, è necessario un layout dei risultati di ricerca. Per assicurarsi che sia presente il layout dei risultati appropriato, è possibile abilitare il verticale di ricerca. Dopo aver abilitato o aggiornato un verticale, saranno necessarie alcune ore prima di poter visualizzare le modifiche nella pagina di ricerca. È possibile aggiungere cacheClear=true all'URL in SharePoint e Office per visualizzare le modifiche. La modifica potrebbe richiedere fino a 30 minuti.

Nota

I verticali aggiunti non sono visibili in SharePoint e Office se visualizzati da Web browser per dispositivi mobili.

Opzioni di configurazione avanzate

Connessioni multiple in una verticale

Un verticale di ricerca può individuare risultati da più origini 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 assegna accuratamente il maggior numero possibile di etichette semantiche , l'esperienza risulterà migliorata. Le etichette semantiche vengono aggiunte nel punto di definizione e acquisizione dello schema. Altre informazioni su come creare e gestire etichette semantiche. Ecco altre informazioni su come creare e gestire le etichette semantiche.

Nota

  • È possibile aggiungere una connessione come origine di contenuto sotto 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 verticale per limitare i risultati visualizzati nel verticale di ricerca usando Keyword Query Language (KQL) (supporto limitato). In questa pagina sono elencate le proprietà disponibili. È consigliabile usare parole chiave a testo libero e restrizioni di proprietà con operatori booleani per creare la query KQL. Gli operatori di classificazione dinamica come XRANK, gli operatori di prossimità e le parole non sono supportati.

Ecco alcune query di esempio.

Scenario Query
Esclusione dei risultati dai siti di archivio NOT (percorso:http//contoso.sharepoint.com/archive OR percorso: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 verticale per fornire dati dinamici come input alla query di un verticale. "Profile" e "query string" sono i tipi di variabili di query che possono essere usate.

Variabili di query del profilo

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

AssignedTo:{Profile.accounts.userPrincipalName}

I risultati della ricerca verranno tagliati in modo da mostrare 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 lavorative 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 ha 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} si risolverà in MyProperty: "Megan.Bowen@contoso.com".

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

Usare l'operatore "|" per risolvere 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} Questo problema non viene risolto perché i messaggi di posta elettronica sono un oggetto.
3 {? MyProperty:{Profile.emails}} Questo problema non viene risolto perché i messaggi di posta elettronica sono un oggetto. Il "?" Ignora le variabili di query che non vengono risolte. Questa variabile verrà rimossa quando viene passata più in basso nello stack di query.
4 {|MyProperty: {profile.emails.source.Type}} ((MioProprietà:"ufficiale") O (MioProprietà:"non ufficiale") O (MioProprietà:"personale"))

Variabili della 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 perfezionati per mostrare solo gli elementi contrassegnati come In corso.

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

Status:{QueryString.state}

È necessario aggiornare l'URL della web part del pulsante del sito di SharePoint per passare la coppia chiave-valore 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.

Ecco altri esempi di espansione della stringa di query.

# Sintassi della query Sintassi URL Valore restituito
1 MyProperty:{QueryString.state} https://{your-domain}.sharepoint.com/sites/{site-name}/_layouts/15/search.aspx/{vertical-ID}?state=InProgress MyProperty:InProgress
2 MyProperty:{QueryString.state} OR MyProperty:{QueryString.priority} https://{your-domain}.sharepoint.com/sites/{site-name}/_layouts/15/search.aspx/{vertical-ID}?state=InProgress&priority=1 MyProperty:InProgress OR MyProperty:1
3 {? MyProperty:{QueryString.state}} https://{your-domain}.sharepoint.com/sites/{site-name}/_layouts/15/search.aspx/{vertical-ID}? State=InProgress In questo caso, lo stato non verrà risolto perché le QueryString fanno distinzione tra maiuscole e minuscole. Il "?" Ignora le variabili di query che non vengono risolte. 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)
Il | viene utilizzato per risolvere variabili con valori muti. I valori per le variabili devono essere passati usando il separatore virgola 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, poiché la sintassi della query non lo definisce come variabile multivalore.

Limitazioni

  • La localizzazione linguistica non si applica ai nomi dei verticali predefiniti una volta modificati.
  • I verticali personalizzati non vengono visualizzati nella visualizzazione per dispositivi mobili di Microsoft Search.
  • L'aggiunta di query non è supportata nel verticale People.
  • Il riordino verticale non è supportato.
  • Le variabili delle stringhe di query possono essere usate solo nei siti di SharePoint.

Risoluzione dei problemi

Ecco un elenco dei problemi più comuni che potresti riscontrare e delle azioni da intraprendere per risolverli.

Problema Azione
Viene visualizzato un messaggio di errore "Si è verificato un problema" nel verticale. Per completare la configurazione sono necessari sia il tipo verticale che il tipo di risultato. Assicurarsi che entrambi siano configurati per l'origine contenuto.
Non vedo alcuna fonte di contenuto nella pagina verticale. Verificare di aver configurato i connettori e indicizzato i dati.