Gestire lo schema di ricerca (anteprima)

Lo schema di ricerca determina il modo in cui il contenuto inserito tramite un connettore Graph viene usato in varie esperienze di Microsoft Graph. Lo schema definisce la struttura del modo in cui il contenuto viene raccolto dall'origine dati, indicizzato, sottoposto a query e recuperato dall'indice di ricerca. Modificando lo schema di ricerca, è possibile controllare ciò che gli utenti possono cercare, come gli utenti possono cercarlo e come è possibile presentare i risultati negli endpoint di Microsoft Search.

Lo schema di ricerca contiene proprietà sottoposte a ricerca per indicizzazione, attributi di ricerca, etichette semantiche e alias. Le sezioni successive definiranno i vari componenti delle funzionalità di schema e gestione fornite.

Nota

Leggere l'articolo Configurare il connettore Graph per comprendere le istruzioni generali di configurazione dei connettori Graph. I passaggi 6 e 7 definiscono lo schema durante la configurazione di una nuova connessione.

Nota

Per modificare lo schema di ricerca di SharePoint Online, vedere Gestire lo schema di ricerca in SharePoint.

Proprietà sottoposte a ricerca per indicizzazione

Per generare l'indice di ricerca, è innanzitutto necessario effettuare una ricerca per indicizzazione del contenuto. È possibile eseguire la ricerca per indicizzazione di varie origini di contenuto come elencato nella raccolta dei connettori. Il contenuto e i metadati degli elementi per cui si esegue la ricerca per indicizzazione sono rappresentati come proprietà sottoposte a ricerca per indicizzazione (o proprietà di origine).

Ad esempio, la tabella seguente presenta proprietà sottoposte a ricerca per indicizzazione di esempio per un connettore di sistema work tickets.

Proprietà	Tipo
ticketId	Stringa
title	Stringa
createdBy	Stringa
assignedTo	Stringa
lastEditedDate	DateTime
lastEditedBy	Stringa
workItemType	Stringa
priorità	Int64
tag	StringCollection
stato	Stringa
URL	Stringa
risoluto	Booleano

Nota

• Per i connettori creati da Microsoft, le proprietà sottoposte a ricerca per indicizzazione sono selezionate nel passaggio 4 dell'articolo Configurare il connettore Graph .

Attributi di ricerca

Proprietà Content

Questa proprietà viene utilizzata per l'indicizzazione full-text del contenuto, la generazione di frammenti di pagina dei risultati di ricerca, la partecipazione al cluster dei risultati , il rilevamento della lingua, il supporto HTML/testo, la classificazione e la pertinenza e la formulazione delle query.

Se si seleziona una proprietà di contenuto, è possibile usare la proprietà generata dal sistema ResultSnippet quando si crea il tipo di risultato. Questa proprietà funge da segnaposto per i frammenti dinamici generati dalla proprietà del contenuto in fase di query. Se si usa questa proprietà nel tipo di risultato, i frammenti di codice vengono generati nei risultati della ricerca.

Ricerca consentita

Se una proprietà è ricercabile, il relativo valore viene aggiunto all'indice full-text. Quando un utente esegue una ricerca, vengono restituiti risultati se è presente un riscontro di ricerca in uno dei campi ricercabili o nel relativo contenuto.

Ricerca di "progettazione" che visualizza i risultati per i riscontri sulla proprietà (title) e sul contenuto.

Sottoponibile a query

Se è possibile eseguire query su una proprietà, è possibile eseguire query su di essa usando knowledge query language (KQL).If a property is queryable, you can query against it using knowledge query language (KQL). KQL è costituito da una o più parole chiave di testo libero (parole o frasi) o restrizioni di proprietà. Il nome della proprietà deve essere incluso nella query, specificato nella query stessa o incluso nella query a livello di codice. È possibile usare la corrispondenza del prefisso con l'operatore con caratteri jolly(*).

Nota

La corrispondenza dei suffissi non è supportata.

Ricerca di "search ba*" che visualizza i risultati che corrispondono a questo prefisso.

Ricerca di "tags:design" che consente di definire l'ambito dei risultati per gli elementi con "progettazione" nella tags proprietà .

Recuperabile

Se una proprietà è recuperabile, il relativo valore può essere restituito nei risultati della ricerca. Tutte le proprietà che si desidera aggiungere nel modello di visualizzazione o che devono essere restituite dalla query e pertinenti nei risultati della ricerca devono essere recuperabili. Contrassegnare proprietà di grandi dimensioni o troppe come recuperabili aumenta la latenza di ricerca. Essere selettivo e scegliere le proprietà rilevanti.

Di conseguenza, viene eseguito il rendering di un set di proprietà recuperabili (title e lastEditedBy).

Affinabile

Se una proprietà è perfezionabile, un amministratore può configurarla come filtro personalizzato nella pagina dei risultati di Microsoft Search. Una refinable proprietà non può essere searchable.

Perfeziona i risultati in tagsbase a , una proprietà perfezionabile.

Nota

• Per i connettori creati da Microsoft, gli attributi di ricerca sono selezionati nel passaggio 7 dell'articolo Configurare il connettore Graph .

Etichette semantica

Un'etichetta semantica è un tag noto pubblicato da Microsoft che è possibile aggiungere a una proprietà nello schema. L'aggiunta di un'etichetta semantica consente a vari prodotti Microsoft di comprendere la proprietà e offrire un'esperienza migliore.

Le etichette semantiche offrono un approccio indipendente dal dominio per l'assegnazione di proprietà da domini di contenuto diversi a un set di classi note. Trovano applicazioni in molte esperienze di contenuto diverse e forniscono supporto automatizzato per attività come:

• Integrazione dei dati in esperienze eterogenee
• Creazione di grafici delle conoscenze comuni (ad esempio, Topics)
• Modelli predefiniti per le esperienze utente

Le etichette offrono un significato semantico e consentono di integrare i dati del connettore nelle esperienze di Microsoft 365.

Etichetta	Descrizione
title	Titolo dell'elemento da visualizzare nella ricerca e in altre esperienze.
URL	URL di destinazione dell'elemento nell'origine dati.
createdBy	Nome della persona che ha creato l'elemento nell'origine dati.
lastModifiedBy	Nome della persona che ha modificato l'elemento più di recente nell'origine dati.
authors	Nomi di tutte le persone che hanno partecipato o collaborato all'elemento nell'origine dati.
createdDateTime	Data e ora di creazione dell'elemento nell'origine dati.
lastModifiedDateTime	Data e ora dell'ultima modifica dell'elemento nell'origine dati.
Filename	Nel caso di un file, il nome del file nell'origine dati.
fileExtension	Nel caso di un file, l'estensione del file nell'origine dati.
iconUrl	URL di un'icona.

Ad esempio, la proprietà sottoposta a ricerca per indicizzazione lastEditedBy ha lo stesso significato dell'etichetta Microsoft lastModifiedBy.

Importante

Tutte le proprietà di cui si esegue il mapping alle etichette devono essere recuperabili.

Il titolo dell'etichetta è l'etichetta più importante. Assicurarsi di assegnare una proprietà a questa etichetta per consentire alla connessione di partecipare all'esperienza del cluster dei risultati. Il mapping errato delle etichette peggiora l'esperienza di ricerca. Per alcune etichette non è possibile assegnare una proprietà.

Nota

• Per i connettori compilati da Microsoft, le etichette semantiche sono selezionate nel passaggio 6 dell'articolo Configurare il connettore Graph .

Alias

Gli alias sono nomi descrittivi per le proprietà assegnate. Questi vengono usati nelle query e nelle selezioni nei filtri delle proprietà perfezionabili.

Nota

• Per i connettori compilati da Microsoft, gli alias sono definiti nel passaggio 7 dell'articolo Configurare il connettore Graph .

Funzionalità di aggiornamento dello schema

Questa sezione include informazioni sulle funzionalità di aggiornamento per lo schema di ricerca dei connettori Graph compilati da Microsoft.

Nota

È consigliabile eseguire una ricerca per indicizzazione completa dopo un aggiornamento per portarli allo schema più recente. Senza una ricerca per indicizzazione completa, il comportamento degli elementi sarà incoerente.

Gestire lo schema

1. Nella interfaccia di amministrazione di Microsoft 365 passare alla pagina Schema nella sezione Personalizzazione.
2. Fare clic su Visualizza dettagli in Schema connettori graph.
3. Selezionare la connessione per cui si vuole aggiornare lo schema e fare clic su Personalizza schema.
4. Dopo aver apportato le modifiche dello schema necessarie, fare clic su Pubblica modifiche dello schema per pubblicare il nuovo schema.

Aggiungere una proprietà sottoposta a ricerca per indicizzazione

È possibile aggiungere una proprietà allo schema. Quando si aggiunge una proprietà, è possibile includere tutti gli attributi di ricerca necessari.

Aggiungere una nuova proprietà di origine dall'elenco delle proprietà supportate dal connettore

Importante

Non è possibile eliminare una proprietà esistente per una connessione pubblicata. Per rimuovere una proprietà, è necessario eliminare e ricreare una connessione.

Aggiungere/rimuovere una funzionalità di ricerca

È possibile aggiungere o rimuovere attributi di ricerca specifici a una proprietà. L'aggiunta di una funzionalità di ricerca richiede una ricerca per indicizzazione completa.

Aggiornare le annotazioni di ricerca per le proprietà sottoposte a ricerca per indicizzazione

Importante

• Non è possibile rimuovere un attributo di ricerca recuperabile da una proprietà.
• Non è possibile aggiungere o rimuovere l'attributo di ricerca affinabile in una proprietà.

Aggiungere/rimuovere un'etichetta semantica

È possibile aggiungere o aggiornare il mapping delle etichette semantica delle proprietà sottoposte a ricerca per indicizzazione.

Aggiornare le etichette semantica per le proprietà sottoposte a ricerca per indicizzazione

Aggiungere/rimuovere un alias

È possibile aggiungere o rimuovere alias e usarli per le query di ricerca.

Aggiungere o rimuovere un alias per le proprietà sottoposte a ricerca per indicizzazione